开发天猫精灵生态项目插座产品

创建与配置产品

1. 创建一个天猫精灵生态项目。具体操作，请参见创建项目。
2. 创建一个品类为插座的产品。
   
3. 定义产品功能。
   在功能定义页面配置产品的功能。

   说明 天猫精灵生态项目定时相关的功能需要添加DeviceTimer属性。

   
4. 配置人机交互。
   如需在TG7100C芯片上使用蓝牙辅助配网，配网方式需选择为蓝牙辅助配网。

   其余配置项的介绍，请参见配置App。

5. 进入设备调试界面，单击新增测试设备生成测试设备证书。
   新蓝牙辅助配网要求Wi-Fi的MAC地址与设备证书中的Device Name保持一致。在TG7100C开发板上，可以在固件运行后通过串口输入mac指令。查询芯片当前的Wi-Fi的MAC地址，并用此MAC地址作为Device Name在设备调试页面申请测试设备证书。

   说明 MAC地址中的字母全部为小写格式。

   1. 查询Wi-Fi的MAC地址示例

      #mac
      MAC address: 18-b9-05-c0-6e-d5

   2. 输入小写格式的MAC地址，如示例中的18b905c06ed5作为DeviceName生成测试设备。
   3. 拷贝测试设备证书。
      说明 请注意一定要依次完整拷贝1、ProductKey；2、DeviceName；3、DeviceSecret；4、ProductSecret；5、ProductID。
      

设备配网连云

1. 设置设备证书。
   • 将设备固件烧录到开发板之后，可以通过linkkey命令设置设备证书，然后通过reset命令重置设备。
   • 设置设备证书信息，在设备上电后将完整的设备证书信息写入开发板。

     linkkey ProductKey DeviceName DeviceSecret ProductSecret ProductID

   • 设备重置，清除设备配网信息。

     reset

2. 设置天猫精灵App配网。
   • 在开发板上设置自有品牌产品的设备证书，并重置设备后，设备会处于待配网状态，会通过BLE广播自己的蓝牙辅助配网相关的设备信息。
   • 天猫精灵App可在其设备中发现页面处于待配网状态的设备，通过App界面可发起对设备的蓝牙辅助配网。
   • 天猫精灵App配网过程如下图所示。
3. 设置天猫精灵音箱配网。

   通过语音输入天猫精灵找队友即可发起零配。

4. 配网连云设备端关键日志示例。
   • 蓝牙辅助配网

     配网状态	命令/动作	预期日志
     设备重置	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的过程。

1. 进入生活物联网平台的运营中心。
2. 进入设备数据 > 固件升级页面，选择相应项目下的相应产品。
   
3. 获取待升级固件文件和版本信息。TG7100C固件编译成功后在readme.txt文件中保存固件的版本信息，tg7100cevb_ota.bin文件即为OTA的bin文件。
   
4. 进入固件升级，在固件列表窗口下操作下列步骤。
   1. 单击添加固件。
   2. 在固件版本号栏中拷贝并输入OTA固件版本号。
   3. 在签名算法栏中，如TG7100C芯片固件签名算法必须选择SHA256。
   4. 单击选择固件下的上传固件，选择上传待升级的OTA.bin文件。
   5. 单击确定完成添加固件。

   
5. 进入天猫精灵App，在查看待验证设备的设备详情页面单击立即更新开始OTA升级。
   
6. 升级完成后，查看运营中心升级状态。
   

量产设备

前文介绍了新蓝牙辅助配网方案需要在设备中写入设备证书，并且Device Name与Wi-Fi MAC地址保持一致。测试设备证书可以通过读取开发板的Wi-Fi地址后在设备调试页面生成，本节介绍自有品牌项目量产阶段如何生成和获取设备证书。生活物联网平台设备量产详细说明，请参见量产流程介绍与量产设备。

1. 自动生成设备证书。
   • 对于天猫精灵生态项目的产品，生活物联网平台有MAC地址段，在人机交互页面的配网引导中，选择蓝牙辅助配网后，生成设备证书时可以分配合法MAC地址作为Device Name。
     说明 注意下载的Device Name（MAC地址）应全部为小写格式，后续的处理流程也要保持小写。
   • 烧录时通过量产烧录工具写入Device Name同时覆盖芯片Wi-Fi MAC即可实现Device Name与Wi-Fi MAC地址保持一致的要求。
   • 天猫精灵生态项目产品在量产设备时，选择自动生成即可。
2. 在设备证书（默认包括ProductKey，DeviceName， DeviceSecret）中补充 ProductSecret与ProductID。
   • 下载的设备证书清单，需要通过文本处理才能生成符合TG7100C批量烧录工具需要的设备证书清单的格式。
   • 在设备证书清单中在增加ProductSecret、ProductID的内容。其中第一行的ProductSecret,ProductID拼写（含大小写）也严格保持一致。可以通过文本编辑器或者编写一个文本处理程序来处理。
     说明 注意不要通过Excel编辑，这可能将CSV文件转为Excel的格式。
     
3. 烧录设备证书。

   在平头哥芯片开放社区的资源下载页面中，下载五元组量产工具使用说明，按文档将包含设备证书的CSV文件，导入到数据库后进行烧录。