📡 Native Device: Query Strings
Nesta seção, apresentamos exemplos de mensagens UDP utilizando Query Strings para o protocolo Native Device.
Query String – Versão 1
| Parte | Descrição |
|---|---|
| $6A6F | Identifica o dispositivo que receberá a ação, utilizando os 4 últimos dígitos do endereço MAC. Para o dispositivo mestre, utilize o valor 0000. |
| >/ac/rs | Especifica a ação a ser executada no dispositivo. Veja lista de ações disponíveis. |
| @0 | Refere-se ao Protocolo da mensagem, podendo ser 0, 1, 8 ou 9. Veja tabela abaixo |
| ?r0=off&r1=off | São os valores da mensagem, que podem representar informações ou alterações, conforme o tipo de protocolo. Este campo não é obrigatório e, caso nenhum valor seja informado, o dispositivo retornará o estado de todas as saídas relacionadas à ação especificada. |
| &_to=192.168.0.10 | IP de origem da solicitação (opcional): define o endereço IP que será utilizado pelo equipamento ao enviar a resposta. Caso informado, o dispositivo responderá exclusivamente para esse endereço. |
| <99999 | Número único e aleatório utilizado para identificar a solicitação e evitar interpretações duplicadas do mesmo protocolo. Caso não seja necessário, utilize o valor 0 para ignorar (não recomendado). |
| # | Indica o fim do protocolo. |
Importante: os caracteres $, >, @, ?, < e # são obrigatórios em todas as mensagens. Eles funcionam como separadores dos campos e devem ser incluídos mesmo que nenhum valor seja fornecido após eles.
Os parâmetros dentro da mensagem são separados por &, e os que iniciam com _ representam protocolos internos.
Por exemplo, a ausência de parâmetros após ? não dispensa o uso do próprio caractere, pois ele define o início do bloco de dados da mensagem. O mesmo vale para os demais separadores, garantindo que a estrutura seja corretamente interpretada pelo dispositivo.
Tabela de Protocolos
| Protolo | Nome | Descrição |
|---|---|---|
| @0 | Set Data | Protocolo utilizado para definir ou solicitar valores no dispositivo, como consultar estados ou aplicar modificações. |
| @1 | Delete data | Protocolo utilizado para remover dados do dispositivo (ex: cenas) |
| @8 | Send All | Protocolo utilizado para enviar a mesma mensagem para múltiplos dispositivos simultaneamente. |
| @9 | Description | Protocolo que solicita ao dispositivo o envio das descrições de suas ações e parâmetros disponíveis. |
Query String – Versão 2
A Query String da Versão 2, compatível com dispositivos a partir da série 2.x.x, apresenta uma otimização significativa na transmissão dos dados. Nesta versão, valores idênticos em arrays não são repetidos; por exemplo, os parâmetros que antes eram enviados como r0=off e r1=off são condensados para r[0,1]=off. Essa condensação reduz o tamanho do pacote, diminui o tráfego de rede e melhora a eficiência da transmissão. Devido às diferenças estruturais, a Versão 2 não é compatível com dispositivos que operam na Versão 1.x.x, sendo necessária atualização para aproveitar as melhorias.