本章節介紹了生活物聯網平臺設備端SDK的更新記錄。
SDK V1.6.6新增功能
請通過git pull更新rel_1.6.6分支到最新版本(1.6.6-20)。
版本 | 新增功能說明 |
1.6.6-20 |
|
1.6.6-19 |
|
1.6.6-16 |
|
1.6.6-15 |
|
1.6.6-12 |
|
1.6.6-10 |
|
1.6.6-9 |
|
1.6.6-8 | 本地定時優化。
|
1.6.6-6 |
|
1.6.6-5 |
|
1.6.6-4 |
|
1.6.6 |
|
SDK V1.6.2新增功能
網關支持子設備三元組批量申請、異步下發。
網關支持子設備批量上線。
無AliOS Things SDK支持適配FreeRTOS。
燈品類支持設備本地拾音、律動,授權開放。
SDK V1.6.0新增功能
支持全球統一激活中心
編譯固件時參數default_region配置為SINGAPORE 或者MAINLAND,設備可全球使用。
設備端重連策略優化
此功能優化了MQTT斷連之后重新連云的策略,默認開啟。
藍牙輔助配網時長優化
此功能縮短了藍牙輔助配網與綁定的總時長,默認開啟。
藍牙輔助配網的離線配網和控制
此功能使得在外網不可靠的條件下仍能完成配網,并且App仍能通過藍牙控制設備。
設備本地時鐘同步服務
此功能提供了一種設備間時間同步機制,如可用于多個燈組控時的場景同步。
SDK V1.5.0新增功能
本地組控優化
此功能提升了本地組控時的性能,可以優化燈品類組控、組律動的同步效果,默認開啟。
設備證書分發工具
詳情請參見設備證書分發工具使用指導。
離線恢復出廠設置
此功能支持對離線的設備進行恢復出廠設置操作,設備重新上線后能獲得離線時的恢復出廠設置操作。
SDK V1.4.0新增功能
網關與子設備支持統一激活中心
V1.4.0版本對網關參考應用做了重構,支持中國內地之外地區的子設備可以切換數據中心,請參考如下配置使能該功能。
如您基于AliOS版本SDK開發,需要將Products/example/linkkit_gateway/make.settings文件中FEATURE_DM_UNIFIED_SERVICE_POST設置為y。
如您基于無AliOS版本SDK開發,可以編輯根目錄下面的make.settings文件,增加
FEATURE_DM_UNIFIED_SERVICE_POST=y
。更多詳情請參見網關開發。
設備離線日志功能
對于具備設備熱點配網的能力的設備,如果在設備配網綁定的過程中出現失敗,App會引導用戶進行診斷。進入診斷之后設備會將一些關鍵日志(例如錯誤碼、上報云端的token、獲取IP的時長等)發給App,通過App將這些日志上傳到云端,然后可以在飛燕控制臺的設備管理頁面中進行查看,便于設備的遠程運維。
您如需開啟此功能,在應用mk文件中增加配置項
GLOBAL_CFLAGS += -DDEV_OFFLINE_LOG_ENABLE
(如您基于linkkit_gateway開發,在linkkit_gateway.mk文件中已包含該配置項,如下圖所示)。說明該功能會占用約4KB的代碼空間和將近3 KB的RAM空間,其中占用的RAM空間診斷結束之后會立即釋放,不診斷的情況會在上電五分鐘之后釋放,您可以根據需要決定是否打開該功能。
設備熱點配網優化
此項優化減小了設備通過設備熱點配網連接中國內地之外地區站點的時長,默認開啟。
藍牙輔助配網優化
此項優化減少了設備通過藍牙輔助配網連接中國內地之外的國家和地區(包括中國香港、中國澳門和中國臺灣地區)站點的時長,并在配網進行過程中增加了設備異常自檢信息的獲取和顯示,并能夠在移動端App界面看到詳細的設備異常信息。藍牙輔助配網的以上功能在應用示例comboapp中已開啟,即comboapp.mk中已開啟以下配置項。
GLOBAL_CFLAGS += -DAWSS_REGION_ENABLE GLOBAL_CFLAGS += -DDEV_ERRCODE_ENABLE
說明使用藍牙輔助配網功能的設備,請參考應用示例comboapp開發。
設備連路由器失敗診斷
此功能默認開啟,支持在設備Wi-Fi配網連接路由器失敗時,啟動自檢并分析具體的路由器連接失敗原因。失敗詳情錯誤碼可以通過手機App頁面顯示。
Wi-Fi產線檢測工具模塊
功能說明:此功能作為獨立檢測工具模塊默認開啟,提供給應用層開發時調用,用于搜索指定路由器的詳情。
默認搜索時間最長為3秒。
可檢測路由器是否能被搜索到。
可檢測路由器信號強度是否過弱。
可在搜索到指定路由器時返回結果給應用層。
使用限制
不能在設備熱點模式時使用。
不能在設備和路由器處于連接狀態時使用。
不能在配網模式下使用。
示例代碼:
關于該工具模塊的使用,您可以參考應用示例living_platform中app_entry.c的示例代碼的實現。
#define TEST_LINE_AP "ali_product_line_test" #define TEST_RSSI_THRESHOLD (-60) static void handle_apscan_cmd(char *pwbuf, int blen, int argc, char **argv) { int ret = 0; ap_scan_info_t scan_result; int ap_scan_result = -1; if (argc == 0) { // start ap scanning for default 3 seconds memset(&scan_result, 0, sizeof(ap_scan_info_t)); ap_scan_result = awss_apscan_process(NULL, TEST_LINE_AP, &scan_result); if ( (ap_scan_result == 0) && (scan_result.found) ) { aos_cli_printf("AP Info: auth(%d) chan(%d) mac(%02X:%02X:%02X:%02X:%02X:%02X) rssi(%d)\r\n", scan_result.auth, scan_result.channel, scan_result.mac[0], scan_result.mac[1], scan_result.mac[2], scan_result.mac[3], scan_result.mac[4], scan_result.mac[5], scan_result.rssi); if (scan_result.rssi < TEST_RSSI_THRESHOLD) { aos_cli_printf("AP_SCAN AP rssi too low\r\n"); } else { aos_cli_printf("AP_SCAN AP found\r\n"); } } else { aos_cli_printf("AP_SCAN AP not found\r\n"); } } }
運行living_platform應用的設備上電之后,輸入命令apscan即可觸發一次指定路由器的檢測。
如果檢測到AP熱點的RSSI過低,設備端會有日志打印提示:
AP_SCAN AP rssi too low
。如果檢測到AP熱點,且RSSI較高,設備端會有日志打印提示:
AP_SCAN AP found
。如果未檢測到AP熱點,設備端會有日志打印提示:
AP_SCAN AP not found
。
SDK V1.3.0新增功能
測試批量配網
如果您是設備廠商,您可以在產線上將設備連到指定的產測路由器,開啟此功能時設備在上電3s內自動連接路由器。該功能默認關閉,您如需開啟此功能,請按以下步驟操作。
在應用mk文件中增加配置項
GLOBAL_CFLAGS += -DMANUFACT_AP_FIND_ENABLE
。在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文件中已包含該配置項,如下圖所示)。本地組控/組律動
此功能提供了燈品類組內設備同步律動能力。
您如需開啟此功能,請按以下步驟操作。
確認本地通信功能已經打開,即make.settings文件中FEATURE_ALCS_ENABLED設置為y,如下圖所示。
在應用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安全簽名校驗。
在應用mk文件中增加配置項:
GLOBAL_CFLAGS += -DDEV_OFFLINE_SECURE_OTA_ENABLE
。獲取產品的公鑰。在控制臺的
頁面中, 打開對應產品的安全升級開關,并單擊復制。在Living_SDK/framework/uOTA/src/verify/ota_public_key_config.h文件中,將下圖的兩行數據(紅框所示),替換為獲取的公鑰信息。
Wi-Fi設備零配token優化
此功能支持在零配過程中,由App端生成綁定用的token并傳輸給設備,從而解決零配方案在路由器設置AP隔離模式下綁定失敗的問題。
您如需開啟此功能,需在應用mk文件中增加配置項
GLOBAL_CFLAGS += -DAWSS_ZCONFIG_APPTOKEN
(如您基于living_platform開發,在living_platform.mk文件中已包含該配置項,如下圖所示)。
SDK V1.1.0新增功能
除中國內地以外地區的設備支持統一激活
在中國內地之外的地區具有3個數據中心:新加坡、美國和德國。中國內地以外地區的設備激活聯網時,將統一連接到新加坡激活中心。在設備綁定時,平臺將根據App用戶所在區域,自動將設備切換到相應的數據中心。詳情請參見基于V1.1.0 SDK編譯(linkkitapp)。
定時組件
增加了對倒計時、本地定時、循環計時、以及隨機定時的簡單產品物模型解析支持。
連云優化
提升了設備連云的速度。
配網與綁定優化
一鍵配網組播編碼,避免AP隔離導致的無法綁定,提升綁定成功率。
增加藍牙輔助配網功能。
提供密碼加密存儲。
綁定解綁感知,綁定解綁成功通知設備。