~~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]]
- 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.
The ''%%--write%%'' option writes to device flash storage.
Use ''%%--list%%'' first when writing Android or Ubuntu images.
===== 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