Comando BTH IoT — Status da Conexão Bluetooth
QBTH consulta em uma única trama todo o status Bluetooth do equipamento — espelho de QCEL e QWIF para o terceiro canal. Além disso, o sinal BTH (cliente conectado) fica disponível para regras do motor de eventos e expressões EVAL.
Disponível desde o firmware v1.09.26.
Para que serve?
| Caso de uso | Descrição |
|---|---|
| 🔗 Detectar um gateway conectado | Saber se há um cliente BT acoplado ao equipamento (e desde quando falha, com regras) |
| 📶 Diagnóstico de enlace | MAC do peer e RSSI ao vivo da conexão |
| ⚙️ Automatizar por conexão | Regras TRG=BTH* — disparar ações quando um cliente se conecta ou vai embora |
Comandos
Consulta completa
>QBTH<
>RBTH,1,1,1,1,0,RINHO_IOT,AABBCCDDEEFF,-62<| # | Campo | Significado |
|---|---|---|
| 0 | pwr | Alimentação configurada do Bluetooth (a chave, não o estado) |
| 1 | up | O stack Bluetooth está rodando |
| 2 | conn | 1 = há pelo menos um cliente conectado |
| 3 | nconn | Quantidade de conexões ativas |
| 4 | sesion | 1 = há uma sessão autenticada (conexão com login) |
| 5 | nombre | Nome Bluetooth do equipamento |
| 6 | mac | MAC do último cliente conectado (vazia se não houver conexão) |
| 7 | rssi | RSSI ao vivo da conexão, em dBm (0 sem conexão) |
Consulta de um campo
>QBTH02<
>RBTH02,1<Índice 00–07 (dois dígitos), conforme a tabela acima.
conn reflete a conexão física (GAP), haja ou não sessão autenticada. Um gateway acoplado sem fazer login dá conn=1, sesion=0. pwr é a configuração de alimentação (CXBTH); up é o estado real do stack.
O sinal BTH (regras e EVAL)
BTH = 1 enquanto houver um cliente Bluetooth conectado. Usa-se igual a qualquer sinal do equipamento:
>QSSBTH< // → RSSBTH11 (conectado) / RSSBTH00
>SRLA0E;TRG=BTH+;ACC={...}< // regra: quando um cliente se conecta
>SRLA1E;TRG=BTH-;ACC={...}< // regra: na desconexãoEm EVAL escreve-se BTH (sem argumentos). Não confundir com BTHPWR, que é somente a configuração de alimentação.
Em builds sem Bluetooth o sinal existe e devolve sempre 0.
Compatibilidade
Ver Também
- Comando CXBTH - Configuração de alimentação Bluetooth
- Comando CEL - Status da rede celular
- Comando WIF - Status da conexão WiFi