厂商对接使用说明

更新时间:2020-02-26 19:22:57

术语约定

1、SDK:Software Development Kit(软件开发工具包),本节所述的SDK均指全屋边缘网关的SDK。
2、VDA: Vendor Device Access,厂商设备接入方式,厂商通过实现VDA SDK的接口实现设备上云。
3、厂商驱动:使用VDA SDK开发的、提供厂商设备接入能力的应用程序。
4、产品三要素:阿里IoT设备的能力分成三种类型,分别是属性、事件和服务。这三种能力简称设备的
三要素。
5、产品物模型:简称TSL,即Thing Specification Language。是一个JSON格式的文件。定义物模型即定义
产品功能,从属性、服务和事件三个维度,分别描述了该实体是什么,能做什么,可以对外提供哪些信息。
定义了这三个维度,即完成了产品功能的定义。
6、设备证书:设备证书指设备连接阿里云的身份认证信息。设备证书包含ProductKey、DeviceName和
DeviceSecret。设备证书是设备后续与物联网平台交流的重要凭证,请妥善保管。
7、子设备:不能直接连接到云端,只能通过网关代理上云的设备。比如使用Zigbee协议的设备。
8、子设备动态注册:网关连接上云后,网关使用子设备的ProductKey和DeviceName通过动态注册获取
DeviceSecret。一般ProductKey根据产品型号转换而来,DeviceName根据设备MAC地址而来。厂商不
需要维护DeviceSecret。
9、ICA设备:使用阿里的ICA标准数据格式(Alink JSON)与云端通信的设备。

设备创建流程

1 创建项目

首先访问生活物联网平台:https://living.aliyun.com,登陆后,创建新项目,如下
1.png

2 创建网关

1、选择创建新产品按钮,新建网关产品。
2.png

2、功能定义界面,如果网关具有特殊功能,可选择“添加功能”来增加“自定义功能”。
3.png

3、设备调试界面,可以添加开发测试阶段所使用的调试设备。
4.png
5.png

4、人机交互界面,打开“使用公版App控制产品”开关,配置“产品面板”,设置“多语言管理”和“设备告警”。
6.png

5、批量投产界面,选择开发完成,发布网关产品。注意:只有产品发布完成后,设备才能被app发现添加。
7.png


到此网关产品和测试设备创建完成,把测试设备的激活凭证(设备证书:ProductKey,DeviceName,DeviceSecret)添加到linkedge的配置中,启动linkedge即可上线网关设备。

3 创建网关子设备

1、选择创建新产品按钮,新建网关子设备产品。
11.png

2、功能定义界面,如果网关子设备具有特殊功能,可选择“添加功能”来增加“自定义功能”。
12.png

3、设备调试界面,可以添加开发测试阶段所使用的调试设备。
13.png

4、人居交互界面,打开“使用公版App控制产品”开关,配置“产品面板”,设置“多语言管理”、“配网引导”和“设备告警”。
14.png
15.png

5、批量投产界面,选择开发完成,发布网关子设备产品。
16.png

6、量产管理界面,添加网关子设备的烧录方式为一型一密(动态注册)。开启后,设备才可以被app正常添加使用。
17.png
18.png

到此网关子设备产品和测试设备创建完成,把测试设备的ProductKey和DeviceName添加到虚拟子设备程序或VDA sample程序中,完成子设备上线、控制等功能。

设备使用示例

1 App登陆

1、安装智能人居app(demo app),安装完成后,启动应用程序。
Screenshot_20191030-105816.jpg

2、注册手机账号,输入账号密码后登陆。
Screenshot_20191030-105831.jpg

2 添加网关

1、手机连接Wi-Fi,确保手机与网关在同一个局域网内,然后点击“+”号添加网关。
Screenshot_20191030-110222.jpg

2、在添加设备界面,通过本地发现网关设备,点击添加。
Screenshot_20191030-112200.jpg

3、添加完成后,在设备列表,可以看到网关设备。
Screenshot_20191030-112223.jpg

3 添加网关子设备

1、点击“+”号添加网关子设备。在添加设备界面,点击右上角扫一扫。
Screenshot_20191030-113028.jpg

2、扫描网关子设备的二维码(飞燕平台生成)。
Screenshot_20191030-113106.jpg

3、选择代理子设备上网的网关。
Screenshot_20191030-113203.jpg

4、根据界面提示,操作网关子设备进入配网模式,点击确认开始进行配网。
Screenshot_20191030-113211.jpg

5、网关子设备配网完成后,在设备列表,可以看到网关子设备。
Screenshot_20191030-113304.jpg

6、在设备操作面板,可以对子设备进行功能控制。

results matching ""

    No results matching ""