Files
gfps/1.2.1+设备端环境搭建.md
2026-05-01 10:06:36 +08:00

231 lines
13 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 设备端环境搭建 {#设备端环境搭建}
:::: {.Section1}
`<style type="text/css">/**/
div.rbtoc1777598888652 {padding: 0px;}
div.rbtoc1777598888652 ul {margin-left: 0px;}
div.rbtoc1777598888652 li {margin-left: 0px;padding-left: 0px;}
/**/</style>`{=html}
::: {.toc-macro .rbtoc1777598888652}
- [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信息不可以直接开给客户)
:::
### 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}
**Note**:
修改为了便于GFPS测试GFPS 测试的时候或者是过认证的时候需要修改, **量产时可以考虑不修改。**
![](media/1.2.1+设备端环境搭建/a75da87126dabd34a9c54e26b5008fd5.png)
#### 1.2 General 页面 : Discoverable in standby mode 设置成disable。**强制要求必须修改** {#id-1.2.1设备端环境搭建-1.2General页面:Discoverableinstandbymode设置成disable。强制要求必须修改}
**Note**:
GFPS 耳机第一次和一只手机配对成功之后(initial pairing 成功),就会进入 subsequent pairing mode。
所以initial pairing 成功之后不管耳机是进入idle mode 还是进入connectable mode(multilink 支持)都不应该再设置成discoverable。
![](media/1.2.1+设备端环境搭建/a73ebf874561ef037ea7cc0e0eec3c1a.png)
#### 1.3  General 页面: 勾选 Non-discoverable when linkback **强制要求必须修改** {#id-1.2.1设备端环境搭建-1.3General页面:勾选Non-discoverablewhenlinkback强制要求必须修改}
linkback模式下DUT不应该discoverable不然手机端会一直弹配对窗口。   
\
![](media/1.2.1+设备端环境搭建/bd1aae2090097e031e53873968a1d6f4.png)
#### 1.4 勾选Multi-link support, 并且不要勾选 Enter pairing state while only available device is connected  **强制要求必须修改** {#id-1.2.1设备端环境搭建-1.4勾选Multi-linksupport,并且不要勾选Enterpairingstatewhileonlyavailabledeviceisconnected强制要求必须修改}
下面红框里的**不可以勾选  **不然battery HUN测试可能测不过 ** [[BBPRO2BUG-21515](https://jira.realtek.com/browse/BBPRO2BUG-21515){.jira-issue-key} - Getting issue details\... STATUS ]{.jira-issue jira-key="BBPRO2BUG-21515" client-id="SINGLE_2d885edc-676b-3349-9548-fe5648c9d8cd_948641792_2c9082e76519d09101657ff5cfb3003b"}**
![](media/1.2.1+设备端环境搭建/deb4e2f66d2e71d13625d9a84e02f4a9.png)
#### 1.5 Third Party页面配置GFPS参数 {#id-1.2.1设备端环境搭建-1.5ThirdParty页面配置GFPS参数}
在Third Party页面配置GFPS参数详细信息参考 [mcu cfg tool中 GFPS 各配置项的含义 - BT_Market - WIKI](https://wiki.realtek.com/pages/viewpage.action?pageId=158870786){rel="nofollow"}
![](media/1.2.1+设备端环境搭建/1184039875b1b2e3119c18c9f50f7a86.png)
下面是RTK已通过认证的Module ID
[认证结果及认证通过的model_id 和key](/pages/viewpage.action?pageId=204620689)
#### 1.6 配置GFPS findme voice prompt tone {#id-1.2.1设备端环境搭建-1.6配置GFPSfindmevoiceprompttone}
[gfps_findme.wav](#){.unresolved}
自行选择wav文件作为findme vp tone
wav文件名称可以自行修改放入MCU config tool vp目录
建议findme的wav文件可以播放久一些这样才能达到提示的效果。
如下图所示:
![](media/1.2.1+设备端环境搭建/376350bb02b315be95274cec1b03fa1d.png)
打开MCU config tool开始配置findme tone
首先refresh一下让tool能够识别新的wav文件
然后就可以选择vp tone了
如下图所示:
![](media/1.2.1+设备端环境搭建/c564ca9d4cb3db32c6a593bdda5b3617.png)
![](media/1.2.1+设备端环境搭建/38d2923796490cb846076477f7aa2e6a.png)
#### 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}
![](media/1.2.1+设备端环境搭建/f7cf5e80b139e58c372ee7bd3b58734d.png)
##### 3.因为设备不支援LEA LEA相关的配置要务必关掉 {#id-1.2.1设备端环境搭建-3.因为设备不支援LEALEA相关的配置要务必关掉}
![](media/1.2.1+设备端环境搭建/80bd69652553556fad57c0794099a55d.png)
![](media/1.2.1+设备端环境搭建/4fbd46cb906e3341fd72fa298fa820cf.png)
![](media/1.2.1+设备端环境搭建/51a0e41fdd5cb323f5cd8e5266bbb005.png)
### 2 TWS 耳机 GFPS battery feature测试环境搭建(只有TWS耳机需要做GFPS battery测试single mode 不需要测试) {#id-1.2.1设备端环境搭建-2TWS耳机GFPSbatteryfeature测试环境搭建(只有TWS耳机需要做GFPSbattery测试singlemode不需要测试)}
Note
测试battery的时候需要搭配充电盒
#### 2.1.mcu config tool 配置: {#id-1.2.1设备端环境搭建-2.1.mcuconfigtool配置}
##### 2.1.1 HW Feature 模块 {#id-1.2.1设备端环境搭建-2.1.1HWFeature模块}
       勾选Charger功能
![](media/1.2.1+设备端环境搭建/ea1bba5a0188d660a7843b301bd45575.png)
勾选支持充电盒功能注意如果充电盒image烧录的是20ms,下面红色框中的40ms也要改成20ms,这个要和充电盒image匹配的。
如果充电盒image 烧录的是40ms
![](media/1.2.1+设备端环境搭建/4bf5ee1adce5f42f2850af333c894b14.png)
如果充电盒image烧录的是20ms:\
![](media/1.2.1+设备端环境搭建/89818e83841c7886e8954c77c415deec.png)
勾选power off immediately when chose case和do not auto power off when case not close
![](media/1.2.1+设备端环境搭建/60edd7696c5c11c06f000f97097a3acb.png)
##### 2.1.2 charger 模块勾选battery detection support {#id-1.2.1设备端环境搭建-2.1.2charger模块勾选batterydetectionsupport}
![](media/1.2.1+设备端环境搭建/ec289f7c9f337a00ff4eed1b2731265c.png)
![](media/1.2.1+设备端环境搭建/b5ca29b78d55f32174c569e6d26e9a0b.png)
![](media/1.2.1+设备端环境搭建/500bc6e0f02e7d9c0c068090d4d90310.png)
##### 2.1.3 general 模块 {#id-1.2.1设备端环境搭建-2.1.3general模块}
![](media/1.2.1+设备端环境搭建/2341c78f84b2b1be53683ee2fe88e7cf.png)
2.1.4 third party 模块 enable battery 功能
![](media/1.2.1+设备端环境搭建/524208b2e6abc1f6646aeba14bd59d65.png)
#### 2.2.充电盒配置: {#id-1.2.1设备端环境搭建-2.2.充电盒配置:}
##### 2.2.1 接线设置 {#id-1.2.1设备端环境搭建-2.2.1接线设置}
![](media/1.2.1+设备端环境搭建/2995cee295e29c60b1d5b454ce57ebd0.png)
##### 2.2.2 充电盒操作 {#id-1.2.1设备端环境搭建-2.2.2充电盒操作}
![](media/1.2.1+设备端环境搭建/95b03ee961d34cf393b9e32ceb54e1cd.png)
#### **2.3 Note** {#id-1.2.1设备端环境搭建-2.3Note}
##### 2.3.1 开关盒操作步骤 {#id-1.2.1设备端环境搭建-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的提示音(目前没有打开,可以不需要修改,使用默认配置就好)
![](media/1.2.1+设备端环境搭建/08271864e4343f90c4a3c604c18353f4.png)
watch dog reset的时间改成6s,目前没有设置成6s,使用默认设置3s目前测试看是ok的所以这个也可以不用修改
![](media/1.2.1+设备端环境搭建/bf3b347414521efeed1e046f0f2a279c.png)
##### 2.3.2 HUN显示测试 {#id-1.2.1设备端环境搭建-2.3.2HUN显示测试}
HUN(Heads up notification)显示图如下:
![](media/1.2.1+设备端环境搭建/12993266da101944d424e1511aee4fc6.png)
一次HUN显示成功之后需要先把上次的显示信息清掉,再执行下一次操作:
![](media/1.2.1+设备端环境搭建/65276f35c42f7a8bfcb298a26c2e6f8d.png)
\
##### 2.3.3 demo rcfg 里面有model id信息不可以直接开给客户 {#id-1.2.1设备端环境搭建-2.3.3demorcfg里面有modelid信息不可以直接开给客户}
[GFPS_Left.rcfg](/download/attachments/139180496/GFPS_Left.rcfg?version=1&modificationDate=1636711808317&api=v2){linked-resource-id="205658521" linked-resource-version="1" linked-resource-type="attachment" linked-resource-default-alias="GFPS_Left.rcfg" linked-resource-content-type="application/octet-stream" linked-resource-container-id="139180496" linked-resource-container-version="20"}
[GFPS_Right.rcfg](/download/attachments/139180496/GFPS_Right.rcfg?version=1&modificationDate=1636711808877&api=v2){linked-resource-id="205658522" linked-resource-version="1" linked-resource-type="attachment" linked-resource-default-alias="GFPS_Right.rcfg" linked-resource-content-type="application/octet-stream" linked-resource-container-id="139180496" linked-resource-container-version="20"}
\
\
::::