充电桩平台通讯协议

《充电桩平台通讯协议》由会员分享，可在线阅读，更多相关《充电桩平台通讯协议（24页珍藏版）》请在金锄头文库上搜索。

1、 充电桩平台通讯协议 交运工业技术处 2016 年 9 月 25 日 第 2 页 目录目录 1. 设备与业务接入模式 . 3 2. HTTP 原始报文格式 4 3. 平台报文一览 . 5 4. 平台报文详细 . 6 4.1. 请求报文 . 6 4.1.1. 开机报文 10100 6 4.1.2. 插卡报文 10200 7 4.1.3. 枪车连接报文 10300 8 4.1.4. 充电报文 10500 9 4.1.5. 结算报文 10600 11 4.1.6. 状态报文 20100 12 4.1.7. 数据请求报文 40100 14 4.1.8. 数据发送报文 40200 15 4.2. 返回报

2、文 . 16 4.2.1. 锁机命令报文 30100 16 4.2.2. 解机命令报文 30200 17 4.2.3. 锁枪命令报文 30300 18 4.2.4. 解枪命令报文 30400 19 4.2.5. 充电命令报文 30500 20 4.2.6. 中止充电命令报文 30600 21 4.2.7. 数据更新命令报文 30700 22 4.2.8. 召测命令报文 30800 23 5. 数据定义 . 24 5.1. 计费标准数据 . 24 5.2. 黑名单数据 . 24 5.3. 白名单数据 . 24 第 3 页 本协议基于 HTTP 协议 （详见 http:/www.w3.org/Pr

3、otocols/HTTP/1.0/spec.html） 和 json 数据格式 （详见 http:/www.json.org/json-zh.html） ， 适合云平台与管理平台之间数 据对接，及充电桩与各平台间的数据通信。 1. 设备与业务接入模式设备与业务接入模式 设计原则设计原则 使用标准 HTTP 方法实现资源操作； 采用 json 作为 API 输入输出； 以 json 输出错误信息。 表 1 HTTP 方法 HTTP 方法 描述 POST GET 不采用 表 2 返回码表 HTTP 返回码 含义 内容描述 200 OK 左示为服务器标准返回码。 服务器端处理结果在 HTTP bod

4、y 中以 json 格式指明详细成 功或错误信息，例如： “errno“: 0, 处理返回码： 0 - 成功 非 0 - 失败 400 Bad Request 401 Not Authorized 403 Forbidden 404 Not Found 406 Not Acceptable 422 Unprocessable Entity 500 Internal Server Error 503 No server error HTTP/JSON HTTP/JSON HTTP/JSON HTTP/JSON HTTP/JSON HTTP/JSON 充 电 桩 云 监 控 平 台 充电桩 充电桩

5、 充电桩 终端 HTTP 站内 管理 平台 终端 图 1 业务接入模式 第 4 页 2. HTTP 原始报文格式原始报文格式 例 1， HTTP 报文，格式如下，其中rn 是两个字符（ASCII 码里面的回车换行） ，长度 nnn 表示两个连续rnrn 后数据的长度： 注： api-key 由平台定义，充电桩出厂前设定。 POST /message HTTP/1.1rn api-key:rn Host:xxx.xxxxxxx.xxxrn Content-Length: 168rn rn “id“:“10100“, “pile_id“:“终端号“, “lng“:106.45623, “lat“:

6、29.45678, “at“:“2012-12-12T23:12:23“ 第 5 页 3. 平台报文一览平台报文一览 报文识别码: 5 位数字 表 3 报文一览 报文 类型 报文名称 报文识别 码 备注 1 请 求 报文 开机报文 10100 含校准时间、桩基本信息 2 插卡报文 10200 含 UID 只有使用在线卡时发送 3 枪车连接报文 10300 含车 VIN 信息 在接收到 VIN 信息后发送 4 充电报文 10500 含充电状态信息 设备处于充电状态，每 15sec 发送 5 结算报文 10600 含充电电量结算、收费结算信息 6 状态报文 20100 时间、状态码 设备处于非充电

7、状态，状态信息发 生变化时立即发送，无变化时每 15sec 发送 故障时，即时发送 7 数据请求报文 40100 数据更新命令的响应处理报文 接收失败时重发 8 数据发送报文 40200 召测命令的响应处理报文 可续发、终止、重发 9 返 回 报文 锁机命令报文 30100 10 解机命令报文 30200 11 锁枪命令报文 30300 12 解枪命令报文 30400 13 充电命令报文 30500 14 中止充电命令报文 30600 15 数据更新命令报文 30700 更新可恢复 有系统软件更新、 参数文件更新 （单 价、黑名单、白名单、其他） 16 召测命令报文 30800 含查询条件信息

8、 注： 返回报文重发机制：后台需要根据桩状态或数据传输状态判断是否重发。 返回报文信息通过请求报文的应答内容发送。 9 99 00 4-5 位：固定 00，备用 2-3 位：顺序号 1 位：报文类型 报文类型: 1 操作报文 2 状态报文 3 命令报文 4 数据报文 第 6 页 4. 平台报文详细平台报文详细 4.1. 请求报文请求报文 4.1.1. 开机开机报文报文 10100 HTTP 方法 POST URL http:/message HTTP 头部 api-key:xxxx-ffff-zzzzz HTTP 内容 Request 内容 Key Value 名称 说明 1 Id 10100

9、 报文识别码 2 At 时间 发送时间 3 pile_id 充电桩设备编号 4 ver_h 硬件版本号 5 ver_s 软件版本号 6 Lng 经度 7 Lat 纬度 8 from 报文源 0: 桩，1: 管理平台 Response 内容 Key Value 名称 说明 1 id 报文识别码 同 Request 报文识别码 2 Errno 处理返回码 3 Cmd 命令报文 4 Data 返回数据 含如下项目 Time 校准时间 服务器时间 例: Request 内容 “id“:“10100“, “pile_id“:“终端号“, “lng“:“106.45623“, “lat“:“29.4567

10、8“, “at“:“2012-12-12T23:12:23“, “from“:0 例: Response 内容 “errno“: 0, “id“: “10100“, “cmd“: , “data“: “ time “: “2012-12-12T23:13:23“ 第 7 页 4.1.2. 插卡插卡报文报文 10200 HTTP 方法 POST URL http:/message HTTP 头部 api-key:xxxx-ffff-zzzzz HTTP 内容 Request 内容 Key Value 名称 说明 1 Id 10200 报文识别码 2 at 时间 发送时间 3 pile_id 充电

11、桩设备编号 4 uid 卡 UID 5 pwd 卡密码 Response 内容 Key Value 名称 说明 1 id 报文识别码 同 Request 报文识别码 2 Errno 处理返回码 3 cmd 命令报文 4 data 返回数据 含如下项目 uid 卡 UID balance 账户余额 单位：分，整数 例: Request 内容 “id“:“10200“, “pile_id“:“终端号“, “uid“:“12345678“, “pwd“:“12345678“, “at“:“2012-12-12T23:12:23“ 例: Response 内容 “errno“: 0, “id“: “1

12、0200“, “cmd“: “id“: “30800“, “start“: “2011-10-11T03: 01: 23“, “end“: “2011-10-12T13: 11: 34“ , “data“: “ uid “: “12345678“, “ balance “: 255 第 8 页 4.1.3. 枪车连接报文枪车连接报文 10300 HTTP 方法 POST URL http:/message HTTP 头部 api-key:xxxx-ffff-zzzzz HTTP 内容 Request 内容 Key Value 名称 说明 1 Id 10300 报文识别码 2 at 时间 发送时

13、间 3 pile_id 充电桩设备编号 4 gun_id 充电枪编号 5 vin 车辆 VIN 码 用扩展 BCD 码表示（34 字节） Response 内容 Key Value 名称 说明 1 id 报文识别码 同 Request 报文识别码 2 Errno 处理返回码 3 cmd 命令报文 4 data 返回数据 空 例: Request 内容 “id“:“10300“, “pile_id“:“终端号“, “gun_id“:”枪号”, “vin“:”车辆 VIN 码”, “at“:“2012-12-12T23:12:23“ 例: Response 内容 “errno“: 0, “id“:

14、 “10300“, “cmd“: , “data“: 注：此报文在接收到 VIN 信息后发送 第 9 页 4.1.4. 充电报文充电报文 10500 HTTP 方法 POST URL http:/message HTTP 头部 api-key:xxxx-ffff-zzzzz HTTP 内容 Request 内容 Key Value 名称 说明 1 Id 10500 报文识别码 2 at 时间 发送时间 3 pile_id 充电桩设备编号 4 gun_id 充电枪号 5 chgmode 充电模式 6 btype 电池类型 7 chgv 充电电压 单位：0.1V，整数 8 chga 充电电流 单位

15、：0.1A，整数 9 chgtime 充电时长 分 10 chgqu 已充电量 单位：0.01W，整数 11 chgw 充电功率 单位：0.01W，整数 12 btemp 电池温度 单位：0.1，整数 13 soclast SOC 满剩余时长 分 14 soc 当前 SOC 整数 15 vout 输出电压 单位：0.1V，整数 16 aout 输出电流 单位：0.1A，整数 17 bmsrv BMS 请求充电电压 单位：0.1V，整数 18 bmsra BMS 请求充电电流 单位：0.1A，整数 19 bmsv BMS 监测电压 单位：0.1V，整数 20 bmsa BMS 监测电流 单位：0

16、.1A，整数 21 vmax 单体最高电压 单位：0.01V，整数 22 vmin 单体最低电压 单位：0.01V，整数 23 amax 最高允许充电电流 单位：0.1A，整数 24 bqu 电池额定容量 单位：0.01VA，整数 25 bvsum 电池总电压 单位：0.1V，整数 26 chgtemp 充电系统温度 单位：0.1，整数 27 vin 车辆 VIN 码 用扩展 BCD 码表示（34 字节） Response 内容 Key Value 名称 说明 1 id 报文识别码 同 Request 报文识别码 2 Errno 处理返回码 3 cmd 命令报文 4 data 返回数据 空 例: Request “Id“:“10500“, 第 10 页 内容 “at“:“2012-12-