Para verificar y depurar la pila de Bluetooth, utilice las herramientas proporcionadas en AOSP y las pruebas del Grupo de interés especial (SIG) de Bluetooth.
Pruebas y verificación
Para probar la pila de Bluetooth, AOSP proporciona una combinación de pruebas unitarias, pruebas CTS y herramientas para Bluetooth Profile Tuning Suite.
Pruebas unitarias en AOSP
AOSP incluye pruebas funcionales y unitarias para la pila Bluetooth predeterminada. Estas pruebas se encuentran en /packages/modules/Bluetooth/system/test/ . Para ejecutar las pruebas de AOSP, haga lo siguiente:
- Detenga el tiempo de ejecución de Android:
adb shell stop
- Desde el directorio de prueba, ejecute el archivo ejecutable del shell e incluya opciones si desea ejecutar una prueba o un conjunto de pruebas específico:
./run_unit_tests.sh TEST_GROUP_NAME TEST_NAME OPTIONS
- Cuando finalicen las pruebas, vuelva a habilitar el tiempo de ejecución de Android:
adb shell start
La lista de nombres de pruebas se puede encontrar en /packages/modules/Bluetooth/system/test/README.md .
Conjunto de pruebas de comunicaciones de Android
Android Comms Test Suite (ACTS) realiza pruebas automatizadas de pilas de conectividad, como Wi-Fi, Bluetooth y servicios móviles. La herramienta de prueba requiere adb y python, y se puede encontrar en tools/test/connectivity/acts .
Las pruebas ACTS para Bluetooth y Bluetooth Low Energy se encuentran en tools/test/connectivity/acts_tests/tests/google/bt/ y tools/test/connectivity/acts_tests/tests/google/ble/ respectivamente.
Suite de ajuste de perfiles
Bluetooth SIG proporciona Bluetooth Profile Tuning Suite (PTS), una herramienta de prueba para la interoperabilidad de protocolos y perfiles. Para obtener más información, consulte el sitio de Bluetooth Profile Tuning Suite .
AOSP proporciona herramientas adicionales para complementar el PTS Bluetooth. Estas herramientas se encuentran en tools/test/connectivity/acts_tests/tests/google/bt/pts/ .
Pruebas CTS
El conjunto de pruebas de compatibilidad (CTS) incluye pruebas para la pila de Bluetooth. Estos se encuentran en cts/apps/CtsVerifier/src/com/android/cts/verifier/bluetooth .
Opciones de depuración
AOSP proporciona diferentes métodos para depurar la pila Bluetooth de un dispositivo, incluidos registros e informes de errores. Es posible que estos métodos no funcionen para problemas que no se pueden reproducir o para problemas de audio, que pueden verse afectados por varias partes de la plataforma y el dispositivo.
Depuración con informes de errores
Para verificar el estado del servicio Bluetooth usando dumpsys , use el siguiente comando:
adb shell dumpsys bluetooth_manager
De forma predeterminada, todos los mensajes de registro son de nivel de seguimiento 2. Para obtener más información sobre los niveles de registro y cambiar los niveles de registro para diferentes perfiles, consulte system/bt/conf/bt_stack.conf .
Para extraer registros de snoop del informe de error, utilice el script btsnooz .
- Obtener
btsnooz.py. - Extraiga la versión de texto del informe de error.
- Ejecute
btsnooz.pyen la versión de texto del informe de error:btsnooz.py BUG_REPORT.txt > BTSNOOP.log
Depuración con registros
En Android 4.4 y versiones posteriores, puede recopilar manualmente registros de BTSnoop, que se asemejan al formato de snoop en RFC 1761. Estos registros capturan los paquetes de la interfaz del controlador de host (HCI). Para la mayoría de los dispositivos Android, los registros se almacenan en data/misc/bluetooth/logs .
Por razones de privacidad, BTSnoop siempre activo y "en memoria" solo registra información y eventos no personales. Para registrar todos los datos, el usuario debe habilitar el rastreo de HCI de Bluetooth haciendo lo siguiente:
- Habilite las opciones de desarrollador en el dispositivo.
- En el menú de opciones de desarrollador , active la opción Habilitar registro de vigilancia HCI de Bluetooth .
- Reinicie Bluetooth para que el registro surta efecto.