This is an ESP32 based Bluetooth to MQTT Bride for BLUETTI power stations. The project is based on https://github.com/warhammerkid/bluetti_mqtt The code is tested on a AC300. Other Powerstations should also work but are untested yet. The discussion on https://diysolarforum.com/threads/monitoring-bluetti-systems.37870/ was a great help for understanding the protocol.
- easy configuration with WiFi manager
- mqtt support
- support for BLUETTI power stations
- AC300 (tested)
- AC200 (untested)
- EB3A (untested)
- EP500 (untested)
- EP500P (untested)
- supported BLUETTI functions
- commands
- ac output on/off
- dc output on/off
- states
- ac input power
- dc input power
- ac output power
- dc output power
- dsp firmware version
- arm firmware version
- serial number
- device type
- power generation
- total battery percent
- commands
You will need to install a board support package for your ESP32. Additionally the follwing libraries are needed:
Change the partition scheme with Tools -> Partition Scheme to
- Huge App (3MB No OTA/1MB SPIFFS)
This setting is required because the Bluetooth stack already uses a lot of the ESP32 memory.
Optional: Do changes in config.h file. The device can be set by changing 'BLUETTI_TYPE'.
Finally upload the Sketch to your ESP32.
INFO: Until now only BLUETTI_AC300 was tested. If you own one of the supported devices please let me know if it works.
Just connect the ESP32 to a power supply or the power station itself. Connect your mobile phone or computer to the Wifi mangaer of the ESP32 firmware, it should show up as "ESP32_Bluetti".
After the connection to the hotspot is established a wifi manager popup will appear. Otherwise open 192.168.4.1 in your local webbrowser.
Select "Configure WiFi"
Configure your WiFi and set the address of your MQTT server and enter the Bluetooth ID of your Bluetti Device. You can use a mobile phone and/or the Bluetti APP for finding the correct Bluetooth ID of your device.
Save the settings. The ESP32 starts sending messages to your MQTT server.
Example ( ioBroker ):
Commands are subscribed from
- /bluetti/<your_device_id>/command
- ac_output_on
- dc_output_on
States are published to
- /bluetti/<your_device_id>/state
- ac_output_on
- dc_output_on
- dc_input_power
- ac_input_power
- ac_output_power
- dc_output_power
- serial
- dsp_version
- arm_version
- power_generation
- total_battery_percent
- MQTT credentials
- add full feature set to device files
- adding a web interface to the ESP32
- adding support for OLED display
- adding support for SD-Card reader, for writing csv data to an sd-card
- adding logging poll commands
The code within this repository comes with no guarantee, use it on your own risk.
Don't touch these firmwares if you don't know how to put the device in the programming mode if something goes wrong. As per the GPL v3 license, I assume no liability for any damage to you or any other person or equipment.