OCPP 1.6 文档概述
目前OCA官方OCPP1.6的最新版文档是 OCPP_1.6_documentation_2019_12
其中包含了6个文件和schemas文件夹：
| 序号 | 文档名 | 描述 |
|---|---|---|
| 0 | ocpp-1.6 edition 2.pdf | Open Charge Point Protocol 1.6 协议内容 |
| 1 | ocpp-1.6-errata-sheet.pdf | OCPP 1.6 勘误表 |
| 2 | ocpp-j-1.6-errata-sheet.pdf | OCPP 1.6 J 勘误表 |
| 3 | ocpp-j-1.6-specification.pdf | OCPP 1.6 J 规范 |
| 4 | ocpp-s-1.6-specification.pdf | OCPP 1.6 S 规范 |
| 5 | ocpp-s-1.6-errata-sheet.pdf | OCPP 1.6 S 勘误表 |
| 6 | schemas | OCPP 1.6 J & S 消息描述文档 |
这里的J和S分别是json和xml soap，这里我们只看使用最广泛的·json。
OCPP 1.6 J 规范要求
连接方式
- 使用基于TCP的
Websocket连接; - 中央系统充当 WebSocket 服务器，充电点充当 WebSocket客户端;
- 充电点需要一个唯一标识用于连接，例：ws://centralsystem.example.com/ocpp/CP001；
- OCPP-J 连接握手的 HTTP 请求示例 ：
GET /ocpp/CP001 HTTP/1.1
Host: centralsystem.example.com:33033
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Key: x3JJHMbDL1EzLkh9GBhXDw==
Sec-WebSocket-Protocol: ocpp1.6, ocpp1.5
Sec-WebSocket-Version: 13
- 服务器响应示例：
HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=
Sec-WebSocket-Protocol: ocpp1.6
- WebSocket Ping
WebsSocket 规范定义了 Ping 和 Pong 框架，用于检查远程端点是否仍在响应，类似于心跳信息。
ocpp 定义了一个 key 来配置这个功能：
| 配置键 | 说明 |
|---|---|
| WebSocketPingInterval | 0-禁用客户端 websocket Ping/Pong，客户端可以回复Pong。 |
| >0 客户端ping的间隔秒数 |
消息框架
- 发送一条消息（CALL），收到一条回复（CALLRESULT）或无法正确处理的解释（CALLERROR）；
- 除非之前发送的所有 CALL 信息都已响应或超时，否则充电点或中央系统不应向对方发送 CALL 信息，实施方可自由选择超时时间间隔；
- 字符编码：UTF8；
- 消息类型：
| 消息类型 | 类型编号 | 方向 |
|---|---|---|
| CALL | 2 | 客户端对服务器 |
| CALLRESULT | 3 | 服务器到客户端 |
| CALLERROR | 4 | 服务器到客户端 |
- 消息ID:
| 名称 | 数据类型 | 限制 | 要求 |
|---|---|---|---|
| messageId | 字符串 | 最多 36 个字符 | 1. ID 必须不同于同一发送方在同一 WebSocket 连接上用于 CALL 消息的所有消息 ID |
| 2. CALLRESULT 或 CALLERROR 的消息 ID 必须等于所响应的 CALL 消息的 ID |
- CALL 消息格式：
[<MessageTypeId>, "<UniqueId>", "<Action>", {<Payload>}]
- CallResult :
[<MessageTypeId>, "<UniqueId>", {<Payload>}]
- CallError:
[<MessageTypeId>, "<UniqueId>", "<errorCode>", "<errorDescription>", {<errorDetails>}]
| 错误码 | 描述 |
|---|---|
| NotImplemented 未实施 | Requested Action is not known by receiver 接收者不知道所请求的操作 |
| NotSupported 不支持 | Requested Action is recognized but not supported by the receiver 请求已被识别，但接收方不支持 |
| InternalError 内部错误 | An internal error occurred and the receiver was not able to process the requested Action successfully 接收方无法成功处理请求的操作 |
| ProtocolError 协议错误 | Payload for Action is incomplete 操作的消息内容不完整 |
| SecurityError 安全错误 | During the processing of Action a security issue occurred preventing receiver from completing the Action successfully 处理过程中出现安全问题，导致接收方无法成功完成操作 |
| FormationViolation 违反形态 | Payload for Action is syntactically incorrect or not conform the PDU structure for Action 操作的有效内容语法错误或不符合消息结构 |
| PropertyConstraintViolation 违反属性限制 | Payload is syntactically correct but at least one field contains an invalid value 消息语法正确，但至少有一个字段包含无效值 |
| OccurenceConstraintViolation 违反事件限制 | Payload for Action is syntactically correct but at least one of the fields violates occurence constraints 操作的消息语言正确，但至少有一个字段违反了限制条件 |
| TypeConstraintViolation 违反类型限制 | Payload for Action is syntactically correct but at least one of the fields violates data type constraints 操作的消息语言正确，但至少有一个字段的数据类型错误 |
| GenericError 通用错误 | Any other error not covered by the previous ones 前面未涵盖的其它错误 |