Realtek蓝牙Android10.0移植结束后的基本测试和常见问题分析

natertech

基本测试主要包括配置检查和BT测试两大部分
配置检查：
/ M3 Z4 U  N, b2 b& R  为了进一步确保 porting 没有问题，在测试之前先确认 fw 以及 config 文件是否存在。
7 q7 }* v- n# |2 D. K# e) h  adb shell 到测试平台的根目录，检查测试平台的 vendor/firmware/目录中 rtlxxxx_fw 以及 rtlxxxx_config文件是否存在(xxxx 为 BT Chip 型号)。检查 Release 包中的 rtkbt/下的文件是否都已经安装到对应的目录.
BT 测试：
  D0 s* o+ v7 ^( T$ J$ m  本测试是 porting 结束后对 BT 基本和常用功能的一个快速测试，旨在快速验证一些基本问题，不代表BT完整的测试 ， 测试结果也非正式test report 。 如果使用的是非Realtek BT chip ，该项测试可能没有意义。
基本功能测试如下：
0 N& m0 H& Q/ c/ W. V! Y( A  1) 打开/关闭 BT 无失败现象。
  2) 能够搜索到近处 BT 设备。
  3) 和搜索到的蓝牙耳机或其他设备配对。
  4) 连接上蓝牙耳机，使用 BT A2DP 听音乐(sdcard 确保存在)。
5 D& I" F. e2 t0 h  5) 连接上蓝牙耳机，使用 BT HFP/HSP 打电话(确保用蓝牙时能够正常通话)。
% d& e: Y/ j: J$ b: I1 v% ^  6) 传输文件到远端支持蓝牙 OPP Server 的设备，从远端支持蓝牙 OPP client 的设备传送文件到本地(sdcard 确保存在)。
  7) 连接上蓝牙键盘，打开需要输入的应用，通过蓝牙键盘输入。
* F# y; R  U9 k5 P$ D5 ]; Y5 A
4 W0 |( L/ s) J, e, }8 z% r! J/ `. t
  当发现蓝牙有问题的时候,需要同时提供对应蓝牙问题报告下面的 log,否则可能会因为 log信息不足无法定位问题.所以请务必学会抓取下列蓝牙 log 的方法.
蓝牙 Log 相关的配置文件：
" Q6 x; X1 t8 _# `9 Y8 M  蓝牙相关的配置文件存放在设备的/system/etc/bluetooth/bt_stack.conf .可以通过 adb 方式进行修改.默认的配置文件如下:
    # Enable trace level reconfiguration function
/ Y$ G" ~9 v% E7 b4 n; E    # Must be present before any TRC_ trace level settings
    TraceConf=true
4 K. v% M0 v" b+ [" h4 m4 L
    # Trace level configuration
    # BT_TRACE_LEVEL_NONE 0 ( No trace messages to be generated )
: B* E4 K/ h9 @0 r  ?* c( `. o    # BT_TRACE_LEVEL_ERROR 1 ( Error condition trace messages )
    # BT_TRACE_LEVEL_WARNING 2 ( Warning condition trace messages )
    # BT_TRACE_LEVEL_API 3 ( API traces )
0 {( h( x4 ~! \4 K- z7 |4 n+ D    # BT_TRACE_LEVEL_EVENT 4 ( Debug messages for events )
    # BT_TRACE_LEVEL_DEBUG 5 ( Full debug messages )
' L  s* B' V1 R' j    # BT_TRACE_LEVEL_VERBOSE 6 ( Verbose messages ) - Currently supported for
TRC_BTAPP only.
    TRC_BTM=2
    TRC_HCI=2
    TRC_L2CAP=2
    TRC_RFCOMM=2
* @  D  D6 t/ E* R3 X    TRC_OBEX=2
    TRC_AVCT=2
    TRC_AVDT=2
    TRC_AVRC=2
    TRC_AVDT_SCB=2
. B3 Q3 d/ t2 X1 C: ~+ P' w$ a    TRC_AVDT_CCB=2
& Q, o  k5 G5 x% Z# r* B0 D" ?' w    TRC_A2D=2
4 R, R8 }+ b  _/ w6 v    TRC_SDP=2
    TRC_GATT=2
    TRC_SMP=2
    TRC_BTAPP=2
2 z! [2 ?- @, a/ b8 B, N" b    TRC_BTIF=2
    TRC_GAP=2
9 l6 E* j3 |  v  S) Y0 P: ^) S    TRC_BNEP=2
8 p" {/ L& w, @% x: H3 m    TRC_PAN=2
7 s0 L2 m) J2 `    TRC_HID_HOST=2
    TRC_HID_DEV=2
( L) H5 b2 k$ v5 K; B4 T, F6 D

' T8 r% r9 Y' i& I: \: iLogcat –v time
  在抓取 log 的时候,必须添加”-v time”选项.否则没法将 log 和出现问题的时间点对应起来,给分析 log 会带来很大的麻烦.
) o. O: j' F% H4 ~  测试前,可以打开 log 并将 log 导入到设备的某个分区,待测试完成后再通过 adb, sdcard 等方式导出 log.

BtSnoop
  打开 btsnoop 录制 功能 设置 persist.bluetooth.btsnooplogmode 属 性为 full， 设 置保 存路 径persist.bluetooth.btsnooppath。然后开关一次蓝牙生效.
  在蓝牙打开时,这个文件会自动被覆盖一次,所以重现到问题后,需要尽快采用 adb 或者 sdcard 将 btsoop文件导出.切勿重新开关蓝牙或者重启设备.
) H* d% T% L  R! Q! `' j
0 V3 A' ~6 U2 D! F5 f, G1 A获取 Bluetooth 进程相关信息
7 }3 w4 Z$ o5 h/ y$ G! a& q  输入 adb shell dumpsys bluetooth_manager > xxx.log, 获取 bt 进程相关信息

注意事项
  报告蓝牙问题 至少 需要 提供 下列信息:
. j6 `) W: Q9 D' H) K- R, I5 k* z   logcat –v time
   btsnoop
3 U. _0 P( Y- s1 T( n/ l   Bluetooth 进程信息
1 F8 Y4 M/ G' k4 o  出现问题的时间点( 以设备时间为准)
  重现步骤.


常见问题分析
' r4 a$ {+ k5 [# t8 `BT 打开失败(UART)
    打开 H5 UART Driver Log， 使用 logcat 抓取 log，看 H5 SYNC 过程时候成功，如果 H5 SYNC 失败，那么需要首先检查硬件电路是否正确（Power Supply， BT Reset PIN， UART TX/RX，CTS/RTS），然后检查卡片 efuse，用示波器量测 UART 波形，看 Host 是否把数据正确的发送到 Controller。
- u- L! E3 z- E+ \+ P    如果 H5 SYNC 成功，那么下一步就是 Change Baudrate，判断 Change Baudrate 是否成功。如果 Change Baudrate 失败，那么需要确定 Host 是否支持该波特率，config 文件是否正确设定了波特率。
& R4 }! y; N, Y" J    如果 Change Baudrate 成功，下一步是下载 fw 以及 config 文件，如果下载完毕之后，收不到 Controller回复的 Command Complete Event，那么需要检查 fw 以及 config 文件是否正确，BT Reset PIN 是否为高电平。
* q3 T7 ], N# m* T$ `  K' g    如果下载 fw 以及 config 文件成功，那么下一步就是根据 config 文件的设定修改 HW Flowcontrol 的设置。设置成功之后，bluedroid stack 会下第一个 HCI Comamnd。
    如果第一个 HCI Command 一直 H5 重传，那么说明可能 HW flowcontrol 有问题，需要检查 Host 的UART driver 是否支持 HW Flowcontrol。

7 S& J2 W& `* H) fBT 打开失败(USB)
    用 logcat 抓取打开蓝牙打开的 log，搜索“dev/bus/usb”字样看是否有这样的 log：Added device UsbDevice[mName=/dev/bus/usb/002/002,mVendorId=3034,mProductId=46880,mClass=239,mSubclass=2. 如果有，检查下 mVendorId和mProductId是不是对应当前使用的蓝牙芯片。如果没有则是没有识别蓝牙卡片，需要首先检查硬件电路是否正确.
    查看 USB 的驱动是否正常加载。登陆到平台里(adb shell)，然后使用命令 lsmod 来查看是否有rtk_btusb.ko 的存在。
* e- E% }: B7 r" R1 K0 g
/ z" t3 a9 {. J5 l$ T' N以上观点纳拓科技提供,请勿随意复制、编辑转用
+ n: `* S5 R- {