HarmonyOS Connect FAQ第三期
原文:https://mp.weixin.qq.com/s/YpI9-k4yQvNhaMfg7Li82g,点击链接查看更多技术内容。
在开发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平台:
Q2: 如何获取“userId”
在云端查询设备挂机日志,需提供有效“userId”。查询方式如下所示:
方式一:登录Device Partner平台查询。
- 使用Chrome浏览器登录Device Partner平台,单击右上角的“管理中心”。
- 按F12打开调试控制台。
- Application中的Storage中查看,或者在Network中通过请求查看。
- 在“Application”中,选择“Storage > Local Storage”,找到userInfo属性,即可查询到userId信息。
![](https://img2022.cnblogs.com/blog/2639134/202206/2639134-20220607154617316-2123759126.png)
- 在“Network”中,选择“All”,在搜索框中输入“getUserInfo”,并按F5刷新页面。通过“getUserInfo”请求的返回值中即可查询到userId信息。
![](https://img2022.cnblogs.com/blog/2639134/202206/2639134-20220607154639244-1022446318.png)
方式二:登录华为商场VMALL平台查询。
- 使用Chrome浏览器进入华为商城VMALL官网,并登录。
- 按F12打开调试控制台。
- 在“Application”中,选择“Cookies”,找到uid属性,即可查询到userId信息。
![](https://img2022.cnblogs.com/blog/2639134/202206/2639134-20220607154655951-2092084912.png)
华为商城VMALL官网:https://www.vmall.com/index_new.html
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平台管理中心上的产品信息保持一致。
- 重新申请设备软证书并写入设备。
申请设备软证书:
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文件中定义的功能不一致。
![](https://img2022.cnblogs.com/blog/2639134/202206/2639134-20220607154853482-142358767.png)
不同开发方案中的固件配置文件名称可能存在差异,此处以“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”。
华为智能硬件合作伙伴平台:
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次/秒。