Comando BTH IoT — Estado de la Conexión Bluetooth
QBTH consulta en una sola trama todo el estado Bluetooth del equipo — espejo de QCEL y QWIF para el tercer canal. Además, la señal BTH (cliente conectado) queda disponible para reglas del motor de eventos y expresiones EVAL.
Disponible desde firmware v1.09.26.
¿Para qué sirve?
| Caso de uso | Descripción |
|---|---|
| 🔗 Detectar un gateway conectado | Saber si hay un cliente BT enganchado al equipo (y desde cuándo falla, con reglas) |
| 📶 Diagnóstico de enlace | MAC del peer y RSSI en vivo de la conexión |
| ⚙️ Automatizar por conexión | Reglas TRG=BTH* — disparar acciones cuando un cliente se conecta o se va |
Comandos
Consulta completa
>QBTH<
>RBTH,1,1,1,1,0,RINHO_IOT,AABBCCDDEEFF,-62,0,0<| # | Campo | Significado |
|---|---|---|
| 0 | pwr | Encendido configurado del Bluetooth (la llave, no el estado) |
| 1 | up | El stack Bluetooth está corriendo |
| 2 | conn | 1 = hay al menos un cliente conectado |
| 3 | nconn | Cantidad de conexiones activas |
| 4 | sesion | 1 = hay una sesión autenticada (conexión con login) |
| 5 | nombre | Nombre Bluetooth del equipo |
| 6 | mac | MAC del último cliente conectado (vacía si no hay conexión) |
| 7 | rssi | RSSI en vivo de la conexión, en dBm (0 sin conexión) |
| 8 | rol | 0 = esclavo, 1 = maestro (tiene peer configurado) |
| 9 | enlace | Estado del enlace cuando es maestro (tabla de abajo) |
Consulta de un campo
>QBTH02<
>RBTH02,1<Índice 00–09 (dos dígitos), según la tabla de arriba.
Estado del enlace entre equipos (campo 9)
Desde v1.09.26 un equipo puede conectarse activamente a otro por BLE (CXBTH). El campo 9 muestra en qué punto está ese enlace:
| Valor | Estado | Qué significa |
|---|---|---|
0 | Inactivo | El equipo es esclavo: no tiene peer configurado |
1 | Buscando | No encuentra al equipo remoto (apagado, fuera de alcance o con otro nombre) |
2 | Conectando | Lo encontró y está estableciendo la conexión |
3 | Autenticando | Conectado, enviando el PIN |
4 | Enlazado | Enlace operativo: los reportes a ;@BTH viajan al otro equipo |
5 | PIN rechazado | El remoto no aceptó el PIN — revisar que ambos tengan el mismo |
>QBTH09<
>RBTH09,4< // enlazadoEl estado 5 no se reintenta a ritmo normal: tras varios intentos fallidos el equipo espera un minuto entre cada uno, para no repetir el PIN al aire. Corregir el PIN con SCXBTH restablece el enlace solo.
conn refleja la conexión física (GAP), haya o no sesión autenticada. Un gateway enganchado sin loguearse da conn=1, sesion=0. pwr es la configuración de encendido (CXBTH); up es el estado real del stack.
La señal BTH (reglas y EVAL)
BTH = 1 mientras haya un cliente Bluetooth conectado. Se usa igual que cualquier señal del equipo:
>QSSBTH< // → RSSBTH11 (conectado) / RSSBTH00
>SRLA0E;TRG=BTH+;ACC={...}< // regla: al conectarse un cliente
>SRLA1E;TRG=BTH-;ACC={...}< // regla: al desconectarseEn EVAL se escribe BTH (sin argumentos). No confundir con BTHPWR, que es solo la configuración de encendido.
En builds sin Bluetooth la señal existe y devuelve siempre 0.
Compatibilidad
Ver También
- Comando CXBTH - Configuración de encendido Bluetooth
- Comando CEL - Estado de la red celular
- Comando WIF - Estado de la conexión WiFi