Relatório Ux — Operações com Relatórios de Usuário

Permite consultar, executar e gerar relatórios de usuário previamente configurados com o Comando UC.

Para que serve?

Caso de uso	Descrição
📤 Envio automático	Gerar e enviar relatórios customizados por eventos
🔍 Consulta local	Verificar conteúdo de relatórios UC
⚡ Execução dinâmica	Executar comandos embarcados no relatório
📊 Telemetria periódica	Enviar dados combinados a intervalos

Comandos

Operação	Sintaxe	Descrição
Consultar	`QUn`	Lê conteúdo do relatório UCnn
Executar	`SUn`	Executa o relatório como comando local
Gerar	`GUn[bb][c]`	Gera e envia relatório ao servidor

Diferença chave:

QUn → Apenas mostra o conteúdo renderizado
SUn → Executa os comandos embarcados no relatório
GUn → Gera o relatório e o envia a um destino IP

Parâmetros

Parâmetro	Descrição	Valores
`n`	Índice de relatório	`0` a `F` (UC00-UC0F)
`bb`	Número de evento associado (só para G)	`00`-`FF`, `XX` = sem evento
`c`	Prioridade de envio (só para G)	`H` = alta, `M` = média, `L` = baixa

Operações em Detalhe

Consultar (Q)

QUn — Consultar Relatório

Lê e mostra o conteúdo do relatório UC processado.


>QUn<

Resposta:


conteudo_renderizado

A resposta a QUn é exatamente o conteúdo renderizado da estrutura UC, sem nenhum prefixo RUn antecedendo: para relatórios de usuário, printmsg() copia o texto tal como está (strcpy(str, txt)). Não confunda com RUn (a resposta de SUn, que sim leva esse prefixo seguido de OK/ERR).

Executar (S)

SUn — Executar Relatório

Executa o relatório como se fosse um comando do equipamento. Útil para disparar ações configuradas no UC.


>SUn<

Comportamento:

Processa a estrutura UC
Executa os comandos embarcados
Retorna resposta local (não envia ao servidor)

Ideal para usar em regras do Motor de Eventos quando você precisa executar uma sequência de comandos configurada dinamicamente.

Gerar (G)

GUn — Gerar e Enviar

Gera o relatório e o envia a um destino IP configurado.


>GUnbbc<

Parâmetros adicionais:

bb → Número de evento associado
c → Tipo de relatório

Resultado: O equipamento responde imediatamente com o literal GOK, confirmando que o comando foi aceito e o relatório ficou enfileirado. O conteúdo real do relatório (igual ao de QUn, sem prefixo) é o que efetivamente viaja até o destino — não é o que retorna como resposta direta ao comando GUn.

Integração com Motor de Eventos

Gerar relatório por IGN ON


>SRL60E;TRG=IGN+;ACC={GU0XXH}<

Executar macro por entrada digital


>SRL61E;TRG=IN02+;ACC={SU1}<

Executa o conteúdo de UC01 quando IN02 é ativada.

Gerar por limite de velocidade


>SRL62E;TRG=VL00+;ACC={GU1XXH}<

Sequência periódica com timer


>STD05E00005<
>SRL96E;TRG=TD05+;ACC={GU0XXH}<
>SRL97E;TRG=TD05+;ACC={SU1}<

Gera UC00 e executa UC01 a cada 5 segundos.

Compatibilidade

💾Firmware v1.12.05

C5Legacy

💾Firmware v1.00.00

SP-IOT

SM-IOT

ZE-IOT

Ver Também

Comando UC - Configuração de estrutura
Comando G - Gerador de relatórios
Comando XB - Buffers de texto
Motor de Eventos - Automação