mirror of
https://github.com/esphome/esphome.git
synced 2026-07-11 01:15:33 +00:00
21539bdeba
Implements a BTHome v2 BLE advertisement parser component that allows ESPHome to receive and parse sensor data from BTHome-compatible BLE devices. Features: - Parse BTHome v2 format BLE advertisements - Support for sensors and binary sensors - AES-CCM encryption support with 16-byte bind keys - Independent sensor configuration (each sensor specifies MAC address and bind key) - Supports 50+ BTHome object types including temperature, humidity, motion, door, etc. Component structure: - Main component: bthome_ble (BLE device listener) - Sensor platform: supports numeric sensor types - Binary sensor platform: supports boolean sensor types Each sensor/binary_sensor independently listens for BLE advertisements from the configured MAC address and extracts the specified object type. Multiple sensors can monitor the same device by specifying the same MAC address and bind key (if encrypted). This is the complementary receiver component to the BTHome transmitter.
Tests for ESPHome
This directory contains some tests for ESPHome.
At the moment, all the tests only work by simply executing
esphome over some YAML files that are made to test
whether the yaml gets converted to the proper C++ code.
Of course this is all just very high-level and things like unit tests would be much better. So if you have time and know how to set up a unit testing framework for python, please do give it a try.
When adding entries in test_.yaml files we usually need only
one file updated, unless conflicting code is generated for
different configurations, e.g. wifi and ethernet cannot
be tested on the same device.
Current test_.yaml file contents.
| Test name | Platform | Network | BLE |
|---|---|---|---|
| test1.yaml | ESP32 | wifi | None |
| test2.yaml | ESP32 | ethernet | esp32_ble_tracker |
| test3.yaml | ESP8266 | wifi | N/A |
| test4.yaml | ESP32 | ethernet | None |
| test5.yaml | ESP32 | wifi | ble_server |
| test6.yaml | RP2040 | wifi | N/A |
| test7.yaml | ESP32-C3 | wifi | N/A |
| test8.yaml | ESP32-S3 | wifi | None |
| test10.yaml | ESP32 | wifi | None |