.vscode | ||
board-design | ||
board-v2 | ||
case | ||
main | ||
.clang-format | ||
.editorconfig | ||
.gitignore | ||
LICENSE | ||
Makefile | ||
README.md | ||
sdkconfig |
ESP32-based Environmental Sensor
Author: Jannik Beyerstedt
license: GNU GPL v3
A simple temperature and humidity sensor node using an ESP32 and a Si7021 sensor element running of a 18650 LiIon battery cell. The sensor outputs the data to an influxDB instance, which must be reachable via HTTP.
To save energy, we use a lower CPU frequency. But this requires compiling the core framework again with the changed settings (see below).
This repository contains the code running on the ESP32, as well as the PCB and case design.
Dependencies
Prepare toolchain (macOS):
cd ~/JBeyerstedt-Projekte/
mkdir ./esp32
cd esp32
curl https://dl.espressif.com/dl/xtensa-esp32-elf-osx-1.22.0-80-g6c4433a-5.2.0.tar.gz -o xtensa-esp32-elf-osx-1.22.0-80-g6c4433a-5.2.0.tar.gz
tar -xzf xtensa-esp32-elf-osx-1.22.0-80-g6c4433a-5.2.0.tar.gz
rm xtensa-esp32-elf-osx-1.22.0-80-g6c4433a-5.2.0.tar.gz
Prepare toolchain (Debian, Ubuntu) (ubuntu devel vm):
sudo apt-get install git wget make libncurses-dev flex bison gperf python python-serial
cd ~/Development/
mkdir ./esp32
cd esp32
wget https://dl.espressif.com/dl/xtensa-esp32-elf-linux64-1.22.0-73-ge28a011-5.2.0.tar.gz
tar -xzf xtensa-esp32-elf-linux64-1.22.0-73-ge28a011-5.2.0.tar.gz
rm xtensa-esp32-elf-linux64-1.22.0-73-ge28a011-5.2.0.tar.gz
Add to your bash profile, zshrc or other:
export PATH=$PATH:$HOME/JBeyerstedt-Projekte/esp32/xtensa-esp32-elf/bin
export IDF_PATH = $HOME/JBeyerstedt-Projekte/esp32/esp-idf
or for ubuntu devel vm:
export PATH=$PATH:$HOME/Development/esp32/xtensa-esp32-elf/bin
export IDF_PATH = $HOME/Development/esp32/esp-idf
Install esp-idf:
git clone --recursive https://github.com/espressif/esp-idf.git
Checkout this project and configure arduino-esp32 with esp-idf:
TODO!!
mkdir -p components && \
cd components && \
git clone https://github.com/espressif/arduino-esp32.git arduino && \
cd arduino && \
git submodule update --init --recursive && \
cd ../..
Configure make menuconfig
:
- under "Arduino Configuration":
- "Autostart Arduino setup and loop on boot": off
- "Disable mutex locks for HAL": off
- under "Serial flasher config":
- change flash size to 4 MB
- optionally set your serial port
- under "Component config" -> "ESP32-secific":
- set CPU frequency to 80 MHz
Make and flash:
make all
make flash
You would probably have to adapt the UPLOAD_PORT
in the Makefile
or set it via an environment variable.
Battery Life
The hardware was designed with two options to drop the battery voltage to a level, which can be fed to the ESP32: A voltage regulator or a simple diode.
A test with increased data rate (for a shorter test duration) showed, that the voltage regulator leads to a slight battery life benefit. Using a measurement interval of 30 seconds and a WiFi connection interval of 3 minutes, the 2500mAh LiIon (3.7V) battery lasted 30 days with the diode and 36 days using the voltage regulator.
The selected voltage regulator has a quite low drop-out voltage and more importantly a low leaking current during the deep-sleep phases, which have a very low current needed by the ESP32. In comparison a diode has no leaking current at all, but a more or less fixed voltage drop.
The benefit of the voltage regulator is, that the battery voltage range can be exploited further than what can be done with the diode. The lowest operational battery level was 3.2 V using the diode and 2.8 V using the voltage regulator.