蜂窝网单品设备开发
更新时间:2019-04-16 10:03:37
本文讲解用户如何通过Link Kit SDK开发使用蜂窝网单品设备。
在飞燕后台定义产品
- 创建项目以及创建产品
请参考“创建产品”了解如何创建项目、以及创建产品,创建产品时“连网方式”选择“蜂窝(2/3/4G)”。
- 产品功能定义
请参考“功能定义”来定义产品的功能
- 添加测试设备
请参考“设备调试”来添加测试设备、设置设备的绑定策略等。
设备端开发
使用C语言Link Kit SDK开发设备
请点击SDK获取页面下载SDK
SDK推荐配置
V3.0.1
版本v3.0.1支持通过配置工具对SDK需要的功能进行配置,获取SDK之后使能相应功能即可,配置工具启动方式:
- Linux
在SDK目录下键入命令: make menuconfig
- Windows
运行SDK目录下的文件: config.bat
推荐使能的配置如下:
PLATFORM_HAS_STDINT
PLATFORM_HAS_OS
FEATURE_MQTT_COMM_ENABLED
FEATURE_MQTT_DIRECT
FEATURE_DEVICE_MODEL_ENABLED
强烈建议开发者阅读编译说明中的“SDK裁剪”了解SDK配置以及各选项的意义。
V2.3.0
v2.3.0版本需要开发者手动修改make.settings来设置需要的功能,推荐的配置如下:
功能 | 数值 | 说明 |
---|---|---|
FEATURE_MQTT_COMM_ENABLED | y | 使用MQTT连接阿里云物联网平台 |
FEATURE_MQTT_DIRECT | y | 指定阿里云物联网服务器region |
FEATURE_Device_MODEL_ENABLED | y | 使能物模型 |
FEATURE_ALCS_ENABLED | n | 使能本地控制功能 |
FEATURE_ALCS_SERVER_ENABLED | n | 使能本地控制被控端功能 |
FEATURE_DEV_BIND_ENABLED | n | 使能用户绑定相关功能 |
FEATURE_SUPPORT_TLS | y | 使能TLS加密 |
FEATURE_OTA_ENABLED | y | 使能OTA |
注:若设备的销售对象是国外,FEATURE_MQTT_DIRECT=n,将开启动态连云功能。
HAL适配
请参照下面的文档进行HAL的实现:
选择设备认证模式
设备连接阿里云物联网平台时,可以使用预置三元组的方式进行设备的身份认证,也可以采用动态注册方式得到完整的三元组再进行身份认证,请参考“设备认证”了解编程细节。
产品功能实现
在设备上根据云端定义的产品功能进行相应功能的实现,请参考“物模型编程”了解细节;
OTA开发
若使能了OTA功能,请参照“OTA编程”了解如何实现固件升级。
设备重置开发
对于飞燕平台来说,建议产品设计一个reset按键用于清除设备上的配置,将设备恢复到出厂状态,同时调用awss_report_reset()函数告知云端清除设备与用户的绑定关系。
因此,设备商需要在处理reset按键的逻辑中增加对awss_report_reset()的调用。
/*
应用程序调用该API后,Linkkit首先往Flash里存储恢复出厂设置的标志,并向云端上报reset操作,
在规定的时间内(3秒)如果没有收到云端的回复,设备会重新上传reset,直至收到云端的回复位置;
有些产品希望发生reset时设备可以重新启动,如果重新启动之前reset没有上报成功,下一次连接云后,
设备会首先检查Flash中恢复出厂标志是否设置,如果设置了则首先向云端上报reset,直至成功;
*/
int awss_report_reset();
使用其它编程语言的Link Kit SDK开发设备
非C语言的Link Kit SDK由于不需要进行系统适配,同时对系统的内存要求不那么严苛,所以不提供功能裁剪功能,用户根据相关开发文档进行产品开发即可。
目前支持的Link Kit SDK支持的编程语言类型:
- 使用安卓Link Kit SDK开发设备
- 使用NodeJS Link Kit SDK开发设备
- 使用Java Link Kit SDK开发设备
- 使用Python Link Kit SDK开发设备