OpenHarmony统一互联生态设备测距KPI自测试指导

简介

为了保障OpenHarmony统一互联生态设备（下文简称：OH生态设备）的用户体验，所有OH生态设备上线前需满足测距KPI要求。

本文将介绍如何进行测距KPI自测试。该方法仅作自测试参考，最终以华为测试人员验收通过为准。

注意：开始测距自测试前，待测设备应已在智慧生活基础服务沙箱环境中配置，如未配置先联系对接的华为技术人员完成配置。

测试环境准备

1. 准备HarmonyOS Next华为手机（如Mate80等操作系统为HarmonyOS 6.0的手机）一台，按照下文 beta版智慧生活最新申请方式 申请beta版智慧生活APP。

• 如果配网广播中的pid（Zxxxx）已商用，则无需下载beta版本智慧生活。

2. 将待测距整机设备安装于干扰较少的室内空间，安装方向上的空间长度需大于5米（保证4米点位可测试），设备通电后持续发送生态配网蓝牙广播。

可以安装蓝牙调试助手等工具抓取UUID为0xFDEE的广播，广播报文格式见下文测试参数调整，确认待测设备是否正在发送配网广播。

测距场景

测距KPI自测试主要是验证待测设备在不同方向和位置上的生态配网弹框率是否满足要求，主要验证两种测试指标，两种指标需同时满足：

• 近距离弹框测试：要求5s内弹框，若超过5s不计入弹框次数。单方向弹框成功率≥80%，整体弹框成功率≥95%。
• 远距离不弹框测试：要求10s内不弹框，若10s内弹框计入弹框次数。单方向弹框成功率≤20%，整体弹框成功率≤5%。

弹框成功率 = 弹框次数 / 测试次数（测试次数≥20）

指标解读：允许单个方向的弹框率略差，但整体弹框率必须要保证稳定。

不同类型设备的测试场景不同，当前有两类：空调挂机和空调柜机，其他类型的设备可参考配网模组所在设备实体的安装位置选择合适的场景。

挂机空调

配网模组位于室内机，通常安装于房间墙壁顶部，房间层高约3米左右。

测试手机手持或用非金属支架固定，高度离柜机下方约1.5米（与人正常手持手机的高度相同），顶端面向空调前盖板中心位置平放，分别在水平距离0cm/50cm/100cm/400cm的位置上测试弹框率。

验收指标：同时满足0cm/50cm/100cm各位置弹框成功率≥80%，整体弹框成功率≥95%；400cm位置弹框成功率≤5%。

柜机空调

配网模组位于室内机，通常安装于房间地面，模组距离地面1~1.5米。

测试手机手持或用非金属支架固定，高度与配网模组保持一致，顶端面向空调前盖板中心位置平放，分别在100cm和400cm距离测试0°/45°/90°/135°/180°各个方向上弹框率。

验收指标：同时满足100cm位置单方向弹框成功率≥80%，整体弹框成功率≥95%；400cm位置单方向弹框成功率≤20%，整体弹框成功率≤5%。

测试步骤

1.设备上电持续发送配网广播；

2.按照上文测距场景要求选择对应的场景，选择其中一个点位保持不动，持续做20次弹框测试，记录弹框KPI结果；然后换个点位继续测试直至所有点位测试完成；

3.查看自测试结果，如果完全满足测距KPI要求，下载附件中的《OpenHarmony生态统一互联设备测距KPI自测试报告模板》并填写自验证结果，发送给华为侧项目经理申请测距KPI验收；如果不满足测距KPI要求，按照下文测距参数调整调整配网广播数据后重新测试。

注意

• 弹框存在抑制规则：一个亮屏周期内，同一个设备只弹框一次；同一个设备连续2次关闭弹框首个页面，7天内不再弹框；连续关闭弹框首个页面3次，永不再弹框。因此推荐的操作是：手机弹框后点击“去连接”后关闭弹框（不要配网完成），然后按下电源键待手机完全熄屏，后再按下电源键手机亮屏等待下一个弹框。
• 注意设备发送广播持续时长（如：30分钟），到时间后会停止发送，在即将停止前设备重新上电可以继续发送配网广播。

测距参数调整

蓝牙测距的基本原理是根据蓝牙信号强度衰减程度估算一个距离，信号强度衰减通过比较发射时的信号强度和实际接收到的信号强度得到，发射时的信号强度数据携带在蓝牙配网广播中。

蓝牙信号强度除了传播距离上的损耗外，还受设备外盒结构及材质、模组安装位置等多种因素影响，因此需要动态调整蓝牙广播数据中携带的发射信号强度消除这些影响。

测距参数调整就是修改这个蓝牙广播中的值（AdvPower）保证能够满足测距KPI要求。

当远距离弹框率不满足时，表示信号衰减太小，测出的距离太近，应调大AdvPower；反之，当近距离弹框率不满足时，应调小AdvPower。

beta版智慧生活最新申请方式

1. 使用参与测试的华为账号登录DP（Device Partner）平台，进入账号管理-基本资料-申请测试权限，提交后等待处理完成。
2. 测试手机登录具有测试权限的华为账号，前往应用市场下载最新版本“智慧生活”APP。
3. 打开智慧生活APP会自动切换到沙箱环境，可以前往：我的->连接三方平台，厂商名称后面显示“认证”即确认当前是沙箱环境。

• 该方式不再与手机uuid绑定，用具有测试权限的华为账号登录即可。申请测试权限的华为账号需要加入企业群组，如果未加入用DP平台管理员账号邀请加入。
• 如果智慧生活未自动切换到沙箱环境，可以按照以下方法排查：1. 请确认华为账号是否已获得测试权限；2. 检查 智慧生活APP->我的->设置->关于->鸿蒙智联基础服务版本，应不低于17.0.2.310，低于该版本需更新到最新版本。
• 具有测试权限的华为账号如果想要连接商用环境，需取消测试权限。

不显示配网弹框解决办法

可从以下几个方向排查：

1. 待测设备是否正在发送配网广播，可以用蓝牙调试助手等工具搜索是否有UUID为0xFDEE的蓝牙广播确认。

2. 待测设备是否已经配置到智慧生活基础服务沙箱环境中，可联系对接的华为技术人员查询或配置。

3. 测试手机是否无网络；智慧生活是否已登录华为账号，已签署隐私协议，已开启设备自动发现，已切换至沙箱环境，版本符合要求等。

4. 之前显示过弹框，但后来始终不弹，可能是连续两次关闭弹框导致抑制，可以尝试两种方法恢复：1. 智慧生活中退出华为账号后重新登陆，重新切换至沙箱环境；2. 执行命令：hdc shell bm clean -d -n com.huawei.hmos.ailifesvc 后重新打开智慧生活APP。

5. 检查是否因蓝牙广播信号强度太弱导致不弹框，使用hilog工具抓取手机中日志，用关键字"modelId=Z"过滤后查看计算出的range值，小于100时才会弹框。

6. 如果以上方法均未能解决请联系华为技术人员协助。

测距日志抓取

以下方式均可按照指定时间区间和关键字"modelId=Z"过滤查看测距相关日志。

1. 通过hilogtool工具从测试手机中抓取。

2. 如果已安装DevEco Studio，可以参考日志分析在可视化页面中查看。