Skip to content

release.md

Latest commit

 

History

History
78 lines (53 loc) · 5.49 KB

release.md

File metadata and controls

78 lines (53 loc) · 5.49 KB
Raw

Release artifacts

This document provides a comprehensive overview of all firmware deliverables and artifacts generated by the Asset Tracker Template. Each firmware variant is optimized for specific use cases and hardware platforms.

Downloading releases

Pre-built firmware binaries and release notes are published on the project's GitHub releases page:

https://github.com/nrfconnect/Asset-Tracker-Template/releases

Pick the firmware that matches your hardware platform and desired configuration from the tables below, download it from the release page, and flash it to your device with west or nrfutil.

Firmware deliverables

The Asset Tracker Template generates multiple firmware artifacts for different hardware platforms and configurations. Each artifact is built to serve specific development, testing, or production needs.

Primary release artifacts

Each firmware variant includes the following set of artifacts:

Artifact suffix Description Use case
-nrf91.hex Full merged image (b0, MCUboot, signed application, provisioning data). Same contents as build/merged.hex from a local sysbuild. Programming the entire internal flash with a J-Link debugger
-nrf91.elf ELF file with debug symbols Debugging, coredump analysis, addr2line
-nrf91.config Build configuration snapshot Inspecting the Kconfig options used for the build
-nrf91-update-signed.hex Signed application-only hex (no bootloader) Updating only the application slot with a debugger
-nrf91-update-signed.bin Signed application-only binary FOTA updates using nRF Cloud
-nrf91-dfu.zip DFU package Serial DFU updates over USB (no debugger)

Standard firmware variants

Artifact name Hardware platform Description Use case
asset-tracker-template-{VERSION}-thingy91x-nrf91.* Thingy:91 X (nRF9151) Standard production firmware with all core features enabled, including Memfault coredump capture and fleet metrics via nRF Cloud CoAP Production deployment on Thingy:91 X devices
asset-tracker-template-{VERSION}-nrf9151dk-nrf91.* nRF9151 DK Development kit firmware with the same feature set as the Thingy:91 X standard build Development and testing on nRF9151 DK

Debug variant

The debug artifact is the standard Thingy:91 X firmware with the modem-trace-to-Memfault overlay applied at build time. Memfault is already enabled in the standard build; the debug variant adds continuous modem trace capture to external flash and uploads those traces together with the coredump when the application crashes. This is not the same as the -mtrace- variants, which stream modem trace live over UART 1 for bench-side analysis.

Artifact name Hardware platform Description Use case
asset-tracker-template-{VERSION}-debug-thingy91x-nrf91.* Thingy:91 X (nRF9151) Standard firmware plus modem trace capture to external flash (~1 MB) and upload to Memfault on crash Investigating crashes in deployed devices where cellular context around the failure is needed

Specialized configuration variants

Artifact name Hardware platform Description Use case
asset-tracker-template-{VERSION}-mtrace-thingy91x-nrf91.* Thingy:91 X (nRF9151) Firmware with modem trace output enabled through UART 1 Cellular connectivity debugging and analysis
asset-tracker-template-{VERSION}-mtrace-nrf9151dk-nrf91.* nRF9151 DK Firmware with modem trace output enabled through UART 1 Cellular connectivity debugging and analysis
asset-tracker-template-{VERSION}-ext-gnss-nrf9151dk-nrf91.* nRF9151 DK Firmware configured for external GNSS antenna Testing with external GNSS antenna setup
asset-tracker-template-{VERSION}-buffer-flash-thingy91x-nrf91.* Thingy:91 X (nRF9151) LittleFS storage backend with buffered sampling Testing persistent flash buffering

Configuration overlays

The firmware variants are built using different configuration overlays that modify the base functionality:

Overlay file Purpose Key features
overlay-storage-minimal.conf Minimal storage configuration Reduced memory footprint with storage for one sample and immediate sending
overlay-modem-trace-over-uart.conf / overlay-modem-trace-shmem.overlay Modem tracing over UART1 UART trace backend (Kconfig) and 16 KiB cpucell_cpuapp_ipc_shm_trace in SRAM
overlay-upload-modem-traces-to-memfault.conf / overlay-upload-modem-traces-to-memfault.overlay Modem trace to Memfault Memfault modem trace upload, on-flash trace partition, and trace shmem (mutually exclusive with UART overlay)

Hardware platform support

Thingy:91 X (Primary platform)

  • SoC: nRF9151
  • Features: Full sensor suite, battery operation, compact form factor
  • Target Use: Production IoT deployments, prototyping
  • Memory Reports: ROM and RAM usage reports generated for optimization

nRF9151 DK

  • SoC: nRF9151
  • Features: On-board debugger (J-Link), external antenna connectors, and Arduino-compatible headers
  • Target Use: Development, testing, and prototyping