Para verificar y depurar la pila de Bluetooth, use las herramientas proporcionadas en AOSP y las pruebas del Grupo de interés especial (SIG) de Bluetooth.
Probando y verificando
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 AOSP, haga lo siguiente:
- Detener el tiempo de ejecución de Android:
adb shell stop
- Desde el directorio de prueba, ejecute el archivo ejecutable de shell e incluya opciones si desea ejecutar una prueba específica o un conjunto de pruebas:
./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 prueba se puede encontrar en el archivo /packages/modules/Bluetooth/system/test/run_unit_tests.sh
.
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 celulares. 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 perfil
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 Bluetooth PTS. 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 de 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 múltiples 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 manera 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, busque en system/bt/conf/bt_stack.conf
.
Para extraer registros de snoop del informe de errores, use el script btsnooz
.
- Obtén
btsnooz.py
. - Extraiga la versión de texto del informe de error.
- Ejecute
btsnooz.py
en la versión de texto del informe de errores:btsnooz.py BUG_REPORT.txt > BTSNOOP.log
Depuración con registros
En Android 4.4 y versiones posteriores, puede recopilar manualmente los registros BTSnoop, que se asemejan al formato 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 eventos e información no personal. Para registrar todos los datos, el usuario debe habilitar Bluetooth HCI snoop haciendo lo siguiente:
- Habilite las opciones de desarrollador en el dispositivo.
- En el menú Opciones de desarrollador , active la opción Habilitar registro de snoop de Bluetooth HCI .
- Reinicie Bluetooth para que el registro surta efecto.
Para verificar y depurar la pila de Bluetooth, use las herramientas proporcionadas en AOSP y las pruebas del Grupo de interés especial (SIG) de Bluetooth.
Probando y verificando
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 AOSP, haga lo siguiente:
- Detener el tiempo de ejecución de Android:
adb shell stop
- Desde el directorio de prueba, ejecute el archivo ejecutable de shell e incluya opciones si desea ejecutar una prueba específica o un conjunto de pruebas:
./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 prueba se puede encontrar en el archivo /packages/modules/Bluetooth/system/test/run_unit_tests.sh
.
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 celulares. 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 perfil
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 Bluetooth PTS. 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 de 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 múltiples 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 manera 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, busque en system/bt/conf/bt_stack.conf
.
Para extraer registros de snoop del informe de errores, use el script btsnooz
.
- Obtén
btsnooz.py
. - Extraiga la versión de texto del informe de error.
- Ejecute
btsnooz.py
en la versión de texto del informe de errores:btsnooz.py BUG_REPORT.txt > BTSNOOP.log
Depuración con registros
En Android 4.4 y versiones posteriores, puede recopilar manualmente los registros BTSnoop, que se asemejan al formato 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 eventos e información no personal. Para registrar todos los datos, el usuario debe habilitar Bluetooth HCI snoop haciendo lo siguiente:
- Habilite las opciones de desarrollador en el dispositivo.
- En el menú Opciones de desarrollador , active la opción Habilitar registro de snoop de Bluetooth HCI .
- Reinicie Bluetooth para que el registro surta efecto.