Comando UC — Reportes de Usuario Personalizados

Permite crear reportes customizados concatenando respuestas de múltiples comandos, texto plano y campos calculados. Ideal para integrar datos específicos en formatos a medida.

🎯 16 reportes disponibles (índices 00-0F), cada uno totalmente configurable e independiente.

¿Para qué sirve?

Caso de uso	Descripción
📊 Telemetría customizada	Combinar datos de GPS, sensores y estados en un solo reporte
🔗 Integración con servidores	Formato específico para plataformas de tracking
📝 Reportes multi-sensor	Concatenar lecturas analógicas, digitales y CAN
🏷️ Identificación de cargas	Incluir códigos de cliente/pedido desde buffers XB
📋 Formato JSON/CSV	Estructurar datos para APIs o procesamiento

Comandos

Operación	Sintaxis	Descripción
Configurar	`SUCnn estructura`	Define estructura del reporte `nn`
Borrar	`SUCnn*`	Elimina configuración del reporte `nn`
Consultar	`QUCnn`	Lee estructura configurada

Parámetros

Parámetro	Descripción	Valores
`nn`	Índice de reporte	`00` a `0F` (16 reportes)
`estructura`	Definición de campos	Campos separados por `\|`

Respuesta


RUCnn campo1|campo2|...|campoN

Sintaxis de Campos

Básico

Extracción de comando


COMANDO,inicio,longitud

Elemento	Descripción
`COMANDO`	Comando a ejecutar (ej: `QPQ`, `QIO`, `QCQ`)
`inicio`	Primera posición a incluir (base 0)
`longitud`	Cantidad de caracteres a extraer

Ejemplo: QPQ,5,64 → Extrae 64 caracteres desde posición 5 de la respuesta QPQ

Con Split

Campo con separador (split)


COMANDO,\XXnn,inicio,longitud

Elemento	Descripción
`\XX`	Separador en hexadecimal (ej: `\2C` = `,`)
`nn`	Número de campo a extraer (base 0)
`inicio`	Posición dentro del campo
`longitud`	Caracteres a extraer

Ejemplo: QXB00,\2C9,0,10 → Del campo 9 separado por comas, extraer 10 chars

Texto

Texto literal


$texto

Incluye texto plano en el reporte.

Ejemplo: $TEMP: → Inserta literalmente “TEMP:“

Evento

Identificador de evento

Inserta el número de evento que disparó el reporte (2 dígitos hex).

Ejemplo: Si el evento 05 disparó el reporte, # se reemplaza por 05

Sin Coma

Sin coma separadora

Anteponer espacio al comando:


 COMANDO

Concatena sin agregar coma entre campos.

Caracteres ASCII Especiales

Usa códigos hexadecimales para insertar caracteres especiales en el reporte.

Código	Caracter	Descripción
`\00`	NULL	Terminador
`\09`	TAB	Tabulación
`\0D`	CR	Retorno de carro
`\0A`	LF	Salto de línea
`\20`	SPACE	Espacio
`\2C`	`,`	Coma
`\3A`	`:`	Dos puntos
`\3B`	`;`	Punto y coma
`\5C`	`\`	Barra invertida
`\7C`	`\|`	Pipe

Ejemplos

Básicos

Reporte simple con posición


>SUC00 $POS| QPQ,5,64<

$POS → Texto literal “POS”
QPQ,5,64 → Respuesta de QPQ desde posición 5, 64 caracteres

Reporte con identificador de evento


>SUC03 $EVT| #| $\3B| QPQ,5,30<

El # se reemplaza por el número de evento disparador.

Multi-comando

Reporte con múltiples comandos


>SUC01 $DATA| QCQ,5,20| $\3B| QIO,15,10<

$DATA → Prefijo
QCQ,5,20 → Coordenadas
$\3B → Separador ;
QIO,15,10 → Estados I/O

Reporte con campo separado (split)


>SUC02 QXB00,\2C9,0,10<

Extrae el campo 9 (separado por comas) del buffer XB00.

Formatos

Formato JSON-like


>SUC0C ${"lat":| QCQ,5,10| $,"lon":| QCQ,15,11| $,"ign":| QIO,20,1| $}<

Formato CSV


>SUC0D QGP,5,14| $\2C| QCQ,5,10| $\2C| QCQ,15,11| $\2C| QIO,20,1<

Invocación de Reportes UC

Consulta manual


>QU0<

Consulta el contenido del reporte UC00.

Generación automática con eventos


>SRL50E;TRG=IGN+;ACC={GU0}<

Genera reporte UC00 cuando se enciende ignición.

Para enviar el reporte al servidor usa GUn (Generador). QUn solo consulta localmente.

Limitaciones

Parámetro	Valor
📦 Reportes UC disponibles	16 (00-0F)
📏 Longitud máxima estructura	~200 caracteres
🔢 Campos por reporte	~20 (según longitud)
🚫 Comandos anidables	No (UC no puede contener UC)

Compatibilidad

💾Firmware:v1.00.00

C5Legacy

SP-IOT

SM-IOT

ZE-IOT

Ver También

Reporte Ux - Consulta y generación de reportes UC
Comando XB - Buffers de texto
Comando EVAL - Expresiones calculadas
Motor de Eventos - Generación automática