Comando CXSMW — SMS White List
Habilita ou desabilita a filtragem de SMS recebidos mediante uma lista branca de números telefônicos autorizados.
Para que serve?
🔐 Casos de uso principais:
- 🛡️ Proteger dispositivo contra comandos SMS não autorizados
- 📱 Restringir controle a números específicos
- 🏢 Controle centralizado de frotas
- 🔒 Segurança em ambientes de produção
Quando a White List está habilitada, apenas serão processados SMS de números registrados nos destinos SM0-SM4.
Características
| Característica | Valor |
|---|---|
| Estados | 0 = Desabilitado, 1 = Habilitado |
| Lista de números | SM0 - SM4 (5 números máximo) |
| Persistência | NVS (sobrevive reinicializações) |
| Disponível desde | Firmware v1.9.08 |
Comandos
| Operação | Sintaxe | Descrição |
|---|---|---|
| Configurar | SCXSMWE | Habilita/desabilita White List |
| Consultar | SCXSMW | Lê estado atual |
| Resposta | RCXSMWE | Confirmação com estado |
Parâmetros
| Parâmetro | Descrição | Valores |
|---|---|---|
E | Estado da White List | 0 = Desabilitado, 1 = Habilitado |
Exemplos
Habilitar White List
>SCXSMW1<
// Resposta: RCXSMW1
// O dispositivo só aceitará SMS de números em SM0-SM4Desabilitar White List
>SCXSMW0<
// Resposta: RCXSMW0
// O dispositivo aceitará SMS de qualquer númeroConsultar estado
>SCXSMW<
// Resposta: RCXSMW1 (habilitado) ou RCXSMW0 (desabilitado)Configuração de Números Autorizados
A White List utiliza os números configurados nos destinos SMS (SM0-SM4):
// Configurar números autorizados
>SSM0+5491112345678< // Número 1: Central de monitoramento
>SSM1+5491187654321< // Número 2: Supervisor
// Verificar configuração
>QSM0<
// Resposta: RSM0+5491112345678
// Apagar número (enviar vazio)
>SSM2<
// Resposta: RSM2Índices disponíveis
| Índice | Chave NVS | Uso recomendado |
|---|---|---|
| SM0 | SMS0 | Central de monitoramento |
| SM1 | SMS1 | Supervisor principal |
| SM2 | SMS2 | Supervisor secundário |
| SM3 | SMS3 | Emergências |
| SM4 | SMS4 | Backup |
Funcionamento Interno
Quando chega um SMS e a White List está habilitada:
Exceção QPW: Se o SMS não provém de um número autorizado mas o primeiro comando é >QPW... (senha), o SMS será processado igualmente. Isso permite recuperar o acesso em caso de perda dos números autorizados.
Coincidência parcial
A validação usa busca de substring (strstr), permitindo coincidências parciais:
| Número em SM0 | SMS desde | Resultado |
|---|---|---|
12345678 | +5491112345678 | ✅ MATCH |
12345678 | +5491198765432 | ❌ NO MATCH |
Recomenda-se usar o formato internacional completo com código de país para maior precisão e evitar falsos positivos.
Casos de Uso
Frota com controle centralizado
// 1. Configurar número de central de monitoramento
>SSM0+5491140001234<
// 2. Configurar número de supervisor
>SSM1+5491140005678<
// 3. Habilitar White List
>SCXSMW1<
// Resultado: Só a central e o supervisor podem enviar comandos SMSDesabilitar temporariamente para diagnóstico
// Desabilitar para testes
>SCXSMW0<
// Realizar testes de qualquer número...
// Voltar a habilitar
>SCXSMW1<Verificar configuração completa
// Verificar estado de White List
>SCXSMW<
// Resposta: RCXSMW1
// Verificar números autorizados
>QSM0<
// Resposta: RSM0+5491140001234
>QSM1<
// Resposta: RSM1+5491140005678
>QSM2<
// Resposta: RSM2 (vazio)Considerações de Segurança
Recomendações
| Recomendação | Descrição |
|---|---|
| ✅ Habilitar em produção | Protege contra comandos SMS não autorizados |
| ✅ Usar formato internacional | Incluir código de país para evitar falsos positivos |
| ✅ Verificar números | Antes de habilitar, confirmar SM0-SM4 |
| ✅ Backup de configuração | Os números se armazenam em NVS |
Riscos potenciais
| Risco | Mitigação |
|---|---|
| White List vazia | Nenhum SMS será processado se estiver habilitada sem números |
| Números incorretos | Verificar com QSM antes de habilitar |
| Coincidência parcial falsa | Usar números completos com código de país |
¡Importante! Se habilitar a White List sem números configurados, nenhum SMS será processado.
Troubleshooting
| Problema | Causa provável | Solução |
|---|---|---|
| SMS não processados | White List habilitada sem números | Adicionar números a SM0-SM4 ou desabilitar com >SCXSMW0< |
| SMS ignorados de número conhecido | Formato de número diferente | Verificar formato exato com >QSMx< |
| Respostas não chegam | Destino SMS incorreto | Configurar SM0-SM4 corretamente |
Compatibilidade
Ver También
- Comando SM — Configuração de destinos SMS
- Comando CXSMS — Configuração de tentativas SMS