Comando CXBTH - Configuração Bluetooth BLE
Configura o modo de uso do módulo Bluetooth (BLE).
Para que serve?
| Caso de uso | Descrição |
|---|---|
| 📱 Configuração sem fio | Enviar comandos desde smartphone |
| 🔧 Diagnóstico | Acessar o equipamento sem cabos |
| 📊 Download de dados | Obter logs via Bluetooth |
| 📡 Destino de relatórios | Enviar relatórios para dispositivo BLE |
Descrição
É muito importante atualizar o dispositivo com a versão adequada que inclua esta funcionalidade. Pode ser atualizado via FOTA, substituindo a extensão do arquivo de atualização por .nimble.ota.
Habilitando o dispositivo a se conectar via BLE em modo SPP, com um dispositivo mestre. Este dispositivo mestre poderá enviar e receber comandos através da porta serial virtual gerada como se fosse uma porta serial a mais do dispositivo.
Comandos
Configurar
SCXBTHa,nome,pin,timeout,peerConsultar
QCXBTHResposta
RCXBTHa,nome,pin,timeout,peerParâmetros
| Campo | Descrição | Valores |
|---|---|---|
| a | Habilitação | 0=Desabilitado, 1=Habilitado |
| nome | Nome do dispositivo BLE (mostrado) | Até 16 caracteres |
| pin | PIN de acesso Bluetooth | Até 16 caracteres |
| timeout | Segundos para autenticar antes de fechar a sessão | 0 = 10 s (padrão) |
| peer | Equipamento remoto ao qual se conectar como mestre | Até 16 caracteres. Vazio = escravo (comportamento clássico) |
Os campos são cumulativos: um SCXBTH com menos campos não altera os que não envia. >SCXBTH1,Nome,1234< mantém o timeout e o peer como estavam.
Exemplos
Habilitar o módulo Bluetooth
>SCXBTH1,MeuDispositivo,1234<Habilita o módulo Bluetooth para que seja habilitado, mostre o nome MeuDispositivo, e permita a conexão de dispositivos utilizando o PIN 1234.
Desabilitar leitura
>SCXBTH0<Enlace entre dois equipamentos (modo mestre)
A partir do firmware v1.09.26 um equipamento pode se conectar ativamente a outro por BLE, em vez de esperar que um celular ou gateway se conecte a ele. Serve para que um equipamento sem conexão própria envie dados através de outro que a tenha.
Exemplo típico: um equipamento instalado numa carreta mede ângulos com o acelerômetro e não tem SIM. Ele se enlaça por BLE ao equipamento do trator, que reenvia os dados à plataforma pelo seu canal celular.
O papel é definido pela configuração
peer | Papel | Comportamento |
|---|---|---|
| Vazio | Escravo | Anuncia e espera conexões (comportamento de sempre) |
| Com um nome | Mestre | Procura esse equipamento e se conecta a ele |
O peer se configura em um só lado do par. Ambos os equipamentos devem ter o mesmo PIN: o mestre o usa para se autenticar contra o escravo.
O peer aceita até 16 caracteres, contando o * do modo itinerante.
// No equipamento do trator (escravo): sem peer
>SCXBTH1,TRATOR_01,1234,10,<
// No equipamento da carreta (mestre): aponta para o trator
>SCXBTH1,CARRETA_07,1234,10,TRATOR_01<O mestre procura o nome, se conecta, se autentica e fica enlaçado. Se o enlace cair — por distância, por um reinício do outro equipamento ou por uma atualização — reconecta sozinho.
Fixação do equipamento remoto
Na primeira autenticação bem-sucedida o mestre memoriza o endereço físico do equipamento remoto. A partir daí só reconecta a esse equipamento, mesmo que outro anuncie o mesmo nome. A memória é apagada ao reconfigurar o peer.
Isso evita que um equipamento alheio com o mesmo nome capture o enlace. Convém fazer o primeiro enlace durante a instalação, com os dois equipamentos próximos.
Modo itinerante
Se o equipamento remoto muda — por exemplo uma carreta que trabalha com tratores diferentes — antepõe-se * ao nome:
>SCXBTH1,CARRETA_07,1234,10,*TRATOR<Com * não se fixa o endereço físico: o mestre se conecta ao equipamento com esse nome e melhor sinal, que é o que o está rebocando. Todos os equipamentos da frota compartilham nome e PIN. Como o * ocupa um lugar, o nome pode ter até 15 caracteres.
O modo itinerante não fixa o equipamento remoto, portanto não protege contra um equipamento alheio que anuncie o mesmo nome. Usá-lo apenas quando o remoto realmente muda.
Acesso ao equipamento mestre enquanto está enlaçado
Nos equipamentos que admitem uma única conexão BLE simultânea, enquanto o mestre está enlaçado ele deixa de anunciar: você não vai conseguir se conectar a ele com o celular nem com o aplicativo de configuração. Ele volta a anunciar apenas quando o enlace cai e está tentando de novo. Para configurá-lo com o enlace ativo, use outro canal (serial, celular) ou apague o peer primeiro.
Relatórios através do enlace
Com o enlace ativo, o destino BTH funciona como sempre: os relatórios dirigidos a ;@BTH viajam ao equipamento remoto. Se o enlace estiver caído, ficam enfileirados e são entregues ao reconectar — nada se perde.
No equipamento receptor, o que chega pode ser capturado com um capturador CXXB de meio B (Bluetooth) e reenviado à plataforma como relatório de usuário. Cada trama viaja com o ID do equipamento que a gerou, então a plataforma distingue a origem.
Estado do enlace
QBTH expõe o papel e o estado do enlace nos campos 8 e 9.
Destino BTH para Relatórios
Quando se habilita o módulo BTH, também se habilita o destino BTH para poder gerar relatórios para esse destino.
Por exemplo, o comando:
>SG1CQ000,BTH<Gerará um relatório CQ para o dispositivo mestre.
Variável de Conexão
A variável BTH_CONNECTED estará disponível para ser utilizada no motor de eventos. Quando for verdadeira indicará uma conexão em curso.
Compatibilidade
Ver Também
- Comando BTH (IOT) - Estado da conexão e do enlace entre equipamentos
- Comando BS (IOT) - Escaneamento BLE
- Comando BE (IOT) - Beacons BLE