Skip to content

javaDevJT/bluetti-home-assistant

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

131 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

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

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages

  • Python 100.0%