小米植物传感器接入智能家居miflora-mqtt-daemon保姆级入门指南新手必看【免费下载链接】miflora-mqtt-daemonLinux service to collect and transfer Xiaomi Mi Flora plant sensor data via MQTT to your smart home system, with cluster support 项目地址: https://gitcode.com/gh_mirrors/mi/miflora-mqtt-daemonmiflora-mqtt-daemon 是一款轻量级 Linux 服务能定时采集小米植物传感器Mi Flora的土壤湿度、光照、温度等数据并通过 MQTT 协议转发到 Home Assistant、openHAB 等智能家居系统让你用手机实时掌握每一盆植物的健康状况。本指南带你从零完成安装、配置与后台部署全程只需几行命令。一、miflora-mqtt-daemon 能做什么一句话概括把插在花盆里的小米植物传感器变成智能家居系统里的实时数据源。传感器通过低功耗蓝牙BLE上报 5 项关键数据数据项含义土壤湿度 moisture土壤含水量%判断是否该浇水土壤肥力 conductivity电导率µS/cm评估施肥情况光照 light环境光照强度lux温度 temperature空气温度°C电量 battery传感器剩余电量%工作流程主机通过蓝牙连接传感器 → 按周期默认 300 秒读取数据 → 以 JSON 格式发布到 MQTT 主题miflora/传感器名→ Home Assistant、openHAB 等系统订阅该主题实现联动。 接入过程对传感器完全无害官方米家 App 仍可正常使用。二、准备工作一台带蓝牙的 Linux 主机树莓派 3 / 0W 等均可一个已通电的小米植物传感器Mi Flora / VegTrug 兼容一个 MQTT Broker如 Eclipse Mosquitto本机或局域网内均可⚠️ Mi Flora 的 BLE 通信距离有限请确保主机与传感器保持在有效范围内否则会出现通信超时。三、快速安装Debian / Raspberry Pi OS# 1. 安装蓝牙与 Python 基础依赖 sudo apt install git python3 python3-pip bluetooth bluez # 2. 克隆项目源码 git clone https://gitcode.com/gh_mirrors/mi/miflora-mqtt-daemon.git /opt/miflora-mqtt-daemon cd /opt/miflora-mqtt-daemon # 3. 安装 Python 依赖 sudo pip3 install -r requirements.txt若使用树莓派 OS 64 位系统还需补装编译依赖避免 bluepy 构建报错sudo apt install libglib2.0-dev最后验证蓝牙工具可用gatttool --help四、配置 config.ini三步完成传感器注册程序入口为miflora-mqtt-daemon.py所有参数通过config.ini控制。先基于模板创建配置文件cp config.ini.dist config.ini vim config.ini第 1 步扫描传感器 MAC 地址sudo hcitool lescan输出中名称为Flower care的条目就是小米植物传感器C4:7C:8D:62:72:49 Flower care C4:7C:8D:62:40:29 Flower care第 2 步在 [Sensors] 段落添加传感器名字支持名称位置格式方便区分房间[Sensors] PetuniaBalcony C4:7C:8D:62:72:49 FicusLiving C4:7C:8D:62:40:29第 3 步填写 MQTT Broker 地址[MQTT] hostname 192.168.1.100 port 1883常用配置项速查完整注释见config.ini.dist配置项说明默认值reporting_method数据格式mqtt-json / homeassistant-mqtt / mqtt-homie / thingsboard-json 等mqtt-jsonperiod采集周期秒300username/passwordBroker 认证账号无tls启用 TLS 加密false五、运行测试python3 /opt/miflora-mqtt-daemon/miflora-mqtt-daemon.py配置正确时终端会持续输出各传感器的实时读数例如{light: 5424, moisture: 30, temperature: 21.4, conductivity: 1020, battery: 100}六、配置 systemd 服务开机自启、后台常驻sudo cp /opt/miflora-mqtt-daemon/template.service /etc/systemd/system/miflora.service sudo systemctl daemon-reload sudo systemctl enable miflora.service sudo systemctl start miflora.service sudo systemctl status miflora.service自带的template.service已配置Restartalways服务异常退出会自动拉起非常适合无人值守部署。七、Docker 部署可选项目自带Dockerfile适合不想在宿主机装依赖的用户docker build -t miflora-mqtt-daemon . docker run -d --name miflora-mqtt-daemon -v /opt/miflora-mqtt-daemon:/config miflora-mqtt-daemon把宿主机目录挂载到容器内/config并放入config.ini即可根据网络情况可追加--network host。八、接入 Home Assistant / openHABHome Assistant将reporting_method设为homeassistant-mqtt设备通过 MQTT 自动发现无需手动建卡。openHAB订阅主题miflora/传感器名用JSONPATH:$.moisture等方式提取各字段建立 Thing 与 Item 即可在面板展示。ThingsBoard / Wiren Board分别使用thingsboard-json与wirenboard-mqtt上报格式设备可自动注册。九、常见问题排查现象原因与解决办法通信超时、读取错误BLE 距离过远将主机移近传感器bluepy 构建失败树莓派 OS 64 位补装sudo apt install libglib2.0-dev扫描不到传感器确认蓝牙正常gatttool --help并检查hcitool lescan输出Broker 收不到数据核对hostname/port/ 认证信息确认 Broker 服务已启动十、总结通过 miflora-mqtt-daemon你只需安装依赖 → 配置传感器 → 注册服务三步就能让小米植物传感器成为智能家居的一员土壤湿度低了自动提醒浇水光照不足自动开补光灯——低成本、免 root、易维护是植物爱好者的入门首选方案。【免费下载链接】miflora-mqtt-daemonLinux service to collect and transfer Xiaomi Mi Flora plant sensor data via MQTT to your smart home system, with cluster support 项目地址: https://gitcode.com/gh_mirrors/mi/miflora-mqtt-daemon创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考