共计 5138 个字符,预计需要花费 13 分钟才能阅读完成。
在开发 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 平台查问。- 应用 Chrome 浏览器进入华为商城 VMALL 官网,并登录。
- 按 F12 关上调试控制台。
- 在“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 次 / 秒。