# 4.2.1 设备端环境搭建
- [1 MCUConfigTool 配置](#id-4.2.1设备端环境搭建-1MCUConfigTool配置) - [1.1 General 页面 : 不勾选 Enable auto power off, 不勾选 Enable pairing timeout](#id-4.2.1设备端环境搭建-1.1General页面:不勾选Enableautopoweroff,不勾选Enablepairingtimeout) - [1.2 General 页面 : Discoverable in standby mode 设置成disable。强制要求必须修改](#id-4.2.1设备端环境搭建-1.2General页面:Discoverableinstandbymode设置成disable。强制要求必须修改) - [1.3 General 页面: 勾选 Non-discoverable when linkback 强制要求必须修改](#id-4.2.1设备端环境搭建-1.3General页面:勾选Non-discoverablewhenlinkback强制要求必须修改) - [1.4 勾选Multi-link support, 并且不要勾选 Enter pairing state while only available device is connected 强制要求必须修改](#id-4.2.1设备端环境搭建-1.4勾选Multi-linksupport,并且不要勾选Enterpairingstatewhileonlyavailabledeviceisconnected强制要求必须修改) - [1.5 Third Party页面配置GFPS参数](#id-4.2.1设备端环境搭建-1.5ThirdParty页面配置GFPS参数) - [1.6 配置GFPS findme voice prompt tone](#id-4.2.1设备端环境搭建-1.6配置GFPSfindmevoiceprompttone) - [1.7 保存新生成的 APP UI Parameter File 和 System Config File](#id-4.2.1设备端环境搭建-1.7保存新生成的APPUIParameterFile和SystemConfigFile) - [1.8 Note](#id-4.2.1设备端环境搭建-1.8Note) - [2 TWS 耳机 GFPS battery feature测试环境搭建(只有TWS耳机需要做GFPS battery测试,single mode 不需要测试)](#id-4.2.1设备端环境搭建-2TWS耳机GFPSbatteryfeature测试环境搭建(只有TWS耳机需要做GFPSbattery测试,singlemode不需要测试)) - [2.1.mcu config tool 配置:](#id-4.2.1设备端环境搭建-2.1.mcuconfigtool配置:) - [2.1.1 HW Feature 模块](#id-4.2.1设备端环境搭建-2.1.1HWFeature模块) - [2.1.2 charger 模块,勾选battery detection support](#id-4.2.1设备端环境搭建-2.1.2charger模块,勾选batterydetectionsupport) - [2.1.3 general 模块](#id-4.2.1设备端环境搭建-2.1.3general模块) - [2.2.充电盒配置:](#id-4.2.1设备端环境搭建-2.2.充电盒配置:) - [2.2.1 接线设置](#id-4.2.1设备端环境搭建-2.2.1接线设置) - [2.2.2 充电盒操作](#id-4.2.1设备端环境搭建-2.2.2充电盒操作) - [2.3 Note](#id-4.2.1设备端环境搭建-2.3Note) - [2.3.1 开关盒操作步骤](#id-4.2.1设备端环境搭建-2.3.1开关盒操作步骤) - [2.3.2 HUN显示测试](#id-4.2.1设备端环境搭建-2.3.2HUN显示测试) - [2.3.3 demo rcfg](#id-4.2.1设备端环境搭建-2.3.3demorcfg) - [3 GFPS LEA 环境搭建](#id-4.2.1设备端环境搭建-3GFPSLEA环境搭建) - [1. enbale lea 以及disconnect enter lea pairing mode](#id-4.2.1设备端环境搭建-1.enbalelea以及disconnectenterleapairingmode) - [2.配置stack相关参数](#id-4.2.1设备端环境搭建-2.配置stack相关参数) - [EATT 暂时设置成 Disable](#id-4.2.1设备端环境搭建-EATT暂时设置成Disable) - [Enable GATT Caching](#id-4.2.1设备端环境搭建-EnableGATTCaching) - [3.配置GFPS参数](#id-4.2.1设备端环境搭建-3.配置GFPS参数) - [4.配置ringtone](#id-4.2.1设备端环境搭建-4.配置ringtone) - [5. 配置按键进入pairing mode](#id-4.2.1设备端环境搭建-5.配置按键进入pairingmode) - [6 配置按键退出pairing mode](#id-4.2.1设备端环境搭建-6配置按键退出pairingmode) - [7 配置GFPS LEA pairing mode 提示音](#id-4.2.1设备端环境搭建-7配置GFPSLEApairingmode提示音) - [4 Find Hub测试环境搭建:](#id-4.2.1设备端环境搭建-4FindHub测试环境搭建:) - [4.1 每一轮测试开始之前耳机端需要做factory reset操作,测试中请不要做factory reset。原因如下:8 手机端清掉配对信息之后,耳机端也要做factory reset,不然finder功能用不起来](#id-4.2.1设备端环境搭建-4.1每一轮测试开始之前耳机端需要做factoryreset操作,测试中请不要做factoryreset。原因如下:) - [4.2 finder 所有功能测试完成之后,测试手机归还QC之前,手机端一定要清掉配对信息,不然过段时间再测试的时候可能会有问题,手机log会提示设备已经有owner了,会比较麻烦,建议测试完成之后一定要先把手机端的配对信息全清掉 1 gfps/finder 如何清除配对信息](#id-4.2.1设备端环境搭建-4.2finder所有功能测试完成之后,测试手机归还QC之前,手机端一定要清掉配对信息,不然过段时间再测试的时候可能会有问题,手机log会提示设备已经有owner了,会比较麻烦,建议测试完成之后一定要先把手机端的配对信息全清掉) - [4.3 MCU cfg tool中model id和key的信息要换成支持finder 的model id 和key的信息,测试账号必须只能使用某个固定的Google账号,暂时还不可以使用多个Google账号进行测试。](#id-4.2.1设备端环境搭建-4.3MCUcfgtool中modelid和key的信息要换成支持finder的modelid和key的信息,测试账号必须只能使用某个固定的Google账号,暂时还不可以使用多个Google账号进行测试。) - [4.4 2024/5/11以后:更新至finder1.3后,需要填写注册model id的时候填写的 ”Company name”, ”Device name” 和 ”Device type”(当前已支持harman T520)](#id-4.2.1设备端环境搭建-4.42024/5/11以后:更新至finder1.3后,需要填写注册modelid的时候填写的”Companyname”,”Devicename”和”Devicetype”(当前已支持harmanT520)) - [4.5 .MCU cfg tool 需要配置按键停止响铃功能](#id-4.2.1设备端环境搭建-4.5.MCUcfgtool需要配置按键停止响铃功能) - [4.6 Finder adv 需要占用一条BLE link,GFPS adv要占用一条 BLE link, 所以这边LE link number 和 LE slave link number要在原有的基础上+2](#id-4.2.1设备端环境搭建-4.6Finderadv需要占用一条BLElink,GFPSadv要占用一条BLElink,所以这边LElinknumber和LEslavelinknumber要在原有的基础上+2) - [4.7 要想让finder响铃,mcu cfg tool 需要配置对应的vp](#id-4.2.1设备端环境搭建-4.7要想让finder响铃,mcucfgtool需要配置对应的vp) - [4.8 mcu cfg tool 需要enable finder 功能](#id-4.2.1设备端环境搭建-4.8mcucfgtool需要enablefinder功能) - [4.9 2024/5/11: 更新至finder1.3后,KEY配置界面需要配置按键0xBB Dult enter id read state mode](#id-4.2.1设备端环境搭建-4.92024/5/11:更新至finder1.3后,KEY配置界面需要配置按键0xBBDultenteridreadstatemode) - [4.10 2024/5/11: 更新至finder1.3后,Ringtone配置页面需要配置GFPS find dult(当前已支持harman T520,该案比较特殊,分为两个响铃:GFPS find dult tone和GFPS find dult vp)](#id-4.2.1设备端环境搭建-4.102024/5/11:更新至finder1.3后,Ringtone配置页面需要配置GFPSfinddult(当前已支持harmanT520,该案比较特殊,分为两个响铃:GFPSfinddulttone和GFPSfinddultvp)) - [4.11 如果需要关机之后依然打finder广播需要配置以下信息:](#id-4.2.1设备端环境搭建-4.11如果需要关机之后依然打finder广播需要配置以下信息:)
### 1  MCUConfigTool 配置 #### 1.1 General 页面 : 不勾选 Enable auto power off, 不勾选 Enable pairing timeout **Note**: 修改为了便于GFPS测试,GFPS 测试的时候或者是过认证的时候需要修改, **量产时可以考虑不修改。** ![](images/4.2.1+设备端环境搭建_7d303d1e.jpg) #### 1.2 General 页面 : Discoverable in standby mode 设置成disable。**强制要求必须修改** **Note**: GFPS 耳机第一次和一只手机配对成功之后(initial pairing 成功),就会进入 subsequent pairing mode。 所以initial pairing 成功之后,不管耳机是进入idle mode 还是进入connectable mode(multilink 支持),都不应该再设置成discoverable。 ![](images/4.2.1+设备端环境搭建_869d0296.jpg) #### 1.3  General 页面: 勾选 Non-discoverable when linkback **强制要求必须修改** linkback模式下DUT不应该discoverable,不然手机端会一直弹配对窗口。    \ ![](images/4.2.1+设备端环境搭建_53168a6d.jpg) #### 1.4 勾选Multi-link support, 并且不要勾选 Enter pairing state while only available device is connected  **强制要求必须修改** 下面红框里的**不可以勾选  **不然battery HUN测试可能测不过, ** BBPRO2BUG-21515 - Getting issue details... STATUS ** ![](images/4.2.1+设备端环境搭建_bc3b00b1.jpg) #### 1.5 Third Party页面配置GFPS参数 在Third Party页面配置GFPS参数,详细信息参考 mcu cfg tool中 GFPS 各配置项的含义 - BT_Market - WIKI ![](images/4.2.1+设备端环境搭建_40c8edaf.jpg) 下面是RTK已通过认证的Module ID [认证结果及认证通过的model_id 和key](/pages/viewpage.action?pageId=204620689) #### 1.6 配置GFPS findme voice prompt tone gfps_findme.wav 自行选择wav文件作为findme vp tone, wav文件名称可以自行修改,放入MCU config tool vp目录, 建议findme的wav文件可以播放久一些,这样才能达到提示的效果。 如下图所示: ![](images/4.2.1+设备端环境搭建_c508659a.jpg) 打开MCU config tool开始配置findme tone, 首先refresh一下,让tool能够识别新的wav文件, 然后就可以选择vp tone了, 如下图所示: ![](images/4.2.1+设备端环境搭建_092e3d72.jpg) ![](images/4.2.1+设备端环境搭建_bc878acc.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/4.2.1+设备端环境搭建_6525469f.jpg) \ ### 2 TWS 耳机 GFPS battery feature测试环境搭建(只有TWS耳机需要做GFPS battery测试,single mode 不需要测试) Note: 测试battery的时候需要搭配充电盒 #### 2.1.mcu config tool 配置: ##### 2.1.1 HW Feature 模块        勾选Charger功能: ![](images/4.2.1+设备端环境搭建_87769b03.jpg) 勾选支持充电盒功能,注意如果充电盒image烧录的是20ms,下面红色框中的40ms也要改成20ms,这个要和充电盒image匹配的。 如果充电盒image 烧录的是40ms: ![](images/4.2.1+设备端环境搭建_f1c0de5a.jpg) 如果充电盒image烧录的是20ms:\ ![](images/4.2.1+设备端环境搭建_2661c85e.jpg) 勾选power off immediately when chose case和do not auto power off when case not close ![](images/4.2.1+设备端环境搭建_67e707a6.jpg) ##### 2.1.2 charger 模块,勾选battery detection support ![](images/4.2.1+设备端环境搭建_de3a321d.jpg) ![](images/4.2.1+设备端环境搭建_657171c9.jpg) ![](images/4.2.1+设备端环境搭建_277c9ade.jpg) ##### 2.1.3 general 模块 ![](images/4.2.1+设备端环境搭建_37f0f310.jpg) 2.1.4 third party 模块 enable battery 功能 ![](images/4.2.1+设备端环境搭建_daa28fc5.jpg) #### 2.2.充电盒配置: ##### 2.2.1 接线设置 ![](images/4.2.1+设备端环境搭建_c1e6411a.jpg) ##### 2.2.2 充电盒操作 ![](images/4.2.1+设备端环境搭建_12a454dc.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/4.2.1+设备端环境搭建_e2a1ba95.jpg) watch dog reset的时间改成6s,目前没有设置成6s,使用默认设置3s,目前测试看是ok的,所以这个也可以不用修改 ![](images/4.2.1+设备端环境搭建_29595b73.jpg) ##### 2.3.2 HUN显示测试 HUN(Heads up notification)显示图如下: ![](images/4.2.1+设备端环境搭建_d7b10852.jpg) 一次HUN显示成功之后,需要先把上次的显示信息清掉,再执行下一次操作: ![](images/4.2.1+设备端环境搭建_a13f6bf9.jpg) \ ##### 2.3.3 demo rcfg GFPS_Left.rcfg GFPS_Right.rcfg \ ### 3 GFPS LEA 环境搭建 #### 1. enbale lea 以及disconnect enter lea pairing mode ![](images/4.2.1+设备端环境搭建_2bfda4dc.jpg) ![](images/4.2.1+设备端环境搭建_4f416667.jpg) #### 2.配置stack相关参数 ##### EATT 暂时设置成 Disable ![](images/4.2.1+设备端环境搭建_2273ec86.jpg) ##### Enable GATT Caching ![](images/4.2.1+设备端环境搭建_5a2ce1eb.jpg) \ #### 3.配置GFPS参数 ![](images/4.2.1+设备端环境搭建_d66a2a36.jpg) \ 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 ![](images/4.2.1+设备端环境搭建_69767f92.jpg) \ #### 4.配置ringtone ![](images/4.2.1+设备端环境搭建_1fe878fc.jpg) ![](images/4.2.1+设备端环境搭建_bc1bffaa.jpg) \ ![](images/4.2.1+设备端环境搭建_c3a321fa.jpg) \ #### 5. 配置按键进入pairing mode 将key1设置成 GFPS LEA enter pair mode(0xB9),  作为GFPS le audio 按键强制进入pairing mode 的MMI, 有的客户不想多配置一个按键,想要复用 legacy 进Pairing mode的mmi, 那么key1也可以配置成 MMI(0x6C) \ ![](images/4.2.1+设备端环境搭建_782bf5a8.jpg) 或者是 ![](images/4.2.1+设备端环境搭建_21049149.jpg) 单击key1 GFPS LE audio 会强制进入pairing mode 手机弹窗出来之后, 配对 GFPS LE audio, 正常配对成功之后会直接退出pairing mode, 如果按键进入pairing mode 之后,手机端一直没有配对耳机,那耳机会一直处于pairing mode,需要配置按键退出pairing mode。 例如: #### 6 配置按键退出pairing mode ![](images/4.2.1+设备端环境搭建_7e46e028.jpg) 或者是 ![](images/4.2.1+设备端环境搭建_2b7172d2.jpg) \ #### 7 配置GFPS LEA pairing mode 提示音 ![](images/4.2.1+设备端环境搭建_869640cf.jpg) \ ### **4 Find Hub测试环境搭建:** #### 4.1 每一轮测试开始之前耳机端需要做factory reset操作,测试中请不要做factory reset。原因如下:[8 手机端清掉配对信息之后,耳机端也要做factory reset,不然finder功能用不起来](/pages/viewpage.action?pageId=350190807) #### 4.2 finder 所有功能测试完成之后,测试手机归还QC之前,手机端一定要清掉配对信息,不然过段时间再测试的时候可能会有问题,手机log会提示设备已经有owner了,会比较麻烦,建议测试完成之后一定要先把手机端的配对信息全清掉 [1 gfps/finder 如何清除配对信息](/pages/viewpage.action?pageId=401291585) #### 4.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](/pages/viewpage.action?pageId=350177663): ![](images/4.2.1+设备端环境搭建_f4478dff.jpg) #### 4.4  2024/5/11以后:更新至finder1.3后,需要填写注册model id的时候填写的 ”Company name”, ”Device name” 和 ”Device type”(当前已支持harman T520) Device type双耳测试选Earphones,单耳测试选Headphones ![](images/4.2.1+设备端环境搭建_21438ec8.jpg) #### 4.5 .MCU cfg tool 需要配置按键停止响铃功能 for example: 配置key1接P3_1 ![](images/4.2.1+设备端环境搭建_d79f274b.jpg) 配置key1短按之后触发GFPS finder停止响铃 ![](images/4.2.1+设备端环境搭建_c26d7866.jpg) 开发板上 key1 接到M3_1 ![](images/4.2.1+设备端环境搭建_5dacbbf4.jpg) #### 4.6 Finder adv 需要占用一条BLE link,GFPS adv要占用一条 BLE link, 所以这边LE link number 和 LE slave link number要在原有的基础上+2 ![](images/4.2.1+设备端环境搭建_7c1d7150.jpg) \ #### 4.7 要想让finder响铃,mcu cfg tool 需要配置对应的vp ![](images/4.2.1+设备端环境搭建_c235cac6.jpg) \ #### 4.8 mcu cfg tool 需要enable finder 功能 ![](images/4.2.1+设备端环境搭建_cf14d853.jpg) \ #### 4.9 2024/5/11: 更新至finder1.3后,KEY配置界面需要配置按键0xBB Dult enter id read state mode ![](images/4.2.1+设备端环境搭建_87ebb23b.jpg) \ #### 4.10 2024/5/11: 更新至finder1.3后,Ringtone配置页面需要配置GFPS find dult(当前已支持harman T520,该案比较特殊,分为两个响铃:GFPS find dult tone和GFPS find dult vp) ![](images/4.2.1+设备端环境搭建_37be2cae.jpg) ![](images/4.2.1+设备端环境搭建_7901d0db.jpg) \ #### 4.11 如果需要关机之后依然打finder广播需要配置以下信息: 详细信息可以参考mcu cfg tool中 GFPS 各配置项的含义 - BT_Market - WIKI 中的: ”9. GFPS Finder相关配置信息描述” ![](images/4.2.1+设备端环境搭建_ff68cd25.jpg) \ \