gfps/2.2.1+设备端环境搭建.md

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>

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

1  MCUConfigTool 配置

1.1 General 页面 : 不勾选 Enable auto power off, 不勾选 Enable pairing timeout 修改为了便于GFPS测试，GFPS 测试的时候或者是过认证的时候需要修改， 量产时可以考虑不修改。

1.2 General 页面 : Discoverable in standby mode 设置成disable。强制要求必须修改

Note:

GFPS 耳机第一次和一只手机配对成功之后(initial pairing 成功)，就会进入 subsequent pairing mode。

所以initial pairing 成功之后，不管耳机是进入idle mode 还是进入connectable mode(multilink 支持)，都不应该再设置成discoverable。

1.3  General 页面: 勾选 Non-discoverable when linkback 强制要求必须修改

linkback模式下DUT不应该discoverable，不然手机端会一直弹配对窗口。   

\

1.4 勾选Multi-link support, 并且不要勾选 Enter pairing state while only available device is connected  强制要求必须修改

下面红框里的**不可以勾选  **不然battery HUN测试可能测不过， BBPRO2BUG-21515 - Getting issue details... STATUS

1.5 Third Party页面配置GFPS参数

在Third Party页面配置GFPS参数，详细信息参考 mcu cfg tool中 GFPS 各配置项的含义 - BT_Market - WIKI

下面是RTK已通过认证的Module ID

认证结果及认证通过的model_id 和key

1.6 配置GFPS findme voice prompt tone

gfps_findme.wav

自行选择wav文件作为findme vp tone，

wav文件名称可以自行修改，放入MCU config tool vp目录，

建议findme的wav文件可以播放久一些，这样才能达到提示的效果。

如下图所示：

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

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

然后就可以选择vp tone了，

如下图所示：

1.7 保存新生成的 APP UI Parameter File 和 System Config File

1.8 Note

1.建议把BD Address和Device Name也改一下

2.建议Export 生成rcfg之前先导入正确的flash_map.ini

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

2 TWS 耳机 GFPS battery feature测试环境搭建(只有TWS耳机需要做GFPS battery测试，single mode 不需要测试)

Note：

测试battery的时候需要搭配充电盒

2.1.mcu config tool 配置：

2.1.1 HW Feature 模块

       勾选Charger功能：

勾选支持充电盒功能，注意如果充电盒image烧录的是20ms,下面红色框中的40ms也要改成20ms,这个要和充电盒image匹配的。

如果充电盒image 烧录的是40ms：

如果充电盒image烧录的是20ms:

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

2.1.2 charger 模块，勾选battery detection support

2.1.3 general 模块

2.1.4 third party 模块 enable battery 功能

2.2.充电盒配置：

2.2.1 接线设置

2.2.2 充电盒操作

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的提示音(目前没有打开，可以不需要修改，使用默认配置就好)

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

2.3.2 HUN显示测试

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

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

\

2.3.3 demo rcfg

GFPS_Left.rcfg

GFPS_Right.rcfg

3 Find Hub测试环境搭建：

3.1 每一轮测试开始之前耳机端需要做factory reset操作，测试中请不要做factory reset。原因如下：8 手机端清掉配对信息之后，耳机端也要做factory reset，不然finder功能用不起来

3.2 finder 所有功能测试完成之后，测试手机归还QC之前，手机端一定要清掉配对信息，不然过段时间再测试的时候可能会有问题，手机log会提示设备已经有owner了，会比较麻烦，建议测试完成之后一定要先把手机端的配对信息全清掉 1 gfps/finder 如何清除配对信息

3.3 MCU cfg tool中model id和key的信息要换成支持finder 的model id 和key的信息，测试账号必须只能使用某个固定的Google账号，暂时还不可以使用多个Google账号进行测试。

 内部测试model id 和Company name, Device name 和 Device type 请参考 7 TWS耳机-finder-内部测试model id：

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

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

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

for example:

配置key1接P3_1

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

开发板上 key1 接到M3_1

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

\

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

\

3.8 mcu cfg tool 需要enable finder 功能

\

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

\

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

\

3.11 如果需要关机之后依然打finder广播需要配置以下信息：

详细信息可以参考mcu cfg tool中 GFPS 各配置项的含义 - BT_Market - WIKI 中的: ”9. GFPS Finder相关配置信息描述”