Instalação, Arch R

Você só precisa de um cartão microSD (8 GB ou mais, recomendado 16 GB) e alguns minutos. O caminho recomendado é o ArchR Flasher: ele baixa a variante de imagem correta para a sua placa, instala o overlay de painel que você gerou no site e confere a gravação.

Opção 1: ArchR Flasher (recomendado)

O Flasher é um pequeno aplicativo desktop (Tauri) que baixa a release mais recente, grava o cartão SD, instala o seu overlay de painel e confere a gravação. Disponível para Linux, macOS e Windows.

O overlay não vem mais junto com a imagem. Você o gera uma vez para a sua placa no Gerador de Overlays e entrega o mipi-panel.dtbo resultante ao Flasher.

Baixe o Flasher

Pegue a release mais recente em archr-flasher releases.

Linux: .AppImage (sem instalação) ou .deb para Debian/Ubuntu/derivados
macOS: .dmg
Windows: instalador .msi

Conecte o microSD

8 GB ou mais. O Flasher vai apagar tudo que estiver no cartão antes de gravar. Faça backup do que precisar antes.

Escolha o seu console

A primeira tela pergunta qual console você tem: R36S Original, R36S Clone ou R36S Soysauce. Essa escolha define qual das duas imagens será baixada e é também a option string que o Gerador de Overlays espera.

Escolha a imagem

Deixe o Flasher baixar a release mais recente, ou aponte para um .img.gz que você já tenha.

Escolha o overlay de painel

Gere o mipi-panel.dtbo da sua placa no Gerador de Overlays e selecione o arquivo aqui. O Flasher copia esse arquivo para overlays/mipi-panel.dtbo na partição de boot depois de gravar a imagem.

Dá para pular essa etapa, mas aí o console dá boot com a descrição de painel que vem no device tree base, o que só funciona em algumas placas. Tela preta ou embaralhada depois do logo de boot significa que você precisa do overlay.

Gere o overlay a partir do .dtb do cartão original do seu próprio console. Um .dtb tirado do dArkOS, do ArkOS RE, do ArkOS4Clones ou de qualquer outro sistema descreve outra configuração e não corresponde ao seu hardware.

Grave

Escolha o cartão SD e clique em Flash. O Flasher mede a velocidade do cartão, limpa o SD, grava a imagem, instala o overlay e, se a opção Verify after writing estiver ligada, lê o cartão de volta e compara o SHA-256 com o da imagem.

A verificação leva um ou dois minutos a mais e é o que pega cartão ruim e gravação truncada.

Boot

Insira o SD no aparelho e ligue. O primeiro boot faz um redimensionamento automático da partição e reinicia uma vez, totalizando uns 30 s. Após o segundo boot você cai no EmulationStation.

Opção 2: `dd` manual

Se você prefere a linha de comando ou está no Windows (use Rufus, Etcher ou equivalente ao Raspberry Pi Imager).

Baixe uma imagem

Em Arch-R releases pegue uma de:

<Ver of="imageBase" />-original.img.gz: para as placas originais
<Ver of="imageBase" />-clone.img.gz: para placas clone

A data no nome do arquivo é a data da release, então uma release mais nova tem outro nome.

Descompacte

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

Identifique o dispositivo SD

lsblk
# procure pelo seu cartão, geralmente /dev/sdX ou /dev/mmcblkX

Confira duas vezes o caminho do dispositivo. Gravar no disco errado vai apagá-lo.

Grave

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

Instale o overlay de painel

A imagem não traz nenhum overlay de painel. Gere o mipi-panel.dtbo da sua placa no Gerador de Overlays e copie o arquivo para a partição de boot:

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

O caminho e o nome do arquivo são fixos: o extlinux.conf carrega FDTOVERLAYS /overlays/mipi-panel.dtbo e mais nada. Um arquivo salvo em outro lugar nunca é lido.

Boot

Insira e ligue. O primeiro boot redimensiona e reinicia; o segundo boot chega ao ES.

Primeiro boot

Depois da gravação, o primeiro power-on faz o seguinte automaticamente e então reinicia:

1. parted resizepart  -> /storage usa o SD inteiro
2. e2fsck + resize2fs -> filesystem ext4 cresce
3. tune2fs -U random  -> UUID novo do filesystem
4. fatlabel -i -r     -> ID de volume novo na partição de boot
5. reboot

O log do resize fica em /flash/fs-resize.log caso você precise inspecionar.

O segundo boot cria os diretórios de ROM (um por sistema) e cai no EmulationStation. A partir daí você pode adicionar ROMs e habilitar SSH.

Variantes explicadas

Variante	U-Boot	Device trees na imagem
`original`	Loader BSP da Rockchip	R36S, R36S Soysauce, R33S, Odroid Go Advance (e a placa v11), Odroid Go Super, Anbernic RG351M, Anbernic RG351V, GameForce Chi, MagicX XU10, Powkiddy RGB10
`clone`	Mainline v2025.10	Clone genérico do R36S (K36 e semelhantes), Powkiddy RGB10X, MagicX XU-Mini-M, Odroid Go Advance

As duas imagens diferem no bootloader e nos device trees que carregam. Kernel, rootfs, RetroArch e EmulationStation são idênticos.

Gerador de overlays de painel

O Gerador de Overlays monta o mipi-panel.dtbo a partir do DTB do firmware original do seu console. Ele roda inteiramente no navegador, mas antes precisa baixar um runtime Python em WebAssembly de cerca de 8,6 MB. Em conexões lentas ou filtradas esse download pode nunca terminar, e a página fica presa pedindo para recarregar.

A edição offline é o mesmo gerador empacotado como script de terminal, com cerca de 100 KB e sem nenhum runtime para baixar.

Baixe o pacote

Pegue o archr-dtbo-offline.zip (cerca de 100 KB) e descompacte em qualquer lugar.

Tudo de que ele precisa vai dentro do pacote:

archr_dtbo.py: o mesmo script que o site executa
archr-bases/: as três DTBs base das quais o gerador espelha os detalhes
fdt/: a biblioteca de device tree (Python puro, licença BSD)
generate.sh (Linux e macOS) e generate.bat (Windows)
README.txt

Confira o Python

Python 3.5 ou mais novo é o único requisito. Nada de pip, nada de acesso à rede.

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

No Windows, instale a partir do python.org e marque Add python.exe to PATH durante a instalação.

Não rode pip install fdt. A biblioteca já está na pasta, e o pacote foi feito para funcionar sem rede nenhuma.

Gere o overlay

Abra um terminal na pasta descompactada e rode:

# 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

Primeiro argumento: o DTB do firmware original do seu console. Segundo: a string de opções do seu console (veja a tabela abaixo). -o: onde o overlay será escrito; sem ele, a saída vai para a saída padrão.

Os wrappers generate.sh e generate.bat fazem exatamente a mesma coisa. No Linux e no macOS o wrapper pode precisar da permissão de execução de volta, caso seu extrator a tenha descartado: chmod +x generate.sh.

Instale o resultado

Copie o arquivo gerado para a partição ARCHR do cartão como overlays/mipi-panel.dtbo. Essa pasta e esse nome de arquivo exatos são o que o extlinux.conf já aponta (FDTOVERLAYS /overlays/mipi-panel.dtbo), então não há mais nada a configurar. Um overlay salvo com outro nome, ou em outra pasta, simplesmente nunca é carregado e o console continua dando tela preta.

Strings de opção por console

String de opções	Console
`SDORIG`	R36S Original
`SDCLONE`	R36S Clone
`SDORIG-NAm`	R36S Soysauce

Flags extras são anexadas com hífen, exatamente como o site as monta, por exemplo SDCLONE-LSi. Se você não souber a sua string, abra o Gerador de Overlays em alguma conexão que funcione, escolha as opções e copie a string mostrada.

Erros comuns

Mensagem	O que significa
`python: command not found`, `'python' is not recognized`	Python ausente ou fora do PATH. Em alguns Linux o comando é `python3`, não `python`.
`No module named 'fdt'`	O script foi movido para fora da pasta. Mantenha `archr_dtbo.py`, `fdt/` e `archr-bases/` juntos.
`anti-gap: base not available`	A pasta `archr-bases` sumiu ou foi movida. O overlay ainda sai, mas sem a etapa que preenche os detalhes da placa a partir da base ArchR correspondente.

Solução de problemas

Tela preta após o logo de boot. Overlay de painel errado ou ausente. Gere o overlay de novo a partir do .dtb original do seu próprio console e copie para /flash/overlays/mipi-panel.dtbo, ou use a aba Overlay do Flasher, que grava o arquivo em um cartão já gravado.

Boot em loop ou travado após o primeiro reboot. Capture cat /storage/.boot_last_hang depois de algum boot bem-sucedido: o arquivo nomeia o script que travou. Veja Solução de problemas.

"BOOT FAILED" em um dispositivo clone com a imagem original. Você escolheu a variante errada. Use a imagem clone.

O Flasher diz "image checksum mismatch". O download veio corrompido. Clique em "Flash" de novo; o Flasher rebaixa e tenta de novo.

Instalação

On this page