Files
gfps/1.2.1+设备端环境搭建.md
danni_dong bdbb2527e6
All checks were successful
Sync To /home/ubuntu/gfps / sync (push) Successful in 2s
gfps: 添加认证测试和FAQ 20260505
Change-Id: I71e676b997159a141ca07d16f82a73b45f4b2410
2026-05-05 19:24:08 +08:00

231 lines
12 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 1.2.1 设备端环境搭建
<style type="text/css">/**/
div.rbtoc1777701049430 {padding: 0px;}
div.rbtoc1777701049430 ul {margin-left: 0px;}
div.rbtoc1777701049430 li {margin-left: 0px;padding-left: 0px;}
/**/</style>
<div class="toc-macro rbtoc1777701049430">
- [1 MCUConfigTool 配置](#id-1.2.1设备端环境搭建-1MCUConfigTool配置)
- [1.1 General 页面 : 不勾选 Enable auto power off, 不勾选 Enable pairing timeout](#id-1.2.1设备端环境搭建-1.1General页面:不勾选Enableautopoweroff,不勾选Enablepairingtimeout)
- [1.2 General 页面 : Discoverable in standby mode 设置成disable。强制要求必须修改](#id-1.2.1设备端环境搭建-1.2General页面:Discoverableinstandbymode设置成disable。强制要求必须修改)
- [1.3 General 页面: 勾选 Non-discoverable when linkback 强制要求必须修改](#id-1.2.1设备端环境搭建-1.3General页面:勾选Non-discoverablewhenlinkback强制要求必须修改)
- [1.4 勾选Multi-link support, 并且不要勾选 Enter pairing state while only available device is connected 强制要求必须修改](#id-1.2.1设备端环境搭建-1.4勾选Multi-linksupport,并且不要勾选Enterpairingstatewhileonlyavailabledeviceisconnected强制要求必须修改)
- [1.5 Third Party页面配置GFPS参数](#id-1.2.1设备端环境搭建-1.5ThirdParty页面配置GFPS参数)
- [1.6 配置GFPS findme voice prompt tone](#id-1.2.1设备端环境搭建-1.6配置GFPSfindmevoiceprompttone)
- [1.7 保存新生成的 APP UI Parameter File 和 System Config File](#id-1.2.1设备端环境搭建-1.7保存新生成的APPUIParameterFile和SystemConfigFile)
- [1.8 Note](#id-1.2.1设备端环境搭建-1.8Note)
- [1.建议把BD Address和Device Name也改一下](#id-1.2.1设备端环境搭建-1.建议把BDAddress和DeviceName也改一下)
- [2.建议Export 生成rcfg之前先导入正确的flash_map.ini](#id-1.2.1设备端环境搭建-2.建议Export生成rcfg之前先导入正确的flash_map.ini)
- [3.因为设备不支援LEA LEA相关的配置要务必关掉](#id-1.2.1设备端环境搭建-3.因为设备不支援LEALEA相关的配置要务必关掉)
- [2 TWS 耳机 GFPS battery feature测试环境搭建(只有TWS耳机需要做GFPS battery测试single mode 不需要测试)](#id-1.2.1设备端环境搭建-2TWS耳机GFPSbatteryfeature测试环境搭建(只有TWS耳机需要做GFPSbattery测试singlemode不需要测试))
- [2.1.mcu config tool 配置:](#id-1.2.1设备端环境搭建-2.1.mcuconfigtool配置)
- [2.1.1 HW Feature 模块](#id-1.2.1设备端环境搭建-2.1.1HWFeature模块)
- [2.1.2 charger 模块勾选battery detection support](#id-1.2.1设备端环境搭建-2.1.2charger模块勾选batterydetectionsupport)
- [2.1.3 general 模块](#id-1.2.1设备端环境搭建-2.1.3general模块)
- [2.2.充电盒配置:](#id-1.2.1设备端环境搭建-2.2.充电盒配置:)
- [2.2.1 接线设置](#id-1.2.1设备端环境搭建-2.2.1接线设置)
- [2.2.2 充电盒操作](#id-1.2.1设备端环境搭建-2.2.2充电盒操作)
- [2.3 Note](#id-1.2.1设备端环境搭建-2.3Note)
- [2.3.1 开关盒操作步骤](#id-1.2.1设备端环境搭建-2.3.1开关盒操作步骤)
- [2.3.2 HUN显示测试](#id-1.2.1设备端环境搭建-2.3.2HUN显示测试)
- [2.3.3 demo rcfg 里面有model id信息不可以直接开给客户](#id-1.2.1设备端环境搭建-2.3.3demorcfg里面有modelid信息不可以直接开给客户)
</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/1.2.1+设备端环境搭建_bcd362b7.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/1.2.1+设备端环境搭建_d0e3475d.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/1.2.1+设备端环境搭建_ae49306f.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_948641792_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/1.2.1+设备端环境搭建_f1131ed7.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/1.2.1+设备端环境搭建_e93dd0c7.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/1.2.1+设备端环境搭建_44f49178.jpg)
打开MCU config tool开始配置findme tone
首先refresh一下让tool能够识别新的wav文件
然后就可以选择vp tone了
如下图所示:
![](images/1.2.1+设备端环境搭建_a176185f.jpg)
![](images/1.2.1+设备端环境搭建_47b6458d.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/1.2.1+设备端环境搭建_ecc9e5f4.jpg)
##### 3.因为设备不支援LEA LEA相关的配置要务必关掉
![](images/1.2.1+设备端环境搭建_739f0969.jpg)
![](images/1.2.1+设备端环境搭建_f4a95b98.jpg)
![](images/1.2.1+设备端环境搭建_9754b655.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/1.2.1+设备端环境搭建_e897c395.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/1.2.1+设备端环境搭建_2c7a3a42.jpg)
如果充电盒image烧录的是20ms:\
![](images/1.2.1+设备端环境搭建_e2ad22ee.jpg)
勾选power off immediately when chose case和do not auto power off when case not close
![](images/1.2.1+设备端环境搭建_0ef42c25.jpg)
##### 2.1.2 charger 模块勾选battery detection support
![](images/1.2.1+设备端环境搭建_9e0e41b4.jpg)
![](images/1.2.1+设备端环境搭建_6fac7144.jpg)
![](images/1.2.1+设备端环境搭建_9cf79166.jpg)
##### 2.1.3 general 模块
![](images/1.2.1+设备端环境搭建_c67fec09.jpg)
2.1.4 third party 模块 enable battery 功能
![](images/1.2.1+设备端环境搭建_01ca4548.jpg)
#### 2.2.充电盒配置:
##### 2.2.1 接线设置
![](images/1.2.1+设备端环境搭建_37c0eb49.jpg)
##### 2.2.2 充电盒操作
![](images/1.2.1+设备端环境搭建_60864ced.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/1.2.1+设备端环境搭建_3bc0451e.jpg)
watch dog reset的时间改成6s,目前没有设置成6s,使用默认设置3s目前测试看是ok的所以这个也可以不用修改
![](images/1.2.1+设备端环境搭建_5776e5d1.jpg)
##### 2.3.2 HUN显示测试
HUN(Heads up notification)显示图如下:
![](images/1.2.1+设备端环境搭建_2b75a162.jpg)
一次HUN显示成功之后需要先把上次的显示信息清掉,再执行下一次操作:
![](images/1.2.1+设备端环境搭建_508076bd.jpg)
\
##### 2.3.3 demo rcfg <span style="color: rgb(255,0,0);">里面有model id信息不可以直接开给客户</span>
<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>
\
\