This project provides PlatformIO code for building custom firmware for the WiFi-F module included with the Growatt SPF 3500-5000 ES off-grid inverters. It collects all available metrics through the inverter's MODBUS interface and sends them to InfluxDB v2 or MQTT. The inverter's AC output can also be placed in and out of standby mode remotely through MQTT to reduce idle power consumption when the AC output isn't needed. This is a function not available through the inverter's interface and can save quite a lot of energy over time.
Otti's project provided some inspiration, however the newer generation Wifi-F module can be a challenge to interface with. Many serial adaptors (including the popular FTDI and CH340) will fail to communicate with the ESP8266 when plugged directly into the TX/RX pin headers on the PCB. There are two options for overcoming this issue:
-
The SIPEX SP3232EE RS-232 transceiver on the rear of the PCB, which is also connected to the RX and TX pins of the ESP8266, can be removed or disconnected temporarily to uploaded new firmware. After the initial upload, the SP3232 chip should be replaced or reconnected before the dongle is attached to the inverter.
-
(Preferred) Use an RS232 interface that can better handle the impedance of the SP3232 chip. A USB to UART adaptor utilising the Silicon Labs CP2102 can be bought for a few dollars and is able to upload firmware without any need to modify the dongle.
The onboard ESP8266 is easy to work with: all the necessary pins (GND, TX, RX and GPIO-0) are broken out to a standard 0.1” through holes that a pin header can be soldered to. The chip can be placed in flash mode by shorting GPIO-0 to ground as it's powered on, then standard ESP8266 firmware upload procedures can be followed. I've included OTA components in the firmware so any future updates can be done without a serial interface.
The WiFi-F board seems to be quite power hungry. Powering it through the USB plug from a source slightly above 5v will ensure the onboard buck converter can provide enough current while flashing the ESP.
The Growatt-Grafana-Dashboard.json file can be imported into Grafana to display metrics from InfluxDB v2 as in the screenshot below.
MQTT-Dash.txt can be imported into the MQTT Dash app to provide metrics and inverter control from your Android device. If MQTT is not required, it can be disabled by removing #define MQTT from line 1 in main.cpp,
Further details and discussion at DIYSolarForum: https://diysolarforum.com/threads/hacking-the-new-growatt-wifi-f-modules.43231/
Otti for his inspiration and prior work flashing other Growatt dongles
RobTillaart for RunningAverage
Tobias Schürg for InfluxDB Client
- Initial release
- Moved SSID, WiFi password and InfluxDB connection string to include/secrets.h
- Removed WebSerial and replaced it with the more efficient TelnetStream.
- Added a sanity check for AC_Discharge_Watts which will return very large numbers if the inverter has been in standby mode.
- Added UDP mode for InfluxDB, which is far faster and more efficient.
HTTP mode is still available for those who want the added reliability of a TCP connection, at the expense of performance.
Either mode can be enabled by toggling the UDP_MODE definition.
- Added MQTT as an optional destination for the statistics.
Influx in HTTP or UDP mode and MQQT can be enabled or disabled by uncommenting or commenting the definitions at the beginning of main.cpp.
- Added the ability to remotely turn on/off standby mode for the inverter through MQTT.
This is useful for reducing overall energy usage when the AC output isn't needed.
Battery charging will still occur while the inverter is in standby.
Note that 4 modes are available and documented in the Growatt protocol, however only option 0 (Standby off, Output enable.) and option 3 (Standby on, Output disable) seem to have the intended effect.
The behaviour of options 1 and 2 are not well defined or implemented.
- Added Growatt-Grafana-Dashboard.json, which can be imported into Grafana to quickly construct the dashboard showing all metrics pulled from InfluxDB.
- Added MQTT-Dash.txt which can be imported into MQTT Dash for inverter metrics and control from an Android device.
- Added MQTT authentication. Update SECRET_MQTT_USER and SECRET_MQTT_PASS in include\secrets.h accordingly.
- Updated to use the official InfluxDB Client for Arduino, introducing support for InfluxDB v2