Guida di Phosphor OS
Phosphor OS trasforma un Raspberry Pi in una console retro che si avvia direttamente nel suo menu. Funziona su televisori e monitor CRT (con le schede RGBerry, tramite SCART o VGA) e su schermi piatti tramite HDMI, anche in verticale per i cabinati arcade.
È gratuito. Le schede RGBerry si vendono a parte, ma non servono per usare Phosphor OS tramite HDMI.
1. Cosa ti serve
| Raspberry Pi | Pi 4 / Pi 400 (consigliato), Pi 5 / Pi 500, Pi 3 o Zero 2 W |
| microSD | 8 GB o più (meglio 32 GB o più se avrai molti giochi). A1 / Class 10 |
| Alimentatore | Quello ufficiale di ogni modello: Pi 4/400 → USB-C 5 V 3 A · Pi 5/500 → USB-C 27 W · Pi 3/Zero 2 W → micro-USB 2,5 A |
| Schermo | Tramite HDMI (TV o monitor) o tramite SCART/VGA con una scheda RGBerry |
| Controller | Qualsiasi controller USB o Bluetooth. Va bene anche una tastiera USB |
Prestazioni indicative:
| Sistema | Zero 2 W / Pi 3 | Pi 4 / 400 | Pi 5 / 500 |
|---|---|---|---|
| NES, Master System, Game Boy, PC Engine | ✓ | ✓ | ✓ |
| SNES, Mega Drive, Game Gear | ✓ (quasi tutto) | ✓ | ✓ |
| PlayStation | al limite | ✓ | ✓ |
| Arcade (MAME 2003-Plus) | dipende dal gioco | ✓ quasi tutto | ✓ |
| Filtro CRT su HDMI | — | leggero / CRT-Pi | tutti |
2. Scrivere la scheda
- Scarica
phosphor-os-rpi.img.xz. Non serve decomprimerlo. - Apri Raspberry Pi Imager (o balenaEtcher).
- Scegli sistema operativo → Usa personalizzato e seleziona il file
.img.xz. - Scegli la microSD e scrivi l'immagine. Tutto il contenuto verrà cancellato.
In Raspberry Pi Imager non usare la "personalizzazione" (utente, Wi-Fi...): Phosphor OS non la legge. Il Wi-Fi si configura come spiegato nella sezione 5.
3. Primo avvio
Inserisci la scheda, collega schermo e controller e accendi. Vedrai l'animazione di Phosphor OS e, la prima volta, il sistema crea una partizione chiamata SHARE nello spazio libero della scheda (ci vuole qualche secondo). Poi compare il menu con l'avviso "Nessun gioco".
Uscita video
- Senza scheda RGBerry: esce tramite HDMI alla risoluzione dello schermo.
- Con scheda RGBerry: viene rilevata da sola e usa SCART o VGA in base ai suoi interruttori. L'HDMI resta spento.
| Interruttore 1 | Interruttore 2 | Uscita |
|---|---|---|
| OFF | — | SCART (TV a 15 kHz, risoluzione originale di ogni gioco) |
| ON | OFF | VGA 31 kHz (monitor PC, 640×480) |
| ON | ON | VGA 15 kHz (monitor arcade o multifrequenza) |
Se qualcosa non si vede bene, guarda la sezione 9.
4. Aggiungere giochi
Phosphor OS non include giochi. Usa solo copie di giochi che possiedi.
Dal computer (il modo più facile)
- Spegni la console (Impostazioni → Spegni) ed estrai la microSD.
- Inseriscila nel PC. Compariranno due unità: PHOSPHOR (avvio, non toccarla se non
per
wifi.txt) e SHARE. - Copia ogni gioco in
SHARE/roms/<sistema>:
| Cartella | Sistema | Formati |
|---|---|---|
nes |
NES / Famicom | .nes .fds .unf .zip .7z |
snes |
Super Nintendo | .sfc .smc .fig .swc .bs .st .zip .7z |
megadrive |
Mega Drive / Genesis | .md .gen .smd .bin .zip .7z |
mastersystem |
Master System | .sms .zip .7z |
gamegear |
Game Gear | .gg .zip .7z |
segacd |
Mega-CD | .cue .chd .iso .m3u |
pcengine |
PC Engine / TurboGrafx | .pce .cue .chd .sgx .zip .7z |
psx |
PlayStation | .cue .chd .pbp .m3u .exe |
gb |
Game Boy | .gb .zip .7z |
gbc |
Game Boy Color | .gbc .zip .7z |
arcade |
Arcade (MAME 2003-Plus) | .zip .7z |
- Reinserisci la scheda e accendi. Nel menu compaiono solo i sistemi che hanno dei giochi.
Arcade: i file zip devono essere del set di MAME 2003-Plus; quelli di altre versioni
di MAME spesso non funzionano. I BIOS arcade (neogeo.zip, ecc.) vanno nella stessa
cartella arcade. Non compaiono nella lista, perché non sono giochi.
PlayStation e CD: usa .chd (un file per disco, occupa meno spazio) o .cue + .bin.
Per i giochi su più dischi, crea un file .m3u con un disco per riga.
Tramite rete
Con il Wi-Fi o il cavo collegati, la console accetta SCP sulla porta 22 (utente root,
password phosphor). Con WinSCP scegli il protocollo SCP e copia in
/userdata/roms/<sistema>. Dal terminale:
scp -O "Super Metroid.sfc" root@<IP>:/userdata/roms/snes/
L'IP compare in Impostazioni → Informazioni. Se copi tramite rete, torna al menu iniziale e rientra nel sistema, oppure riavvia, per vedere i nuovi giochi.
BIOS
Alcuni sistemi hanno bisogno del BIOS originale, che non è incluso. Va in SHARE/bios:
| Sistema | File | Obbligatorio? |
|---|---|---|
| PlayStation | scph5501.bin (USA) · scph5502.bin (EUR) · scph5500.bin (JAP) |
Consigliato (senza, funziona con un BIOS libero meno compatibile) |
| Mega-CD | bios_CD_E.bin · bios_CD_U.bin · bios_CD_J.bin |
Sì |
| PC Engine CD | syscard3.pce |
Sì, per i giochi su CD |
| Famicom Disk System | disksys.rom |
Sì, per i .fds |
| Game Boy / Color | gb_bios.bin · gbc_bios.bin |
No (solo l'animazione iniziale) |
Immagini nella lista
Se metti un'immagine PNG con lo stesso nome del gioco in roms/<sistema>/media/, la
vedi nel pannello della lista dei giochi (su HDMI). Per esempio:
roms/snes/media/Super Metroid.png.
5. Wi-Fi e Bluetooth
Wi-Fi
- Dal menu: Impostazioni → Wi-Fi. Cerca le reti, scegli la tua e scrivi la password con la tastiera sullo schermo. Se hai una tastiera USB collegata, puoi scrivere direttamente con quella.
- Dal PC, prima dell'avvio: nell'unità PHOSPHOR modifica
wifi.txt, togli i#e inserisci la tua rete:
SSID="MiaRete"
PASSWORD="MiaPassword"
COUNTRY=IT
Le reti vengono salvate in SHARE, quindi non si perdono quando aggiorni Phosphor OS.
Controller Bluetooth
Impostazioni → Bluetooth → Cerca controller. Metti il controller in modalità di associazione prima di cercare:
| Controller | Modalità di associazione |
|---|---|
| 8BitDo | Tieni premuto Start + il tasto della modalità (X, B...) e poi quello di associazione |
| DualShock 4 | Tieni premuto Share + PS finché la luce lampeggia velocemente |
| DualSense | Tieni premuto Create + PS |
| Switch Pro | Tasto piccolo in alto, accanto all'USB-C |
Scegli il controller nella lista e si associa da solo. La volta dopo basta accenderlo. Per dimenticare un controller, premi A due volte su di esso.
6. Usare il menu
| Tasto | Nel menu |
|---|---|
| Croce direzionale | Muoversi |
| A | Entrare / giocare |
| B | Tornare indietro |
| Y | Aggiungere ai preferiti |
| L / R | Filtro: tutti, preferiti, recenti |
| START | Impostazioni |
Con la tastiera: frecce, Invio (A), Esc o Backspace (B), Y (preferito), Q/W (L/R) e Tab (Impostazioni). Se non hai né controller né tastiera, il mouse va bene in caso di emergenza: la rotella sposta, il clic sinistro entra, il destro torna indietro e il clic sulla rotella apre Impostazioni.
Durante il gioco
- SELECT + START: menu rapido di RetroArch (salvare e caricare la partita, opzioni...). Lì, Chiudi contenuto torna al menu di Phosphor.
- Con la tastiera, Esc esce dal gioco.
7. Impostazioni
| Impostazione | Cosa fa |
|---|---|
| Uscita | Auto usa gli interruttori della scheda. Forzare un'altra uscita richiede il riavvio |
| Monitor | Solo CRT: TV a 15 kHz, monitor arcade a 15 kHz o VGA a 31 kHz |
| Posizione H / V | Solo CRT: sposta l'immagine se esce da un lato |
| Filtro CRT | Solo HDMI: scanline o simulazione del tubo (CRT-Pi è il più fedele) |
| Schermata di test | Griglia e barre per centrare e regolare il monitor. Su CRT, la croce direzionale centra in tempo reale |
| Rotazione | 0°, 90° o 270°, per i monitor in verticale |
| Tema | Cambia l'aspetto del menu (vedi sotto) |
| Animazione di avvio | Attiva o toglie il logo animato all'accensione |
| Suoni del menu | I "blip" quando ti muovi |
| Controller | Vedi quelli collegati e configura uno che non risponde bene |
| Wi-Fi / Bluetooth | Vedi la sezione 5 |
| Informazioni | Modello, scheda, uscita, IP e spazio libero |
Configurare un controller che non funziona bene
Se un controller USB economico ha i tasti scambiati, in Impostazioni → Controller sceglilo e premi A. La procedura guidata ti chiede ogni tasto in base alla sua posizione. Se il tuo controller non ne ha qualcuno (X/Y, L/R, SELECT), aspetta 6 secondi e viene saltato da solo. La configurazione vale per il menu e per i giochi.
Temi
I temi vanno in SHARE/themes/<nome> e si scelgono in Impostazioni → Tema. Un tema può
cambiare solo i colori o tutto il design. Vedi docs/TEMAS.md del progetto.
8. Impostazioni avanzate (SHARE/phosphor.conf)
Lo stesso file che modifica il menu si può modificare dal PC:
PHOS_FORCE_OUTPUT=hdmi # scart | vga | hdmi (vuoto = automatico)
PHOS_FORCE_MONITOR= # generic_15 | arcade_15 | vga
PHOS_CENTER_H=0
PHOS_CENTER_V=0
PHOS_ROTATION=0 # 0 | 90 | 270
PHOS_CRT_FILTER=none # none | scanlines | light | crtpi | lottes
PHOS_THEME=phosphor
PHOS_SPLASH=1
PHOS_UI_SOUNDS=1
PHOS_FRONTEND=phosphor # retroarch = usa invece il menu di RetroArch
PHOS_DEBUG=0 # 1 = log dettagliato di RetroArch
La configurazione di RetroArch si trova in SHARE/system/configs/retroarch/retroarch.cfg e i
salvataggi in SHARE/saves e SHARE/states.
9. Risoluzione dei problemi
Non si vede niente tramite HDMI con la scheda RGBerry montata. È normale: con la scheda,
l'HDMI si spegne. Togli la scheda o imposta PHOS_FORCE_OUTPUT=hdmi in phosphor.conf.
L'immagine del CRT è spostata o tagliata. Impostazioni → Schermata di test e centra con la croce direzionale. Se il monitor ha i comandi della geometria, regolali con la schermata.
Un sistema non compare nel menu. Controlla che i giochi siano nella cartella giusta (sezione 4) e con un'estensione della lista.
Un gioco arcade non si avvia. Quasi sempre è uno zip di un'altra versione di MAME. Usa il
set di MAME 2003-Plus e, se il gioco ha bisogno del BIOS (Neo Geo, per esempio), metti anche
lo zip del BIOS in roms/arcade.
Il controller non risponde nei giochi, ma nel menu sì. Configuralo in Impostazioni → Controller.
Lo schermo resta nero dopo l'animazione. Aspetta qualche secondo: se il menu
fallisce tre volte di fila, si avvia il menu di RetroArch come alternativa. Se vuoi
capire cosa è successo, entra tramite SSH (ssh root@<IP>, password phosphor) e controlla
/userdata/system/logs/phosphor-ui.log e retroarch.log.
10. Licenze
Phosphor OS è software libero e gratuito. Alcuni emulatori inclusi (Snes9x, Genesis Plus GX e MAME 2003-Plus) hanno licenze che non consentono l'uso commerciale: non vendere schede SD con Phosphor OS già scritto e non includerlo in un prodotto a pagamento.