Abeeway trackers reference guide overview

This document details the Asset Tracker 3 (AT3) application firmware v1.3, covering:

• Application design

• Tracker dynamic behavior

• Configuration and user interface

• Applicative payloads

Applicable Products

The AT3 firmware is applicable only to AT3 compliant tracker models

Definitions, Acronyms and Abbreviations

The terms Software and Firmware are used interchangeably in this document.

Acronym	Description
AOS-SDK	Abeeway Operating system, Software Development Kit
AT3	Assert-tracker 3, the application layer of Abeeway trackers
BLE	Bluetooth Low Energy
CLI	Command Line Interface
FID	32-bit parameter Full Identifier
FQDN	Fully Qualified Domain Name
LID	16-bit parameter Local Identifier
LoRa	The LoRa RF physical layer, a Semtech technology
LoRaWAN	The protocol defined by the LoRa Alliance
RFU	Reserved for Future Use

Content

Here is the outline of the remaining parts of the document.

• Functioning provides an overview of the firmware's core features.

• Release Notes highlights the new features of each release and lists the known-issues.

• Application Design presents the high level design principles of the firmware.

• Event Manager details the events handled by the firmware and their specific roles.

• Geolocation Manager explains the multi-technology geolocation engine and how it triggers location fixes.

• GNSS Manager covers the GNSS subsystem along with almanac management.

• Networking explains the management of LPWAN connectivity (LTE-M, NB-IoT and LoRaWAN).

• Payload Manager introduces the management of uplinks (segmentation, buffering).

• Application Uplinks explains the structure and payload formats of uplink messages (uplink requests, unsollicited frames and responses to commands).

• Uplink Data Buffering explains how to recover lost frames from the device uplink frame buffer.

• Application Downlinks explains the structure and payload formats of downlink messages (commands and responses to uplink requests)

• Device and Power Monitoring describes the device temperature and power monitoring functionality.

• User Interface details the button and LED patterns.

• Configuration is the reference for all configuration parameters.

• BLE scan introduces the Bluetooth scanning functionality.

• System Time Update discusses the approach to managing system time in the firmware.

• Firmware Update introduces the firmware types and the various ways to upgrade them (USB, BLE, Over-the-air).