Skip to main content

MQTT interface to Bluetti power stations

Project description

This tool provides an MQTT interface to Bluetti power stations. State will be published to the bluetti/state/[DEVICE NAME]/[PROPERTY] topic, and commands can be sent to the bluetti/command/[DEVICE NAME]/[PROPERTY] topic.

Installation

$ pip install bluetti_mqtt

Usage

$ bluetti-mqtt --scan
Found AC3001234567890123: address 00:11:22:33:44:55
$ bluetti-mqtt --broker [MQTT_BROKER_HOST] 00:11:22:33:44:55

If your MQTT broker has a username and password, you can pass those in.

$ bluetti-mqtt --broker [MQTT_BROKER_HOST] --username username --password pass 00:11:22:33:44:55

By default the device is polled as quickly as possible, but if you’d like to collect less data, the polling interval can be adjusted.

# Poll every 60s
$ bluetti-mqtt --broker [MQTT_BROKER_HOST] --interval 60 00:11:22:33:44:55

If you have multiple devices within bluetooth range, you can monitor all of them with just a single command. We can only talk to one device at a time, so you may notice some irregularity in the collected data, especially if you have not set an interval.

$ bluetti-mqtt --broker [MQTT_BROKER_HOST] 00:11:22:33:44:55 00:11:22:33:44:66

Background Service

If you are running on a platform with systemd, you can use the following as a template. It should be placed in /etc/systemd/system/bluetti-mqtt.service. Once you’ve written the file, you’ll need to run sudo systemctl start bluetti-mqtt. If you want it to run automatically after rebooting, you’ll also need to run sudo systemctl enable bluetti-mqtt.

[Unit]
Description=Bluetti MQTT
After=network.target
StartLimitIntervalSec=0

[Service]
Type=simple
Restart=always
RestartSec=30
TimeoutStopSec=15
User=your_username_here
ExecStart=/home/your_username_here/.local/bin/bluetti-mqtt --broker [MQTT_BROKER_HOST] 00:11:22:33:44:55

[Install]
WantedBy=multi-user.target

Home Assistant Integration

If you have configured Home Assistant to use the same MQTT broker, then by default most data and switches will be automatically configured there. This is possible thanks to Home Assistant’s support for automatic MQTT discovery, which is enabled by default with the discovery prefix of homeassistant.

This can be controlled with the --ha-config flag, which defaults to configuring most fields (“normal”). Home Assistant MQTT discovery can also be disabled, or additional internal device fields can be configured with the “advanced” option.

Reverse Engineering

For research purposes you can also use the bluetti-logger command to poll the device and log in a standardised format.

$ bluetti-logger --log the-log-file.log 00:11:22:33:44:55

While the logger is running, change settings on the device and take note of the time when you made the change, waiting ~ 1 minute between changes. Note that not every setting that can be changed on the device can be changed over bluetooth.

If you’re looking to add support to control something that the app can change but cannot be changed directly from the device screen, both iOS and Android support collecting bluetooth logs from running apps. Additionally, with the correct hardware Wireshark can be used to collect logs. With these logs and a report of what commands were sent at what times, this data can be used to reverse engineer support.

For supporting new devices, the bluetti-discovery command is provided. It will scan from 0 to 12500 assuming MODBUS-over-Bluetooth. This will take a while and requires that the scanned device be in close Bluetooth range for optimal performance.

$ bluetti-discovery --scan
Found AC3001234567890123: address 00:11:22:33:44:55
$ bluetti-discovery --log the-log-file.log 00:11:22:33:44:55

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bluetti_mqtt_asyncio-0.16.1.tar.gz (23.2 kB view details)

Uploaded Source

Built Distribution

bluetti_mqtt_asyncio-0.16.1-py3-none-any.whl (34.6 kB view details)

Uploaded Python 3

File details

Details for the file bluetti_mqtt_asyncio-0.16.1.tar.gz.

File metadata

  • Download URL: bluetti_mqtt_asyncio-0.16.1.tar.gz
  • Upload date:
  • Size: 23.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for bluetti_mqtt_asyncio-0.16.1.tar.gz
Algorithm Hash digest
SHA256 ac2672a1370940d053ed5e93e6f3d364cd6193e2cd76a77c6342ce530d81e5a2
MD5 aaf7bb896e98a0b6576bba6f9f13a7eb
BLAKE2b-256 4aa9d84e8203545d64433fa0c725c87a922adb6b37f6f3871eb2a07660f2d54d

See more details on using hashes here.

File details

Details for the file bluetti_mqtt_asyncio-0.16.1-py3-none-any.whl.

File metadata

File hashes

Hashes for bluetti_mqtt_asyncio-0.16.1-py3-none-any.whl
Algorithm Hash digest
SHA256 713cc6fd56f51a0b309301f284caf3596fd377c4e6500f916d592f9496f61d5e
MD5 b04cd9857bc8dc7a65d007f48714952e
BLAKE2b-256 59c24c5b9e5cfc622514e46654d105af96d0b5376eee1a7c7908e75ba46f4ecb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page