联犀开发者文档

如何使用协议网关

约 821 字大约 3 分钟

2025-03-03

联犀支持不同的设备接入,无论是云云对接的还是各种设备协议,这里以物美协议为示例来说明如何安装我们的协议网关.

物美协议开源地址:

原理

简单的说就是:

  • 上行: 设备 -xx协议> 协议转换网关 -nats> 联犀服务(dmsvr)
  • 下行: 联犀服务(通过不同的topic进行分发)-nats>协议转换网关-xx协议>设备

那么我们只需要安装对应的网关就可以实现不同的协议接入.

安装

安装可以采用docker安装,也可以采用手动编译安装.

注意: 需要先运行起联犀服务(core,things)

docker安装

  1. 首先打开我们的docker配置文件所在位置: cd things/deploy/docker/run-all
  2. 运行协议插件:

源码安装

首先下载我们的物美协议,当然,如果大家自己编写协议网关可以参考服务创建来进行创建(欢迎贡献给社区).

  1. git clone https://gitee.com/unitedrhino/protocol-wumei.git
  2. cd service/pwumeisvr
  3. go run .

注意:如果连接不上things,则需要修改etc下的配置文件

查看协议状态

  1. 查看后台协议状态
  1. 首先可以看到后台已经自动创建了一个物美协议, 这个是在协议初始化的时候自动创建的,不需要手动新增
  1. 点进去之后可以看到该协议网关的运行状态,运行状态就是正常的.(协议会定时向联犀上报心跳,如果超时未上报会变成停止状态)

参数配置

  1. 在「产品管理」创建或选择物美协议产品。迁入已有设备时，核对产品和设备在客户端所使用的标识。
  2. 在产品详情「设备接入」填写物美设备使用的 MQTT 用户名和密码，保存后同步更新设备端连接配置。
  3. 在设备详情「设备接入」查看连接信息，按物美协议接入核对 Topic 和报文格式。

云账号、工业点位及设备连接参数分别在各自范围维护，见如何快速接入第三方协议。

设备连接测试

我们随便创建一个物美协议的设备,然后用mqttx使用物美协议测试看看(mqtt参数格式参考物美官网)

  1. 连接联犀
  1. 订阅topic
  1. 设备上报测试

总结

至此我们就实现了物美协议的接入,当然物美中的ota等功能也接入了,大家可以自行测试.大家开发自己的协议的时候也可以将多个协议开发到一个协议网关中,不影响功能的实现.

大家接入了更多的协议欢迎发布到联犀中,我们一起共赢.

更新日志

2026/11/10 05:37
查看所有更新日志
  • ae9e0-docs(设备接入): 更新多协议接入流程与配置范围于
  • eb33f-Merge #35 into master from docs/third-party-protocols-update于
  • 7e927-文档站全面重构：目录重排、首页重写、案例独立成站、应用市场下线于
  • bddea-docs: 更新文档结构、添加新内容并优化现有文档于
  • 74719-doc: 完善文档于
  • d4fa0-doc: 更换皮肤到最新版于
  • f4a25-doc于
  • 82830-doc于