Skip to main content
Version: AT3 v1.3

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 the following tracker models

Definitions, Acronyms and Abbreviations

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

AcronymDescription
AOS-SDKAbeeway Operating system, Software Development Kit
AT3Assert-tracker 3, the application layer of Abeeway trackers
BLEBluetooth Low Energy
CLICommand Line Interface
FID32-bit parameter Full Identifier
FQDNFully Qualified Domain Name
LID16-bit parameter Local Identifier
LoRaThe LoRa RF physical layer, a Semtech technology
LoRaWANThe protocol defined by the LoRa Alliance
RFUReserved 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).