Khadas Docs

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
~~tag>edge edge2 edge-2l online burn linux os~~

====== Edge Series Online OS Burn ======

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]]

<WRAP info>
  - Connect the board to your PC using a USB-C cable.
  - Activate USB Burn mode by quickly pressing the **KEY_FUN** button three times.
  - Run the commands below from your PC's Linux terminal.
</WRAP>

<WRAP important>
The ''%%--write%%'' option writes to device flash storage.  
Use ''%%--list%%'' first when writing Android or Ubuntu images.
</WRAP>

===== Check connected device =====

```sh Show detected USB devices
curl dl.khadas.com/online/rockchip-burn | sh -s - --devices
```

```sh 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.

====== Edge2 online burn ======

===== List available OS images =====

```sh List all normal Android and Ubuntu images
curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 --list
```

```sh List only Ubuntu images
curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 ubuntu --list
```

```sh List only Android images
curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 android --list
```

===== Write OS image to eMMC =====

```sh List available images
curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 --list
```

```sh Write selected image by index
curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 --write 1
```

```sh Download selected image only
curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 --dl 1
```

===== Edge2 Restore OOWOW firmware =====

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

```sh Write latest OOWOW image
curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 oowow --write
```

```sh Refresh cache and write latest OOWOW image
curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 oowow --refresh --write
```

```sh Download latest OOWOW image only
curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 oowow --dl
```

```sh List available OOWOW images
curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 oowow --list
```

```sh Write OOWOW image by index
curl dl.khadas.com/online/rockchip-burn | sh -s - edge2 oowow --write 1
```

====== Edge-2L online burn ======

===== List available OS images =====

```sh List all normal Android and Ubuntu images
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l --list
```

```sh List only Ubuntu images
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l ubuntu --list
```

```sh List only Android images
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l android --list
```

Example output:

```text 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
```

===== Write OS image to eMMC =====

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

```sh Write selected image by index
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l --write 1
```

```sh Download selected image only
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l --dl 1
```

```sh Write Ubuntu image by index
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l ubuntu --write 1
```

```sh Write Android image by index
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l android --write 1
```

===== Edge-2L Restore OOWOW firmware =====

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

```sh Write latest OOWOW image
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --write
```

```sh Refresh cache and write latest OOWOW image
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --refresh --write
```

```sh Download latest OOWOW image only
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --dl
```

```sh List available OOWOW images
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --list
```

Example output:

```text Example OOWOW image list
[1] edge-2l-oowow-260528.000-spi.img.gz
[2] edge-2l-oowow-260529.000-spi.img.gz
```

```sh Download OOWOW image by index
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --dl 1
```

```sh Write OOWOW image by index
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l oowow --write 2
```

====== Advanced usage ======

===== Auto board detection =====

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

```sh List normal OS images for detected board
curl dl.khadas.com/online/rockchip-burn | sh -s - --list
```

```sh Restore OOWOW for detected board
curl dl.khadas.com/online/rockchip-burn | sh -s - oowow --write
```

===== Local usage =====

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

==== Download and install ====

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

Install to ''%%~/bin%%'' for direct usage:

```sh 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:

```sh Update rockchip-burn
rockchip-burn --update
```

==== Usage ====

```sh Show detected USB devices
./rockchip-burn --devices
```

```sh List Edge-2L images
./rockchip-burn edge-2l --list
```

```sh Restore latest OOWOW to SPI flash
./rockchip-burn edge-2l oowow --write
```

```sh Write selected OS image by index
./rockchip-burn edge-2l --write 1
```

After installing to ''%%~/bin%%'', use it directly:

```sh Use installed rockchip-burn
rockchip-burn --devices
rockchip-burn edge-2l --list
rockchip-burn edge-2l oowow --write
```

==== Help ====

Show help

```sh
rockchip-burn --help
```

Show online help

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

===== Write exact image by filename =====

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

```sh 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
```

```sh Write Android image by filename
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l-android-14-v260428.raw.img.xz --write
```

```sh Write OOWOW image by filename
curl dl.khadas.com/online/rockchip-burn | sh -s - edge-2l-oowow-260529.000-spi.img.gz --write
```

===== Write custom remote image =====

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

```sh 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
```

```sh 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
```

===== Write local image =====

A local existing file is used directly.

```sh Write local Ubuntu image
rockchip-burn ./edge-2l-ubuntu-24.04-server-linux-6.1-fenix-1.7.6-260519.img.xz --write
```

```sh Write local OOWOW image
rockchip-burn ./edge-2l-oowow-260529.000-spi.img.gz --write
```

====== Dependencies ======

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:

```sh 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:

```text Cache directory
~/upgrade_tool/
```

====== Behavior notes ======

  * ''%%--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.

====== Useful options ======

  * ''%%--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

====== Limitations ======

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

====== Sources ======

  * 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
Khadas Docs

User Tools

Site Tools

Page Tools
