Installare ROCKNIX passo dopo passo: la guida completa

ROCKNIX è una distribuzione Linux dedicata alle console portatili di retrogaming. Sostituisce il firmware di fabbrica e offre un'interfaccia unificata, emulator aggiornati e una compatibilità hardware molto ampia: Anbernic, Powkiddy, Ayn, Retroid, AYANEO, GameForce, Hardkernel, MagicX e diversi cloni senza marca. Il progetto è un fork di JELOS, il cui codice è stato ripreso dopo la fine del suo sviluppo.

L'installazione non è complicata, ma un passaggio fa inciampare molti al primo tentativo: sulle console con chip Allwinner H700, è necessario copiare manualmente un file device tree prima del primissimo avvio. Ecco la procedura, verificata nella documentazione ufficiale del progetto nell'agosto 2026.

A chi è rivolto ROCKNIX

Gli sviluppatori sono chiari: il progetto è fornito «così com'è», senza supporto ufficiale, e viene descritto come una distribuzione per appassionati. Non è garantito il funzionamento e la documentazione è ancora in fase di elaborazione in alcuni punti.

ROCKNIX è quindi adatto se accettate di leggere una pagina wiki, confrontare un numero di modello e ricominciare un'operazione in caso di errore. Altrimenti, il firmware originale svolge già il suo compito e le nostre schede indicano lo stato di ogni console al momento della consegna: pronta per giocare o da configurare.

La nostra guida generale sui firmware personalizzati mette a confronto muOS, Knulli, ArkOS, ROCKNIX e Batocera. Questo articolo tratta esclusivamente ROCKNIX.

Quali console del catalogo sono supportate

La compatibilità hardware è uno dei punti di forza del progetto: la lista ufficiale supera le sessanta console. Ecco la situazione per le console che vendiamo.

Verificate la lista aggiornata sulla pagina Devices del progetto, integrata dalla nostra tabella di compatibilità firmware.

Cosa offre ROCKNIX rispetto al firmware originale

Un'unica interfaccia per tutto. ROCKNIX utilizza EmulationStation, con scraper integrato per copertine, temi, collezioni, shader e overlay. Il firmware di fabbrica di Anbernic, invece, mescola diverse interfacce a seconda del sistema emulato.

Aggiornamenti regolari. Dal giugno 2026, il progetto pubblica un'immagine il primo giorno di ogni mese: 20260601, 20260701, 20260801, 20260901, 20261001. In precedenza il ritmo era più irregolare. La versione più recente al momento del nostro ultimo controllo è la 20261001.

Rete e servizi online. Wi-Fi, condivisione Samba, SSH, netplay, RetroAchievements e sincronizzazione dei backup sul cloud sono integrati. I firmware di fabbrica sono molto più limitati in questo ambito.

In cambio, perdete il sistema pronto per giocare: la partizione principale è in ext4, quindi illeggibile da Windows senza software di terze parti, e diventate responsabili della vostra installazione. È uno scambio, non un vantaggio gratuito.

Cosa serve prima di iniziare

• Una seconda scheda microSD di qualità e un lettore di schede affidabile. Una scheda lenta o contraffatta provoca crash che si impiegano ore a diagnosticare: consultate la nostra guida alle schede microSD.
• Un software per scrivere immagini. La documentazione cita Rufus, Raspberry Pi Imager, Win32 Disk Imager o dd da riga di comando. Il progetto pubblica anche il proprio strumento, ROCKNIX Image Burner, esclusivamente per Windows: scegliete il produttore e il modello, quindi «Write Image to Drive».
• Un programma per decomprimere un file .gz.

Installazione passo dopo passo

1. Identificate il vostro modello esatto, non la famiglia. Una RG35XX Plus, una RG35XX H e una RG35XX Pro non utilizzano lo stesso file device tree. Il nome completo è stampato sulla scatola e sul retro della console.
2. Scaricate l'immagine dal sito ufficiale. Passate dalla scheda della vostra console su rocknix.org, che punta all'immagine corretta, o dalla pagina delle versioni del repository ROCKNIX/distribution su GitHub, sezione «Installation Package Downloads». Il nome segue lo schema ROCKNIX-PLATEFORME.aarch64-DATE.img.gz. Per le H700 esistono due varianti, DDR3 e DDR4; la documentazione non specifica come scegliere, da confermare in base alla versione — se la console non si avvia, provate l'altra.
3. Verificate la somma di controllo. Le versioni recenti pubblicano un hash accanto alle immagini. Confrontatelo con quello che calcolate: certutil -hashfile file.img.gz SHA256 su Windows, shasum -a 256 file.img.gz su macOS e Linux. Un download interrotto produce una scheda che sembra scritta ma non si avvia mai.
4. Decomprimete e scrivete l'immagine sulla seconda scheda microSD. L'operazione cancella completamente la scheda.
5. Console Allwinner H700: copiate il device tree. Vedere di seguito. Non avviate la console prima di averlo fatto.
6. Espellite correttamente la scheda tramite la funzione di espulsione del vostro sistema. La documentazione è esplicita: saltare questo passaggio può rendere la scheda non avviabile e dovrete ricominciare tutto dalla scrittura dell'immagine.
7. Primo avvio. Console spenta, inserite la scheda e accendete. ROCKNIX esegue la sua sequenza di installazione, si riavvia e poi si avvia EmulationStation. Su alcune console è necessario prima dare priorità alla scheda SD nell'ordine di avvio; la scheda della console lo specifica.

Il passaggio device tree sulle Allwinner H700

È la particolarità di tutte le Anbernic con chip H700, ovvero la maggior parte delle console Linux del catalogo. La documentazione ufficiale è chiara: queste console richiedono operazioni manuali dopo la scrittura dell'immagine e prima del primo avvio. Si eseguono una sola volta e non sono necessarie per gli aggiornamenti.

Aprite la partizione denominata ROCKNIX: contiene una cartella device_trees. Individuate il file del vostro modello, copiatelo nella cartella principale di questa stessa partizione, quindi rinominate la copia in dtb.img, tutto in minuscolo.

Le due revisioni indistinguibili

Avrete notato le voci doppie. Sulla RG35XX 2024, sulla RG35XX Plus e sulla RG35XX H esistono due file a seconda della revisione della scheda elettronica, e la documentazione lo afferma chiaramente: è impossibile distinguere la differenza senza aprire la console. La stessa logica vale per la RG35XX SP con la variante v2-panel.

Il metodo è quindi empirico. Prendete il file standard. Se lo schermo mostra un'immagine incoerente all'avvio, spegnete tenendo premuto il pulsante di accensione per dieci secondi, riscrivete l'immagine e ricominciate con l'altro file. Non è elegante, ma è la procedura ufficiale e richiede un quarto d'ora.

La configurazione dopo l'installazione

Il menu principale di EmulationStation si apre con il tasto Start. Le impostazioni da effettuare subito.

• Lingua. Il francese è disponibile nelle impostazioni dell'interfaccia. La traduzione è corretta per l'essenziale, meno uniforme nei menu avanzati.
• Wi-Fi. Attivatelo subito: è necessario per lo scraper, gli aggiornamenti online e la condivisione di rete.
• Pulsanti. Il controller integrato viene rilevato al primo avvio. La riassegnazione dei tasti avviene poi dall'interfaccia e separatamente in RetroArch per le impostazioni per sistema. Il progetto sta attualmente spostando la documentazione dei comandi nelle schede di ogni console, ma non è ancora tutto presente.
• Standby e autonomia. Regolate lo standby e, se la console lo consente, la frequenza del processore: sulla RG35XX Pro funziona a 1,4 GHz e può essere spinta a 1,5 GHz.
• Credenziali di rete. Samba e SSH sono disattivati per impostazione predefinita e si attivano nelle impostazioni di rete. L'utente è root; la password viene rigenerata a ogni riavvio e viene visualizzata nelle impostazioni di sistema, a meno che non ne definiate una.

Dove mettere i giochi

Tutto parte da una cartella roms, che contiene una sottocartella per ogni sistema emulato e dove vengono conservati anche i file BIOS richiesti da alcuni emulatori.

Sulle console con due slot, come la maggior parte delle Anbernic H700, inserite una scheda formattata in FAT32, exFAT, ext4 o btrfs nel secondo slot: la cartella roms viene creata automaticamente all'avvio. Su una console con un solo slot, attivate il rilevamento automatico della scheda dei giochi nelle impostazioni di sistema prima di inserirla.

I dettagli dei nomi delle sottocartelle e delle differenze tra i firmware sono nel nostro articolo su la struttura dei giochi.

L'errore più frequente

È la dimenticanza, o la scelta errata, del file device tree sulla H700. La scheda viene scritta correttamente, la console si accende, ma non viene visualizzato nulla. Il primo istinto è quello di sospettare della scheda SD o dell'immagine e di ricominciare tutto da capo, ottenendo lo stesso risultato.

Tre verifiche in ordine: il file è stato copiato nella cartella principale della partizione ROCKNIX e non è stato lasciato in device_trees; è stato rinominato correttamente in dtb.img tutto in minuscolo, senza l'estensione .dtb aggiunta da Windows; corrisponde al vostro modello esatto. Se tutti e tre sono corretti, è la revisione della scheda elettronica: provate l'altro file.

Secondo errore, meno evidente: rimuovere la scheda senza utilizzare la funzione di espulsione del sistema può renderla non avviabile.

Aggiornare a una versione successiva

Il passaggio device tree non va ripetuto: avviene solo durante l'installazione.

Dalla console. Tasto Start, impostazioni di sistema, sezione aggiornamento, quindi avvio. Potete consultare il registro delle modifiche prima di confermare. Il Wi-Fi deve essere configurato.

Manualmente. Scaricate il file .tar della vostra piattaforma nella sezione «Update Package Downloads», quindi copiatelo in /storage/.update, tramite SCP o tramite la condivisione di rete «update». Riavviate: l'aggiornamento viene applicato automaticamente.

Le versioni di sviluppo sono disponibili sul Discord del progetto. Non contengono le credenziali dello scraper né di RetroAchievements: queste due funzioni non funzionano in esse. Riservatele ai test.

Tornare indietro

Se avete rispettato la regola d'oro, non c'è nulla da fare: spegnete la console, reinserite la scheda microSD originale e riaccendetela. Il firmware di fabbrica ripartirà come prima, con i vostri backup.

Se avete sovrascritto la scheda originale, dovete recuperare l'immagine ufficiale del firmware sul sito del produttore e riscriverla. È fattibile, ma i produttori non sempre la conservano a lungo. Ecco perché esiste la regola d'oro.

In entrambi i casi, recuperate i vostri backup prima di passare all'altro sistema: non sono condivisi tra i due.

Domande frequenti

Per approfondire

Il passaggio device tree è solo un dettaglio procedurale: non deve influire sulla scelta di una console. Guardate prima la dimensione dello schermo, l'autonomia e i sistemi supportati. Le nostre console compatibili con ROCKNIX sono raggruppate nella collezione console retro Linux, e ogni scheda indica il chip esatto, quindi l'immagine da scaricare.