如何配置模組待配網(wǎng)超時時間

在開發(fā)HarmonyOS Connect生態(tài)產(chǎn)品時，你是否對設(shè)備開發(fā)存在這些疑問：

如何獲取HiLink SDK包、userId、設(shè)備deviceId等信息？如何配置模組待配網(wǎng)的超時時間？如何處理設(shè)備配網(wǎng)中KitFramework認(rèn)證失敗？……？

本期FAQ通過三個章節(jié)——信息獲取、設(shè)備連接、其他問題，為大家?guī)?5個設(shè)備開發(fā)常見問題答疑，讓你快速get到解決方案。

趕緊往下看吧~

一、信息獲取

首先是信息獲取方面的問題，包括“HiLink SDK包”、“userId”、“設(shè)備deviceId”內(nèi)容，希望能給你帶來一定幫助~

Q1： 如何獲取HiLink SDK包

1.登錄Device Partner平臺，進(jìn)入“管理中心”。2.在導(dǎo)航欄選擇“產(chǎn)品開發(fā)”，選擇對應(yīng)產(chǎn)品。3.在“集成開發(fā) 》 SDK下載&集成開發(fā) 》 集成開發(fā)”中，即可下載對應(yīng)的HiLink SDK包。

Device Partner平臺：

https://devicepartner.huawei.com/cn/

Q2： 如何獲取“userId”

在云端查詢設(shè)備掛機(jī)日志，需提供有效“userId”。查詢方式如下所示：

方式一：登錄Device Partner平臺查詢。

使用Chrome瀏覽器登錄Device Partner平臺，單擊右上角的“管理中心”。

按F12打開調(diào)試控制臺。

Application中的Storage中查看，或者在Network中通過請求查看。

在“Application”中，選擇“Storage 》 Local Storage”，找到userInfo屬性，即可查詢到userId信息。

在“Network”中，選擇“All”，在搜索框中輸入“getUserInfo”，并按F5刷新頁面。通過“getUserInfo”請求的返回值中即可查詢到userId信息。

方式二：登錄華為商場VMALL平臺查詢。

使用Chrome瀏覽器進(jìn)入華為商城VMALL官網(wǎng)，并登錄。

按F12打開調(diào)試控制臺。

在“Application”中，選擇“Cookies”，找到uid屬性，即可查詢到userId信息。

華為商城VMALL官網(wǎng)：https://www.vmall.com/index_new.htmlQ3： 如何通過設(shè)備日志獲取設(shè)備deviceId使用智慧生活A(yù)pp添加設(shè)備，設(shè)備添加成功后，在產(chǎn)生的設(shè)備側(cè)日志中搜索“Start to login， devId =”獲取。

二、設(shè)備連接

第二部分是設(shè)備連接方面的問題，涵蓋“待配網(wǎng)”、“配網(wǎng)過程”、“配網(wǎng)失敗”三種情況，快看看有沒有解答你的疑問~

Q4： 模組待配網(wǎng)的超時時間是多久？如何配置？超時時間默認(rèn)為10分鐘。修改方法如下：

極速常規(guī)/秒控配網(wǎng)：在超時時間函數(shù)“HILINK_SetNetConfigTimeout（unsigned long netConfigTimeout）”中配置。

藍(lán)牙輔助配網(wǎng)：在BLE配網(wǎng)廣播控制函數(shù)“BLE_CfgNetAdvCtrl（unsigned int advSecond）”中配置，其中的藍(lán)牙廣播時間必須與極速常規(guī)/秒控配網(wǎng)中的超時時間保持一致。

Q5： 設(shè)備處于待配網(wǎng)模式時，手機(jī)未碰觸設(shè)備也會出現(xiàn)連接彈窗

問題描述

設(shè)備處于待配網(wǎng)模式時，手機(jī)未碰觸設(shè)備也會出現(xiàn)連接彈窗?？赡茉蛟撃＝M支持Wi-Fi靠近發(fā)現(xiàn)功能（此時代碼中HILINK_GetDevSurfacePower接口的返回值為“0”）。當(dāng)手機(jī)靠近待配網(wǎng)的設(shè)備時，會發(fā)現(xiàn)設(shè)備并出現(xiàn)連接彈窗。解決措施

打開“hilink_device.c”文件，將HILINK_GetDevSurfacePower接口的返回值配置為“-1”，關(guān)閉Wi-Fi靠近發(fā)現(xiàn)功能。

Q6： 設(shè)備配網(wǎng)過程中，KitFramework認(rèn)證時軟證書解析失敗問題現(xiàn)象設(shè)備KitFramework認(rèn)證時軟證書解析失敗，日志顯示“ERROR ： Get padding failed，ret = -0x6200” 。可能原因

原因一：ProdID或者AcKey配置異常。

原因二：使用了其他產(chǎn)品的設(shè)備軟證書。

解決措施

檢查“hal_token.c”中的productId及AcKey信息，確保和Device Partner平臺管理中心上的產(chǎn)品信息保持一致。

重新申請設(shè)備軟證書并寫入設(shè)備。

申請設(shè)備軟證書：

https://device.harmonyos.com/cn/docs/devicepartner/DevicePartner-Guides/device-authorization-0000001134626077Q7： 設(shè)備配網(wǎng)過程中，KitFramework認(rèn)證時產(chǎn)品信息查詢失敗問題現(xiàn)象設(shè)備KitFramework認(rèn)證時產(chǎn)品信息查詢失敗，日志顯示“ERROR ［KitFramework］： Do symbol authentication failed， ret = -30004” 。可能原因

原因一：設(shè)備的基礎(chǔ)信息與Device Partner平臺配置的產(chǎn)品信息不一致。

原因二：未添加調(diào)測設(shè)備SN。

解決措施

檢查“hal_sys_param.c“文件中企業(yè)英文名、產(chǎn)品型號、品牌英文名信息是否配置正確，確保和Device Partner平臺管理中心上的產(chǎn)品信息保持一致。

進(jìn)入Device Partner平臺的管理中心，選擇“產(chǎn)品開發(fā) 》 集成開發(fā) 》 管理調(diào)測設(shè)備”，添加調(diào)測設(shè)備的SN號。

Q8： 設(shè)備配網(wǎng)過程中，設(shè)備側(cè)日志已顯示“get wifi ssid pwd done”，但熱點(diǎn)無法連接問題現(xiàn)象設(shè)備配網(wǎng)的過程中，設(shè)備側(cè)日志已顯示“get wifi ssid pwd done”，但之后串口工具循環(huán)打印設(shè)備側(cè)日志“+NOTICE:SCANFINISH/+NOTICE:DISCONNECTED”，熱點(diǎn)無法連接，最終設(shè)備配網(wǎng)失敗?？赡茉?/p>

原因一：在智慧生活A(yù)pp掃描配網(wǎng)輸入熱點(diǎn)信息界面時，輸入了錯誤的SSID或密碼。

原因二：勾選了記住密碼，但熱點(diǎn)密碼已發(fā)生了改變，再次配網(wǎng)時傳入了舊密碼導(dǎo)致。

解決措施

將設(shè)備重置，并重新進(jìn)入待配網(wǎng)狀態(tài)。

重新給設(shè)備配網(wǎng)，在熱點(diǎn)信息界面輸入正確的SSID和密碼。

Q9： 設(shè)備配網(wǎng)失敗且設(shè)備側(cè)日志顯示“Parse symbol authentication response message failed”問題現(xiàn)象設(shè)備配網(wǎng)的過程中，串口工具打印的設(shè)備側(cè)日志顯示“Parse symbol authentication response message failed”，配網(wǎng)流程結(jié)束后，智慧生活A(yù)pp顯示設(shè)備配網(wǎng)失敗。可能原因

原因一：hal_sys_param.c文件中的產(chǎn)品信息未配置正確。

原因二：設(shè)備軟證書（激活碼）與產(chǎn)品信息不匹配。

原因三：Device Partner平臺管理中心上添加的調(diào)測設(shè)備SN與HalGetSearial接口返回的value值不一致。

解決措施

檢查hal_sys_param.c文件中企業(yè)英文名、產(chǎn)品型號、品牌英文名信息是否配置正確，確保和Device Partner平臺管理中心上的產(chǎn)品信息保持一致。

在Device Partner平臺管理中心上重新申請設(shè)備軟證書（激活碼），并寫入設(shè)備。

檢查hal_sys_param.c文件中HalGetSearial接口的實(shí)現(xiàn)，可通過打印value方式查看其返回值是否和Device Partner平臺管理中心上配置的調(diào)測設(shè)備SN是否一致（大小寫也需要保持一致）。

Q10： 智慧生活A(yù)pp Debug版本掃描設(shè)備顯示為“未知設(shè)備”問題現(xiàn)象智慧生活A(yù)pp Debug版本環(huán)境設(shè)置為“認(rèn)證沙箱”時能夠正常掃描設(shè)備，但切換至“商用環(huán)境”后掃描設(shè)備顯示為“未知設(shè)備”?？赡茉虻卿浿腔凵預(yù)pp的華為帳號未申請測試權(quán)限。解決措施

進(jìn)入手機(jī)“設(shè)置 》 應(yīng)用和服務(wù) 》 應(yīng)用管理”，在應(yīng)用列表中選擇智慧生活，進(jìn)入智慧生活應(yīng)用信息頁面后，選擇“存儲”并點(diǎn)擊“刪除數(shù)據(jù)”。

登錄Device Partner平臺，進(jìn)入“管理中心”，在“帳號管理 》 基本資料 》 申請測試權(quán)限”頁面，點(diǎn)擊“立即申請測試權(quán)限”。

使用步驟2中的同一帳號登錄智慧生活A(yù)pp。

使用智慧生活A(yù)pp重新掃描設(shè)備。

Q11： 智慧生活A(yù)pp添加設(shè)備成功后，設(shè)備頻繁離線問題現(xiàn)象在智慧生活A(yù)pp中添加設(shè)備成功后，設(shè)備和路由器電源正常，但設(shè)備頻繁離線。可能原因可能是固件配置文件“hilink_device_sdk.c”與Device Partner平臺的Profile文件中定義的功能不一致。

不同開發(fā)方案中的固件配置文件名稱可能存在差異，此處以“HarmonyOS Connect直連方案（Wi-Fi/Combo）”中的固件配置文件“hilink_device_sdk.c”為例。解決措施檢查固件配置文件“hilink_device_sdk.c”與平臺Profile中定義的功能是否完全一致。

登錄華為智能硬件合作伙伴平臺，進(jìn)入“管理中心”。

在左側(cè)菜單欄選擇“產(chǎn)品開發(fā)”，在右側(cè)的產(chǎn)品開發(fā)頁面中選擇對應(yīng)的產(chǎn)品。

單擊對應(yīng)的產(chǎn)品進(jìn)入“產(chǎn)品定義 》 物模型定義”頁面。

在界面右上角“下載Profile（Excel）”或者“下載Profile（Json）”。

檢查固件配置文件“hilink_device_sdk.c”與Profile中定義的功能是否完全一致。如果不一致，需要修改配置文件“hilink_device_sdk.c”。

華為智能硬件合作伙伴平臺：

https://devicepartner.huawei.com/cn/Q12： 智慧生活A(yù)pp添加設(shè)備失敗，配網(wǎng)進(jìn)度顯示99%，設(shè)備日志顯示“hilink register timeout”問題現(xiàn)象智慧生活A(yù)pp添加設(shè)備失敗，配網(wǎng)進(jìn)度顯示99%，設(shè)備日志報錯如下：

hilink register timeout

可能原因

原因一：“hal_sys_param.c”文件中的產(chǎn)品信息未配置正確，導(dǎo)致KitFramework認(rèn)證失敗。

原因二：“hilink_device.h”文件中的產(chǎn)品信息未配置正確，導(dǎo)致HiLinkSDK注冊超時。

解決措施

檢查“hal_sys_param.c”文件中企業(yè)英文名、產(chǎn)品型號、品牌英文名信息是否配置正確，確保和Device Partner平臺管理中心上的產(chǎn)品信息保持一致。

檢查“hilink_device.h”的產(chǎn)品ID、設(shè)備類型 、企業(yè)ID是否配置正確，確保和Device Partner平臺管理中心上的產(chǎn)品信息保持一致。

在Device Partner平臺的管理中心上重新申請設(shè)備軟證書，并寫入設(shè)備。

Q13： 智慧生活A(yù)pp添加設(shè)備失敗，設(shè)備側(cè)日志顯示“Hardware result is ［14002］”問題現(xiàn)象使用智慧生活A(yù)pp添加設(shè)備失敗，關(guān)鍵設(shè)備側(cè)日志參考如下：

可能原因

原因一：軟證書被使用過，已經(jīng)失效。

原因二：軟證書和設(shè)備固件中配置的產(chǎn)品信息不匹配。

解決措施

從已獲取的軟證書中重新選擇一個軟證書，確認(rèn)其未被使用后，重新寫入設(shè)備，再進(jìn)行設(shè)備配網(wǎng)。

在平臺提交產(chǎn)品信息并重新申請設(shè)備軟證書。

登錄Device Partner平臺，進(jìn)入“管理中心”。

在“產(chǎn)品開發(fā) 》 產(chǎn)品定義 》 軟硬件定義”頁面，單擊“編輯”后，再單擊“提交”重新觸發(fā)產(chǎn)品信息同步。

重新申請設(shè)備軟證書并寫入設(shè)備。

三、其他問題

最后是“燒寫激活碼”、“報文上報頻率”內(nèi)容的解答。

Q14： 如何在固件中燒寫激活碼激活碼是設(shè)備合法性認(rèn)證的唯一標(biāo)識，系統(tǒng)會通過激活碼配置文件“hal_token.c”中的OEMReadToken函數(shù)來讀取激活碼。燒寫激活碼有以下兩種方式：

通過AT指令寫入：開發(fā)AT指令，調(diào)用激活碼寫入函數(shù)。以Hi3861模組為例，燒寫激活碼的AT指令如下：

AT+TOKEN=激活碼

通過bin燒錄：在bin文件中替換激活碼，并按照指定的地址和長度燒錄。燒錄的地址和長度可以參考激活碼配置文件“hal_token.c”中的定義。

Q15： HiLink SDK報文上報的頻率限制是多少

最短50ms上報一次報文，即不超過20次/秒。