Comando UV — Disparadores de Usuario

Crea disparadores personalizados que monitorean cualquier variable interna del dispositivo y generan eventos cuando se cumplen condiciones específicas.

¿Para qué sirve?

Caso de uso	Descripción
🎯 Monitoreo de variables	Supervisa cualquier parámetro interno del dispositivo
⚡ Detección de cambios	Dispara eventos cuando valores entran/salen de rangos
📈 Modo delta	Detecta cambios abruptos en velocidad, combustible, etc.
🔗 Integración con reglas	Señales UV00-UV47 disponibles para motor de eventos
🔧 Parseo de respuestas	Extrae campos específicos con delimitadores

Soporta 32 disparadores (índices 00-31), expandibles hasta 47 en algunos firmwares.

Sintaxis

Acción	Comando	Descripción
Consultar	`QUVnn`	Consulta configuración del disparador nn
Configurar	`SUVnnabb.bb,cc,dd,ee,ff`	Configura disparador completo
Borrar uno	`SUVnn*`	Elimina disparador nn
Borrar todos	`SUV*55AA`	Elimina todos los disparadores
Reset señal	`SUVnnR`	Pone a 0 la señal UVnn

Parámetros

Param	Descripción	Valores
`nn`	Índice del disparador	`00` a `31` (o `47`)
`a`	Tipo de conversión	Ver tabla abajo
`bb.bb`	Comando interno a monitorear	Ej: `QIO`, `QVR`
`cc`	Índice del primer carácter	Posición en respuesta
`dd`	Cantidad de caracteres	Largo del dato
`ee..ee`	Valor mínimo (≥) o tiempo delta	Depende del tipo
`ff..ff`	Valor máximo (<) o delta	Depende del tipo

Tipos de Conversión

Tipo	Descripción	Rango
/ `S`	Decimal con signo	-2147483648 a +2147483647
`U`	Decimal sin signo	0 a 4294967295
`F`	Punto flotante	Decimales
`H`	Hexadecimal Big Endian	0x00 a 0xFFFFFFFF
`h`	Hexadecimal Little Endian	0x00 a 0xFFFFFFFF
`A`	Cadena ASCII	Texto
`X`	Delta (cambio abrupto)	Desde v1.08.07

Modo Delta (X): Dispara cuando el valor cambia más allá del delta especificado en un tiempo determinado. Útil para detectar frenadas bruscas o robo de combustible.

Campo Split (Opcional)

Formato: \XXnn donde:

XX = Carácter delimitador en hexadecimal (ej: 3B = ;)
nn = Número del campo a extraer


// Ejemplo: \3B1 separa por ";" y toma el campo 1

Señales Asociadas

Propiedad	Valor
Señal	`UV`
Índice	`00` - `47`
Uso condicional	✅ Sí
Flancos	`+` positivo, `-` negativo, `*` cualquiera

Ejemplos Prácticos

Ejemplo 1: Monitoreo de Ignición

Captura el estado de IGN desde el comando QIO:


>SUV00UQIO,7,1,1,2<       // Sin signo, posición 7, 1 carácter, rango 1-2

Crear reglas para detectar cambios de ignición:


>SRL00E;TRG=UV00+;ACC={STX UV00+ ;@TRM}<  // Disparo positivo (IGN ON)
>SRL01E;TRG=UV00-;ACC={STX UV00- ;@TRM}<  // Disparo negativo (IGN OFF)

Ejemplo 2: Estado de Antena GPS

Detectar si la antena GPS está conectada, abierta o en corto:


// Configurar buffer de consulta
>SCXXB04G0000000,STATUS=,\2A,A<
 
// Crear disparadores para cada estado
>SUV00AQXB04,5,2,OK,<       // GPS Antena OK
>SUV01AQXB04,5,4,OPEN,<     // GPS Antena abierta
>SUV02AQXB04,5,5,SHORT,<    // GPS Antena en corto
 
// Reglas para reportar estado
>SRL90E;TRG=UV00+;ACC={STX ANTENA GPS CONECTADA;@TRM}<
>SRL91E;TRG=UV01+;ACC={STX ANTENA GPS ABIERTA;@TRM}<
>SRL92E;TRG=UV02+;ACC={STX ANTENA GPS EN CORTO;@TRM}<

Resultado esperado:


>RTX ANTENA GPS CONECTADA;ID=039129;*5B<
>RTX ANTENA GPS ABIERTA;ID=039129;*47<
>RTX ANTENA GPS EN CORTO;ID=039129;*61<

Ver comando CXXB

Ejemplo 3: Uso de Delimitador (Split)

Extraer IGN desde respuesta delimitada por ;:


>SUV04FQIO,\3B1,3,1,1,2<    // Delimitador ; (0x3B), campo 1

Respuesta de QIO:


RIO;IGN1;IN1111111;XP000;V000;VBU464
    ↑
    Campo 1, posición 3, 1 carácter = "1"

Consulta el valor del disparador UV con: >QSSUV04<

Compatibilidad

💾Firmware v1.03.00

SPLegacy

ULLegacy

MTLegacy

💾Firmware v1.00.00

SP-IOT

SM-IOT

ZE-IOT