电动自行车集中充电控制器智能充电终端与云平台之间的通信协议.pdf

JB/T 14055202220AA附录 A（资料性）智能充电终端与云平台之间的通信协议A.1目的使用统一的通信协议后，可实现不同厂家的设备接入相同的云平台，方便不同厂家的设备实现互联互通如图A.1所示，B和A厂商的云平台，可以与B和C厂商的充电设备通信，并管理接入的设备，从而实现不同厂商的云平台和充电设备互联互通图 A.1应用场景示意图A.2互联方案在各个厂商充电设备和厂商云平台、使用统一的转换协议，实现不同厂商充电设备、云平台之间的联通如表 A.1 所示，为设备与云间通信接口，接口详细描述请参见第 A.4 小节表 A.1设备与平台之间的互联接口DevRegist设备注册StartCharge设备启动充电StopCharge设备停止充电SlotInfo时间片上报OrderInfo订单上报DevGetInfo设备信息查询DevCfgInfo设备信息配置JB/T 14055202221AlarmInfo设备告警上传A.3基本规范A.3.1通讯原理设备层：设备层：设备基于 EDP SDK，实现 EDP 协议与云平台通信，用于上报业务数据到云平台若需要实时接收业务层下发的控制命令，需要保持 EDP 长连接。

业务应用层：业务应用层：若要自定义实现业务平台，可通过 HTTP 协议的 RESTful API 操作云平台提供的资源（设备、数据点、命令控制等资源的增删查改）通信构架如图 A.2 所示图 A.2通信架构A.3.2接入方式协议统一使用 TCP 连接方式，基于 JSON 格式封装，使用 EDP 协议，UTF-8 编码A.3.3EDP方法EDP 消息命令格式如表 A.2 所示表 A.2EDP 消息命令类型值类型值含义含义方向方向1CONN_REQ：连接建立请求Clinet-Server2CONN_RESP：连接建立响应Server-Client3PUSH_DATA：转发（透传）数据双向4CONN_CLOSE：连接关闭Server-Client8SAVE_DATA：存储（&转发）数据双向9SAVE_ACK：存储确认Server-Client10CMD_REQServer-ClientJB/T 1405520222211CMD_RESPClient-Server12PING_REQ:心跳请求Client-Server13PING_RESP:心跳响应Server-Client设备使用 CONN_XXX 与云平台建立连接。

设备上报消息给平台，可使用 PUSH_DATA 或者 SAVE_DATA 消息，平台也可以使用两个消息与设备通信平台可使用 CMD_XXX 给设备发控制消息设备与平台之间通过 PING_XXX 保持长连接A.3.4接口分类在各个厂商充电设备和厂商云平台、使用统一的转换协议，实现不同厂商充电设备、云平台之间的联通设备与平台之间的互联接口如表 A.3 所示表 A.3消息接口DevRegist设备注册DevUnregist设备注销StartCharge设备开始充电StopCharge设备停止充电SlotInfo时间片上报OrderInfo订单上报DevGetInfo设备信息查询DevCfgInfo设备信息配置AlarmInfo设备告警上传DevOp设备使能接口详细描述请参见第 A.4 小节A.3.5互联时传递的参数互联时传递的参数如表 A.4 至表 A.9 所示表 A.4PubAttr 公共属性字段名称中文说明数据类型是否必填访问方式说明ProtoVersion协议版本号String必填RPlatName设备商名字String必填RDevModel设备型号String必填RDevSn设备标识码String必填RDevVersion嵌入式版本号String必填R表 A.5CommAttr 通信属性字段名称中文说明数据类型是否必填访问方式说明JB/T 14055202223CommMode通信模式Integer必填RCommStd通信制式Integer必填RCommRssi信号强度Integer可选RCommPara通信参数Object可选RW表 A.6OutletAttr 插口属性字段名称中文说明数据类型是否必填访问方式说明ChargeMode充电模式Integer必填ROutletNum充电口数量Integer必填ROutletPara插口参数Object可选RW表 A.7CommPara 通信参数字段名称中文说明数据类型是否必填访问方式说明DstIp目标 IPString可选RWDstPort目标 PORTString可选RWCloudId云平台 IDString可选RWCloudPw云平台认证String可选RW表 A.8OutletPara 插口参数字段名称中文说明数据类型是否必填访问方式说明NoloadIrms欠载电流Float可选RW单位 ANoloadTime欠载检测时间Integer可选RW单位秒FullIrms满载电流Float可选RW单位 AFullTime满载检测时间Integer可选RW单位秒OverloadIrms过载电流Float可选RW单位 AOverloadTime过载检测时间Integer可选RW单位秒OverTempValue过温值Integer可选RW单位度OverTempTime过温检测时间Integer可选RW单位秒表 A.9EnergyInfo 电能信息字段名称中文说明数据类型是否必填访问方式说明EnAvgPower平均功率Float可选R单位 WEnMaxPower最大功率Float可选R单位 WEnCurPower当前功率Float可选R单位 WEnAvgIrms平均电流Float可选R单位 AEnMaxIrms最大电流Float可选R单位 AJB/T 14055202224EnCurIrms当前电流Float可选R单位 AEnCurVrms当前电压Float可选R单位 VA.3.6安全策略设备登录云平台时，需要认证，有两种认证方式，如表 A.10 和表 A.11 所示。

表 A.10EDP 登录认证方式携带信息说明设备 ID+鉴权信息（api-key）设备 ID：申请设备时平台返回的 ID；鉴权信息：在平台申请的可以操作该设备的 api-key 字符串；产品 ID+鉴权信息（auth_info）产品 ID：在平台添加产品时平台生成的 ID；鉴权信息：在平台申请设备时填写设备的 auth_info 属性（json 对象字符串），该属性需要产品内具备唯一性；表 A.11云平台认证信息产品 ID 获取方式在云平台添加产品时，平台生成产品 ID设备 ID 获取方式在云平台创建设备时平台生成的设备 ID 号api-key 获取方式在云平台注册的产品，管理整个产品的 api-key,或者用于自己新增具有该设备操作权限的 api-keyA.3.7通用标识码通用的充电设备标识是不通厂家设备互联互通的基础统一了设备标识码，各个厂家才能识别其他厂家的充电设备通过通用充电设备标识信息识别生产厂家、充电类型、设备标识码（各厂家自定义），从而确定需要互联的云平台、需要操作的设备通用充电设备标识码设计，如图 A.3 所示，结构为：“厂商代码+产品类型+产品编码”的形式创建标识码，每一位取值范围为：09，均使用 ASCLL 码表示。

其中：a）厂商代码：4 位，区分不同厂家；b）设备类型：4 位，厂商自定义设备类型；c）产品编码：16 位，厂商自定义序号厂商代码厂商代码设备类型设备类型产品编码产品编码图 A.3通用标识码结构A.4接口描述A.4.1设备注册设备向服务器发起注册，服务器回复响应后，表明设备接入服务器成功，可进行业务操作设备注册的字段说明见表A.12，注册响应字段说明见表A.13，注册结果见表A.14JB/T 14055202225表 A.12设备注册请求参数表字段名称中文说明数据类型是否必填访问方式说明DevRegist注册Json 对象见表 A.32OpType操作类型String必填取值“Report”ParaJson 对象PubAttr公共属性Object必填R见表 A.4 定义CommAttr通信属性Object必填R见表 A.5 定义OutletAttr插口属性Object必填R见表 A.6 定义表 A.13设备注册响应参数表字段名称中文说明数据类型是否必填访问方式说明DevRegist注册Json 对象见表 A.32OpType操作类型String必填取值“ack”ParaJson 对象Result注册结果Integer必填R见 A.14表 A.14注册结果说明字段值说明0注册成功1设备非法2注册消息错误A.4.2设备充电由后台发起充电流程。

对指定充电口充电，并指定充电时长和时间片间隔,具体消息格式见表A.15A.17表 A.15启动充电请求参数表字段名称中文说明数据类型是否必填访问方式说明StartCharge开始充电Json 对象见表 A.32OpType操作类型String必填取值“Set”ParaJson 对象OutletNo插口编号Integer必填WSlotDuration时间片间隔Integer必填WChargeTime充电时长Integer必填W表 A.16启动充电响应参数表JB/T 14055202226字段名称中文说明数据类型是否必填访问方式说明StartCharge开始充电Json 对象见表 A.32OpType操作类型String必填取值“ack”ParaJson 对象OutletNo插口编号Integer必填OutletStatus插口状态String必填见表 A.34Result充电结果Integer必填见表 A.17表 A.17启动充电结果说明字段值说明0充电成功1正在充电2插口损坏3插口自检4未知失败A.4.3停止充电设备充电过程中，平台可对设备发起停止充电操作，具体消息格式见表 A.18A.20表 A.18停止充电请求参数字段名称中文说明数据类型是否必填访问方式说明StopCharge停止充电Json 对象见表 A.32OpType操作类型String必填取值“Set”ParaJson 对象OutletNo插口编号Integer必填表 A.19停止充电响应参数字段名称中文说明数据类型是否必填访问方式说明StopCharge停止充电Json 对象见表 A.32OpType操作类型String必填取值“ack”ParaJson 对象OutletNo插口编号Integer必填OutletStatus插口状态String必填见表 A.34Result充电结果Integer必填见表 A.20表 A.20停止充电结果说明字段值说明0停止成功JB/T 140552022271不是充电中2停止失败A.4.4时间片上报时间片上报充电设备在时间片到时，向后台上报时间片信息，包括功率、电流、电能、温度等相关信息。

时间片相关数据格式见表A.21与A.22表 A.21时间片上报参数字段名称中文说明数据类型是否必填访问方式说明SlotInfo时间片上报Json 对象见表 A.32OpType操作类型String必填取值“Report”ParaJson 对象OutletNo插口编号Integer必填RSlotNo时间片编号Integer必填RSlotTime时间片时长Integer必填R单位分钟EnergyInfo电能信息Object必填R见表 A.9表 A.22时间片上报确认参数字段名称中文说明数据类型是否必填访问方式说明SlotInfo时间片上报Json 对象见表 A.32OpType操作类型String必填取值“Ack”ParaJson 对象OutletNo插口编号Integer必填RSlotNo时间片编号Integer必填RA.4.5订单上报充电结束时，充电设备向后台上报订单信息，包括耗时、功率、电流、电能、温度等相关信息订单相关数据格式见表A.23与A.24表 A.23订单上报参数字段名称中文说明数据类型。