aiobmsble 0.3.0__tar.gz → 0.4__tar.gz

{aiobmsble-0.3.0/aiobmsble.egg-info → aiobmsble-0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiobmsble
-Version: 0.3.0
+Version: 0.4
 Summary: Asynchronous Python library to query battery management systems via Bluetooth Low Energy.
 Author: Patrick Loschmidt
 Maintainer: Patrick Loschmidt
@@ -12,7 +12,7 @@ Project-URL: Bug Reports, https://github.com/patman15/aiobmsble/issues
 Keywords: BMS,BLE,battery,bluetooth
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.12
@@ -27,26 +27,42 @@ Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: pytest-xdist; extra == "dev"
 Requires-Dist: hypothesis; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
-Requires-Dist: ruff~=0.12.1; extra == "dev"
+Requires-Dist: ruff<0.14.0,>=0.12.1; extra == "dev"
 Dynamic: license-file
 
+[![GitHub Release][releases-shield]](https://pypi.org/p/aiobmsble/)
 [![License][license-shield]](LICENSE)
 
 # Aiobmsble
 Requires Python 3 and uses [asyncio](https://pypi.org/project/asyncio/) and [bleak](https://pypi.org/project/bleak/)
-> [!IMPORTANT]
-> At the moment the library is under development and there might be missing functionality compared to the [BMS_BLE-HA integration](https://github.com/patman15/BMS_BLE-HA/)!
-> Please do not (yet) report missing BMS support or bugs here. Instead please raise an issue at the integration till the library reached at least development status *beta*.
 
 ## Asynchronous Library to Query Battery Management Systems via Bluetooth LE
-This library is intended to query data from battery management systems that use Bluetooth LE. It is developed to support [BMS_BLE-HA integration](https://github.com/patman15/BMS_BLE-HA/) that was written to make BMS data available to Home Assistant. While the integration depends on Home Assistant, this library can be used stand-alone in any Python environment (with necessary dependencies installed).
+This library is intended to query data from battery management systems that use Bluetooth LE. This library can be used stand-alone in any Python environment (with necessary dependencies installed). It is developed to support [BMS_BLE-HA integration](https://github.com/patman15/BMS_BLE-HA/) that was written to make BMS data available to Home Assistant, but can be hopefully usefull for other use-cases as well.
+
+* [Features](#features)
+* [Usage](#usage)
+* [Installation](#installation)
+* [Troubleshooting](#troubleshooting)
+
+## Features
+- Support for autodetecting compatible BLE BMSs
+- Automatic detection of compatible BLE write mode
+- Asynchronous operation using [asyncio](https://pypi.org/project/asyncio/)
+- Any number of batteries in parallel
+- 100% test coverage plus fuzz tests for BLE data
+
+### Supported Devices
+The [list of supported devices](https://github.com/patman15/BMS_BLE-HA/blob/feature-aiobmsble/README.md#supported-devices) is maintained in the repository of the related [Home Assistant integration](https://github.com/patman15/BMS_BLE-HA).
 
 ## Usage
 In order to identify all devices that are reachable and supported by the library, simply run
 ```bash
 aiobmsble
 ```
-from the command line after [installation](#installation). In case you need the code as reference, please see [\_\_main\_\_.py](/aiobmsble/__main__.py).
+from the command line after [installation](#installation). 
+
+### From your Python code
+In case you need a reference to include the code into your library, please see [\_\_main\_\_.py](/aiobmsble/__main__.py).
 
 ### From a Script
 This example can also be found as an [example](/examples/minimal.py) in the respective [folder](/main/examples).
@@ -97,6 +113,20 @@ if __name__ == "__main__":
     asyncio.run(main(NAME))  # pragma: no cover
 ```
 
+### Testing
+For integrations tests (using pytest) the library provides advertisement data that can be used to verify detection of BMSs. To use it, include the following line into your `conftest.py`:
+```python
+pytest_plugins: list[str] = ["aiobmsble.test_data"]
+```
+
+For your tests you can then use
+```python
+def test_advertisements(bms_advertisements) -> None:
+    """Run some tests with the advertisements"""
+    for advertisement, bms_type, _comments in bms_advertisements:
+        ...
+```
+
 ## Installation
 Install python and pip if you have not already, then run:
 ```bash
@@ -119,4 +149,15 @@ pip3 install -e .[dev]
 ```
 This gives you the latest library code from the main branch.
 
-[license-shield]: https://img.shields.io/github/license/patman15/aiobmsble.svg?style=for-the-badge&cacheSeconds=86400
+## Troubleshooting
+In case you have problems with the library, please enable debug logging. You can also run `aiobmsble -v` from the command line in order to query all known BMS that are reachable.
+
+### In case you have troubles you'd like to have help with 
+
+- please record a debug log using `aiobmsble -v -l debug.log`,
+- [open an issue](https://github.com/patman15/aiobmsble/issues/new?assignees=&labels=question&projects=&template=support.yml) with a good description of what your question/issue is and attach the log, or
+- [open a bug](https://github.com/patman15/aiobmsble/issues/new?assignees=&labels=Bug&projects=&template=bug.yml) if you think the behaviour you see is misbehaviour of the library, including a good description of what happened, your expectations,
+- and put the `debug.log` **as attachement** to the issue.
+
+[license-shield]: https://img.shields.io/github/license/patman15/aiobmsble?style=for-the-badge&cacheSeconds=86400
+[releases-shield]: https://img.shields.io/pypi/v/aiobmsble?style=for-the-badge

aiobmsble-0.4/README.md

@@ -0,0 +1,131 @@
+[![GitHub Release][releases-shield]](https://pypi.org/p/aiobmsble/)
+[![License][license-shield]](LICENSE)
+
+# Aiobmsble
+Requires Python 3 and uses [asyncio](https://pypi.org/project/asyncio/) and [bleak](https://pypi.org/project/bleak/)
+
+## Asynchronous Library to Query Battery Management Systems via Bluetooth LE
+This library is intended to query data from battery management systems that use Bluetooth LE. This library can be used stand-alone in any Python environment (with necessary dependencies installed). It is developed to support [BMS_BLE-HA integration](https://github.com/patman15/BMS_BLE-HA/) that was written to make BMS data available to Home Assistant, but can be hopefully usefull for other use-cases as well.
+
+* [Features](#features)
+* [Usage](#usage)
+* [Installation](#installation)
+* [Troubleshooting](#troubleshooting)
+
+## Features
+- Support for autodetecting compatible BLE BMSs
+- Automatic detection of compatible BLE write mode
+- Asynchronous operation using [asyncio](https://pypi.org/project/asyncio/)
+- Any number of batteries in parallel
+- 100% test coverage plus fuzz tests for BLE data
+
+### Supported Devices
+The [list of supported devices](https://github.com/patman15/BMS_BLE-HA/blob/feature-aiobmsble/README.md#supported-devices) is maintained in the repository of the related [Home Assistant integration](https://github.com/patman15/BMS_BLE-HA).
+
+## Usage
+In order to identify all devices that are reachable and supported by the library, simply run
+```bash
+aiobmsble
+```
+from the command line after [installation](#installation). 
+
+### From your Python code
+In case you need a reference to include the code into your library, please see [\_\_main\_\_.py](/aiobmsble/__main__.py).
+
+### From a Script
+This example can also be found as an [example](/examples/minimal.py) in the respective [folder](/main/examples).
+```python
+"""Example of using the aiobmsble library to find a BLE device by name and print its sensor data.
+
+Project: aiobmsble, https://pypi.org/p/aiobmsble/
+License: Apache-2.0, http://www.apache.org/licenses/
+"""
+
+import asyncio
+import logging
+from typing import Final
+
+from bleak import BleakScanner
+from bleak.backends.device import BLEDevice
+from bleak.exc import BleakError
+
+from aiobmsble import BMSsample
+from aiobmsble.bms.dummy_bms import BMS  # TODO: use the right BMS class for your device
+
+NAME: Final[str] = "BT Device Name"  # TODO: replace with the name of your BLE device
+
+# Configure logging
+logging.basicConfig(level=logging.INFO)
+logger: logging.Logger = logging.getLogger(__name__)
+
+
+async def main(dev_name) -> None:
+    """Find a BLE device by name and update its sensor data."""
+
+    device: BLEDevice | None = await BleakScanner.find_device_by_name(dev_name)
+    if device is None:
+        logger.error("Device '%s' not found.", dev_name)
+        return
+
+    logger.info("Found device: %s (%s)", device.name, device.address)
+    try:
+        async with BMS(ble_device=device) as bms:
+            logger.info("Updating BMS data...")
+            data: BMSsample = await bms.async_update()
+            logger.info("BMS data: %s", repr(data).replace(", ", ",\n\t"))
+    except BleakError as ex:
+        logger.error("Failed to update BMS: %s", type(ex).__name__)
+
+
+if __name__ == "__main__":
+    asyncio.run(main(NAME))  # pragma: no cover
+```
+
+### Testing
+For integrations tests (using pytest) the library provides advertisement data that can be used to verify detection of BMSs. To use it, include the following line into your `conftest.py`:
+```python
+pytest_plugins: list[str] = ["aiobmsble.test_data"]
+```
+
+For your tests you can then use
+```python
+def test_advertisements(bms_advertisements) -> None:
+    """Run some tests with the advertisements"""
+    for advertisement, bms_type, _comments in bms_advertisements:
+        ...
+```
+
+## Installation
+Install python and pip if you have not already, then run:
+```bash
+pip3 install pip --upgrade
+pip3 install wheel
+```
+
+### For Production:
+
+```bash
+pip3 install aiobmsble
+```
+This will install the latest library release and all of it's python dependencies.
+
+### For Development:
+```bash
+git clone https://github.com/patman15/aiobmsble.git
+cd aiobmsble
+pip3 install -e .[dev]
+```
+This gives you the latest library code from the main branch.
+
+## Troubleshooting
+In case you have problems with the library, please enable debug logging. You can also run `aiobmsble -v` from the command line in order to query all known BMS that are reachable.
+
+### In case you have troubles you'd like to have help with 
+
+- please record a debug log using `aiobmsble -v -l debug.log`,
+- [open an issue](https://github.com/patman15/aiobmsble/issues/new?assignees=&labels=question&projects=&template=support.yml) with a good description of what your question/issue is and attach the log, or
+- [open a bug](https://github.com/patman15/aiobmsble/issues/new?assignees=&labels=Bug&projects=&template=bug.yml) if you think the behaviour you see is misbehaviour of the library, including a good description of what happened, your expectations,
+- and put the `debug.log` **as attachement** to the issue.
+
+[license-shield]: https://img.shields.io/github/license/patman15/aiobmsble?style=for-the-badge&cacheSeconds=86400
+[releases-shield]: https://img.shields.io/pypi/v/aiobmsble?style=for-the-badge

{aiobmsble-0.3.0 → aiobmsble-0.4}/aiobmsble/__main__.py

@@ -31,7 +31,7 @@ async def scan_devices() -> dict[str, tuple[BLEDevice, AdvertisementData]]:
     scan_result: dict[str, tuple[BLEDevice, AdvertisementData]] = (
         await BleakScanner.discover(return_adv=True)
     )
-    logger.info(scan_result)
+    logger.debug(scan_result)
     logger.info("%i BT devices in range.", len(scan_result))
     return scan_result
 

{aiobmsble-0.3.0 → aiobmsble-0.4}/aiobmsble/basebms.py

@@ -379,8 +379,8 @@ class BaseBMS(ABC):
             if reset:
                 self._inv_wr_mode = None  # reset write mode
             await self._client.disconnect()
-        except BleakError:
-            self._log.warning("disconnect failed!")
+        except (BleakError, TimeoutError) as exc:
+            self._log.error("disconnect failed! (%s)", type(exc).__name__)
 
     async def _wait_event(self) -> None:
         """Wait for data event and clear it."""

aiobmsble-0.4/aiobmsble/test_data/__init__.py

@@ -0,0 +1,95 @@
+"""Test advertisements for aiobmsble package."""
+
+from importlib import resources
+import json
+from typing import Any
+
+from bleak.backends.scanner import AdvertisementData
+import pytest
+
+from tests.bluetooth import generate_advertisement_data
+
+type BmsAdvList = list[tuple[AdvertisementData, str, list[str]]]
+
+
+def _json_dict_to_advdata(json_dict: dict[str, Any]) -> AdvertisementData:
+    """Generate an AdvertisementData instance from a JSON dictionary."""
+
+    if "manufacturer_data" in json_dict:
+        json_dict["manufacturer_data"] = {
+            int(k): bytes.fromhex(v) for k, v in json_dict["manufacturer_data"].items()
+        }
+    if "service_data" in json_dict:
+        json_dict["service_data"] = {
+            k: bytes.fromhex(v) for k, v in json_dict["service_data"].items()
+        }
+    if "platform_data" in json_dict:
+        json_dict["platform_data"] = tuple(json_dict.get("platform_data", []))
+
+    return generate_advertisement_data(**json_dict)
+
+
+@pytest.fixture
+def bms_advertisements() -> BmsAdvList:
+    """Provide all available BMS advertisements from test data directory.
+
+    Load all *_bms.json files from the packaged test data directory.
+    """
+    all_data: BmsAdvList = []
+
+    for resource in resources.files(__package__).iterdir():
+        if resource.name.endswith("_bms.json"):
+            with resource.open("r", encoding="UTF-8") as f:
+                raw_data: Any = json.load(f)
+                assert isinstance(raw_data, list)
+
+                for entry in raw_data:
+                    assert isinstance(entry, dict)
+                    assert {"advertisement", "type"}.issubset(set(entry.keys()))
+                    adv: AdvertisementData = _json_dict_to_advdata(
+                        entry["advertisement"]
+                    )
+                    bms_type: str = entry["type"]
+                    comments: list[str] = entry["_comments"]
+
+                    assert isinstance(adv, AdvertisementData)
+                    assert isinstance(bms_type, str)
+                    assert isinstance(comments, list)
+                    assert all(isinstance(c, str) for c in comments)
+                    assert resource.name == f"{bms_type}.json"
+
+                    all_data.append((adv, bms_type, comments))
+    return all_data
+
+
+@pytest.fixture
+def ignore_advertisements() -> BmsAdvList:
+    """Provide a list of advertisements that shall not be identified as a valid BMS.
+
+    Load ignore.json files from the packaged test data directory.
+    """
+    data: BmsAdvList = []
+
+    with (
+        resources.files(__package__)
+        .joinpath("ignore.json")
+        .open("r", encoding="UTF-8") as f
+    ):
+        raw_data: Any = json.load(f)
+        assert isinstance(raw_data, list)
+
+        for entry in raw_data:
+            assert isinstance(entry, dict)
+            assert {"advertisement", "reason"}.issubset(set(entry.keys()))
+            adv: AdvertisementData = _json_dict_to_advdata(entry["advertisement"])
+            reason: str = entry["reason"]
+            comments: list[str] = entry["_comments"]
+
+            assert isinstance(adv, AdvertisementData)
+            assert isinstance(reason, str)
+            assert isinstance(comments, list)
+            assert all(isinstance(c, str) for c in comments)
+
+            data.append((adv, reason, comments))
+
+    return data

aiobmsble-0.4/aiobmsble/test_data/abc_bms.json

@@ -0,0 +1,34 @@
+[
+  {
+    "advertisement": {
+      "local_name": "SOK-24V1127",
+      "service_uuids": [
+        "0000fff0-0000-1000-8000-00805f9b34fb"
+      ],
+      "rssi": -94
+    },
+    "type": "abc_bms",
+    "_comments": [
+      "source pcap (https://github.com/patman15/BMS_BLE-HA/issues/168)"
+    ]
+  },
+  {
+    "advertisement": {
+      "local_name": "SOK-AA02120",
+      "service_uuids": [
+        "00001800-0000-1000-8000-00805f9b34fb",
+        "00001801-0000-1000-8000-00805f9b34fb",
+        "0000180a-0000-1000-8000-00805f9b34fb",
+        "0000180f-0000-1000-8000-00805f9b34fb",
+        "0000ffe0-0000-1000-8000-00805f9b34fb",
+        "0000fff0-0000-1000-8000-00805f9b34fb",
+        "f000ffc0-0451-4000-b000-000000000000"
+      ],
+      "rssi": -62
+    },
+    "type": "abc_bms",
+    "_comments": [
+      "source log (https://github.com/patman15/BMS_BLE-HA/issues/394)"
+    ]
+  }
+]

aiobmsble-0.4/aiobmsble/test_data/ant_bms.json

@@ -0,0 +1,18 @@
+[
+  {
+    "advertisement": {
+      "local_name": "ANT-BLE24C-001",
+      "manufacturer_data": {
+        "8979": "88a0aabbcc900001"
+      },
+      "service_uuids": [
+        "0000ffe0-0000-1000-8000-00805f9b34fb"
+      ],
+      "rssi": -70
+    },
+    "type": "ant_bms",
+    "_comments": [
+      "source advmon (https://github.com/patman15/BMS_BLE-HA/issues/366)"
+    ]
+  }
+]

aiobmsble-0.4/aiobmsble/test_data/ant_leg_bms.json

@@ -0,0 +1,19 @@
+[
+  {
+    "advertisement": {
+      "local_name": "ANT-BLE16S",
+      "manufacturer_data": {
+        "1623": "88a0aabbcca12345"
+      },
+      "service_uuids": [
+        "0000ffe0-0000-1000-8000-00805f9b34fb",
+        "0000fee7-0000-1000-8000-00805f9b34fb"
+      ],
+      "rssi": -31
+    },
+    "type": "ant_leg_bms",
+    "_comments": [
+      "source HA Bluetooth"
+    ]
+  }
+]

aiobmsble-0.4/aiobmsble/test_data/braunpwr_bms.json

@@ -0,0 +1,34 @@
+[
+  {
+    "advertisement": {
+      "local_name": "HSKS-25A-118",
+      "manufacturer_data": {
+        "123": "02ffff7b"
+      },
+      "service_uuids": [
+        "0000ff00-0000-1000-8000-00805f9b34fb"
+      ],
+      "rssi": -70
+    },
+    "type": "braunpwr_bms",
+    "_comments": [
+      "source pcap (https://github.com/patman15/BMS_BLE-HA/issues/303)"
+    ]
+  },
+  {
+    "advertisement": {
+      "local_name": "BL-25F-170-118",
+      "manufacturer_data": {
+        "123": "02ffff7d"
+      },
+      "service_uuids": [
+        "0000ff00-0000-1000-8000-00805f9b34fb"
+      ],
+      "rssi": -76
+    },
+    "type": "braunpwr_bms",
+    "_comments": [
+      "source LOG (https://github.com/patman15/BMS_BLE-HA/issues/303)"
+    ]
+  }
+]

aiobmsble-0.4/aiobmsble/test_data/cbtpwr_bms.json

@@ -0,0 +1,90 @@
+[
+  {
+    "advertisement": {
+      "local_name": "170R000121",
+      "manufacturer_data": {
+        "21330": "2134ba03ec110cb4010500010000"
+      },
+      "service_uuids": [
+        "00001800-0000-1000-8000-00805f9b34fb",
+        "00001801-0000-1000-8000-00805f9b34fb",
+        "0000180a-0000-1000-8000-00805f9b34fb",
+        "0000fd00-0000-1000-8000-00805f9b34fb",
+        "0000ff90-0000-1000-8000-00805f9b34fb",
+        "0000ffb0-0000-1000-8000-00805f9b34fb",
+        "0000ffc0-0000-1000-8000-00805f9b34fb",
+        "0000ffd0-0000-1000-8000-00805f9b34fb",
+        "0000ffe0-0000-1000-8000-00805f9b34fb",
+        "0000ffe5-0000-1000-8000-00805f9b34fb",
+        "0000fff0-0000-1000-8000-00805f9b34fb"
+      ],
+      "tx_power": 0,
+      "rssi": -75
+    },
+    "type": "cbtpwr_bms",
+    "_comments": [
+      "source LOG, https://github.com/patman15/BMS_BLE-HA/issues/59"
+    ]
+  },
+  {
+    "advertisement": {
+      "local_name": "170R000086",
+      "manufacturer_data": {
+        "21330": "2134ba03ec110cf8010500010000"
+      },
+      "service_uuids": [
+        "00001800-0000-1000-8000-00805f9b34fb",
+        "00001801-0000-1000-8000-00805f9b34fb",
+        "0000180a-0000-1000-8000-00805f9b34fb",
+        "0000fd00-0000-1000-8000-00805f9b34fb",
+        "0000ff90-0000-1000-8000-00805f9b34fb",
+        "0000ffb0-0000-1000-8000-00805f9b34fb",
+        "0000ffc0-0000-1000-8000-00805f9b34fb",
+        "0000ffd0-0000-1000-8000-00805f9b34fb",
+        "0000ffe0-0000-1000-8000-00805f9b34fb",
+        "0000ffe5-0000-1000-8000-00805f9b34fb",
+        "0000fff0-0000-1000-8000-00805f9b34fb"
+      ],
+      "tx_power": 0,
+      "rssi": -73
+    },
+    "type": "cbtpwr_bms",
+    "_comments": [
+      "source LOG"
+    ]
+  },
+  {
+    "advertisement": {
+      "local_name": "140R000288",
+      "manufacturer_data": {
+        "0": "ffffffff6400ff000000000000000000"
+      },
+      "service_uuids": [
+        "0000fff0-0000-1000-8000-00805f9b34fb"
+      ],
+      "rssi": -82
+    },
+    "type": "cbtpwr_bms",
+    "_comments": [
+      "source BT monitor (https://github.com/patman15/BMS_BLE-HA/issues/176)"
+    ]
+  },
+  {
+    "advertisement": {
+      "local_name": "100R0002E3",
+      "manufacturer_data": {
+        "21330": "2134ba03ec110909010500010000"
+      },
+      "service_uuids": [
+        "000003c1-0000-1000-8000-00805f9b34fb"
+      ],
+      "tx_power": 0,
+      "rssi": -76
+    },
+    "type": "cbtpwr_bms",
+    "_comments": [
+      "source advmon (https://github.com/patman15/BMS_BLE-HA/issues/197)",
+      "Creabest"
+    ]
+  }
+]

aiobmsble-0.4/aiobmsble/test_data/cbtpwr_vb_bms.json

@@ -0,0 +1,20 @@
+[
+  {
+    "advertisement": {
+      "local_name": "VB024000390",
+      "manufacturer_data": {
+        "16963": "545e0211f82e0ca88942"
+      },
+      "service_uuids": [
+        "0000fff0-0000-1000-8000-00805f9b34fb",
+        "0000ffb0-0000-1000-8000-00805f9b34fb"
+      ],
+      "rssi": -73
+    },
+    "type": "cbtpwr_vb_bms",
+    "_comments": [
+      "source advmon (https://github.com/patman15/BMS_BLE-HA/issues/240)",
+      "Creabest"
+    ]
+  }
+]

aiobmsble-0.4/aiobmsble/test_data/daly_bms.json

@@ -0,0 +1,100 @@
+[
+  {
+    "advertisement": {
+      "local_name": "DL-46640102XXXX",
+      "manufacturer_data": {
+        "25670": "010209ac"
+      },
+      "service_uuids": [
+        "0000fff0-0000-1000-8000-00805f9b34fb"
+      ],
+      "rssi": -58
+    },
+    "type": "daly_bms",
+    "_comments": [
+      "source LOG (https://github.com/patman15/BMS_BLE-HA/issues/89)"
+    ]
+  },
+  {
+    "advertisement": {
+      "local_name": "DL-401710015C9B",
+      "manufacturer_data": {
+        "770": "16401710015c9b444c"
+      },
+      "rssi": -36
+    },
+    "type": "daly_bms",
+    "_comments": [
+      "source LOG, proxy (https://github.com/patman15/BMS_BLE-HA/issues/160)"
+    ]
+  },
+  {
+    "advertisement": {
+      "local_name": "JHB-501812XXXXXX",
+      "manufacturer_data": {
+        "260": "0150181201a3b34a4842"
+      },
+      "rssi": -46
+    },
+    "type": "daly_bms",
+    "_comments": [
+      "source BTctl (https://github.com/patman15/BMS_BLE-HA/issues/145)"
+    ]
+  },
+  {
+    "advertisement": {
+      "local_name": "Randomname",
+      "manufacturer_data": {
+        "260": "0150181201a4944a4842"
+      },
+      "rssi": -36
+    },
+    "type": "daly_bms",
+    "_comments": [
+      "source LOG (https://github.com/patman15/BMS_BLE-HA/issues/160#issuecomment-2629318416)",
+      "JHB-50181201A494"
+    ]
+  },
+  {
+    "advertisement": {
+      "local_name": "BT270-2",
+      "manufacturer_data": {
+        "770": "16401712011197444c"
+      },
+      "rssi": -60
+    },
+    "type": "daly_bms",
+    "_comments": [
+      "source BTctl (https://github.com/patman15/BMS_BLE-HA/issues/174#issuecomment-2637936795)"
+    ]
+  },
+  {
+    "advertisement": {
+      "local_name": "DL-40160901534C",
+      "manufacturer_data": {
+        "258": "04"
+      },
+      "rssi": -87
+    },
+    "type": "daly_bms",
+    "_comments": [
+      "source advmon (https://github.com/patman15/BMS_BLE-HA/issues/204)",
+      "16S LiFePo 250A BMS"
+    ]
+  },
+  {
+    "advertisement": {
+      "local_name": "DL-FB4C2E0000000",
+      "manufacturer_data": {
+        "771": "00b4c2e0000000444c00"
+      },
+      "rssi": -81
+    },
+    "type": "daly_bms",
+    "_comments": [
+      "proxy LOG (https://github.com/patman15/BMS_BLE-HA/issues/85)",
+      "Bulltron battery",
+      "MAC address (Bouffalo Lab)"
+    ]
+  }
+]