11 月 22 日訊息，在開發 HarmonyOS Connect 生態產品時，你是否也有裝置功能調測方面的疑問？現在華為鴻蒙開發者官方為大家帶來了裝置功能調測相關的常見問題答疑，讓你快速獲得解決方案。

一、裝置連線

Q1: 手機碰一碰 NFC 標籤，彈框提示“系統錯誤”，如何處理？

問題現象

手機碰一碰待連線裝置，彈框提示“系統錯誤”，更換 Wi-Fi 後報錯仍無法清除。

可能原因

• 手機時間與網路時間不一致。

• 裝置發起請求時，會將手機時間與裝置啟用碼等資訊傳到雲端。雲端會對手機時間與網路時間的一致性進行校驗，以確保請求的合法性。如果兩者的時間差大於一小時，則請求無效。

A:解決措施

將手機的時間設定為“自動設定”，使手機與當前網路上的時間同步。以華為手機為例：

1.進入手機“設定”。

2.選擇“系統和更新> 日期和時間”。

3.開啟“自動設定”開關。

Q2: 手機碰一碰 NFC 標籤，提示“未獲取到應用資訊”。

問題現象

手機碰一碰 NFC 標籤，提示“未獲取到應用資訊”。

可能原因

• 原因一：服務意圖配置的 HarmonyOS 標籤的產品型號不是當前的 ProductID。

• 原因二：NFC 標籤寫入的碼流中的 ProductID 有誤。

A:解決措施

1.確認服務意圖配置的 HarmonyOS 標籤的產品型號是否為當前的 ProductID。

• 登入華為快服務智慧平臺。

• 在服務列表中找到對應的原子化服務，單擊“編輯”。

• 選擇“配置> HarmonyOS 標籤”，確認裝置標籤中的“產品型號”是否正確。如果不正確，需要重新配置。

2.確認 NFC 標籤碼流的 ProductID 欄位是否正確。如果不正確，需要重新寫入。

Q3: 碰一碰 NFC 標籤無法拉起 FA，NFC 服務提示“發現 NFC 標籤，點選啟動應用”。

問題現象

手機碰一碰待連線裝置，NFC 服務彈出提示“發現 NFC 標籤，點選啟動應用”，無法正常拉起原子化服務。

圖 1原子化服務無法正常拉起

可能原因

NFC 標籤碼流錄入錯誤，導致手機系統無法正確解析 NFC 碼流。

A:解決措施

1.在 Device Partner 平臺上申請 NFC 標籤碼流，並根據實際裝置資訊生成可用的標籤碼流。

2.將碼流重新寫入 NFC 標籤，並重試碰一碰拉起原子化服務。

Q4: 裝置處於開機狀態且手機網路正常，但智慧生活 App 上裝置卡片顯示離線狀態。

問題現象

裝置處於開機狀態且手機網路正常，但智慧生活 App 上裝置卡片顯示離線狀態，且串列埠工具不停重複列印裝置側日誌“+NOTICE:SCANFINISH/+NOTICE:DISCONNECTED”。

可能原因

裝置已連線的熱點的 SSID 或密碼發生變更。

A:解決措施

• 方式一：將熱點 SSID 和密碼改回，模組即可重新連線熱點，恢復正常。

• 方式二：將模組重置，重新給模組配網。

Q5: 模組在 STA 模式下連線路由器熱點，路由器斷電重啟或模組離開熱點範圍再返回後無法重連熱點。

問題現象

1.模組短距測試中，執行如下命令設定模組開啟 STA 模式。

AT+STARTSTA

2.執行如下命令，掃描模組周圍熱點。

AT+SCAN

3.執行如下命令，檢視掃描結果。

AT+SCANRESULT

4.參考執行如下命令，連線熱點。命令中的四個值分別代表 SSID、MAC、熱點型別以及密碼，請根據實際情況修改。

AT+CONN="hisilicon",1a:01:f1:c9:7c:92,3,"123456789"

5.執行如下命令，開啟 DHCP。

AT+DHCP=wlan0,1

6.路由器斷電重啟或者模組離開熱點範圍再返回，此時發現模組無法重新連線該熱點。

可能原因

模組未配置重連策略。

A:解決措施

參考如下命令執行重連策略，命令中的引數需要根據實際情況修改，具體取值參見晶片手冊。

AT+RECONN=1,10,3600,5

二、裝置配網

Q6: 手機首次碰一碰 NFC 標籤，拉起的是非配網 FA 頁面。

問題現象

手機首次碰一碰 NFC 標籤，拉起的是非配網 FA 頁面（比如控制 FA 頁面）。

可能原因

• 原因一：服務意圖配置的 Ability 名稱不是配網 FA 頁面的 Ability 名稱。

• 原因二：原子化服務包中其他模組的 Ability 與配網 FA 的 Ability 重名，導致拉起的 FA 頁面有誤。

A: 解決措施

1. 確認服務意圖配置的“服務名”是否為配網 FA 的 Ability 名稱。

• 登入華為快服務智慧平臺。

• 在服務列表中找到對應的原子化服務，單擊“編輯”。

• 選擇“配置> FA 資訊”，確認配置方式中的“服務名”是否為配網 FA 的 Ability 名稱。如果不正確，需要重新配置。

2. 確認其他模組 Ability 名稱是否與配網 FA 的 Ability 重名。

在 DevEco Studio 專案下，逐個排查其他模組中的“src/main/config.json”檔案。

在 json 檔案中，找到“module/mainAbility”配置項，檢查是否與配網 FA 的 Ability 同名。

找到並選中重名的 Ability，單擊右鍵，選擇“Refactor> Rename”，重新命名檔案。

Q7: 碰一碰拉起配網 FA，在 SoftAP 配網進度達 30% 時失敗，顯示“當前網路不可用”。

問題現象

碰一碰拉起配網 FA，在進行 SoftAP 配網時配網進度在 30% 失敗，提示“當前網路不可用”。

可能原因

• 原因一：模組側因長時間不啟用進入待機狀態，關閉了配網所需的裝置 AP。

• 原因二：NFC 標籤碼流中 0406 欄位後 6 位元組寫入的資料與裝置開啟的 AP MAC 地址不一致。

A:解決措施

1.確保裝置 AP 無線網路名稱正確。

• 登入華為智慧硬體合作伙伴平臺，單擊右上角的“管理中心”。

• 單擊對應的產品，進入“整合開發”頁面。在配網設定中檢視並記錄“無線網路名稱”(SSID) 的取值。

• 在手機中開啟“設定”，選擇“WLAN > 可用 WLAN”，確保該列表中存在與記錄的 SSID 相同的裝置 AP。

• 若無相同 SSID 的裝置 AP，請嘗試重啟裝置。

• 若產品 ID 一致但 SSID 名稱不一致，請重新燒錄模組使 SSID 與記錄的一致。

2.修改標籤碼流 MAC 欄位並重新燒錄 NFC。

Q8: 碰一碰拉起配網 FA，無法進行 NAN 配網。

問題現象

碰一碰拉起配網 FA，無法進行 NAN 配網，FA 日誌中列印碰一碰 Intent 引數 nanSessionId 欄位的值為“NAN_DEVICE_NOT_FOUND”。

可能原因

• 用於配網的模組不支援 NAN 配網。

• 手機與模組之間距離大於 30cm。

• 上一次碰一碰拉起配網 FA 進行 NAN 配網未完成，模組的 NAN 通道將鎖定一段時間。

A:解決措施

1.諮詢產品對應模組廠商，確認模組是否支援 NAN 配網。

2.將手機靠近至模組 30cm 半徑以內後重新碰一碰配網。

3.等待模組日誌列印以下資訊時，即可進行 NAN 配網 (x 代表任意數字)。

Send:msgType[x]msgId[x]msgLen[x]

若模組日誌列印顯示以下資訊，則表示當前模組只能進行 SoftAP 配網，請重啟模組或重新燒錄模組。

waitSTAjoinAP

Q9: 裝置配網過程中，配網 FA 獲取不到 Wi-Fi 列表。

問題現象

裝置配網過程中，配網 FA 獲取不到 Wi-Fi 列表。

可能原因

• 原因一：配網模組中沒有註冊“NetConfigAbility”。

• 原因二：不止一個配網模組註冊了“NetConfigAbility”。

A:解決措施

1.確認配網模組是否有註冊“NetConfigAbility”。

• 在配網模組下，找到該模組下的“MainAbility”，雙擊開啟。

• 檢查該檔案的 onStart 方法中是否含有 NetConfigAbility.register () 的程式碼。

2.確認是否存在多個註冊了“NetConfigAbility”的配網模組。

• 逐個排查各個配網模組“MainAbility”的 onStart 方法是否都註冊了“NetConfigAbility”。

• 只在一個配網模組中保留“NetConfigAbility”的註冊，刪除其他配網模組“NetConfigAbility”的註冊程式碼。

Q10: 裝置配網過程中，使用 SoftAP 的方式未掃描到裝置。

問題現象

裝置配網過程中，使用 SoftAP 的方式未掃描到裝置。

圖 2未掃描到裝置

可能原因

• 原因一：Wi-Fi 裝置未開啟。

• 原因二：Wi-Fi 裝置已開啟，getWifiList 介面讀取的是 Wi-Fi 快取資訊。

• 原因三：NFC 標籤碼流的 MAC 地址與 Wi-Fi 裝置的 MAC 地址不一致。

A:解決措施

1.確認 Wi-Fi 裝置已開啟。

2.間隔一段時間（約 2min）後，重新掃描裝置。如果多次掃描仍提示配網失敗，重試重置裝置。

3.確認 NFC 標籤碼流的 MAC 地址是否與 Wi-Fi 裝置的 MAC 地址一致。如果不一致，則需要重新燒錄正確的 NFC 碼流資訊。

Q11: 裝置配網失敗且裝置側日誌顯示“Parse symbol authentication response message failed”。

問題現象

裝置配網的過程中，串列埠工具列印的裝置側日誌顯示“Parse symbol authentication response message failed”，配網流程結束後，智慧生活 App 顯示裝置配網失敗。

可能原因

• 原因一：hal_sys_param.c 檔案中的產品資訊未配置正確。

• 原因二：裝置啟用碼與產品資訊不匹配。

• 原因三：Device Partner 平臺管理中心上新增的調測裝置 SN 與 HalGetSearial 介面返回的 value 值不一致。

A:解決措施

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

2.在 Device Partner 平臺管理中心上重新申請裝置啟用碼，並寫入裝置。

3.檢查 hal_sys_param.c 檔案中 HalGetSearial 介面的實現，可通過列印 value 方式檢視其返回值是否和 Device Partner 平臺管理中心上配置的調測裝置 SN 是否一致（注意大小寫也需要保持一致）。

三、其他問題

Q12: 如何獲取 HinkSvc 日誌？

A:1.開啟手機的“檔案管理”應用，進入“瀏覽”頁面。

2.在“位置”列表中，選擇“我的手機”。

3.進入“Android> data > com.huawei.hilink.framework > files > Log > com.huawei.hilink.framework”資料夾。此資料夾中的檔案即為 HinkSvc 日誌。

Q13: 如何抓取 HarmonyOS 手機藍芽 HCI 日誌？

A:1.確認手機已進入開發者模式並開啟“USB 除錯”功能。

• 在手機中開啟“設定”。

• 選擇“關於手機”，查詢版本號。

• 快速點選“版本號”多次，直到提示開發者模式已開啟，返回上一層。

• 選擇“系統和更新> 開發人員選項”，並開啟“USB 除錯”。

2.在電腦中執行 cmd 命令。

3.在命令列中輸入如下命令，匯出的檔案即為手機藍芽 HCI 日誌。

hdcfilerecv/data/log/bt./

Q14: 在帳號登入 FA 介面單擊“華為帳號快捷登入”，沒有響應。

問題現象

在帳號登入 FA 介面單擊“華為帳號快捷登入”，沒有響應。

可能原因

原因一：沒有在 AppGalley Connect 網站新增應用指紋證書。

原因二：“config.json”檔案中“metaData”下“customizeData”沒有配置 appid 或者 appid 配置錯誤。

A:解決措施

1.在 AppGalley Connect 網站新增應用指紋證書。

2.在“config.json”檔案中配置 appid 即為 Client ID。

"metaData":{"customizeData":[{"name":"com.huawei.hms.client.appid","value":"*********"}]},

更多 HarmonyOS Connect 文件檢視：點此連結。