Skip to content

Flashing

Artifacts

From Yocto deploy/: image-<machine>-v<version>-<kind>.tar.gz

Kind Board Operator action
emmc r30 USB with kaonic-flash
sdcard-usb r24 USB with kaonic-flash
sdcard-raw r24 Unpack .raw, write to the microSD card

Each bundle has manifest.toml (machine, SoC, version, payload). Verify the accompanying .sha256 before use. Match the image machine name to the board revision.

Watch: flashing the OS image

This video shows writing a Kaonic OS image onto a Kaonic 1S board. Use it together with the USB steps below.

Download the flashing video

USB procedure (CLI)

Host Linux: install kaonic-flash/50-kaonic-dfu.rules. ModemManager fights STM32 DFU — the rule suppresses it. Windows: WinUSB/Zadig; shipped INF is unsigned.

  1. Identify r24 vs r30 with your eyes.
  2. Open the matching bundle.
  3. Set BOOT SEL to USB ROM (straps).
  4. Power-cycle.
  5. kaonic-flash flash FlashLayout_*.tsv --wipe or use the GUI.
  6. --wipe zeros U-Boot environment so partition defaults rebuild.
  7. Restore normal straps, power-cycle again.

Flashing erases the selected SD/eMMC. r24: remove unrelated cards.

Raw SD (r24 only)

Use this path when you have a .raw Kaonic OS image and a card reader. r30 boots from onboard eMMC and is programmed over USB, not by writing a card.

What you need

  • microSD card, 32 GB or larger recommended
  • microSD card reader
  • Computer (Windows, macOS, or Linux)
  • Kaonic OS image (.raw). If Beechat sent a .gz or .zip, extract it first.
  • A flashing tool. balenaEtcher is the usual choice; dd is equivalent on Linux.

The card is erased completely. Back up anything on it first.

Write the card

  1. Download the image Beechat provided for this board.
  2. If the file is compressed (.gz or .zip), extract it until you have the .raw file.
  3. Insert the microSD card into the computer with a reader.
  4. Open balenaEtcher (or your chosen tool).
  5. Flash from file and select the .raw image.
  6. Select target and choose that microSD card. Confirm the size so you do not overwrite another drive.
  7. Flash. Wait until the tool reports that the write finished and was validated.

Boot from the card

  1. Remove the card from the reader and insert it fully into the Kaonic r24 slot.
  2. Set BOOT SEL to normal for r24 (straps).
  3. Power on. The board boots into Kaonic OS from the card.

Then continue with first boot.