This page explains how to burn OS images to Khadas Edge series boards from a Linux PC using the rockchip-burn online burn tool.

Supported boards: Edge2 edge-2l

Show detected USB devices

curl dl.khadas.com/online/rockchip-burn | sh -s - --devices

Show resolved target info

curl dl.khadas.com/online/rockchip-burn | sh -s -

The tool can auto-detect supported Edge series boards from USB when possible.

List all normal Android and Ubuntu images

curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 --list

List only Ubuntu images

curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 ubuntu --list

List only Android images

curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 android --list

List available images

curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 --list

Write selected image by index

curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 --write 1

Download selected image only

curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 --dl 1

OOWOW uses a special image source and writes to SPI flash by default.

Write latest OOWOW image

curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 oowow --write

Refresh cache and write latest OOWOW image

curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 oowow --refresh --write

Download latest OOWOW image only

curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 oowow --dl

List available OOWOW images

curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 oowow --list

Write OOWOW image by index

curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 oowow --write 1

List all normal Android and Ubuntu images

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l --list

List only Ubuntu images

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l ubuntu --list

List only Android images

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l android --list

Example output:

Example image list

[1] android-14/edge-2l-android-14-v260428.raw.img.xz
[2] ubuntu-24.04/edge-2l-ubuntu-24.04-server-linux-6.1-fenix-1.7.6-260519.img.xz
[3] ubuntu-24.04/edge-2l-ubuntu-24.04-gnome-linux-6.1-fenix-1.7.6-260519.img.xz

List available images

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l --list

Write selected image by index

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l --write 1

Download selected image only

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l --dl 1

Write Ubuntu image by index

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l ubuntu --write 1

Write Android image by index

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l android --write 1

OOWOW uses a special image source and writes to SPI flash by default.

Write latest OOWOW image

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --write

Refresh cache and write latest OOWOW image

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --refresh --write

Download latest OOWOW image only

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --dl

List available OOWOW images

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --list

Example output:

Example OOWOW image list

[1] edge-2l-oowow-260528.000-spi.img.gz
[2] edge-2l-oowow-260529.000-spi.img.gz

Download OOWOW image by index

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --dl 1

Write OOWOW image by index

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --write 2

When a supported board is connected, the board name can be omitted.

List normal OS images for detected board

curl dl.khadas.com/online/rockchip-burn | sh -s - --list

Restore OOWOW for detected board

curl dl.khadas.com/online/rockchip-burn | sh -s - oowow --write

You can use rockchip-burn online with curl, or download it and run it as a local script.

Download rockchip-burn

wget https://dl.khadas.com/online/rockchip-burn -O rockchip-burn
chmod 0755 rockchip-burn

Install to ~/bin for direct usage:

Install rockchip-burn to user bin

mkdir -p ~/bin
wget https://dl.khadas.com/online/rockchip-burn -O ~/bin/rockchip-burn
chmod 0755 ~/bin/rockchip-burn

Update local script:

Update rockchip-burn

rockchip-burn --update

Show detected USB devices

./rockchip-burn --devices

List Edge-2L images

./rockchip-burn edge-2l --list

Restore latest OOWOW to SPI flash

./rockchip-burn edge-2l oowow --write

Write selected OS image by index

./rockchip-burn edge-2l --write 1

After installing to ~/bin, use it directly:

Use installed rockchip-burn

rockchip-burn --devices
rockchip-burn edge-2l --list
rockchip-burn edge-2l oowow --write

Show help

rockchip-burn --help

Show online help

curl dl.khadas.com/online/rockchip-burn | sh -s - --help

If only an image filename is provided, the tool resolves the correct download path using the online catalog.

Write Ubuntu image by filename

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l-ubuntu-24.04-server-linux-6.1-fenix-1.7.6-260519.img.xz --write

Write Android image by filename

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l-android-14-v260428.raw.img.xz --write

Write OOWOW image by filename

curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l-oowow-260529.000-spi.img.gz --write

A full URL is used directly and does not need catalog lookup.

Write Android image from full URL

rockchip-burn https://dl.khadas.com/.images/edge-2l/android-14/edge-2l-android-14-v260428.raw.img.xz --write

Write OOWOW image from full URL

rockchip-burn https://dl.khadas.com/products/oowow/system/versions/edge-2l/edge-2l-oowow-260529.000-spi.img.gz --write

A local existing file is used directly.

Write local Ubuntu image

rockchip-burn ./edge-2l-ubuntu-24.04-server-linux-6.1-fenix-1.7.6-260519.img.xz --write

Write local OOWOW image

rockchip-burn ./edge-2l-oowow-260529.000-spi.img.gz --write

The tool is designed for Linux PC host systems.

Required tools:

• curl or wget
• xz or pixz
• gzip or pigz
• tar
• md5sum
• grep, sed, awk, sort
• basename, dirname, realpath
• sudo

On Ubuntu or Debian based systems:

Install dependencies

sudo apt update
sudo apt install curl wget xz-utils pixz gzip pigz tar coreutils sed gawk grep sudo

The Rockchip upgrade_tool, board loader, and downloaded images are cached in:

Cache directory

~/upgrade_tool/

• --write is required for writing flash storage.
• --dl downloads only and does not write to the device.
• --list lists images with index numbers.
• The image index from --list can be used anywhere in the command line.
• oowow is an exclusive mode and uses the OOWOW image source.
• OOWOW images normally target SPI flash.
• Android and Ubuntu images use the normal board image catalog.
• Normal image filenames are resolved through the catalog, including subdirectories such as android-14/ or ubuntu-24.04/.
• Local file paths and full URLs are used directly.
• Bare image filenames are resolved through the correct online catalog.

• --devices — show detected USB devices
• --list — list available images
• --dl — download image only
• --refresh — refresh cached download or cached list
• --no-reset — do not reset the device after writing
• --spi — force SPI target
• --sd — force eMMC/SD target

• Linux host systems only.
• x86_64 / amd64 host architecture only.
• Tested on Ubuntu.
• Requires USB Burn mode for writing.

• https://github.com/hyphop/rockchip-burn
• https://github.com/hyphop/rockchip-burn/blob/main/rockchip-burn
• http://dl.khadas.com/online/rockchip-burn
• http://dl.khadas.com/online/rockchip-burn.readme.md