Skip to content

Home

Jump to bottom
Geoffrey Fournier edited this page Mar 12, 2026 · 13 revisions

LinKit v4 Core - Firmware Documentation

LinKit v4 Core is a multi-sensor wildlife tracker firmware running on nRF52840 (Nordic Semiconductor). It supports Argos satellite communication (KIM/SMD modules) and LoRaWAN (RAK3172-SiP) for tracking birds and marine animals with configurable sensors, underwater detection, geofencing zones, and low-battery management.

Features

  • GNSS - u-blox M10Q GPS with AssistNow Online/Offline, configurable dynamic models, HDOP/HACC filtering
  • Argos Satellite TX/RX - Pass prediction, legacy, duty cycle, and Doppler modes. Supports KIM2 (CLS) and SMD (Arribada, A+ protocol) modules
  • LoRaWAN - RAK3172-SiP module (Semtech SX1262), OTAA/ABP, EU868 (+ other bands), Class A/B/C
  • Pressure Sensor - LPS28DFW barometric pressure with altitude computation and configurable full scale (1260/4060 hPa)
  • Accelerometer - BMA400 3-axis with wakeup detection, activity monitoring, configurable measurement range
  • Thermistor - NTC temperature sensor with wakeup threshold
  • Underwater Detection - Saltwater switch (analog with auto-calibration, 5-level detection), pressure-based, GNSS-based
  • Geofencing Zones - Circular zone with out-of-zone detection and alternate Argos configuration
  • Low Battery Management - Configurable threshold with alternate GNSS/Argos parameters and critical shutdown
  • Camera - Optional camera trigger on surfaced/accelerometer wakeup events
  • Dive Mode - Dive state machine with reed switch pause/resume
  • 196+ Configurable Parameters - Read/write via DTE commands over USB/BLE/UART
  • Sensor Data Logging - Per-sensor CSV-formatted flash logs with DUMPD retrieval
  • Sensor Data in TX - Configurable sensor data aggregation (oneshot/mean/median) appended to Argos/LoRa packets

Supported Boards

Board Communication Description
LinkIt V4 KIM Argos (KIM2, UART) Default Argos tracker with CLS module
LinkIt V4 SMD Argos (SMD, SPI) Arribada SMD module with A+ protocol and security
LinkIt V4 LoRa LoRaWAN (RAK3172) Terrestrial LPWAN for gateway-covered areas
RSPB Tracker Argos (SMD, SPI) Bird tracker with TPL5111 duty cycle wakeup

See dedicated board documentation:

Hardware

  • MCU: nRF52840 (ARM Cortex-M4F, 1MB Flash, 256KB RAM)
  • SoftDevice: S140 v7.2.0 (BLE 5.0)
  • GPS: u-blox M10Q (UART)
  • Build System: CMake + ARM GCC Toolchain
  • Test Framework: CppUTest

Wiki Structure

  1. Quick Start Guide - Get up and running
  2. Building the Project - CMake configuration and build options
  3. Programming the Module - Flashing, debugging, DFU
  4. DTE Commands Reference - DTE protocol and commands
  5. Firmware Architecture - Code structure and design patterns
  6. Development Guide - Adding parameters, services, sensors

Clone this wiki locally