Una entrada digital y una salida digital son contactos (pines conectores) a los que se aplica voltaje de solo dos niveles: uno corresponde al estado activado (1 o Encendido), y el otro al estado desactivado (0 o Apagado). Por lo tanto, las entradas y salidas digitales se utilizan para conectar al rastreador dispositivos o circuitos que transmiten solo dos estados posibles. Por ejemplo, se puede conectar un sensor de estado de puerta a una entrada digital del rastreador para que este pueda determinar si está abierta o no. Y a una salida digital del rastreador se puede conectar un dispositivo antirrobo que será controlado por el rastreador y bloqueará el encendido.

Cabe señalar que si el cliente necesita un valor numérico exacto, se requiere un conector analógico. Porque si, por ejemplo, se usa una entrada digital para un sensor de nivel de combustible, solo podrá saber si hay combustible en el tanque o no.

El número de entradas y salidas digitales en un rastreador puede ser bastante grande (por ejemplo, el Galileosky 7x puede tener de 6 a 10 entradas digitales dependiendo de la modificación y configuración). Por lo tanto, los usuarios a menudo se preguntan: ¿a qué entrada o salida digital conectó el mecánico el dispositivo para el cliente? Con las instrucciones a continuación, podrá obtener la respuesta requerida.

Visualización de entradas/salidas digitales

Primero, cabe señalar que el estado de las entradas y salidas digitales en Wialon se presenta en forma de dos números hexadecimales (HEX), obtenidos de números binarios (BIN), en los que cada bit corresponde a una entrada/salida con el mismo número. El parámetro con estos valores tiene el nombre I/O (abreviatura de Inputs/Outputs) y contiene dos números separados por una barra diagonal: a la izquierda está el valor correspondiente al estado de todas las entradas, y a la derecha, al estado de las salidas.

¿Por qué se eligió esta implementación? Analicemos un ejemplo.

Supongamos que el equipo está conectado a las entradas digitales 1, 3, 4 y 7, así como a las salidas 1, 3, 6 y 8. Supongamos también que en el mensaje considerado todas las entradas y salidas mencionadas están activadas. Si se usara un parámetro separado en el mensaje para cada uno de ellos, vería lo siguiente:

in1=1, in2=0, in3=1, in4=1, in5=0, in6=0, in7=1, in8=0, out1=1, out2=0, out3=1, out4=0, out5=0, out6=1, out7=0, out8=1

Y en la implementación actual en Wialon, verá el siguiente registro:

I/O=4D/A5

Y la obvia brevedad del registro en este caso es la ventaja clave.

Determinación del número de entrada/salida digital activada

Si se conoce el número N de la entrada o salida, el parámetro correspondiente tendrá la forma inN, y el parámetro de salida, outN. Por ejemplo, el parámetro para la cuarta entrada es in4, y para la cuarta salida es out4.

Sin embargo, si no conoce el número de la entrada o salida a la que está conectado el equipo, puede usar uno de dos métodos: selección o enfoque matemático.

Selección

Al conectar el equipo, los mecánicos suelen usar las primeras entradas/salidas. Es decir, si se trata de un dispositivo o circuito que transmite información al rastreador, vale la pena verificar in1-in4, y si se trata de un dispositivo o circuito controlado por el rastreador, out1-out4.

Para buscar la entrada necesaria, puede crear 4 sensores con el tipo Sensor digital personalizado basados en estos parámetros (por ejemplo, en el primer sensor en la línea Parámetro será in1, en el segundo in2 y así sucesivamente). Luego vaya al panel Mensajes, seleccione el tipo de mensajes Mensajes de datos y en el menú de abajo indique Valores de sensores. Después de esto, ejecute mensajes para el intervalo cuando el equipo estuvo primero apagado y luego encendido, para encontrar el momento de transición del estado Apagado al estado Encendido en una de las columnas, cada una de las cuales corresponde al sensor creado.

Este es el método práctico más rápido para encontrar la entrada necesaria (de manera similar se puede trabajar con las salidas, pero en este caso se deben usar los parámetros out1, out2, etc.). Si no funciona, puede recurrir al enfoque matemático.

Enfoque matemático

Si no conoce el número de la entrada/salida a la que está conectado el equipo, puede usar las siguientes instrucciones:

1. Vaya al panel Mensajes, seleccione el tipo de mensajes Mensajes de datos y en el menú de abajo indique Datos sin procesar.
2. Ejecute mensajes para el intervalo cuando el equipo estuvo primero apagado y luego encendido.
3. Después de mostrar la tabla con mensajes del rastreador, preste atención a la columna Parámetros y encuentre allí el parámetro I/O (está ubicado al final de la línea).
   
   Supongamos que en el mensaje donde el equipo estaba apagado, el parámetro I/O=102/0, es decir, las salidas digitales están desactivadas (o incluso no conectadas), y algunas entradas digitales están activadas.
   
   
4. Abra la aplicación Calculadora (está instalada en cada computadora, o se pueden encontrar sus análogos en Internet) y cámbiela al modo Programador (o similar, que permite convertir valores de un sistema numérico a otro).
5. Cambie la calculadora al sistema numérico hexadecimal (HEX).
6. Ingrese el valor 102 encontrado anteriormente.
7. La aplicación automáticamente (o al presionar la tecla Enter) le presentará este número en diferentes sistemas numéricos. Nos interesa el registro en forma binaria (BIN), que consiste solo en ceros y unos.
   
   
   
   
8. Examine el número binario obtenido. Tenga en cuenta que el conteo del número de bit va de derecha a izquierda (como en el sistema decimal, donde las unidades están a la derecha, a su izquierda están las decenas, luego las centenas, miles, etc.): 0001 0000 0010

9. Determine los números de bits para este número (la numeración de bits en Wialon comienza desde 1):

   Número	12	11	10	9	8	7	6	5	4	3	2	1
   Valor	0	0	0	1	0	0	0	0	0	0	1	0

10. De este registro se puede concluir que en este mensaje están activadas las entradas 2 y 9 (es decir, in2=1, in9=1), y todas las demás entradas están desactivadas (es decir, su valor es cero).
11. Ahora encuentre el mensaje en el que el equipo estaba encendido. Supongamos que contiene el parámetro I/O=10A/0.
12. Repita los pasos 4-8 para el valor 10A.
    
    
    
    

13. Determine los números de bits para este número:

    Número	12	11	10	9	8	7	6	5	4	3	2	1
    Valor	0	0	0	1	0	0	0	0	1	0	1	0

14. En este mensaje están activadas las entradas 2, 4 y 9 (es decir, in2=1, in4=1 e in9=1).
15. Compare los resultados de los pasos 10 y 14. Como se puede notar fácilmente, solo difieren en el estado del parámetro in4, es decir, en el ejemplo dado, el equipo estaba conectado a la entrada 4.

Uso de entradas/salidas digitales

El parámetro de entrada o salida digital se puede usar de la misma manera que cualquier otro parámetro.

Al crear sensores para entradas/salidas digitales, los tipos más adecuados son los del grupo Digitales, ya que implican solo dos estados (Encendido y Apagado).

Un método único de uso, que solo está disponible para entradas digitales, es la notificación con el tipo Entrada digital, para la cual ni siquiera es necesario crear un sensor.

Oleg Zharkovsky,Customer Service Engineer 2022-02-03

Una de las primeras y principales etapas del trabajo con Wialon es la configuración de sensores en la unidad. Si los sensores se configuran correctamente, algunos algoritmos estándar darán resultados más precisos y podrá utilizar funcionalidades previamente no disponibles. En este artículo, se examinará en detalle la tabla de cálculo, una herramienta de la pestaña del mismo nombre, ya que es la que más frecuentemente causa dificultades al configurar sensores.

Principio general de funcionamiento de los sensores

Wialon soporta muchos tipos de rastreadores (la cantidad actual se puede encontrar en el sitio web wialon.com en la sección Hardware), y cada uno de ellos "habla" en su propio "idioma". Por lo tanto, los parámetros que provienen de diferentes rastreadores y se muestran en la pestaña Mensajes pueden contener la misma información (por ejemplo, sobre temperatura o kilometraje), pero tener diferentes nombres. Para que el usuario no note diferencias al usar unidades con diferentes tipos de rastreadores, es necesario crear sensores para cada unidad en Wialon. Los sensores tienen un tipo determinado, lo que permite al sistema entender qué algoritmo se debe usar para procesar los parámetros entrantes.

Sin embargo, a menudo simplemente elegir el tipo de sensor e indicar un parámetro en él no es suficiente, porque el valor del parámetro llega de una forma no obvia para el usuario. Por ejemplo, temp=125 puede significar 125°F, 125°C, 12.5°C o incluso −3°C. Existen 3 métodos para convertir el parámetro entrante a la forma deseada:

1. Expresión en la línea Parámetro;
2. Tabla de cálculo;
3. Validación.

Se pueden usar por separado o combinar. Si se usan varios métodos simultáneamente, se aplicarán en el orden en que se enumeran arriba.

Esquemáticamente, el uso de sensores se puede representar de la siguiente manera:

1. El sensor conectado al rastreador mide algún valor físico, que designaremos como S.
2. El sensor convierte este valor y la transmite al rastreador. Del rastreador a Wialon llega el parámetro X.
3. Basándose en el parámetro, se crea un sensor en Wialon. Para obtener un valor Y comprensible para el usuario, se aplican transformaciones f(X) al parámetro en el sensor.
4. Idealmente, después de las transformaciones en el sensor, el valor Y=f(X) debería ser igual al valor que se midió en la primera etapa. Luego, Y se utilizará en tooltips, informes, notificaciones y otras funcionalidades de Wialon.

Dado que este artículo solo trata sobre la configuración de la tabla de cálculo en Wialon, del esquema anterior solo prestaremos atención a los siguientes elementos:

Cuándo se usa la tabla de cálculo

Por lo general, la tabla de cálculo se usa en casos donde es necesario transformar el parámetro de entrada. Sin embargo, los 3 métodos mencionados anteriormente sirven para esto. ¿En qué caso se debe recurrir específicamente a la tabla de cálculo?

Desde el punto de vista de la aplicación práctica, se puede decir que la tabla de cálculo se utiliza:

• para la tabla de calibración (por ejemplo, para sensores de peso o nivel de combustible);
• para sensores digitales basados en datos de entrada analógicos (por ejemplo, para sensores de ignición basados en voltaje);
• para sensores basados en códigos que describen diferentes estados pero llegan en un solo parámetro (por ejemplo, device_status=4 muestra el estado de la ignición del motor, y device_status=13 significa que el botón de pánico está presionado, etc.);
• para sensores que deben mostrar valores positivos y negativos, aunque el parámetro asociado solo tiene valores positivos (por ejemplo, para sensores de temperatura);
• para cualquier sensor en el que sea necesario separar el rango de valores correctos y erróneos (por ejemplo, si el sensor envía valores especiales en el parámetro que indican errores).

Configuración de la tabla de cálculo

La tabla de cálculo implica trabajar con las funciones lineales más simples. Es decir, la tabla de cálculo transforma los datos de acuerdo con la siguiente fórmula: Y=a⋅X+b que es una de las variantes de la ecuación de una línea recta.

Si entendemos cómo funciona cada componente de esta herramienta, se pueden crear soluciones bastante útiles e inusuales con su ayuda. Por lo tanto, a continuación examinaremos cada área de la pestaña Tabla de cálculo por separado, visualizando su impacto en el resultado mediante un gráfico.

Pares XY

En la parte derecha se encuentra el bloque Pares XY. Su llenado no es suficiente para el funcionamiento de la tabla de cálculo, pero puede simplificar su configuración.

Se pueden agregar pares tanto manualmente como mediante la importación de archivos CSV o TXT (la exportación solo está disponible en CSV). Después de llenar todas las filas de este bloque, es necesario hacer clic en el botón Generar (se entiende "Generar tabla de cálculo basada en pares XY"), lo que llevará al cálculo de los valores X, a y b en la parte izquierda de la ventana.

Cada uno de los pares XY agregados corresponde a un punto en el gráfico. Como puede saber, se puede trazar una línea recta a través de 2 puntos. Por lo tanto, si se introducen 5 pares XY, se obtendrán 4 líneas rectas en el gráfico.

X es valor de entrada

El bloque central de la pestaña Tabla de cálculo contiene filas con valores X, a y b. Cada fila corresponde a una línea recta en el gráfico. El valor X en cada fila significa el comienzo de una nueva línea recta, es decir, establece el intervalo donde se usarán los nuevos valores a y b.

Como ejemplo, consideremos una tabla con los siguientes valores:

De otra manera, esta condición se puede escribir así:

• De −∞ a 3 (sin incluir) se aplica la ecuación Y=1⋅X-2.
• De 3 (incluyendo) a 5.5 (sin incluir) se aplica la ecuación Y=0⋅X+3.
• De 5.5 (incluyendo) a +∞ se aplica la ecuación Y=-0.5⋅X+2.

Ejemplo de gráfica obtenida al llenar la tabla de cálculo

a es coeficiente de inclinación de la línea recta

Cuando a=0, la inclinación será 0°, es decir, la línea será paralela al eje X.
Cuando a=1, la inclinación será 45°, es decir, cuanto mayor sea el coeficiente, más cerca estará la línea del eje Y.
Cuando a=-1, la inclinación será −45°, es decir, los valores negativos de este coeficiente inclinan la línea hacia abajo, y los positivos hacia arriba.

Ejemplo de gráfico de la línea recta Y=a⋅X con diferentes coeficientes de inclinación

b es desplazamiento de la línea recta a lo largo del eje Y

Cuando b=0, no hay desplazamiento.
Cuando b>0, la línea se desplaza hacia arriba con respecto al eje X.
Cuando b<0, el desplazamiento es hacia abajo.

Ejemplo de líneas con diferentes desplazamientos

Límites inferior y superior

Los límites permiten descartar valores erróneos del sensor según un principio simple: si el valor está fuera del rango entre el límite inferior y superior, el sensor mostrará un guion (error).

Consideremos un ejemplo con un sensor de nivel de combustible. Supongamos que los valores del parámetro de 3 a 250 corresponden a un volumen de combustible de 0 litros a 100 litros. Y los valores del parámetro 0 o 255 indican errores que queremos excluir para que no se interpreten como un volumen real (ya que en el tanque considerado no puede haber menos de 0 o más de 100 litros de combustible). Para este ejemplo, se puede proponer una solución con la opción Aplicar después del cálculo desactivada:

También existe una solución con la opción Aplicar después del cálculo activada:

Del ejemplo se puede entender que la opción Aplicar después del cálculo afecta a qué valores se aplican los límites: si está desactivada, se filtran los valores en el eje X (valores de entrada antes de aplicar la tabla de cálculo), y si está activada, se filtran los valores en el eje Y (valores del sensor después de aplicar la tabla de cálculo).

Para visualizar el funcionamiento de los límites, consideremos otro ejemplo en el que se aplican los mismos límites a la misma línea recta, y la diferencia radica solo en la opción Aplicar después del cálculo, que afecta significativamente el resultado.

Límite inferior igual a 2, límite superior igual a 3, opción Aplicar después del cálculo desactivada

Límite inferior igual a 2, límite superior igual a 3, opción Aplicar después del cálculo activada

Principio de funcionamiento de la tabla de cálculo

A veces, para entender la esencia de un fenómeno, es necesario ir al revés. Si conocemos la fórmula exacta Y=f(X) que relaciona los valores de entrada y salida en todo el rango, no es necesario recurrir a la tabla de cálculo; es suficiente simplemente usar la expresión en la línea Parámetro. Consideremos tal caso.

Por ejemplo, supongamos que el valor de entrada está relacionado con el de salida por la siguiente fórmula: Y=0.5⋅X². Como parámetro, tomemos adc3. Para describir tal fórmula en Wialon, es necesario insertar la siguiente expresión en la línea Parámetro: const0.5*adc3^const2

Gráfico de la función Y=0.5⋅X²

Pero ¿qué hacer si no conocemos la fórmula exacta Y=f(X)? Es precisamente en este caso que nos ayudará la tabla de cálculo.

Supongamos que en ciertas condiciones conocemos los valores de la magnitud medida (esto será Y) y podemos verificar qué valor tomará el parámetro en Wialon en estos puntos (esto será X). De esta manera, podemos obtener valores, por ejemplo, en 4 puntos: (0; 0), (1; 0.5), (2; 2), (3; 4.5). Luego, trazamos estos puntos (X, Y) en el gráfico y los conectamos con segmentos de color rojo.

Reproducción de parte de la función Y=0.5⋅X² con segmentos construidos a partir de 4 puntos

No es difícil notar que el resultado es cercano al que se obtiene por la fórmula, pero aún hay diferencias. En algunos casos, tal precisión será suficiente, y si no lo es, se pueden medir valores en más puntos. En el gráfico de abajo se muestra un ejemplo para 6 puntos: (0; 0), (0.5; 0.125), (1; 0.5), (1.5; 1.125), (2; 2), (3; 4.5).

Reproducción de parte de la función Y=0.5⋅X² con segmentos construidos a partir de 6 puntos

Justificación y ejemplos de uso

En esta sección, consideraremos varios casos en los que la tabla de cálculo será útil.

La forma de la curva que describe la relación entre X e Y puede ser bastante compleja.

Por ejemplo, al usar un sensor de nivel de combustible, es necesario calibrar el tanque, y la forma del gráfico construido según la tabla de calibración dependerá de la geometría del tanque, que nunca es ideal (puede tener curvas, abolladuras, costillas internas, etc.).

Gráfico construido según la tabla de calibración con pequeños pasos entre mediciones

Describir tal dependencia con una sola fórmula es bastante problemático. Una forma más simple de describir la curva para el sistema es dividirla en intervalos donde se comporta aproximadamente como una línea recta y determinar las fórmulas de estas líneas. Se puede obtener un resultado similar usando pares XY.

Reproducción de la forma de una curva compleja mediante segmentos que pasan por 11 puntos

Además, a veces la dependencia entre X e Y puede ser diferente en varios intervalos. Para describirla, es necesario utilizar un sistema de varias expresiones, lo cual no se puede hacer en la línea Parámetro en las propiedades del sensor.

Por ejemplo, algunos sensores de temperatura funcionan de la siguiente manera: los valores de X en el rango de 0 a 127 corresponden a temperatura positiva, y en el rango de 128 a 255 a temperatura negativa. Para procesar tal caso, se necesitarán dos líneas en la tabla de cálculo:

X=0; a=1; b=0
X=128; a=1; b=-256

Gráfico de temperatura, donde valores más altos del parámetro corresponden a temperatura negativa

Los sensores digitales son otro ejemplo claro de una situación donde la dependencia entre X e Y es diferente en varios intervalos. Por ejemplo, se puede crear un sensor de ignición basado en el parámetro de voltaje, y para esto es necesario considerar dos condiciones: Y=0 cuando X<14, Y=1 cuando X≥14. Pero, como ya sabemos, no se puede hacer esto usando una expresión en las propiedades del sensor. Y en la pestaña Tabla de cálculo, para esto se necesitarán solo dos líneas:

X=0; a=0; b=0
X=14; a=0; b=1

Gráfico del estado de ignición en función del voltaje

Oleg Zharkovsky,Customer Service Engineer 2023-02-21

Algunos rastreadores no envían información sobre el combustible, o los sensores de combustible simplemente no están instalados en la unidad, sin embargo, los usuarios aún quieren ver información sobre el consumo en el informe.

Como alternativa a los sensores de combustible, se puede utilizar el Consumo por tarifa, que se configura en la pestaña Avanzadas. Su algoritmo de cálculo es simple: el kilometraje durante el intervalo se multiplica por la norma de consumo especificada (l/100 km), que puede variar según la temporada. Pero en este artículo examinaremos otra opción para calcular el consumo sin sensor, que requiere más explicaciones: el Consumo por cálculo, también llamado Cálculo matemático. Además, su ámbito de aplicación no se limita a una sola opción.

Dónde se utiliza el consumo por cálculo

En primer lugar, el consumo por cálculo se utiliza en informes para compensar la ausencia de sensores de combustible o para verificar sus lecturas. Para mostrar los resultados del cálculo matemático, agregue a la tabla las columnas Consumido por cálculo, Consumo promedio por cálculo u otras que incluyan "por cálculo" en su nombre.

El consumo por cálculo también se utiliza en algoritmos de combustible. Primero, para buscar descargas, si la opción Calcular descargas según el tiempo está activada. Segundo, para calcular el consumo en intervalos con valores erróneos, si la opción Reemplazar valores inválidos por los calculados matemáticamente está activada. Ambas opciones mencionadas se encuentran en los ajustes avanzados del Sensor del nivel de combustible (SNC).

Cómo funciona el cálculo matemático

El sistema determina el consumo esperado en el intervalo utilizando un modelo matemático. Se forma en base a:

• sensores de funcionamiento del motor (Sensor de ignición del motor u Horas de motor absolutas/relativas), que indican la norma de consumo en ralentí;
• sensores de eficiencia del motor (SEM), cada uno de los cuales indica la influencia de algún factor en el consumo de combustible (revoluciones del motor, temperatura, carga del eje, funcionamiento del aire acondicionado, equipo auxiliar, etc.).

El consumo por cálculo para un intervalo es la suma de los consumos entre todos los mensajes del intervalo. Para calcular el consumo por cálculo entre el mensaje actual y el anterior, se utiliza la siguiente fórmula:

Δt ⋅ ( C_{I 1} + C_{I 2} + ... + C_{I N} ) ⋅ (K_{EES 1} + (K_{EES 2} - 1) + (K_{EES 3} - 1) + ... + (K_{EES M} - 1)),

donde Δt es el tiempo entre mensajes; C_{I j} es la norma de consumo en ralentí del i-ésimo sensor de funcionamiento del motor que estaba activado en el mensaje considerado; N es el número de sensores de funcionamiento del motor creados en la unidad; K_{EES i} es el valor del j-ésimo sensor de eficiencia del motor en el mensaje considerado; M es el número de sensores de eficiencia del motor creados en la unidad.

Por qué vincular sensores de funcionamiento del motor, SEM y SNC

Algunas unidades tienen varios motores a la vez. Esto se aplica con mayor frecuencia a maquinaria especial, y un buen ejemplo aquí es un camión hormigonera: su motor principal hace que el vehículo se mueva, y un motor autónomo adicional gira el tambor mezclador. La aceleración del vehículo o el encendido del aire acondicionado pueden afectar el consumo del motor principal, pero no afectarán el consumo del motor adicional. Por lo tanto, algunos factores que influyen en el consumo (los tenemos en cuenta con SEM) afectan solo a uno de los motores (los tenemos en cuenta con sensores de funcionamiento del motor). Al mismo tiempo, la unidad puede tener varios tanques de combustible (los tenemos en cuenta con SNC), que también deben vincularse a un motor específico.

Para realizar la conexión, es necesario entrar en las propiedades del sensor de ignición o de los sensores de horas de motor absolutas/relativas y seleccionar los SEM correspondientes. De manera similar, en las propiedades del SNC se configura su conexión con los sensores de funcionamiento del motor.

Cómo crear rápidamente un modelo matemático

Para crear un modelo matemático básico, utilice el Asistente para consumo por cálculo, ubicado en la pestaña Sensores en las propiedades de la unidad. En la ventana del Asistente para consumo por cálculo, es necesario ingresar información sobre el consumo de combustible en diferentes modos de operación, así como el coeficiente estacional y las fechas de inicio y fin de la temporada. Consideremos estos campos en más detalle:

• Consumo (l/h) implica el consumo en ralentí, es decir, con el motor encendido y sin movimiento. La Velocidad mínima de movimiento se toma de la Detección de viajes.
• Ciclo urbano y Ciclo suburbano (l/100km) son características estándar del vehículo que se pueden encontrar en documentos, en Internet o calcular en la práctica. Al mismo tiempo, en diferentes países se utilizan diferentes enfoques para determinar estos ciclos. En Wialon, la norma del ciclo urbano corresponde a una velocidad de 36 km/h, y la del ciclo en carretera a 80 km/h.
• El Coeficiente estacional (%) implica en qué porcentaje aumenta el consumo de combustible durante la temporada especificada en relación con el resto del año. La consideración del coeficiente estacional se puede desactivar si no se observa un cambio significativo de temperatura durante el año en el área de uso del vehículo.

Al completar el Asistente para consumo por cálculo, creará un modelo matemático básico que solo tiene en cuenta la velocidad de la unidad y la influencia de la temporada. Tal modelo es aproximado, ya que en realidad la velocidad no afecta el consumo — lo que afecta son las revoluciones del motor, así como la temporada no afecta — en realidad, lo que afecta el consumo es la temperatura. Sin embargo, la mayoría de los rastreadores por defecto no envían información sobre las revoluciones del motor y la temperatura. Por lo tanto, elegimos un modelo que es adecuado para todos los rastreadores.

No será posible crear un modelo más preciso automáticamente, pero se puede hacer manualmente agregando SEM por cuenta propia.

Cómo funcionan los sensores de eficiencia del motor

El valor del SEM (Sensor de eficiencia del motor) en cada mensaje debe mostrar cuántas veces algún factor influyente aumenta el consumo en ralentí en relación con el consumo sin la influencia de este factor. Para una mejor comprensión, consideremos un ejemplo.

Supongamos que el consumo en ralentí es de 2 l/h, y cuando se enciende el sistema de calefacción, el consumo aumenta a 2.2 l/h. Por lo tanto, la relación de estas cantidades es: 2.2/2 = 1.1 También supongamos que el parámetro in4 indica inequívocamente el estado del sistema de calefacción: si este parámetro es igual a 0, la calefacción está apagada, y si es igual a 1, está encendida. En este caso, para tener en cuenta la influencia del sistema de calefacción en el consumo, es necesario crear un sensor con el tipo Sensor de eficiencia del motor, especificar in4 en la línea Parámetro, y agregar las siguientes líneas a la Tabla de cálculo:

x = 0; a = 0; b = 1
x = 1; a = 0; b = 1.1

Resulta que cuando el sistema de calefacción está apagado, el SEM aumenta el consumo en 1 vez (es decir, no lo cambia en absoluto), y cuando está encendido, lo aumenta en 1.1 veces. Adicionalmente, vale la pena señalar que un valor cero del SEM tampoco cambiaría el consumo.

De la manera descrita anteriormente, se puede tener en cuenta la influencia de un factor en el consumo esperado. Si hay varios sensores de eficiencia del motor, todos sus valores se consideran simultáneamente, formando el consumo esperado en el intervalo entre dos mensajes (ver la fórmula anterior).

Cómo hacer el consumo por cálculo más preciso

Cabe señalar de inmediato que si ha activado la opción Calcular descargas según el tiempo en las propiedades del sensor del nivel de combustible, el sistema comparará el consumo por cálculo con el consumo por SNC, y las lecturas de este último, desafortunadamente, no son muy precisas. Por lo tanto, no es necesario tratar de llevar el modelo matemático a la perfección, ya que al final esto puede no afectar el resultado de la comparación con el SNC.

Sin embargo, puede intentar aumentar la precisión del modelo de las siguientes maneras.

Considere más factores

Puede crear más SEM basados en parámetros del rastreador que describen factores que influyen en el consumo.

Vale la pena señalar que muchos factores afectan el consumo, pero el grado de su influencia puede variar. Por ejemplo, probablemente no vale la pena instalar un sensor de humedad del aire, aunque también puede afectar el consumo. Medir la presión de los neumáticos tiene más sentido, aunque por otro lado es mejor simplemente no permitir el uso de neumáticos desinflados. Pero no espere una alta precisión del modelo matemático si decide ignorar el peso de la carga, que se puede medir con un sensor de carga del eje. Es decir, la elección de los factores a considerar debe abordarse teniendo en cuenta el grado de su influencia en el resultado.

Aumente la precisión de la medición de parámetros

Esta recomendación se deriva de la anterior. Para mejorar el resultado, no solo puede aumentar el número de sensores, sino también utilizar sensores de mayor precisión.

Aumente la frecuencia de generación de mensajes

Si los factores que influyen en el consumo cambian con frecuencia, el rastreador también debe generar mensajes con frecuencia, de lo contrario no será posible tenerlos en cuenta completamente. Por ejemplo, esto se aplica a los viajes por la ciudad, durante los cuales un automóvil puede detenerse en varios semáforos en 10 minutos, pero si durante este tiempo solo se registra un mensaje en la memoria del rastreador, el modelo matemático simplemente no podrá tener en cuenta cada cambio de velocidad.

Por qué el consumo por cálculo muestra valores incorrectos

Puede haber varias razones para tal comportamiento.

1. Las normas utilizadas en el Asistente para consumo por cálculo pueden diferir de las reales (por ejemplo, debido al desgaste del vehículo). En este caso, puede verificar en la práctica su correspondencia con la realidad.
2. Puede estar relacionado con una configuración incorrecta del consumo por cálculo. Verifique que en las propiedades del sensor de funcionamiento del motor se especifique un valor no nulo en la línea Consumo, l/h. También asegúrese de que el sensor de funcionamiento del motor y el SEM estén conectados.
3. La frecuencia de generación de mensajes por el rastreador puede ser demasiado baja.
4. Puede explicarse por una falla del sensor cuyas lecturas se utilizan en el modelo matemático.
5. En algunos casos, el sistema puede considerar que la ignición estuvo activada todo el tiempo mientras el rastreador no enviaba mensajes. En este caso, el modelo matemático mostrará que el motor debería haber estado consumiendo combustible todo este tiempo. Para corregir la situación, intente establecer un valor correcto para la opción Intervalo máximo entre mensajes en la pestaña Avanzadas en las propiedades de la unidad. Se puede lograr el mismo resultado utilizando la opción Tiempo de espera en las propiedades del sensor de ignición.

Oleg Zharkovsky,Customer Service Engineer 2022-02-04

En esta página solo se indican las diferencias clave entre los algoritmos de combustible. No pretendo enumerar todas las posibles combinaciones de configuraciones de las propiedades del sensor del nivel de combustible, aunque todas ellas afectan en cierta medida al procesamiento de datos. Para estudiar cada una de las opciones, recomiendamos ver los webinarios (Parte I, Parte II, Parte III) o recurrir a la comprobación práctica. Puede cambiar la configuración sin preocuparse por los datos originales, ya que cambiar las opciones de combustible no altera los mensajes, solo afecta al resultado mostrado.

Qué algoritmo elegir

A continuación se presenta una lista de características de los algoritmos que debería ayudarle a tomar una decisión.

Algoritmo por kilometraje

1. Adecuado para la mayoría de las unidades móviles.
2. Relativamente fácil de configurar.
3. Se utiliza por defecto.

Algoritmo por tiempo

1. Adecuado:
   • para unidades estacionarias,
   • para unidades con largos intervalos de ralentí,
   • para unidades con equipos adicionales que aumentan el consumo,
   • cuando se sospecha de descargas durante el movimiento,
   • si el algoritmo por kilometraje no da los resultados esperados.
2. Más complejo de configurar.
3. Para activarlo, se recomienda habilitar simultáneamente las siguientes opciones en las propiedades del sensor del nivel de combustible:
   • Calcular el consumo de combustible según el tiempo,
   • Calcular llenados según el tiempo,
   • Calcular descargas según el tiempo para procesar las descargas también se requiere un modelo matemático de consumo, que se puede crear, por ejemplo, con el Asistente para consumo por cálculo.

Cuál es la diferencia entre los algoritmos

Primero, cabe señalar que el algoritmo por kilometraje en cierto sentido sería más correcto llamarlo algoritmo por velocidad, ya que ignora los mensajes cuya velocidad es menor que la Velocidad mínima de movimiento establecida en la Detección de viajes. Pero como el kilometraje aumenta cuando hay velocidad, el nombre actual también es bastante apropiado.

De lo descrito anteriormente se deduce que la diferencia clave entre los algoritmos es que el algoritmo por tiempo analiza todos los mensajes, mientras que el algoritmo por kilometraje excluye del análisis parte de los mensajes, utilizando una simplificación. Se basa en que se puede juzgar el cambio en el nivel de combustible durante una parada o estacionamiento (es decir, en un intervalo de baja velocidad) por dos mensajes antes y después de la parada o estacionamiento considerado. Por ejemplo, si el vehículo estuvo en el estacionamiento de 14:00 a 16:00, y la descarga se realizó entre las 15:00-15:10, se puede conocer el hecho de la descarga simplemente comparando los niveles de combustible a las 14:00 y 16:00.

Consumo

En ambos algoritmos, el cálculo del consumo para un intervalo se realiza de manera similar: del valor del nivel de combustible al inicio del intervalo se resta el valor del nivel al final del intervalo, y luego se suma el volumen de llenados para ese intervalo. Sin embargo, de la diferencia clave de los algoritmos aún se deduce que consideran diferentes intervalos.

Adicionalmente, señalo que el volumen de descargas por defecto está incluido en el consumo, hasta que se active la opción Excluir descargas del consumo de combustible en los ajustes de la plantilla de informe.

Llenados de combustible

La detección de llenados también ocurre de la misma manera para ambos algoritmos: el sistema busca mensajes con un aumento secuencial en las lecturas del sensor del nivel de combustible. Sin embargo, el algoritmo de cálculo de llenados por kilometraje calcula el llenado durante las paradas usando solo dos puntos (nivel de combustible al final del intervalo de movimiento anterior y al inicio del siguiente), sin analizar todos los mensajes del intervalo considerado.

Descargas de combustible

La detección de descargas se realiza por diferentes métodos:

• El algoritmo por kilometraje calcula la descarga durante la parada usando dos puntos (niveles de combustible al final del intervalo de movimiento anterior y al inicio del siguiente), sin analizar todos los mensajes del intervalo considerado.
• El algoritmo por tiempo compara el consumo real según el sensor del nivel de combustible con el consumo esperado determinado por el modelo matemático.

Oleg Zharkovsky,Customer Service Engineer 2021-12-08

Si los datos recibidos del rastreador cumplen con todos los criterios de detección de descargas, aparecerán registros en la tabla Descargas de combustible, incluso si en realidad no hubo descarga. Estas descargas se denominan falsas.

Para configurar correctamente la detección de descargas, es necesario conocer no solo las características técnicas de los algoritmos de Wialon, sino también los principios de funcionamiento del equipo mismo (rastreadores, sensores y sistema de combustible de la unidad). Este artículo proporciona instrucciones simples que le permitirán eliminar las falsas descargas, basándose únicamente en la gráfica del nivel de combustible.

Pasos obligatorios antes de aplicar las instrucciones

• Se ha creado una unidad en Wialon, los mensajes de datos del rastreador se muestran en el sistema.
• El sensor del nivel de combustible está conectado al rastreador, se ha realizado la calibración del tanque.
• Se ha creado un sensor del tipo Sensor del nivel de combustible (SNC) en la unidad.
• En las propiedades del SNC, se ha activado la opción Calcular datos según el sensor.
• La tabla de calibración (Pares XY) se ha introducido en la Tabla de cálculo del sensor del nivel de combustible, después de lo cual se ha presionado el botón Generar.
• Se ha creado una plantilla de informe con una gráfica de tipo Regular que muestra el Nivel de combustible procesado.
• La gráfica también muestra marcadores de descargas y el fondo de viajes (por defecto es rosa), paradas (azul) y horas de motor (amarillo).

Comportamiento de la gráfica en el área de falsa descarga

Elija una de las opciones presentadas a continuación de acuerdo con lo que observa en la gráfica en el lugar donde se encuentra el marcador de descarga.

1. Fluctuaciones durante el movimiento o funcionamiento del motor

Durante el funcionamiento del motor, el movimiento sobre superficies irregulares o cualquier movimiento en general, se producen fluctuaciones de combustible que el SNC lee. Dependiendo del volumen y forma del tanque, así como de la ubicación de instalación del SNC, estas fluctuaciones pueden alcanzar decenas de litros, lo que puede llevar a la detección de descargas. En general, se pueden compensar utilizando un algoritmo de suavizado.

Para esto, en las propiedades del sensor del nivel de combustible, seleccione el tipo de filtración Filtración de mediana adaptable, en cuyo caso el algoritmo selecciona automáticamente el valor necesario del nivel de filtración.

O bien, en el mismo lugar, puede seleccionar el tipo de filtración Filtración de mediana para ajustar manualmente el suavizado. Para esto, establezca el nivel de filtración (por ejemplo, 3). Tenga en cuenta que los altos grados de filtración solo deben aplicarse con una alta frecuencia de envío de mensajes (1-5 segundos entre mensajes). Después de aplicar la filtración, los algoritmos de combustible trabajarán no con los datos originales, sino con los suavizados.

Para verificar la efectividad del suavizado, agregue a la gráfica la línea Nivel de combustible (antes del suavizado) y compárela con la línea Nivel de combustible procesado (después del suavizado). Si las fluctuaciones de la línea Nivel de combustible procesado aún le parecen significativas, puede intentar aumentar el nivel de filtración (se recomienda hacerlo con un paso de 1). Sin embargo, recuerde que el suavizado puede comenzar a distorsionar los datos de entrada, por lo que es necesario encontrar un punto medio: las fluctuaciones de la línea Nivel de combustible procesado ya no parecen grandes (o no existen en absoluto), pero las líneas antes y después del suavizado aún no difieren demasiado en lugares característicos (por ejemplo, durante llenados/descargas reales).

2. Salto brusco inmediatamente después del inicio o cese del movimiento

Las lecturas del SNC pueden cambiar bruscamente en el momento del inicio/cese del movimiento, lo que puede llevar a la detección de una descarga. Si el nivel de filtración que ha elegido no suaviza estos saltos, y no desea aumentarlo (por ejemplo, en su caso, esto lleva a una gran distorsión de los datos de entrada en otros intervalos), puede utilizar uno de los dos filtros temporales en las propiedades del sensor del nivel de combustible:

• Ignorar mensajes al comenzar el movimiento — esta opción permite excluir del análisis de descargas un número especificado de segundos después del inicio del movimiento.
• Tiempo sin movimiento mínimo para detectar una descarga de combustible — si la duración del intervalo sin movimiento no excede la especificada, este intervalo no se analizará para descargas (de esta manera se pueden cortar las fluctuaciones del nivel de combustible, por ejemplo, durante paradas cortas en semáforos).

3. Caída suave durante el funcionamiento del motor y ausencia de movimiento

En el sistema Wialon existen 2 algoritmos para el análisis de combustible: el algoritmo por kilometraje (se usa por defecto) y el algoritmo por tiempo. Para unidades estacionarias y para unidades con largos intervalos de ralentí, se recomienda utilizar el algoritmo por tiempo. Para esto, active 3 opciones en las propiedades del sensor del nivel de combustible: Calcular llenados según el tiempo, Calcular descargas según el tiempo y Calcular el consumo de combustible según el tiempo. Vale la pena explicar que en el caso considerado se podría haber utilizado solo la opción Calcular descargas según el tiempo, pero la activación simultánea de todas las opciones permitirá lograr una mejor convergencia de todos los indicadores de combustible en los informes.

Al utilizar el algoritmo por tiempo, se compara el consumo según el SNC con el consumo por cálculo, es decir, con el valor calculado según el modelo matemático. En los intervalos de ralentí, el consumo por cálculo generalmente se determina por el sensor de ignición o los sensores de horas de motor. Por lo tanto, abra las propiedades del sensor de ignición o de horas de motor y verifique si la norma correcta de consumo por hora está establecida en el campo Consumo.

4. Descarga durante el movimiento, aunque la gráfica se ve normal

Lo más probable es que esté utilizando el algoritmo de análisis de combustible por tiempo, y también haya activado la opción Detectar descargas de combustible en movimiento en las propiedades del sensor del nivel de combustible. En tal caso, se compara el consumo según el SNC con el consumo calculado matemáticamente. Si el consumo por cálculo está configurado incorrectamente, se puede detectar una falsa descarga donde la unidad simplemente estaba realizando un viaje, por lo que se recomienda verificar el modelo matemático de consumo por cálculo. Se configura a través de:

• sensores de ignición o sensores de horas de motor — en sus propiedades, en el campo Consumo, es necesario especificar la norma de consumo por hora en ralentí;
• sensores de eficiencia del motor (SEM) — este sensor puede utilizar cualquier parámetro que afecte el consumo, y su valor determina el coeficiente de cambio de consumo, que luego se multiplica por el consumo del punto anterior.

Se puede crear un modelo matemático básico de consumo utilizando el Asistente para consumo por cálculo en la pestaña Sensores en las propiedades de la unidad. Este modelo tiene en cuenta la influencia de la velocidad y la temporada en el consumo de combustible utilizando sensores de eficiencia del motor. Luego, el modelo matemático se puede complementar con otros sensores de eficiencia del motor que tendrán en cuenta otros factores que influyen en el consumo (peso de la carga, temperatura, funcionamiento de equipos auxiliares, etc.).

5. Saltos significativos al mínimo/máximo

Si en la gráfica se observan saltos de la línea Nivel de combustible procesado a 0 o al valor máximo (a menudo es 2¹⁶-1=65535) y de vuelta al valor actual, incluso después de aplicar el suavizado, estos saltos pueden llevar a la detección de falsas descargas. Tales saltos en las lecturas pueden estar relacionados con una configuración incorrecta o una conexión inadecuada del sensor del nivel de combustible al rastreador.

Se recomienda corregir este problema desde el lado del hardware, sin embargo, desde el lado de Wialon también puede intentar eliminar estas lecturas utilizando la Tabla de cálculo. Para ello, entre en las propiedades del SNC, vaya a la pestaña Tabla de cálculo y establezca los valores del Límite inferior y/o Límite superior correspondientes al tanque vacío y lleno. Sin embargo, en el límite inferior es mejor no escribir 0, sino un valor cercano a cero (por ejemplo, 0.1) para eliminar los falsos saltos de lecturas a 0.

6. Saltos significativos no al mínimo/máximo

Si las lecturas del SNC cambian en cantidades significativas (pero no a 0 o al valor máximo) y luego vuelven al valor actual, incluso después de aplicar el suavizado, estos saltos pueden llevar a la detección de falsas descargas. Este comportamiento puede estar relacionado con saltos de voltaje, que se pueden notar en el gráfica usando la línea Voltaje, si tiene creado un Sensor de voltaje.

Se recomienda corregir tales situaciones desde el lado del hardware, sin embargo, desde el lado de Wialon puede intentar compensar esta influencia a través de la Validación. Para ello, es necesario aplicar las siguientes instrucciones:

1. Abra la pestaña Mensajes y solicite mensajes con datos sin procesar para el intervalo que incluye el salto de nivel de combustible investigado.
2. Manualmente o usando un filtro, encuentre otro parámetro que cambie simultáneamente con las lecturas del SNC. Supongamos que es el parámetro pwr_ext, que para la mayoría de los rastreadores corresponde al voltaje externo.
3. Determine en qué valor del parámetro encontrado cambian las lecturas del SNC. Supongamos que si pwr_ext es menor que 12, el SNC comienza a enviar lecturas incorrectas.
4. Entre en las propiedades de la unidad y cree un sensor del tipo Sensor digital personalizado, usando el parámetro del punto 3, y luego establezca para él una Tabla de cálculo con las siguientes líneas:
   X = 0; a = 0; b = 0
   X = 12; a = 0; b = 1
5. Guarde el sensor creado y los cambios en las propiedades de la unidad, presionando dos veces el botón OK.
6. Vuelva a entrar en las propiedades de la unidad y luego en las propiedades del SNC. Especifique el sensor del punto 4 como validador con el tipo Comprobar no nulos.

En el ejemplo anterior se considera un caso real, ya que el bajo voltaje a menudo lleva a la distorsión de las lecturas de varios sensores. Es decir, existe una conexión directa entre los parámetros de voltaje y nivel de combustible transmitidos. Sin embargo, también puede usar una conexión indirecta si nota un cambio simultáneo en las lecturas del SNC y cualquier otro parámetro. Es posible que el rastreador no envíe el valor de voltaje, pero envíe el valor de temperatura, y el sensor de temperatura también falle y envíe, por ejemplo, 451 °F en el momento del salto de voltaje. En tal caso, intente vincular el SNC y el valor de temperatura mediante la validación, lo que también debería corregir la situación.

7. Caída suave después del llenado de combustible en presencia de varios tanques conectados (cada tanque tiene un SNC)

Tal cambio en las lecturas del SNC puede estar relacionado con el hecho de que la unidad tiene varios tanques conectados entre los cuales ocurre un flujo de combustible. Después del llenado de combustible en uno de los tanques, la nivelación entre varios tanques puede llevar algún tiempo, y si creó sensores de nivel de combustible en Wialon por separado, inmediatamente después del llenado de combustible el sistema puede detectar una falsa descarga en uno de los tanques.

Al trabajar con varios tanques conectados, recomendamos crear un Sensor personalizado para cada SNC (por ejemplo, con los nombres "SNC 1" y "SNC 2") e introducir su propia tabla de calibración. Después de esto, cree un sensor separado del tipo Sensor del nivel de combustible, no introduzca una tabla de calibración en él, sino simplemente use la siguiente fórmula: [SNC 1]+[SNC 2]

8. Caída brusca al alcanzar cierto nivel

Esta situación puede observarse para tanques de forma específica en el momento de transición de la parte ancha a la estrecha (por ejemplo, para tanques en forma de "L"). Esto es especialmente probable si la calibración se realizó con muy pocos puntos, y a menudo se hace con solo 2 puntos (con el tanque vacío y lleno). Por lo tanto, tiene sentido recalibrar el tanque usando pequeñas porciones.

9. Cambio suave al mismo tiempo

A veces el nivel de combustible cae/aumenta en ciertos momentos, y en algunos casos incluso vuelve al valor actual más tarde. Esto puede ocurrir por la noche, o durante un viaje (especialmente bajo carga), o aproximadamente al mismo tiempo después de completar un viaje, es decir, es difícil identificar una regla general.

Causas probables:

• cambio de temperatura que afecta el volumen de combustible, así como la deformación del tanque (esto es especialmente cierto para tanques de plástico flexibles);
• formación de "vacío" debido a diferencias de presión (extracción activa de combustible al motor);
• sedimentación de impurezas en el combustible o suciedad en el tanque que ocurre después de completar un viaje (vibración).

La solución en la mayoría de los casos está relacionada con el equipo: instalación de una tapa con válvula para igualar la presión, eliminación de suciedad/sedimentos en el tanque o en el SNC. Sin embargo, si la situación está relacionada solo con el cambio de temperatura, puede ayudarle el uso de un sensor del tipo Coeficiente de temperatura (un ejemplo de su configuración se puede encontrar en la documentación).

Oleg Zharkovsky,Customer Service Engineer 2024-02-12

El SDK (Software Development Kit) es un conjunto de herramientas para desarrollar aplicaciones propias. El SDK de Wialon incluye varios API. El más básico de ellos es el Remote API, al cual están dirigidos estos artículos. El Remote API permite el acceso a los datos a través de solicitudes HTTP y es relevante para 1C, PHP, C++/C# y otros lenguajes de programación. El JS API y otros están construidos sobre la base del Remote API.

En este artículo se considerarán los conocimientos básicos necesarios para los principiantes en el uso del Remote API.

Visualización de solicitudes en el navegador

Al comenzar a estudiar el SDK, a menudo surge la necesidad de entender qué solicitud API se envía al servidor al realizar una u otra acción en la interfaz de Wialon. Esto se puede rastrear fácilmente utilizando las herramientas integradas del navegador para monitorear solicitudes de red.

En el navegador Chrome, se utiliza la pestaña Red de las Herramientas para desarrolladores, que se abren al presionar la tecla F12. En otros navegadores, esta herramienta puede abrirse de manera diferente, lo cual se puede leer en la documentación del navegador.

Al visualizar las solicitudes de red, se puede ver la solicitud enviada, sus parámetros y la respuesta del servidor API en formato JSON.

Formato de la solicitud

Las solicitudes HTTP se envían al servidor en el siguiente formato:

https://host/wialon/ajax.html?svc=REQUEST_NAME¶ms={PARAMETERS}&sid=SESSION_IDENTIFIER

Obtención de token y autorización

Para la autorización en Wialon se utiliza un token, es decir, una clave utilizada para la identificación cifrada del usuario.

Para crear un token, se puede utilizar el formulario oAuth. Después de un inicio de sesión exitoso, el token se mostrará en la barra de direcciones del navegador como el valor del parámetro formulario oAuth. Es importante tener en cuenta los parámetros adicionales que regulan propiedades como la duración (parámetro duration), el nombre de usuario (parámetro user), los derechos de acceso (parámetro access_type) y otros.

Ejemplo de formulario extendido para obtener un token:

https://hosting.wialon.com/login.html?client_id=APP_NAME&access_type=256&activation_time=0&duration=0&lang=en&flags=0&user=USER_NAME

Ejemplo de respuesta:

https://hosting.wialon.com/login.html?lang=en&user=USER_NAME&wialon_sdk_url=https%3A%2F%2Fhst%2Dapi%2Ewialon%2Ecom&access_token=TOKEN_VALUE&svc_error=0

Después de obtener el token, se debe utilizar para la autorización. Ejemplo de inicio de sesión con token:

https://hst-api.wialon.com/wialon/ajax.html?svc=token/login¶ms={"token":"TOKEN_VALUE"}

En la respuesta al inicio de sesión con token, se incluye el parámetro eid, cuyo valor es el identificador único de sesión. Luego, se utilizará en casi todas las solicitudes API.

Configuración de la zona horaria

Por defecto, al trabajar con Remote API, los datos se muestran según la zona horaria GMT+0. Para cambiarla a la necesaria, se utiliza la solicitud render/set_locale. Es suficiente ejecutar esta solicitud en el marco de una sesión activa.

Al enviar la solicitud render/set_locale, es necesario utilizar el parámetro tzOffset. El método estándar para calcular su valor se describe en la documentación.

También se puede obtener el valor necesario del parámetro tzOffset mediante la visualización de solicitudes de red al cambiar la zona horaria del usuario en la interfaz web.

ID del sistema

En el API, el trabajo con casi todos los elementos se realiza a través de identificadores internos, llamados ID del sistema, que se presentan como valores numéricos únicos.

En las interfaces web, los ID del sistema no se muestran por defecto, pero se pueden ver de tres maneras:

1. En la respuesta a la solicitud de búsqueda de elementos por criterios (core/search_items). Se detallará en la siguiente sección de este artículo.
2. En los parámetros de las solicitudes al visualizar las solicitudes de red en el navegador.

3. En la columna avl_id en el sistema de gestión CMS Manager.

   Para que se muestre la columna avl_id, es necesario iniciar sesión en el CMS, añadiendo al final del enlace ?features=avl_id. Un ejemplo de dicho enlace se muestra en la imagen a continuación.
   
   

Búsqueda de elementos por criterios

Esta solicitud permite encontrar elementos según los criterios especificados en los parámetros.

La búsqueda se realiza por los siguientes tipos de elementos, que se indican en el campo itemsType:

• avl_hw — tipo de dispositivo;
  
• avl_resource — recurso;
  
• avl_retranslator — repetidor;
  
• avl_unit — unidad;
  
• avl_unit_group — grupo de unidades;
  
• user — usuario;
  
• avl_route — ruta.

Uno de los posibles criterios de búsqueda pueden ser los subelementos. En tal caso, para el parámetro propType se establece el valor propitemname, y el parámetro propName tomará los siguientes valores:

• Unidades:
  • unit_sensors — sensores;
  • unit_commands — comandos;
  • service_intervals — intervalos de servicio;
    
    
• Recursos:
  • drivers — conductores;
  • driver_groups — grupos de conductores;
  • jobs — tareas;
  • notifications — notificaciones;
  • trailers — remolques;
  • trailer_groups — grupos de remolques;
  • zones_library — geocercas;
  • reporttemplates — plantillas de informes;
  • orders — pedidos;
    
    
• Rutas:
  • rounds — rutinas;
  • route_schedules — horarios;
    
    
• Repetidores:
  • retranslator_units — unidades retransmitidas;
    
    
• Unidades, usuarios o recursos:
  • custom_fields — campos personalizados;
  • admin_fields — campos administrativos.

La información en la respuesta depende de los flags especificados en la solicitud de búsqueda en el parámetro flags. Los flags se establecen en formato DEC.

Veamos algunos ejemplos de uso de la solicitud de búsqueda de elementos por criterio (otros ejemplos se pueden encontrar en la documentación).

Búsqueda de elementos con un nombre específico

Es necesario obtener una lista de todas las unidades disponibles para el usuario, cuyo nombre contenga la palabra Tractor, así como información sobre los sensores creados en las unidades.

En tal caso, se puede utilizar la siguiente solicitud:

https://hst-api.wialon.com/wialon/ajax.html?svc=core/search_items¶ms={"spec":{"itemsType":"avl_unit","propName":"sys_name","propValueMask":"*Tractor*","sortType":"sys_name"},"force":1,"flags":4097,"from":0,"to":0}&sid=SESSION_IDENTIFIER

{
	"searchSpec":{
		"itemsType":"avl_unit",
		"propName":"sys_name",
		"propValueMask":"*Tractor*",
		"sortType":"sys_name",
		"propType":"",
		"or_logic":"0"
	},
	"dataFlags":4097,
	"totalItemsCount":1,
	"indexFrom":0,
	"indexTo":0,
	"items":[
		{
			"nm":"Tractor 1",
			"cls":2,
			"id":22353120,
			"mu":0,
			"sens":{
				"1":{
					"id":1,
					"n":"Ignition",
					"t":"engine operation",
					"d":"",
					"m":"On\/Off",
					"p":"in1",
					"f":0,
					"c":"{\"act\":1,\"appear_in_popup\":true,\"ci\":{},\"cm\":1,\"mu\":0,\"pos\":2,\"show_time\":false,\"timeout\":0}",
					"vt":0,
					"vs":0,
					"tbl":[]
				},
				"2":{
					"id":2,
					"n":"Fuel level",
					"t":"fuel level",
					"d":"",
					"m":"l",
					"p":"adc1",
					"f":0,
					"c":"{\"act\":1,\"appear_in_popup\":true,\"calc_fuel\":0,\"ci\":{},\"cm\":1,\"fuel_params\":{\"fillingsJoinInterval\":300,\"filterQuality\":0,\"flags\":0,\"ignoreStayTimeout\":10,\"minFillingVolume\":20,\"minTheftTimeout\":0,\"minTheftVolume\":10,\"theftsJoinInterval\":300},\"mu\":0,\"pos\":1,\"show_time\":false,\"timeout\":0}",
					"vt":0,
					"vs":0,
					"tbl":[]
				}
			},
			"sens_max":-1,
			"uacl":-1
		}
	]
}

Búsqueda de usuarios creados después de una fecha específica

Es necesario obtener una lista de usuarios que fueron creados después del 23 de febrero de 2021 a las 05:41:46 (GMT+0). La respuesta debe contener los ID del sistema de estos usuarios y sus direcciones de correo electrónico.

En este caso, se puede utilizar la siguiente solicitud:

https://hst-api.wialon.com/wialon/ajax.html?svc=core/search_items¶ms={"spec":{"itemsType":"user","propName":"rel_creation_time","propValueMask":">=1614058906","sortType":"sys_name"},"force":1,"flags":3,"from":0,"to":0}&sid=SESSION_IDENTIFIER

Búsqueda de unidades de un tipo específico

Es necesario obtener una lista de unidades con el tipo de equipo Wialon Retranslator, que hayan enviado mensajes después del 12 de febrero de 2023 a las 12:00:00 (GMT+0). La respuesta debe mostrar los sensores de las unidades, el tiempo del último mensaje y las ubicaciones.

En este caso, se puede utilizar la siguiente solicitud:

https://hst-api.wialon.com/wialon/ajax.html?svc=core/search_items¶ms={"spec":{"itemsType":"avl_unit","propName":"rel_hw_type_name,rel_last_msg_date","propValueMask":"Wialon%20Retranslator,>1676203200","sortType":"rel_creation_time"},"force":1,"flags":1,"from":0,"to":0}&sid=SESSION_IDENTIFIER

Búsqueda de unidades por nombre de sensor

Es necesario obtener una lista de unidades en las que se haya creado un sensor con el nombre Engine.

En este caso, se puede utilizar la siguiente solicitud:

https://hst-api.wialon.com/wialon/ajax.html?svc=core/search_items¶ms={"spec":{"itemsType":"avl_unit","propType":"propitemname","propName":"unit_sensors","propValueMask":"Engine","sortType":"sys_name"},"force":1,"flags":1,"from":0,"to":0}&sid=SESSION_IDENTIFIER

Búsqueda de grupos de unidades por varios criterios

Es necesario obtener una lista de grupos de unidades que fueron creados por el usuario User y en los que se hayan añadido más de 5 unidades.

En este caso, se puede utilizar la siguiente solicitud:

https://hst-api.wialon.com/wialon/ajax.html?svc=core/search_items¶ms={"spec":{"itemsType":"avl_unit_group","propName":"rel_user_creator_name,rel_group_unit_count","propValueMask":"User,>5","sortType":"sys_name"},"force":1,"flags":133,"from":0,"to":0}&sid=SESSION_IDENTIFIER

Lista de errores comunes

El error se muestra cuando no se puede ejecutar la solicitud. La lista completa de errores devueltos se puede encontrar en la documentación.

Los errores más comunes son:

• {error: 1} — sesión no válida. Este error se muestra cuando ha expirado el tiempo de vida del identificador único de sesión. Para corregir el error, basta con iniciar sesión con el token nuevamente y usar el nuevo identificador de sesión (sid) para ejecutar las solicitudes.

  Si no se ejecuta ninguna solicitud dentro de los 5 minutos en el marco de la sesión, esta se vuelve inactiva. Para mantener la sesión, puede enviar la solicitud avl_evts cada 5 minutos.

• {error: 4} — entrada no válida. Este error se muestra si hay un error en el texto de la solicitud: no se especifican todos los parámetros requeridos, los parámetros de texto no están entre comillas, falta un paréntesis de apertura o cierre, etc. Para corregir el error, es necesario corregir el texto de la solicitud según su descripción en la documentación.
  
  
• {error: 7} — acceso denegado. Este error se muestra si el usuario no tiene suficientes derechos para ejecutar la solicitud. Para corregir el error, es necesario verificar si el token utilizado para obtener el identificador único de sesión tiene suficientes flags de acceso, así como si el usuario para el cual se generó el token tiene suficientes derechos sobre los elementos utilizados.

Ekaterina Grib,Customer Service Engineer 2023-08-02