Skip to Content

Comando EVAL - Evaluador de Expresiones

Motor de evaluación de expresiones matemáticas, lógicas y de estado del sistema.


📋 Sintaxis

EVAL expresión[:formato[:valor_error]]
ParámetroDescripciónDefault
expresiónOperación o consulta a evaluar(obligatorio)
formatoFormato de salida estilo printf%.2f
valor_errorValor si falla la evaluaciónERR

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

VariableDescripciónUnidadLink
VTensión principaldV (28.0V = 280)
VBUTensión batería respaldodV
OTOdómetro totalmetros
OPOdómetro parcialmetros
CREGEstado registro red-
CSQCalidad señal celular0-31
HOHorómetrosegundos
VELVelocidad GPS filtradakm/h
HDGRumbo GPS (heading) (v1.09.18+)0-360°
AGEEdad dato GPSsegundos
LATLatitudgrados×10⁵
LONLongitudgrados×10⁵
IGNEstado ignición0/1
CELConexión celular0/1
GPSGPS activo0/1
PWRAlimentación0/1
JMDJamming detectado0/1
PKParking0/1
ACAcelerómetro0/1
WIFWiFi0/1
CANBus CAN0/1
ALTAltitud GPS (v1.09.19+)metros
TICKTicks desde arranquesegundos
TTTacómetro interno (pulso/seg)0/1
BUFBuffer de reportes con pendientes0/1
BTHPWRAlimentación Bluetooth0/1
BTHCliente Bluetooth conectado (v1.09.26+)0/1
WIFPWRAlimentación WiFi0/1
CELPWRAlimentación módulo celular0/1
GPSPWRAlimentación módulo GPS0/1
VIOPWRAlimentación de accesorios0/1
INTPWRAlimentación interna0/1
DTCNCantidad de fallas activas de la ECU (v1.09.27+)0-32

Con Un Parámetro

VariableDescripciónRangoLink
AIN(n)Entrada analógica0-3
IN(n)Entrada digital0-3
XP(n)Salida digital0-n
UV(n)Variable de usuario0-n
U(n)Variable auxiliar0-n
MXB(n)Buffer XB0-n
DC(n)Ángulo (ANG)0-n
DV(n)Frecuencia (FRE)0-n
OW(n)Sensor 1-Wire0-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

VariableDescripciónParam 1Param 2
ECU(i;t)Datos ECUÍndice0=valor, 2=edad (ms)
MBS(i;t)Sensores BLEÍndice0=temp, 1=humedad
MBSW(i;t)BLE wildcardÍndice0=connected, 1=major, 2=minor, 3=distance, 4=rssi, 5=age
MDT(i;t)Sensor 1-Wire (temp)Índice0=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Índice0=estado, 1=timer, 2=dist, 3=timeout, 4=distanceout
MTR(i;t)TripsÍndice0=trigger, 1=habilitado, 2=hora, 3=minuto, 4=segundo
MNT(i;t)ContadoresÍndice0=actual, 1=máximo
MDL(i;t)Datos LOGÍndice0=cantidad, 1=pendientes, 2=habilitado, 3=reintentos, 4=tiempo reintento
MPC(i;t)Contador pulsosÍndice0=valor, 1=factor K
MFC(i;t)FrecuencímetroÍndice0=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.

LlamadaDevuelve
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ónDevuelveSi 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 yATN2(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

OperadorDescripciónEjemploResultado
+SumaEVAL 10 + 515.00
-RestaEVAL 20 - 812.00
*MultiplicaciónEVAL 3 * 412.00
/DivisiónEVAL 10 / 25.00
%Módulo (resto entero)EVAL 10 % 31.00

Comparadores

OperadorDescripciónEjemploResultado
gtMayor queEVAL 5 gt 31.00
ltMenor queEVAL 5 lt 71.00
geMayor o igualEVAL 5 ge 51.00
leMenor o igualEVAL 4 le 51.00
eqIgualEVAL 5 eq 51.00
neNo igualEVAL 5 ne 61.00

Lógicos

OperadorDescripciónEjemploResultado
&&AND lógicoEVAL (5 gt 3) && (2 lt 4)1.00
||OR lógicoEVAL (5 gt 6) || (2 lt 4)1.00
^^XOR lógicoEVAL 1 ^^ 01.00
!NOT lógico (unario)EVAL !01.00

Bitwise

OperadorDescripciónEjemploResultado
&AND bit a bitEVAL 5 & 31.00
|OR bit a bitEVAL 5 | 27.00
^XOR bit a bitEVAL 5 ^ 36.00
~NOT bit a bit (unario)EVAL ~0 & 0xFF255.00
slShift leftEVAL 2 sl 14.00
srShift rightEVAL 4 sr 12.00

📝 Formato de Salida

Personaliza la presentación del resultado usando sintaxis printf de C:

FormatoDescripciónEjemploResultado
%.2fFlotante 2 decimalesEVAL 3.14159:%.2f3.14
%.3fFlotante 3 decimalesEVAL 3.14159:%.3f3.142
%dEnteroEVAL 5.7:%d5
%xHexadecimal minúsculasEVAL 15:%xf
%XHexadecimal mayúsculasEVAL 15:%XF
%bBinarioEVAL 5:%b101
%05.2fCon ceros izquierdaEVAL 3.14:%05.2f03.14
%08.2fMás ceros izquierdaEVAL 3.14:%08.2f00003.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ímiteValor
Anidamiento5 niveles. Suma un nivel cada paréntesis, cada función con argumentos y cada signo unario (-, !, ~)
Largo de la expresión99 caracteres
Largo del formato y del valor_error19 caracteres cada uno
>EVAL (((((1)))))< // 5 niveles: 1.00 >EVAL ((((((1))))))< // 6 niveles: ERR

Los 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

ErrorCausaSolución
ERRVariable no definida, sintaxis incorrecta o división por ceroVerifica ortografía y divisores, usa valor_error
SintaxisParéntesis desbalanceadosRevisa estructura de expresión
ÍndiceFuera de rango (ej: AIN(9))Consulta rangos válidos del modelo
ERR con una expresión bien escritaMá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 inesperadoANGV, ANG6, SQR o ACS recibieron una entrada no válidaRevisa el dato de origen (por ejemplo, un sensor vencido)

Compatibilidad

ZE-IoT
SP-IoT
SM-IoT

Ver también

Última actualización