Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools

Home / software / tools / rockchip-burn
software:tools:rockchip-burn

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision 		Previous revision
software:tools:rockchip-burn [2026/06/15 02:56]
hyphop created 		software:tools:rockchip-burn [2026/06/15 04:13] (current)
hyphop [Edge2 Restore OOWOW firmware to SPI flash]
Line 1: Line 1:
-====== rockchip-burn ======+~~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
  
Last modified: 2026/06/15 02:56 by hyphop

Page Tools

Khadas Site

Khadas Community

Khadas GitHub

Khadas Downloads