Skip to content
No description, website, or topics provided.
C Objective-C Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


This repository is part of the Fieldtracks project, which aims at creating a tracking system to be used in field exercises by relief organizations.


First make sure you are cloning the project including its submodules:

git clone --recursive

You will need to setup ESP-IDF and a toolchain for the ESP32 in order to compile the project. For further instructions look here.

To configure the build run make menuconfig from the project's root directory and change settings under "JellingStone configuration".

Finally run make flash to compile the project and flash it to an attached ESP32. Debug output can be watched with make monitor (or run them together with make flash monitor).

Flashing wifi and mqtt credentials to the ESP32

This will not run automatically during make flash.

  1. Copy nvs_data.csv.example to nvs_data.csv
  2. Edit the credentials
  3. Run make flash_nvs

NOTE: The path to the certificate must be an absolute path IMPORTANT: If the offset of the nvs partition gets updated the offset in the Makefile needs to be updated as well


As of 1.0.0 binary releases are available at Flashing does not require building the software; however, nvs_data.csv must be converted into a working flash partition. Flashing can be done using esptool: --chip esp32 --port /dev/ttyUSB0 --baud 115200 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 40m --flash_size detect 0x1000 bootloader.bin 0x10000 jellingstone.bin 0x8000 partitions.bin

Creating and flashing the NVS partition is done using:: --input nvs_data.csv --output build/nvs.bin --size 2457 write_flash 0x9000 build/nvs.bin


This file is part of JellingStone - (C) The Fieldtracks Project

JellingStone is distributed under the civilian open source license (COSLi).
Military usage is forbidden.

You should have received a copy of COSLi along with JellingStone.
If not, please contact
You can’t perform that action at this time.