如何快速接入第三方协议
前言
在物联网中,存在大量的非标设备,他们有各种各样的协议,我们可以根据设备协议的差异性来采用不同的接入方案.
| 设备协议 | 特点 | 解决方案 |
|---|---|---|
| mqtt/http/coap | 具有专有认证、主题或会话约定(如阿里云alink) | 编写协议网关,适配第三方的认证及流程 |
| mqtt/http | 可使用现有接入入口完成认证与主题授权，仅载荷不一致 | 在已接入链路绑定协议脚本，转换 JSON 或二进制载荷 |
| 其他协议 | 可以通过一定的规则将物模型和自定义协议的参数对应上(物模型上可以编辑自定义字段,如modbus协议的位置和类型) | 编写协议网关进行通用的处理,后续所有该协议的设备都能支持 |
| 其他协议 | 只能通过脚本一个个去解析 | 需要编写协议网关进行基础解析,然后将数据放到脚本中,根据不同的产品或设备进行处理 |
多协议如何汇入平台
不同设备分别通过原生入口、MQTT 协议服务、私有通信或云云服务接入；现场网关按其对外协议选择对应通路。内置路径与独立协议服务分开，脚本在已经接入的消息处理中完成字段和载荷转换。
查看放大图与下载；认证分派、协议登记、上下行路由及四个脚本位置见IoT 接入与数据架构。
当然,如果我们的设备协议非常简单,比如就是一个简单的http轮询,我们也可以借助规则引擎来实现,这样的话我们的开发成本会更低. 
接入方式比较
| 协议网关 | 协议脚本 | 规则引擎 | |
|---|---|---|---|
| 是否可以自定义授权 | √ | × | √ |
| 灵活度 | 最高 | 低 | 高 |
| 性能 | 最高 | 中 | 中 |
| 支持协议的类型 | 所有协议都可以支持 | 需要协议网关或规则引擎先把基础协议接入才可以使用协议脚本 | http,mqtt,消息队列等 |
| 适用场景 | 需要高度定制的场景 | 没有特殊的授权,只需要做payload转换 | 第三方对接 |
| 开发速度 | 稍慢 | 快 | 快 |
从哪里配置协议
打开联犀物联网应用，进入「设备接入 → 协议配置」。选择配置范围后，打开协议行的「配置详情」；产品和设备也可以直接在各自详情的「设备接入」页操作。表单和填写说明由该协议网关提供。
| 接入场景 | 在哪里配置 | 接入文档 |
|---|---|---|
| 已在阿里云或腾讯云平台上的设备 | 企业级建云账号；产品级选择账号并维护云端产品标识 | 阿里云云云对接、腾讯云云云对接 |
| 已在米家 App 绑定的设备 | 企业级或项目级建账号并授权；产品详情选择米家型号并同步设备 | 小米米家云 |
| Modbus、IEC104、OPC UA | 产品级维护点位或节点，设备级维护连接参数 | Modbus、IEC104、OPC UA |
| 物美 MQTT | 产品级维护 MQTT 账号密码，设备详情查看连接信息 | 物美 MQTT |
| 使用阿里云 Alink 报文的设备直接接入联犀 | 产品和设备详情核对 Alink 身份凭证、Topic 与物模型 | 阿里云 MQTT 直连 |
云账号在选定范围内使用。企业账号同步的新设备归该企业；小米项目账号按绑定项目同步。产品需要明确关联对应账号。旧版平台级云账号需要由管理员先确认归属、迁移并复验，再切换版本，历史配置和设备不会自动迁移。
若「协议配置」未显示相应入口，请检查当前企业或项目、账号权限，以及网关是否在线并提供该层级的页面。产品或设备页面提示「配置页暂不可用」时，先到「设备接入 → 协议网关」确认网关运行状态，并核对该协议是否提供配置页。查看协议清单与其他接入文档。
从旧版升级
- 清点旧版平台账号及其关联产品、设备，明确目标企业或项目。多人共用的账号先由管理员确认归属。
- 在旧版完成企业或项目配置及产品改绑，复核设备归属、同步和消息链路。小米账号按目标配置重新授权，避免新旧链路同时使用同一刷新令牌。
- 如果试用过工业协议的企业策略，将实际需要的超时、采集周期及 OPC UA 认证参数核对后填回产品或设备。旧配置引用未处理时，先完成迁移再切换。
- 在维护窗口一次性切换平台和协议网关，验证新版本的配置页与设备消息。保留原配置和回退所需的制品。
更新日志
2026/11/11 02:18
查看所有更新日志
ade67-于ae9e0-于c4a4b-于eb33f-于b72ca-于4ab8f-于7e927-于bddea-于74719-于