梯控边缘接入API

更新时间:2019-12-26 10:42:17

梯控边缘解决方案>>

1、简介

由于梯控设备接口基于RS485,因此需要额外的代理设备如门禁机、TCP串口网关等连接梯控设备,将其接入边缘网关。边缘网关使用TCP socket连接与梯控(代理)设备进行通信。梯控、代理设备和梯控系统三者的关系如下图所示:

elevator

图中的梯控代理设备和梯控部分由设备厂家负责,梯控系统和边缘网管的交互通过边缘网关与代理设备间的交互完成,具体的API接口细节请参考下面。

2、边缘网关与梯控代理设备API

2.1 梯控设备连接上线

初始阶段梯控设备需要与边缘网关建立起连接,并根据边缘网关的设备ID查询请求上报自己的设备ID。梯控设备上线的交互流程如下图所示:

connect

整个过程在边缘网关和梯控系统之间设计两个接口。

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初始版本。

results matching ""

    No results matching ""