OpenMQTTGateway与Jeedom智能家居平台集成指南
OpenMQTTGateway 项目地址: https://gitcode.com/gh_mirrors/op/OpenMQTTGateway
前言
OpenMQTTGateway(以下简称OMG)是一个强大的开源物联网网关项目,能够通过多种无线协议(如蓝牙、RF、红外等)与各类智能设备通信,并将数据转换为MQTT协议传输。本文将详细介绍如何将OMG与Jeedom智能家居平台进行深度集成。
Jeedom平台简介
Jeedom是一款功能强大的开源智能家居平台,具有以下核心特性:
- 场景自动化管理
- 历史数据可视化
- 图表曲线生成
- 语音/文本交互
- 直观的用户界面设计
Jeedom采用模块化架构,通过插件市场支持多种家庭自动化协议,能够整合各种异构设备。
准备工作
jMQTT插件安装
要在Jeedom中使用MQTT协议并解析JSON格式的数据负载,首先需要安装jMQTT插件:
- 进入Jeedom的"插件 > 插件管理"菜单
- 在市场中搜索"jMQTT"插件
- 安装稳定版本
- 进入插件配置页面激活插件
MQTT Broker配置
根据你的使用场景,有两种Broker配置方式:
-
本地安装Mosquitto:
- 在jMQTT配置页面勾选"本地安装Mosquitto"
- 插件会自动创建一个名为"local"的Broker
-
使用现有Broker:
- 取消勾选"本地安装Mosquitto"
- 手动配置Broker的IP地址和端口
完成依赖安装后,启动jMQTT守护进程即可完成基础配置。
OMG设备集成
创建OMG网关设备
- 在jMQTT插件页面点击"添加设备"
- 命名设备(建议与OMG配置中的网关名称一致)
- 在"订阅主题"字段中输入基础主题路径(格式为:
bt/网关名称/#
) - 勾选"自动添加命令"选项
- 激活设备并保存
等待5分钟左右,让系统自动发现并添加相关命令后,建议关闭"自动添加命令"功能。
关键命令配置
-
LWT(Last Will and Testament)命令:
- 设置为二进制信息类型
- 启用历史记录功能
- 在高级配置中设置计算公式:
#value# == "online"
-
系统监控命令:
- 可创建uptime(运行时间)、freemem(空闲内存)等监控命令
- 这些命令来自SYStoMQTT主题的JSON数据
-
重启命令:
- 创建动作命令,主题格式:
bt/网关名称/commands/MQTTtoSYS/config
- 负载内容:
{"cmd":"restart"}
- 创建动作命令,主题格式:
蓝牙设备集成
未知设备发现
- 创建新设备(非Broker类型)
- 订阅主题格式:
bt/网关名称/BTtoMQTT/#
- 启用自动命令创建功能
- 系统会自动发现并添加所有检测到的蓝牙设备
特定设备配置(以小米温湿度传感器为例)
-
识别设备的MAC地址(如:582D3431FE5F)
-
创建新设备,命名如"Xiaomi Mi Jia"
-
订阅特定主题(格式:
bt/网关名称/BTtoMQTT/MAC地址
) -
手动创建需要的命令:
- 温度(tmp)
- 湿度(hum)
- 电池电量(bat)
-
配置命令的JSON解析路径,如:
- 温度命令:
#value#.temp
- 湿度命令:
#value#.hum
- 温度命令:
仪表板定制
完成命令配置后,可以在Jeedom仪表板中:
- 添加温度、湿度等指标的显示组件
- 设置合适的图表和显示样式
- 配置告警阈值和通知
最佳实践建议
- 命名规范:保持OMG网关名称与Jeedom设备名称一致,便于管理
- 主题结构:采用清晰的层级主题结构,如
bt/网关名称/设备类型/MAC地址
- 历史记录:对重要指标启用历史记录功能,但注意存储空间管理
- 错误处理:配置适当的场景来处理设备离线等异常情况
- 性能监控:定期检查OMG网关的系统资源使用情况
版本兼容性
本文基于以下版本验证:
- OpenMQTTGateway v0.9.13
- Jeedom Core v4.2.20
- jMQTT插件 v2022-07-25
通过以上步骤,你可以将OpenMQTTGateway完美集成到Jeedom智能家居生态系统中,实现对多种无线协议设备的统一管理和控制。
OpenMQTTGateway 项目地址: https://gitcode.com/gh_mirrors/op/OpenMQTTGateway
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考