本文以TG7100C芯片为例,介绍在开发天猫精灵生态项目智能插座产品时,使用开发板调试配网连云的过程,以及OTA、量产设备证书等注意事项。
创建与配置产品
创建一个天猫精灵生态项目。具体操作,请参见创建项目。
创建一个品类为插座的产品。
定义产品功能。
在功能定义页面配置产品的功能,更多操作请参见新增标准功能。
说明天猫精灵生态项目设备定时相关的功能需要添加DeviceTimer属性,在下方步骤4中配置人机交互-定时服务后会自动添加该属性至功能定义页面。
配置人机交互。
如需在TG7100C芯片上使用蓝牙辅助配网,配网方式需选择为蓝牙辅助配网。
其余配置项的介绍,请参见配置App。
进入设备调试界面,单击新增测试设备生成测试设备证书。
新蓝牙辅助配网要求Wi-Fi的MAC地址与设备证书中的Device Name保持一致。在TG7100C开发板上,可以在固件运行后通过串口输入mac指令。查询芯片当前的Wi-Fi的MAC地址,并用此MAC地址作为Device Name在设备调试页面申请测试设备证书。
说明MAC地址中的字母全部为小写格式。
查询Wi-Fi的MAC地址示例
#mac MAC address: 18-b9-05-c0-6e-d5
输入小写格式的MAC地址,如示例中的18b905c06ed5作为DeviceName生成测试设备。
拷贝测试设备证书。
说明请注意一定要依次完整拷贝1、ProductKey;2、DeviceName;3、DeviceSecret;4、ProductSecret;5、ProductID。
设备配网连云
设置设备证书。
将设备固件烧录到开发板之后,可以通过linkkey命令设置设备证书,然后通过reset命令重置设备。
设置设备证书信息,在设备上电后将完整的设备证书信息写入开发板。
linkkey ProductKey DeviceName DeviceSecret ProductSecret ProductID
设备重置,清除设备配网信息。
reset
设置天猫精灵App配网。
在开发板上设置自有品牌产品的设备证书,并重置设备后,设备会处于待配网状态,会通过BLE广播自己的蓝牙辅助配网相关的设备信息。
天猫精灵App可在其设备中发现页面处于待配网状态的设备,通过App界面可发起对设备的蓝牙辅助配网。
天猫精灵App配网过程如下图所示。
设置天猫精灵音箱配网。
通过语音输入天猫精灵找队友即可发起零配。
配网连云设备端关键日志示例。
蓝牙辅助配网
配网状态
命令/动作
预期日志
设备重置
reset
start-----------hal
开启蓝牙辅助配网
ble_awss
ble_awss_open
Parse SSID/PWD
设备解析出热点信息
IOTX_AWSS_GOT_SSID_PASSWD
AP Connect
设备连接AP
IOTX_AWSS_CONNECT_ROUTER
DHCP Get IP
设备获取IP地址
IOTX_AWSS_GOT_IP
Cloud Connect
连云成功
Cloud Connected
零配
配网状态
命令/动作
预期日志
设备重置
reset
start-----------hal
Dev Scan
awss
IOTX_AWSS_START
Awss Process
active_awss
IOTX_AWSS_ENABLE
Parse SSID/PWD
设备解析出热点信息
IOTX_AWSS_GOT_SSID_PASSWD
AP Connect
设备连接AP
IOTX_AWSS_CONNECT_ROUTER
DHCP Get IP
设备获取IP地址
IOTX_AWSS_GOT_IP
Cloud Connect
连云成功
Cloud Connected
一键配网
配网状态
命令/动作
预期日志
设备重置
reset
start-----------hal
Dev Scan
awss
IOTX_AWSS_START
Awss Process
active_awss
IOTX_AWSS_ENABLE
Parse SSID/PWD
设备解析出热点信息
IOTX_AWSS_GOT_SSID_PASSWD
AP Connect
设备连接AP
IOTX_AWSS_CONNECT_ROUTER
DHCP Get IP
设备获取IP地址
IOTX_AWSS_GOT_IP
Cloud Connect
连云成功
Cloud Connected
设备端上定时功能
天猫精灵生态项目开发设备端上定时功能与自有品牌项目有区别,自有品牌项目本地定时功能基于LocalTimer属性开发,而天猫精灵生态项目本地定时功能基于新的DeviceTimer属性。
自有品牌项目定时功能开发请参见开发设备端本地定时功能。
因此在控制台定义产品功能的时候,要添加DeviceTimer属性,并确认在面板里添加了预约组件。
控制台配置和设备端开发的详细介绍请参见开发天猫精灵项目Wi-Fi产品设备端上定时功能。
固件OTA
以天猫精灵生态项目产品为例说明OTA的过程。
进入生活物联网平台的运营中心。
进入 页面,选择相应项目下的相应产品。
获取待升级固件文件和版本信息。TG7100C固件编译成功后在readme.txt文件中保存固件的版本信息,tg7100cevb_ota.bin文件即为OTA的bin文件。
进入固件升级,在固件列表窗口下操作下列步骤。
单击添加固件。
在固件版本号栏中拷贝并输入OTA固件版本号。
在签名算法栏中,如TG7100C芯片固件签名算法必须选择SHA256。
单击选择固件下的上传固件,选择上传待升级的OTA.bin文件。
单击确定完成添加固件。
进入天猫精灵App,在查看待验证设备的设备详情页面单击立即更新开始OTA升级。
升级完成后,查看运营中心升级状态。
量产设备
前文介绍了新蓝牙辅助配网方案需要在设备中写入设备证书,并且Device Name与Wi-Fi MAC地址保持一致。测试设备证书可以通过读取开发板的Wi-Fi地址后在设备调试页面生成,本节介绍自有品牌项目量产阶段如何生成和获取设备证书。生活物联网平台设备量产详细说明,请参见量产流程介绍与量产设备。
自动生成设备证书。
对于天猫精灵生态项目的产品,生活物联网平台有MAC地址段,在人机交互页面的配网引导中,选择蓝牙辅助配网后,生成设备证书时可以分配合法MAC地址作为Device Name。
说明注意下载的Device Name(MAC地址)应全部为小写格式,后续的处理流程也要保持小写。
烧录时通过量产烧录工具写入Device Name同时覆盖芯片Wi-Fi MAC即可实现Device Name与Wi-Fi MAC地址保持一致的要求。
天猫精灵生态项目产品在量产设备时,选择自动生成即可。
在设备证书(默认包括ProductKey,DeviceName, DeviceSecret)中补充 ProductSecret与ProductID。
下载的设备证书清单,需要通过文本处理才能生成符合TG7100C批量烧录工具需要的设备证书清单的格式。
在设备证书清单中在增加
ProductSecret
、ProductID
的内容。其中第一行的ProductSecret,ProductID
拼写(含大小写)也严格保持一致。可以通过文本编辑器或者编写一个文本处理程序来处理。说明注意不要通过Excel编辑,这可能将CSV文件转为Excel的格式。
烧录设备证书。
在资源中心下载TG7100C量产指导烧录篇,按文档将包含设备证书的CSV文件,导入到数据库后进行烧录。