Lo sviluppo dell'emulatore

La versione originale dell'emulatore risale al 2005 ed è stata scritta in Quick Basic 4.5 (quindi a 16 bit) utilizzando una libreria di funzioni BCD, il che permette di ottenere gli stessi risultati della macchina originale. L'emulatore è stato poi arricchito nel corso del del tempo con nuove funzionalità; lanciato con lo switch /? fornisce un piccolo aiuto:

Dopo aver scoperto l'esistenza nel 2013 di QB64, progetto open-source che consente di portare in ambienti 32/64 bit programmi scritti per Qbasic/QuickBasic senza doverli riscrivere completamente, l'emulatore è stato leggermente modificato per poter essere compilato sotto QB64 ed è nato così il "fratellino", P101EMUL64.EXE, che può essere eseguito nativamente anche sotto Windows 7/8/10.
In entrambe le versioni è possibile visualizzare lo status degli switch tramite l'icona presente in alto a sinistra.

P101TOQB: traduttore da Programma 101 a Quick Basic

P101TOQB utilizza per la traduzione un file di transcodifica (ogni istruzione P101 viene resa con uno più statement BASIC) e poi aggiunge due file di libreria (scritti sempre in Quick BASIC) rispettivamente uno in cima e l'altro in fondo al programma: un file di note presente nella distribuzione spiega più in dettaglio l'intero processo.

Si può notare che la stessa metodologia può essere usata per la traduzione da P101 in un qualsiasi linguaggio di tipo interpretato.

Breve cronistoria

• Dicembre 2005: Prima versione; per i calcoli veniva usata la doppia precisione del QuickBasic 4.5 con tutti i problemi della virgola mobile implementata dalla Microsoft..... A questa data risale anche il traduttore P101TOQB. A parte l'emulatore (scritto in Pascal) dell'Università di Amsterdam, che però si limita all'esecuzione di programmi, questo è il primo emulatore completo della Programma 101 al mondo !!

• Ottobre 2007: Emulatore messo on line sul vecchio sito Tiscali - aggiornato nel Luglio 2008 ed a cui fanno riferimento ancora certi link su Internet.

• Giugno 2009: Riscrittura del codice utilizzando le routine a multipla precisione "BIGNUM"; si ottengono così gli stessi risultati della macchina originale.

• Agosto 2010: Oltre a migliorie varie introdotta la funzione Timer per avere anche i tempi di esecuzione della P101 reale.

• Agosto 2013: Prima versione a 32/64 bit con QB64

• Ottobre 2014: Rivista la gestione del mouse (sia a 16 bit che a 32/64) e passaggio sul nuovo sito - questa pagina ha subito nel tempo estensioni e miglioramenti.

• Marzo 2015: Penultima versione aggiornata poi anche a Novembre dello stesso anno.

• Settembre/Ottobre 2017: Revisione completa del codice con ulteriori correzioni e miglioramenti (tra i quali una schermata introduttiva e l'uso dei suoni nella versione a 32/64 bit); inoltre la versione a 16 bit è stata ricompilata con Microsoft BASIC PDS 7.1 mentre quella a 32/64 bit con QB64 1.1. Aggiunto pure P101TOQB64 a 32/64 bit.

• Gennaio 2019: Grazie alla segnalazione di un utente via mail, corretto un errore dell'emulatore (non veniva controllato l'overflow nell'addizione). Ricompilata la versione a 32/64 bit con QB64 1.2.

• Luglio 2023: Ricompilata la versione a 32/64 bit con QB64 1.5.

Download, Installazione ed Esecuzione

   Download

(15/01/2019) - entrambe le versioni a 16 bit e 32/64 bit:  P101Emul.rar

(27/11/2017) - manuale dell'emulatore:  Manuale P101Emul.pdf 

(20/07/2023) - versione a 32/64 bit ricompilata con QB64 v 1.5:  P101EXE64.rar

Installazione - Per l'installazione è sufficiente scompattare il file di cui sopra nella radice di una qualsiasi unità - disco fisso o chiavetta USB. La situazione delle cartelle sarà la seguente:

C:\>tree p101
Elenco del percorso delle cartelle per il volume ACER
Numero di serie del volume: 1CE0-B742
C:\P101
├───AMSTERDAM        ◄---- emulatore Univ.di Amsterdam con mia traduzione QuickBasic
├───ANGELA           ◄---- ANGELA GAME (tradotto dalla versione Java sito di Perotto)
│ └───ANGELA GAME (Programma101)_file
├───COMPIL           ◄---- traduttore da P101 a QuickBasic
├───FORM             ◄---- files di "form" per il mouse
├───QUEENS           ◄---- programmi tratti da altri siti
├───SCHEDE           ◄---- file schede magnetiche "virtuali"
└───SCHERMI          ◄---- schermate varie (compresi i file di help)

Esecuzione - Per l'esecuzione basterà lanciare uno dei due eseguibili - a seconda del sistema operativo ospite. Ecco le due schermate: la prima è quella di P101EMUL (a 16 bit - a schermo intero sotto XP)

mentre la seconda è P101EMUL64 (a finestra - sotto Win7 - versione 32/64 bit):

I Sistemi Operativi supportati sono i seguenti:

nome	DOS 6.x	Windows 9.x	Windows XP	Windows 7/8/10 32 bit	Windows 7/8/10 64 bit
P101EMUL	(schermo intero)	(finestra e schermo intero)	(finestra e schermo intero)	(solo finestra)	solo in virtualizzazione  (ad  esempio DosBox).
P101EMUL64	no	no

Lo stesso vale per le versioni P101TOQB e P101TOQB64 del programma traduttore. Come indicato P101EMUL funziona anche a 64 bit usando un software di virtualizzazione; senza ricorrere ad applicazioni pesanti - tipo VM Player o Virtual PC - il buon DosBox 0.74 sarà più che sufficiente. Basterà montare il disco di installazione di P101EMUL con una istruzione mount e poi si va: una sola avvertenza, dovrà essere disponibile l'applicazione EDIT a 16 bit per poter accedere ad alcune funzioni del menù    Controllo     .

Nota: In alcune configurazioni (usando P101EMUL in una finestra) la palette dei colori potrebbe non essere applicata correttamente a causa dei driver della scheda video, cosicché i colori risulteranno sfalsati. Si consiglia di utilizzare la versione a 32/64 bit.

Note sull'Emulatore

L'utilizzo dell'emulatore, nelle fasi iniziali, è uguale a quello della macchina reale: si accende la P101 (si lancia il programma di emulazione) e la luce rossa si accende, si preme (si clicca) il tasto di "General Reset" così da inizializzare il tutto, la luce rossa si spegne e si è pronti.

Un piccolo esempio .....

Lanciamo l'emulatore, premiamo su  General Reset  per preparare la P101, attiviamo il menù    Controllo       e scegliamo la voce  Usa scheda magn.    

Impostiamo il numero di scheda 136 cliccando sul piccolo tastierino numerico a destra e confermando con OK. (CE cancella l'ultima cifra impostata). La "scheda magnetica" viene trasferita in memoria.

Cliccando sullo switch PRINT (che passa da OFF a ON) e premendo  *  e poi  ♦  otteniamo il listato del programma (sulla macchina reale non vengono stampati i passi di programma)

A questo punto clicchiamo sullo switch PRINT (che passa da ON a OFF) e siamo pronti per una esecuzione di prova: con la rotella a 2 decimali si preme   V   poi le cifre 1 2 e successivamente   S  . L'elaborazione si ferma con un errore di "overflow" (luce rossa accesa)

Tramite la voce   Vedi Nastro    del menù    Controllo      possiamo vedere il risultato completo dell'elaborazione (si noti in basso a destra il Timer in secondi: sulla macchina reale questa esecuzione dovrebbe durare quindi circa 20 secondi....)

e possiamo confrontarlo con quello della macchina reale (che, ahimè, non possiedo.......)

Come già detto, con   CLEAR si azzera l'errore e si riparte: ovviamente OFF "spegne" la macchina. Nel nostro caso, dopo aver premuto   CLEAR, la situazione dei registri è la seguente (dalla voce   Registri     del menù    Controllo     ):

Dove parlano di noi