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

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

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

趕緊往下看吧~

一、信息獲取

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

Q1： 如何獲取HiLink SDK包

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

Device Partner平臺(tái)：

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

Q2： 如何獲取“userId”

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

方式一：登錄Device Partner平臺(tái)查詢。

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

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

Application中的Storage中查看，或者在Network中通過請(qǐng)求查看。

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

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

方式二：登錄華為商場(chǎng)VMALL平臺(tái)查詢。

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

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

在“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)的超時(shí)時(shí)間是多久？如何配置？超時(shí)時(shí)間默認(rèn)為10分鐘。修改方法如下：

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

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

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

問題描述

設(shè)備處于待配網(wǎng)模式時(shí)，手機(jī)未碰觸設(shè)備也會(huì)出現(xiàn)連接彈窗。可能原因該模組支持Wi-Fi靠近發(fā)現(xiàn)功能（此時(shí)代碼中HILINK_GetDevSurfacePower接口的返回值為“0”）。當(dāng)手機(jī)靠近待配網(wǎng)的設(shè)備時(shí)，會(huì)發(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)證時(shí)軟證書解析失敗問題現(xiàn)象設(shè)備KitFramework認(rèn)證時(shí)軟證書解析失敗，日志顯示“ERROR ： Get padding failed，ret = -0x6200” 。可能原因

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

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

解決措施

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

重新申請(qǐng)?jiān)O(shè)備軟證書并寫入設(shè)備。

申請(qǐng)?jiān)O(shè)備軟證書：

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

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

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

解決措施

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

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

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)失敗。可能原因

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

原因二：勾選了記住密碼，但熱點(diǎn)密碼已發(fā)生了改變，再次配網(wǎng)時(shí)傳入了舊密碼導(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平臺(tái)管理中心上添加的調(diào)測(cè)設(shè)備SN與HalGetSearial接口返回的value值不一致。

解決措施

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

在Device Partner平臺(tái)管理中心上重新申請(qǐng)?jiān)O(shè)備軟證書（激活碼），并寫入設(shè)備。

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

Q10： 智慧生活A(yù)pp Debug版本掃描設(shè)備顯示為“未知設(shè)備”問題現(xiàn)象智慧生活A(yù)pp Debug版本環(huán)境設(shè)置為“認(rèn)證沙箱”時(shí)能夠正常掃描設(shè)備，但切換至“商用環(huán)境”后掃描設(shè)備顯示為“未知設(shè)備”。可能原因登錄智慧生活A(yù)pp的華為帳號(hào)未申請(qǐng)測(cè)試權(quán)限。解決措施

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

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

使用步驟2中的同一帳號(hào)登錄智慧生活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平臺(tái)的Profile文件中定義的功能不一致。

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

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

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

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

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

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

華為智能硬件合作伙伴平臺(tái)：

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è)備日志報(bào)錯(cuò)如下：

hilink register timeout

可能原因

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

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

解決措施

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

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

在Device Partner平臺(tái)的管理中心上重新申請(qǐng)?jiān)O(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)品信息不匹配。

解決措施

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

在平臺(tái)提交產(chǎn)品信息并重新申請(qǐng)?jiān)O(shè)備軟證書。

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

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

重新申請(qǐng)?jiān)O(shè)備軟證書并寫入設(shè)備。

三、其他問題

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

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

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

AT+TOKEN=激活碼

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

Q15： HiLink SDK報(bào)文上報(bào)的頻率限制是多少

最短50ms上報(bào)一次報(bào)文，即不超過20次/秒。