Comando EVAL - Evaluador de Expresiones
Motor de evaluación de expresiones matemáticas, lógicas y de estado del sistema.
V, AIN, IN, GPS, ECU...
→Aritméticos, lógicos, bitwise
→printf style: %d, %f, %X
→Casos de uso prácticos
→📋 Sintaxis
EVAL expresión[:formato[:valor_error]]| Parámetro | Descripción | Default |
|---|---|---|
expresión | Operación o consulta a evaluar | (obligatorio) |
formato | Formato de salida estilo printf | %.2f |
valor_error | Valor si falla la evaluación | ERR |
Dentro de la expresión, los argumentos de funciones con múltiples parámetros se separan con ; (punto y coma), no con coma. Ejemplo: ECU(0;0), MBS(1;2). La expresión finaliza con el separador de formato : o con el cierre del mensaje del protocolo (<).
Ejemplos Básicos
>EVAL 10 + 5<Resultado: 15.00
>EVAL 10 + 5.5 * 2:%.1f:NA<Resultado: 21.0 (si falla, devuelve NA)
📊 Variables del Sistema
Sin Parámetros
| Variable | Descripción | Unidad | Link |
|---|---|---|---|
V | Tensión principal | dV (28.0V = 280) | |
VBU | Tensión batería respaldo | dV | |
OT | Odómetro total | metros | |
OP | Odómetro parcial | metros | |
CREG | Estado registro red | - | |
CSQ | Calidad señal celular | 0-31 | |
HO | Horómetro | segundos | |
VEL | Velocidad GPS filtrada | km/h | |
HDG | Rumbo GPS (heading) (v1.09.18+) | 0-360° | |
AGE | Edad dato GPS | segundos | |
LAT | Latitud | grados×10⁵ | |
LON | Longitud | grados×10⁵ | |
IGN | Estado ignición | 0/1 | |
CEL | Conexión celular | 0/1 | |
GPS | GPS activo | 0/1 | |
PWR | Alimentación | 0/1 | |
JMD | Jamming detectado | 0/1 | |
PK | Parking | 0/1 | |
AC | Acelerómetro | 0/1 | |
WIF | WiFi | 0/1 | |
CAN | Bus CAN | 0/1 | |
ALT | Altitud GPS (v1.09.19+) | metros | |
TICK | Ticks desde arranque | segundos | |
TT | Tacómetro interno (pulso/seg) | 0/1 | |
BUF | Buffer de reportes con pendientes | 0/1 | |
BTHPWR | Alimentación Bluetooth | 0/1 | |
BTH | Cliente Bluetooth conectado (v1.09.26+) | 0/1 | |
WIFPWR | Alimentación WiFi | 0/1 | |
CELPWR | Alimentación módulo celular | 0/1 | |
GPSPWR | Alimentación módulo GPS | 0/1 | |
VIOPWR | Alimentación de accesorios | 0/1 | |
INTPWR | Alimentación interna | 0/1 | |
DTCN | Cantidad de fallas activas de la ECU (v1.09.27+) | 0-32 |
Con Un Parámetro
| Variable | Descripción | Rango | Link |
|---|---|---|---|
AIN(n) | Entrada analógica | 0-3 | |
IN(n) | Entrada digital | 0-3 | |
XP(n) | Salida digital | 0-n | |
UV(n) | Variable de usuario | 0-n | |
U(n) | Variable auxiliar | 0-n | |
MXB(n) | Buffer XB | 0-n | |
DC(n) | Ángulo (ANG) | 0-n | |
DV(n) | Frecuencia (FRE) | 0-n | |
OW(n) | Sensor 1-Wire | 0-n | |
DTC(n) | Sub-señal de fallas: 0=hay falla, 1=falla nueva, 2=lámpara, 3=se limpiaron (v1.09.27+) | 0-3 | |
DTCH(spn) | 1 si ese SPN está activo — sólo J1939 (v1.09.27+) | SPN | |
DRV(n) | Chofer del equipo: 0=hay chofer, 1=login, 2=logout, 3=código no autorizado, 4=venció la ventana (v1.09.28+) | 0-4 | |
CAL(n) | Calibración continua del acelerómetro (ver tabla abajo) (v1.09.28+) | 0-3 |
Señales del Motor de Eventos como variables (retornan 0/1):
Además de las anteriores, cualquier disparador con índice del Motor de Eventos puede usarse en EVAL como TOKEN(n). Incluye: ACK, AR, BE, BS, BSW, BSWN, CID, CQ, FCT, IC, ICL, KO, MC, MVXN, MVXP, MVYN, MVYP, MVZN, MVZP, NT, RG, RL, SIM, TD, TR, VL, VBU, WP, XB, ZNA, ZNB. Ver Lista de Disparadores con rangos válidos de cada uno.
Con Dos Parámetros
| Variable | Descripción | Param 1 | Param 2 |
|---|---|---|---|
ECU(i;t) | Datos ECU | Índice | 0=valor, 2=edad (ms) |
MBS(i;t) | Sensores BLE | Índice | 0=temp, 1=humedad |
MBSW(i;t) | BLE wildcard | Índice | 0=connected, 1=major, 2=minor, 3=distance, 4=rssi, 5=age |
MDT(i;t) | Sensor 1-Wire (temp) | Índice | 0=valor, 1=edad |
MPB(p;t) | Ráfagas de pulsos (v1.09.25+) | Puerto (0-1) | 0=conteo, 1=secuencia, 2=edad (s) |
MTD(i;t) | Timers TD | Índice | 0=estado, 1=timer, 2=dist, 3=timeout, 4=distanceout |
MTR(i;t) | Trips | Índice | 0=trigger, 1=habilitado, 2=hora, 3=minuto, 4=segundo |
MNT(i;t) | Contadores | Índice | 0=actual, 1=máximo |
MDL(i;t) | Datos LOG | Índice | 0=cantidad, 1=pendientes, 2=habilitado, 3=reintentos, 4=tiempo reintento |
MPC(i;t) | Contador pulsos | Índice | 0=valor, 1=factor K |
MFC(i;t) | Frecuencímetro | Índice | 0=freq, 1=factor Q, 2=basetime |
Calibración continua: CAL(n)
Desde v1.09.28. CAL(n) devuelve la misma señal que usan las reglas CAL00–CAL03: lo que mide el equipo sobre su propia calibración de ejes en cada parada.
| Llamada | Devuelve |
|---|---|
CAL(0) | 1 si el nivelado medido ya está confirmado (estado OK), 0 si no |
CAL(1) | 1 si el equipo detectó que lo cambiaron de montaje, 0 si no |
CAL(2) | Estado: 0 sin datos · 1 juntando paradas · 2 OK · 3 equipo movido · 4 modo AUTO sin calibrar, con los HM de acelerómetro en pausa |
CAL(3) | Desvío entre el nivelado medido y el aplicado, en grados enteros (0 a 180; 0 sin dato) |
>EVAL CAL(3) ge 3<Retorna 1.00 si el montaje se apartó 3° o más de la calibración aplicada.
📐 Funciones Matemáticas y de Ángulo
Desde v1.09.28. Funciones para cálculos que antes no se podían hacer dentro de una expresión: valor absoluto, raíz, ángulos. Los argumentos se separan con ;.
| Función | Devuelve | Si la entrada no es válida |
|---|---|---|
ANGV(x;y;z) | Ángulo en grados (0 a 180) entre el vector (x;y;z) y la vertical (eje Z positivo) | -1 si el vector es nulo |
ANG6(x;y;z;rx;ry;rz) | Ángulo en grados (0 a 180) entre el vector (x;y;z) y un vector de referencia (rx;ry;rz) | -1 si alguno de los dos vectores es nulo |
ABS(x) | Valor absoluto | — |
SQR(x) | Raíz cuadrada | -1 si x es negativo |
ACS(x) | Arcocoseno, en grados (0 a 180) | -1 si x está fuera de [-1, 1] |
ATN2(y;x) | Arcotangente de y/x en grados (-180 a 180), con el cuadrante correcto. Ojo con el orden: primero y | ATN2(0;0) vale 0 |
MIN(a;b) | El menor de los dos valores | — |
MAX(a;b) | El mayor de los dos valores | — |
El -1 es un centinela, no un ángulo. ANGV, ANG6, SQR y ACS nunca devuelven 0 ni un error cuando la entrada no sirve: devuelven -1. Ejemplo típico: un sensor BLE vencido que informa sus tres ejes en 0. Una regla que compara el ángulo tiene que descartar ese caso (ANGV(...) ge 0) para no tomarlo como una posición real.
>EVAL ANGV(0;0;100)< // 0.00: el vector apunta hacia arriba
>EVAL ANGV(0;100;0)< // 90.00
>EVAL ANGV(0;0;0)< // -1.00: vector nulo
>EVAL ATN2(1;-1)< // 135.00
>EVAL MAX(AIN(0);AIN(1))< // la mayor de las dos entradas analógicas
>EVAL ABS(V - 240)< // cuánto se aparta la tensión de 24,0 V, en dV🧮 Operadores
Aritméticos
| Operador | Descripción | Ejemplo | Resultado |
|---|---|---|---|
+ | Suma | EVAL 10 + 5 | 15.00 |
- | Resta | EVAL 20 - 8 | 12.00 |
* | Multiplicación | EVAL 3 * 4 | 12.00 |
/ | División | EVAL 10 / 2 | 5.00 |
% | Módulo (resto entero) | EVAL 10 % 3 | 1.00 |
Comparadores
| Operador | Descripción | Ejemplo | Resultado |
|---|---|---|---|
gt | Mayor que | EVAL 5 gt 3 | 1.00 |
lt | Menor que | EVAL 5 lt 7 | 1.00 |
ge | Mayor o igual | EVAL 5 ge 5 | 1.00 |
le | Menor o igual | EVAL 4 le 5 | 1.00 |
eq | Igual | EVAL 5 eq 5 | 1.00 |
ne | No igual | EVAL 5 ne 6 | 1.00 |
Lógicos
| Operador | Descripción | Ejemplo | Resultado |
|---|---|---|---|
&& | AND lógico | EVAL (5 gt 3) && (2 lt 4) | 1.00 |
|| | OR lógico | EVAL (5 gt 6) || (2 lt 4) | 1.00 |
^^ | XOR lógico | EVAL 1 ^^ 0 | 1.00 |
! | NOT lógico (unario) | EVAL !0 | 1.00 |
Bitwise
| Operador | Descripción | Ejemplo | Resultado |
|---|---|---|---|
& | AND bit a bit | EVAL 5 & 3 | 1.00 |
| | OR bit a bit | EVAL 5 | 2 | 7.00 |
^ | XOR bit a bit | EVAL 5 ^ 3 | 6.00 |
~ | NOT bit a bit (unario) | EVAL ~0 & 0xFF | 255.00 |
sl | Shift left | EVAL 2 sl 1 | 4.00 |
sr | Shift right | EVAL 4 sr 1 | 2.00 |
📝 Formato de Salida
Personaliza la presentación del resultado usando sintaxis printf de C:
| Formato | Descripción | Ejemplo | Resultado |
|---|---|---|---|
%.2f | Flotante 2 decimales | EVAL 3.14159:%.2f | 3.14 |
%.3f | Flotante 3 decimales | EVAL 3.14159:%.3f | 3.142 |
%d | Entero | EVAL 5.7:%d | 5 |
%x | Hexadecimal minúsculas | EVAL 15:%x | f |
%X | Hexadecimal mayúsculas | EVAL 15:%X | F |
%b | Binario | EVAL 5:%b | 101 |
%05.2f | Con ceros izquierda | EVAL 3.14:%05.2f | 03.14 |
%08.2f | Más ceros izquierda | EVAL 3.14:%08.2f | 00003.14 |
⚠️ Manejo de Errores
Valor personalizado por error
>EVAL toker + 5:%0.2f:NA<Resultado: NA (variable no definida)
Error por defecto
>EVAL toker + 5<Resultado: ERR
División por cero
>EVAL 10 / 0<Resultado: ERR (o el valor_error configurado). El motor detecta el infinito internamente, pero lo trata como un fallo de evaluación: nunca devuelve Inf al usuario.
Límites de la expresión
Desde v1.09.28. Para proteger la memoria del equipo, una expresión que pasa estos límites no se evalúa y devuelve el valor_error (o ERR):
| Límite | Valor |
|---|---|
| Anidamiento | 5 niveles. Suma un nivel cada paréntesis, cada función con argumentos y cada signo unario (-, !, ~) |
| Largo de la expresión | 99 caracteres |
Largo del formato y del valor_error | 19 caracteres cada uno |
>EVAL (((((1)))))< // 5 niveles: 1.00
>EVAL ((((((1))))))< // 6 niveles: ERRLos operadores (+, *, gt, &&, …) no suman niveles: una cadena larga como a + b + c + ... se evalúa igual. Las expresiones de uso habitual usan de 1 a 3 niveles.
💬 Ejemplos Prácticos
Rumbo GPS (HDG)
>EVAL HDG<Retorna rumbo actual en grados (0-360°). Ejemplo: 185.00
>EVAL HDG ge 180<Retorna 1.00 si el vehículo apunta hacia el sur-oeste-norte (180°-360°).
>EVAL (HDG ge 0) && (HDG lt 90)<Retorna 1.00 si apunta hacia el norte-este (0°-90°).
Suma de parámetros ECU
>EVAL ECU(0;0) + ECU(1;0) + ECU(2;0):%0.2f<Suma valores ECU de los índices 0, 1 y 2.
Comparación AIN
>EVAL AIN(0) gt 500<Retorna 1.00 si AIN(0) > 500, sino 0.00.
Lógica compuesta
>EVAL (V gt 150) && (AIN(0) lt 100)<Verifica condición compuesta sobre voltaje y entrada analógica.
Cálculo con formato
>EVAL (10 * 5) + 3:%0.3f<Resultado: 53.000
Expresión compleja
>EVAL ((AIN(0) * 10) + (AIN(1) * 5)) / 2:%0.2f:NA<Calcula promedio ponderado con formato personalizado y error NA.
Máscara bitwise
>EVAL IN(0) & 0x0F:%X<Aplica máscara a entrada digital y muestra en hexadecimal.
Shift bits
>EVAL 8 sr 2<Resultado: 2.00 (8 >> 2)
División con formato entero
>EVAL 25 / 4:%d<Resultado: 6 (división entera)
Conversión de temperatura
>EVAL (AIN(0) * 0.1) - 40:%0.1f:ERR<Convierte lectura ADC a temperatura con error ERR.
🔧 Resolución de Errores
| Error | Causa | Solución |
|---|---|---|
ERR | Variable no definida, sintaxis incorrecta o división por cero | Verifica ortografía y divisores, usa valor_error |
| Sintaxis | Paréntesis desbalanceados | Revisa estructura de expresión |
| Índice | Fuera de rango (ej: AIN(9)) | Consulta rangos válidos del modelo |
ERR con una expresión bien escrita | Más de 5 niveles de anidamiento o más de 99 caracteres (v1.09.28+) | Simplifica la expresión: ver Límites de la expresión |
-1 inesperado | ANGV, ANG6, SQR o ACS recibieron una entrada no válida | Revisa el dato de origen (por ejemplo, un sensor vencido) |
Compatibilidad
Ver también
- Lista de Disparadores - Señales disponibles
- Motor de Eventos - Uso en reglas
- Reportes de Usuario Ux - Integración con EVAL