本文介绍用户如何通过生活物联网SDK开发接入生活物联网的蜂窝网(2/3/4/5G移动通信协议、NB-IoT)设备。
在生活物联网平台定义产品
创建项目。 创建产品。参见新建产品,连网方式选择蜂窝(2/3/4G)。
添加测试设备。参见在线调试设备来添加测试设备,并设置设备的绑定策略等。
设备端开发
请参见SDK概述与开发环境设置下载无AliOS的SDK(基于Link Kit v2.3.0)。
SDK推荐配置建议开发者阅读编译说明中的“SDK裁剪”,了解SDK配置以及各选项的意义。
可以通过修改make.settings或者Linux下执行make menuconfig来配置需要的功能。
功能 说明 FEATURE_MQTT_COMM_ENABLED y:使用MQTT连接阿里云物联网平台 FEATURE_MQTT_DIRECTy:连国内服务器
n:连海外服务器
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设备需要连接海外服务器请参见国际站设备开发。
HAL适配请参照下面的文档进行HAL的实现:
基础HAL适配 MQTT连云相关的HAL适配 OTA 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();