Installation

Download the Flasher

Get the latest release from archr-flasher releases.

• Linux: .AppImage (no install) or .deb for Debian/Ubuntu/derivatives
• macOS: .dmg
• Windows: .msi installer

Plug your microSD

8 GB or larger. The Flasher will erase everything on the card before writing, back up anything you need first.

Pick your console

The first screen asks which console you have: R36S Original, R36S Clone or R36S Soysauce. That choice decides which of the two images is downloaded, and it is also the option string the Overlay Generator expects.

Pick the image

Let the Flasher download the latest release, or point it at an .img.gz you already have.

Pick the panel overlay

Generate mipi-panel.dtbo for your board on the Overlay Generator, then select the file here. The Flasher copies it to overlays/mipi-panel.dtbo on the boot partition after writing the image.

You can skip this step, but then the console boots with the panel description that comes in the base device tree, which only works on some boards. A blank or scrambled screen after the boot logo means you need the overlay.

Write

Pick the SD card and click Flash. The Flasher measures the card speed, wipes the card, writes the image, installs the overlay, and (if Verify after writing is on) reads the card back and compares its SHA-256 against the image.

Verification adds a minute or two and is what catches a bad card or a truncated write.

Boot

Insert the SD into the device, power on. First boot does an automatic partition resize and reboots once, total ~30 s. After the second boot you land in EmulationStation.

Download an image

From Arch-R releases grab one of:

• <Ver of="imageBase" />-original.img.gz, for the original boards
• <Ver of="imageBase" />-clone.img.gz, for clone boards

The date in the filename is the release date, so a newer release has a different name.

Decompress

gunzip ArchR-R36S.aarch64-*.img.gz

Identify the SD device

lsblk
# look for your card, usually /dev/sdX or /dev/mmcblkX

Write

sudo dd if=ArchR-R36S.aarch64-*.img of=/dev/sdX bs=4M conv=fsync status=progress
sync

Install the panel overlay

The image ships no panel overlay. Generate mipi-panel.dtbo for your board on the Overlay Generator, then copy it into the boot partition:

sudo mount /dev/sdX1 /mnt
sudo cp mipi-panel.dtbo /mnt/overlays/mipi-panel.dtbo
sudo umount /mnt

The path and filename are fixed: extlinux.conf loads FDTOVERLAYS /overlays/mipi-panel.dtbo and nothing else. A file saved anywhere else is never read.

Boot

Insert and power on. First boot resizes and reboots; second boot reaches ES.

Download the bundle

Grab archr-dtbo-offline.zip (about 100 KB) and extract it anywhere.

Everything it needs travels inside it:

• archr_dtbo.py, the same script the website runs
• archr-bases/, the three base DTBs the generator mirrors from
• fdt/, the device tree library (pure Python, BSD licensed)
• generate.sh (Linux, macOS) and generate.bat (Windows)
• README.txt

Check Python

Python 3.5 or newer is the only requirement. No pip, no network access.

python3 --version   # Linux / macOS
python --version    # Windows

On Windows, install it from python.org and tick Add python.exe to PATH during setup.

Generate the overlay

Open a terminal in the extracted folder and run:

# Linux / macOS
python3 archr_dtbo.py rk3326-r36s-linux.dtb SDORIG -o mipi-panel.dtbo

# Windows
python archr_dtbo.py rk3326-r36s-linux.dtb SDORIG -o mipi-panel.dtbo

First argument: the DTB from your console's original firmware. Second: the option string for your console (see the table below). -o: where the overlay is written; without it the overlay goes to standard output.

The generate.sh and generate.bat wrappers do exactly the same thing. On Linux and macOS the wrapper may need its executable bit back if your unzip tool dropped it: chmod +x generate.sh.

Install the result

Copy the generated file to the ARCHR partition of the card as overlays/mipi-panel.dtbo. That exact folder and filename is what extlinux.conf already points at (FDTOVERLAYS /overlays/mipi-panel.dtbo), so there is nothing else to configure. An overlay saved under a different name, or in a different folder, is simply never loaded and the console still boots to a blank screen.