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

物美协议开源地址:

• gitee: https://gitee.com/unitedrhino/protocol-wumei (opens new window)
• github: https://github.com/unitedrhino/protocol-wumei (opens new window)

原理

简单的说就是:

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

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

安装

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

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

docker安装

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

源码安装

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

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

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

查看协议状态

1. 查看后台协议状态

1. 首先可以看到后台已经自动创建了一个物美协议, 这个是在协议初始化的时候自动创建的,不需要手动新增

2. 点进去之后可以看到该协议组件的运行状态,运行状态就是正常的.(协议会定时向联犀上报心跳,如果超时未上报会变成停止状态)

参数配置

官方文档: https://fastbee.cn/doc/link/mqtt.html (opens new window)

1. 我们先创建一个和物美产品ID相同的产品
2. 并将物美上的mqtt账号和mqtt密码复制出来

3. 在联犀对应的产品上填入协议配置

userName: 物美的mqtt账号

password: 物美的mqtt密码

设备连接测试

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

1. 连接联犀

2. 订阅topic

4. 设备上报测试

总结

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

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