关于harmonyos:HarmonyOS-Connect-FAQ第三期

在开发 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….
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 平台查问。
1. 应用 Chrome 浏览器进入华为商城 VMALL 官网，并登录。
2. 按 F12 关上调试控制台。
3. 在“Application”中，抉择“Cookies”，找到 uid 属性，即可查问到 userId 信息。
华为商城 VMALL 官网：https://www.vmall.com/index_n…
Q3: 如何通过设施日志获取设施 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/…
Q7: 设施配网过程中，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….
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 增加设施失败，关键设备侧日志参考如下：

ERROR [KitFramework]: Read ticket failed
ERROR [KitFramework]: Read tikcet failed
…… 
INFO [KitFramework]: Hardware result is [14002] 
INFO [KitFramework]: Symbol authentication succeed 
WARN [KitFramework]: Write ticket failed 
…… 
INFO [KitFramework]: Start active symbol 
ERROR [KitFramework]: Invalid parameter 
ERROR [KitFramework]: Active symbol failed, ret = -1

可能起因

起因一：软证书被应用过，曾经生效。
起因二：软证书和设施固件中配置的产品信息不匹配。
解决措施
从已获取的软证书中从新抉择一个软证书，确认其未被应用后，从新写入设施，再进行设施配网。
在平台提交产品信息并从新申请设施软证书。
登录 Device Partner 平台，进入“管理中心”。
在“产品开发 > 产品定义 > 软硬件定义”页面，单击“编辑”后，再单击“提交”从新触发产品信息同步。
从新申请设施软证书并写入设施。

最初是“烧写激活码”、“报文上报频率”内容的解答。
Q14: 如何在固件中烧写激活码
激活码是设施合法性认证的惟一标识，零碎会通过激活码配置文件“hal_token.c”中的 OEMReadToken 函数来读取激活码。烧写激活码有以下两种形式：

通过 AT 指令写入：开发 AT 指令，调用激活码写入函数。以 Hi3861 模组为例，烧写激活码的 AT 指令如下：
AT+TOKEN= 激活码
通过 bin 烧录：在 bin 文件中替换激活码，并依照指定的地址和长度烧录。烧录的地址和长度能够参考激活码配置文件“hal_token.c”中的定义。

// token flag offset address  
#define TOKEN_REGION_BEGIN 0x1F9000 
#define TOKEN_REGION_END 0x1FB000

Q15: HiLink SDK 报文上报的频率限度是多少
最短 50ms 上报一次报文，即不超过 20 次 / 秒。

一、信息获取

二、设施连贯

三、其余问题

站内搜索