NAV Navbar
Logo
Examples

ThingPark X Location Engine API - Connector module

Welcome to the ThingPark X Location Engine Connector API reference documentation. The purpose of this API is to provide the best experience for all developers who intend to interface with ThingPark geolocation features.

In order to get acquainted with the API, you can use the convenient online client Swagger-UI.
To use the API from your application, you can generate client code using the API’s OpenAPI contract.

Below are descriptions and examples for all operations exposed by this API.

ConnectorConfig operations

Connector configuration operations are used to configure options for ThingPark Location modules associated with devices. Currently only the ThingPark Location Push Module can be configured to push Resolved Positions and Alarm to a target HTTP server.

Connector configurations retrieval

Retrieves the list of existing connector configurations.

HTTP Endpoint

GET /connectorConfigs

Responses

Code Type Description
200 ConnectorConfig array Connectors with their configurations retrieved successfully.
400 Bad Request - invalid request

Connector configuration creation

Creates a new connector configuration.

HTTP Endpoint

POST /connectorConfigs

Parameters

Parameter In Type Required Description
ConnectorConfig body ConnectorConfig true Contents of the connector configuration to create.

Responses

Code Type Description
201 ConnectorConfig Connector configuration created successfully.
400 Bad Request - invalid request

Connector configuration retrieval

Retrieves the connector configuration corresponding to the provided ref.

HTTP Endpoint

GET /connectorConfigs/{connectorConfigRef}

Parameters

Parameter In Type Required Description
connectorConfigRef path String true Ref of the connector configuration to retrieve.

Responses

Code Type Description
200 ConnectorConfig Connector configuration retrieved successfully.
400 Bad Request - invalid request
401 Unauthorized - invalid api key or user not authorized for access
404 Not found

Connector configuration update

Updates the connector configuration corresponding to the provided ref.

HTTP Endpoint

PUT /connectorConfigs/{connectorConfigRef}

Parameters

Parameter In Type Required Description
connectorConfigRef path String true Ref of the connector configuration to update.
ConnectorConfig body ConnectorConfig true Contents of the connector configuration to update.

Responses

Code Type Description
200 ConnectorConfig Connector configuration updated successfully.
400 Bad Request - invalid request
401 Unauthorized - invalid api key or user not authorized for access

Connector configuration deletion

Deletes the connector configuration corresponding to the provided ref.

HTTP Endpoint

DELETE /connectorConfigs/{connectorConfigRef}

Parameters

Parameter In Type Required Description
connectorConfigRef path String true Ref of the connector configuration to delete.

Responses

Code Type Description
204 Connector configuration deleted successfully.
400 Bad Request - invalid request
401 Unauthorized - invalid api key or user not authorized for access
404 Not found

KNOWN operations

A fake endPoint to illustrate resolved position examples of TPXLE push connector messages

HTTP Endpoint

POST /resolvedPositionExamples

Parameters

Parameter In Type Required Description
ResolvedPosition body ResolvedPosition false Resolved position examples of TPXLE push connector messages

Responses

Code Type Description
401 Unauthorized - invalid api key or user not authorized for access

A fake endPoint to illustrate provided alarm examples of TPXLE push connector messages

HTTP Endpoint

POST /providedAlarmExamples

Parameters

Parameter In Type Required Description
ProvidedAlarm body ProvidedAlarm false Provided alarm examples of TPXLE push connector messages

Responses

Code Type Description
401 Unauthorized - invalid api key or user not authorized for access

Resources

Alert

Resource representing an alert detected from devices

Attribute Type Description
alertType AlertType
deviceEUIList String List of tracker devices EUI affected by the alert. Device EUIs must be separated by commas.
ref String Ref of the alert.

AlertAlarm

Resource representing an alarm triggered for a specific alert on a specific device in relationship with a device and form of alert.

Attribute Type Description
alert Alert
alertAlarmType String Type of Alert alarm.

AlertAlarmBattery

Resource representing an alarm triggered for a battery threshold alert.

Attribute Type Description
alert Alert
alertAlarmType String Type of Alert alarm.
batteryLevel Integer New battery level of the tracker when the alarm has been triggered

AlertAlarmBatteryStatus

Resource representing an alarm triggered for a battery status change.

Attribute Type Description
alert Alert
alertAlarmType String Type of Alert alarm.
batteryStatus String New battery status of the tracker when the alarm has been triggered

AlertAlarmParameter

Resource representing an alarm triggered for a parameter change alert.

Attribute Type Description
alert Alert
alertAlarmType String Type of Alert alarm.
parameterValue String New parameter value when the alarm has been triggered

AlertAlarmPosition

Resource representing an alarm triggered for a position alert.

Attribute Type Description
alert Alert
alertAlarmType String Type of Alert alarm.
horizontalAccuracy Integer Horizontal accuracy of the position, in meters.
newPosition double array New tracker position when the alarm has been triggered as per the GeoJSON specification, i.e. [longitude, latitude, altitude].
verticalAccuracy Integer Vertical accuracy of the position, in meters.

AlertAlarmTimeout

Resource representing an alarm triggered for a volatile alert timeout.

Attribute Type Description
alert Alert
alertAlarmType String Type of Alert alarm.

AlertAlarmTrackingMode

Resource representing an alarm triggered for a tracking mode change alert.

Attribute Type Description
alert Alert
alertAlarmType String Type of Alert alarm.
newMode String New tracking mode of the tracker when the alarm has been triggered

AlertType

Resource representing an alert type detected from devices

Attribute Type Description
alertTypeName String Type of Alert provided.
notifyByEmail Boolean Indicates to notify users about alerts by email. Default is false.
notifyOnInterface Boolean Indicates to notify users about alerts on the GUI. Default is false.

AlertTypeBattery

Resource representing a battery alert detected from devices

Attribute Type Description
alertTypeName String Type of Alert provided.
notifyByEmail Boolean Indicates to notify users about alerts by email. Default is false.
notifyOnInterface Boolean Indicates to notify users about alerts on the GUI. Default is false.
batteryThreshold Integer Battery Threshold for receiving Battery Level Notifications. When the battery reaches below this threshold, a notification will be sent

AlertTypeBatteryStatus

Resource representing tracker parameter update alert detected from devices

Attribute Type Description
alertTypeName String Type of Alert provided.
notifyByEmail Boolean Indicates to notify users about alerts by email. Default is false.
notifyOnInterface Boolean Indicates to notify users about alerts on the GUI. Default is false.
batteryStatus String Represents the battery status. Possible values are:- ‘UNKNOWN’: Not supported value.- 'CHARGING’: The battery is charging.- 'OPERATING’: In this case, the battery level indicates the battery usage. If this property is missing, any mode change will trigger a notification.

AlertTypeMotion

Resource representing a motion alert detected from devices. Whenever the tracker moves, a notification will be sent.

Attribute Type Description
alertTypeName String Type of Alert provided.
notifyByEmail Boolean Indicates to notify users about alerts by email. Default is false.
notifyOnInterface Boolean Indicates to notify users about alerts on the GUI. Default is false.

AlertTypeParameter

Resource representing tracker parameter update alert detected from devices

Attribute Type Description
alertTypeName String Type of Alert provided.
notifyByEmail Boolean Indicates to notify users about alerts by email. Default is false.
notifyOnInterface Boolean Indicates to notify users about alerts on the GUI. Default is false.
paramName String Name of the parameter to watch. Possible values are 'TRACKING_UL_PERIOD’ (period in seconds of position messages while in tracking state), 'LORALIVE_PERIOD’ (period in seconds of heartbeat messages in idle state), 'ENERGY_STATUS_PERIOD’ (period in seconds of energy status messages), 'PERIODIC_POSITION_PERIOD’ (period in seconds of the periodic position report), 'GEOLOC_SENSOR_PROFILE’ (policy used to decide what Geolocation Sensor is to be used for geolocation scans in tracking state), 'ONESHOT_GEOLOC_METHOD’ (what geoloc sensor to use for periodic/on-demand positions), 'EXT_ANTENNA_PROFILE’ (0 - use only PCB antenna for GPS scans, 1 - use only ceramic antenna for GPS scans, 2 – automatic selection, use ceramic antenna only when facing the sky), 'MOTION_START_END_NB_TX’ (number of position messages to send after motion events in Start/End tracking mode), 'GPS_TIMEOUT’ (time in seconds for GPS geoloc timeout), 'XGPS_TIMEOUT’ (time in seconds for XGPS geoloc timeout), 'GPS_EHPE’ (horizontal error in meters to decide if a GPS fix in GPS geoloc is acceptable), 'GPS_CONVERGENCE’ (time in seconds before deciding a GPS fix in GPS geoloc has converged for enough time)
paramValue String Value of the parameter to watch. Should always be passed as a string, regardless of the parameter unit type. If this property is missing, any value change in the parameter will trigger a notification.

AlertTypePosition

Resource representing position on demand alert detected from devices. When the tracker sends a new position, a notification will be sent.

Attribute Type Description
alertTypeName String Type of Alert provided.
notifyByEmail Boolean Indicates to notify users about alerts by email. Default is false.
notifyOnInterface Boolean Indicates to notify users about alerts on the GUI. Default is false.
coordinates double array Device coordinates, to be used 'as is’ in the platform. Expected value is an array of coordinates , i.e.[longitude, latitude].
coordinatesAccuracy Double Accuracy in meters of the position provided in “coordinates” property

AlertTypeSOS

Resource representing a SOS alert detected from devices. When the tracker switches to SOS, a notification will be sent.

Attribute Type Description
alertTypeName String Type of Alert provided.
notifyByEmail Boolean Indicates to notify users about alerts by email. Default is false.
notifyOnInterface Boolean Indicates to notify users about alerts on the GUI. Default is false.

AlertTypeTrackingMode

Resource representing a tracking mode update alert detected from devices. When the tracking mode changes, a notification will be sent

Attribute Type Description
alertTypeName String Type of Alert provided.
notifyByEmail Boolean Indicates to notify users about alerts by email. Default is false.
notifyOnInterface Boolean Indicates to notify users about alerts on the GUI. Default is false.
newMode String New mode applied to the trackers. Possible values are 'OFF’ (everything is turned OFF to achieve the lowest possible power consumption), 'STANDBY’ (the trackeris in idle state. It can use periodic reporting if it is activated, and answers to On-Demand position request), 'MOTION’ (tracking state only when moving), 'PERMANENT’ (always in tracking state), 'START_END’ (motion start and end events), 'ACTIVITY’ (the tracker focuses on detecting movements. Every motion detection increases a counter). If this property is missing, any mode change will trigger a notification.

AngleDetection

Attribute Type Description
flags AngleDetectionFlags
age Integer Age of the measure in second.
referenceVector integer array Represents the reference acceleration of the tracker. It is provided only in 'ANGLE_DETECTION’ event message, i.e. [x-axis, y-axis, z-axis].
criticalVector integer array Represents the critical acceleration of the tracker. It is provided only in 'ANGLE_DETECTION’ event message, i.e. [x-axis, y-axis, z-axis].
angle Integer Angle in degree between the reference vector and the last measurement.

AngleDetectionFlags

Flags providing status and report reason.

Attribute Type Description
transition String
triggerType String
notificationIdentifier Integer Notification identifier. Any new transition normal reset this counter.

BatchProfileTrackerCommandAlarm

Resource representing the tracker command alarm to change a profile that has more than 5 parameters

Attribute Type Description
trackerCommand TrackerCommand
batchDownlinkInformation downlinkInformation array
timeout Date Timeout set for this tracker command
commandTime Date Time when this tracker command was received
state String Tracker command result state:
- 'BATCH_PROFILE_SUCCESS’: The tracker has received the complete list of downlink to change the profile.
- 'BATCH_PROFILE_FAILURE’: The tracker may not have received all downlinks.
- 'TIMEOUT’: Time out in waiting for downlink acknowledgement.
- 'DELIVERY_ERROR’: error in sending the downlink payload to the underlying operator.

BeaconIdData

Attribute Type Description
rssi Integer Received signal strength indication for this beaconId
beaconId String Beacon Id

BeaconIdInformation

Resource representing a BLE beacon scan information with beaconId coded on 4 bytes and RSSI

Attribute Type Description
scanInformationType String Type of scan information.:
- 'BeaconIdInformation’: BLE Beacon Id
- 'BeaconMACInformation’: BLE Mac address.
- 'WifiBSSIDInformation’: WIFI BSSID.
rssi Integer
beaconId String

BeaconMACInformation

Resource representing a BLE beacon scan information with MAC address and RSSI

Attribute Type Description
scanInformationType String Type of scan information.:
- 'BeaconIdInformation’: BLE Beacon Id
- 'BeaconMACInformation’: BLE Mac address.
- 'WifiBSSIDInformation’: WIFI BSSID.
rssi Integer
macAddress String

ConfigFlags

Attribute Type Description
framePendingMechanism Boolean false: Frame pending mechanism is disabled.
true: Frame pending mechanism is enabled. Factory default value.
(Supported from Asset Tracker 1.7.0)
buttonPressToTurnDeviceOff Boolean false: Cannot turn OFF device with a button press.
true: Can turn OFF device with a button press. Factory default value. (Supported from Asset Tracker 1.7.0)
doubleClickIsSosModeOrAlert Boolean false: Double button click triggers an Alert.
true: Double button click starts SOS mode, another double click stops it. Factory default value.
(Supported from Asset Tracker 1.7.0)
downlinkSetParameterConfirmation Boolean false: Confirmation uplink mechanism is disabled.
true: Confirmation uplink mechanism is enabled. Factory default value.
(Supported from Asset Tracker 1.7.0)
wifiPayloadWithNoCypher Boolean false: Wifi payload is cyphered.
true: Wifi payload is not cyphered. Factory default value.
(Supported from Asset Tracker 1.7.0)
bleAdvertisingAtStart Boolean false: BLE advertising is disabled. Factory default value.
true: BLE advertising is enabled.
(Supported from Asset Tracker 1.7.0)
selectWifiScanOrGeolocStartMessage Boolean false: Enable geoloc start event message when starting a geoloc sequence.
true: Enable Wifi scan when starting a geoloc sequence. Factory default value.
(Supported from Asset Tracker 1.7.3)
ledBlinkWithGpsFix Boolean false: No blink when a GPS fix is received. Factory default value.
true: LED Blink when a GPS fix is received.
(Supported from Asset Tracker 1.7.3)
startMotionEventUplink Boolean false: Start Motion event payload is disabled. Factory default value. true: Start Motion event payload is enabled.
(Supported from Asset Tracker 1.8.0)
endMotionEventUplink Boolean false: End Motion event payload is disabled. Factory default value.
true: End Motion event payload is enabled.
(Supported from Asset Tracker 1.8.0)
otaJoinWhenLeavingModeOff Boolean false: Disable OTA join when leaving mode OFF. Factory default value.
true: Enable OTA join when leaving mode OFF.
(Supported from Asset Tracker 1.8.0)
rejectAsymmetricBlePairing Boolean false: Accept asymmetric BLE pairing. Factory default value.
true: Reject asymmetric BLE pairing.
(Supported from Asset Tracker 1.8.0)
enableLongWifiPayload Boolean false: Long wifi payload is disabled. Factory default value.
-true: Long wifi payload is enabled.
(Supported from Asset Tracker 1.9.0)
collectionLongReport Boolean false: The usual payload size is used (36 bytes).
true: The number of entries carried in the uplink is larger and use a payload size of 91 bytes.
(Supported from Asset Tracker 2.0)
autoStart Boolean false: Once LoRa join succeeds, the user needs to make another long press to actually start in the configured operating mode.
true: Once LoRa join succeeds, the device automatically starts without requiring a long press.
(Supported from Asset Tracker 2.0)

ConfigurationParameter

Resource representing a tracker configuration parameter.

Attribute Type Description
paramName paramName
paramValue String Value of the parameter to update. Should always be passed as a string, regardless of the parameter unit type.

ConnectorConfig

Resource representing a configuration of the ThingPark Connector module.

Attribute Type Description
ref String Ref of the module configuration. Generated by the system upon creation.
deviceEUIList String List of devices EUI managed by the module. Device EUIs must be separated by commas. If the field is *, the data of any tracker of the customer/subscriber will be sent to the configured URL
applicationServerURL String HTTP url of the target server to which the resolved positions should be sent.
authorizationHeader String Content of the Authorization Header in the HTTP request.
includeProcessedFeed Boolean Indicates if the processed feed solver output should be included in the pushed data.
includeRawPosition Boolean Indicates if the raw position solver output should be included in the pushed data.
includeResolvedTracker Boolean Indicates if the resolved tracker solver output should be included in the pushed data.
includeUplinkPayload Boolean Indicates if the result of driver should be included in the pushed data.
includeResolvedTrackerParameters Boolean Indicates if the resolved tracker parameters should be included in the pushed data.
includeAlarms Boolean Indicates if the alarms of the device should be included in the pushed data.

DetectedBssid

Attribute Type Description
bssid String Wifi access point BSSID (MAC address)
rssi Integer Received signal strength indication for this Wifi BSSID

downlinkInformation

Resource representing the payload and the ackToken of each downlink used in trackerCommand changeProfile

Attribute Type Description
ackToken Integer Acknowledgement token used to send this tracker command
payload String Downlink payload sent in hexadecimal string

EnableDatarate

A bitmap representing each DR to select for the transmission. You Can configure DR from DR0 to DR7. If no DR is selected, default DR will be minimum available DR for the current band. (Supported from Asset Tracker 1.9.0).

Attribute Type Description
dr0 Boolean -false: dr0 is disabled.
-true: dr0 is enabled.
dr1 Boolean -false: dr1 is disabled.
-true: dr1 is enabled.
dr2 Boolean -false: dr2 is disabled.
-true: dr2 is enabled.
dr3 Boolean -false: dr3 is disabled.
-true: dr3 is enabled.
dr4 Boolean -false: dr4 is disabled.
-true: dr4 is enabled.
dr5 Boolean -false: dr5 is disabled.
-true: dr5 is enabled.
dr6 Boolean -false: dr6 is disabled.
-true: dr6 is enabled.
dr7 Boolean -false: dr7 is disabled.
-true: dr7 is enabled.

ErrorInfo

Attribute Type Description
code String A code identifying the error
message String Provides a message describing the error

Geofence

Resource representing a geofence, i.e. a region which is monitored in relationship with devices and transitions.

Attribute Type Description
circleRegion RegionAsCircle
deviceEUIList String List of tracker devices EUI in the geofence. Device EUIs must be separated by commas.
icon String url of an image describing the geofence icon.
name String name of the geofence.
polygonRegion RegionAsPolygon
ref String Ref of the geofence.
regionShape String Shape of the geofence’s monitored region. Possible values are 'CIRCLE’ and 'POLYGON’. Depending on this value, either 'circleRegion’ or 'polygonRegion’ attribute should be set.
transition GeofenceTransition

GeofenceAlarm

Resource representing a geofence’s alarm in a region which is monitored in relationship with a device and transition.

Attribute Type Description
geofence Geofence
transition String Type of the transition. Possible values are 'ENTERING’ and 'LEAVING’. Support of specific transition may vary depending on region types.

GeofenceTransition

Resource representing a transition related to a geofence.

Attribute Type Description
notifyByEmail Boolean Indicates to notify users about geofence alarms by email. Default is false.
notifyOnInterface Boolean Indicates to notify users about geofence alarms on the GUI. Default is false.
type String Type of the transition. Possible values are 'ENTERING’ and 'LEAVING’. Support of specific transitions may vary depending on region types.

GeofencingNotification

Attribute Type Description
geofencingFormat Integer Geofencing identifier format
geofencingType String Geofencing notification type. Possible values are:
- 'SAFE_AREA’: The device moved from hazardous to a safe area.
- 'ENTRY’: The device moved from a non-monitored area to a monitored area.
- 'EXIT’: The device moved from a monitored to a non monitored area.
- 'HAZARD’: The device moved to a hazardous area.
id Integer Identifier, its size depends on the geofencing format.

Hangout

Resource representing an hangout detected from devices

Attribute Type Description
circleRegion RegionAsCircle
deviceEUIList String List of devices EUI in the hangout. Device EUIs must be separated by commas.
hangoutMode HangoutMode
icon String url of an image describing the hangout icon.
polygonRegion RegionAsPolygon
ref String Ref of the hangout.
regionShape String Shape of the hangout’s monitored region. Possible values are 'CIRCLE’,'POLYGON’ and 'UNKNOWN’. Depending on this value, either 'circleRegion’ or 'polygonRegion’ 'unknownRegion’ attribute should be set.
unknownRegion RegionAsUnknown

HangoutAlarm

Resource representing the hangout alarm

Attribute Type Description
dwellTime Integer Time spent by the device in the hangout region, in seconds.
hangout Hangout

HangoutMode

Resource representing hangout modes for devices

Attribute Type Description
dwellTime Integer Time spent by the device in the hangout region, in seconds.
notifyByEmail Boolean Indicates to notify users about the hangout by email. Default is false.
notifyOnInterface Boolean Indicates to notify users about the hangout on the GUI. Default is false.

MacAddressData

Attribute Type Description
rssi Integer Received signal strength indication for this mac address
mac String Mac address

moduleSpec

Attribute Type Description
producerId String
moduleId String
version String

paramName

Possible names of parameter are:

- 'TRACKING_UL_PERIOD’: Period in seconds of position messages while in tracking state (Supported from Asset Tracker 1.7.0, called 'ul_period’ in configuration file).

- 'LORALIVE_PERIOD’: Period in seconds of heartbeat messages in idle state (Supported from Asset Tracker 1.7.0, called 'lora_period’ in configuration file).

- 'ENERGY_STATUS_PERIOD’: Period in seconds of energy status messages (Supported from Asset Tracker 1.7.0, called 'pw_stat_period’ in configuration file).

-'PERIODIC_POSITION_INTERVAL’: Period in seconds of the periodic position report (Supported from Asset Tracker 1.7.0, called 'periodic_pos_period’ in configuration file).

-'PERIODIC_POSITION_PERIOD’: deprecated. See 'PERIODIC_POSITION_INTERVAL’

-'GPS_SCAN_MODE’: Reserved.

-'GPS_SCAN_PROFILE’: deprecated. See 'GPS_SCAN_MODE’.

-'GEOLOC_SENSOR_PROFILE’: (Called 'geoloc_sensor’ in configuration file) The geolocation technology to be used for geolocation scans in operating mode. The possible technolgy values are:
0: WIFI_ONLY: Only the WIFI technology is used (Supported from Asset Tracker 1.7.0).
1: GPS_ONLY: Only the GPS technology is used (Supported from Asset Tracker 1.7.0).
2: XGPS_ONLY : Only the Low Power GPS and GPS technologies are used (Supported from Asset Tracker 1.7.0).
3: WIFI_FALLBACK_XGPS: Swap on failure, alternate WIFI and xGPS (Supported from Asset Tracker 1.7.0).
4: SELF_GOVERNING_HISTORY: Self governing with history (Supported from Asset Tracker 1.7.0).
5: SELF_GOVERNING_TIMEOUT: Self governing with timeout (Supported from Asset Tracker 1.7.0).
6: WGPS_ONLY: The WIFI technology is used fisrt. If the result is not considered OK, swap to GPS technology (Supported from Asset Tracker 1.7.0).
7: WXGPS_ONLY: The WIFI technology is used fisrt. If the result is not considered OK, swap to XGPS technology (Supported from Asset Tracker 1.7.0).
8: WGPS_WXGPS_FAILURE: WGPS/WXGPS, change on failure (Supported from Asset Tracker 1.7.0).
9: WGPS_WXGPS_TIMEOUT: WGPS/WXGPS, change on timeout (Supported from Asset Tracker 1.7.0).
10: BLE: BLE beacon scan only (Supported from Asset Tracker 1.7.0).
11: BGPS_ONLY (Supported from Asset Tracker 1.8.0).

- 'ONESHOT_GEOLOC_METHOD’: (Called 'geoloc_method’ in configuration file) The geolocation technology to used for geolocation scans only for the periodic and on-demand positions. The possible technolgy values are:
0: WIFI (Supported from Asset Tracker 1.7.0).
1: GPS (Supported from Asset Tracker 1.7.0).
2: XGPS (Supported from Asset Tracker 1.7.0).
3: WGPS (Supported from Asset Tracker 1.7.0).
4: WXGPS (Supported from Asset Tracker 1.7.0).
5: BLE (Supported from Asset Tracker 1.7.0).
6: BGPS (Supported from Asset Tracker 1.8.0)

- 'EXT_ANTENNA_PROFILE’: (Called 'antenna’ in configuration file)
* From Asset Tracker 1.7.0 to Asset Tracker 1.9.0:
This parameter is used only for an industrial tracker. The possible values are: .
0: use only PCB antenna for GPS scans.
1: use only ceramic antenna for GPS scans.
2: automatic selection, use ceramic antenna only when facing the sky.
* From Asset Tracker 2.0: Only the value 0 is supported.

- 'MOTION_START_END_NB_TX’: Number of position messages to send after motion events in Start/End tracking mode (Supported from Asset Tracker 1.7.0, called 'motion_nb_pos’ in configuration file).

- 'GPS_TIMEOUT’: Time in seconds for GPS geoloc timeout (Supported from Asset Tracker 1.7.0, called 'gps_timeout’ in configuration file).

- 'XGPS_TIMEOUT’: time in seconds for XGPS geoloc timeout(Supported from Asset Tracker 1.7.0, called 'agps_timeout’ in configuration file).

- 'GPS_EHPE’: Horizontal error in meters to decide if a GPS fix in GPS geoloc is acceptable (Supported from Asset Tracker 1.7.0, called 'gps_ehpe’ in configuration file).

- 'GPS_CONVERGENCE’: Time in seconds before deciding a GPS fix in GPS geoloc has converged for enough time (Supported from Asset Tracker 1.7.0, called 'gps_convergence’ in configuration file).

-'TRANSMIT_STRAT’: Different transmission strategies, applied when the device is in motion (Supported from Asset Tracker 1.7.0, called 'transmit_strat’ in configuration file):
0: Single fixed: always transmit using the predefined datarate (from provisioning).
1: Single Random Datarate: single transmission, applied to (SF7-12) using Central Limit Theorem.
2: Double Random Datarate: double transmission of the same frame using a fast (SF7-8) then a slow datarate (SF9-12), using Central Limit Theorem.
3: Double Fixed: first transmission at SF7 or SF8, then at predefined datarate (from provisioning).
4: Network ADR: Adaptive DataRate, selected by the network. In static, Network ADR is applied.
5: Custom strategy: Activate the strategy defined with transmitStratCustom parameter.

- 'BLE_BEACON_COUNT’: This parameter is used only for a micro tracker. It represents the maximum number of BLE beacons to be reported in the position message (Supported from Asset Tracker 1.7.0, called 'ble_beacon_cnt’ in configuration file).

- 'BLE_BEACON_TIMEOUT’: This parameter is used only for a micro tracker. Time in seconds for BLE Beacon geoloc timeout (Supported from Asset Tracker 1.7.0, called 'ble_beacon_timeout’ in configuration file).

- 'GPS_STANDBY_TIMEOUT’: Time in seconds for the GPS to stay in standby mode after being turned ON. At the timeout, the GPS is turned OFF.When 0, the GPS always stays in standby mode (Supported from Asset Tracker 1.7.0, called 'gps_standby_timeout’ in configuration file).

- 'CONFIRMED_UL_BITMAP’: Confirmed uplink bitmap for specific Messages type.
For example, to configure confirmed uplinks for message type 0x00 and 0x03:20 + 23 = 9. You need to set 9 (Supported from Asset Tracker 1.7.0, called 'confirmed_ul_bitmap’ in configuration file).

-'CONFIRMED_UL_RETRY’: The number of retries for each confirmed uplink, when confirmation is not received (Supported from Asset Tracker 1.7.0, called 'confirmed_ul_retry’ in configuration file).

-'MOTION_SENSITIVITY’: Set a specific accelerometer configuration. 0 is default configuration. 1-100 configures the accelerometer in low sensitivity from 1 to 100%. 101-200 configures the accelerometer in high sensitivity from 1 to 100% (Supported from Asset Tracker 1.8.0, called 'motion_sensitivity’ in configuration file).

- 'SHOCK_DETECTION’: This parameter provides the configuration of the sensitivity of the shock detection from 1 to 100%. A value of 0 disables the shock detection.
(Supported from Asset Tracker 1.8.0, called 'shock_detection’ in configuration file).

- 'PERIODIC_ACTIVITY_PERIOD’: Time in seconds to report periodic activity. As the activity is reported on 6 windows, this value has to be a multiple of 6. When 0, the reporting is disabled (Supported from Asset Tracker 1.8.0, called 'periodic_activity_period’ in configuration file).

- 'MOTION_DURATION’: Time in seconds for motion duration, minimum time between a start and an end motion event (Supported from Asset Tracker 1.8.0, called 'motion_duration’ in configuration file).

- 'BLE_RSSI_FILTER’: RSSI value to filter BLE beacons with BLE-GPS geolocation mode (Supported from Asset Tracker 1.8.0, called 'ble_rssi_filter’ in configuration file).

- 'TEMPERATURE_HIGH’ :Configure the high threshold temperature.
255 = disabled.
(Supported from Asset Tracker 1.9.0, called 'temperature_high’ in configuration file)

- 'TEMPERATURE_LOW’: Configure the low threshold temperature.
255 = disabled
(Supported from Asset Tracker 1.9.0, called 'temperature_low’ in configuration file)

- 'TEMPERATURE_ACTION’: Configure the action to be done when entering critical state: (Supported from Asset Tracker 1.9.0, called 'temperature_action’ in configuration file):
-0: No action.
-1: Geolocation disabled if temperature_high is reached.
-2: Geolocation disabled if temperature_low is reached.
-3: Geolocation disabled if temperature_low or temperature_high is reached.

- 'MODE’: Tracking mode of the trackers (Supported from Asset Tracker 1.9.0, called 'mode’ in configuration file). The possible mode values are:
0: STAND_BY: The tracker is in idle state. It can use periodic reporting if it is activated, and answers to On-Demand position requests.
1: 'MOTION_TRACKING’: Tracking state only when moving.
2: 'PERMANENT_TRACKING’: Always in tracking state.
3: 'MOTION_START_END_TRACKING’: Motion start and end events.
4: 'ACTIVITY_TRACKING’: The tracker focuses on detecting movements. Every motion detection increases a counter.
5: 'OFF’: Everything is turned OFF.

- 'BLE_BOND’: Delete the ble bond (Supported from Asset Tracker 1.9.0, called 'temperature_high’ in configuration file).

- 'BATTERY_CAPACITY’: The battery capacity in mAh (Supported from Asset Tracker 2.0).

- 'REED_SWITCH_CONFIGURATION’: The switch reed configuration (Supported from Asset Tracker 2.0, called 'reed_switch_configuration'in configuration file):
-0: disable.
-1: normal switch reed behaviour.
-2: button
-3: other.

- 'COLLECTION_SCAN_TYPE’: The collection scan type provides the type of the collection to be done.(Supported from Asset Tracker 2.0):
- 0: No collection scan.
-1: BLE beacons.
-2: WIFI BSSID.

- 'COLLECTION_BLE_FILTER_TYPE’: BLE filter type used for BLE collection only (Supported from Asset Tracker 2.0):
-0: No filter.
:-1: Eddystone UID.
:-2: Eddystone URL.
:-3: All Eddystone.
:-4: iBeacon only.
:-5: Altbeacon only.

- 'COLLECTION_BLE_FILTER_MAIN_1’: BLE main filter part 1 used for BLE collection only (Supported from Asset Tracker 2.0).

- 'COLLECTION_BLE_FILTER_MAIN_2’: BLE main filter part 2 used for BLE collection only (Supported from Asset Tracker 2.0).

- 'COLLECTION_BLE_FILTER_SEC_VALUE’: Value used for the BLE secondary filter (BLE collection only) (Supported from Asset Tracker 2.0).

- 'COLLECTION_BLE_FILTER_SEC_MASK’: Mask used for the BLE secondary filter (BLE collection only) (Supported from Asset Tracker 2.0).

- 'COLLECTION_NB_ENTRY’: Provide the number of entries in the collection (Supported from Asset Tracker 2.0).

- 'NETWORK_TIMEOUT_CHECK’: LoRa network monitoring. A timer using this duration is restarted after each last downlink received. Once elapsed, the tracker includes a link check request in all of this uplink. Once the answer is received, the timer restarts. A null value disables this monitoring. Duration expressed in seconds.(Supported from Asset Tracker 2.0).

- 'NETWORK_TIMEOUT_RESET’: LoRa network monitoring. A timer using this duration is restarted after each last downlink received. Once elapsed, the tracker resets. Duration expressed in seconds.(Supported from Asset Tracker 2.0).
- 'GNSS_CONSTELLATION’ : Select the GNSS constellation set to be used for making fixes. Possible values are :
- 0: GPS_ONLY
- 1: GLONASS_ONLY
- 2: GPS_GLONASS
- 3: GPS_GALILEO
-4: GPS_GLONASS_GALILEO
-5: BEIDOU_ONLY
-6: GPS_BEIDOU (Supported from Asset Tracker 2.0)

Attribute Type Description

ProcessedFeed

Resource representing information gathered from the different initial feed resources, processed by the solvers and eventually completed through the resolution.

Attribute Type Description
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
payloadEncoded String Binary device payload encoded as an hexadecimal string.
sequenceNumber Long Sequence number of the device uplink.
receptionTime Date Time associated with the reception of the device uplink, in ISO 8601 format.
SF Integer Spreading factor value of the device.
dynamicMotionState String Motion state provided by the device. Possible values are 'MOVING’, 'STATIC’ and 'UNKNOWN’.
temperatureMeasure Float Temperature measured by the device in celsius degrees.
processedPacket ProcessedFeedPacket
packets ProcessedFeedPacket array List of packets received by base stations and related to the device uplink.
lastContext String This optional attribute contains the Base64 encoded binary solver state returned with the last calculated position. This attribute may be required if the target solver is configured in stateless mode and this is not the first request for a given deviceEUI.
port Integer LoRa port used by the device.

ProcessedFeedPacket

Resource representing a generic packet received by a base station.

Attribute Type Description
baseStationId String Id of the base station (aka LRR or gateway) which received the uplink.
antennaCoordinates double array Coordinates of the base station antenna. Expected value is an array of coordinates as per the GeoJSON specification, i.e. [longitude, latitude, altitude].
SNR Float Signal to Noise ratio in dB.
RSSI Float RSSI in dBm.

Profile

Configuration profile of the tracker (up to 5 tracker parameters). A profile change can take up to 5 minutes to be taken into account.

Attribute Type Description
namespace String Profile namespace. It can be a profile for ADA or for Mobile APP, or 'Subscriber’ for specific subscriber profile namespace
name String Name identifying the profile (English language, should be unique in the namespace).
description String Profile description. (English language)
translations ProfileTranslation array Profile name and description translations (if any).
parameters Resource representing tracker configuration parameter.

ProfileAlarm

Resource representing the profile modification alarm

Attribute Type Description
newProfile Profile

ProfileTranslation

Resource representing a profile translation.

Attribute Type Description
language String Translation language. Must be a ISO-639 code.
name String Profile name translation in the corresponding language.
description String Profile description translation in the corresponding language.

ProvidedAlarm

Resource representing an alarm detected from a device

Attribute Type Description
deviceEUI String Unique tracker device EUI affected by the alert.
alertAlarm AlertAlarm
geofenceAlarm GeofenceAlarm
hangoutAlarm HangoutAlarm
trackerCommandAlarm TrackerCommandAlarm
scanCollectionAlarm ScanCollectionAlarm
profileAlarm ProfileAlarm
batchProfileTrackerCommandAlarm BatchProfileTrackerCommandAlarm
time Date time when the alert is triggered.
typeAlarm String Type of the ProvidedAlarm’s monitored alarm. Possible values are ‘GEOFENCE’,‘HANGOUT’, ‘ALERT’, ‘TRACKER_COMMAND’ or ‘SCAN_COLLECTION’. Depending on this value, either ‘geofenceAlarm’, ‘hangoutAlarm’, ‘alertAlarm’, ‘trackerCommandAlarm’ or ‘scanCollectionAlarm’ attribute should be set.

RawPositionByAgpsSolver

Resource extending RawPositionByGenericSolver with additional information provided by the AGPS solver.

Attribute Type Description
rawPositionType String Type of raw position eventually extending the RawPositionByGenericSolver resource to allow more specific attributes to be provided.
coordinates double array Raw coordinates before filtering. Expected value is an array of coordinates as per the GeoJSON specification, i.e. [longitude, latitude, altitude].
age Integer Age of the raw position, in seconds.
horizontalAccuracy Integer Horizontal accuracy of the raw position, in meters.
verticalAccuracy Integer Vertical accuracy of the raw position, in meters.
horizontalDilution Float Horizontal computed geometric dilution of precision.
verticalDilution Float Vertical computed geometric dilution of precision.
northVelocity Float North component of estimated device velocity, in meters/second.
eastVelocity Float East component of estimated device velocity, in meters/second.
errorInfo ErrorInfo
satelliteCount Integer Number of satellites involved in the resolution.

RawPositionByBleSolver

Resource extending RawPositionByGenericSolver with additional information provided by the Bluetooth LE solver (currently no position is computed, only detected BSSID list is provided).

Attribute Type Description
rawPositionType String Type of raw position eventually extending the RawPositionByGenericSolver resource to allow more specific attributes to be provided.
coordinates double array Raw coordinates before filtering. Expected value is an array of coordinates as per the GeoJSON specification, i.e. [longitude, latitude, altitude].
age Integer Age of the raw position, in seconds.
horizontalAccuracy Integer Horizontal accuracy of the raw position, in meters.
verticalAccuracy Integer Vertical accuracy of the raw position, in meters.
horizontalDilution Float Horizontal computed geometric dilution of precision.
verticalDilution Float Vertical computed geometric dilution of precision.
northVelocity Float North component of estimated device velocity, in meters/second.
eastVelocity Float East component of estimated device velocity, in meters/second.
errorInfo ErrorInfo
bssidCount Integer Number of Bluetooth Low Energy BSSIDs used for the resolution.
bleBssids DetectedBssid array List of detected Bluetooth Low Energy BSSID
beaconIdData BeaconIdData array List of beacon identifier.
beaconFormat String The provided beacon format can be:
- BEACON_ID : The beacon is presented by the beacon identifier.
- MAC_ADDRESS: The beacon is presented by the MAC address.
floorUnderscorenumber Integer Indicates the floor number of the position. It depends to the beacon having the highest value of RSSI.
roomUnderscorename String Indicates the room name of the position. It depends to the beacon having the highest value of RSSI.
additionalUnderscoredata Indicates the additional information related to the position.

RawPositionByGenericSolver

Resource representing generic raw non-filtered position information provided by a solver. To be eventually inherited to define more specific raw position resources. The 'rawPositionType’ discriminator attribute indicates which type of resource is defined.

Attribute Type Description
rawPositionType String Type of raw position eventually extending the RawPositionByGenericSolver resource to allow more specific attributes to be provided.
coordinates double array Raw coordinates before filtering. Expected value is an array of coordinates as per the GeoJSON specification, i.e. [longitude, latitude, altitude].
age Integer Age of the raw position, in seconds.
horizontalAccuracy Integer Horizontal accuracy of the raw position, in meters.
verticalAccuracy Integer Vertical accuracy of the raw position, in meters.
horizontalDilution Float Horizontal computed geometric dilution of precision.
verticalDilution Float Vertical computed geometric dilution of precision.
northVelocity Float North component of estimated device velocity, in meters/second.
eastVelocity Float East component of estimated device velocity, in meters/second.
errorInfo ErrorInfo

RawPositionByGpsSolver

Resource extending RawPositionByGenericSolver with additional information provided by the GPS solver.

Attribute Type Description
rawPositionType String Type of raw position eventually extending the RawPositionByGenericSolver resource to allow more specific attributes to be provided.
coordinates double array Raw coordinates before filtering. Expected value is an array of coordinates as per the GeoJSON specification, i.e. [longitude, latitude, altitude].
age Integer Age of the raw position, in seconds.
horizontalAccuracy Integer Horizontal accuracy of the raw position, in meters.
verticalAccuracy Integer Vertical accuracy of the raw position, in meters.
horizontalDilution Float Horizontal computed geometric dilution of precision.
verticalDilution Float Vertical computed geometric dilution of precision.
northVelocity Float North component of estimated device velocity, in meters/second.
eastVelocity Float East component of estimated device velocity, in meters/second.
errorInfo ErrorInfo

RawPositionByTdoaRssiSolver

Resource extending RawPositionByGenericSolver with additional information provided by the GPS solver.

Attribute Type Description
rawPositionType String Type of raw position eventually extending the RawPositionByGenericSolver resource to allow more specific attributes to be provided.
coordinates double array Raw coordinates before filtering. Expected value is an array of coordinates as per the GeoJSON specification, i.e. [longitude, latitude, altitude].
age Integer Age of the raw position, in seconds.
horizontalAccuracy Integer Horizontal accuracy of the raw position, in meters.
verticalAccuracy Integer Vertical accuracy of the raw position, in meters.
horizontalDilution Float Horizontal computed geometric dilution of precision.
verticalDilution Float Vertical computed geometric dilution of precision.
northVelocity Float North component of estimated device velocity, in meters/second.
eastVelocity Float East component of estimated device velocity, in meters/second.
errorInfo ErrorInfo

RawPositionByWifiSolver

Resource extending RawPositionByGenericSolver with additional information provided by the WiFi solver.

Attribute Type Description
rawPositionType String Type of raw position eventually extending the RawPositionByGenericSolver resource to allow more specific attributes to be provided.
coordinates double array Raw coordinates before filtering. Expected value is an array of coordinates as per the GeoJSON specification, i.e. [longitude, latitude, altitude].
age Integer Age of the raw position, in seconds.
horizontalAccuracy Integer Horizontal accuracy of the raw position, in meters.
verticalAccuracy Integer Vertical accuracy of the raw position, in meters.
horizontalDilution Float Horizontal computed geometric dilution of precision.
verticalDilution Float Vertical computed geometric dilution of precision.
northVelocity Float North component of estimated device velocity, in meters/second.
eastVelocity Float East component of estimated device velocity, in meters/second.
errorInfo ErrorInfo
bssidCount Integer Number of WiFi BSSIDs used for the resolution.
wifiBssids DetectedBssid array List of detected Wifi BSSID

RegionAsCircle

Resource representing a circle-shaped region.

Attribute Type Description
centerCoordinates double array Coordinates of the center of a circle. Expected value is an array of coordinates as per the GeoJSON specification, i.e. [longitude, latitude].
radius Integer Radius of the circle, in meters.

RegionAsPolygon

Resource representing a polygon region.

Attribute Type Description
polygonCoordinates array array Coordinates of multiple points forming a polygon. Expected value is an 2-level array of coordinate arrays as per the GeoJSON specification, i.e. [ [ [longitude, latitude], [longitude, latitude], [longitude, latitude] ] ].

RegionAsUnknown

Resource representing an unknown region.

Attribute Type Description
radius Integer Radius of the region, in meters.

ResolvedPosition

Resource representing a resolved device position with related feed inputs and solver outputs.

Attribute Type Description
deviceEUI String Unique device identifier.
time Date Time associated with the device position, in ISO 8601 format.
customerId String Id of the subscriber or provider-specific customer owning the device in the target ThingPark environment.
modelCfg String Internal property used for routing purposes.
dxProfileId String Unique DX profile identifier, i.e. target ThingPark environment accessible through the DX API platform.
coordinates double array Device position coordinates. Expected value is an array of coordinates as per the GeoJSON specification, i.e. [longitude, latitude, altitude].
age Integer Age of the current position before reception time, in seconds.
validityState String State indicating the validity of the position. Possible values are 'NEW’ (new valid position), 'PREVIOUS’ (previous position is reported because device did not send its position) or 'INVALID’ (reported position is not valid and should not be considered).
horizontalAccuracy Integer Horizontal accuracy of the position, in meters.
verticalAccuracy Integer Vertical accuracy of the position, in meters.
incomingSubscriberId String External Suscriber ID transparently handled by ThingPark Location.
trackerType String The hardware type of the tracker.
processedFeed ProcessedFeed
rawPosition RawPositionByGenericSolver
resolvedTracker ResolvedTrackerAsAssetTracker
uplinkPayload Uplink payload as decoded by Abeeway IoT flow driver. See DX Location driver module for more information
resolvedTrackerParameters Resouce representing the tracker’s parameters maintained in the solver
reverseGeocoding ReverseGeocoding
messageSource String Indicates the type of message source. Possible are values:
-'LORA’: The message is a LORA uplink.
-'MOBILE_APP’: The message is a mobile application uplink.
-'UNKNOWN’: Unknown message source.

ResolvedTrackerAsAssetTracker

Resource representing tracker information obtained through the resolution process. Currently it only supports Abeeway’s Asset Tracker

Attribute Type Description
firmwareVersion String MCU firmware version of the tracker.
bleFirmwareVersion String BLE firmware version of the tracker.
messageType String Type of the message sent by the tracker. Possible values are:
-“UNKNOWN”: Unknown value.
-“UNSUPPORTED”: Not supported value.
- “POSITION_MESSAGE”: GPS, low power GPS, WIFI or BLE position data.
- “ENERGY_STATUS”: Used by the server to estimate the battery level. Contains information related to the power consumption.
- “HEARTBEAT”: Notify the server that tracker is operational and is under LoRa coverage.
- “ACTIVITY_STATUS”: The possible messages are:
* The tracker sends an activity reports by counting the amount of motions with the accelerometer.
* The tracker can report periodically its activity (motion detection).
- “CONFIGURATION”: This message reports the parameter values configured in the trackers.
- “SHOCK_DETECTION”: The shock detection message contains the number of shocks above threshold, and the biggest shock detected during this period.
- “SHUTDOWN”: Sent when the tracker is set off.
- “EVENT”: Notifications sent by the tracker informing the server about specific events.
- “FRAME_PENDING”: When additional messages are available on a gateway, this uplink message is sent to trigger the gateway sending.
- “DEBUG”: a debug message.
- “DATA_SCAN_COLLECTION”: message to report a collection of WIFI BSSID or BLE beacons. (Supported from Asset Tracker 2.0)
- 'EXTENDED_POSITION_MESSAGE’: GPS, low power GPS, WIFI or BLE position data with more precision. (Supported from Asset Tracker 2.2.1)
eventType String The possible values for an event message are:
-'UNKNOWN’: Unknown value.
-'UNSUPPORTED’: Not supported value.
- 'GEOLOC_START’: The event message is sent when the tracker begins a geolocation sequence.
- 'MOTION_START’: The event message is sent when the tracker begins a motion.
- 'MOTION_END’: The event message is sent when the end of a motion is detected.
- 'BLE_CONNECTED’: The event message is sent when a tracker is bonded and BLE connected to a another BLE device.
- 'BLE_DISCONNECTED’: The event message is sent when a tracker is bonded and BLE disconnected to a another BLE device.
- 'TEMPERATURE_ALERT’: The event message is sent if the measured temperature is below or above a configured threshold.(Supported from Asset Tracker 1.9.0).
- 'BLE_BOND_DELETED’: The event message is sent when the bond is deleted on the tracker.(Supported from Asset Tracker 1.9.0)
shutdownCause String Possible values are:
-'UNKNOWN’: Unknown value.
-'UNSUPPORTED’: Not supported value.
- 'USER_ACTION’: Long press button.
- 'LOW_BATTERY’: If the battery is low.
- 'DOWNLINK_REQUEST’: Downlink request to shutdown the tracker.
- 'BLE_REQUEST’: BLE request to shutdown the tracker.
trackingMode String Tracking mode applied by the tracker. Possible values are:
- 'OFF’: Everything is turned OFF to achieve the lowest possible power consumption.
- 'STAND_BY’: The tracker is in idle state. It can use periodic reporting if it is activated, and answers to On-Demand position requests.
- 'MOTION_TRACKING’: Tracking state only when moving.
- 'PERMANENT_TRACKING’: Always in tracking state.
- 'MOTION_START_END_TRACKING’: Motion start and end events.
- 'ACTIVITY_TRACKING’: The tracker focuses on detecting movements. Every motion detection increases a counter.
-'UNKNOWN’: Unknown value.
-'UNSUPPORTED’: Not supported value.
dynamicMotionState String Motion state provided by the device. Possible values are 'MOVING’, 'STATIC’ and 'UNKNOWN’.
temperatureMeasure Float Temperature measured by the device in celsius degrees.
gpsScanMode String GPS scan mode (for power efficiency) applied by the tracker. Not implemented yet.
sensorMode String Sensor mode applied by the tracker. This field is deprecated. Instead refer to geolocSensorProfile and oneshotGeolocMethod.
periodicPositionInterval Integer TimePeriod in seconds of the periodic position report (Supported from Asset Tracker 1.7.0, called 'periodic_pos_period’ in configuration file). A value of 0 means reporting is disabled, a value of -1 means the setting is unknown.
batteryLevel Integer Percentage of available battery of the tracker.
batteryStatus String Represents the battery status. Possible values are:
- 'UNKNOWN’: Not supported value.
- 'CHARGING’: The battery is charging.
- 'OPERATING’: In this case, the battery level indicates the battery usage.
sosFlag Boolean SOS Flag of the tracker
activityReportingWindow integer array Periodic activity reporting contains the data of activity during 6 windows of the configured period ('periodicActivityPeriod’), one window being 1/6th of Periodic Activity Period.
activityCount Integer Activity counter, in case of trackingMode it is 'ACTIVITY_TRACKING’.
nbOfShocks Integer Number of shocks having an accelerometer value above the configured threshold(“shockDetection”).
accelerometerShockData integer array Values measured on X, Y, and Z axes of the accelerometer, corresponding to the biggest shock detected during this period, i.e. [x-axis, y-axis, z-axis].
trackerOrientation integer array Represents the orientation of the tracker. It is provided only in 'MOTION_END’ event message, i.e. [x-axis, y-axis, z-axis].
trackingUlPeriod Integer TimePeriod in seconds for position messages while in tracking state (Supported from Asset Tracker 1.7.0, called “ul_period” in configuration file).
loralivePeriod Integer TimePeriod in seconds for heartbeat messages in idle state (Supported from Asset Tracker 1.7.0, called “lora_period” in configuration file).
energyStatusPeriod Integer Period in seconds of energy status messages (Supported from Asset Tracker 1.7.0, called “pw_stat_period” in configuration file).
geolocSensorProfile String (Called 'geoloc_sensor’ in configuration file) The geolocation technology to be used for geolocation scans in operating mode. The possible technolgy values are:
-'UNKNOWN’: Unknown value.
-'UNSUPPORTED’: Not supported value.
- 'WIFI_ONLY’: Only the WIFI technology is used (Supported from Asset Tracker 1.7.0).
- 'GPS_ONLY’: Only the GPS technology is used (Supported from Asset Tracker 1.7.0).
- 'XGPS_ONLY’: Only the Low Power GPS and GPS technologies are used (Supported from Asset Tracker 1.7.0).
- 'WIFI_FALLBACK_XGPS’: Swap on failure, alternate WIFI and xGPS (do not use).
- 'SELF_GOVERNING_HISTORY’: Self governing with history (do not use).
- 'SELF_GOVERNING_TIMEOUT’: Self governing with timeout (superseded by technology WGPS_WXGPS_TIMEOUT).
- 'WGPS_ONLY’: The WIFI technology is used first. If the result is not OK, swap to GPS technology in one geolocation cycle (Supported from Asset Tracker 1.7.0).
- 'WXGPS_ONLY’: The WIFI technology is used fisrt. If the result is not considered OK, swap to XGPS technology in one geolocation cycle (Supported from Asset Tracker 1.7.0).
- 'WGPS_WXGPS_FAILURE’: 'WGPS/WXGPS’, change on failure (Supported from Asset Tracker 1.7.0).
- 'WGPS_WXGPS_TIMEOUT’: 'WGPS/WXGPS’, change on timeout (Supported from Asset Tracker 1.7.0).
- 'BLE’: BLE beacon scan only (Supported from Asset Tracker 1.7.0).
- 'BGPS_ONLY’: The BLE technology is used first. If the result is not OK, swap to low power GPS technology in one geolocation cycle. (Supported from Asset Tracker 1.8.0).
oneshotGeolocMethod String (Called 'geoloc_method’ in configuration file) The geolocation technology to used for geolocation scans only for the periodic and on-demand positions. The possible technolgy values are:
-'UNKNOWN’: Unknown value.
-'UNSUPPORTED’: Not supported value.
- 'WIFI’: Only the WIFI technology is used (Supported from Asset Tracker 1.7.0).
- 'GPS’: Only the GPS technology is used (Supported from Asset Tracker 1.7.0).
- 'XGPS’: Only the low power GPS technology is used (Supported from Asset Tracker 1.7.0).
- 'WGPS’: The WIFI technology is used first. If the result is not OK, swap to GPS technology (Supported from Asset Tracker 1.7.0).
- 'WXGPS’: The WIFI technology is used first. If the result is not OK, swap to low power GPS technology (Supported from Asset Tracker 1.7.0).
- 'BLE’: BLE beacon scan only (Supported from Asset Tracker 1.7.0).
- 'BGPS’: The BLE technology is used first. If the result is not OK, swap to low power GPS technology in one geolocation cycle. (Supported from Asset Tracker 1.8.0).
extAntennaProfile String The GPS antenna to be used when starting the GPS.( called 'antenna’ in configuration file).
* From Asset Tracker 1.7.0 to Asset Tracker 1.9.0:
Possible values are:
-'UNKNOWN’: Unknown value.
-'UNSUPPORTED’: Not supported value.
- 'PRINTED’: use only PRINTED antenna for GPS scans.
- 'CERAMIC’: use only ceramic antenna for GPS scans.
- 'DYNAMIC’: automatic selection, use ceramic antenna only when facing the sky.
* From Asset Tracker 2.0: Only the value CERAMIC is supported.
motionStartEndNbTx Integer Number of position messages to send after motion events in Start/End tracking mode (Supported from Asset Tracker 1.7.0, called 'motion_nb_pos’ in configuration file).
gpsTimeout Integer Time in seconds for GPS geoloc timeout (Supported from Asset Tracker 1.7.0, called 'gps_timeout’ in configuration file).
xgpsTimeout Integer Time in seconds for XGPS geoloc timeout(Supported from Asset Tracker 1.7.0, called 'agps_timeout’ in configuration file).
gpsEHPE Integer Horizontal error in meters to decide if a GPS fix in GPS geoloc is acceptable (Supported from Asset Tracker 1.7.0, called 'gps_ehpe’ in configuration file).
gpsConvergence Integer Time in seconds to decide a GPS fix if GPS geoloc has converged for enough time (Supported from Asset Tracker 1.7.0, called 'gps_convergence’ in configuration file).
configFlags ConfigFlags
transmitStrat String Different transmission strategies, applied when the device is in motion (Supported from Asset Tracker 1.7.0, called 'transmit_strat’ in configuration file):
-'UNKNOWN’: Unknown value.
-'UNSUPPORTED’: Not supported value.
- 'SINGLE_FIXED’: always transmit using the predefined datarate (from provisioning).
- 'SINGLE_RANDOM_DATARATE’: single transmission, applied to (SF7-12) using Central Limit Theorem.
- 'DOUBLE_RANDOM_DATARATE’: double transmission of the same frame using a fast (SF7-8) then a slow datarate (SF9-12), using Central Limit Theorem.
- 'DOUBLE_FIXED’: first transmission at SF7 or SF8, then at predefined datarate (from provisioning).
- 'NETWORK_ADR’: Adaptive DataRate, selected by the network. In static, Network ADR is applied.
- 'CUSTOM_STRATEGY’: Activate the strategy defined with transmitStratCustom parameter.(Supported from Asset Tracker 1.9.0)
bleBeaconCount Integer This parameter is used only for a micro tracker. It represents the maximum number of BLE beacons to report, Range 1..4.
bleBeaconTimeout Integer This parameter is used only for a micro tracker. Time in seconds for BLE Beacon geoloc timeout (Supported from Asset Tracker 1.7.0, called 'ble_beacon_timeout’ in configuration file)
gpsStandbyTimeout Integer Time in seconds for the GPS to stay in standby mode after being turned ON. At the timeout, the GPS is turned OFF.When 0, the GPS always stays in standby mode (Supported from Asset Tracker 1.7.0, called 'gps_standby_timeout’ in configuration file).
confirmedUlBitmap Integer Confirmed uplink bitmap for specific Messages type. For example, to configure confirmed uplinks for message type 0x00 and 0x03: 2^0 + 2^3 = 9. You need to set 9 (Supported from Asset Tracker 1.7.0, called 'confirmed_ul_bitmap’ in configuration file). For more details, please refer firmware reference document.
confirmedUlRetry Integer The number of retries for each confirmed uplink, when confirmation is not received (Supported from Asset Tracker 1.7.0, called 'confirmed_ul_retry’ in configuration file).
motionSensitivity Integer It is a specific accelerometer configuration. 0 is the default configuration. 1-100 configures the accelerometer in low sensitivity from 1 to 100%. (Supported from Asset Tracker 1.8.0, called 'motion_sensitivity’ in configuration file).
shockDetection Integer This parameter provides the configuration of shock detection global vector. It has a range of 0-199, with a step of 20mG (Supported from Asset Tracker 1.8.0, called 'shock_detection’ in configuration file).
periodicActivityPeriod Integer Time in seconds to report periodic activity. As the activity is reported on 6 windows, this value has to be a multiple of 6. When 0, the reporting is disabled (Supported from Asset Tracker 1.8.0, called 'periodic_activity_period’ in configuration file).
motionDuration Integer Time in seconds for motion duration, minimum time between a start and an end motion event (Supported from Asset Tracker 1.8.0, called 'motion_duration’ in configuration file).
bleRssiFilter Integer RSSI value to filter BLE beacons with BLE-GPS geolocation mode (Supported from Asset Tracker 1.8.0, called 'ble_rssi_filter’ in configuration file).
temperatureHigh Float Configure the high threshold temperature.
255 = disabled
(Supported from Asset Tracker 1.9.0, called 'temperature_high’ in configuration file)
temperatureLow Float Configure the low threshold temperature.
255 = disabled
(Supported from Asset Tracker 1.9.0, called 'temperature_low’ in configuration file)
temperatureAction String Configure the action to be done when entering critical state: (Supported from Asset Tracker 1.9.0, called 'temperature_action’ in configuration file):
- 'UNKNOWN’: Unknown value.
- 'UNSUPPORTED’: Not supported value.
- 'NO_ACTION’: No action.
- 'TEMPERATURE_HIGH’: Geolocation disabled if temperature_high is reached.
- 'TEMPERATURE_LOW’: Geolocation disabled if temperature_low is reached.
- 'TEMPERATURE_LOW_TEMPERATURE_HIGH’: Geolocation disabled if temperature_low or temperature_high is reached.
bleBond String BLE Bond status (Supported from Asset Tracker 1.9.0).
- 'UNKNOWN’:Unknown state.
- 'NOT_BONDED’: The tracker in not bonded.
- 'BONDED’:The tracker is bonded.
transmitStratCustom TransmitStratCustom
measuredTemperature ResolvedTrackerAsAssetTracker_measuredTemperature
batteryCapacity Long The battery capacity in mAh (Supported from Asset Tracker 2.0). Can be -1 if not set.
reedSwitchConfiguration String The switch reed configuration. (Supported from Asset Tracker 2.0).
- 'UNKNOWN’: Unknown configuration.
- 'UNSUPPORTED’: Not supported value.
- 'DISABLE_REED_SWITCH’
- 'NORMAL_REED_SWITCH’
- 'BUTTON_REED_SWITCH’
- 'OTHER_REED_SWITCH’
collectionScanType String Provide the type of the collection to be done.(Supported from Asset Tracker 2.0).
- 'UNKNOWN’:Unknown collection scan type.
- 'UNSUPPORTED’: Not supported value.
- 'NO_COLLECTION_SCAN’: No collection scan
- 'BLE_BEACONS’:The collection will be done and BLE beacons will be reported.
- 'WIFI_BSSID’: The collection will be done and WIFI BSSIDs will be reported.
collectionBLEFilterType String BLE filter type used for BLE collection only (Supported from Asset Tracker 2.0).
- 'UNKNOWN’: Unknown collection BLE filter type.
- 'UNSUPPORTED’: Not supported value.
- 'NO_FILTER’: MAC addresses reported in the collection uplink.
- 'EDDYSTONE_UID’: Beacons ID reported in the collection uplink
- 'EDDYSTONE_URL’: Eddystone URL only. MAC addresses reported in the collection uplink.
- 'ALL_EDDYSTONE’: MAC addresses reported in the collection uplink
- 'IBEACON_ONLY’: Beacon IDs reported in the collection uplink
- 'ALTBEACON_ONLY’: Beacon IDs reported in the collection uplink
collectionBLEFilterMain1 Long BLE main filter part 1 used for BLE collection only (Supported from Asset Tracker 2.0).
collectionBLEFilterMain2 Long BLE main filter part 2 used for BLE collection only (Supported from Asset Tracker 2.0).
collectionBLEFilterSecValue Long Value used for the BLE secondary filter (BLE collection only) (Supported from Asset Tracker 2.0).
collectionBLEFilterSecMask Long Mask used for the BLE secondary filter (BLE collection only) (Supported from Asset Tracker 2.0).
collectionNbEntry Integer Provide the number of entries in the collection (Supported from Asset Tracker 2.0).
networkTimeoutCheck Integer LoRa network monitoring. A timer using this duration is restarted after each last downlink received. Once elapsed, the tracker includes a link check request in all of this uplink. Once the answer is received, the timer restarts. A null value disables this monitoring. Duration expressed in seconds. (Supported from Asset Tracker 2.0)
networkTimeoutReset Integer LoRa network monitoring. A timer using this duration is restarted after each last downlink received. Once elapsed, the tracker resets. Duration expressed in seconds.(Supported from Asset Tracker 2.0)
scanCollection ScanCollection
gnssConstellation String Select the GNSS constellation set to be used for making fixes. Possible values are :
- 'UNKNOWN’
- 'UNSUPPORTED’
- 'GPS_ONLY’
- 'GLONASS_ONLY’
- 'GPS_GLONASS’
- 'GPS_GALILEO’
- 'GPS_GLONASS_GALILEO’
- 'BEIDOU_ONLY’
- 'GPS_BEIDOU’
(Supported from Asset Tracker 2.0)
angleDetection AngleDetection
geofencingNotification GeofencingNotification

ResolvedTrackerAsAssetTracker_measuredTemperature

Provides data about the measured temperature for the event message “TEMPERATURE_ALERT”(Supported from Asset Tracker 1.9.0).

Attribute Type Description
state String The state of temperature. Possible values are:
- 'UNKNOWN’: Unknown value.
- 'UNSUPPORTED’: Not supported value.
-'NORMAL’
- 'HIGH’
-'LOW’
-'FEATURE_NOT_ACTIVATED’
max Float Maximum temperature measured by the device
min Float Minimum temperature measured by the device
highCounter Integer From the time a high temperature event is sent, this counter is incremented every 10 minutes (can be used to calculate the over temperature time).
lowCounter Integer From the time a low temperature event is sent, this counter is incremented every 10 minutes (can be used to calculate the under temperature time).

ReverseGeocoding

Resource representing reverse geocoding information retrieved for the current position.

Attribute Type Description
formattedAddress String Formatted address of the reverse geocoding response, if any.
geolocationProvider String Geolocation provider identifier used for this reverse geocoding operation.
status String Status of reverse geocoding operation. Possible values are:
- 'RETRIEVED’: Reverse geocoding information retrieved.
- 'RETRIEVED’: No reverse geocoding information found.
-'NO_PROVIDER’: No geolocation provider available for the current subscriber.
-'ERROR’: Error retrieving reverse geocoding data.

ScanCollection

Attribute Type Description
scanType String Type of scan collection.
- 'BLE_BEACONS’:The collection will be done and BLE beacons will be reported.
- 'WIFI_BSSID’: The collection will be done and WIFI BSSIDs will be reported.
again Boolean -false: No next associated uplink. -true: Another associated uplink will follow.
dataFormat String The data format
- 'BEACON_ID’: The Data information field is coded on 4 bytes and contains the beacon identifier.
- 'MAC_ADDRESS’: The Data information field is coded on 7 bytes and contains the MAC address.
fragmentIdentification Integer Fragment identification
collectionIdentifier Integer Collection identification
hash Integer The hash of the associated position message. Hash is the xor sum on the whole position message (including the payload header). All fragments have the same hash.
beaconIdData BeaconIdData array List of beacon identifier.
macAddressData MacAddressData array List of MAC address

ScanCollectionAlarm

Resource representing the scan collection alarm

Attribute Type Description
position ScanCollectionAlarm_position
scanResult ScanCollectionAlarm_scanResult
state ScanCollectionAlarm_state

ScanCollectionAlarm_position

Attribute Type Description
horizontalAccuracy Integer Horizontal accuracy of the position, in meters.
receptionTime Date time when position is received
coordinates double array the resolved position as per the GeoJSON specification, i.e. [longitude, latitude, altitude].

ScanCollectionAlarm_scanResult

The result of the scan operation

Attribute Type Description
scanType String Scan type:
- 'BLE_ID’: BLE beacons with information coded on 2 bytes (beacon identifier) and detected RSSI.
- 'BLE_MAC’: BLE beacons with MAC address and detected RSSI.
- 'WIFI_BSSID’: Wifi BSSID scan information with MAC address and detected RSSI. Depending on this value, the items in 'result’ should be either 'BeaconIdInformation’, 'BeaconMACInformation’ or 'WifiBSSIDInformation’.
result ScanInformation array

ScanCollectionAlarm_state

Attribute Type Description
positionState String state of the position message reception:
- 'GPS_SUCCESS’: GPS position received.
- 'GPS_TIMEOUT’: GPS position time out message received.
- 'WIFI_SUCCESS’: WIFI position resolved and received.
- 'WIFI_TIMEOUT’: WIFI time out message received.
- 'WIFI_FAILURE’: WIFI failure message received.
- 'WIFI_RESOLUTION_FAILURE’: WIFI position resolution problem.
- 'LPGPS_SUCCESS’: LPGPS position resolved and received.
- 'LPGPS_RESOLUTION_FAILTURE’: LPGPS position resolution problem.
- 'BLE_SUCCESS’: BLE Beacon scan success.
- 'BLE_TIMEOUT’: BLE Beacon Scan timeout.
- 'POSITION_LOST’: No position message received.
scanState String state of the scan collection messages reception:
- 'SUCCESS’: The complete scan collection is received.
- 'INCOMPLETE’: One or more scan collection fragments are missing.
- 'SCAN_RECEPTION_TIMEOUT’: Time out in waiting for the complete scan collection.

ScanInformation

Resource representing a single beacon or BSS information

Attribute Type Description
scanInformationType String Type of scan information.:
- 'BeaconIdInformation’: BLE Beacon Id
- 'BeaconMACInformation’: BLE Mac address.
- 'WifiBSSIDInformation’: WIFI BSSID.
rssi Integer

thingSpec

Attribute Type Description
model moduleSpec
application moduleSpec

TrackerCommand

Resource representing a generic command to be sent through a downlink to an Abeeway tracker.

Attribute Type Description
deviceEUI String Tracker device EUI affected by the command.
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
trackerCommandType String Type of command for the list of trackers. Depending on the type, other attributes can be set for the command resource.
notificationType TrackerCommandNotificationType
callbackURL String HTTP url of the target server to which the tracker command should be sent as a callback to the downlink.

TrackerCommandAlarm

Resource representing the tracker command alarm

Attribute Type Description
trackerCommand TrackerCommand
ackToken Integer Acknowledgement token used to send this tracker command
payload String Downlink payload sent in hexadecimal string
timeout Date Timeout set for this tracker command
commandTime Date Time when this tracker command was received
state String Tracker command result state:
- 'RECEIPT_SUCCEEDED’: The tracker has received the tracker command.
- 'RECEIPT_FAILED’: The tracker may not have received the tracker command.
- 'TIMEOUT’: Time out in waiting for downlink acknowledgement.
- 'DELIVERY_ERROR’: error in sending the downlink payload to the underlying operator.

TrackerCommandNotificationType

Attribute Type Description
notifyByEmail Boolean Indicates to notify user about tracker command by email. Default is false.
notifyOnInterface Boolean Indicates to notify users about about tracker command on the GUI. Default is false.
asyncResponseUplinkPeriods Integer Number of uplink periods to wait before notification timeout
asyncResponseSlack Integer Delay on top of asyncResponseUplinkPeriods * uplink period duration to wait before timeout

TrackerCommandToChangeMode

Resource representing a command used to change the operating mode of trackers.

Attribute Type Description
deviceEUI String Tracker device EUI affected by the command.
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
trackerCommandType String Type of command for the list of trackers. Depending on the type, other attributes can be set for the command resource.
notificationType TrackerCommandNotificationType
callbackURL String HTTP url of the target server to which the tracker command should be sent as a callback to the downlink.
newMode String New operating mode to apply to the trackers. Possible values are:
- 'OFF’: Everything is turned OFF to achieve the lowest possible power consumption.
- 'STAND_BY’: The tracker is in idle state. It can use periodic reporting if it is activated, and answers to On-Demand position requests.
- 'STANDBY’: deprecated. See 'STAND_BY’
- 'MOTION_TRACKING’: Tracking state only when moving.
- 'MOTION’: deprecated. See 'MOTION_TRACKING’.
- 'PERMANENT_TRACKING’: Always in tracking state.
- 'PERMANENT’: deprecated. See 'PERMANENT_TRACKING’.
- 'MOTION_START_END_TRACKING’: Motion start and end events.
- 'START_END’: deprecated. See 'MOTION_START_END_TRACKING’.
- 'ACTIVITY_TRACKING’: The tracker focuses on detecting movements. Every motion detection increases a counter.
- 'ACTIVITY’: deprecated. See 'ACTIVITY_TRACKING’.

TrackerCommandToChangeParam

Resource representing a command used to change a tracker parameter.

Attribute Type Description
deviceEUI String Tracker device EUI affected by the command.
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
trackerCommandType String Type of command for the list of trackers. Depending on the type, other attributes can be set for the command resource.
notificationType TrackerCommandNotificationType
callbackURL String HTTP url of the target server to which the tracker command should be sent as a callback to the downlink.
paramName paramName
paramValue String Value of the parameter to update. Should always be passed as a string, regardless of the parameter unit type.

TrackerCommandToChangeParams

Resource representing a command used to change parameter(s) of trackers.

Attribute Type Description
deviceEUI String Tracker device EUI affected by the command.
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
trackerCommandType String Type of command for the list of trackers. Depending on the type, other attributes can be set for the command resource.
notificationType TrackerCommandNotificationType
callbackURL String HTTP url of the target server to which the tracker command should be sent as a callback to the downlink.
parameters ConfigurationParameter array

TrackerCommandToChangeProfile

Resource representing a command used to change the current tracker configuration profile.

Attribute Type Description
deviceEUI String Tracker device EUI affected by the command.
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
trackerCommandType String Type of command for the list of trackers. Depending on the type, other attributes can be set for the command resource.
notificationType TrackerCommandNotificationType
callbackURL String HTTP url of the target server to which the tracker command should be sent as a callback to the downlink.
profileNamespace String Configuration profile namespace to set
profileName String Configuration profile name to set

TrackerCommandToGetParam

Resource representing a command used to get the configuration parameter (s) of the trackers.

Attribute Type Description
deviceEUI String Tracker device EUI affected by the command.
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
trackerCommandType String Type of command for the list of trackers. Depending on the type, other attributes can be set for the command resource.
notificationType TrackerCommandNotificationType
callbackURL String HTTP url of the target server to which the tracker command should be sent as a callback to the downlink.
paramName paramName

TrackerCommandToSendAbeewayDownlinkPayload

Resource representing a command used to change the current tracker configuration profile.

Attribute Type Description
deviceEUI String Tracker device EUI affected by the command.
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
trackerCommandType String Type of command for the list of trackers. Depending on the type, other attributes can be set for the command resource.
notificationType TrackerCommandNotificationType
callbackURL String HTTP url of the target server to which the tracker command should be sent as a callback to the downlink.
abeewayDownlinkPayload Abeeway downlink payload as described in Abeeway IoT Flow driver (abeewayDownlinkPayload.ackToken is not required, it will be replaced by a generated value)
thing thingSpec

TrackerCommandToSendRawData

Send raw payload to the tracker.

Attribute Type Description
deviceEUI String Tracker device EUI affected by the command.
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
trackerCommandType String Type of command for the list of trackers. Depending on the type, other attributes can be set for the command resource.
notificationType TrackerCommandNotificationType
callbackURL String HTTP url of the target server to which the tracker command should be sent as a callback to the downlink.
rawPayload String Raw Payload to be sent to the tracker

TrackerCommandToSendRequest

Resource representing a command used to send a request to the trackers.

Attribute Type Description
deviceEUI String Tracker device EUI affected by the command.
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
trackerCommandType String Type of command for the list of trackers. Depending on the type, other attributes can be set for the command resource.
notificationType TrackerCommandNotificationType
callbackURL String HTTP url of the target server to which the tracker command should be sent as a callback to the downlink.
requestType String Type of the request to be sent to the trackers. Possible values are:
-'POS_ON_DEMAND’: Request tracker position (Supported from Asset Tracker 1.7.0).
-'RESET’: Reset tracker (Supported from Asset Tracker 1.7.0).
-'START_SOS’: Turn on SOS mode of the tracker.
-'STOP_SOS’: Turn off SOS mode of the tracker.
-'RESET_SOS’: deprecated. See 'STOP_SOS’
-'RESET_BATTERY’: For primary batteries, when replacing it (Supported from Asset Tracker 1.7.0).
-'RESET_BLE_PAIRING’: Reset tracker BLE bond (Supported from Asset Tracker 1.7.0).
-'GET_DEVICE_CONFIG’: Retrieve the complete configuration of the tracker (Supported from Asset Tracker 1.7.0).
-'GET_CONFIG_FLAGS’: Retrieve the configuration flags parameter (Supported from Asset Tracker 1.7.0).
-'GET_BLE_FIRMWARE_VERSION’: Get the BLE firmware version (Supported from Asset Tracker 1.7.0).
-'GET_MCU_FIRMWARE_VERSION’: Get the MCU firmware version (Supported from Asset Tracker 1.7.0).
-'GET_X_AXIS_ACCELEROMETER’: Get the X axis accelerometer value in mg (Supported from Asset Tracker 1.8.0).
-'GET_Y_AXIS_ACCELEROMETER’: Get the Y axis accelerometer value in mg (Supported from Asset Tracker 1.8.0).
-'GET_Z_AXIS_ACCELEROMETER’: Get the Z axis accelerometer value in mg (Supported from Asset Tracker 1.8.0).
-'REQUEST_TEMPERATURE_STATUS’: Request temperature status. The tracker answers this request with a temperature event message.(Supported from Asset Tracker 1.9.0)

TrackerCommandToSetConfigFlags

Resource representing a command used to set the configuration flags of trackers.

Attribute Type Description
deviceEUI String Tracker device EUI affected by the command.
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
trackerCommandType String Type of command for the list of trackers. Depending on the type, other attributes can be set for the command resource.
notificationType TrackerCommandNotificationType
callbackURL String HTTP url of the target server to which the tracker command should be sent as a callback to the downlink.
framePendingMechanism Boolean false: Frame pending mechanism is disabled.
true: Frame pending mechanism is enabled. Factory default value.
(Supported from Asset Tracker 1.7.0)
buttonPressToTurnDeviceOff Boolean false: Cannot turn OFF device with a button press.
true: Can turn OFF device with a button press. Factory default value.
(Supported from Asset Tracker 1.7.0)
doubleClickIsSosModeOrAlert Boolean false: Double button click triggers an Alert.
true: Double button click starts SOS mode, another double click stops it. Factory default value.
(Supported from Asset Tracker 1.7.0)
downlinkSetParameterConfirmation Boolean false: Confirmation uplink mechanism is disabled.
true: Confirmation uplink mechanism is enabled. Factory default value.
(Supported from Asset Tracker 1.7.0)
wifiPayloadWithNoCypher Boolean false: Wifi payload is cyphered.
true: Wifi payload is not cyphered. Factory default value.
(Supported from Asset Tracker 1.7.0)
bleAdvertisingAtStart Boolean false: BLE advertising is disabled. Factory default value.
true: BLE advertising is enabled.
(Supported from Asset Tracker 1.7.0)
selectWifiScanOrGeolocStartMessage Boolean false: Enable geoloc start event message when starting a geoloc sequence.
true: Enable Wifi scan when starting a geoloc sequence. Factory default value.
(Supported from Asset Tracker 1.7.3)
ledBlinkWithGpsFix Boolean false: No blink when a GPS fix is received. Factory default value.
true: LED Blink when a GPS fix is received.
(Supported from Asset Tracker 1.7.3)
startMotionEventUplink Boolean false: Start Motion event payload is disabled. Factory default value.
true: Start Motion event payload is enabled.
(Supported from Asset Tracker 1.8.0)
endMotionEventUplink Boolean false: End Motion event payload is disabled. Factory default value.
true: End Motion event payload is enabled.
(Supported from Asset Tracker 1.8.0)
otaJoinWhenLeavingModeOff Boolean false: Disable OTA join when leaving mode OFF. Factory default value.
true: Enable OTA join when leaving mode OFF.
(Supported from Asset Tracker 1.8.0)
rejectAsymmetricBlePairing Boolean false: Accept asymmetric BLE pairing. Factory default value.
true: Reject asymmetric BLE pairing.
(Supported from Asset Tracker 1.8.0)
enableLongWifiPayload Boolean false: Long wifi payload is disabled. Factory default value.
-true: Long wifi payload is enabled.
(Supported from Asset Tracker 1.9.0)
collectionLongReport Boolean false: The usual payload size is used (36 bytes).
true: The number of entries carried in the uplink is larger and use a payload size of 91 bytes.
(Supported from Asset Tracker 2.0)
autoStart Boolean false: Once LoRa join succeeds, the user needs to make another long press to actually start in the configured operating mode.
true: Once LoRa join succeeds, the device automatically starts without requiring a long press.
(Supported from Asset Tracker 2.0)

TrackerCommandToSetCustomTransmitStrat

Resource representing a command used to set the configuration flags of trackers.

Attribute Type Description
deviceEUI String Tracker device EUI affected by the command.
deviceProfileId String Id of the profile associated with the device, used for decoding properly the payload.
trackerCommandType String Type of command for the list of trackers. Depending on the type, other attributes can be set for the command resource.
notificationType TrackerCommandNotificationType
callbackURL String HTTP url of the target server to which the tracker command should be sent as a callback to the downlink.
ADREnabled Boolean ADR activation in static (Supported from Asset Tracker 1.9.0)
-false: ADR is enabled.Factory default value.
-true: ADR is disabled.
transmissionType String Transmission type (Supported from Asset Tracker 1.9.0)
-'SINGLE’: single transmission Factory default value.
-'DOUBLE’: double transmission.
firstTransmissionDatarateDistribution String First transmission data rate distribution (Supported from Asset Tracker 1.9.0). Possible values are:
-'UNKNOWN’: Not supported value.
-'RANDOM’: Factory default value.
-'BELL’
-'RING’
secondTransmissionDatarateDistribution String Second transmission data rate distribution (Supported from Asset Tracker 1.9.0). Possible values are:
-'UNKNOWN’: Not supported value.
-'RANDOM’: Factory default value.
-'BELL’
-'RING’
firstTransmissionDatarate EnableDatarate
secondTransmissionDatarate EnableDatarate

TransmitStratCustom

Attribute Type Description
ADREnabled Boolean ADR activation in static (Supported from Asset Tracker 1.9.0)
-false: ADR is enabled.Factory default value.
-true: ADR is disabled.
transmissionType String Transmission type (Supported from Asset Tracker 1.9.0)
-'SINGLE’: single transmission Factory default value.
-'DOUBLE’: double transmission.
firstTransmissionDatarateDistribution String First transmission data rate distribution (Supported from Asset Tracker 1.9.0). Possible values are:
-'UNKNOWN’: Unknown value.
-'UNSUPPORTED’: Not supported value.
-'RANDOM’: Factory default value.
-'BELL’
-'RING’
secondTransmissionDatarateDistribution String Second transmission data rate distribution (Supported from Asset Tracker 1.9.0). Possible values are:
-'UNKNOWN’: Unknown value.
-'UNSUPPORTED’: Not supported value.
-'RANDOM’: Factory default value.
-'BELL’
-'RING’
firstTransmissionDatarate EnableDatarate
secondTransmissionDatarate EnableDatarate

WifiBSSIDInformation

Resource representing a Wifi information with BSSID and RSSI

Attribute Type Description
scanInformationType String Type of scan information.:
- 'BeaconIdInformation’: BLE Beacon Id
- 'BeaconMACInformation’: BLE Mac address.
- 'WifiBSSIDInformation’: WIFI BSSID.
rssi Integer
bssid String