core icon indicating copy to clipboard operation
core copied to clipboard

Add BMS BLE integration

Open patman15 opened this issue 2 weeks ago • 0 comments

Proposed change

This is the PR add support for integrating over 30 different battery management systems (even more battery brands/models). The new integration bms_ble Bluetooth Low Energy (BLE) battery management systems (BMS) that is currently available as HACS integration. The sensors follow a consistent schema, while the BMS themself have a big variance in published data points. I oriented my self on the principles that the NUT integration uses, i.e. consistent data over a wide variety of devices.

  • The data is received via local polling over Bluetooth Low Energy with the library aiobmsble with the changelog.
  • The manifest of the integration is kept as short as possible, but due to high number of supported devices it's still quite long. Selection of supported devices is done in a second step in the library. Test data ensures the consistency between the two steps.
  • If desired, virtual integrations could be added for the most popular devices

Type of change

  • [ ] Dependency upgrade
  • [ ] Bugfix (non-breaking change which fixes an issue)
  • [x] New integration (thank you!)
  • [ ] New feature (which adds functionality to an existing integration)
  • [ ] Deprecation (breaking change to happen in the future)
  • [ ] Breaking change (fix/feature causing existing functionality to break)
  • [ ] Code quality improvements to existing code or addition of tests

Additional information

  • This PR fixes or closes issue: fixes #
  • This PR is related to issue:
  • Link to documentation pull request: https://github.com/home-assistant/home-assistant.io/pull/42675
  • Link to developer documentation pull request:
  • Link to frontend pull request:

Checklist

  • [x] I understand the code I am submitting and can explain how it works.
  • [x] The code change is tested and works locally.
  • [x] Local tests pass. Your PR cannot be merged unless tests pass
  • [x] There is no commented out code in this PR.
  • [x] I have followed the development checklist
  • [x] I have followed the perfect PR recommendations
  • [x] The code has been formatted using Ruff (ruff format homeassistant tests)
  • [x] Tests have been added to verify that the new code works.
  • [x] Any generated code has been carefully reviewed for correctness and compliance with project standards.

If user exposed functionality or configuration variables are added/changed:

If the code communicates with devices, web services, or third-party tools:

  • [x] The manifest file has all fields filled out correctly.
    Updated and included derived files by running: python3 -m script.hassfest.
  • [x] New or updated dependencies have been added to requirements_all.txt.
    Updated by running python3 -m script.gen_requirements_all.
  • [x] For the updated dependencies - a link to the changelog, or at minimum a diff between library versions is added to the PR description.

To help with the load of incoming pull requests:

patman15 avatar Dec 21 '25 18:12 patman15