gfps: 添加认证测试和FAQ 20260505
All checks were successful
Sync To /home/ubuntu/gfps / sync (push) Successful in 2s

Change-Id: I71e676b997159a141ca07d16f82a73b45f4b2410
This commit is contained in:
danni_dong
2026-05-05 19:24:08 +08:00
parent 2ed168dcf8
commit bdbb2527e6
1943 changed files with 10585 additions and 434 deletions

View File

@@ -0,0 +1,191 @@
# 5.2.1 设备端环境搭建
<style type="text/css">/**/
div.rbtoc1777701377597 {padding: 0px;}
div.rbtoc1777701377597 ul {margin-left: 0px;}
div.rbtoc1777701377597 li {margin-left: 0px;padding-left: 0px;}
/**/</style>
<div class="toc-macro rbtoc1777701377597">
- [1 MCUConfigTool 配置](#id-5.2.1设备端环境搭建-1MCUConfigTool配置)
- [1.1 General 页面 : 不勾选 Enable auto power off, 不勾选 Enable pairing timeout](#id-5.2.1设备端环境搭建-1.1General页面:不勾选Enableautopoweroff,不勾选Enablepairingtimeout)
- [1.2 General 页面 : Discoverable in standby mode 设置成disable。强制要求必须修改](#id-5.2.1设备端环境搭建-1.2General页面:Discoverableinstandbymode设置成disable。强制要求必须修改)
- [1.3 General 页面: 勾选 Non-discoverable when linkback 强制要求必须修改](#id-5.2.1设备端环境搭建-1.3General页面:勾选Non-discoverablewhenlinkback强制要求必须修改)
- [1.4 Third Party页面配置GFPS参数](#id-5.2.1设备端环境搭建-1.4ThirdParty页面配置GFPS参数)
- [1.5 配置GFPS findme voice prompt tone](#id-5.2.1设备端环境搭建-1.5配置GFPSfindmevoiceprompttone)
- [1.6 保存新生成的 APP UI Parameter File 和 System Config File](#id-5.2.1设备端环境搭建-1.6保存新生成的APPUIParameterFile和SystemConfigFile)
- [1.7 Note](#id-5.2.1设备端环境搭建-1.7Note)
- [1.建议把BD Address和Device Name也改一下](#id-5.2.1设备端环境搭建-1.建议把BDAddress和DeviceName也改一下)
- [2.建议Export 生成rcfg之前先导入正确的flash_map.ini](#id-5.2.1设备端环境搭建-2.建议Export生成rcfg之前先导入正确的flash_map.ini)
- [2 Find Hub测试环境搭建](#id-5.2.1设备端环境搭建-2FindHub测试环境搭建)
- [2.1 每一轮测试开始之前耳机端需要做factory reset操作测试中请不要做factory reset。原因如下8 手机端清掉配对信息之后耳机端也要做factory reset不然finder功能用不起来](#id-5.2.1设备端环境搭建-2.1每一轮测试开始之前耳机端需要做factoryreset操作测试中请不要做factoryreset。原因如下)
- [2.2 finder 所有功能测试完成之后测试手机归还QC之前手机端一定要清掉配对信息不然过段时间再测试的时候可能会有问题手机log会提示设备已经有owner了会比较麻烦建议测试完成之后一定要先把手机端的配对信息全清掉 1 gfps/finder 如何清除配对信息](#id-5.2.1设备端环境搭建-2.2finder所有功能测试完成之后测试手机归还QC之前手机端一定要清掉配对信息不然过段时间再测试的时候可能会有问题手机log会提示设备已经有owner了会比较麻烦建议测试完成之后一定要先把手机端的配对信息全清掉)
- [2.3 MCU cfg tool中model id和key的信息要换成支持finder 的model id 和key的信息测试账号必须只能使用某个固定的Google账号暂时还不可以使用多个Google账号进行测试。](#id-5.2.1设备端环境搭建-2.3MCUcfgtool中modelid和key的信息要换成支持finder的modelid和key的信息测试账号必须只能使用某个固定的Google账号暂时还不可以使用多个Google账号进行测试。)
- [2.4 2024/5/11以后更新至finder1.3后需要填写注册model id的时候填写的 ”Company name”, ”Device name” 和 ”Device type”](#id-5.2.1设备端环境搭建-2.42024/5/11以后更新至finder1.3后需要填写注册modelid的时候填写的”Companyname”,”Devicename”和”Devicetype”)
- [2.5 .MCU cfg tool 需要配置按键停止响铃功能](#id-5.2.1设备端环境搭建-2.5.MCUcfgtool需要配置按键停止响铃功能)
- [2.6 Finder adv 需要占用一条BLE linkGFPS adv要占用一条 BLE link, 所以这边LE link number 和 LE slave link number要在原有的基础上+2](#id-5.2.1设备端环境搭建-2.6Finderadv需要占用一条BLElinkGFPSadv要占用一条BLElink,所以这边LElinknumber和LEslavelinknumber要在原有的基础上+2)
- [2.7 要想让finder响铃mcu cfg tool 需要配置对应的vp](#id-5.2.1设备端环境搭建-2.7要想让finder响铃mcucfgtool需要配置对应的vp)
- [2.8 mcu cfg tool 需要enable finder 功能](#id-5.2.1设备端环境搭建-2.8mcucfgtool需要enablefinder功能)
- [2.9 2024/5/11 更新至finder1.3后KEY配置界面需要配置按键0xBB Dult enter id read state mode](#id-5.2.1设备端环境搭建-2.92024/5/11更新至finder1.3后KEY配置界面需要配置按键0xBBDultenteridreadstatemode)
- [2.10 2024/5/11 更新至finder1.3后Ringtone配置页面需要配置GFPS find dultHarman案子比较特殊分为两个响铃GFPS find dult tone和GFPS find dult vp 其他案子一般就一个)](#id-5.2.1设备端环境搭建-2.102024/5/11更新至finder1.3后Ringtone配置页面需要配置GFPSfinddultHarman案子比较特殊分为两个响铃GFPSfinddulttone和GFPSfinddultvp其他案子一般就一个)
- [2.11 如果需要关机之后依然打finder广播需要配置以下信息](#id-5.2.1设备端环境搭建-2.11如果需要关机之后依然打finder广播需要配置以下信息)
</div>
### 1  MCUConfigTool 配置
#### 1.1 General 页面 : 不勾选 Enable auto power off, 不勾选 Enable pairing timeout
<span style="color: rgb(255,0,0);">**Note**:</span>
修改为了便于GFPS测试GFPS 测试的时候或者是过认证的时候需要修改, **<span style="color: rgb(255,0,0);">量产时可以考虑不修改。</span>**
![](images/5.2.1+设备端环境搭建_df408f64.jpg)
#### 1.2 General 页面 : Discoverable in standby mode 设置成disable。<span style="color: rgb(255,0,0);">**强制要求必须修改**</span>
<span style="color: rgb(255,0,0);">**Note**:</span>
GFPS 耳机第一次和一只手机配对成功之后(initial pairing 成功),就会进入 subsequent pairing mode。
所以initial pairing 成功之后不管耳机是进入idle mode 还是进入connectable mode(multilink 支持)都不应该再设置成discoverable。
![](images/5.2.1+设备端环境搭建_0f0a32e1.jpg)
#### 1.3  General 页面: 勾选 Non-discoverable when linkback <span style="color: rgb(255,0,0);">**强制要求必须修改**</span>
linkback模式下DUT不应该discoverable不然手机端会一直弹配对窗口。<span style="color: rgb(255,0,0);">   </span>
\
![](images/5.2.1+设备端环境搭建_bf169e87.jpg)
#### 1.4 Third Party页面配置GFPS参数
在Third Party页面配置GFPS参数详细信息参考 <a href="https://wiki.realtek.com/pages/viewpage.action?pageId=158870786" rel="nofollow">mcu cfg tool中 GFPS 各配置项的含义 - BT_Market - WIKI</a>
![](images/5.2.1+设备端环境搭建_bae9ee80.jpg)
\
![](images/5.2.1+设备端环境搭建_28d0ce48.jpg)
\
#### 1.5 配置GFPS findme voice prompt tone
<a href="#" class="unresolved">gfps_findme.wav</a>
自行选择wav文件作为findme vp tone
wav文件名称可以自行修改放入MCU config tool vp目录
建议findme的wav文件可以播放久一些这样才能达到提示的效果。
如下图所示:
![](images/5.2.1+设备端环境搭建_d1325426.jpg)
打开MCU config tool开始配置findme tone
首先refresh一下让tool能够识别新的wav文件
然后就可以选择vp tone了
如下图所示:
![](images/5.2.1+设备端环境搭建_9c951882.jpg)
![](images/5.2.1+设备端环境搭建_773dbdeb.jpg)
#### 1.6 保存新生成的 APP UI Parameter File 和 System Config File
#### **1.7 Note**
##### 1.建议把BD Address和Device Name也改一下
##### 2.建议Export 生成rcfg之前先导入正确的flash_map.ini
![](images/5.2.1+设备端环境搭建_3a6ea962.jpg)
\
### <span style="color: rgb(255,0,0);">**2 Find Hub测试环境搭建**</span>
#### 2.1 每一轮测试开始之前耳机端需要做factory reset操作测试中请不要做factory reset。原因如下[8 手机端清掉配对信息之后耳机端也要做factory reset不然finder功能用不起来](/pages/viewpage.action?pageId=350190807)
#### <span style="color: rgb(255,0,0);">2.2 finder 所有功能测试完成之后测试手机归还QC之前手机端一定要清掉配对信息不然过段时间再测试的时候可能会有问题手机log会提示设备已经有owner了会比较麻烦建议测试完成之后一定要先把手机端的配对信息全清掉</span> [1 gfps/finder 如何清除配对信息](/pages/viewpage.action?pageId=401291585)
#### 2.3 MCU cfg tool中model id和key的信息要换成支持finder 的model id 和key的信息测试账号必须只能使用某个固定的Google账号暂时还不可以使用多个Google账号进行测试。
<span style="color: rgb(255,0,0);"> 内部测试model id 和Company name, Device name 和 Device type 请参考 </span>
<span style="color: rgb(255,0,0);">如果是Dual mode model id 请参考 <a href="https://wiki.realtek.com/display/BTMKT/4.+dual+mode+locator+tag+model+id" rel="nofollow">4. dual mode locator tag model id - BT_Market - WIKI</a></span>
<span style="color: rgb(255,0,0);">如果是le only mode, model id 请参考 <a href="https://wiki.realtek.com/display/BTMKT/LE+only+locator+tracker+model+id" rel="nofollow">LE only locator tracker model id - BT_Market - WIKI</a></span>
![](images/5.2.1+设备端环境搭建_9150821a.jpg)
#### 2.4  2024/5/11以后更新至finder1.3后需要填写注册model id的时候填写的 ”Company name”, ”Device name” 和 ”Device type”
![](images/5.2.1+设备端环境搭建_2d80b99b.jpg)
#### 2.5 .MCU cfg tool 需要配置按键停止响铃功能
for example:
配置key1接P3_1
![](images/5.2.1+设备端环境搭建_44f81150.jpg)
配置key1短按之后触发GFPS finder停止响铃
![](images/5.2.1+设备端环境搭建_30f147ea.jpg)
开发板上 key1 接到M3_1
![](images/5.2.1+设备端环境搭建_19cd012f.jpg)
#### 2.6 Finder adv 需要占用一条BLE linkGFPS adv要占用一条 BLE link, 所以这边LE link number 和 LE slave link number要在原有的基础上+2
![](images/5.2.1+设备端环境搭建_d0d60aaf.jpg)
\
#### 2.7 要想让finder响铃mcu cfg tool 需要配置对应的vp
![](images/5.2.1+设备端环境搭建_51011cff.jpg)
\
#### 2.8 mcu cfg tool 需要enable finder 功能
![](images/5.2.1+设备端环境搭建_edd3e39b.jpg)
\
#### 2.9 2024/5/11 更新至finder1.3后KEY配置界面需要配置按键0xBB Dult enter id read state mode
![](images/5.2.1+设备端环境搭建_c3f13fee.jpg)
\
#### 2.10 2024/5/11 更新至finder1.3后Ringtone配置页面需要配置GFPS find dultHarman案子比较特殊分为两个响铃GFPS find dult tone和GFPS find dult vp 其他案子一般就一个)
![](images/5.2.1+设备端环境搭建_eb1a7423.jpg)
![](images/5.2.1+设备端环境搭建_da818ff3.jpg)
\
#### 2.11 如果需要关机之后依然打finder广播需要配置以下信息
详细信息可以参考<a href="https://wiki.realtek.com/pages/viewpage.action?pageId=158870786" rel="nofollow">mcu cfg tool中 GFPS 各配置项的含义 - BT_Market - WIKI</a> 中的: ”9. GFPS Finder相关配置信息描述”
![](images/5.2.1+设备端环境搭建_d6a9bb6e.jpg)
\
\