在開發HarmonyOS Connect生態產品時，你是否對設備開發存在這些疑問：

如何獲取HiLink SDK包、userId、設備deviceId等信息？如何配置模組待配網的超時時間？如何處理設備配網中KitFramework認證失敗？……？

本期FAQ通過三個章節——信息獲取、設備連接、其他問題，為大家帶來15個設備開發常見問題答疑，讓你快速get到解決方案。

趕緊往下看吧~

一、信息獲取

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

Q1： 如何獲取HiLink SDK包

1.登錄Device Partner平臺，進入“管理中心”。2.在導航欄選擇“產品開發”，選擇對應產品。3.在“集成開發 》 SDK下載&集成開發 》 集成開發”中，即可下載對應的HiLink SDK包。

Device Partner平臺：

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

Q2： 如何獲取“userId”

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

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

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

按F12打開調試控制臺。

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

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

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

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

使用Chrome瀏覽器進入華為商城VMALL官網，并登錄。

按F12打開調試控制臺。

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

華為商城VMALL官網：https://www.vmall.com/index_new.htmlQ3： 如何通過設備日志獲取設備deviceId使用智慧生活App添加設備，設備添加成功后，在產生的設備側日志中搜索“Start to login， devId =”獲取。

二、設備連接

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

Q4： 模組待配網的超時時間是多久？如何配置？超時時間默認為10分鐘。修改方法如下：

極速常規/秒控配網：在超時時間函數“HILINK_SetNetConfigTimeout（unsigned long netConfigTimeout）”中配置。

藍牙輔助配網：在BLE配網廣播控制函數“BLE_CfgNetAdvCtrl（unsigned int advSecond）”中配置，其中的藍牙廣播時間必須與極速常規/秒控配網中的超時時間保持一致。

Q5： 設備處于待配網模式時，手機未碰觸設備也會出現連接彈窗

問題描述

設備處于待配網模式時，手機未碰觸設備也會出現連接彈窗。可能原因該模組支持Wi-Fi靠近發現功能（此時代碼中HILINK_GetDevSurfacePower接口的返回值為“0”）。當手機靠近待配網的設備時，會發現設備并出現連接彈窗。解決措施

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

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

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

原因二：使用了其他產品的設備軟證書。

解決措施

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

重新申請設備軟證書并寫入設備。

申請設備軟證書：

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

原因一：設備的基礎信息與Device Partner平臺配置的產品信息不一致。

原因二：未添加調測設備SN。

解決措施

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

進入Device Partner平臺的管理中心，選擇“產品開發 》 集成開發 》 管理調測設備”，添加調測設備的SN號。

Q8： 設備配網過程中，設備側日志已顯示“get wifi ssid pwd done”，但熱點無法連接問題現象設備配網的過程中，設備側日志已顯示“get wifi ssid pwd done”，但之后串口工具循環打印設備側日志“+NOTICE:SCANFINISH/+NOTICE:DISCONNECTED”，熱點無法連接，最終設備配網失敗。可能原因

原因一：在智慧生活App掃描配網輸入熱點信息界面時，輸入了錯誤的SSID或密碼。

原因二：勾選了記住密碼，但熱點密碼已發生了改變，再次配網時傳入了舊密碼導致。

解決措施

將設備重置，并重新進入待配網狀態。

重新給設備配網，在熱點信息界面輸入正確的SSID和密碼。

Q9： 設備配網失敗且設備側日志顯示“Parse symbol authentication response message failed”問題現象設備配網的過程中，串口工具打印的設備側日志顯示“Parse symbol authentication response message failed”，配網流程結束后，智慧生活App顯示設備配網失敗。可能原因

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

原因二：設備軟證書（激活碼）與產品信息不匹配。

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

解決措施

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

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

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

Q10： 智慧生活App Debug版本掃描設備顯示為“未知設備”問題現象智慧生活App Debug版本環境設置為“認證沙箱”時能夠正常掃描設備，但切換至“商用環境”后掃描設備顯示為“未知設備”。可能原因登錄智慧生活App的華為帳號未申請測試權限。解決措施

進入手機“設置 》 應用和服務 》 應用管理”，在應用列表中選擇智慧生活，進入智慧生活應用信息頁面后，選擇“存儲”并點擊“刪除數據”。

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

使用步驟2中的同一帳號登錄智慧生活App。

使用智慧生活App重新掃描設備。

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

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

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

在左側菜單欄選擇“產品開發”，在右側的產品開發頁面中選擇對應的產品。

單擊對應的產品進入“產品定義 》 物模型定義”頁面。

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

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

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

https://devicepartner.huawei.com/cn/Q12： 智慧生活App添加設備失敗，配網進度顯示99%，設備日志顯示“hilink register timeout”問題現象智慧生活App添加設備失敗，配網進度顯示99%，設備日志報錯如下：

hilink register timeout

可能原因

原因一：“hal_sys_param.c”文件中的產品信息未配置正確，導致KitFramework認證失敗。

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

解決措施

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

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

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

Q13： 智慧生活App添加設備失敗，設備側日志顯示“Hardware result is ［14002］”問題現象使用智慧生活App添加設備失敗，關鍵設備側日志參考如下：

可能原因

原因一：軟證書被使用過，已經失效。

原因二：軟證書和設備固件中配置的產品信息不匹配。

解決措施

從已獲取的軟證書中重新選擇一個軟證書，確認其未被使用后，重新寫入設備，再進行設備配網。

在平臺提交產品信息并重新申請設備軟證書。

登錄Device Partner平臺，進入“管理中心”。

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

重新申請設備軟證書并寫入設備。

三、其他問題

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

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

通過AT指令寫入：開發AT指令，調用激活碼寫入函數。以Hi3861模組為例，燒寫激活碼的AT指令如下：

AT+TOKEN=激活碼

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

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

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