jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-18 23:06:58 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add event platform to xiaomi-ble (#31104)

Browse Source 
* Update xiaomi_ble.markdown

* Update docs

* Update source/_integrations/xiaomi_ble.markdown

---------

Co-authored-by: J. Nick Koston <nick@koston.org>
This commit is contained in:
Ernst Klamer 2024-01-31 07:03:27 +01:00 committed by GitHub
parent 2e401cb03f
commit d11ea7bea3
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 14 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
source/_integrations/xiaomi_ble.markdown
View File

@ -3,6 +3,7 @@ title: Xiaomi BLE
description: Instructions on how to integrate Xiaomi BLE devices into Home Assistant. description: Instructions on how to integrate Xiaomi BLE devices into Home Assistant.
ha_category: ha_category:
- Binary sensor - Binary sensor
- Event
- Sensor - Sensor
ha_bluetooth: true ha_bluetooth: true
ha_release: 2022.8 ha_release: 2022.8
@ -14,6 +15,7 @@ ha_domain: xiaomi_ble
ha_config_flow: true ha_config_flow: true
ha_platforms: ha_platforms:
- binary_sensor - binary_sensor
- event
- sensor - sensor
ha_integration_type: integration ha_integration_type: integration
--- ---
@ -40,11 +42,20 @@ It is possible that we detect your device because it uses the MiBeacon protocol
It also supports the following classes of binary sensors: It also supports the following classes of binary sensors:
- Door
- Light - Light
- Smoke
- Moisture - Moisture
- Motion
- Opening
- Smoke
- Toothbrush
The entities for the sensor classes are added after the values are first received. This means entities for values that are broadcasted at a lower interval (e.g., battery) might show up later. And also supports the following events:
- Motion detected (MUE4094RT only)
- Button press
The entities are added after the values are first received. This means entities for values that are broadcasted at a lower interval (e.g., battery) might show up later.
## Encryption ## Encryption
@ -57,8 +68,8 @@ This key is called the bindkey or beaconkey.
There are a few ways to obtain a bindkey for your device: There are a few ways to obtain a bindkey for your device:
- Set your own. The [Telink Flasher](https://atc1441.github.io/TelinkFlasher.html) allows you to generate new bindkeys for devices it supports. The new bind key will work with Home Assistant, but the Mi Home app will not recognize the sensor anymore once the device has been activated by the TeLink flasher application. To use the sensor again with the Xiaomi Mi Home app, the device needs to be removed and then re-added inside the Mi Home app.
- Extract the keys from Xiaomi Cloud using a [token extractor](https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor) tool. - Extract the keys from Xiaomi Cloud using a [token extractor](https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor) tool.
- Set your own. The [Telink Flasher](https://pvvx.github.io/ATC_MiThermometer/TelinkMiFlasher.html) allows you to generate new bindkeys for devices it supports (LYWSD03MMC, MJWSD05MMC, MHO-C401, CGG1, and CGDK2). The new bind key will work with Home Assistant, but the Mi Home app will not recognize the sensor anymore once the device has been activated by the TeLink flasher application. To use the sensor again with the Xiaomi Mi Home app, the device needs to be removed and then re-added inside the Mi Home app.
## Devices ## Devices