Skip to content

nrfconnect/Asset-Tracker-Template

Repository files navigation

Asset Tracker Template

Release Quality Gate Coverage On-commit Nightly PSM Current RAM Usage thingy91x FLASH Usage thingy91x

Overview

The Asset Tracker Template is a modular framework for developing IoT applications on nRF91-based devices. It is built on the nRF Connect SDK and Zephyr RTOS, and provides a modular, event-driven architecture suitable for battery-powered IoT use cases. The framework supports features such as cloud connectivity, location tracking, and sensor data collection.

The system is organized into modules, each responsible for a specific functionality, such as managing network connectivity, handling cloud communication, or collecting environmental data. Modules communicate through zbus channels, ensuring loose coupling and maintainability.

Supported hardware:

If you are new to nRF91 series and cellular IoT, consider taking the Nordic Developer Academy Cellular Fundamentals Course.

nRF Cloud - Asset tracking map view
Thingy:91 X reporting its location to nRF Cloud running the Asset Tracker Template


Get started

To set up your development environment, build the application, flash it to your device, and connect it to nRF Cloud, follow the Getting Started guide.


Documentation

Getting Started Architecture Configuration
Modifying Modules Connecting
Location Services Achieving Low Power Firmware Updates (FOTA)
Testing and CI Setup Tooling and Troubleshooting Known Issues
Release Artifacts Release Notes

System Overview

System overview

Core modules include:

  • Main: Implements the business logic and controls the overall application behavior.
  • Storage: Stores data from enabled modules.
  • Network: Manages LTE connectivity and tracks network status.
  • Cloud: Handles communication with nRF Cloud using CoAP.
  • Location: Provides location services using GNSS, Wi-Fi, and cellular positioning.
  • Button: Reports button press events for user input.
  • FOTA: Manages firmware over-the-air updates.

Thingy:91 X specific modules:

  • Environmental: Collects environmental sensor data (temperature, humidity, pressure).
  • LED: Controls an RGB LED for visual indication.
  • Power: Monitors battery status and provides power management.
  • UART Power Control: UART suspend/resume on VBUS changes.

Key Features

  • State Machine Framework (SMF): Predictable behavior with run-to-completion model
  • Message-Based Communication: Loose coupling via zbus channels
  • Modular Architecture: Separation of concerns with dedicated threads for blocking operations
  • Power Optimization: LTE PSM enabled by default with configurable power-saving features

About

No description, website, or topics provided.

Resources

License

Stars

31 stars

Watchers

5 watching

Forks

Packages

 
 
 

Contributors