本文介绍用户如何通过生活物联网SDK开发接入生活物联网的蜂窝网(2/3/4/5G移动通信协议、NB-IoT)设备。

在生活物联网平台定义产品

  1. 创建项目。
    参见创建项目
  2. 创建产品。
    参见新建产品连网方式选择蜂窝(2/3/4G)
  3. 添加测试设备。
    参见在线调试设备来添加测试设备,并设置设备的绑定策略等。

设备端开发

请参见SDK概述与开发环境设置下载无AliOS的SDK(基于Link Kit v2.3.0)。

  • SDK推荐配置

    建议开发者阅读编译说明中的“SDK裁剪”,了解SDK配置以及各选项的意义。

    可以通过修改make.settings或者Linux下执行make menuconfig来配置需要的功能。

    功能 说明
    FEATURE_MQTT_COMM_ENABLED y:使用MQTT连接阿里云物联网平台
    FEATURE_MQTT_DIRECT

    y:连国内服务器

    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的实现:

  • 设备身份认证模式

    设备连接阿里云物联网平台时,可以使用预置设备证书的方式进行设备的身份认证,也可以采用动态注册方式得到完整的设备证书再进行身份认证,请参见设备认证

  • 产品功能实现

    在设备上根据云端定义的产品功能进行相应功能的实现,请参见物模型编程

  • 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();