小米BLE

集成使用小米米家BLE MiBeacon协议和在MiScales及MiFora植物传感器中实现的BLE协议的设备。该集成不支持小米BLE Mesh设备。该集成监听设备自行发出的蓝牙广播，允许跟踪最新的传感器值或事件，而无需唤醒设备进行轮询（除了HHCCJCY01，请参见下面的注释）。这种方法可以节省电池寿命。

一旦启用并正常工作蓝牙集成，集成就会自动发现设备。实体在首次接收到值后添加。这意味着如果对应的值以较低的频率广播（例如，电池），实体可能稍后才会出现。

配置

要将 小米BLE integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

加密

某些设备使用AES加密来保护它们广播的传感器值。

• MiBeacon v2/v3使用未认证的AES，密钥为24个字符十六进制（12字节）
• MiBeacon v4/v5使用认证的AES，密钥为32个字符十六进制（16字节）

该密钥称为bindkey或beaconkey。

获取设备bindkey的几种方法：

• 对于v4和v5设备，您可以提供与设备绑定的Xiaomi Cloud帐户的登录凭据。Home Assistant将从您的帐户导入适当的bindkey。
• 使用令牌提取器工具从小米云提取密钥。
• 设置您自己的密钥。Telink Flasher由pvvx提供，允许您为它支持的设备（LYWSD03MMC、MJWSD05MMC、MHO-C401、CGG1和CGDK2）生成新的bindkey。该在线闪存工具还允许您上传替代固件，与原厂固件相比，具有一些改进，如更快的传感器更新。请注意，新的bindkey在Home Assistant中有效，但一旦通过TeLink flasher应用程序激活，Mi Home应用程序将不再识别传感器。要再次在小米Mi Home应用中使用传感器，需要在Mi Home应用中删除该设备然后重新添加。
• 另一个Telink Flasher由atc1441提供，也允许您生成新的bindkey，并支持比pvvx的Telink Flasher更多的小米设备。
• Yeelight Remote (YLYK01YL)和调光器 (YLKG07YL和YLKG08YL)可以使用V2/V3 MiBeacon加密，尽管最近的设备似乎配备了V4/V5加密。对于V2/V3 MiBeacon加密，无法通过上述方法确定bindkey。有关如何获取这些设备的bindkey的说明，请参见BLE监视器FAQ。

设备

植物传感器：Flower Care / MiFlora (HHCCJCY01)

HHCCJCY01，也称为MiFlora或“Flower Care”，应该会被自动发现。然而，如果固件过旧，它将无法发送正确的BLE信标，则需要通过应用程序进行更新。确认的最低工作固件版本为3.2.1（较低的3.x版本也可能可以）。

Flower Care固件更新步骤：

• 安装HHCC的官方“Flower Care”应用：
  • Google Play（需要位置和存储权限）
  • Apple App Store
• 将设备与应用放在距离植物传感器10cm内
• 在应用的设备标签中按右上角的“+”按钮
• 将植物传感器添加到应用并选择任意植物
• 等待传感器的同步完成，应该会出现一个提示对话框询问是否更新固件（这可能需要几分钟）
• 通过选择植物->三点菜单->硬件设置->硬件更新，可以验证已安装和最新的固件版本
• 该集成不再需要Flower Care帐户和应用程序才能工作

还需要注意，植物传感器的电池电量只能通过连接设备（读取特征）来检索，而其他传感器数据是被动广播的。为了防止电池耗尽，连接每天只进行一次。连接设备还要求设备有良好的信号强度。