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.9.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 | 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 | |
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 |
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 |
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 |
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 |
🧮 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: Inf
💬 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 o sintaxis incorrecta | Verifica ortografía, usa valor_error |
Inf | División por cero | Valida divisor o 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 |
Compatibilidad
Ver también
- Lista de Disparadores - Señales disponibles
- Motor de Eventos - Uso en reglas
- Reportes de Usuario Ux - Integración con EVAL