Skip to main content

Firmware Update

The Landmark Precision Landing System firmware is stored on the microSD card inside the module. Firmware updates are installed by writing the latest Landmark system image to the microSD card.

Landmark module microSD card slot

MicroSD card slot on the Landmark module.

Check Firmware Version​

Firmware v1.1.0 and later reports the firmware version at startup.

If no firmware version is reported at startup, the module is likely running firmware v1.0.0. Landmark modules purchased before June 4, 2026 shipped with firmware v1.0.0.

Update Procedure​

Landing target configuration changes in firmware v1.1.0

When upgrading from firmware v1.0.0 to v1.1.0 or later, the landing targets enabled by default change from A4 Max and Fibonacci to Bullseye.

On firmware v1.1.0 and later, A4 Max and Fibonacci require configuration. They use a different marker family from Bullseye, so do not enable them alongside Bullseye.

Before flying, either use the Bullseye target or configure the landing targets you intend to use.

  1. Remove the microSD card from the Landmark module and insert it into a computer. A volume named bootfs should automatically mount.

    Back up files before updating

    Writing the firmware image will erase the entire microSD card. Back up the license file, custom landing target files, and any user configuration before continuing.

  2. Copy the applicable files from the microSD card to your computer:

    • License file
      • Firmware v1.1.0 and later: bootfs/landmark/license.json
      • Firmware v1.0.0: bootfs/landmark_license.json
    • Custom landing target files, if applicable
      • Firmware v1.1.0 and later: custom JSON files in bootfs/landmark/landing-targets/
      • Firmware v1.0.0: custom JSON files in bootfs/marker_layouts/
    • User configuration, if you changed any settings
      • Firmware v1.1.0 and later: bootfs/landmark/config.toml

  3. Download the latest Landmark firmware image from GitHub Releases.

  4. Write the firmware to the microSD card using Raspberry Pi Imager:

    Raspberry Pi Imager v2 instructions
    1. In Raspberry Pi Imager, click OS, scroll down, then click Use custom.
      Select the downloaded Landmark firmware image and click NEXT.
      RPi Imager OS
    2. Select the Landmark microSD card and click NEXT.
      RPi Imager Storage
    3. Click WRITE. Then I UNDERSTAND, ERASE AND WRITE.
      RPi Imager Writing RPi Imager Writing Confirmation
    4. When the image has been written, click FINISH.
      RPi Imager Done
    Raspberry Pi Imager v1 instructions
    1. In Raspberry Pi Imager, click CHOOSE OS, then click Use custom.
      RPi Imager CHOOSE OS RPi Imager Use custom
    2. Select the downloaded Landmark firmware image.
    3. Click CHOOSE STORAGE and select the Landmark microSD card.
      RPi Imager CHOOSE STORAGE
    4. Click NEXT, then click NO when asked about applying OS customization settings.
      RPi Imager NEXT RPi Imager NO
    5. Click YES to write the firmware image to the microSD card.
      RPi Imager YES
    6. When the image has been written, click CONTINUE.
      RPi Imager CONTINUE

  5. Remove and re-insert the microSD card into your computer.
    The card is automatically ejected after writing, so it must be remounted before restoring the backed-up files.

  6. Copy the license file to bootfs/landmark/license.json.
    If upgrading from firmware v1.0.0, rename landmark_license.json to license.json.

  7. Copy any custom landing target JSON files to bootfs/landmark/landing-targets/.

  8. Restore any user configuration:

    • When upgrading from firmware v1.1.0 or later, reapply your custom settings to the new config.toml. Do not replace the new file with the backed-up version, because available settings and defaults may have changed.
    • When upgrading from firmware v1.0.0, configure each custom landing target in config.toml.

  9. Eject the microSD card and insert it back into the Landmark module.

The firmware update is complete.