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<| # | 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) |
Consulta de un campo
>QBTH02<
>RBTH02,1<Índice 00–07 (dos dígitos), según la tabla de arriba.
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