铁塔电单车协议对接电单车TCP json协议对接成熟充电桩系统搭建低速充电桩TCP 接口规范

低速充电桩

TCP 接口规范

2019 年 9 月 10 日

目录

低速充电桩 1

  1. 概述 2

• 协议服务器(IOT_Server) 6

• 通讯报文原则 6

• 报文协议说明 6

  1. 报文中所有数值类型为十进制; 6
  2. 报文中不允许使用转义字符,如\n、\t、\r、\s; 6
    • 报文类型 6
    • 遥测上报策略 8
    • 告警上报策略 8
    2充电桩协议 9
    2.1登录 9
    2.1.1 登录请求 9
    2.1.2 登录回应 11
    2.2 心跳 11
    2.2.1 设备心跳上报 11
    2.2.2 服务器响应心跳上报 12
    2.3 实时数据上报 12
    2.3.1 实时数据上报请求 12
    2.3.2 实时数据上报回应 13
    2.4 状态上报 13
    2.4.1状态上报请求 14
    2.4.2状态上报回应 14
    2.5 远程控制 15
    2.5.1 远程控制请求 15
    2.5.2 远程控制请求回应 16
    2.6告警上报 17
    2.6.1告警上报请求 17
    2.6 告警上报回应 18
    2.7 刷卡事件 19
    2.7.1刷卡上报请求 19
    2.7.2 刷卡上报回应 20
    2.8 平台下发设置参数 20
    2.8.1 平台下发设置参数请求 20
    2.8.2 平台下发设置参数回应 21
    2.9 配置查询 22
    2.9.1 配置查询请求 22
    2.9.2 配置查询回应 23
    2.10 远程升级 24
    2.10.1 远程升级请求 24
    2.10.2 远程升级回应 24
    2.11 远程重启 25
    2.11.1 远程重启请求 25
    2.11.2 远程重启回应 26
    附录:信号量字典表 27

一、概述

1.1 适用范围和意义

为了建立统一的充电桩管理平台,统一充电桩管理平台与充电桩物联网网关/主机的通讯接口,本文制定了《低速充电桩 TCP 接口协议》。在本文中,《低速充电桩 TCP 接口协议》统一简称为本协议。

一个充电桩物联网网关/主机可能带一个或者多个子设备。

1.2 名词定义

在本协议中,定义如下名词:

名称 说明 备注

IOT_Dev 充电桩

IOT_Server 协议服务器

网关/主机 充电桩通过网关或者主机与平台进行通讯

子设备 充电桩网关或者主机携带的一个或者多个设备

1.3 修改历史记录

版本 日期 内容 人员

V0.1 2022年 09月20 日 协议草案

V0.2 2022年10月11日 告警上报中添加05102001上报

1.4报文状态定义

1.4.1 充电桩类型

状态 编码 备注

直流充电桩 1

交流充电桩 2

交直流充电桩 3

1.4.2 充电口类型

状态 编码 备注

直流(DC) 1

交流(AC) 2

1.4.3 充电口状态

状态 编码 备注

待连接 0

空闲 1

充电中 2

已充满 3

异常 4

掉线 5

1.4.4 电池信息

适用直流充电桩,交流充电桩不需识别。

状态 编码 备注

未识别 0

适合充电的铅酸电池 1

适合充电的锂电池 2

损坏的铅酸电池 3

不符合标准的铅酸电池 4

损坏的锂电池 5

不符合标准的锂电池 6

1.5通讯规则

1.5.1 协议服务器(IOT_Server)

充电桩和 IOT_Server 连接为 TCP 长连接,采用域名(Domain Name):端口(Port)方式, 域名和端口号由平台运营厂商提供。如果正式连接地址无法连接,设备应自动切换到备份连接地址进 行连接。

正式连接地址:XX.XXXX.com:XXXX

测试连接地址:Test_XX.XXXX.com:XXXX

1.5.2 通讯报文原则

设备登录:IOT_Dev 进行向 IOT_Server 发送登录请求;

设备鉴权:IOT_Server 收到 IOT_Dev 登录请求,通过设备 ID 进行鉴权,如果是合法设备则允许进行连接,并向 IOT_DEV 发送登录成功数据包,否则强制关闭 TCP 连接;

报文收发:IOT_Dev 与 IOT_Server 建立数据连接以后,发送设备状态、故障/报警信息; IOT_Server 向IOT_Dev 发送控制指令;

连接失败:如果设备连续 10 个包发送失败或者连续 10 分钟无法与平台建立连接,则设备判断为请求连接失败,需要重新发起连接。

1.6 报文格式

本协议报文内容采用 UTF-8 编码 JSON 格式。

1.6.1 报文协议说明

1.报文中所有数值类型为十进制;

2.报文中时间为 13 位 Unix 时间戳,格式是字符串,如:2019-09-03 19:07:05 转换为"1567508825531";如果设备端的 CPU 是 32 位的,最大是 10 位字符,则在后面补位0,达到 13 位

3.报文中不允许使用转义字符,如\n、\t、\r、\s;

4.报文中的交易流水号规则:CD+yymmdd+8位数字 如:CD22090112345678

5.报文中字符类型的时间格式可为"yyyy-MM-dd HH:mm:ss" 如:2019-09-03 19:07:05

1.6.2 报文类型

报文类型 报文动作 数据流方向 类型编码

登录 登录请求 平台设备 110

登录响应 平台设备 111

心跳 心跳上报请求 平台设备 310

心跳上报响应 平台设备 311

实时数据上报 实时数据上报请求 平台设备 310

实时数据上报响应 平台设备 311

状态上报 状态上报请求 平台设备 310

状态上报响应 平台设备 311

远程控制 远程控制请求 平台设备 500

远程控制响应 平台设备 501

告警上报 告警上报请求 平台设备 410

告警上报响应 平台设备 411

刷卡事件 刷卡事件请求 平台设备 410

刷卡事件响应 平台设备 411

平台下发设置参数 平台下发设置参数请求 平台设备 500

平台下发设置参数响应 平台设备 501

配置查询 配置查询请求 平台设备 210

配置查询响应 平台设备 211

远程升级 远程升级请求 平台设备 500

远程升级响应 平台设备 501

远程重启 远程重启请求 平台设备 500

远程重启响应 平台设备 501

历史数据上报 历史数据上报请求 设备平台 310

历史数据上报响应 设备平台 311

1.6.7报文省略说明

在本协议中,报文参数不必全量上报,可根据实际情况省略部分键值对。

1.7充电桩上报策略

1.7.7遥测上报策略

充电桩上电后一直保持长连接,并且 60 秒一次的长连接上报,上报信息要包含正在充电的端口信息,如充电口状态,充电电压,充电电流,已充电量。

1.7.8告警上报策略

告警触发后向平台上报告警开始报文,上报成功后不再需要重复上报该告警,仅需将告警信号量状态随遥测报文定时上报。告警消除条件:5min 内告警一直处于消除状态,才能上报告警结束报文,消除告警。

1.7.9离线判断

TCP 连接断开或者 20 分钟未收到性能上报报文,即判断为离线,恢复连接后恢复上线。

1.7.10设备编码规则

通讯协议中网关、主机、设备与子设备的 ID 编码规则如下:

1.编码共 12 位,格式为XXXXYYYYYYYY,其中 XXXX 表示 4 位厂家代码, YYYYYYYY 为 8 位 ID

2.厂家英文代码为四位,若不足四位,以数字"0"补位,在厂家代码后面补"0"

3.集中式的设备如果是 1 拖 10,则 10 个端口的命名规则为:XXXXYYYYYY00-

XXXXYYYYYY09,XXXXYYYYYY00 为端口 0 的 ID

4.分布式设备的格式为 XXXXYYYYYYYY,其中 XXXX 表示 4 位厂家代码, YYYYYYYY 为分布式设备的 8 位ID;

2充电桩协议

2.1登录

充电桩第一次连接服务器,或是充电桩断电后重新加电,充电桩被服务器强制断开连接后重新连接服务器。

2.1.1 登录请求

名称 父节点 含义 说明

msgType 报文代码 编码:110,登录请求

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

iccid IMEI 或IMSI 或ICCID 流量卡的 ICCID

devType 设备类型 5:充电桩

devAttr 设备属性 1:集中式充电桩

2:分布式充电桩

devElecAttr 设备交直流属性 1:直流充电桩

2:交流充电桩

3:交直流充电桩

softVersion 软件版本号 充电桩的软件版本

hardVersion 硬件版本号 充电桩的硬件版本

protocolVersion 协议版本号 平台通信协议版本:V1

devList 设备列表 网关/主机携带的子设备列表

devId devList 子设备 ID 子设备的 ID

报文示例:

{

"msgType": 110,

"devId": "MMCD12345600", "txnNo": "1567508825531",

"iccid": "123456789",

"devType": 3,

"devAttr": 2,

"softVersion": "",

"hardVersion": "", "protocolVersion": "V1", "devList": [{

"devId": "MMCD12345601"

}, {

}]

}

"devId ": "MMCD12345602"

2.1.2 登录回应

名称 父节点 含义 说明

msgType 报文代码 编码:111,登录回应

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 0:失败

1:成功

报文示例:

{

"msgType": 111,

"devId": " MMCD12345600", "txnNo": 1567508825531,

"result": 1

}

2.2 心跳

2.2.1 心跳上报

名称 父节点 含义 说明

msgType 报文代码 编码:310

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

attrList 属性列表

Id attrList 信号量 ID 8 位信号 ID,信号量包含05115001,05114001,05109001

value attrList 属性值 对应的信号量的值

devId attrList 子设备 ID 子设备的 ID

isFull 是否全量上报 0:增量,1:全量

报文示例:

{

"devId":" HMCF00000000",

"txnNo":"1579058847087",

"msgType":310,

"isFull":1, 1:全量

"attrList":[

{"devId":"HMCF00000000","id":"05115001","value":4}, //信号类型

{"devId":"HMCF00000000","id":"05114001","value":31}, //信号值

{"devId":"HMCF00000000","id":"05109001","value":"cmiot"}] //APN

}

2.2.2 心跳上报响应

名称 父节点 含义 说明

msgType 报文代码 编码:311

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 1:成功 0:失败

报文示例:

{

"msgType":311,

"devId":" HMCF00000000",

"result":1,

"txnNo":"1579058847087"

}

2.3 实时数据上报

2.3.1 实时数据上报请求

名称 父节点 含义 说明

msgType 报文代码 编码:310

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

attrList 属性列表

Id attrList 信号量 ID 8 位信号 ID,包括:05104001,05107001,05108001,05127001等

devId attrList 子设备 ID 子设备的id

value attrList 信号量对应的值

isFull 是否全量上报 1:全量 0:增量

报文示例:

{

"msgType":310,

"devId":"HMCF00000000",

"txnNo":"1579059016097",

"attrList":[

{

"id":"05104001",

"value":23288,

"devId":"HMCF00000000"

},

{

"id":"05107001",

"value":1184,

"devId":"HMCF00000000"

},

{

"id":"05108001",

"value":130,

"devId":"HMCF00000000"

},

{

"id":"05127001",

"value":"CD22090412322212",

"devId":"HMCF00000000"

}

],

"isFull":1

}

2.3.2 实时数据上报回应

名称 父节点 含义 说明

msgType 报文代码 编码:311

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 1:成功 0:失败

报文示例:

{

"devId":" HMCF00000000",

"result":1,

"txnNo":"1579059016097",

"msgType":311

}

2.4 状态上报

2.4.1状态上报请求

名称 父节点 含义 说明

msgType 报文代码 编码:310

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

attrList 属性列表

Id attrList 信号量 ID 8 位信号 ID,包括:05102001

devId attrList 子设备 ID 子设备的id

value attrList 信号量对应的值

isFull 是否全量上报 1:全量 0:增量

报文示例:

{

"msgType":310,

"devId":" HMCF00000000",

"txnNo":"1579056295156",

"attrList":[

{

"id":"05102001",

"value":1,

"devId":"HMCF00000000"

},

{

"id":"05102001",

"value":1,

"devId":"HMCF00000000"

}

{

"id":"05102001",

"value":1,

"devId":"HMCF00000000"

},

{

"id":"05102001",

"value":1,

"devId":"HMCF00000000"

}

],

"isFull":1

}

2.4.2状态上报回应

名称 父节点 含义 说明

msgType 报文代码 编码311

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 1:成功 0:失败

报文示例:

{

"devId":" YJDC12001300",

"result":1,

"txnNo":"1579056295156",

"msgType":311

}

2.5 远程控制

2.5.1 远程控制请求

名称 父节点 含义 说明

msgType 报文代码 编码:500

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

paramList 参数列表

Id paramList 信号量 ID 8 位信号 ID,包含:05201001,05127001,05315001,05011001,05013001

当(05201001对应的值为1时)下发结束充电时,可不下发充电时长信号量

devId paramList 子设备 ID 子设备的id,如果为"ALL",代表对网关中的所有子设备进行信号量参数设置,比如计费模式、费率等。

value paramList 参数值

报文示例:

远程控制设备开始充电:

{

"devId":" HMCF00000000",

"txnNo":"1584069947622",

"msgType":500,

"paramList":[

{

"devId":"HMCF00000000",

"id":"05201001", //05201001值为0充电

"value":0

},

{

"id":"05127001", // 打开充电时,需要下发充电订单号

"value":"CD22090412322212",

"devId":"HMCF00000000"

},

{

"devId":"HMCF00000000",

"id":"05315001", // 05315001 值为0为充满自停

"value":0

}

]

}

下发刷卡充电报文示例

{

"devId":"YJDC65006484",

"txnNo":"1579071697065",

"msgType":500,

"paramList":[

{

"devId":"YJDC84022546",

"id":"05201001",

"value":0

},

{

"devId":"YJDC84022546",

"id":"05011001", //卡号

"value":"24935711"

},

{

"id":"05127001",

"value":"CD22090412322212", //添加结束交易流水号

"devId":"YJDC84022546"

},

{

"devId":"YJDC84022546",

"id":"05013001", // 卡内余额

"value":9345

},

{

"devId":"HMCF00000000",

"id":"05315001", // 05315001 值为0为充满自停

"value":0

}

]

}

2.5.2 远程控制请求回应

名称 父节点 含义 说明

msgType 报文代码 编码:501

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 1:成功 0:失败

paramList 参数列表

Id paramList 信号量 ID 8 位信号 ID,包含05201001,05127001,05108001

devId paramList 子设备 ID 子设备的id,

value paramList 信号量值

result paramList 结果 1:成功 0:失败

报文示例:

{

"devId":"HMCF00000000",

"txnNo":"1584069947622",

"msgType":501,

"result":1,

"paramList":[

{

"devId":" HMCF00000000",

"result":1,

"id":"05201001"

},

{

"id":"05108001",

"value":1230,

"devId":"HMCF00000000"

},

{

"id":"05127001",

"value":"CD22090412322212",

"devId":"HMCF00000000"

}

]

}

2.6告警上报

2.6.1告警上报请求

名称 父节点 含义 说明

msgType 报文代码 编码:410

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

alarmList 参数列表

Id alarmList 信号量 ID 8 位信号 ID,包含:05006001,05127001,05354001,05108001,05014001,05102001

等,若事件涉及到充电结束的话,必须包含05127001,05354001,05108001等信号量

devId alarmList 子设备 ID 子设备的id,如果为"ALL",代表对网关中的所有子设备进行信号量参数设置,比如计费模式、费率等。

value alarmList 参数值 可选项,可不出现

alarmTime alarmList 告警时间

alarmFlag alarmList 告警标记 可选项,可不出现

报文示例

{

"devId":"HMCF00000000",

"txnNo":"1579068993642",

"msgType":410,

"alarmList":[

{

"devId":" HMCF00000000",

"alarmTime":"1579068993642",

"id":"05006001",

"alarmFlag":1

},

{

"id":"05127001", //交易流水号

"value":"CD22090412322212",

"devId":"HMCF00000000"

},

{

"id":"05354001", //充电耗时时长,单位是秒

"value":3600,

"devId":"HMCF00000000"

},

{

"id":"05108001", //电表有功总电能

"value":"1230",

"devId":"HMCF00000000"

},

{

"id":"05102001", //当前枪头或插座状态

"value":"6",

"devId":"HMCF00000000"

}

]

}

2.6.2 告警上报回应

名称 父节点 含义 说明

msgType 报文代码 编码:411

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 1:成功 0:失败

resultList 结果列表

Id resultList 信号量 ID

devId resultList 子设备 ID 子设备的id,非必填

value resultList 参数值

报文示例:

{

"devId":" HMCF00000000",

"result":1,

"txnNo":"1579068993642",

"msgType":411

}

2.7 刷卡事件

2.7.1刷卡上报请求

名称 父节点 含义 说明

msgType 报文代码 编码:410

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

alarmList 参数列表

Id alarmList 信号量 ID 8 位信号 ID,包含:05011001,05012001 ,05127001信号量

devId alarmList 子设备 ID 子设备的id,如果为"ALL",代表对网关中的所有子设备进行信号量参数设置,比如计费模式、费率等。

value alarmList 参数值 可选项,可不出现

报文示例

{

"msgType":410,

"devId":"YJDC65006484",

"txnNo":"1579071697065",

"alarmList":[

{

"id":"05011001",

"value":"24935711",

"devId":"YJDC84022546"

},

{

"id":"05012001",

"value":1, //0:充电;1:刷卡一次,2:刷卡2次;3:该插座在充电或空载,查询卡内余额;4:该插座正在充电中,关闭充电

"devId":"YJDC84022546"

}

]

}

2.7.2 刷卡上报回应

名称 父节点 含义 说明

msgType 报文代码 编码:411

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 1:成功 0:失败

resultList 结果列表

Id resultList 信号量 ID

devId resultList 子设备 ID 子设备的id,非必填

value resultList 参数值

报文示例:

{

"devId":" YJDC65006484",

"result":1,

"txnNo":"1579068993642",

"msgType":411

}

2.8 平台下发设置参数

2.8.1 平台下发设置参数请求

名称 父节点 含义 说明

msgType 报文代码 编码:500

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

paramList 参数列表

Id paramList 信号量 ID 8 位信号 ID,包含:05310001,05317001,05321001,05325001,05351001,05352001

devId paramList 子设备 ID 子设备的id,如果为"ALL",代表对网关中的所有子设备进行信号量参数设置,比如计费模式、费率等。

value paramList 参数值

报文示例:

平台下发参数:

{

"devId":"YJDC12018068",

"txnNo":"1662572917700",

"msgType":500,

"paramList":[

{

"devId":"YJDC12018068",

"id":"05310001",

"value":120

},

{

"devId":"YJDC12018068",

"id":"05317001",

"value":"10"

},

{

"devId":"YJDC12018068",

"id":"05321001",

"value":"110"

},

{

"devId":"YJDC12018068",

"id":"05325001",

"value":"10"

},

{

"devId":"YJDC12018068",

"id":"05351001",

"value":"20"

}

]

}

2.8.2 平台下发设置参数回应

名称 父节点 含义 说明

msgType 报文代码 编码:501

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 1:成功 0:失败

paramList 参数列表

Id paramList 信号量 ID 8 位信号 ID,包含05201001,05127001,05108001

devId paramList 子设备 ID 子设备的id,

result 结果 1:成功 0:失败

报文示例:

{

"devId":" HMCF00000000",

"txnNo":"1584069947622",

"msgType":501,

"result":1,

"paramList":[

{

"devId":" HMCF00000000",

"result":1,

"id":"05201001"

}

]

}

2.9 配置查询

2.9.1 配置查询请求

名称 父节点 含义 说明

msgType 报文代码 编码:210

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

paramList 信号量列表

Id paramList 信号量 ID

devId paramList 子设备 ID 子设备的id,非必填

报文示例:

查询设备的总电压示例:

{

"msgType": 210,

"devId": "MMCD12345600", "txnNo": "1567508825531",

"paramList": [{

"id": "05104001",

"devId": "MMCD12345601"

}]

}

查询设备的卡密钥和数据块示例:

{

"msgType": 210,

"devId": "MMCD12345600", "txnNo": "1567508825536",

"paramList": [{

"id": "05311001",

},

{

"id": "05312001",

}]

}

2.9.2 配置查询回应

名称 父节点 含义 说明

msgType 报文代码 编码:211

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 1:成功 0:失败

resultList 结果列表

Id resultList 信号量 ID

devId resultList 子设备 ID 子设备的id,非必填

value resultList 参数值

2.10 远程升级

2.10.1 远程升级请求

名称 父节点 含义 说明

msgType 报文代码 编码:500

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

paramList 参数列表

Id paramList 信号量 ID 8 位信号 ID,包含:05302001,05303001,05304001

devId paramList 子设备 ID 对应的设备ID,若为空,将升级主机,可选项

value paramList 参数值

报文示例:

远程升级请求:

{

"devId":"HMCF00000000",

"txnNo":"1660551861592",

"msgType":500,

"paramList":[

{

"id":"05302001",

"value":"ftp://username:pswd@ip:port/hm/xxxx/xxx.bin",

"devId":"HMCF00000000",

},

{

"id":"05303001",

"value":1

},

{

"id":"05304001",

"value":"20220821121356"

}

]

}

2.10.2 远程升级回应

名称 父节点 含义 说明

msgType 报文代码 编码:501

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 1:成功 0:失败

paramList 参数列表

Id paramList 信号量 ID

devId paramList 子设备 ID 子设备的id,

result 结果 1:成功 0:失败

报文示例:

{

"msgType":501,

"devId":"YJDC12018068",

"txnNo":"1662572917700",

"result":1,

"paramList":[

{

"id":"05302001",

"devId":"YJDC12018068",

"result":1

}

]

}

2.11 远程重启

2.11.1 远程重启请求

名称 父节点 含义 说明

msgType 报文代码 编码:500

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

paramList 参数列表

Id paramList 信号量 ID 8 位信号 ID,05202001

devId paramList 子设备 ID

value paramList 参数值 0:重启; 1:开机; 2:关机

报文示例:

远程重启:

{

"devId":"YJDC12018068",

"txnNo":"1662572917700",

"msgType":500,

"paramList":[

{

"devId":"YJDC12018068",

"id":"05202001",

"value":0

}

]

}

2.11.2 远程重启回应

名称 父节点 含义 说明

msgType 报文代码 编码:501

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 1:成功 0:失败

paramList 参数列表

Id paramList 信号量 ID 8 位信号 ID,包含05202001

devId paramList 子设备 ID 子设备的id,

result 结果 1:成功 0:失败

报文示例:

{

"devId":" HMCF00000000",

"txnNo":"1584069947622",

"msgType":501,

"result":1,

"paramList":[

{

"devId":" HMCF00000000",

"result":1,

"id":"05202001"

}

]

}

2.12 历史数据上报

2.12.1 历史数据上报请求

名称 父节点 含义 说明

msgType 报文代码 编码:310

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 13 位时间戳

attrList 属性列表

Id attrList 信号量 ID 8 位信号 ID,包括:05104001,05107001,05108001,05127001,05353001,05354001等

devId attrList 子设备 ID 子设备的id

value attrList 信号量对应的值

isFull 是否全量上报 1:全量 0:增量

报文示例:

{

"msgType":310,

"devId":"HMCF00000000",

"txnNo":"1579059016097",

"attrList":[

{

"id":"05104001",

"value":23288,

"devId":"HMCF00000000"

},

{

"id":"05107001",

"value":1184,

"devId":"HMCF00000000"

},

{

"id":"05108001",

"value":130,

"devId":"HMCF00000000"

},

{

"id":"05127001",

"value":"CD22090412322212",

"devId":"HMCF00000000"

},

{

"id":"05353001",

"value":"2022-09-03 22:12:21",

"devId":"HMCF00000000"

},

{

"id":"05354001",

"value":3600,

"devId":"HMCF00000000"

}

],

"isFull":1

}

2.12.2 历史数据上报回应

名称 父节点 含义 说明

msgType 报文代码 编码:311

devId 设备 ID 网关/主机的 ID

txnNo 消息流水号 与请求报文的 txnNo 对应

result 结果 1:成功 0:失败

报文示例:

{

"devId":" HMCF00000000",

"result":1,

"txnNo":"1579059016097",

"msgType":311

}

附录:信号量字典项目 所需数目

书籍 1

杂志 3

笔记本 1

便笺簿 1

钢笔 3

铅笔 2

荧光笔 2 色

剪刀 1 把

信号标准名	信号类型	单位	备注	信号量ID	枚举值	告警级别

新设备标准 充电口状态 遥测 0:待连接 05102001

1:空闲

2:充电中

3:已充满

4:异常

5:掉线

电压 遥测 V100 总电压放大100倍 05104001
电流 遥测 A
100 总电流放大100倍 05105001

电表有功瞬时功率 遥测 W*10 05107001

电表有功总电能 遥测 KWH 电表有功总电能放大1000倍 05108001

APN 遥测 必须上传 05109001

国际移动设备识别码 遥测 15位 05110001

国际移动用户识别码 遥测 15位 05111001

信号强度 遥测 dBm 05112001

DTU状态 遥测 05113001

CSQ值 遥测 05114001

信号类型2G/3G/4G 遥测 2G/3G/4G 0:No service(掉线了) 05115001

2:2G(包括 GSM,EDGE,CDMA)

3:3G(包括 WCDMA,TD-SCDMA,EVDO)

4:4G(包括 FDD-LTE,TDD-LTE)。

温度 遥测 ℃ 充电桩的温度 05116001

高温报警 遥信 1:高温报警(发生高温报警,上传该信号量,值为1,并上传该设备编号) 05001001 一级

0:告警恢复(高温报警恢复正常时,上传该信号量,值为0,并上传该设备编号)

其他:无告警不上传该信号量

充电头脱落 遥信 上报充电口号(子设备号) 05003001 二级

电表异常 遥信 05004001 一级

充电口异常 遥信 需要上传,电压,电流 05005001 一级

充电口充满自停 遥信 上报充电口号、电量(有的厂家通过心跳上传电压、电流、功率,实现充电电量的计算;有的厂家通过硬件采集计算直接上传电量) 05006001 三级

已充满交流充电桩可以不报

功率过载 遥信 05014001 二级

超出最长充电时间 遥信 05015001 二级

控制充电口 遥控 0:开始充电 05201001

1:关闭充电

2:充电口禁用

控制充电桩 遥控 0:重启 05202001

1:关机

2:开机

设置充电桩时间 遥调 05301001

OTA升级地址 遥调 05302001

OTA升级方式 遥调 0:对比升级 05303001

1:强制升级,IOT_Dev不需要对比版本号

2:指定时间升级

OTA升级时间 遥调 格式:yymmddHHmm 05304001

OTA升级版本号 遥调 05305001

连接域名 遥调 05306001

连接端口 遥调 05307001

业务域名 遥调 05308001

业务端口 遥调 05309001

计费模式 遥调 0:按时间计费 05313001

1:按功率和时间计费

2:按电量计费

费率 遥调 05314001

充电时长 遥调 05315001

设备的ID号 遥调 05316001

最长充电时长 遥调 05317001

过载阈值 遥调 W 05319001

过温判定时间 遥调 秒 05325001

欠压阈值 遥调 V 05328001

过压阈值 遥调 V 05329001

涓流阈值 遥调 % 05330001

欠压告警 遥信 05016001 二级

过压告警 遥信 05017001 二级

过流保护 遥信 10A 05018001 一级

离线告警 遥信 05019001 一般为三级告警;如果一个充电站75%端口离线,上升为二级;如果一个充电站所有端口都离线,上升为一级告警

手动断电判定时间 遥调 秒 05331001

漏电流异常告警 遥信 05020001 一级

输出短路告警 遥信 05021001 一级

容量超载告警 遥信 1:告警开始;(发生容量超载告警,

上传该信号量,值为1,并上传该设备编号,且开始充电的端口不能充电;多为集中式) 05022001 三级

0:告警解除(告警解除恢复正常时,上传该信号量,值为0,并上传该设备编号,其余端口可以接收开始充电指令;)

继电器粘连告警 遥信 1:告警开始;(发生继电器粘连告警,

上传该信号量,值为1,并上传该设备编号,有此告警后不能接收充电指令) 05023001 三级

0:告警解除(告警解除恢复正常时,上传该信号量,值为0,并上传该设备编号;)

保险丝熔断告警 遥信 1:告警开始;(发生保险丝熔断告警,

上传该信号量,值为1,并上传该设备编号,有此告警后不能接收充电指令) 05024001 三级

0:告警解除(告警解除恢复正常时,上传该信号量,值为0,并上传该设备编号;)

负载检测时间 遥调 秒 开始充电时,判定设备是否有连接负载 05332001 三级

防脉冲时间 遥调 秒 此处定义与欠载判定时间基本一致,但是此

信号量可随开始充电命令下发至设备端,

仅此次充电订单有效 05333001 三级

存量设备额外信号量 电池信息 遥测 0:未识别 05103001

1:适合充电的铅酸电池

2:适合充电的锂电池

3:损坏的铅酸电池

4:不符合标准的铅酸电池

5:损坏的锂电池

6:不符合标准的锂电池

卡费用不足 遥信 05007001 三级

没有检测到卡 遥信 05008001 三级

卡校验错误 遥信 05009001 三级

在线刷卡超时 遥信 05010001 三级

卡号 遥信 05011001 三级

刷卡次数 遥信 0:表示没有插入负载,使用户要查余额 05012001 三级

1:设备检测到负载,请求充电校验,并刷卡1次 三级

2:设备检测到负载,请求充电校验,并刷卡2次 三级

3:设备检测到负载,并正在充电,查询卡内余额 三级

4:设备正在充电,请求结束充电 三级

卡内余额 遥信 05013001 三级

刷卡密钥 遥调 05311001

卡数据块 遥调 05312001

充电口类型 遥测 1:直流(DC) 05101001

2:交流(AC)

电池容量 遥测 Ah 05106001

低温报警 遥信 1:低温报警(发生低温报警,上传该信号量,值为1,并上传该设备编号) 05002001 二级

0:告警恢复(低温报警恢复正常时,上传该信号量,值为0,并上传该设备编号)

其他:无告警不上传该信号量

开路电压阈值 遥调 V 05326001

闭路电压阈值 遥调 V 05327001

满电阈值 遥调 W 05320001

欠载阈值 遥调 W 05318001

设置心跳时长 遥调 05310001

控制电子锁 遥控 电子锁编号 05203001

满电判定时间 遥调 秒 05324001

欠载判定时间 遥调 秒 05322001

过载判定时间 遥调 秒 05323001

过温阈值 遥调 ℃ 05321001

交易流水号 遥测 充电订单交易号,充电过程需要携带此订单号 05127001

离网充电最大时长 遥调 分 离网后可充电的最大时长 05351001

二维码地址 遥调 下发屏幕上显示的二维码地址 05352001

获取当前服务器时间 遥信 0:获取当前服务器时间 05040001

充电停止告警 遥信 0:其他原因 05041001

1:空载

2:充满

3:过载

4:充电枪主电源线温度过高

5:主动关闭(已取消,平台关闭,见3.5协议)

6:紧急关闭;

7:拔枪关闭;

8:CP异常关闭;

9:功率异常(长时间低功率)关闭;

10:计时充电关闭;

11:按电量充电关闭;

12:按金额充电关闭;

13:断网关闭;

14:漏电保护关闭;

15:服务器异常;

:16:过压或者欠压保护关闭;

:17:继电器粘连

充电停止后,需上报交易流水号,电量,充电时长

开始充电时间 遥调 插座或枪头开始充电的时间 05353001

充电耗时时间 遥调 秒 充电订单从开始到结束的总耗时时长, 05354001

相关推荐
饮长安千年月2 小时前
Linksys WRT54G路由器溢出漏洞分析–运行环境修复
网络·物联网·学习·安全·机器学习
是小崔啊3 小时前
java网络编程02 - HTTP、HTTPS详解
java·网络·http
车载诊断技术5 小时前
电子电气架构 --- 电子电器新技术及发展趋势
网络·架构·汽车·电子电器框架·车载充电器(obc)·电子电器新技术及发展趋势
卷心菜不卷Iris5 小时前
第1章大型互联网公司的基础架构——1.6 RPC服务
网络·网络协议·微服务·rpc·http协议·rpc协议
网络安全-老纪5 小时前
网络安全之如何发现安全漏洞
网络·安全·web安全
菜萝卜子5 小时前
【计算机网络】数据链路层数据帧(Frame)格式
网络·计算机网络
xiaohai@Linux6 小时前
ESP32 在IDF_V5.3.1版本下实现AP无线热点模式!(带WIFI事件处理)
c语言·嵌入式硬件·tcp/ip·wifi·esp32
是纯一呀6 小时前
WebSocket(WS)协议系列(一)基本概念
网络·websocket·网络协议
网络安全筑盾者-燕子6 小时前
计算机网络-OSI七层参考模型与数据封装,网络安全零基础入门到精通实战教程!
网络·计算机网络·安全·web安全·网络安全·osi
zhj16953697 小时前
手写简易RPC(实践版)
java·网络·网络协议·rpc