本文介绍生活物联网SDK V1.3.0版本相对于SDK V1.1.0新增的功能,以及开启相应功能的方法。

生活物联网平台SDK V1.3.0是基于上一个版本(V1.1.0)的功能递增,主要优化了目录结构和新增了功能。

  • 优化目录结构

    将开发的代码存放到Products/品类目录/应用名/…下(例如Products/example/smart_outlet为单路智能插座参考实现)。SDK V1.3.0的详细目录结构如下图所示。

    目录结构

    SDK V1.3.0版本与SDK V1.1.0的目录结构对比,如下图所示。

    目录机构对比
  • 新增功能

    除了优化了目录结构,生活物联网平台SDK V1.3.0相比SDK V1.1.0主要新增以下功能。

    • 设备厂商测试批量配网
    • 终端用户批量配网
    • 设备热点配网错误码诊断
    • 本地组控/组律动
    • 离线OTA
    • WiFi设备零配token优化

设备厂商测试批量配网

如果您是设备厂商,您可以在产线上将设备连到指定的产测路由器,开启此功能时设备在上电3s内自动连接路由器。

该功能默认关闭,您如需开启此功能,请按以下步骤操作。

  1. 在应用mk文件中增加配置项GLOBAL_CFLAGS += -DMANUFACT_AP_FIND_ENABLE
  2. app_entry.c文件中更改产测路由器SSID和密码。
    • 默认SSID为ali_mprov_TEST_AP,其中ali_mprov_是模块自动加入的SSID前缀,TEST_AP是开发者可自定义设定的字段
    • 默认密码为TEST_PASSWORD
    配置示例
    说明 如果从应用层设定的部分SSID字段,或路由器密码字段为空,该模块功能不会启用。如果设定了正确的SSID和密码,设备在未配网状态下开机时会搜索该路由器,如果搜索到就会连接,搜索不到则会进入正常的待配网状态。

终端用户批量配网

支持App终端用户对多个同一型号的设备进行快速的批量配网,设备需支持设备热点配网或零配,每次最多可批量配网20个设备。

您如需开启此功能,需在应用mk文件中增加配置项GLOBAL_CFLAGS += -DAWSS_BATCH_DEVAP_ENABLE(如您基于living_platform开发,在living_platform.mk文件中已包含该配置项,如下图所示)。

配置示例

设备热点配网错误码诊断

此功能支持设备通过热点配网连路由器或连云过程中产生的异常,通过App端的“错误诊断”功能展示出来。

您如需开启此功能,需在应用mk文件中增加配置项GLOBAL_CFLAGS += -DDEV_ERRCODE_ENABLE(如您基于living_platform开发,在living_platform.mk文件中已包含该配置项,如下图所示)。

配置示例

本地组控/组律动

此功能提供了灯品类组内设备同步律动能力。

您如需开启此功能,请按以下步骤操作。

  1. 确认本地通信功能已经打开,即make.settings文件中FEATURE_ALCS_ENABLED设置为y,如下图所示。
    配置示例
  2. 在应用mk文件中增加配置项。如您基于living_platform开发,在living_platform.mk文件中增加以下配置项。
    GLOBAL_CFLAGS += -DALCS_GROUP_COMM_ENABLE
    GLOBAL_CFLAGS += -DDM_UNIFIED_SERVICE_POST

离线OTA

此功能提供了设备在设备热点下配网或连云失败后通过固件升级进行固件修复的手段,支持普通和安全离线升级。

您如需开启此功能,需在应用mk文件中增加配置项GLOBAL_CFLAGS += -DDEV_OFFLINE_OTA_ENABLE(如您基于living_platform开发,在living_platform.mk文件中已包含该配置项,如下图所示)。

配置示例

您还可以按照以下步骤启用离线OTA安全签名校验。

  1. 在应用mk文件中增加配置项:GLOBAL_CFLAGS += -DDEV_OFFLINE_SECURE_OTA_ENABLE
  2. 获取产品的公钥。在控制台的运营中心 > 设备运维 > 固件升级 > 安全升级页面中, 打开对应产品的安全升级开关,并单击复制安全升级
  3. Living_SDK/framework/uOTA/src/verify/ota_public_key_config.h文件中,将下图的两行数据(红框所示),替换为获取的公钥信息。配置示例

WiFi设备零配token优化

此功能支持在零配过程中,由App端生成绑定用的token并传输给设备,从而解决零配方案在路由器设置AP隔离模式下绑定失败的问题。

您如需开启此功能,需在应用mk文件中增加配置项GLOBAL_CFLAGS += -DAWSS_ZCONFIG_APPTOKEN(如您基于living_platform开发,在living_platform.mk文件中已包含该配置项,如下图所示)。

配置示例

编译SDK V1.3.0

您可通过更改build.sh默认变量参数,并执行./build.sh 来编译SDK,从而生成烧录所需的固件。build.sh的参数说明如下(更多介绍请参见README.md)。

产品类型:default_type="example"
应用名称:default_app="smart_outlet"
模组型号:default_board="uno-91h"
连云区域:default_region=SINGAPORE //连接国内为MAINLAND
连云环境:default_env=ONLINE
Debug log:default_debug=0
其他参数:default_args=""     //可配置其他编译参数
配置示例