Firmware for CAN and UART to WiFi or Bluetooth gateway based on ESP32-IDF v4.0.
Warning: This firmware is at a very early stage. Expect bugs and report them in the issues :)
The firmware should support multiple use-cases to connect Libre Solar devices with other networks (incl. the internet).
In this application, the ESP32 is integrated in a separate device (like the Libre Solar Data Manager) and communicates with the other devices like the charge controller via CAN bus.
The ThingSet protocol on the CAN bus can translated to MQTT in order to push data to a cloud. For local access, the ESP32 can directly serve a website or provide a Bluetooth Low Energy interface for a mobile phone app.
The ESP32 board can also be directly integrated in a charge controller or other devices and communicate with the host device via UART interface (again using the ThingSet protocol).
The data can be accessed in the same way as described above.
- Libre Solar Data Manager
- Sparkfun ESP32thing
- Most other ESP32-based boards
- Written in C using ESP-IDF and PlatformIO
- Data input from Libre Solar devices via
- Local communication via ThingSet Protocol
- Data access via HTTP JSON API
- Publishing of monitoring data via WiFi to
- Open Energy Monitor Emoncms
- MQTT server (ToDo)
- Data logging on SD card (ToDo)
This firmware repository contains git submodules, so you need to clone (download) it by calling:
git clone --recursive https://github.com/LibreSolar/esp32-edge-firmware
Unfortunately, the green GitHub "Clone or download" button does not include submodules. If you cloned the repository already and want to pull the submodules, run git submodule update --init --recursive.
To be able to build the esp32-edge-firmware you need to build the webapp first. To do so, go into the webapp folder
cd esp32-edge-firmware/webapp
and run
npm install
npm run build
You are now able to build the firmware itself.
The ESP-IDF is the native toolchain for ESP32 microcontrollers by Espressif. Follow this guide to install it.
After installation run the following commands:
idf.py build # compile the firmware
idf.py flash # flash it to the device
You can use PlatformIO for easy building and flashing. However, the PlatformIO packages for ESP-IDF are not updated as frequently as the official repositories.
The firmware is configured using Kconfig integrated into ESP-IDF.
The most convenient way is to run idf.py menuconfig after the ESP-IDF was successfully installed. If ESP-IDF is not available and PlatformIO is used, configuration can be changed manually in the generated sdkconfig file.
The firmware supports provisioning via bluetooth. You can download the espressif BLE provisioning app in the iOS or android app store and scan this QR code:
You can also scan for the device manually in the app, the data manager should be found as device PROV_LS-DM, the service pin is LibreSolar.