# jetlinks-protocol **Repository Path**: chenzhang001/jetlinks-protocol ## Basic Information - **Project Name**: jetlinks-protocol - **Description**: jetlinks协议开发 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-04-07 - **Last Updated**: 2026-09-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 物联网协议使用指南 ## 四信网关 ### 上报 上报的topic为 > /sixin/{产品id}/{设备id}/thingmodelproperty/report 上报的payload为 ```json { "did": "sn", "utime": "1970/01/01 01:12:55", "content": [{ "pid": "1", "type": "0", "addr": "1_1_huiwei", "addrv": "11", "ctime": "1970/01/01 01:12:55" }] } ```

说明:

网关相关 ```text 1.产品id:物联网->设备管理->产品->新增->ID字段 由平台自动生成 2.设备id:物联网->设备管理->设备->新增->ID字段 这里对应要上报的网关配置的数据中心号 使用1号数据中心上报的这里就是 sn_1 3.上报的payload: did:网关的sn号(由于四信网关的sn号不能修改,使用它本身的sn号) 注意是网关的sn号不是数据中心号 utime:上报的时间戳 content上报的内容: pid:PLC的站号对应实际设备占用的ip地址段,若PLC使用的是192.168.158.1那此处填写1,若PLC使用的是192.168.158.2那此处填写2 ......以此类推 type:数据类型。0 为模拟量、1 为遥信量 addr:采集地址。此处是 "数据中心序号_PLC站号_属性(属性跟平台配置的保持一致 例如:1号数据中心的1号PLC的temp 此处就对应 1_1_temp)" addrv:采集值 ctime:采集时间 ``` 子设备相关 ```text 子设备的sn号为 网关sn号_数据中心序号_PLC站号 即我在网关的上面添加了数据中心1、下面使用的是192.168.128.1这台PLC 那么此处子设备的id应该设置为 sn_1_1 ``` ### 下发 下发的topic为 > /sixin/{产品id}/{设备id}/thingmodelproperty/set 下发的payload,转换过程平台的encode函数做了、只需要在平台配置即可,但如果需要通过MQTTX发送,可以发送下面的json数据给对应网关设备 ```json { "did": "sn", "utime": "1970/01/01 01:12:55", "content": [{ "pid": "1", "type": "0", "addr": "1_1_huiwei", "addrv": "11", "ctime": "1970/01/01 01:12:55" }] } ``` 下发的操作 ```text 1. 在物联网->设备管理->设备->网关1->详情信息->物模型->功能定义中添加对应的功能 2.标识: control+控制的PLC站号 例如我需要控制1号PLC的下面的属性 此处填写control1 是否异步选择是、 3.输入参数填写对应的addr的值,例如我想要控制1号数据中心的1号PLC的temp值 可以写成 1_1_temp 其他的参数按规范填写即可 4.保存后在对应的网关的 物联网->设备管理->设备->网关1->详情信息->设备功能 中可以查看到对应的功能 ``` ## 有人网关 ### 上报 上报的topic为 > /youren/{产品id}/{设备id}/thingmodelproperty/report 上报的payload为 ```json { "1_1_temp": "23.4", "1_1_humidity": "55.6" } ```

说明:

网关相关 ```text 1.产品id:物联网->设备管理->产品->新增->ID字段 由平台自动生成 2.设备id:物联网->设备管理->设备->新增->ID字段 这里对应要上报的网关配置的数据中心号 当前有人网关没有数据中心、故默认是一号数据中心传来的 创建出的网关设备的id均为 sn_1 3.上报的payload: 每个key的构成如下: 数据中心序号_PLC站号_属性构成 例如 1_1_temp是数据中心1下的1号站的temp属性、1_1_humidity是数据中心1下的1号站的humidity属性 ``` 子设备相关 ```text 子设备的sn号为 网关sn号_数据中心序号_PLC站号 即我在网关的上面添加了数据中心1、下面使用的是192.168.128.1这台PLC 那么此处子设备的id应该设置为 sn_1_1 ``` ### 下发 下发的topic为 > /youren/{产品id}/{设备id}/thingmodelproperty/set 下发的payload,转换过程平台的encode函数做了、只需要在平台配置即可,但如果需要通过MQTTX发送,可以发送下面的json数据给对应网关设备 ```json { "rw_prot": { "Ver": "1.0.1", "dir": "down", "id": "10001", "r_data": [], "w_data ": [{ "name": "1_1_temp", "value": "data", "err": "0" }] } } ``` ```text 说明: rw_prot:读写属性 Ver:协议版本、M100系列的默认是1.0.1 dir:数据上传方向 up:上报 down:下发 id: 站号(1-255) r_data:数据读取字段 name:属性名称,定义的哪个数据中心哪个PLC站地址的哪个属性、例如 1_1_temp 为1号数据中心1号PLC站地址下的temp属性 value:属性值 err:错误码 0:正常 1:异常 ``` 下发的操作 ```text 1. 在物联网->设备管理->设备->网关1->详情信息->物模型->功能定义中添加对应的功能 2.标识: control+控制的PLC站号 例如我需要控制1号PLC的下面的属性 此处填写control1 是否异步选择是、 3.输入参数填写对应的addr的值,例如我想要控制1号数据中心的1号PLC的temp值 可以写成 1_1_temp 其他的参数按规范填写即可 4.保存后在对应的网关的 物联网->设备管理->设备->网关1->详情信息->设备功能 中可以查看到对应的功能 ``` #### 注意 ```text 1.当前下发的数据是非常规点位的、例如使用的网关DO、DI、AO、AI等点位的,需要注意下发的格式: 1.1 在网关配置界面(192.168.0.7)中,json模板中将该点位设置为 1_1_DO01_BOOL,例如: { "1_1_DO01_BOOL": "DO01", "1_1_DO02_BOOL": "DO02", "1_1_DO11_BOOL": "DO11", "1_1_DI01_BOOL": "DI01", "1_1_DI02_BOOL": "DI02", "1_1_DI11_BOOL": "DI11" } 1.2 在平台上(mqtt.whhksj.com)的 设备管理 -> 设备 -> 网关设备 -> 物模型 -> 功能定义 -> 输入参数中,添加参数标识 1_1_DO01_BOOL 此处的 1_1_DO01_BOOL 说明: 数据中心号_PLC站号_属性名称_BOOL 最后的_BOOL是一个特殊的后缀表示该属性是特殊点位,必须加 ``` ## MCGS触摸屏 ### 上报 上报的topic为 > /mcgs/{产品id}/{设备id}/thingmodelproperty/report 上报的payload为 ```json { "properties": { "1_1_temp": "23.4", "1_1_humidity": "55.6" } } ```

说明:

网关相关 ```text 1.产品id:物联网->设备管理->产品->新增->ID字段 由平台自动生成 2.设备id:物联网->设备管理->设备->新增->ID字段 这里对应要上报的mcgs的屏的sn号、 可以自定义为mcgs_1、 3.上报的payload: properties:代表属性块 在属性块中填写屏要传输的每一个属性 key格式:数据中心序号_点位号_属性名称 value格式:int、float、double、bool、String等都支持 ``` **注意:在同一个物联网系统中录入的mcgs屏的sn号不能重复,比如在物联网192.168.158.1这个ip对应的平台上接入了mcgs_1的屏,要想再接入其他屏需要将下一块屏的sn号改为mcgs_2以此类推...** 子设备相关 ```text 子设备的sn号为 网关sn号_数据中心序号_PLC站号 可以根据mcgs屏对应控制的点位来配置、若一个屏对应一个点位那么可以在平台的子设备创建时设置deviceId为mcgs_1_1,若有多个则mcgs_1_2以此类推...... ``` ### 下发 下发的topic为 > /mcgs/{产品id}/{设备id}/thingmodelproperty/set 下发的payload,转换过程平台的encode函数做了、只需要在平台配置即可,但如果需要通过MQTTX发送测试,可以发送下面的json数据给对应网关设备 ```json { "properties": { "1_1_temp": "23.4", "1_1_humidity": "55.6" } } ``` 下发的操作 ```text 1. 在物联网->设备管理->设备->网关1->详情信息->物模型->功能定义中添加对应的功能 2.标识: control+控制的PLC站号 例如我需要控制1号PLC的下面的属性 此处填写control1 是否异步选择是、 3.输入参数填写对应的属性的key,例如我想要控制1号数据中心的1号PLC的temp值 可以写成 1_1_temp 其他的参数按规范填写即可 4.保存后在对应的网关的 物联网->设备管理->设备->网关1->详情信息->设备功能 中可以查看到对应的功能 ``` ## 迅饶网关 ### 上报 上报的topic为 > /edge/{产品id}/{设备id}/rtg 上报的payload为 ```json { "devs": [{ "d": [{ "m": "1_1_WD", "ts": 1555694379, "v": 0 }, { "m": "1_1_SD", "ts": 1555694379, "v": 0 }], "dev": "1" }], "pKey": "/edge/2075470832625668096/2075471192853467136/rtg", "sn": "/cloud/2075470832625668096/2075471192853467136/cmd/set", "ts": 1555694379, "ver": "2.0.0" } ```

说明:

网关相关 ```text 1.产品id:物联网->设备管理->产品->新增->ID字段 由平台自动生成,对应迅饶网关的主题 2.设备id:物联网->设备管理->设备->新增->ID字段 可以直接使用平台生成的设备id作为 迅饶网关的sn号 3.上报的payload: devs:代表设备数组,支持上报多个设备及多个属性 devs中的每个对象: d:点位数组 m:点位名称(需要配置为 1_1_temp形式,意为第一个站的第一个传感器设备的temp属性) ts:上报的时间戳 v:点位的值 dev:设备名(需要配置为 1、2等对应设备序号) pKey:迅饶网关的MQTT配置中的主题(改动:现使用新奥数能v2,这个pKey表示的是网关上报给平台的topic) sn:迅饶网关的MQTT配置中sn号(改动:现使用新奥数能v2,这个sn表示的是平台下发给网关的topic) ts:上报的时间戳 ver:协议版本默认2.0.0 ``` **现使用新奥数能v2这个云平台厂家,需要纠正一下主题跟网关ID的配置: 主题(网关发给平台的json中 pKey) 需要填写网关上报给平台的topic 网关ID(网关发给平台的json中的 sn) 需要填写平台下发给网关的topic** 子设备相关 ```text 子设备的sn号为 网关sn号_站号_传感器序号 例如 sn_1_1,sn_2_1,sn_3_1代表的是sn这台网关下的序号1的站的1号传感器、序号2的站下的1号传感器、序号3的站下的1号传感器以此类推...... ``` ### 下发 下发的topic为 > /cloud/{产品id}/{设备id}/cmd/set 下发的payload,转换过程平台的encode函数做了、只需要在平台配置即可,但如果需要通过MQTTX发送测试,可以发送下面的json数据给对应网关设备 ```json { "ver": "v2.0.0", "pKey": "/edge/2075470832625668096/2075471192853467136/rtg", "sn": "/cloud/2075470832625668096/2075471192853467136/cmd/set", "seq": 1012800, "type": "cmd/set", "ts": 1569724110, "data": { "sysid": "1169925172722737152", "dev": "1", "m": "1_1_WD", //要控制多个、这里可以改为 1_1_WD|1_2_WD "v": 23.6 //要控制多个这里可以改为 23.6|23.7 } } ``` 下发的操作 ```text 1. 在物联网->设备管理->设备->网关1->详情信息->物模型->功能定义中添加对应的功能 2.标识: control+"_"+专业代码+"_"+对应的属性代码 例如我需要控制风机盘管专业下的传感器设备温度 此处填写control_FJPG_WDSZ 是否异步选择是。 3.输入参数填写对应的属性的key,例如我想要控制该网关下的1号站的1号传感器的WDSZ值 可以写成 1_1_WDSZ 其他的参数按规范填写即可 4.保存后在对应的网关的 物联网->设备管理->设备->网关1->详情信息->设备功能 中可以查看到对应的功能 ``` 注意:新奥数能v2这个云平台厂家。以上配置的控制需要在网关中添加,在子设备中添加的会控制不成功 ## 星纵物联网关 ### 上报 上报的topic为 > /milesight/{产品id}/{设备id}/thingmodelproperty/report 上报的payload为 ```json { "applicationID": 1, "devEUI": "24e124126d494890", "deviceName": "6221E2457672_1_24E124126D494890", "fPort": 85, "properties": { "temperature": 30.9 } } ```

说明:

网关相关 ```text 1.产品id:物联网->设备管理->产品->新增->ID字段 由物联网平台自动生成 2.设备id:物联网->设备管理->设备->新增->ID字段 网关sn号(网关后台->状态查看) 3.上报的payload: applicationID: 网关后台自动生成的应用ID、不用配置 devEUI: 网关后台设置的设备EUI、从NFC扫码获取 deviceName: 网关后台设置的设备名称、 网关sn号(网关后台->状态查看) fPort: 设备通讯时候的数据端口、从NFC扫码获取 properties: 经过载荷编解码器解码后的json数据 ``` 子设备相关 ```text 子设备的sn号为 配置应遵循网关sn号(网关后台->状态查看)_数据中心序号(默认1)_devEUI(从NFC扫对应设备获取) 例如 6221E2457672_1_24E124126D494890 代表的是6221E2457672这台网关下的devEUI为24E124126D494890的传感器设备(终端)...... ``` ### 下发 下发的topic为 > /milesight/{产品id}/{设备id}/thingmodelproperty/set 下发的payload,转换过程平台的encode函数做了、只需要在平台配置即可,但如果需要通过MQTTX发送测试,可以发送下面的json数据给对应网关设备 ```json { "data": "A2duAA==", "fport": 85, "confirmed": true, "devEUI": "24E124126D494890" } ``` 下发的操作 ```text 1. 在物联网->设备管理->设备->网关->详情信息->物模型->功能定义中添加对应的功能 2.标识: control+控制的设备devEUI 例如我需要控制24E124126D494890设备的下面的属性 此处填写control24E124126D494890 是否异步选择是、 3.输入参数填写对应的属性的key,例如我想要控制sn号为6221E2457672的网关[数据中心为1]下的设备EUI为24E124126D494890的设备fport为85的值 可以写成 6221E2457672_1_24E124126D494890_85 其他的参数按规范填写即可 4.保存后在对应的网关的 物联网->设备管理->设备->网关->详情信息->设备功能 中可以查看到对应的功能 ```