官方网关使用说明
官方网关简介
官方网关由网关主程序java包、动态加载的驱动包两部分构成。其中,驱动部分需用户自己实现,从而完成对任何自有协议的解析。驱动可以在平台的开发者中心->边缘计算->驱动管理处上传到平台,然后在边缘实例部署时下发到网关,网关根据部署信息,自行拉取驱动并且更换驱动。
官方网关提供了边缘网关主程序包Java版,以及驱动接口包。用户可根据驱动接口中定义的接口自己实现协议的编解码或者设备的接入管理,从而通过驱动实现对私有协议的编解码。
操作步骤
1.准备工作:在准备运行边缘网关的机器环境上,安装Java 1.7以上版本。
2.下载边缘网关主程序包Java版。
3.修改主程序包中的接入域名和端口,从设备管理->产品->对应的网关产品->产品概况中,获取到对应的接入域名和端口。
4.修改主程序包中的配置,从设备管理->产品->对应的网关产品->设备管理中,找到需要上线的网关设备,从认证信息中找到设备id和特征串。
5.用压缩工具打开aep-edge-gateway.jar,进入BOOT-INF/ classes。
6.打开user.properties文件。
7.修改mqtt.host为网关产品tls对应的域名,mqtt.port为网关产品tls对应的端口,mqtt.clientId为创建的网关设备的设备id,mqtt.password修改为创建的网关设备的特征串,保存关闭。
8.运行:可以使用命令java -jar aep-edge-gateway.jar,启动网关程序。到设备管理界面看到对应的网关设备在线,说明边缘网关设备上线成功。网关上线后,平台可以远程部署,发送驱动和子设备信息给网关。
9.本地驱动加载:在aep-edge-gateway.jar所在的文件夹创建lib文件夹,把编译好的驱动jar包,放到lib文件夹中,在启动aep-edge-gateway.jar时,如果没有远程部署过,或者远程部署有问题时,网关会加载lib文件夹下的所有驱动。本地加载的驱动,驱动代码中要写明产品id和驱动id。
10.本地存储设备信息和驱动位置:远程部署下发的设备信息和驱动信息都在aep-edge-gateway.jar所在的文件夹的data文件中,自动保存的为密文。也可以自己明文写设备信息和驱动信息,格式为json,具体格式如下:
[
{
"productId":1,
"devices":[
{
"deviceSn":"test1",
"token":"password1"
},
{
"deviceSn":"test2",
"token":"password2"
}
],
"port":8001,
"drivenPath":"http://asdfasfsdbg.jar",
"drivenName":"driven1.jar"
},
{
"productId":2,
"devices":[
{
"deviceSn":"test1",
"token":"password1"
},
{
"deviceSn":"test2",
"token":"password2"
}
],
"port":8002,
"drivenPath":"http://sdfsdf.jar",
"drivenName":"driven2.jar"
}
]
说明:productId为子设备产品id,port为子设备接入的端口,drivenPath为驱动下载路径(可以为空),drivenName为驱动文件名称(可以为空),devices为子设备列表,deviceSn为子设备编号,token为子设备特征串。