update_units

Para agregar unidades a la sesión, utilice el método events/update_units.

svc=events/update_units&params={
  "mode": "add",
  "units": [
    {
      "id": <long>,
      "detect": {
        "trips": <uint>,
        "lls": <uint>,
        "sensors": <uint>,
        "ignition": <uint>,
        "counters": <uint>
      }
    },
    ...
  ]
}

Para eliminar unidades específicas de la sesión, utilice la siguiente estructura:

svc=events/update_units&params={
  "mode": "remove",
  "units": [
    <long>
  ]
}

Para eliminar todas las unidades de la sesión, utilice la siguiente estructura:

svc=events/update_units&params={
  "mode": "clear"
}

Para trabajar con los elementos “detect” (trips, lls, sensors, ignition), utilice un ID de sensor específico o indique 0 para agregar todos los sensores de un tipo determinado. Para viajes, siempre utilice 0, ya que no existe un sensor de viajes.

Para agregar todos los sensores de la unidad, utilice:

"detect":{"*":0}

Para agregar todos los sensores de ignición y otros sensores, utilice:

"detect":{"ignition":0,"sensors":0}

o

"detect":{"ignition,sensors":0}

Para agregar todos los sensores de nivel de combustible con ID 2 y otro sensor con ID 6:

"detect":{"lls":2,"sensors":6}

El parámetro evt_flags controla qué modo de procesamiento de eventos se utiliza cuando se llama a events/check_updates.

Las marcas de detalle son combinables mediante OR bit a bit y se utilizan en los 9 bits inferiores cuando 0x200 está establecido. Las siguientes marcas de detalle están disponibles:

Por ejemplo, evt_flags = 0x207 significa usar el modo evt_evts (0x200) con las marcas de detalle base, detector y parámetros de mensaje habilitadas (0x1 | 0x2 | 0x4 = 0x7).

Si la solicitud se completa correctamente, se devuelve la siguiente respuesta:

{
    units:<uint>        /* número de unidades agregadas a la sesión */
}

De lo contrario, se devuelve un código de error.