梯控边缘接入API
更新时间：2019-12-26 10:42:17
1、简介
由于梯控设备接口基于RS485，因此需要额外的代理设备如门禁机、TCP串口网关等连接梯控设备，将其接入边缘网关。边缘网关使用TCP socket连接与梯控（代理）设备进行通信。梯控、代理设备和梯控系统三者的关系如下图所示：
图中的梯控代理设备和梯控部分由设备厂家负责，梯控系统和边缘网管的交互通过边缘网关与代理设备间的交互完成，具体的API接口细节请参考下面。
2、边缘网关与梯控代理设备API
2.1 梯控设备连接上线
初始阶段梯控设备需要与边缘网关建立起连接，并根据边缘网关的设备ID查询请求上报自己的设备ID。梯控设备上线的交互流程如下图所示：
整个过程在边缘网关和梯控系统之间设计两个接口。
2.1.1 连接建立
调用发起方：梯控代理设备
描述：梯控代理设备向边缘网关的
10040端口发起TCP Socket连接建立请求。如果连接断开，梯控代理设备需要再次发起新的连接请求，每个梯控和边缘网关之间有唯一的一条连接。
2.1.2 获取设备ID
发起方：边缘网关
描述：连接成功建立后，边缘网关向梯控系统发起梯控设备ID查询请求，获取梯控设备的唯一标识。设备ID可以是SN或者其他能唯一标识梯控设备的字符串，只包含字母、数字、下划线，由本地系统自行定义。边缘网关发起设备ID查询请求后，会等待10s，如果在设定时间内未收到梯控系统的响应，则断开和梯控设备的连接。
请求包格式（边缘网关 => 梯控）：
| 字段 | 请求包 |
|---|---|
| 包头（1 BYTE） | 0x41 |
| 数据长度（1 BYTE） | 0x05 |
| 命令码（1 BYTE） | 0xC0 |
| 校验和（1 BYTE） | 0xC5 |
| 包尾（1 BYTE） | 0x4A |
校验和 = (数据长度值 + 命令码值 + 数据域值) & 0xFF
应答包格式（梯控 => 边缘网关）
| 字段 | 应答包 |
|---|---|
| 包头（1 BYTE） | 0x41 |
| 数据长度（1 BYTE） | N+5 |
| 命令码（1 BYTE） | 0xC1 |
| 数据域（N BYTEs） | 设备ID |
| 校验和（1 BYTE） | 校验和算法同上 |
| 包尾（1 BYTE） | 0x4A |
2.2 释放部分楼层
发起方：边缘网关
描述：边缘网关调用梯控系统释放列出的楼层，梯控系统只需要根据收到的释放列表执行释放操作，使用户可以自行选择释放的楼层。
请求包格式（边缘网关 => 梯控）：
| 字段 | 请求包 |
|---|---|
| 包头（1 BYTE） | 0x41 |
| 数据长度（1 BYTE） | N + 5 |
| 命令码（1 BYTE） | 0xA1 |
| 数据域（N BYTEs） | 释放楼层总数，FLOOR1, FLOOR2 ... |
| 校验和（1 BYTE） | 校验和算法同上 |
| 包尾（1 BYTE） | 0x4A |
暂不考虑贯通梯门侧问题。
2.3 释放全部楼层
发起方：边缘网关
描述：边缘网关调用梯控系统释放全部楼层，梯控系统只需要执行释放操作，使用户可以自行选择楼层。
请求包格式（边缘网关 => 梯控）：
| 字段 | 请求包 |
|---|---|
| 包头（1 BYTE） | 0x41 |
| 数据长度（1 BYTE） | 0x05 |
| 命令码（1 BYTE） | 0xA2 |
| 校验和（1 BYTE） | 校验和算法同上 |
| 包尾（1 BYTE） | 0x4A |
2.4 呼梯
调用发起方：边缘网关
描述：边缘网关调用梯控系统呼叫电梯，登记目的楼层。
请求包格式（边缘网关 => 梯控）：
| 字段 | 请求包 |
|---|---|
| 包头（1 BYTE） | 0x41 |
| 数据长度（1 BYTE） | N + 5 |
| 命令码（1 BYTE） | 0xA3 |
| 数据域（2 BYTEs） | 出发楼层，目的楼层 |
| 校验和（1 BYTE） | 校验和算法同上 |
| 包尾（1 BYTE） | 0x4A |
部分梯控厂家呼梯时只有目的楼层，无出发楼层，可以根据不同的厂商需求做配置适配。
发布历史
v0.1.0 2019-12-30
- 梯控设备对接API初始版本。