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) - Detalle
El modo delta acumula los cambios del valor monitoreado durante una ventana de tiempo y dispara si la variación acumulada supera el umbral configurado.
Parámetros en modo X:
| Param | Función |
|---|---|
ee | Ventana de tiempo en segundos |
ff | Umbral delta (ver modos abajo) |
Modos de comparación:
Formato de ff | Comportamiento | Disparo |
|---|---|---|
ff positivo (ej: 20) | Solo incrementos | Si delta acumulado ≥ ff |
ff negativo (ej: -20) | Solo decrementos | Si delta acumulado ≤ ff |
*ff (ej: *20) | Valor absoluto | Si |delta acumulado| ≥ |ff| |
Funcionamiento interno:
- Al inicio de cada ventana, guarda el valor actual y resetea el acumulador
- En cada evaluación, suma la diferencia:
delta += valor_actual - valor_anterior - Al cumplirse el tiempo
ee, compara el delta acumulado con el umbralff - Si se cumple la condición, dispara la señal UV correspondiente
- Reinicia la ventana de tiempo y el acumulador
El valor de ff (delta) no puede ser cero. Si se configura delta = 0, el disparador no será procesado.
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 1Señ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-2Crear 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<Ejemplo 3: Uso de Delimitador (Split)
Extraer IGN desde respuesta delimitada por ;:
>SUV04FQIO,\3B1,3,1,1,2< // Delimitador ; (0x3B), campo 1Respuesta 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<