update_units

For adding units into the session, use the events/update_units request.

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

To remove specific units from the session, use the following signature:

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

To remove all units from the session, use the following signature:

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

To work with the “detect” elements (trips, lls, sensors, ignition) use a specific sensor ID or indicate 0 to add all the sensors of a certain type. For trips, always use 0 as there is no trip sensor.

To add all unit sensors, use:

"detect":{"*":0}

To add all ignition sensors and other sensors, use:

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

or

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

To add all fuel level sensors with ID 2 and other sensor with ID 6:

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

The evt_flags parameter controls which event processing mode is used when events/check_updates is called.

Detail flags are combinable via bitwise OR and used in the lower 9 bits when 0x200 is set. The following detail flags are available:

For example, evt_flags = 0x207 means using the evt_evts mode (0x200) with the base, detector, and message parameter detail flags enabled (0x1 | 0x2 | 0x4 = 0x7).

If the request is completed successfully, the following response is returned:

{
    units:<uint>        /* number of units added into session */
}

Otherwise, an error code is returned.