ET21XX系列-ET2120-ET2110-ET2100-Json交互协议-成都纵横智控

ET21XX系列-ET2120-ET2110-ET2100-Json交互协议

2025-06-09 11:00:10 阅读：发布人：纵横智控

数据格式

请求帧格式
字段	必须	类型	描述
msgType	是	string	get_req（读操作）/set_req（写操作）
msgPath	是	string	指示目标数据点，下文有详细介绍
msgId	是	string	默认时间戳，用于匹配请求帧和响应帧
data	是	string	msgPath不同，data格式不同

响应帧格式
字段	必须	类型	描述
msgType	是	string	get_res（读响应）/set_res（写响应）
msgPath	是	string	指示目标数据点，下文有详细介绍
msgId	是	string	和请求帧msgId保持一致
code	是	int	状态码0-成功；其他-失败错误码
data	是	string	msgPath不同，data格式不同

1. 设备信息

msgPath支持：/devInfo。不同属性描述如下所示：

字段	读/写	类型	描述
addr	读	int	设备Modbus地址(1-255)
ver	读	int	固件版本号
model	读	string	ET2100
cmd	写	int	系统命令1-重启2-复位

1.1. 读操作

读取设备信息示例：

/*请求*/

{

"msgType": "get_req",

"msgId": "123456001",

"msgPath": "/devInfo"

}

/*响应*/

{

"msgType": "get_res",

"msgId": "123456001",

"msgPath": "/devInfo",

"code": 0,

"data": {

"addr": 1,

"ver": 4,

"model":"ET2100"

}

1.2. 写操作

设置设备信息示例：

/*请求*/

{

"msgType": "set_req",

"msgId": "123456001",

"msgPath": "/devInfo",

"data": {

"cmd":1

}

/*响应*/

{

"msgType": "set_res",

"msgId": "123456001",

"msgPath": "/devInfo",

"code": 0

}

2. LoRa信息

msgPath支持：/loraInfo 。不同属性描述如下所示：

字段	类型	类型	描述
netId	读/写	int	网络ID，不同网络ID的设备无法直接通信，1-255
mode	读/写	int	0-正常模式 1-中继模式
relayA	读/写	int	被中继的网络ID，1-255
relayB	读/写	int	被中继的网络ID，1-255
bps	读/写	int	无线空中速率，2400/4800/9600/19200/38400/62500
power	读/写	int	发射功率，30/27/24/21
channel	读/写	int	信道，0-83，默认23，国内工作频率=410.125+231=433.125Mhz 国际工作频率=850.125+231=873.125Mhz
rssi	读/写	int	0-禁用 1-启用，启用后串口输出跟随一个字节表示RSSI
keyH	读/写	int	用于加密
keyL	读/写	int	用于加密

2.1. 读操作

读取LoRa信息示例：

/*请求*/

{

"msgType": "get_req",

"msgId": "123456001",

"msgPath": "/loraInfo"

}

/*响应*/

{

"msgType": "get_res",

"msgId": "123456001",

"msgPath": "/loraInfo",

"code": 0,

"data": {

"netId": 1,

"mode": 0,

"relayA": 1,

"relayB": 1,

"bps": 2400,

"power": 30,

"channel": 0,

"rssi": 0

}

2.2. 写操作

设置LoRa信息示例：

/*请求*/

{

"msgType": "set_req",

"msgId": "123456001",

"msgPath": "/loraInfo",

"data": {

"netId": 1,

"mode": 1,

"relayA": 1,

"relayB": 1,

"bps": 2400,

"power": 30,

"channel": 0,

"rssi": 0,

"keyH": 127,

"keyL": 127

}

/*响应*/

{

"msgType": "set_res",

"msgId": "123456001",

"msgPath": "/loraInfo",

"code": 0

}

3. 逻辑信息

共8条可用逻辑，msgPath支持：/logicInfo/x。不同属性描述如下所示：

字段	读/写	类型	描述
mode	读/写	int	0-关闭逻辑1-正向跟随2-反向跟随 3-模拟量跟随4-大于等于5-小于等于
addr	读/写	int	01H-FEH，跟随的远端设备的地址码
inReg	读/写	int	输入寄存器地址，0表示DI1或者AI1，取值范围[0-7]
outType	读/写	int	输出寄存器类型，0-DO输出4-AO输出
outReg	读/写	int	输出寄存器地址，0表示DO1或者AO1，取值范围[0-7]
thr	读/写	int	在模式4和模式5时AI比较的阈值，0-25000，单位uA
outTime	读/写	int	在模式1/2时DO跟随DI断联超时时间，0-65535，单位秒，在模式3时AO跟随AI断联超时时间，0-65535，单位秒
outThr	读/写	int	在模式3时AO跟随AI断联后输出值，0-25000，单位uA
action	读/写	int	在模式1/2时DO跟随DI断联后DO执行动作，在模式4/5时条件满足时DO执行动作， 0-断开1-闭合2-翻转

3.1. 读操作

读取逻辑信息示例：

/*请求*/

{

"msgType": "get_req",

"msgId": "123456001",

"msgPath": "/logicInfo/0"

}

/*响应*/

{

"msgType": "get_res",

"msgId": "123456001",

"msgPath": "/logicInfo",

"code": 0,

"data":{

"mode": 1,

"addr": 60,

"inReg": 55,

"outType": 0,

"outReg": 55,

"thr": 2000,

"outTime": 10,

"outThr": 4000,

"action": 1

}

3.2. 写操作

设置逻辑信息示例：

/*请求*/

{

"msgType": "set_req",

"msgId": "123456001",

"msgPath": "/logicInfo/0",

"data":{

"mode": 1,

"addr": 60,

"inReg": 55,

"outType": 0,

"outReg": 55,

"thr": 2000,

"outTime": 10,

"outThr": 4000,

"action": 1

}

/*响应*/

{

"msgType": "set_res",

"msgId": "123456001",

"msgPath": "/logicInfo",

"code": 0

}

4. 串口信息

msgPath支持：/uartInfo。不同属性描述如下所示：

字段	读/写	类型	描述
baudrate	读/写	int	波特率，2400-921600，默认115200
bytesize	读/写	int	数据位，89
parity	读/写	int	校验位，0-NONE1-ODD2-EVEN
stopbit	读/写	int	停止位，12

4.1. 读操作

读取串口信息示例：

/*请求*/

{

"msgType": "get_req",

"msgId": "123456001",

"msgPath": "/uartInfo"

}

/*响应*/

{

"msgType": "get_res",

"msgId": "123456001",

"msgPath": "/uartInfo",

"code": 0,

"data": {

"baudrate": 115200,

"bytesize":8 ,

"parity":0 ,

"stopbit": 1

}

4.2. 写操作

设置串口信息示例：

/*请求*/

{

"msgType": "set_req",

"msgId": "123456001",

"msgPath": "/uartInfo",

"data": {

"baudrate": 115200,

"bytesize": 8,

"parity": 0,

"stopbit": 1

}

/*响应*/

{

"msgType": "set_res",

"msgId": "123456001",

"msgPath": "/uartInfo",

"code": 0

}

5. DI信息

msgPath支持：/diInfo。不同属性描述如下所示：

字段	读/写	类型	描述
num	读	int	DI接口数量，硬件决定，最大为80
rpt_enable	读/写	int	主动上报，0-禁用1-启用
rpt_cyc	读/写	int	主动上报周期，0-65535，默认为60，单位秒
rpt_direction	读/写	int	上报方向，0-北向 1-南向 2-南北向
value	读	int	0-断开 1-闭合

5.1. 读操作

读取DI信息示例：

/*请求*/

{

"msgType": "get_req",

"msgId": "123456001",

"msgPath": "/diInfo"

}

/*响应*/

{

"msgType": "get_res",

"msgId": "123456001",

"msgPath": "/diInfo",

"code": 0,

"data": {

"num": 2,

"rpt_enable":1,

"rpt_cyc":30 ,

"rpt_direction": 1,

"value": {

"0": 0,

"l": 0

}

5.2. 写操作

设置DI信息示例：

/*请求*/

{

"msgType": "set_req",

"msgId": "123456001",

"msgPath": "/diInfo",

"data": {

"rpt_enable":1,

"rpt_cyc":30 ,

"rpt_direction": 1

}

/*响应*/

{

"msgType": "set_res",

"msgId": "123456001",

"msgPath": "/diInfo",

"code": 0

}

6. DO信息

msgPath支持：/doInfo。不同属性描述如下所示：

字段	读/写	类型	描述
num	读	int	DO接口数量，硬件决定，最大为80
value	读/写	string	0-断开1-闭合

6.1. 读操作

读取DO信息示例：

/*请求*/

{

"msgType": "get_req",

"msgId": "123456001",

"msgPath": "/doInfo"

}

/*响应*/

{

"msgType": "get_res",

"msgId": "123456001",

"msgPath": "/doInfo",

"code": 0,

"data": {

"num": 2,

"value": {

"0": 0,

"l": 0

}

6.2. 写操作

设置DO信息示例：

/*请求*/

{

"msgType": "set_req",

"msgId": "123456001",

"msgPath": "/doInfo",

"data": {

"value": {

"0": 0,

"l": 0,

"num-1": 0

}

/*响应*/

{

"msgType": "set_res",

"msgId": "123456001",

"msgPath": "/doInfo",

"code": 0

}

7. AI信息

msgPath支持：/aiInfo。不同属性描述如下所示：

字段	读/写	类型	描述
num	读	int	AI接口数量，硬件决定，最大为80
rpt_enable	读/写	int	主动上报，0-禁用1-启用
rpt_cyc	读/写	int	主动上报周期，0-65535，默认为60，单位秒
rpt_direction	读/写	int	上报方向，0-北向 1-南向 2-南北向
value	读	string	0-20000，单位uA

7.1. 读操作

读取AI信息示例：

/*请求*/

{

"msgType": "get_req",

"msgId": "123456001",

"msgPath": "/aiInfo"

}

/*响应*/

{

"msgType": "get_res",

"msgId": "123456001",

"msgPath": "/aiInfo",

"code": 0,

"data": {

"num": 8,

"rpt_enable":1,

"rpt_cyc":30 ,

"rpt_direction": 1,

"value": {

"0": 4600,

"l": 4600,

"7": 4600

}

7.2. 写操作

设置AI信息示例：

/*请求*/

{

"msgType": "set_req",

"msgId": "123456001",

"msgPath": "/aiInfo",

"data": {

"rpt_enable":1,

"rpt_cyc":30 ,

"rpt_direction": 1,

}

/*响应*/

{

"msgType": "set_res",

"msgId": "123456001",

"msgPath": "/aiInfo",

"code": 0

}

8. AO信息

msgPath支持：/aoInfo。不同属性描述如下所示：

字段	读/写	类型	描述
num	读	int	AO接口数量，硬件决定，最大为80
value	读/写	string	0-20000，单位uA

8.1. 读操作

读取AO信息示例：

/*请求*/

{

"msgType": "get_req",

"msgId": "123456001",

"msgPath": "/aoInfo"

}

/*响应*/

{

"msgType": "get_res",

"msgId": "123456001",

"msgPath": "/aoInfo",

"code": 0,

"data": {

"num": 2,

"value": {

"0": 0,

"l": 0

}

8.2. 写操作

设置AO信息示例：

/*请求*/

{

"msgType": "set_req",

"msgId": "123456001",

"msgPath": "/aoInfo",

"data": {

"value": {

"0": 0,

"l": 0,

"num-1": 0

}

/*响应*/

{

"msgType": "set_res",

"msgId": "123456001",

"msgPath": "/aoInfo",

"code": 0

}

注

-只针对485下发指令生效

立即联系专家！

上一篇: ET21XX系列-ET2120-ET2110-ET2100使用说明

下一篇: ET34XX系列-ET4320-ET3410使用说明

ET21XX系列-ET2120-ET2110-ET2100-Json交互协议

数据格式

1. 设备信息

2. LoRa信息

3. 逻辑信息

4. 串口信息

5. DI信息

6. DO信息

7. AI信息

8. AO信息

注

热门产品