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