Tested with: BLUETTI Elite 30 V2 only.
Other models that work with the BLUETTI cloud (AC200L, AC300, AC500, Apex 300, Elite 100/200 V2, AORA, EP760 …) may work, but are untested. Reports are very welcome!
This is a community app — not made or supported by BLUETTI.
Features
Battery level (battery tab + sensor tile)
Solar input, grid input, AC output and DC output power
Battery power (positive = charging, negative = discharging)
Time to empty / time to full in readable form (“1d 9h 6m”)
Working mode: Standard UPS, PV Priority UPS, Time Control UPS, Custom UPS
AC output, DC output, AC ECO and DC ECO on/off — on one screen and in Flows
Real-time updates: changes made on the unit or in the BLUETTI app appear in Homey within seconds
Flow cards
When: an output was turned on/off · went offline · came back online
And: an output is on/off
Then: turn an output on/off
How it works
BLUETTI power stations have no local network API (all ports closed), so the app uses the same BLUETTI cloud API as the official Home Assistant integration. You sign in with your BLUETTI account inside the Homey pairing screen — your password goes to BLUETTI only, Homey just receives a login token.
Requirements: power station already set up on Wi‑Fi with the BLUETTI app, and a BLUETTI account.
Not available (not offered by the BLUETTI cloud to third-party apps): charging mode, Power Lifting, SOC limits, auto-sleep, display settings.
Other models? Help wanted
If you own another model: install the app, add your power station and post your model + a screenshot. If the log shows lines like Unmapped fnCode …, please share them — that’s how support for more data/models gets added.
You can already switch things off with the “Turn output on or off” Then card. It covers AC output, DC output, AC ECO and DC ECO. If you add two of those cards, one for AC off and one for DC off, the unit stops powering anything.
A full shutdown, like holding the power button, isn’t available right now. The BLUETTI cloud API doesn’t offer it, at least on the Elite 30 V2 I tested with. Also, once the unit is fully off its Wi-Fi is off too, so Homey couldn’t turn it back on afterwards.
If you’d like me to check whether the Elite 200 V2 exposes anything extra, turn on verbose logging in the device settings, wait a few minutes, and send a diagnostics report from the app page. I’ll take a look.
I really like this app. I can now also see data on my Homey dashboard.
I would like to be able to turn the device off completely when the solar panels are no longer generating power. However, if I turn it off completely, the Bluetti cannot be switched on remotely. When its completely switch off then when the solar panels start generating power again the following morning, the Bluetti will automatically turn on.
There is also a sleep mode, which might be more suitable to control through Homey.
I’m trying to enable verbose logging, but the Bluetti suddenly went offline for a while. It’s back online now, but I can’t seem to get the logging to work.
No problem! Here’s how to run the app from GitHub so you can see the log live. You’ll need a computer on the same network as your Homey.
Install Node.js (LTS) from nodejs.org, then the Homey CLI: npm install -g homey
Download the app: git clone https://github.com/gpmachado/com.gpm.bluetti.git cd com.gpm.bluetti npm install
Copy env.json.dist to env.json and fill in the two values. The file tells you where to find them (in BLUETTI’s official Home Assistant integration on GitHub, profile/application.yaml).
Log in and pick your Homey: homey login homey select
Run it: homey app run --remote
The log scrolls in the terminal. Wait until you see a line starting with Cloud data: model=... and paste that line here. It lists every function your Elite 200 V2 offers.
This replaces the App Store version while it runs. When you stop it (Ctrl+C), the development app is removed, so you may need to reinstall BLUETTI from the App Store and add the device again.
If that’s too much hassle: the App Store version can send the same info. Go to Settings → Apps → BLUETTI → Restart, wait a minute, then Send diagnostics report and post the report ID here.
Thanks for the diagnostics report, Hepsie, it was very helpful!
What happened: the BLUETTI real-time link was working fine, but every regular data request to BLUETTI’s main server timed out for several hours. That’s why Homey kept showing old values, and why I couldn’t see your unit’s functions (power off / sleep) yet.
Test version v0.4.2: if the main server stops answering, the app now switches automatically to your account’s regional BLUETTI server, the same one the real-time link already uses.
In the report I’ll be looking for a line like BLUETTI REST host switched to …, plus the list of functions your Elite 200 V2 offers. With that I can check power off and sleep mode.
Tip: if your Homey is near the Bluetti, also turn on “Read over Bluetooth when the cloud is unavailable” in the device settings. It keeps your values up to date even when the BLUETTI cloud has problems.
Thanks Hepsie, that report was exactly what I needed!
Good news: your Elite 200 V2 reports a sleep mode to the BLUETTI cloud. Unfortunately there’s no “power off” function, so a full shutdown still isn’t possible through the cloud.
Test version v0.4.3 adds sleep mode:
A new Sleep mode button on the device (it appears after the first update from the cloud)
“Sleep mode” in the Turn output on or off, Output is on and An output was turned on or off cards
Turn sleep mode on from Homey. Does the Bluetti actually go to sleep?
While it’s asleep, does it stay online in the BLUETTI app? If the Wi-Fi switches off in sleep, Homey can’t wake it remotely, much like a full power off.
Turn sleep mode off from Homey (or check it wakes up by itself when the solar panels start producing).
Then send a diagnostics report and post the ID here.
About the connection: v0.4.2 helped. The data requests that failed for hours before now only fail for a minute here and there and recover by themselves. That’s on BLUETTI’s side, and the real-time link keeps your dashboard up to date in the meantime.
Quick update. I spent the evening testing on my own Elite 30 V2 with its Wi-Fi blocked at the router, and found a few things that explain what you have been seeing:
When a power station loses its internet connection, the BLUETTI cloud keeps reporting it as online for about 4 minutes, and it accepts commands during that time and afterwards, but they never reach the unit. So a flow can say “done” while nothing happened.
The Bluetooth fallback in the app had a bug that made it fail on Homey Pro. That is fixed now: when the cloud reports the unit offline, Homey reads it over Bluetooth, including the AC/DC/ECO outputs, and also switches those outputs over Bluetooth, checking that the unit really applied the command.
This is confirmed on the Elite 30 V2. The Elite 200 V2 may use different Bluetooth registers, so I can’t promise it works on yours yet. I’ll put it in the next test version and would really appreciate it if you could try it. Two questions in the meantime:
Is your Homey within Bluetooth range of the Elite 200 V2 (roughly the same room or the next one)?
Is “Bluetooth fallback” enabled in the device settings?
One tip: the unit accepts only one Bluetooth connection at a time, so close the BLUETTI app on your phone when you want Homey to use Bluetooth.
I think it’s great that you’re putting so much effort into this. Thank you so much! But I don’t want you to spend your entire evening working on this for me, especially since it’s the weekend for you too.
The Homey and the Bluetti are about 1.8 metres apart. (The Homey is on top of a cabinet, and the Bluetti is inside the same cabinet.) Bluetooth fallback is indeed enabled.
I’ll remember not to use the Bluetti app.
Once again, thank you so much for all your help. I really appreciate it!
My Bluetti was switched on, and I noticed the Bluetti 0.4.4 update in Homey. So I thought I’d try the flow to turn Sleep Mode on and off, and it works!
I also noticed that there was a button available. See the screenshot. That works perfectly too!
Even my wife could hear how excited I was! I’m so happy about this. It works brilliantly, and this is exactly what I’ve been wanting for a long time.
Thank you so much for all your hard work, effort, and dedication! I really appreciate it!
The only thing was the bluetooth fallback its switch on but I get still the warming, see screenshot.
That’s great to hear, thanks for testing so quickly! Glad sleep mode works on the Elite 200 V2, both from flows and from the button, and I’m happy your wife got to hear the excitement too!
The orange warning is left over from an older version: Homey keeps a device warning across app updates, and the app only cleared it when the cloud came back while it was running. v0.4.6 clears it on start, and it only comes back if the cloud really is unavailable. Once it’s in test, just update. No need to do anything else.
And thanks for the details about the range: 1.8 m is fine for Bluetooth. If your Bluetti ever loses its Wi-Fi, Homey should now keep reading it, and switch AC/DC/ECO, over Bluetooth. That part is only confirmed on my Elite 30 V2 so far, so I’d love to hear how it behaves on yours if it happens.
No worries about the evening, I enjoyed it. Your reports made the app better for everyone.
Thanks for the screenshot. “BLUETTI request timed out” means the BLUETTI cloud did not answer the command within 8 seconds. At about the same time (your 16:49 is 15:49 UTC), my own Homey also lost its connection to the BLUETTI cloud for a few minutes, so I think the BLUETTI servers had a hiccup rather than something on your side.
Version 0.4.7 is now in test. It adds a Connection sensor (Cloud / Bluetooth / Offline), so you can see how Homey reaches your Bluetti. Could you:
Update to 0.4.7.
Check what Connection shows on the device.
Try the Sleep mode button or your flow.
Right after that, send a diagnostic report: Homey app → More → Settings → Apps → BLUETTI → Send diagnostic report, and post the code here.
The report only covers the time since the app last started, so please send it soon after the test, without restarting anything in between.
One thing to know: if the cloud is down, Homey can still read your Bluetti and switch AC/DC/ECO over Bluetooth, but sleep mode is only available through the cloud for now.
Thank you once again for your help and the updates. Everything is clearly explained. I can now also check whether I have a cloud connection, which is great.
I’ve installed the update, activated sleep mode via Homey, and added the diagnostic report ID. 1bdc0b4d-c1b4-462a-b8f9-99cbf4381f32
I hope that, in the future, sleep mode will also be available via Bluetooth.
Thanks for the report and the screenshot, that’s exactly what I needed. Everything looks healthy. The cloud accepted the sleep command in about a second, and a few seconds later your Bluetti itself reported sleep mode on. There were no errors at all, so yesterday’s timeout was most likely a hiccup on BLUETTI’s servers.
About sleep mode over Bluetooth: I checked the Home Assistant Bluetooth projects, and none of them support it yet. Sleep mode came to the Elite 200 V2 with a later firmware update, after their register maps were made. I think I can find it with your help, though. A test version would read your Bluetti’s settings over Bluetooth, then you switch sleep mode on from Homey, and the app reads them again. Whatever changed is the sleep setting. Nothing gets written to your Bluetti until we know which setting it is. Would you be up for that? No rush.
One more question: when your Bluetti has lost its Wi-Fi (Connection shows Bluetooth), does it come back to the cloud by itself after a while? On my Elite 30 V2 it didn’t. After a Wi-Fi drop it stayed off the cloud, and even restarting the router didn’t help. I had to set up Wi-Fi again in the BLUETTI app, which took a few attempts. Other owners report the same, so I’d like to know how your Elite 200 V2 behaves.
You can switch off Detailed logging in the device settings again. It’s only needed when I ask for a report.
Thank you for the update on how things are progressing. I really admire what you have managed to achieve so far.
What I have been hoping for (for quite some time) is now finally being put into motion. What I consider important is that I can see whether Sleep Mode is switched on or off. Also, if the cloud server goes down, I would like to be notified through a flow. And yes, I would definitely like to be able to change these settings via Bluetooth through Homey.
By the way, does this have any implications for the Bluetti’s firmware or software in terms of the warranty?
I would also be more than happy to help with testing in the future, should you have any further questions or need feedback, including questions from other users.
Until yesterday evening at around 10:00 PM, I was experiencing server connection issues. After that, I switched off the Bluetti. When I checked again this morning, the Bluetti was back online without any issues. So, I didn’t have to configure or set up anything again.