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,321 @@
# 3.2.1 设备端环境搭建
<style type="text/css">/**/
div.rbtoc1777701128697 {padding: 0px;}
div.rbtoc1777701128697 ul {margin-left: 0px;}
div.rbtoc1777701128697 li {margin-left: 0px;padding-left: 0px;}
/**/</style>
<div class="toc-macro rbtoc1777701128697">
- [1 MCUConfigTool 配置](#id-3.2.1设备端环境搭建-1MCUConfigTool配置)
- [1.1 General 页面 : 不勾选 Enable auto power off, 不勾选 Enable pairing timeout](#id-3.2.1设备端环境搭建-1.1General页面:不勾选Enableautopoweroff,不勾选Enablepairingtimeout)
- [1.2 General 页面 : Discoverable in standby mode 设置成disable。强制要求必须修改](#id-3.2.1设备端环境搭建-1.2General页面:Discoverableinstandbymode设置成disable。强制要求必须修改)
- [1.3 General 页面: 勾选 Non-discoverable when linkback 强制要求必须修改](#id-3.2.1设备端环境搭建-1.3General页面:勾选Non-discoverablewhenlinkback强制要求必须修改)
- [1.4 勾选Multi-link support, 并且不要勾选 Enter pairing state while only available device is connected 强制要求必须修改](#id-3.2.1设备端环境搭建-1.4勾选Multi-linksupport,并且不要勾选Enterpairingstatewhileonlyavailabledeviceisconnected强制要求必须修改)
- [1.5 Third Party页面配置GFPS参数](#id-3.2.1设备端环境搭建-1.5ThirdParty页面配置GFPS参数)
- [1.6 配置GFPS findme voice prompt tone](#id-3.2.1设备端环境搭建-1.6配置GFPSfindmevoiceprompttone)
- [1.7 保存新生成的 APP UI Parameter File 和 System Config File](#id-3.2.1设备端环境搭建-1.7保存新生成的APPUIParameterFile和SystemConfigFile)
- [1.8 Note](#id-3.2.1设备端环境搭建-1.8Note)
- [2 TWS 耳机 GFPS battery feature测试环境搭建(只有TWS耳机需要做GFPS battery测试single mode 不需要测试)](#id-3.2.1设备端环境搭建-2TWS耳机GFPSbatteryfeature测试环境搭建(只有TWS耳机需要做GFPSbattery测试singlemode不需要测试))
- [2.1.mcu config tool 配置:](#id-3.2.1设备端环境搭建-2.1.mcuconfigtool配置)
- [2.1.1 HW Feature 模块](#id-3.2.1设备端环境搭建-2.1.1HWFeature模块)
- [2.1.2 charger 模块勾选battery detection support](#id-3.2.1设备端环境搭建-2.1.2charger模块勾选batterydetectionsupport)
- [2.1.3 general 模块](#id-3.2.1设备端环境搭建-2.1.3general模块)
- [2.2.充电盒配置:](#id-3.2.1设备端环境搭建-2.2.充电盒配置:)
- [2.2.1 接线设置](#id-3.2.1设备端环境搭建-2.2.1接线设置)
- [2.2.2 充电盒操作](#id-3.2.1设备端环境搭建-2.2.2充电盒操作)
- [2.3 Note](#id-3.2.1设备端环境搭建-2.3Note)
- [2.3.1 开关盒操作步骤](#id-3.2.1设备端环境搭建-2.3.1开关盒操作步骤)
- [2.3.2 HUN显示测试](#id-3.2.1设备端环境搭建-2.3.2HUN显示测试)
- [2.3.3 demo rcfg](#id-3.2.1设备端环境搭建-2.3.3demorcfg)
- [3 GFPS LEA 环境搭建](#id-3.2.1设备端环境搭建-3GFPSLEA环境搭建)
- [1. enbale lea 以及disconnect enter lea pairing mode](#id-3.2.1设备端环境搭建-1.enbalelea以及disconnectenterleapairingmode)
- [2.配置stack相关参数](#id-3.2.1设备端环境搭建-2.配置stack相关参数)
- [EATT 暂时设置成 Disable](#id-3.2.1设备端环境搭建-EATT暂时设置成Disable)
- [Enable GATT Caching](#id-3.2.1设备端环境搭建-EnableGATTCaching)
- [3.配置GFPS参数](#id-3.2.1设备端环境搭建-3.配置GFPS参数)
- [4.配置ringtone](#id-3.2.1设备端环境搭建-4.配置ringtone)
- [5. 配置按键进入pairing mode](#id-3.2.1设备端环境搭建-5.配置按键进入pairingmode)
- [6 配置按键退出pairing mode](#id-3.2.1设备端环境搭建-6配置按键退出pairingmode)
- [7 配置GFPS LEA pairing mode 提示音](#id-3.2.1设备端环境搭建-7配置GFPSLEApairingmode提示音)
</div>
### 1  MCUConfigTool 配置
#### 1.1 General 页面 : 不勾选 Enable auto power off, <span style="letter-spacing: -0.003em;">不勾选 Enable pairing timeout</span>
<span style="color: rgb(255,0,0);">**Note**:</span>
修改为了便于GFPS测试GFPS 测试的时候或者是过认证的时候需要修改, **<span style="color: rgb(255,0,0);">量产时可以考虑不修改。</span>**
![](images/3.2.1+设备端环境搭建_f57f20be.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/3.2.1+设备端环境搭建_03797d18.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/3.2.1+设备端环境搭建_ed3de84f.jpg)
#### 1.4 勾选Multi-link support, 并且不要勾选 Enter pairing state while only available device is connected  <span style="color: rgb(255,0,0);">**强制要求必须修改**</span>
下面红框里的**<span style="color: rgb(255,0,0);">不可以勾选</span>  **<span style="color: rgb(0,0,0);letter-spacing: 0.0px;">不然battery HUN测试可能测不过</span> **<span class="jira-issue" client-id="SINGLE_2d885edc-676b-3349-9548-fe5648c9d8cd_948642932_2c9082e76519d09101657ff5cfb3003b" jira-key="BBPRO2BUG-21515"> <a href="https://jira.realtek.com/browse/BBPRO2BUG-21515" class="jira-issue-key"><span class="aui-icon aui-icon-wait issue-placeholder"></span>BBPRO2BUG-21515</a> - <span class="summary">Getting issue details...</span> <span class="aui-lozenge aui-lozenge-subtle aui-lozenge-default issue-placeholder">STATUS</span> </span>**
![](images/3.2.1+设备端环境搭建_de506e81.jpg)
#### 1.5 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/3.2.1+设备端环境搭建_9bed7f8b.jpg)
下面是RTK已通过认证的Module ID
[认证结果及认证通过的model_id 和key](/pages/viewpage.action?pageId=204620689)
#### 1.6 配置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/3.2.1+设备端环境搭建_90a61fa1.jpg)
打开MCU config tool开始配置findme tone
首先refresh一下让tool能够识别新的wav文件
然后就可以选择vp tone了
如下图所示:
![](images/3.2.1+设备端环境搭建_a1569809.jpg)
![](images/3.2.1+设备端环境搭建_923a4b2f.jpg)
#### 1.7 保存新生成的 APP UI Parameter File 和 System Config File
#### **1.8 Note**
1.建议把BD Address和Device Name也改一下
2.建议Export 生成rcfg之前先导入正确的flash_map.ini
![](images/3.2.1+设备端环境搭建_bc8b6e71.jpg)
\
### 2 TWS 耳机 GFPS battery feature测试环境搭建(<span style="color: rgb(255,0,0);">只有TWS耳机需要做GFPS battery测试single mode 不需要测试</span>)
Note
测试battery的时候需要搭配充电盒
#### 2.1.mcu config tool 配置:
##### 2.1.1 HW Feature 模块
       勾选Charger功能
![](images/3.2.1+设备端环境搭建_a10bd948.jpg)
勾选支持充电盒功能,<span style="color: rgb(255,0,0);">注意如果充电盒image烧录的是20ms,下面红色框中的40ms也要改成20ms,这个要和充电盒image匹配的。</span>
<span style="color: rgb(255,0,0);">如果充电盒image 烧录的是40ms</span>
![](images/3.2.1+设备端环境搭建_5cdb6740.jpg)
如果充电盒image烧录的是20ms:\
![](images/3.2.1+设备端环境搭建_bffc8745.jpg)
勾选power off immediately when chose case和do not auto power off when case not close
![](images/3.2.1+设备端环境搭建_2ec82dcc.jpg)
##### 2.1.2 charger 模块勾选battery detection support
![](images/3.2.1+设备端环境搭建_7d634684.jpg)
![](images/3.2.1+设备端环境搭建_4549444f.jpg)
![](images/3.2.1+设备端环境搭建_f7b6759c.jpg)
##### 2.1.3 general 模块
![](images/3.2.1+设备端环境搭建_adcf7ea6.jpg)
2.1.4 third party 模块 enable battery 功能
![](images/3.2.1+设备端环境搭建_823fbf23.jpg)
#### 2.2.充电盒配置:
##### 2.2.1 接线设置
![](images/3.2.1+设备端环境搭建_b643e9a4.jpg)
##### 2.2.2 充电盒操作
![](images/3.2.1+设备端环境搭建_742c3d62.jpg)
#### **2.3 Note**
##### 2.3.1 开关盒操作步骤
1.左右耳factory reset 之后,先按下出盒入盒按钮(确保两个按钮同时按下,代表左右耳机入盒),耳机入盒之后,再按下开盒关盒按钮(按键弹起是开盒)耳机端可以听到power on的提示音说明开盒成功。有时候开盒成功但是没有提示音此时可以看一下log
app_adp_handle_msg +++++ AD2B_CMD_POWER_ON =3如果有AD2B_CMD_POWER_ON的log说明开盒成功
2.按下开盒关盒按钮按键按下是关盒耳机端可以听到power off的提示音说明关盒成功。有时候关盒成功但是没有提示音此时可以看一下log
app_adp_handle_msg +++++ AD2B_CMD_POWER_OFF =4如果有AD2B_CMD_POWER_OFF的log说明关盒成功
3.如果重新烧录app的bin. 烧录完成之后要先按一下reset按键然后按开盒关盒按钮进行操作。
**4.关盒之后3s关机关机之后 3s会 watch dog reset故关盒之后建议等10s才可以再次开盒否则开机流程可能会不正常**
相关代码修改(仅用于GFPS认证)
关盒之后3s关机
\#define ADP_CLOSE_CASE_TIMEOUT_MS                       3000
关机之后打开power off的提示音(目前没有打开,可以不需要修改,使用默认配置就好)
![](images/3.2.1+设备端环境搭建_0e82a2e9.jpg)
watch dog reset的时间改成6s,目前没有设置成6s,使用默认设置3s目前测试看是ok的所以这个也可以不用修改
![](images/3.2.1+设备端环境搭建_4da279b3.jpg)
##### 2.3.2 HUN显示测试
HUN(Heads up notification)显示图如下:
![](images/3.2.1+设备端环境搭建_29219f10.jpg)
一次HUN显示成功之后需要先把上次的显示信息清掉,再执行下一次操作:
![](images/3.2.1+设备端环境搭建_acdbdb52.jpg)
\
##### 2.3.3 demo rcfg
<a href="/download/attachments/139180496/GFPS_Left.rcfg?version=1&amp;modificationDate=1636711808317&amp;api=v2" data-linked-resource-container-id="139180496" data-linked-resource-container-version="20" data-linked-resource-content-type="application/octet-stream" data-linked-resource-default-alias="GFPS_Left.rcfg" data-linked-resource-id="205658521" data-linked-resource-type="attachment" data-linked-resource-version="1">GFPS_Left.rcfg</a>
<a href="/download/attachments/139180496/GFPS_Right.rcfg?version=1&amp;modificationDate=1636711808877&amp;api=v2" data-linked-resource-container-id="139180496" data-linked-resource-container-version="20" data-linked-resource-content-type="application/octet-stream" data-linked-resource-default-alias="GFPS_Right.rcfg" data-linked-resource-id="205658522" data-linked-resource-type="attachment" data-linked-resource-version="1">GFPS_Right.rcfg</a>
\
### 3 GFPS LEA 环境搭建
#### 1. enbale lea 以及disconnect enter lea pairing mode
![](images/3.2.1+设备端环境搭建_e8e3cbb6.jpg)
![](images/3.2.1+设备端环境搭建_f8279dc1.jpg)
#### 2.配置stack相关参数
##### EATT 暂时设置成 Disable
LE link 设置:
![](images/3.2.1+设备端环境搭建_6112c00b.jpg)
![](images/3.2.1+设备端环境搭建_d9ec7592.jpg)
##### Enable GATT Caching
![](images/3.2.1+设备端环境搭建_f081533e.jpg)
\
#### 3.配置GFPS参数
![](images/3.2.1+设备端环境搭建_a9bc57a8.jpg)
\
GFPS device mode 设置成 Dual mode device with CSIP (**<span style="color: rgb(255,0,0);">这边取名字为CSIP取的有点问题实际是想声明是否支援LE audio, 后面会请tool 帮忙把CSIP 改成LE audio</span>**)
**<span style="color: rgb(255,0,0);">如果找不到  Dual mode device with CSIP  应该是 新的 mcu cfg tool 有改名字将 CSIP 统一改成 LE audio了 tool上可以设置成 Dual mode device with LE audio</span>**
<a href="https://jira.realtek.com/browse/BTSOCTOOL-5234" class="external-link" rel="nofollow" title="https://jira.realtek.com/browse/btsoctool-5234">[BTSOCTOOL-5234] GFPS页面CSIP改成LE audio - Jira</a>
![](images/3.2.1+设备端环境搭建_b3c9b188.jpg)
\
#### 4.配置ringtone
![](images/3.2.1+设备端环境搭建_8cfd479d.jpg)
![](images/3.2.1+设备端环境搭建_68e8b8d6.jpg)
\
![](images/3.2.1+设备端环境搭建_9ad77753.jpg)
\
#### 5. 配置按键进入pairing mode
将key1设置成 GFPS LEA enter pair mode(0xB9),  作为GFPS le audio 按键强制进入pairing mode 的MMI
有的客户不想多配置一个按键,想要复用 legacy 进Pairing mode的mmi, 那么key1也可以配置成 MMI(0x6C)
\
![](images/3.2.1+设备端环境搭建_dba3a558.jpg)
或者是
![](images/3.2.1+设备端环境搭建_cfe5d409.jpg)
单击key1 GFPS LE audio 会强制进入pairing mode
手机弹窗出来之后, 配对 GFPS LE audio,
正常配对成功之后会直接退出pairing mode
如果按键进入pairing mode 之后手机端一直没有配对耳机那耳机会一直处于pairing mode需要配置按键退出pairing mode。
例如:
#### 6 配置按键退出pairing mode
![](images/3.2.1+设备端环境搭建_81ad6b9a.jpg)
或者是
![](images/3.2.1+设备端环境搭建_f8d77b26.jpg)
\
#### 7 配置GFPS LEA pairing mode 提示音
![](images/3.2.1+设备端环境搭建_cd75c78f.jpg)
\