Knulli è un firmware alternativo derivato da Batocera, progettato per console portatili il cui kernel Linux non è mainline o il cui produttore non pubblica sorgenti utilizzabili. In concreto, si scrive un'immagine su una scheda microSD, si avvia e si ottiene un'interfaccia EmulationStation che gestisce emulatori, controller, Wi-Fi, scraping e successi RetroAchievements da un unico menu. La versione attuale al momento in cui scriviamo si chiama Scarab (build 20260511), pubblicata a maggio 2026. Questa guida segue passo dopo passo la documentazione ufficiale del progetto, senza scorciatoie. Calcolate trenta minuti per l'installazione, un po' di più se partite da una scheda vuota.
Cos'è Knulli e cosa non è
Knulli è un fork di Batocera. Il progetto lo dichiara chiaramente: la licenza di Batocera non consente l'aggiunta di kernel chiusi, il che rendeva impossibile l'integrazione delle macchine con BSP proprietario nel ramo principale. Knulli riprende quindi la base di Batocera e la adatta alle portatili con poca memoria.
Non è uno strato sovrapposto al sistema originale e non è un prodotto commerciale: il marchio Knulli è sotto licenza non commerciale e non è destinato alla vendita.
Su quali macchine gira Knulli
La lista ufficiale è pubblicata sulla pagina Devices del progetto e sulla pagina delle versioni. Ecco il confronto con le macchine che vendiamo.
| Macchina | Piattaforma | Immagine ufficiale |
|---|---|---|
| Anbernic RG35XX Pro | Allwinner H700 | Sì |
| Anbernic RG35XX Plus / 2024 / H / SP | Allwinner H700 | Sì, un'immagine per variante |
| Anbernic RG28XX, RG34XX, RG CubeXX | Allwinner H700 | Sì |
| Anbernic RG40XX H e RG 40XXV | Allwinner H700 | Sì, due immagini distinte |
| TrimUI Brick e Smart Pro | Allwinner A133 Plus | Sì |
| TrimUI Smart Pro S | Allwinner T527 | Versione anticipata (early), non ancora stabile |
| Retroid Pocket 5, Pocket Flip 2 e Pocket Mini | Snapdragon 865 | Versione anticipata (early), con preparazione preliminare |
| Miyoo Mini Plus | SigmaStar SSD202D | No |
| Console Android (Retroid Pocket Classic, Anbernic RG557, AYN Thor…) | ARM Android | Non interessate |
Due osservazioni. Le Anbernic H700 hanno ciascuna la propria immagine: una RG35XX H non si avvia con quella di una RG35XX SP, nonostante lo stesso chip. E alcuni modelli non sono presenti nelle immagini della versione Scarab (RG353V, RG353PS, Powkiddy RGB20S); la lista cambia a ogni versione. La nostra tabella di compatibilità firmware riporta queste corrispondenze.
Cosa offre Knulli rispetto al firmware originale
Il vantaggio principale è la centralizzazione: si configurano gli emulatori da EmulationStation, senza entrare nel menu di ogni core di RetroArch. Il resto, in pratica:
- Scraping delle copertine e dei metadati integrato.
- Successi RetroAchievements.
- Bluetooth per controller esterni, supporto per tastiera e mouse.
- Uscita HDMI sulle macchine che la possiedono.
- Trasferimento file tramite rete, condivisione Samba accessibile dall'Esplora risorse di Windows.
- Sincronizzazione dei backup tramite Syncthing, migliorata nella versione Scarab.
- Temi, cornici (bezels), logo di avvio, shader, illuminazione RGB.
- PortMaster, la libreria di porting nativi, installabile da due menu.
Ci sono anche dei contro, bisogna dirlo. La documentazione ufficiale non è tradotta in francese. L'interfaccia è più densa di quella di un firmware del produttore e un principiante può perdersi. Un aggiornamento maggiore richiede spesso una reinstallazione pulita, quindi una riconfigurazione. E non appena si connette la macchina al Wi-Fi, i suoi dati sono accessibili sulla rete locale senza password finché non si attiva la protezione nel menu Security.
L'hardware necessario
Una scheda microSD di buona qualità, un lettore di schede affidabile e uno strumento per scrivere immagini. La documentazione di Knulli cita Rufus, balenaEtcher, Raspberry Pi Imager e Win32 Disk Imager; dd è adatto se siete a vostro agio con la riga di comando. Prevedete anche 7-Zip: alcune immagini sono fornite in archivi suddivisi in più parti.
Per la scheda, non risparmiate: una contraffazione o una scheda lenta causano corruzioni dei backup che poi vengono attribuite al firmware. I nostri criteri sono dettagliati nella guida scegliere una scheda microSD. Le schede che spediamo vengono verificate con una scrittura-lettura completa prima della partenza.
Installazione passo dopo passo
- Identificate il vostro modello esatto. Non la gamma, ma il modello e la sua variante: RG35XX Plus, RG35XX 2024, RG35XX H, RG35XX SP e RG35XX Pro sono cinque macchine diverse. Controllate la serigrafia sul retro e la scatola.
- Verificate se il vostro dispositivo richiede una preparazione. La guida di avvio rapido segnala che alcune macchine, tra cui la Miyoo Flip e le Retroid Pocket, richiedono un'operazione preliminare prima della scrittura della scheda. Le Anbernic H700 e le TrimUI, no.
-
Scaricate l'immagine dalla pagina ufficiale delle versioni, repository
knulli-cfw/knulli-linuxsu GitHub. I file seguono lo schemaknulli-<chip>-<modello>-<nome della versione>-<data>.img.gz, ad esempio un'immagineh700per le Anbernic oa133per le TrimUI. Non prendete mai un'immagine trovata altrove. -
Controllate l'integrità del download. La pagina delle versioni su GitHub mostra l'impronta SHA-256 di ogni file: confrontatela con quella che calcolate. Fate anche testare l'archivio da 7-Zip prima della scrittura, poiché i formati gzip e 7z includono un CRC. Se l'immagine è suddivisa, scaricate tutte le parti (
.001,.002…) ed estraete dalla prima. - Scrivete l'immagine sulla scheda con lo strumento a vostra scelta. L'operazione cancella completamente la scheda. Verificate tre volte la lettera dell'unità prima di confermare.
- Primo avvio. Inserite la scheda nel primo alloggiamento, rimuovete qualsiasi scheda dal secondo alloggiamento, accendete. L'avvio è lungo: Knulli estende e formatta la partizione dei giochi. Non interrompete l'alimentazione, non rimuovete la scheda.
- Aspettate EmulationStation. L'installazione è terminata solo quando l'interfaccia appare. La partizione SHARE raggiunge la sua dimensione definitiva solo in quel momento: non provate a copiarvi nulla prima.
La configurazione subito dopo
Lingua
La lingua dell'interfaccia si imposta dal menu principale, tasto Start, nelle impostazioni di sistema. La dicitura esatta del menu cambia da una versione all'altra, da confermare sulla vostra build. La documentazione del progetto, invece, esiste solo in inglese, spagnolo, tedesco, polacco, turco, portoghese del Brasile, italiano e giapponese.
Wi-Fi e rete
Start quindi Network settings, attivate il Wi-Fi nella sezione delle impostazioni. Una volta connessi, la macchina appare nell'Esplora risorse di Windows all'indirizzo \\KNULLI\share, e l'accesso SSH utilizza l'identificativo root. Passate immediatamente al menu Security per impostare una password se non siete sulla vostra rete domestica.
Pulsanti
Start, Controller & Bluetooth Settings, Controller Mapping per associare un controller esterno. Tuttavia, non rimappate i comandi integrati della console: ogni immagine Knulli è fornita con un mapping ottimizzato per la macchina, e il rimapping rompe delle funzioni virtuali nascoste, come la conversione del direzionale in stick. Per cambiare i tasti di un gioco specifico, passate dalle impostazioni dell'emulatore.
Standby e autonomia
La FAQ ufficiale tratta di uno scaricamento rapido della batteria sulle Anbernic RG35XX e RG40XX, e di un'immagine deformata sulle revisioni recenti della RG35XX SP. Leggete la scheda di risoluzione problemi del progetto prima di concludere per un difetto hardware.
Dove mettere i vostri giochi
Tutto passa per la cartella /userdata, che corrisponde alla partizione SHARE della scheda principale, o alla partizione principale della seconda scheda se ne utilizzate una. Il percorso da ricordare è /userdata/roms/, con una sottocartella per sistema, più /userdata/bios per i file di sistema e /userdata/saves per i backup.
Punto importante sulla doppia scheda: SD1 e SD2 non possono servire come archiviazione dei giochi contemporaneamente. Scegliete l'una o l'altra nelle impostazioni, e in modalità doppia scheda la partizione SHARE interna non è più utilizzata né accessibile tramite rete. Per il dettaglio dei nomi delle cartelle per sistema, consultate il nostro articolo su l'albero delle cartelle dei firmware, non lo riscriviamo qui.
La trappola più frequente
È la fretta al primo avvio. Tre errori si ripetono continuamente: copiare giochi prima che la partizione SHARE sia stata estesa, lasciare una seconda scheda inserita durante l'installazione, accettare la proposta di formattazione di Windows. Tutti e tre si risolvono con una reinstallazione completa.
La seconda trappola riguarda gli aggiornamenti maggiori: dopo un aggiornamento di versione, non ripristinate la cartella system della vostra installazione precedente. I file di configurazione non sono compatibili da una versione maggiore all'altra e vi ritrovate con impostazioni incoerenti. Ripristinate i giochi, i backup, i temi, non la cartella system. Se nonostante tutto un gioco si rifiuta di avviarsi, la nostra guida il mio gioco non si avvia esamina le cause.
Aggiornare
Esistono tre strade, documentate dal progetto.
- OTA. Menu principale, Updates & Downloads, tipo di aggiornamento su Stable, quindi Start Update. È necessaria una connessione internet. Non interrompete nulla durante l'operazione, non avviate alcun gioco in parallelo.
-
Pacchetto di avvio. Per gli aggiornamenti minori, si scarica il pacchetto corrispondente dalla pagina delle versioni, si sostituisce il file
boot/batoceradella partizione BATOCERA con il file fornito, rinominato, quindi si riavvia. -
Riscrittura completa. Per le versioni maggiori. Le note della versione Scarab raccomandano esplicitamente di ricominciare da una installazione pulita, poiché i file di configurazione non sono compatibili con le versioni precedenti. Fate un backup di
/userdataprima.
Sulle versioni recenti, l'installazione pulita rimane la via sicura, anche quando un aggiornamento sembra possibile. È più lunga, ma evita comportamenti erratici impossibili da diagnosticare in seguito.
Tornare indietro
Se avete seguito la regola d'oro, non c'è nulla da disfare: spegnete la console, rimettete la scheda microSD originale, riaccendete. Il firmware del produttore torna come prima, poiché Knulli vive sulla sua scheda e non tocca la scheda originale.
Questo vale per le macchine che si avviano dalla scheda, in particolare Anbernic H700 e TrimUI. Sui modelli che hanno richiesto una preparazione preliminare, il ripristino segue la procedura inversa descritta nella loro documentazione: da verificare caso per caso. Per confrontare i firmware alternativi tra loro, vedete la nostra guida all'installazione dei firmware personalizzati.
Domande frequenti
Knulli cancella il firmware originale della mia console?
No, se lo installate su un'altra scheda microSD. Sulle macchine che si avviano dalla scheda, il firmware del produttore è sulla scheda originale: finché non scrivete sopra, rimane intatto. I modelli che richiedono una preparazione preliminare fanno eccezione, leggete la loro pagina di documentazione prima.
Come verificare che il file scaricato non sia corrotto?
La pagina delle versioni su GitHub mostra l'impronta SHA-256 di ogni immagine: confrontatela con quella del vostro file. Fate anche testare l'archivio da 7-Zip prima della scrittura: i formati gzip e 7z contengono un CRC interno e un archivio danneggiato verrà segnalato. Se l'immagine è in più parti, scaricatele tutte.
La mia console si avvia ma non appare nulla per diversi minuti, è normale?
Al primo avvio, sì. Knulli estende e formatta la partizione dei giochi, e la documentazione avverte che l'operazione può essere lunga. Non spegnete la macchina. Se lo schermo rimane nero dopo diversi riavvii, probabilmente avete scritto l'immagine di un'altra variante.
Posso usare la stessa seconda scheda di muOS?
La FAQ di risoluzione problemi del progetto tratta questo caso specifico, così come il riutilizzo di una scheda formattata per Garlic. Il comportamento dipende dal sistema di file e dall'albero delle cartelle atteso da ogni firmware: consultate la risposta ufficiale prima di condividere una scheda, piuttosto che provare e formattare tutto in seguito.
PortMaster è incluso?
Non è preinstallato. Dopo l'installazione, aprite il menu, andate in Device Settings e scegliete Install Portmaster. È necessaria una connessione internet per installarlo e recuperare i porting. La libreria conta diverse centinaia di giochi, ma la vostra console mostrerà solo quelli compatibili con essa.
Knulli cambia le prestazioni di emulazione della mia macchina?
Non cambia l'hardware. Una Allwinner H700 rimarrà nelle stesse acque: Super Nintendo e precedenti, PlayStation 1, un po' di Nintendo 64 o di Dreamcast a seconda dei titoli. Knulli porta emulatori aggiornati e impostazioni accessibili, non potenza.
Se avete ancora dubbi sulla macchina da installare, o se cercate un modello il cui firmware alternativo sia ben supportato, sfogliate la nostra selezione di console retro Linux.
