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,0,0<| # | 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) |
| 8 | rol | 0 = escravo, 1 = mestre (tem peer configurado) |
| 9 | enlace | Estado do enlace quando atua como mestre (tabela abaixo) |
Consulta de um campo
>QBTH02<
>RBTH02,1<Índice 00–09 (dois dígitos), conforme a tabela acima.
Estado do enlace entre equipamentos (campo 9)
A partir da v1.09.26 um equipamento pode se conectar ativamente a outro por BLE (CXBTH). O campo 9 mostra em que ponto está esse enlace:
| Valor | Estado | O que significa |
|---|---|---|
0 | Inativo | O equipamento é escravo: não tem peer configurado |
1 | Procurando | Não encontra o equipamento remoto (desligado, fora de alcance ou com outro nome) |
2 | Conectando | Encontrou-o e está estabelecendo a conexão |
3 | Autenticando | Conectado, enviando o PIN |
4 | Enlaçado | Enlace operacional: os relatórios para ;@BTH viajam ao outro equipamento |
5 | PIN rejeitado | O remoto não aceitou o PIN — verificar que ambos tenham o mesmo |
>QBTH09<
>RBTH09,4< // enlaçadoO estado 5 não é repetido no ritmo normal: após várias tentativas falhas o equipamento espera um minuto entre cada uma, para não repetir o PIN no ar. Corrigir o PIN com SCXBTH restabelece o enlace sozinho.
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