# 2.2.1 设备端环境搭建

<style type="text/css">/**/
div.rbtoc1777700930417 {padding: 0px;}
div.rbtoc1777700930417 ul {margin-left: 0px;}
div.rbtoc1777700930417 li {margin-left: 0px;padding-left: 0px;}

/**/</style>

<div class="toc-macro rbtoc1777700930417">

- [1 MCUConfigTool 配置](#id-2.2.1设备端环境搭建-1MCUConfigTool配置)
  - [1.1 General 页面 : 不勾选 Enable auto power off, 不勾选 Enable pairing timeout 修改为了便于GFPS测试，GFPS 测试的时候或者是过认证的时候需要修改， 量产时可以考虑不修改。](#id-2.2.1设备端环境搭建-1.1General页面:不勾选Enableautopoweroff,不勾选Enablepairingtimeout修改为了便于GFPS测试，GFPS测试的时候或者是过认证的时候需要修改，量产时可以考虑不修改。)
  - [1.2 General 页面 : Discoverable in standby mode 设置成disable。强制要求必须修改](#id-2.2.1设备端环境搭建-1.2General页面:Discoverableinstandbymode设置成disable。强制要求必须修改)
  - [1.3 General 页面: 勾选 Non-discoverable when linkback 强制要求必须修改](#id-2.2.1设备端环境搭建-1.3General页面:勾选Non-discoverablewhenlinkback强制要求必须修改)
  - [1.4 勾选Multi-link support, 并且不要勾选 Enter pairing state while only available device is connected 强制要求必须修改](#id-2.2.1设备端环境搭建-1.4勾选Multi-linksupport,并且不要勾选Enterpairingstatewhileonlyavailabledeviceisconnected强制要求必须修改)
  - [1.5 Third Party页面配置GFPS参数](#id-2.2.1设备端环境搭建-1.5ThirdParty页面配置GFPS参数)
  - [1.6 配置GFPS findme voice prompt tone](#id-2.2.1设备端环境搭建-1.6配置GFPSfindmevoiceprompttone)
  - [1.7 保存新生成的 APP UI Parameter File 和 System Config File](#id-2.2.1设备端环境搭建-1.7保存新生成的APPUIParameterFile和SystemConfigFile)
  - [1.8 Note](#id-2.2.1设备端环境搭建-1.8Note)
    - [1.建议把BD Address和Device Name也改一下](#id-2.2.1设备端环境搭建-1.建议把BDAddress和DeviceName也改一下)
    - [2.建议Export 生成rcfg之前先导入正确的flash_map.ini](#id-2.2.1设备端环境搭建-2.建议Export生成rcfg之前先导入正确的flash_map.ini)
    - [3.因为设备不支援LEA， LEA相关的配置要务必关掉：](#id-2.2.1设备端环境搭建-3.因为设备不支援LEA，LEA相关的配置要务必关掉：)
- [2 TWS 耳机 GFPS battery feature测试环境搭建(只有TWS耳机需要做GFPS battery测试，single mode 不需要测试)](#id-2.2.1设备端环境搭建-2TWS耳机GFPSbatteryfeature测试环境搭建(只有TWS耳机需要做GFPSbattery测试，singlemode不需要测试))
  - [2.1.mcu config tool 配置：](#id-2.2.1设备端环境搭建-2.1.mcuconfigtool配置：)
    - [2.1.1 HW Feature 模块](#id-2.2.1设备端环境搭建-2.1.1HWFeature模块)
    - [2.1.2 charger 模块，勾选battery detection support](#id-2.2.1设备端环境搭建-2.1.2charger模块，勾选batterydetectionsupport)
    - [2.1.3 general 模块](#id-2.2.1设备端环境搭建-2.1.3general模块)
  - [2.2.充电盒配置：](#id-2.2.1设备端环境搭建-2.2.充电盒配置：)
    - [2.2.1 接线设置](#id-2.2.1设备端环境搭建-2.2.1接线设置)
    - [2.2.2 充电盒操作](#id-2.2.1设备端环境搭建-2.2.2充电盒操作)
  - [2.3 Note](#id-2.2.1设备端环境搭建-2.3Note)
    - [2.3.1 开关盒操作步骤](#id-2.2.1设备端环境搭建-2.3.1开关盒操作步骤)
    - [2.3.2 HUN显示测试](#id-2.2.1设备端环境搭建-2.3.2HUN显示测试)
    - [2.3.3 demo rcfg](#id-2.2.1设备端环境搭建-2.3.3demorcfg)
- [3 Find Hub测试环境搭建：](#id-2.2.1设备端环境搭建-3FindHub测试环境搭建：)
  - [3.1 每一轮测试开始之前耳机端需要做factory reset操作，测试中请不要做factory reset。原因如下：8 手机端清掉配对信息之后，耳机端也要做factory reset，不然finder功能用不起来](#id-2.2.1设备端环境搭建-3.1每一轮测试开始之前耳机端需要做factoryreset操作，测试中请不要做factoryreset。原因如下：)
  - [3.2 finder 所有功能测试完成之后，测试手机归还QC之前，手机端一定要清掉配对信息，不然过段时间再测试的时候可能会有问题，手机log会提示设备已经有owner了，会比较麻烦，建议测试完成之后一定要先把手机端的配对信息全清掉 1 gfps/finder 如何清除配对信息](#id-2.2.1设备端环境搭建-3.2finder所有功能测试完成之后，测试手机归还QC之前，手机端一定要清掉配对信息，不然过段时间再测试的时候可能会有问题，手机log会提示设备已经有owner了，会比较麻烦，建议测试完成之后一定要先把手机端的配对信息全清掉)
  - [3.3 MCU cfg tool中model id和key的信息要换成支持finder 的model id 和key的信息，测试账号必须只能使用某个固定的Google账号，暂时还不可以使用多个Google账号进行测试。](#id-2.2.1设备端环境搭建-3.3MCUcfgtool中modelid和key的信息要换成支持finder的modelid和key的信息，测试账号必须只能使用某个固定的Google账号，暂时还不可以使用多个Google账号进行测试。)
  - [3.4 2024/5/11以后：更新至finder1.3后，需要填写注册model id的时候填写的 ”Company name”, ”Device name” 和 ”Device type”（当前已支持harman T520）](#id-2.2.1设备端环境搭建-3.42024/5/11以后：更新至finder1.3后，需要填写注册modelid的时候填写的”Companyname”,”Devicename”和”Devicetype”（当前已支持harmanT520）)
  - [3.5 .MCU cfg tool 需要配置按键停止响铃功能](#id-2.2.1设备端环境搭建-3.5.MCUcfgtool需要配置按键停止响铃功能)
  - [3.6 Finder adv 需要占用一条BLE link，GFPS adv要占用一条 BLE link, 所以这边LE link number 和 LE slave link number要在原有的基础上+2](#id-2.2.1设备端环境搭建-3.6Finderadv需要占用一条BLElink，GFPSadv要占用一条BLElink,所以这边LElinknumber和LEslavelinknumber要在原有的基础上+2)
  - [3.7 要想让finder响铃，mcu cfg tool 需要配置对应的vp](#id-2.2.1设备端环境搭建-3.7要想让finder响铃，mcucfgtool需要配置对应的vp)
  - [3.8 mcu cfg tool 需要enable finder 功能](#id-2.2.1设备端环境搭建-3.8mcucfgtool需要enablefinder功能)
  - [3.9 2024/5/11： 更新至finder1.3后，KEY配置界面需要配置按键0xBB Dult enter id read state mode](#id-2.2.1设备端环境搭建-3.92024/5/11：更新至finder1.3后，KEY配置界面需要配置按键0xBBDultenteridreadstatemode)
  - [3.10 2024/5/11： 更新至finder1.3后，Ringtone配置页面需要配置GFPS find dult（当前已支持harman T520，该案比较特殊，分为两个响铃：GFPS find dult tone和GFPS find dult vp）](#id-2.2.1设备端环境搭建-3.102024/5/11：更新至finder1.3后，Ringtone配置页面需要配置GFPSfinddult（当前已支持harmanT520，该案比较特殊，分为两个响铃：GFPSfinddulttone和GFPSfinddultvp）)
  - [3.11 如果需要关机之后依然打finder广播需要配置以下信息：](#id-2.2.1设备端环境搭建-3.11如果需要关机之后依然打finder广播需要配置以下信息：)

</div>

### 1  MCUConfigTool 配置

#### 1.1 General 页面 : 不勾选 Enable auto power off, <span style="letter-spacing: -0.003em;">不勾选 Enable pairing timeout </span>修改为了便于GFPS测试，GFPS 测试的时候或者是过认证的时候需要修改， **<span style="color: rgb(255,0,0);">量产时可以考虑不修改。</span>**

![](images/2.2.1+设备端环境搭建_67e885b0.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/2.2.1+设备端环境搭建_c8a58a63.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/2.2.1+设备端环境搭建_629c1520.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_948642484_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/2.2.1+设备端环境搭建_f36d91e4.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/2.2.1+设备端环境搭建_bb98816c.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/2.2.1+设备端环境搭建_b61271af.jpg)

打开MCU config tool开始配置findme tone，

首先refresh一下，让tool能够识别新的wav文件，

然后就可以选择vp tone了，

如下图所示：

![](images/2.2.1+设备端环境搭建_f3b5c168.jpg)

![](images/2.2.1+设备端环境搭建_2106587b.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/2.2.1+设备端环境搭建_59432eff.jpg)

##### 3.因为设备不支援LEA， LEA相关的配置要务必关掉：

![](images/2.2.1+设备端环境搭建_01e20658.jpg)

![](images/2.2.1+设备端环境搭建_b109f957.jpg)

![](images/2.2.1+设备端环境搭建_9df186a7.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/2.2.1+设备端环境搭建_90027c24.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/2.2.1+设备端环境搭建_c2e48143.jpg)

如果充电盒image烧录的是20ms:\
![](images/2.2.1+设备端环境搭建_7d783562.jpg)

勾选power off immediately when chose case和do not auto power off when case not close

![](images/2.2.1+设备端环境搭建_f8873d22.jpg)

##### 2.1.2 charger 模块，勾选battery detection support

![](images/2.2.1+设备端环境搭建_a3e8d5c8.jpg)

![](images/2.2.1+设备端环境搭建_a43bfa78.jpg)

![](images/2.2.1+设备端环境搭建_8a4cb645.jpg)

##### 2.1.3 general 模块

![](images/2.2.1+设备端环境搭建_7c939b1b.jpg)

2.1.4 third party 模块 enable battery 功能

![](images/2.2.1+设备端环境搭建_8806cf01.jpg)

#### 2.2.充电盒配置：

##### 2.2.1 接线设置

![](images/2.2.1+设备端环境搭建_0853bf71.jpg)

##### 2.2.2 充电盒操作

![](images/2.2.1+设备端环境搭建_b1da60c4.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/2.2.1+设备端环境搭建_938e8e81.jpg)

watch dog reset的时间改成6s,目前没有设置成6s,使用默认设置3s，目前测试看是ok的，所以这个也可以不用修改

![](images/2.2.1+设备端环境搭建_c9202c73.jpg)

##### 2.3.2 HUN显示测试

HUN(Heads up notification)显示图如下：

![](images/2.2.1+设备端环境搭建_83cc1a3c.jpg)

一次HUN显示成功之后，需要先把上次的显示信息清掉,再执行下一次操作：

![](images/2.2.1+设备端环境搭建_05cd32ff.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>

### <span style="color: rgb(255,0,0);">**3 Find Hub测试环境搭建：**</span>

#### 3.1 每一轮测试开始之前耳机端需要做factory reset操作，测试中请不要做factory reset。原因如下：[8 手机端清掉配对信息之后，耳机端也要做factory reset，不然finder功能用不起来](/pages/viewpage.action?pageId=350190807)

#### <span style="color: rgb(255,0,0);">3.2 finder 所有功能测试完成之后，测试手机归还QC之前，手机端一定要清掉配对信息，不然过段时间再测试的时候可能会有问题，手机log会提示设备已经有owner了，会比较麻烦，建议测试完成之后一定要先把手机端的配对信息全清掉</span> [1 gfps/finder 如何清除配对信息](/pages/viewpage.action?pageId=401291585)

#### 3.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> [7 TWS耳机-finder-内部测试model id](/pages/viewpage.action?pageId=350177663)：

![](images/2.2.1+设备端环境搭建_176efe17.jpg)

#### 3.4  2024/5/11以后：更新至finder1.3后，需要填写注册model id的时候填写的 ”Company name”, ”Device name” 和 ”Device type”（当前已支持harman T520）

Device type双耳测试选Earphones，单耳测试选Headphones

![](images/2.2.1+设备端环境搭建_6ce7649f.jpg)

#### 3.5 .MCU cfg tool 需要配置按键停止响铃功能

for example:

配置key1接P3_1

![](images/2.2.1+设备端环境搭建_2b17cb35.jpg)

配置key1短按之后触发GFPS finder停止响铃

![](images/2.2.1+设备端环境搭建_cfd2080b.jpg)

开发板上 key1 接到M3_1

![](images/2.2.1+设备端环境搭建_d4c22a9a.jpg)

#### 3.6 Finder adv 需要占用一条BLE link，GFPS adv要占用一条 BLE link, 所以这边LE link number 和 LE slave link number要在原有的基础上+2

![](images/2.2.1+设备端环境搭建_d57f0a59.jpg)

\

#### 3.7 要想让finder响铃，mcu cfg tool 需要配置对应的vp

![](images/2.2.1+设备端环境搭建_da041843.jpg)

\

#### 3.8 mcu cfg tool 需要enable finder 功能

![](images/2.2.1+设备端环境搭建_71a306fa.jpg)

\

#### 3.9 2024/5/11： 更新至finder1.3后，KEY配置界面需要配置按键0xBB Dult enter id read state mode

![](images/2.2.1+设备端环境搭建_6f81602c.jpg)

\

#### 3.10 2024/5/11： 更新至finder1.3后，Ringtone配置页面需要配置GFPS find dult（当前已支持harman T520，该案比较特殊，分为两个响铃：GFPS find dult tone和GFPS find dult vp）

![](images/2.2.1+设备端环境搭建_10721780.jpg)

![](images/2.2.1+设备端环境搭建_bf2c956f.jpg)

\

#### 3.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/2.2.1+设备端环境搭建_ec42890d.jpg)