postgresql>> esp32-weather-station>> 返回
项目作者： dastu08

项目描述 ：
This is a project with the ESP32 chip onboard the ESP32-devkitc and a temperature and pressure sensor BMP180. It uses the ESP-IDF framework.
高级语言： C
项目地址: git://github.com/dastu08/esp32-weather-station.git
创建时间： 2021-05-02T17:14:44Z
项目社区：https://github.com/dastu08/esp32-weather-station
开源协议：MIT License
下载


ESP32 Weather Station

This is a project with the ESP32 chip onboard the ESP32-DevKitC and a
temperature and pressure sensor BMP180. It uses the ESP-IDF framework.

Usage

  1. Connect the BMP180 to the ESP32-DevKitC. The default pins for I2C
    are GPIO 19 for SDA and GPIO 18 for SCL. This is set in
    main.c by calling
    1.  pl_i2c_init(GPIO_NUM_19, GPIO_NUM_18, 100000);
  2. The ESP32 needs to connect to an existing WiFi network. See the section
    Project Configuration for the steps to enter
    the ssid and the password.
  3. Communicate with the ESP32 via UDP. Both sending and receiving are
    done over the same port. The port and the timer periods for heartbeat
    and measurements are set in main.c. 
    1.  #define UDP_PORT 50000
    2.  #define MEASUREMENT_RATE 600
    3.  #define HEARTBEAT_RATE 300
  4. The UDP communication consists of JSON objects that are send as
    strings. The following listing shows all the current options.
    The numerical values for the interval variables are in seconds.
    1.  {"type":"get", "quantity":"temperature"}
    2.  {"type":"get", "quantity":"pressure"}
    3.  {"type":"get", "quantity":["temperature", "pressure"]}
    4.  {"type":"set", "name":"heartbeat", "value":"on"}
    5.  {"type":"set", "name":"heartbeat", "value":"off"}
    6.  {"type":"set", "name":"heartbeat_interval", "value": 30}
    7.  {"type":"set", "name":"measurement_interval", "value": 5}
  5. The return objects have the following syntax.
    Response to a get request which has only a single element in the list
    of quantity.
    1.  {
    2.      "type":"response",
    3.      "time":"2021-05-04 20:11:20 CET",
    4.      "quantity": [{
    5.          "name":"temperature",
    6.          "value": 21.5,
    7.          "unit": "celsius"
    8.      }]
    9.  }
    Response from a periodic measurement which holds a list of measured
    quantities in quantity.
    1.  {
    2.      "type":"measurement",
    3.      "time":"2021-10-18 14:41:29 CET",
    4.      "quantity":[
    5.          {
    6.              "name":"temperature",
    7.              "value": 21.6,
    8.              "unit":"celsius"
    9.          },
    10.          {
    11.              "name":"pressure",
    12.              "value": 1019.310,
    13.              "unit":"hPa"
    14.          }]
    15.  }
    For debug purposes the ESP32 also sends objects with type heartbeat
    which do not contain any more information than the type and the time.
    1.  {
    2.      "type":"heartbeat",
    3.      "time":"2021-10-18 14:42:53 CET"
    4.  }
  6. The UDP traffic is encrypted AES-256-CBC mode. The 32 byte key is set
    with menuconfig. The buffer length BUFFER_LENGTH in al_crypto
    determines the length of the outgoing message. The incoming messages
    can be as large as the BUFFER_LENGTH + 16 for they contain the initialization vector as the first 16 bytes.

Framework

The framework used in this project is the ESP-IDF by espressif that can be
found on GitHub and has an extensive documentation.
=> https://github.com/espressif/esp-idf
=> https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/get-started/index.html

This project uses version 4.2 of the ESP-IDF.

  1. git clone --recursive --branch v4.2 https://github.com/espressif/esp-idf.git

Toolchain Troubleshooting (Ubuntu)

Make sure to have the packages python3-virtualenv installed if you have an
error No module pip.

The setup needs the name python so set the alternatives.

  1. sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 10 && alias pip=pip3

Then install the toolchain for the local user inside the esp/esp-idf
directory by executing 

  1. ./install.sh

After the installation you need to source esp/esp-idf/export.sh. Create an
alias in .bashrc.

  1. alias get-idf='. $HOME/esp/esp-idf/export.sh'

For the gdb debugger to work you have to install the package libpython2.7-dev.

Project Configuration

You can configure the framework for the project in an interactive terminal.
Then build, flash and monitor the project. The port for flashing is
/dev/ttyUSB0 on Ubuntu. 

  1. idf.py set-target esp32
  2. idf.py menuconfig
  3. idf.py build
  4. idf.py flash -p <port>
  5. idf.py monitor -p <port>
  6. idf.py flash monitor -p <port>
  7. idf.py size-components

The WiFi configuration of the menuconfig is located under
Component config ---> Wifi Connect Config ---> WiFi SSID /WiFi Password.
The fast scan method should work fine.

Further documentation for monitor.
=> https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/api-guides/tools/idf-monitor.html

Notice when writing components:
The following header files are part of esp_common component and
do not need to be added to required lists in CMakeLists.txt of
components.

  • esp_err.h

WiFi

The WiFi bundle uses the LwIP stack with esp_netif and BSD Sockets
for UDP/TCP communication. Time synchronization is done via sntp.

=> https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/api-guides/wifi.html
=> https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/api-reference/network/esp_netif.html
=> https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/api-guides/lwip.html
=> https://pubs.opengroup.org/onlinepubs/007908799/xns/socket.html
=> https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/system/system_time.html?highlight=system%20time

Hardware

ESP32-DevKitC V4

Get started with the ESP32-DevKitC V4 board with has the ESP-WROOM-32
chip. The I2C Bus works on 3.3 V.

=> https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/hw-reference/modules-and-boards.html#esp32-devkitc-v4
=> https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/hw-reference/modules-and-boards.html#esp-modules-and-boards-esp32-wroom-32

ESP-Prog

For debugging use the ESP-Prog board which has JTAG debugging
capabilities. The debugging chip uses two ports:

  • /dev/ttyUSB0 is for the JTAG interface and
  • /dev/ttyUSB1 for the flashing.

To connect the correct pins see the third link.

=> https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/api-guides/jtag-debugging/index.html
=> https://github.com/espressif/esp-dev-kits/blob/master/esp-prog/docs/ESP-Prog_guide_en.md
=> https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/api-guides/jtag-debugging/configure-other-jtag.html
=> https://docs.platformio.org/en/latest/faq.html#faq-udev-rules

Make sure to apply the udev rule to avoid permission issues and then start
the openocd service. Note this has to run when starting the gdb. 

  1. openocd -f interface/ftdi/esp32_devkitj_v1.cfg -f target/esp32.cfg

You can also flash the ESP32 via JTAG.

  1. openocd -f interface/ftdi/esp32_devkitj_v1.cfg -f target/esp32.cfg -c "program_esp build/esp32-devkitc.bin 0x10000 verify exit"

Start the debugger

  1. xtensa-esp32-elf-gdb -x gdbinit build/esp32-devkitc.elf

Pin connection for debugging

ESP-PROG DevKit C
TDO G15
TDI G12
TCK G13
TMS G14
EN EN
TXD TXD
RXD RXD
VDD 3V3
GND GND
IO0 G0

=> https://github.com/espressif/esp-dev-kits/blob/master/esp-prog/docs/_static/program_pin.png
=> https://github.com/espressif/esp-dev-kits/blob/master/esp-prog/docs/_static/JTAG_pin.png

BMP180 Sensor

Temperature and air pressure sensor with an I2C interface.

  • I2C address: 0x77
  • I2C clock speed max: 3.4 MHz

VS Code Extension

See GitHub on debugging with the extension.

=> https://github.com/espressif/vscode-esp-idf-extension
=> https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/DEBUGGING.md

Useful settings.json

  1. {
  2.     "idf.port": "/dev/ttyUSB1",
  3.     "idf.adapterTargetName": "esp32",
  4.     "idf.flashType": "UART",
  5.     "idf.openOcdConfigs": [
  6.         "interface/ftdi/esp32_devkitj_v1.cfg",
  7.         "target/esp32.cfg"
  8.     ]
  9. }

Useful launch.json

  1. {
  2.     "version": "0.2.0",
  3.     "configurations": [
  4.         {
  5.             "name": "GDB",
  6.             "type": "cppdbg",
  7.             "request": "launch",
  8.             "MIMode": "gdb",
  9.             "miDebuggerPath": "${command:espIdf.getXtensaGdb}",
  10.             "program": "${workspaceFolder}/build/${command:espIdf.getProjectName}.elf",
  11.             "cwd": "${workspaceFolder}",
  12.             "environment": [
  13.                 {
  14.                     "name": "PATH",
  15.                     "value": "${config:idf.customExtraPaths}"
  16.                 }
  17.             ],
  18.             "setupCommands": [
  19.                 { "text": "target remote :3333" },
  20.                 { "text": "set remote hardware-watchpoint-limit 2"},
  21.                 { "text": "mon reset halt" },
  22.                 { "text": "thb app_main" },
  23.                 { "text": "flushregs" }
  24.             ],
  25.             "externalConsole": false,
  26.             "logging": {
  27.                 "exceptions": true,
  28.                 "moduleLoad": true,
  29.                 "programOutput": true,
  30.                 "engineLogging": false,
  31.                 "trace": false,
  32.                 "traceResponse": false
  33.             },
  34.         }
  35.     ]
  36. }