Convivere con una scheda LISY: LISY_control, dip switch e audio

La scheda è dentro, la macchina parte, esce la prima pallina. E adesso?

Una scheda LISY non è un ricambio equivalente che si monta e si dimentica. È un piccolo computer Linux al posto dove stava la vostra scheda CPU, e quasi tutto il comportamento della macchina è ora un'impostazione invece che un dato saldato. Due banchi di dip switch decidono le cose grandi; una pagina web decide il resto.

Questa è la vista quotidiana: cosa cambiare, dove si trova e cosa lasciar stare. Se state ancora capendo che cosa sia LISY, partite dalla nostra spiegazione su che cos'è la scheda LISY e come funziona e poi tornate qui.

Metterla in rete

LISY_control, l'interfaccia web, è il motivo per cui quasi tutto questo è semplice — e ha bisogno che la scheda sia nella vostra rete. Ci sono due modi per entrare.

La modalità client è quella predefinita: la scheda cerca una rete wireless e vi si collega. L'immagine arriva preconfigurata per una rete usata dall'autore, quindi il primo lavoro è puntarla sulla vostra. La partizione /boot della scheda SD è normale vFAT, quindi potete estrarre la card, metterla in un qualsiasi computer Windows o Mac e modificare il file wpa_supplicant.conf con il vostro SSID e la vostra password. Non serve conoscere Linux.

La modalità hotspot è il ripiego, e quella da ricordare quando si lavora su una macchina in un garage senza wifi. La scheda diventa il proprio access point chiamato LISY_Control, con la passphrase lisy80_and_lisy1_rocks, e l'interfaccia si raggiunge a 192.168.80.1 da telefono o portatile.

Una volta in rete potete dare alla scheda un hostname da LISY_control stesso, cosa che conta nel momento in cui possedete due macchine e rispondono entrambe a «lisy».

I due banchi di interruttori che decidono tutto

I dip switch fisici sulla scheda fanno ancora il lavoro pesante, e vale la pena impararli una volta per tutte.

S2 sceglie il vostro gioco. La scheda non porta con sé alcun codice di gioco: esegue le immagini ROM originali, e S2 le dice quale. Le appendici del manuale elencano il numero per ogni titolo supportato, per variante: appendice A per LISY1 (Gottlieb System 1), appendice B per LISY80 (System 80, 80A, 80B), appendice D per LISY35 (Bally e Stern, dal 1977 al 1985).

S1 imposta le opzioni. Quelle che toccherete davvero:

• S1-1 — partita libera (più sotto)
• S1-2 — audio interno invece dell'audio emulato
• S1-4 insieme a S1-8 — passare il controllo a Mission Pinball Framework
• S1-7 — scrivere un log di debug

Una cosa su cui in molti inciampano: il sistema normalmente monta il proprio filesystem in sola lettura, che è esattamente quello che si vuole in una macchina che viene spenta dall'interruttore. In modalità debug non lo fa, quindi usate il pulsante S3 sulla scheda per spegnere in modo pulito prima di togliere corrente, altrimenti rischiate la scheda SD.

Dove vivono le ROM

I romset sono file .zip PinMAME, messi in /lisy/lisy80/roms (oppure /lisy/lisy1/roms o /lisy/lisy35/roms), nominati esattamente come indica la colonna «Mame Name» delle appendici. Se il nome è sbagliato, la scheda semplicemente non troverà il gioco.

Non sono incluse nell'immagine, per motivi di copyright, e non è una dimenticanza da aggirare. Procurarsi la ROM della macchina che possedete è affare vostro, non del progetto.

La partita libera e il trucco dei due secondi

Mettete S1-1 su ON e la macchina gioca gratis. La cosa più elegante è come lo fa: tenete premuto il pulsante replay per più di due secondi e LISY emula la caduta di una moneta nella gettoniera sinistra, dandovi i crediti che il vostro gioco è configurato a dare per moneta.

È un dettaglio che conta nella pratica. Significa che la partita libera rispetta ancora le impostazioni di monetazione del gioco invece di scavalcarle: il display crediti si comporta normalmente e un gioco impostato su tre per uno continua a darne tre.

Far parlare a LISY_control la lingua della vostra macchina

Appena installato, le pagine di test elencano il contatto 27 e il solenoide 9. Utile, ma non tanto quanto «bersaglio a scomparsa sinistro» e «kicker sinistro».

Ogni descrizione è un file CSV che la scheda legge all'avvio — <NNN>_lisy1_switches.csv, _lamps.csv, _coils.csv, dove NNN è il numero del vostro gioco. Potete modificarli sulla scheda SD oppure caricarli dalla pagina di upload di LISY_control. Un'ora spesa a dare nomi alle cose una volta sola trasforma ogni futura ricerca guasti in una lettura invece che in un conteggio.

La stessa interfaccia modifica le vostre regolazioni di gioco. Le impostazioni dip che un proprietario di System 80 cambiava col cacciavite dentro il backbox ora vivono in <NNN>_lisy80_dips.csv, e LISY_control è l'editor: digitate i valori, premete set values, e restano salvati. Se per il vostro gioco non esiste un file, ne crea uno dai valori predefiniti.

Il resto dell'interfaccia è quello che si spera. I contatti si aggiornano circa una volta al secondo, chiuso in rosso e aperto in verde. Le lampade si commutano una per una. I solenoidi si eccitano da un pulsante — che è il modo più rapido in assoluto per capire se un pop bumper morto è la bobina, il driver o il contatto. I display accettano testo digitato. E c'è una pagina di statistiche NVRAM, perché la scheda tiene i contatori in una EEPROM e non su una batteria.

Audio: emulato oppure con i vostri file WAV

Per impostazione predefinita la scheda emula l'hardware audio originale tramite PinMAME, partendo dalla vostra ROM. Funziona, e su alcuni giochi è onestamente un po' ruvido: il progetto stesso avverte di audio scadente, variazioni di velocità e clic su certi titoli.

L'alternativa è l'audio interno, attivato con S1-2. Qui la scheda ignora l'emulazione e riproduce invece i vostri file .wav, mappati su ciascun suono di gioco: sette toni su LISY1, trenta su LISY80, fino a 256 su LISY35. Mettete i file nella cartella audio del gioco e vengono riprodotti.

Serve una scheda audio aggiuntiva, e il requisito è generico e non proprietario: qualsiasi scheda pHat-compatibile che funzioni con i driver hifiberry-dac. JustBoom, Speaker pHat e la HiFiBerry MiniAmp sono tutte indicate come funzionanti, e sul sito del progetto è pubblicato un progetto pHat DIY se preferite costruirvela.

Vale la pena sapere che questa non è l'unica strada per un buon audio su un System 80. Una scheda audio FPGA dedicata come la Gosof, che gestisce anche il parlato, toglie del tutto il lavoro alla scheda CPU. Problema diverso, strumento diverso.

Il gioco originale, o quello che avete scritto voi

Questa è la parte che i proprietari raramente si accorgono di aver comprato. Impostate S1-4 e S1-8 e la scheda smette di eseguire la vostra ROM e inizia a prendere ordini da Mission Pinball Framework, un framework Python aperto per scrivere regole di gioco da zero.

Tre modi per farlo girare: modalità master, con MPF in esecuzione sul Raspberry Pi della scheda e la vostra configurazione sulla SD; slave via seriale, con MPF su un PC collegato in USB a 115200 baud; oppure slave via rete, con MPF ovunque nella vostra LAN che dialoga con la scheda sulla porta 5963.

Realisticamente la maggior parte dei proprietari non lascia mai la ROM, e va benissimo così. Ma significa che la stessa macchina che gioca a Black Hole esattamente come nel 1981 può, con un dip switch, diventare una piattaforma di sviluppo per regole inventate da voi, senza toccare il piano di gioco. È una cosa rara da avere in un mobile di quarant'anni.

Il limite che dovreste conoscere

L'emulazione software legge la matrice dei contatti via software, e il progetto dice chiaramente che questo ha un costo: su alcuni giochi i movimenti rapidi dei contatti — lo spinner è l'esempio tipico — non vengono rilevati il 100% delle volte. Se la vostra macchina si appoggia a uno spinner per il punteggio, ve ne accorgerete.

La risposta del progetto stesso è la sua seconda famiglia di schede, i progetti FPGA «FA» — GottFA1, GottFA80, BallyFA, WillFA7 — che emulano il processore originale in hardware e stanno più vicini all'originale nei tempi. La nostra panoramica su chi produce schede CPU di ricambio colloca entrambe le famiglie accanto agli altri produttori.

Manutenzione ordinaria

Gli aggiornamenti di solito significano scrivere una nuova immagine sulla scheda SD, cosa che suona più pesante di quanto sia: copiate prima i vostri file CSV e in venti minuti siete tornati dov'eravate. Gli aggiornamenti piccoli si possono applicare direttamente dalla pagina di update di LISY_control senza riscrivere la card.

Se un gioco gira stranamente veloce o lento, c'è una colonna throttle nel CSV dei giochi (/lisy/lisy80/cfg/lisy80games.csv) che regola la velocità di emulazione per titolo. E se qualcosa si comporta davvero male, attivate il log di debug con S1-7, riproducete il guasto e poi leggete il file: a chi vi aiuta serve molto di più di un «non funziona».

Un'abitudine che vale la pena prendere: tenete una copia dei vostri file CSV fuori dalla macchina. Sono l'unica parte dell'installazione che è davvero vostra.

Domande frequenti

Come mi collego a LISY_control?

O collegate la scheda al vostro wifi modificando wpa_supplicant.conf sulla partizione /boot della SD e poi aprite il suo hostname; oppure usate la modalità hotspot, vi connettete alla rete LISY_Control e andate su 192.168.80.1.

Come imposto la partita libera su una scheda LISY?

Mettete il dip switch S1-1 su ON. Tenere premuto il pulsante replay per più di due secondi emula poi la caduta di una moneta nella gettoniera sinistra e assegna i crediti che il gioco è impostato a dare.

Le ROM dei giochi sono incluse con una scheda LISY?

No. I romset sono file .zip PinMAME che fornite voi e mettete nella cartella roms della vostra scheda, nominati come specifica l'appendice del manuale. Sono esclusi dall'immagine per motivi di copyright.

Posso usare suoni miei invece di quelli emulati?

Sì. Mettete S1-2 su ON per l'audio interno e fornite file .wav: sette su LISY1, trenta su LISY80, fino a 256 su LISY35. Serve una scheda audio pHat-compatibile che funzioni con i driver hifiberry-dac.

Una scheda LISY perde i colpi dello spinner?

Può succedere. Il progetto dichiara che su alcuni giochi i movimenti rapidi dei contatti come gli spinner non vengono rilevati il 100% delle volte. Se questo conta sulla vostra macchina, le schede FA basate su FPGA sono l'alternativa consigliata dal progetto stesso.

Devo spegnerla correttamente?

Normalmente no: il filesystem gira in sola lettura, quindi spegnere la macchina dall'interruttore è sicuro. In modalità debug non è così, quindi premete prima il pulsante S3 sulla scheda per spegnere in modo pulito.

Fonti e approfondimenti

• Manuale utente LISY v5.28 (Ralf / bontango)
• Progetto LISY — la gamma MPU e il limite sui contatti rapidi
• Progetto LISY — FAQ, licenza e dichiarazione DIY
• Progetto LISY — manuali, guide di montaggio e distinte base
• Mission Pinball Framework — documentazione hardware LISY
• bontango su GitHub — codice sorgente di LISY

Avete un Gottlieb System 80 e volete la scheda che rende possibile tutto quanto sopra? Guardate la scheda CPU Lisy80 con diagnostica, oppure leggete come la Lisy80 pronta all'uso si collega al progetto DIY. Il montaggio è trattato nel nostro video di installazione, e se dopo la macchina continua a fare i capricci, controllate le modifiche di massa del System 80 prima di dare la colpa alla scheda.