first commit

This commit is contained in:
魏风
2026-05-01 10:06:36 +08:00
commit e29d75e367
129 changed files with 1485 additions and 0 deletions

View File

@@ -0,0 +1,230 @@
# 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"}
\
\
::::