周界报警主机对接方案介绍
1、概述
1.1 编写目的
本文档为周界报警主机设备厂商的技术人员，介绍周界报警主机接入到边缘网关（物业一体机）的对接方案和设备驱动的开发流程。
1.2 名词解释
名词 | 解释 |
Link IoT Edge | 物联网边缘计算产品（Link IoT Edge，简称LE），即阿里云物联网平台（IoT）中的边缘计算产品。提供安全可靠的数据计算能力，可供本地处理设备数据，减少上传云端的成本。 |
网关 | 运行Link IoT Edge软件的计算设备统称为边缘网关或边缘服务器，简称网关。 |
子设备 | 指通过一定的协议或接口接入到Link IoT Edge网关上的设备（即设备接入到网关后称为子设备），网关代理该子设备与云端进行通信。 |
驱动 | Link IoT Edge中的设备接入模块称为驱动（driver）或设备接入驱动。所有连接到Link IoT Edge的设备都需要通过驱动实现接入。 |
2、系统架构图
图解说明：
① 云端应用：周界报警应用软件。功能包括通道设置、通道状态查询，通道告警事件接收和处理等，该软件基于云平台提供的物模型相关的服务端订阅和云产品流转，实现对设备上报事件的处理及对设备的控制。
② 云平台：物联网云平台，向自定义驱动提供物模型。
③ 边缘网关：边缘网关内含有自定义协议驱动。驱动运行在LE组件中，负责管理及控制设备，其中包含阿里云提供的设备接入SDK（LEDA）部分和开发者实现部分。
④ 设备端：周界报警主机及下面接入的通道设备。设备供应商应提供设备通信协议，供驱动访问或控制设备使用。设备供应商应提供硬件配置工具，可以进行设备初始化、设备参数配置及故障定位功能。
3、交互流程
3.1 通道设置
云端应用对指定的通道进行布防或撤防通道设置时，交互流程如下图所示
此外，通道列表查询，通道状态查询，消除报警的流程，与上面类似
3.2 通道告警
周界报警的通道设备出现告警时，例如入侵告警、触网告警等，将上报给周界报警主机。周界报警主机将出现告警的通道号及告警类型通知边缘网关驱动，最后上报到应用，交互流程示意如下：
此外，告警解除事件的上报流程，与上图的通道告警事件上报流程类似
4、对接流程
4.1 明确方案分工
根据系统架构图的内容，进行方案可行性评估，理解自定义协议驱动所处的位置。
明确各环节项目分工——需要设备端技术人员和协议驱动开发人员明确各自负责内容。
明确自定义协议驱动需要实现的功能，参考对应设备的物模型（请参考《周界报警设备物模型》文档的物模型介绍）。
明确自定义协议驱动与设备的通信方式，需要设备厂商提供设备端SDK，使自定义协议驱动可以基于该SDK实现访问设备数据和下发控制命令的功能。
4.2 信息收集
提供设备的硬件型号、设备ID
4.3 驱动开发
参考《周界报警主机驱动开发指导》文档，了解物联网设备接入，熟悉LEDA接口，熟悉实现驱动的基本方式，开发自定义协议驱动。
自定义协议驱动需通过驱动日志确认设备向云平台注册上线的接口被调用，并保证设备持续稳定地处于在线状态。
自定义协议驱动需通过驱动日志确认设备上报事件的接口被调用，通过驱动日志确认服务方法接口被调用。
在物联网应用服务平台，新创建的驱动英文名称定义有下面的规范建议：
驱动名称包含内容：
厂商名称_厂商产品型号_适用领域_驱动功能
如果这个驱动是通用驱动，适用所有厂商，则驱动名称里可以去掉厂商名称和厂商产品型号；
如果这个驱动支持某个厂商的所有产品型号，则驱动名称里可以去掉厂商产品型号。
适用领域
说明：
人行：PerAccess（personal access）
车行：VehAccess（vehicle access）
EBA：EBA
安防：SecSystem（security system）
驱动功能
说明：
例如EBA领域的Modbus功能，例如人行领域的可视对讲功能。
驱动名称
使用大驼峰命名规范，即每个单词的首字母都要求是大写
举例说明：
有一个驱动，可以支持广拓公司（Goto）的A7型号的周界报警主机设备，驱动名称可定义为：
Goto_A7_SecSystem_Perimeter
5. 物模型
请参考物联网应用服务平台里品类管理-周界报警主机，如下图所示
