Skip to content
 
 

Repository files navigation

BLUETTI Integration for Home Assistant

🇨🇳 简体中文 | 🇩🇪 German | 🇬🇧 English | 🇳🇱 Dutch | 🇺🇦 Ukrainian

BLUETTI Power Station Integration is an integrated component of Home Assistant supported by BLUETTI official. It allows you to use BLUETTI smart Power Station devices in Home Assistant.

The Integration's github repository is: https://github.com/javaDevJT/bluetti-home-assistant.

This fork adds read-only Hub A1 support for Apex 300 systems that BLUETTI's Home Assistant /devices API does not currently list. Hub A1 support is based on BLUETTI app API telemetry discovered from live account captures and does not use the bindDevices write endpoint for manually entered Hub A1 serials.

✨ Features

  • ✅ Power Switch
  • ✅ Inverter Status
  • ✅ Battery state of charge (SOC)
  • ✅ AC Switch
  • ✅ DC Switch
  • ✅ Main unit power switch
  • ✅ AC ECO
  • ✅ DC ECO
  • ✅ Work mode switch: Backup, Self-consumption, Peak and Off-Peak
  • ✅ Sleep Mode
  • ✅ PV Input Power
  • ✅ Grid Input Power
  • ✅ AC Ouput Power
  • ✅ DC Ouput Power
  • ✅ Hub A1 read-only telemetry for Apex 300 systems

🎮 Power Station Support List

Note

More power station models will be added in the future.

Power Station Model Buesiness Name Inverter Status Battery SOC AC Switch DC Switch power switch AC ECO DC ECO Work mode switch Sleep Mode PV Input Power Grid Input Power AC Output Power DC Output Power
AP300 Apex 300
EL300 Elite 300,AORA 300
EL320,AORA320 Elite 320,AORA 320
EL400 Elite 400
EP13K EP13k
EP2000 EP200
EP6K EP6k
EP760 EP760
EP500Pro EP500Pro
FP Fridge Product
PR100V2,EL100V2,AORA100V2 Premium 100 V2,Elite 100 V2,AORA 100 V2
PR200V2,Elite 200 V2,AORA200 Premium 200 V2,Elite 200 V2,AORA 200 V2
PR30V2,EL30V2 Premium 30 V2,Elite 30 V2,AORA 30 V2
RV5 RV5
Balco260,Balco500 Balco260,Balco500
AC300,AC500 AC300,AC500
AC200PL,AC200L AC200PL,AC200L

📦 Integration installation

There are two ways to install BLUETTI Power Station Integration.

Install manually

  1. Enter the Home Assistant configuration directory

    cd /<ha workspaces>/core/config/custom_components
  2. Clone BLUETTI Power Station Integration github repository.

    git clone https://github.com/bluetti-official/bluetti-home-assistant.git
  3. Or download the integrated zip file and extract it to the custom integration directory of Home Assistant:

    unzip xxx.zip -d /<ha workspaces>/core/config/custom_components/bluetti
  4. Reboot your Home Assistant system.

Install by HACS

As the BLUETTI Power Station Integration has not yet been submitted to the official HACS repository, it is necessary to manually add a custom repository. HACS itself is a Home Assistant plugin (users need to install HACS first), similar to an app store. Through this app store, other third-party integrations can be installed.

  1. Follow the steps "HACS -> Integration -> Custom Repository (it is in the upper right corner of the page)".

  2. Add repository and make the type selection:

  3. Then, on the "Integration" page of HACS, you can see the BLUETTI Integration. Click to install.

  4. Finally, Reboot your Home Assistant system.

⚙️ Integration configuration

  1. Follow the steps "Settings -> Devices & services", click to enter the Integration List page.

  2. Click the "Add Integration" button, then search for the brand keyword bluetti; select the BLUETTI integration to proceed with the OAUTH authorization login.

  3. You must agree that Home Assistant can access your BLUETTI account and establish a connection with the BLUETTI cloud service.

  4. Enter your BLUETTI account to authorize and login.

  5. You must agree that Home Assistant link to your BLUETTI account.

  6. Select your BLUETTI power station devices that need to be used and managed in Home Assistant. If your Hub A1/Apex 300 system is missing from the device list, enter the Hub A1 serial number in the Hub A1 serial numbers field. Multiple serial numbers can be separated with commas, spaces, or new lines.

❓ Frequently Asked Questions (FAQ)

Not found BLUETTI Integration after installation?

Please check whether the custom_components path is correct and confirm whether the Home Assistant system has been restarted.

Always offline or failed connect to BLUETTI server?

Please check the network, ports and firewall to ensure that Home Assistant can access the power station devices.

How to update the BLUETTI Integration?

  1. Enter the HACS management page to perform the update.

  2. Update using git

    cd /<ha workspaces>/config/custom_components/bluetti
    git pull

Notice

Balco260 Self-consumption mode need connect the electricity meter

📮 Support & Feedback

💬 Have any problems or suggestions? Create an issue on GitHub: https://github.com/javaDevJT/bluetti-home-assistant/issues

About

BLUETTI Home Assistant integration fork with read-only Hub A1 support for Apex 300 systems

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages