IT之家 11 月 22 日消息，在開發(fā) HarmonyOS Connect 生態(tài)產(chǎn)品時，你是否也有設(shè)備功能調(diào)測方面的疑問？現(xiàn)在華為鴻蒙開發(fā)者官方為大家?guī)砹嗽O(shè)備功能調(diào)測相關(guān)的常見問題答疑，讓你快速獲得解決方案。
一、設(shè)備連接
Q1: 手機碰一碰 NFC 標簽，彈框提示“系統(tǒng)錯誤”，如何處理？
問題現(xiàn)象
手機碰一碰待連接設(shè)備，彈框提示“系統(tǒng)錯誤”，更換 Wi-Fi 后報錯仍無法清除。
可能原因
手機時間與網(wǎng)絡(luò)時間不一致。
設(shè)備發(fā)起請求時，會將手機時間與設(shè)備激活碼等信息傳到云端。云端會對手機時間與網(wǎng)絡(luò)時間的一致性進行校驗，以確保請求的合法性。如果兩者的時間差大于一小時，則請求無效。
A: 解決措施
將手機的時間設(shè)置為“自動設(shè)置”，使手機與當前網(wǎng)絡(luò)上的時間同步。以華為手機為例：
1.進入手機“設(shè)置”。
2.選擇“系統(tǒng)和更新> 日期和時間”。
3.開啟“自動設(shè)置”開關(guān)。
Q2: 手機碰一碰 NFC 標簽，提示“未獲取到應(yīng)用信息”。
問題現(xiàn)象
手機碰一碰 NFC 標簽，提示“未獲取到應(yīng)用信息”。
可能原因
原因一：服務(wù)意圖配置的 HarmonyOS 標簽的產(chǎn)品型號不是當前的 ProductID。
原因二：NFC 標簽寫入的碼流中的 ProductID 有誤。
A: 解決措施
1.確認服務(wù)意圖配置的 HarmonyOS 標簽的產(chǎn)品型號是否為當前的 ProductID。
登錄華為快服務(wù)智慧平臺。
在服務(wù)列表中找到對應(yīng)的原子化服務(wù)，單擊“編輯”。
選擇“配置> HarmonyOS 標簽”，確認設(shè)備標簽中的“產(chǎn)品型號”是否正確。如果不正確，需要重新配置。
2.確認 NFC 標簽碼流的 ProductID 字段是否正確。如果不正確，需要重新寫入。
Q3: 碰一碰 NFC 標簽無法拉起 FA，NFC 服務(wù)提示“發(fā)現(xiàn) NFC 標簽，點擊啟動應(yīng)用”。
問題現(xiàn)象
手機碰一碰待連接設(shè)備，NFC 服務(wù)彈出提示“發(fā)現(xiàn) NFC 標簽，點擊啟動應(yīng)用”，無法正常拉起原子化服務(wù)。
圖 1 原子化服務(wù)無法正常拉起
可能原因
NFC 標簽碼流錄入錯誤，導致手機系統(tǒng)無法正確解析 NFC 碼流。
A: 解決措施
1.在 Device Partner 平臺上申請 NFC 標簽碼流，并根據(jù)實際設(shè)備信息生成可用的標簽碼流。
2.將碼流重新寫入 NFC 標簽，并重試碰一碰拉起原子化服務(wù)。
Q4: 設(shè)備處于開機狀態(tài)且手機網(wǎng)絡(luò)正常，但智慧生活 App 上設(shè)備卡片顯示離線狀態(tài)。
問題現(xiàn)象
設(shè)備處于開機狀態(tài)且手機網(wǎng)絡(luò)正常，但智慧生活 App 上設(shè)備卡片顯示離線狀態(tài)，且串口工具不停重復(fù)打印設(shè)備側(cè)日志“+NOTICE:SCANFINISH/+NOTICE:DISCONNECTED”。
可能原因
設(shè)備已連接的熱點的 SSID 或密碼發(fā)生變更。
A: 解決措施
方式一：將熱點 SSID 和密碼改回，模組即可重新連接熱點，恢復(fù)正常。
方式二：將模組重置，重新給模組配網(wǎng)。
Q5: 模組在 STA 模式下連接路由器熱點，路由器斷電重啟或模組離開熱點范圍再返回后無法重連熱點。
問題現(xiàn)象
1.模組短距測試中，執(zhí)行如下命令設(shè)置模組打開 STA 模式。
AT+STARTSTA
2.執(zhí)行如下命令，掃描模組周圍熱點。
AT+SCAN
3.執(zhí)行如下命令，查看掃描結(jié)果。
AT+SCANRESULT
4.參考執(zhí)行如下命令，連接熱點。命令中的四個值分別代表 SSID、MAC、熱點類型以及密碼，請根據(jù)實際情況修改。
AT+CONN="hisilicon",1a:01:f1:c9:7c:92,3,"123456789"
5.執(zhí)行如下命令，打開 DHCP。
AT+DHCP=wlan0,1
6.路由器斷電重啟或者模組離開熱點范圍再返回，此時發(fā)現(xiàn)模組無法重新連接該熱點。
可能原因
模組未配置重連策略。
A: 解決措施
參考如下命令執(zhí)行重連策略，命令中的參數(shù)需要根據(jù)實際情況修改，具體取值參見芯片手冊。
AT+RECONN=1,10,3600,5
二、設(shè)備配網(wǎng)
Q6: 手機首次碰一碰 NFC 標簽，拉起的是非配網(wǎng) FA 頁面。
問題現(xiàn)象
手機首次碰一碰 NFC 標簽，拉起的是非配網(wǎng) FA 頁面（比如控制 FA 頁面）。
可能原因
原因一：服務(wù)意圖配置的 Ability 名稱不是配網(wǎng) FA 頁面的 Ability 名稱。
原因二：原子化服務(wù)包中其他模塊的 Ability 與配網(wǎng) FA 的 Ability 重名，導致拉起的 FA 頁面有誤。
A: 解決措施
1. 確認服務(wù)意圖配置的“服務(wù)名”是否為配網(wǎng) FA 的 Ability 名稱。
登錄華為快服務(wù)智慧平臺。
在服務(wù)列表中找到對應(yīng)的原子化服務(wù)，單擊“編輯”。
選擇“配置> FA 信息”，確認配置方式中的“服務(wù)名”是否為配網(wǎng) FA 的 Ability 名稱。如果不正確，需要重新配置。
2. 確認其他模塊 Ability 名稱是否與配網(wǎng) FA 的 Ability 重名。
在 DevEco Studio 項目下，逐個排查其他模塊中的“src/main/config.json”文件。
在 json 文件中，找到“module/mainAbility”配置項，檢查是否與配網(wǎng) FA 的 Ability 同名。
找到并選中重名的 Ability，單擊右鍵，選擇“Refactor> Rename”，重命名文件。
Q7: 碰一碰拉起配網(wǎng) FA，在 SoftAP 配網(wǎng)進度達 30% 時失敗，顯示“當前網(wǎng)絡(luò)不可用”。
問題現(xiàn)象
碰一碰拉起配網(wǎng) FA，在進行 SoftAP 配網(wǎng)時配網(wǎng)進度在 30% 失敗，提示“當前網(wǎng)絡(luò)不可用”。
可能原因
原因一：模組側(cè)因長時間不啟用進入待機狀態(tài)，關(guān)閉了配網(wǎng)所需的設(shè)備 AP。
原因二：NFC 標簽碼流中 0406 字段后 6 字節(jié)寫入的數(shù)據(jù)與設(shè)備開啟的 AP MAC 地址不一致。
A: 解決措施
1.確保設(shè)備 AP 無線網(wǎng)絡(luò)名稱正確。
登錄華為智能硬件合作伙伴平臺，單擊右上角的“管理中心”。
單擊對應(yīng)的產(chǎn)品，進入“集成開發(fā)”頁面。在配網(wǎng)設(shè)置中查看并記錄“無線網(wǎng)絡(luò)名稱”(SSID) 的取值。
在手機中打開“設(shè)置”，選擇“WLAN > 可用 WLAN”，確保該列表中存在與記錄的 SSID 相同的設(shè)備 AP。
若無相同 SSID 的設(shè)備 AP，請嘗試重啟設(shè)備。
若產(chǎn)品 ID 一致但 SSID 名稱不一致，請重新燒錄模組使 SSID 與記錄的一致。
2.修改標簽碼流 MAC 字段并重新燒錄 NFC。
Q8: 碰一碰拉起配網(wǎng) FA，無法進行 NAN 配網(wǎng)。
問題現(xiàn)象
碰一碰拉起配網(wǎng) FA，無法進行 NAN 配網(wǎng)，F(xiàn)A 日志中打印碰一碰 Intent 參數(shù) nanSessionId 字段的值為“NAN_DEVICE_NOT_FOUND”。
可能原因
用于配網(wǎng)的模組不支持 NAN 配網(wǎng)。
手機與模組之間距離大于 30cm。
上一次碰一碰拉起配網(wǎng) FA 進行 NAN 配網(wǎng)未完成，模組的 NAN 通道將鎖定一段時間。
A: 解決措施
1.咨詢產(chǎn)品對應(yīng)模組廠商，確認模組是否支持 NAN 配網(wǎng)。
2.將手機靠近至模組 30cm 半徑以內(nèi)后重新碰一碰配網(wǎng)。
3.等待模組日志打印以下信息時，即可進行 NAN 配網(wǎng) (x 代表任意數(shù)字)。
Send: msgType[x] msgId[x] msgLen[x]
若模組日志打印顯示以下信息，則表示當前模組只能進行 SoftAP 配網(wǎng)，請重啟模組或重新燒錄模組。
wait STA join AP
Q9: 設(shè)備配網(wǎng)過程中，配網(wǎng) FA 獲取不到 Wi-Fi 列表。
問題現(xiàn)象
設(shè)備配網(wǎng)過程中，配網(wǎng) FA 獲取不到 Wi-Fi 列表。
可能原因
原因一：配網(wǎng)模塊中沒有注冊“NetConfigAbility”。
原因二：不止一個配網(wǎng)模塊注冊了“NetConfigAbility”。
A: 解決措施
1.確認配網(wǎng)模塊是否有注冊“NetConfigAbility”。
在配網(wǎng)模塊下，找到該模塊下的“MainAbility”，雙擊打開。
檢查該文件的 onStart 方法中是否含有 NetConfigAbility.register () 的代碼。
2.確認是否存在多個注冊了“NetConfigAbility”的配網(wǎng)模塊。
逐個排查各個配網(wǎng)模塊“MainAbility”的 onStart 方法是否都注冊了“NetConfigAbility”。
只在一個配網(wǎng)模塊中保留“NetConfigAbility”的注冊，刪除其他配網(wǎng)模塊“NetConfigAbility”的注冊代碼。
Q10: 設(shè)備配網(wǎng)過程中，使用 SoftAP 的方式未掃描到設(shè)備。
問題現(xiàn)象
設(shè)備配網(wǎng)過程中，使用 SoftAP 的方式未掃描到設(shè)備。
圖 2 未掃描到設(shè)備
可能原因
原因一：Wi-Fi 設(shè)備未開啟。
原因二：Wi-Fi 設(shè)備已開啟，getWifiList 接口讀取的是 Wi-Fi 緩存信息。
原因三：NFC 標簽碼流的 MAC 地址與 Wi-Fi 設(shè)備的 MAC 地址不一致。
A: 解決措施
1.確認 Wi-Fi 設(shè)備已開啟。
2.間隔一段時間（約 2min）后，重新掃描設(shè)備。如果多次掃描仍提示配網(wǎng)失敗，重試重置設(shè)備。
3.確認 NFC 標簽碼流的 MAC 地址是否與 Wi-Fi 設(shè)備的 MAC 地址一致。如果不一致，則需要重新燒錄正確的 NFC 碼流信息。
Q11: 設(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é)束后，智慧生活 App 顯示設(shè)備配網(wǎng)失敗。
可能原因
原因一：hal_sys_param.c 文件中的產(chǎn)品信息未配置正確。
原因二：設(shè)備激活碼與產(chǎn)品信息不匹配。
原因三：Device Partner 平臺管理中心上添加的調(diào)測設(shè)備 SN 與 HalGetSearial 接口返回的 value 值不一致。
A: 解決措施
1.檢查 hal_sys_param.c 文件中企業(yè)英文名、產(chǎn)品型號、品牌英文名信息是否配置正確，確保和 Device Partner 平臺管理中心上的產(chǎn)品信息保持一致。
2.在 Device Partner 平臺管理中心上重新申請設(shè)備激活碼，并寫入設(shè)備。
3.檢查 hal_sys_param.c 文件中 HalGetSearial 接口的實現(xiàn)，可通過打印 value 方式查看其返回值是否和 Device Partner 平臺管理中心上配置的調(diào)測設(shè)備 SN 是否一致（注意大小寫也需要保持一致）。
三、其他問題
Q12: 如何獲取 HinkSvc 日志？
A: 1.打開手機的“文件管理”應(yīng)用，進入“瀏覽”頁面。
2.在“位置”列表中，選擇“我的手機”。
3.進入“Android> data > com.huawei.hilink.framework > files > Log > com.huawei.hilink.framework”文件夾。此文件夾中的文件即為 HinkSvc 日志。
Q13: 如何抓取 HarmonyOS 手機藍牙 HCI 日志？
A: 1.確認手機已進入開發(fā)者模式并開啟“USB 調(diào)試”功能。
在手機中打開“設(shè)置”。
選擇“關(guān)于手機”，查找版本號。
快速點擊“版本號”多次，直到提示開發(fā)者模式已打開，返回上一層。
選擇“系統(tǒng)和更新> 開發(fā)人員選項”，并開啟“USB 調(diào)試”。
2.在電腦中運行 cmd 命令。
3.在命令行中輸入如下命令，導出的文件即為手機藍牙 HCI 日志。
hdc file recv /data/log/bt ./
Q14: 在帳號登錄 FA 界面單擊“華為帳號快捷登錄”，沒有響應(yīng)。
問題現(xiàn)象
在帳號登錄 FA 界面單擊“華為帳號快捷登錄”，沒有響應(yīng)。
可能原因
原因一：沒有在 AppGalley Connect 網(wǎng)站添加應(yīng)用指紋證書。
原因二：“config.json”文件中“metaData”下“customizeData”沒有配置 appid 或者 appid 配置錯誤。
A: 解決措施
1.在 AppGalley Connect 網(wǎng)站添加應(yīng)用指紋證書。
2.在“config.json”文件中配置 appid 即為 Client ID。
"metaData": {
"customizeData": [
{
"name": "com.huawei.hms.client.appid",
"value": "*********"
}
]
},更多 HarmonyOS Connect 文檔查看：點此鏈接。
廣告聲明：文內(nèi)含有的對外跳轉(zhuǎn)鏈接（包括不限于超鏈接、二維碼、口令等形式），用于傳遞更多信息，節(jié)省甄選時間，結(jié)果僅供參考，IT之家所有文章均包含本聲明。