eminguez/xiaomi-ble-mqtt

镜像概述

该镜像包含一个Python脚本，用于扫描小米BLE温湿度传感器（如MJ_HT_V1型号），并将温度、湿度、电池电量等测量数据发布到指定的MQTT broker，帮助用户快速实现传感器数据的物联网化传输与集成。

核心功能

• 扫描小米BLE温湿度传感器设备
• 将传感器数据（温度、湿度、电池）发布到MQTT主题
• 支持多设备配置（不同房间/区域的传感器）
• 可配置数据平均次数、消息保留、超时时间等参数

使用场景

• 家庭物联网环境：收集各房间温湿度数据，用于智能家居控制
• 小型办公场所：监测环境温湿度，辅助空调或通风系统自动化
• 与Home Assistant、OpenHAB等平台集成，实现环境数据可视化与自动化

配置说明

1. 准备配置文件
   将mqtt.ini.sample重命名为mqtt.ini，配置MQTT broker地址、端口、用户名等信息；将devices.ini.sample重命名为devices.ini，添加传感器MAC地址、MQTT主题等配置。

2. Docker部署示例
   挂载本地配置目录到容器内（假设配置文件存放在./config）：

   bash
   docker run -d \
     --name xiaomi-ble-mqtt \
     --privileged \  # 需蓝牙权限访问设备
     -v ./config:/app/config \  # 挂载配置目录
     eminguez/xiaomi-ble-mqtt
   

3. 数据示例
   MQTT发布的payload格式：

   json
   {"temperature":25.7,"humidity":42.0,"battery":100}