Abeeway Trackers User Guide Supporting: Micro Tracker, Smart Badge, Compact Tracker, and Industrial Tracker Firmware V2.1 ABEEWAY SAS contact@abeeway.com www.abeeway.
Abeeway Tracker Reference Guide FW 2.1 V1.1 Table of contents 1 INTRODUCTION ____________________________________________________________________________________________________________ 3 1.1 Document purpose ....................................................................................................................................................... 3 1.2 Products description........................................................................................................................
Abeeway Tracker Reference Guide FW 2.1 V1.1 1 INTRODUCTION 1.1 Document purpose This document describes in detail the usage of Asset tracker MCU application Firmware 2.x that runs on Abeeway trackers: Micro tracker, Compact tracker, Industrial tracker and Smart badge. Chapters 2, 3 and 4 are related to the main functionalities of the device, and chapter 5 discusses the geolocation strategies. The next chapters 6 and 7 give more details for Uplink and Downlink messages.
Abeeway Tracker Reference Guide FW 2.1 V1.1 1.3.2 Smart badge ➢ ➢ ➢ ➢ ➢ Personal multi-mode tracking: employees, workers, visitors SOS panic alarm for indoor and outdoor lone workers Safety evacuation monitoring Location heatmaps, e.g. for optimization of supervisor/worker ratio in large construction or industrial sites Contact back-tracking, proximity detection for sanitary policy enforcement. 1.3.
Abeeway Tracker Reference Guide FW 2.1 V1.1 2 FEATURES ➢ Multiple operating modes ✓ Standby: LoRaWAN™ heartbeat only ✓ 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.
Abeeway Tracker Reference Guide FW 2.1 V1.
Abeeway Tracker Reference Guide FW 2.1 V1.1 ➢ Your LoRaWAN™ network provider can use two activation modes1: ✓ OTAA (Over The Air Activation): This mode requires the following keys to join the network: DEVEUI, APPEUI and APPKEY for each device.
Abeeway Tracker Reference Guide FW 2.1 V1.1 3.2.2 Tracker best placement The device can be attached with the provided lanyard or placed in a bag, or inside an asset. It is recommended to place the tracker in a way that LoRaWAN/GPS antenna is pointing towards the sky for best LoRaWAN/GPS coverage. Note The close 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 fields. 3.
Abeeway Tracker Reference Guide FW 2.1 V1.1 3.4 Compact tracker and Industrial tracker device Compact Tracker Industrial Tracker 3.4.1 Getting started The compact tracker is shipped to the customer in “shipping” state to preserve battery lifetime. It can be brought back into “JOIN” state by bringing the magnet close to the tracker for at least 5 seconds. The tracker will then start the JOIN procedure which can be seen in LoRaWAN Network Server logs.
Abeeway Tracker Reference Guide FW 2.1 V1.1 4 FUNCTIONING 4.1 Startup process This new firmware version significantly modifies the startup process of Abeeway devices. A process called shipping has been introduced to allow the shipping of the trackers to the final customer. This process put the tracker in a deep low power state. Once the tracker arrives on the final customer site, it leaves the shipping state and starts the LoRaWANTM join process.
Abeeway Tracker Reference Guide FW 2.1 V1.1 4.2.1 Overview The tracker supports up to six different operational modes: Off, Standby, Motion tracking, Permanent tracking, Start/End tracking and Activity tracking. The mode is configurable using configurations parameters 4.2.2 OFF mode The tracker is in deep low power mode. No LoRaWAN™ uplinks are sent. A long button press is required to wake up the device.
Abeeway Tracker Reference Guide FW 2.1 V1.1 4.3 Side operations Whatever the operating mode (except OFF mode), the trackers support side operations in the table below: Side operations Trackers User interface needed Periodic positions reporting All Positions on demand All Alert position Smart Badge, Micro and button or reed switch acting like a button compact tracker Periodic activity reporting All Collection payloads All Proximity detection Smart Badge, and Micro Button tracker 4.
Abeeway Tracker Reference Guide FW 2.1 V1.1 4.5.2 Motion sensitivity The accelerometer sensitivity can be fine-tuned by configuration via the parameter motion_sensitivity as follows: ➢ The zero value is used for the default sensitivity: ➢ The range [1 .. 100] gives the sensitivity (in percentage). 4.5.3 Motion duration The end of a motion is triggered by the absence of movement using a configuration parameter called motion_duration. This parameter is expressed in seconds and ranges from [60 .. 3600].
Abeeway Tracker Reference Guide FW 2.1 V1.1 4.7.3 Shock detection message Upon the detection of a shock event, the tracker triggers a LoRaWANTM message as follows: The first message is sent immediately with the actual acceleration values. The next ones are delayed by two minutes. In this case the reported value will be the highest shock that occurred during this fixed period. If no shock is detected during the two minutes period, no more payload is sent. 4.
Abeeway Tracker Reference Guide FW 2.1 V1.1 The battery level monitoring is done as follows: ➢ Every 5 minutes ➢ On a single button short press When the battery level goes to 1%, the device sends a shutdown message with the reason low battery then moves to the OFF mode (no more LoRaWANTM payloads are sent). The tracker remains in this state until the battery is recharged and restarted with a long button press. Before moving to the OFF state, a low battery melody is played.
Abeeway Tracker Reference Guide FW 2.1 V1.1 Sequence One short press Three short presses Double short press Any press when battery low (short or long press) (1) One long press when device OFF and good battery One long press when device ON.
Abeeway Tracker Reference Guide FW 2.1 V1.1 Alarm or Warning is triggered (2) Permanent short blinks Red 4.11.3 Buzzer melodies The second interface from the tracker to the user is done via a buzzer. The volume can be managed using buzzer_volume parameter.
Abeeway Tracker Reference Guide FW 2.1 V1.1 5 GEOLOCATION STRATEGY MODES All geolocation strategies are supported by Abeeway trackers 5.1 Main operating modes and SOS mode The following geolocation technology settings (geoloc_sensor parameter) are used by the main operating modes: motion-tracking, permanent-tracking, start/end tracking and SOS. Note that in standby mode, only side operations can report positions. ➢ WIFI only → Only WIFI scans are used for position determination.
Abeeway Tracker Reference Guide FW 2.1 V1.1 6 UPLINK MESSAGES This section describes the payload messages supported by the tracker. Unless otherwise specified, all values are transmitted in network byte order (MSB first). Each message is composed of two parts: ➢ A common header ➢ A specific data parts The LoraWANTM port used for the uplinks is the 18.
Abeeway Tracker Reference Guide FW 2.1 V1.
Abeeway Tracker Reference Guide FW 2.1 V1.1 the device. To ensure optimum performance and long battery lifetime, keep the device between -10°C to 60°C. The tracker should be charged with an adequate DC 5V – 500mA USB charge power adapter. For the micro tracker, a standard USB cable with micro USB connecter is required. The smart badge requires a specific USB cable with magnetic 4-pin connector provided by Abeeway or can be charged with the smart badge docking station.
Abeeway Tracker Reference Guide FW 2.1 V1.1 10 CERTIFICATION AND REGULATORY 10.1 Radio certification CE This device may be operated in all member states of the EU with a LoRa network. The CE mark is affixed to this product. The Smart Badge Type E310 are in compliance with all the relevant provisions of Directive 2014/53/UE. FCC Warning: Changes or modifications to this unit not expressly approved by the party responsible for compliance could void the user’s authority to operate the equipment.
Abeeway Tracker Reference Guide FW 2.1 V1.1 accordance to 2014/34/EU (ATEX) standard The EC-Type Examination Certificate: SGS20ATEX0150X Ex-Marking: II 3G Ex ic IIB T4 Gc Ta -20 °C ... +40 °C II 3D Ex ic IIIB T135°C Dc Ta -20 °C ... +40 °C Approved for zone 2 device group II, explosion group IIB (explosive gases, vapors or mist), temperature class T4. Approved for zone 22, device group II, explosion group IIIB (combustible flying, non-conductive dust and conductive dust), maximum Temperature 135°C. 10.