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平台：

https://devicepartner.huawei.com/cn/

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_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平台管理中心上的产品信息保持一致。

重新申请设备软证书并写入设备。

申请设备软证书：

https://device.harmonyos.com/cn/docs/devicepartner/DevicePartner-Guides/device-authorization-0000001134626077

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.com/cn/

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次/秒。