本文以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文件,導入到數據庫后進行燒錄。