Micro Tracker user guide Micro Tracker Firmware V1.6 ABEEWAY SAS contact@abeeway.com www.abeeway.com Micro Tracker User Guide FW1.6 V1.1 Table of contents 1 Introduction ............................................................................................................................ 3 1.1 General Description .......................................................................................................... 3 1.2 Applications ...................................................................................................................... 3 2 3 Features .................................................................................................................................. 3 Installation .............................................................................................................................. 4 3.1 Getting started .................................................................................................................. 4 3.2 Fixation ............................................................................................................................. 4 4 Functioning ............................................................................................................................. 5 4.1 Main operating modes ...................................................................................................... 5 4.2 Side operations ................................................................................................................. 6 4.3 User interface ................................................................................................................... 6 4.4 Geolocation strategies ...................................................................................................... 8 5 6 Uplink messages ...................................................................................................................... 9 Remote configuration using ADA ........................................................................................... 10 6.1 Operating Mode Configuration ....................................................................................... 10 6.2 6.3 Position on demand ........................................................................................................ 10 Parameters configuration ................................................................................................ 10 7 Downlink messages ............................................................................................................... 11 7.1 Ack Token ........................................................................................................................ 11 7.2 Mode Configuration ........................................................................................................ 12 7.3 7.4 Position on demand ........................................................................................................ 12 Parameters configuration ................................................................................................ 12 8 Specifications ........................................................................................................................ 15 8.1 8.2 Physical configuration ..................................................................................................... 15 Estimated lifetime ........................................................................................................... 15 8.3 Data communication support .......................................................................................... 15 8.4 8.5 Position accuracy ............................................................................................................ 16 Power management ........................................................................................................ 16 9 Products References .............................................................................................................. 16 Page 2 of 17 11 October 2018 Company Confidential restricted distribution Micro Tracker User Guide FW1.6 V1.1 1 Introduction 1.1 General Description The Abeeway Micro Tracker is a multi-mode tracker combining GPS/Low power GPS, Wi-Fi, LoRa, BLE radios with embedded sensors to support accurate outdoor and indoor geolocation. A button, a buzzer and 3 LEDs are available to interface with the user. The Micro Tracker, with its small size and long battery lifetime, is the ideal product for many tracking applications. 1.2 Applications Comment [AD1]: Need to be aligned with dataheet Asset tracking at fixed frequency updates or on demand. Personal tracking with help button. Safety monitoring for isolated workers inside facilities or in outdoor. Anti-theft; Notification and location when device is moving. Geofencing applications. 2 Features Multiple operating modes Motion tracking: Get the tracker position at a given cycle when motion is detected. Permanent tracking: Get permanently a position of the tracker. Start/End motion tracking: Get position messages during motion start and end events. Activity tracking: Monitor activity rate with embedded sensors. OFF: device stopped Position on demand: Receive the tracker position only when needed (very low power operating mode). Used geolocation technologies GPS: Precise outdoor position. WI-FI: Position indoors and urban area. Low power GPS: get quick position outdoors and daylight indoor conditions. Buzzer and LEDs Temperature monitoring Embedded antennas LoRa Class A radio Water-spray resistant enclosure (IP64) Page 3 of 17 11 October 2018 Company Confidential restricted distribution 3 Installation Micro Tracker User Guide FW1.6 V1.1 Antennas area Blue LED Micro USB White Charge LED Button Lanyard 3.1 Getting started Charge your device using a micro USB cable. While charging the white led is ON. When the battery is fully charged the white LED goes OFF. A long press is needed to turn ON the device (starting in motion tracking mode in standard configuration). Your network can use two activation modes:
o OTAA (Over The Air Activation) that requires the following keys to make the join: DEVEUI, APPEUI and APPKEY for each device. (the most used) o ABP (Activation by personalization) that requires the following keys to make the join:
DEVEUI, DEVADDR and NWKSKEY for each device Depending on your operator, some actions need to be done to activate the transfer of the data through Abeeway servers. Please refer to your vendor for more information. 3.2 Fixation The device can be attached with the provided lanyard or placed in bag, or inside an asset. Note: the environment and orientation of the tracker can influence the radio performance. For optimum results keep the zone around the antenna area clear from any conducting material or magnetic field. Page 4 of 17 11 October 2018 Company Confidential restricted distribution Micro Tracker User Guide FW1.6 V1.1 4 Functioning 4.1 Main operating modes This section describes the different operational modes supported by the trackers. OFF mode: The tracker is in deep low power mode. No uplinks are sent in this mode. A long button press is required to wake it up. Three possibilities to set the tracker in OFF mode:
User action (long button press) Low battery Downlink request Standby mode: The tracker is sending periodically short LoRa messages, called heartbeat at the chosen period (lora_period). Device position can be obtained in this mode by using the side operations features (see next section). Motion tracking mode: The tracker provides positions when the device is moving. The reporting is done at the chosen period (ul_period). The positions are acquired based on the geoloc_sensor geolocation technology. If the device is not moving, heartbeat messages are sent regularly at the lora_period frequency. Additional positions can be obtained by using the on-demand side operations features. Note: Whatever the chosen geolocation policy, the first position is always established via WI-FIWi-
Fi sent immediately after the beginning of the motion. Permanent tracking mode: The device reports its positions at ul_period frequency regardless the motion. It uses the geoloc_sensor geolocation technology. Heartbeat messages are sent if there are no uplink message during lora_period seconds. Motion Start/End tracking mode: In this mode, position messages are sent twice, at the start and at the end of a motion (one Wi-Fi and one using the geoloc_sensor geolocation technology). The end of the motion is detected when there is no movement detection for a period of 120 seconds. Heartbeat messages are sent if there are no uplink message during lora_period seconds. Additional positions can be obtained by using the on-demand side operation feature. Activity mode: This mode sends activity reports instead of positions. The tracker focuses on detecting movements. Each shake detection increases a counter (after applying an integration period). The value of the counter is reported up the LoRa link at the ul_period frequency. Heartbeat messages are sent if there are no uplink messages during lora_period seconds. Additional positions can be obtained by using the on-demand side operations features. Note: The accuracy of the different frequencies is not guaranteed as extra delay may be introduced by the LoRa network duty cycle. Page 5 of 17 11 October 2018 Company Confidential restricted distribution Micro Tracker User Guide FW1.6 V1.1 4.2 Side operations Whatever the mode, optional messages can be sent according to the configuration. The side operations can be:
Periodic position message: The device sends periodically its position at periodic_pos_period frequency. Usually, this reporting frequency is very long. The position is sent three times (six if the device is moving). Position on Demand: Position requests are done via LORA downlink message. The device answers with its current position. Alert position: A double press on the button generates a LORA uplink message containing the position. Notes:
The geolocation strategy used in these cases is geoloc_method one. The side operations can be cumulated. 4.3 User interface 4.3.1 Button management Sequence Action Output One short press Show current mode and state Two short presses Trigger an alert position Any press when battery low
(short or long press) Go to OFF mode One long press when device OFF and good battery Wake up Led state pattern (see next section) Other Led pattern (see next section) Buzzer melody other Led pattern (see next section) Other Led pattern (see next section) only for the first wake up after reset One very long press (5 s) when device ON. Button down when device is ON Go to the OFF mode Buzzer melody Blue LED ON Page 6 of 17 11 October 2018 Company Confidential restricted distribution Micro Tracker User Guide FW1.6 V1.1 4.3.2 Blue LEDs mode and state patterns This interface output is triggered by a single short button press. It generates two main sequences The two sequences are consecutives. The first one indicates the mode, and, is followed by the state of the tracker. The LED behavior are provided below. Show current mode Mode Standby: No blink. Mode Motion Track: One long blink. Mode Permanent Track: Two long blinks. Mode Motion Start/End Track: Three long blinks. Mode Activity: Four long blinks. Show current state State Idle: No blink. State Tracking: Two fast blinks. 4.3.3 Other blue LEDs patterns Three fast blinks Three slow blinks Go to the OFF mode (Low battery) Device starting for the first time Long fast blink of blue LED LORA join operation in progress Fast blink of blue LED after two button clicks 4.3.4 Buzzer melodies There are three different melodies:
Melody Major rising scale Major falling scale Low battery Device acknowledges the alert position Meaning Device is starting Device is going to OFF mode Low battery detected Page 7 of 17 11 October 2018 Company Confidential restricted distribution Micro Tracker User Guide FW1.6 V1.1 4.4 Geolocation strategies 4.4.1 Main operating modes The following geolocation policies (geoloc_sensor parameter) are used when the operating mode is either motion-tracking, permanent-tracking, or start/end tracking. WI-FI only Only WI-FI scans are used for position determination. GPS only Only the GPS is used for position determination. LP-GPS only GPS and LP-GPS are used for position determination. Multimode (WI-FI + AGPS + GPS) Alternate WI-FI, LP-GPS and GPS technologies on failure, with timeout. Wi-Fi-GPS only WI-FI then GPS if Wi-Fi fails in one geolocation cycle. Wi-Fi-LPGPS only Wi-Fi then LP-GPS if Wi-Fi fails in one geolocation cycle. Wi-Fi-LPGPS/ Wi-Fi-GPS Wi-Fi-LPGPS first, then Wi-Fi-GPS if Wi-Fi-LPGPS fails until timeout, then back to Wi-Fi-LGPS. Note: The first position is always a Wi-Fi one whatever the chosen geolocation strategy. 4.4.2 Side operations The following geolocation policies (geoloc_method parameter) are used for periodic-reporting or on-demand actions. Wi-Fi only Only Wi-Fi scans are used for position determination. GPS only Only the GPS is used for position determination. LP-GPS only GPS and LP-GPS are used for position determination. Wi-Fi-GPS only Wi-Fi then GPS if Wi-Fi fails in one geolocation cycle. Wi-Fi-LPGPS only Wi-Fi then LP-GPS if Wi-Fi fails in one geolocation cycle. Page 8 of 17 11 October 2018 Company Confidential restricted distribution 5 Uplink messages Micro Tracker User Guide FW1.6 V1.1 Type of message Content Heartbeat message Notify the server the tracker is operational and under LoRa coverage Position message GPS, low power GPS or Wi-Fi position data Energy status message Used by the server to estimate the battery level. Contain information related to the power consumption Activity Status message Reports the activity counter. Used only by the activity tracking operating mode Debug message Internal used only Frame pending When additional downlink messages are available on gateway, this uplink message is sent to trigger the sending (and speed up the configuration of the tracker) OFF message Notify the move to the OFF state Page 9 of 17 11 October 2018 Company Confidential restricted distribution 6 Remote configuration using ADA All following parameters are configurable in Abeeway Data Analyzer (ADA) application Micro Tracker User Guide FW1.6 V1.1 6.1 Operating Mode Configuration All modes can be set using ADA application:
Standby Motion tracking Permanent tracking Motion start/end tracking Activity tracking OFF 6.2 Position on demand Position of the tracker can be requested. 6.3 Parameters configuration Following parameters are configurable:
Parameters used in the main operating modes:
LoRa Heartbeat: period of Lora Heartbeat messages Position report: period of LoRa position messages Geolocation methodology (geoloc sensor) Parameters used in side operating modes:
Periodic position: activation, and period of LoRa position messages Geolocation methodology (geoloc method) Page 10 of 17 11 October 2018 Company Confidential restricted distribution 7 Downlink messages Micro Tracker User Guide FW1.6 V1.1 These messages are sent from the server to the tracker through the LoRa network. They are used to configure the tracker or request a position. Each message contains a header including:
A message type An acknowledgement token The remaining of the message depends on the message type. The tracker accepts three types of downlink messages, listed in the following table:
Message type ID Description POD Set Mode Set Param 0x01 0x02 0x0B Position on demand Change the tracker mode Modify a parameter Notes 1. Any unexpected message (unknown message type, bad length, ...) is discarded. However, the ack token is updated even if the message is discarded (if the payload is at least 2 bytes long). 2. The LoRa port to be used for downlink is 2. 7.1 Ack Token It provides a way to indicate to the application that a given message has been received and processed by the tracker. The ack token is transmitted in every uplink message, and it is updated when the tracker receives a LoRa message. This way, each time the server receives a LoRa uplink, it knows whether the previous message has been received. The ack token is four bits long. Its value ranges from 0 to 15(0x0F). Notes 1. The ack token value should be updated for each downlink to be used by the application. 2. Its up to the application to process or not the ack tokens. 3. Its up to the application to manage the confirmations. It can either wait for the matching ack token in the uplink message before sending another downlink or send multiple downlink and later waits for the acks. Page 11 of 17 11 October 2018 Company Confidential restricted distribution Micro Tracker User Guide FW1.6 V1.1 7.2 Mode Configuration The operating mode can be remotely configured with a downlink LoRa message built as follow:
Byte 0 0x02 Byte 1 ACK Byte 2 Mode ACK: Ack token. Refer to the associated section. Mode: operating modes. Acceptable values are:
0- Standby 1- Motion tracking 2- Permanent tracking 3- Motion start/end tracking 4- Activity tracking 5- OFF Example:
Changing the operating mode to motion tracking (01) with an ack token of 3: 0x020301. 7.3 Position on demand Whatever the state, a position can be requested from the tracker by the message:
Byte 0 0x01 Byte 1 ACK Example:
Position on demand message with ack token of 2: 0x0102. 7.4 Parameters configuration Any parameter can be remotely modified with a downlink LoRa message. Such messages are built according to the following format:
Byte 0 0x0B Byte 1 Byte 2 Byte 3-6 ACK Parameter ID New value [31-00]
Page 12 of 17 11 October 2018 Company Confidential restricted distribution The parameters identifier and the values are given in the following table Parameter ID Unit Range Description Micro Tracker User Guide FW1.6 V1.1 Position period ul_period 0x00 second 60 - 86400 Period of position or activity messages in motion tracking, start end tracking, activity mode or permanent operating mode heartbeat period lora_period 0x01 second 300 - 86400 Period of heartbeat messages (sent only in idle state) Periodic position report period *
periodic_pos_period 0x03 second 0, 900 - 604800 Geolocation sensor profile Geoloc_sensor 0x05 none 0 - 9 Oneshot geolocation method Geoloc_method 0x06 none 0-4 Period of the periodic position report. When 0, no periodic position report is transmitted. Geolocation policy used in motion, start end or permanent tracking operating mode 0- Wi-Fi only 1- GPS only 2- LP-GPS (AGPS/GPS) 3- Reserved (do not use) 4- Reserved (do not use) 5- Multimode (Wi-Fi + LP-GPS + GPS) (with reset to Wi-Fi on timeout) 6-Wi-Fi-GPS only (Wi-Fi then GPS if Wi-Fi fails in one geolocation cycle) 7- Wi-Fi-LPGPS only (Wi-Fi then LP-GPS if Wi-Fi fails in one geolocation cycle) 8- Reserved (do not use) 9- Wi-Fi-LPGPS first, the Wi-Fi-GPS until timeout, then back to Wi-Fi-LGPS Geolocation policy used for periodic or on demand positions:
0- WI-FI 1- GPS 2- XGPS (Low power GPS/GPS) 3- Wi-Fi-GPS only (Wi-Fi then GPS if Wi-Fi fails in one geolocation cycle) 4- Wi-Fi-LPGPS only (Wi-Fi then LP-GPS if Wi-Fi fails in one geolocation cycle) Page 13 of 17 11 October 2018 Company Confidential restricted distribution Example:
To modify the heartbeat period to 1 hour, the command 0x0B020100000E10 should be sent. Description:
Micro Tracker User Guide FW1.6 V1.1
(0x0B) : set the parameter.
(0x02) : with an ack token of 2
(0x01) : heartbeat message period.
(0x 00 00 0E 10) : to a value of 3600s = 1 hour. It is possible to modify two parameters in the same message by using the following format:
Byte 0 0x0B Byte 1 ACK Parameter 1 Parameter 2 Byte 2 Byte 3-6 Byte 2 Byte 3-6 ID New value1 [31-00]
ID New value2 [31-00]
Page 14 of 17 11 October 2018 Company Confidential restricted distribution Micro Tracker User Guide FW1.6 V1.1 8 Specifications 8.1 Physical configuration Size Weight Waterproof capability Operating temperature Storage temperature Humidity Time storage max Power supply 59mm x 34 mm x13 mm (L x l x h) 21g IP64 0C to 45 C (Charge)
-10C to 55 C (Operation) 10C to 30 C (recommended) 5% to 95% non-condensing 6 months 5v (using micro USB connector)
(1) In static, 5 satellites or more at -130 dBm 8.2 Estimated lifetime Use Case Standby mode Battery Life (Approx.) 10 months at 20C Movement detection (120 positions per day)
>10 days (3)
(3) Using WIFI modes 8.3 Data communication support LoRa Modem Protocol Frequencies bands Configuration supported RF power Min sensitivity of LoRa receiver WiFi Frequency band WiFi sniffer max emission BLE sensitivity BLE RF output power BLE frequency band GNSS band Semtech transceiver SX1272 LoRaWAN v1.0.2 Class A EU 868MHz ISM band US 902-928MHz OTA or ABP 14 dBm (EU) 16.5 dBm (max)
-130 dBm in SF10 2412 2472MHz 3 dBm
-88 dBm 4 dBm max 2402 2480MHz 1559 1610MHz Page 15 of 17 11 October 2018 Company Confidential restricted distribution 8.4 Position accuracy GPS Position Accuracy (50%-90%) (2) Time to have a position (2) Low power GPS Wi-Fi Acquisition sensitivity Position Accuracy (50%-90%) (2) Time to have a position (2) Acquisition sensitivity Indoor Position accuracy Time to have a position
(2) In static, >5 satellites at -130 dBm 8.5 Power management Micro Tracker User Guide FW1.6 V1.1 50-210 seconds 15 seconds 10 to 20 meters Cold start Hot start
-140 dBm 15 - 30 meters 10 - 30 seconds
-160 dBm 20 - 50 meters 3 seconds Rechargeable Battery Battery type Charger supply Power consumption 0.45 Ah 3.7V Lithium Polymer 5V from a standard micro USB charger Stand-by: 0,01mA/h GPS tracking in cold start(1): 1,5mAh (per position) Low power GPS tracking(1): 0,3mAh (per position) WiFi tracking: 0,1mAh (per position)
(1) In static, 6 satellites or more at -130 dBm 9 Instructions / Warnings This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. Any changes or modifications to this equipment not expressly approved by ABEEWAY may cause, harmful interference and void the FCC authorization to operate this equipment. This portable equipment with its antenna complies with FCCs radiation exposure limits set forth for an uncontrolled environment. To maintain compliance, follow the instructions below :
1. This transmitter must not be co-located or operating in conjunction with any other antenna or transmitter. 2. Avoid direct contact to the antenna, or keep contact to a minimum while using this equipment. Page 16 of 17 11 October 2018 Company Confidential restricted distribution Micro Tracker User Guide FW1.6 V1.1 This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:
Reorient or relocate the receiving antenna. Increase the separation between the equipment and receiver. Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. Consult the dealer or an experienced radio/TV technician for help 10 Products References Product definition MICRO TRACKER WHITE EU868 (option small packing box) MICRO TRACKER WHITE US915 (option small packing box) MICRO TRACKER WHITE US915 (option retail packing box) Minor version updates are defined by suffix xxx SKU DEABE003-xxxEU DEABE001-xxxUS DEABE004-xxxUS Page 17 of 17 11 October 2018 Company Confidential restricted distribution