联犀开发者文档

设备远程配置

约 981 字大约 3 分钟

2025-03-03

功能概述

设备使用场景中，对于需要更新系统参数（如：设备的 IP、端口号和串口参数等）的设备，可采用远程配置功能对设备系统参数进行更新。

功能详情

设备远程配置分为物联网平台主动下发和设备端主动请求两种配置更新方式。对于同一产品下所有设备均需更新配置的场景，可采用物联网平台主动下发的形式，将配置信息通过远程配置 Topic 下发到同一产品下的所有设备中。对于部分设备更新配置信息的场景，可采用设备端主动请求远程配置 Topic 的方式来完成。

  • 远程配置请求 Topic：$config/up/get/{productID}/{deviceName}
  • 远程配置订阅 Topic：$config/down/get/{productID}/{deviceName}

参数说明

  • {productID}：产品ID。
  • {deviceName}：设备ID。
  • 通用请求参数
参数类型必填说明
msgTokenString是用于上下行消息配对标识
sys.noAskbool否云端是否回复设备
sys.retMsgbool否是否返回错误信息,字段为msg
示例:
{
  "method": "reportInfo",
  "msgToken": "1234567",
  "sys": {
     "noAsk": false,
     "retMsg": true
  }
}

物联网平台主动下发

  1. 远程配置订阅通知 Topic:$config/down/push/{productID}/{deviceName}
  2. 在联犀中配置界面输入 JSON 格式的配置信息。
  3. 单击【批量更新】，即可将配置信息通过远程配置订阅 Topic 批量下发到该产品下的所有设备中。
    云端通过远程配置订阅 Topic 下发的消息内容格式如下：
{
  "method":"push",     
  "payload":"yourConfigurationMessage",
  "code":200,
  "msg":"success"
}
  1. 参数说明：
字段类型含义
methodstring物联网平台主动下发时取值 push。
- push：物联网平台主动下发
- reply：设备端主动请求
codeint200 表示成功
msgstring当 code 非200的时候，提示错误信息
payloadstring配置信息内容详情

设备端成功接收到物联网通信下发的配置信息之后，设备端通过调用 SDK 中提供的回调函数获取到配置信息，并将信息更新到设备的系统参数中。此部分更新配置参数逻辑需用户自定义。

设备端主动请求

  1. 在控制台配置界面开启远程配置开关，并输入 JSON 格式的配置信息。
  2. 设备端订阅远程配置 Topic，并通过 Topic 发送远程配置请求。
  3. 云端成功接收到设备请求远程配置信息之后,通过远程配置订阅 Topic 将配置界面的设备配置信息下发到设备端。
    • 设备发送配置请求信息的内容固定如下：
{"method":"get"}
  • 参数说明：
字段类型含义
methodstring设备端主动请求时取值 get
  • 云端通过远程配置订阅 Topic 下发的消息内容格式如下：
{ 
  "method":"reply",       
  "payload":"yourConfigurationMessage" ,
  "code":200,
  "msg":"success"
}
  • 参数说明：
字段类型含义
methodstring设备端主动请求时取值 reply。
- push：物联网平台主动下发
- reply：设备端主动请求
codeint200 表示成功
msgstring当 code 非200的时候，提示错误信息
payloadstring配置信息内容详情
  1. 设备端接收到数据之后的操作步骤与云端主动下发部分的步骤一致。

配置信息管理

物联网平台提供配置信息管理功能，用户可在控制台查询近五次的配置信息记录。重新编辑并保存配置信息后，上一次的配置信息将显示在配置信息记录中。您可以查看编号、更新时间和配置内容，便于管理配置信息。

更新日志

2026/8/4 07:04
查看所有更新日志
  • 7e927-文档站全面重构：目录重排、首页重写、案例独立成站、应用市场下线于
  • bddea-docs: 更新文档结构、添加新内容并优化现有文档于
  • 706e5-doc于
  • ded7d-doc于
  • 80b39-doc于
  • d4fa0-doc: 更换皮肤到最新版于
  • 82830-doc于
  • 4066c-doc: 完善文档于
  • f4017-doc: 完善文档于
  • 8794f-feat: 完善项目`于
  • df9b4-初始化于