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

3.2.1 设备端环境搭建

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

• 1 MCUConfigTool 配置
  • 1.1 General 页面 : 不勾选 Enable auto power off, 不勾选 Enable pairing timeout
  • 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
• 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 GFPS LEA 环境搭建
  • 1. enbale lea 以及disconnect enter lea pairing mode
  • 2.配置stack相关参数
    • EATT 暂时设置成 Disable
    • Enable GATT Caching
  • 3.配置GFPS参数
  • 4.配置ringtone
  • 5. 配置按键进入pairing mode
  • 6 配置按键退出pairing mode
  • 7 配置GFPS LEA pairing mode 提示音

1  MCUConfigTool 配置

1.1 General 页面 : 不勾选 Enable auto power off, 不勾选 Enable pairing timeout

Note:

修改为了便于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

\

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 GFPS LEA 环境搭建

1. enbale lea 以及disconnect enter lea pairing mode

2.配置stack相关参数

EATT 暂时设置成 Disable

LE link 设置：

Enable GATT Caching

\

3.配置GFPS参数

\

GFPS device mode 设置成 Dual mode device with CSIP (这边取名字为CSIP取的有点问题，实际是想声明是否支援LE audio, 后面会请tool 帮忙把CSIP 改成LE audio)，

如果找不到  Dual mode device with CSIP  应该是 新的 mcu cfg tool 有改名字将 CSIP 统一改成 LE audio了， tool上可以设置成 Dual mode device with LE audio

[BTSOCTOOL-5234] GFPS页面CSIP改成LE audio - Jira

\

4.配置ringtone

\

\

5. 配置按键进入pairing mode

将key1设置成 GFPS LEA enter pair mode(0xB9),  作为GFPS le audio 按键强制进入pairing mode 的MMI，

有的客户不想多配置一个按键，想要复用 legacy 进Pairing mode的mmi, 那么key1也可以配置成 MMI(0x6C)

\

或者是

单击key1 GFPS LE audio 会强制进入pairing mode

手机弹窗出来之后， 配对 GFPS LE audio,

正常配对成功之后会直接退出pairing mode，

如果按键进入pairing mode 之后，手机端一直没有配对耳机，那耳机会一直处于pairing mode，需要配置按键退出pairing mode。

例如：

6 配置按键退出pairing mode

或者是

\

7 配置GFPS LEA pairing mode 提示音

\