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

natertech

基本测试主要包括配置检查和BT测试两大部分
& C5 S% W1 p' u配置检查：
. L# @* x9 S/ a% U! N# g8 E  为了进一步确保 porting 没有问题，在测试之前先确认 fw 以及 config 文件是否存在。
! G% \5 T+ q& x2 C  adb shell 到测试平台的根目录，检查测试平台的 vendor/firmware/目录中 rtlxxxx_fw 以及 rtlxxxx_config文件是否存在(xxxx 为 BT Chip 型号)。检查 Release 包中的 rtkbt/下的文件是否都已经安装到对应的目录.
BT 测试：
  本测试是 porting 结束后对 BT 基本和常用功能的一个快速测试，旨在快速验证一些基本问题，不代表BT完整的测试 ， 测试结果也非正式test report 。 如果使用的是非Realtek BT chip ，该项测试可能没有意义。
+ D5 |) ^% L0 l+ N  R5 B6 q, G0 r基本功能测试如下：
  1) 打开/关闭 BT 无失败现象。
3 D6 {6 \8 Q1 |+ i6 b! ~, U  2) 能够搜索到近处 BT 设备。
  3) 和搜索到的蓝牙耳机或其他设备配对。
8 ^% _2 x0 h  e1 c. @  4) 连接上蓝牙耳机，使用 BT A2DP 听音乐(sdcard 确保存在)。
  5) 连接上蓝牙耳机，使用 BT HFP/HSP 打电话(确保用蓝牙时能够正常通话)。
  6) 传输文件到远端支持蓝牙 OPP Server 的设备，从远端支持蓝牙 OPP client 的设备传送文件到本地(sdcard 确保存在)。
/ p+ X8 o! Z% W8 W% y6 b/ K  7) 连接上蓝牙键盘，打开需要输入的应用，通过蓝牙键盘输入。
. G5 h' L! ?/ v5 v
' W8 ~* K* b1 p; `) t; `
) i4 O$ R- `. @. p  当发现蓝牙有问题的时候,需要同时提供对应蓝牙问题报告下面的 log,否则可能会因为 log信息不足无法定位问题.所以请务必学会抓取下列蓝牙 log 的方法.
3 j2 J  {, s0 E' v! c! d# X' M蓝牙 Log 相关的配置文件：
' O2 E. O/ g# A! b/ h  蓝牙相关的配置文件存放在设备的/system/etc/bluetooth/bt_stack.conf .可以通过 adb 方式进行修改.默认的配置文件如下:
1 ]! E* e2 C( d$ {6 P% S    # Enable trace level reconfiguration function
    # Must be present before any TRC_ trace level settings
    TraceConf=true
$ t# Z3 P- N/ ^
1 S2 b& q8 t5 S1 ^# a7 r6 v    # Trace level configuration
    # BT_TRACE_LEVEL_NONE 0 ( No trace messages to be generated )
. ^) _( [& L0 q$ |    # BT_TRACE_LEVEL_ERROR 1 ( Error condition trace messages )
( O/ O0 y/ {. B- q    # BT_TRACE_LEVEL_WARNING 2 ( Warning condition trace messages )
    # BT_TRACE_LEVEL_API 3 ( API traces )
    # BT_TRACE_LEVEL_EVENT 4 ( Debug messages for events )
    # BT_TRACE_LEVEL_DEBUG 5 ( Full debug messages )
4 i) G7 x& ~" r$ d0 ]    # BT_TRACE_LEVEL_VERBOSE 6 ( Verbose messages ) - Currently supported for
TRC_BTAPP only.
    TRC_BTM=2
2 G2 v  _' u+ T! B. W! h$ n    TRC_HCI=2
    TRC_L2CAP=2
1 V2 a) A. _! b( x    TRC_RFCOMM=2
" y4 y+ o( p4 i7 n0 v4 j    TRC_OBEX=2
    TRC_AVCT=2
- _: A" Y# |; C    TRC_AVDT=2
  C' m3 C9 u! b$ {$ _- {    TRC_AVRC=2
    TRC_AVDT_SCB=2
0 M* r+ Q2 }, `& }5 d% w    TRC_AVDT_CCB=2
    TRC_A2D=2
$ q* K1 W3 _9 c$ r' g6 }    TRC_SDP=2
    TRC_GATT=2
    TRC_SMP=2
    TRC_BTAPP=2
7 w' r3 R) G! l0 ]: M5 X3 c    TRC_BTIF=2
) u* S) ^2 Z  g    TRC_GAP=2
' ~( j5 `. Q' d; f$ }, @; F/ M    TRC_BNEP=2
7 d. Z/ p$ r4 @7 A; w    TRC_PAN=2
    TRC_HID_HOST=2
, s3 D3 ^/ S* @! A: `2 W2 l, C  S    TRC_HID_DEV=2


Logcat –v time
  在抓取 log 的时候,必须添加”-v time”选项.否则没法将 log 和出现问题的时间点对应起来,给分析 log 会带来很大的麻烦.
  测试前,可以打开 log 并将 log 导入到设备的某个分区,待测试完成后再通过 adb, sdcard 等方式导出 log.

BtSnoop
  F) D, j) L; p: f# u% S7 }  打开 btsnoop 录制 功能 设置 persist.bluetooth.btsnooplogmode 属 性为 full， 设 置保 存路 径persist.bluetooth.btsnooppath。然后开关一次蓝牙生效.
5 N2 e, g3 t1 g+ s( b  在蓝牙打开时,这个文件会自动被覆盖一次,所以重现到问题后,需要尽快采用 adb 或者 sdcard 将 btsoop文件导出.切勿重新开关蓝牙或者重启设备.

获取 Bluetooth 进程相关信息
! f! e/ Q' s3 D( l( X  输入 adb shell dumpsys bluetooth_manager > xxx.log, 获取 bt 进程相关信息

0 w/ |1 E( Z: G7 u. _8 b* Z( f( P注意事项
  报告蓝牙问题 至少 需要 提供 下列信息:
   logcat –v time
   btsnoop
8 B' ]4 T' I( C+ I   Bluetooth 进程信息
+ A& `) {; x% x, |( @% b  出现问题的时间点( 以设备时间为准)
  重现步骤.


常见问题分析
BT 打开失败(UART)
& Q0 ^& D# S8 h( H/ L5 R  S    打开 H5 UART Driver Log， 使用 logcat 抓取 log，看 H5 SYNC 过程时候成功，如果 H5 SYNC 失败，那么需要首先检查硬件电路是否正确（Power Supply， BT Reset PIN， UART TX/RX，CTS/RTS），然后检查卡片 efuse，用示波器量测 UART 波形，看 Host 是否把数据正确的发送到 Controller。
& Q* ]0 ^" y8 ?. k, I    如果 H5 SYNC 成功，那么下一步就是 Change Baudrate，判断 Change Baudrate 是否成功。如果 Change Baudrate 失败，那么需要确定 Host 是否支持该波特率，config 文件是否正确设定了波特率。
- J0 @7 u0 ?7 `; @4 z& b: I7 |) [) Y" q    如果 Change Baudrate 成功，下一步是下载 fw 以及 config 文件，如果下载完毕之后，收不到 Controller回复的 Command Complete Event，那么需要检查 fw 以及 config 文件是否正确，BT Reset PIN 是否为高电平。
    如果下载 fw 以及 config 文件成功，那么下一步就是根据 config 文件的设定修改 HW Flowcontrol 的设置。设置成功之后，bluedroid stack 会下第一个 HCI Comamnd。
; B* G5 @7 T  B+ k" M    如果第一个 HCI Command 一直 H5 重传，那么说明可能 HW flowcontrol 有问题，需要检查 Host 的UART driver 是否支持 HW Flowcontrol。
/ b" m5 n1 G# t# ?$ z1 s5 D
: p0 Z) h- `- |: s6 J. ~$ kBT 打开失败(USB)
2 z) T' O6 j# |. Y2 l4 T- y- x- [    用 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是不是对应当前使用的蓝牙芯片。如果没有则是没有识别蓝牙卡片，需要首先检查硬件电路是否正确.
4 S# A; n* E7 B+ g    查看 USB 的驱动是否正常加载。登陆到平台里(adb shell)，然后使用命令 lsmod 来查看是否有rtk_btusb.ko 的存在。
$ {. T7 ?2 x" B( a, D, c
0 {) E) a: o" P2 {7 {: r% @以上观点纳拓科技提供,请勿随意复制、编辑转用
1 R* W) f& z& V" z+ M7 i/ W