Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 11 Current »

The application behaviour can be customised via two methods for configuration:

  • Parameters
    The application parameters control the primary aspects of the application

  • User configuration file
    The user configuration file enables fine-grained customisation of the application behaviour
    (e.g. enabling/disabling individual sensors). Please contact support to receive detailed documentation about the user configuration file, its format and options.

Parameters

Please note that the following description assumes ideal behaviour in terms of timing and durations. In reality, delays and inaccuracies may occur due to varying cellular network conditions and the time required to obtain a position using the global navigation satellite system, resulting in potential transmission delays of several minutes.

papp

Configures the application variant that is executed

Value range

  • Must be an integer

  • Valid values

    • 0 — Inventory track

    • 1 — Theft track

With the inventory track application, you configure a time of day in which you want to track the device's position. The device won't report a change of position outside the configured interval.

The general idea behind the theft track application is, that you configure a time of day in which motion of the device is allowed. The device will send its position when it detects motion outside the configured interval and ignores movement otherwise.

pmode

The mode parameter determines which events will cause the application to send telemetry data

Value range

  • Must be an integer

  • Valid values

    • 0 — Motion detection

    • 1 — Scheduled intervals

    • 2 — Motion detection and scheduled intervals

pstart

Inventory track:
Denotes the start of the interval in which the device sends positioning information
Theft track:
Denotes the start of the interval in which motion of the device is allowed

Value range

  • Must be an integer

  • The value is interpreted as minutes since 0 o'clock. Hence, it must not exceed 1440. The parameters pstart and pdur are used in conjunction, and therefore the sum of both values must not exceed 1440 as well.

pdur

Denotes the length of the interval that begins after pstart. The semantic of this interval is determined by the application (See papp).

Value range

  • Must be an integer

  • The pdur value is specified in minutes and must not exceed 1440. The parameters pdur and pstart are used in conjunction, and therefore the sum of both values must not exceed 1440 as well.

Example

pxtime

Specifies the interval duration after which the device transmits any unsent positioning information and sensor readings.

Value range

  • Must be an integer

  • The pxtime value is specified in minutes and must be smaller or equal to the pdur value

  • If pmode is set to 0, this setting has no effect

Example

pytime

Denotes a dead time after a motion was detected. Motions of the device within the dead time don't trigger a new transfer of positioning information.

Value range

  • Must be an integer

  • The pytime value is specified in minutes

  • If pmode is set to 1, this setting has no effect

Example

cid

A custom identifier that will be attached to all telemetry records of the device. After a value was assigned to a device, it can be used instead of the device ID to analyse telemetry data via the Exelonix backend.

Value range

  • Must be a string with a maximum length of 32 characters

  • Only characters a-zA-Z0-9.- are permitted

  • The same value can be assigned to multiple devices. You need to ensure uniqueness across multiple devices yourself if this is required.

pcollect

Specifies the duration of the interval at which the device collects new sensor readings. These readings are stored locally and transmitted after the specified pxtime has elapsed. This functionality supports use cases where sensor data needs to be collected without being immediately sent.

Value range

  • The value is specified in minutes

  • Must be a float or an integer

  • Minimum value: 0.15

  • Maximum value: 1440

  • The pcollectfunctionality is deactivated by default. In this case, the device will report value 0 for this parameter and new sensor readings are gathered in pxtime intervals.

  • Once activated, pcollect can’t be reset to 0 again. To achieve the same behavior as when pcollect is not activated, set its value equal to pxtime.

gnss-force-next-time

Force the device to update its GNSS position information the next time readings are collected.

Value range

  • Must be an integer

  • Valid values

    • 0 — Don’t force an update of the GNSS position information

    • 1 — Force an update of the GNSS position information

  • When the device receives no GNSS signal, the position information won’t be updated, regardless of this setting.

  • The device will automatically reset this parameter to 0 after it executed the forced update.

gnss-trigger

Configure the device to update GNSS position information only after every the specified number of periodic data sets are collected.

Value range

  • Must be an integer

  • Minimum value: 0

  • Maximum value: 99999

  • Setting the value to 0 disables the collection of GNSS position information for periodic transmissions.

  • No labels