Chapter 10. Apple

10.1. cpKermit sull'Apple II

Igor

Questo e' il procedimento che ho utilizzato per riuscire a far girare kermit-80 sull' AppleII e mi riferisco quindi a coloro che hanno una configurazione simile alla mia: AppleIIe con seriale e scheda z-80; PC con Windows, ADT e un programma tipo FishWings per creare dishi immagini (.dsk) per l'AppleII. Sicuramente qualcosa di simile puo' essere fatto anche con il Mac ma non so come.

Iniziamo... Innanzitutto occorre scaricare i file del Kermit-80 per CP/M (cpKermit) dal sito ftp della Columbia University (di cui non ricordo l'url ma e' sufficente una ricerca con Google per trovarlo). I file in questione sono tre e tutti di tipo .HEX (binari trasformati in esadecimale, quindi testo ASCII):

  • I due moduli del Kermit: il "system-independent module" che e' uguale per tutti i sistemi cp/m e si chiama CPSKER.HEX e il modulo "system-dependent" CPVAPL.HEX (valido per AppleII con super-serial card o Apple//c, altrimenti dovete consultare la guida sul sito ftp per trovare il file che corrisponde alla vostra configurazione).

  • Il file MLOAD.HEX (una utility che permettera' di unire i due moduli e convertirli in eseguibile all'interno del cp/m).

Consiglio inoltre di scaricare la guida del Kermit-80 (o cpkermit), sempre sul sito.

Quando questi file saranno trasferiti sull'AppleII si utilizzera' una utility dell'AppleII CP/M chiamata APDOS che permette il passaggio Apple dos3.3 -> cp/m. Purtroppo pare che APDOS si blocchi con file troppo grandi, come appunto CPSKER.HEX. Occorre quindi dividere questo file in due parti. Si puo' fare con un normale editor di testi (io ho usato il Notepad di Windows e ho chiamato le due parti: CPSKER1.HEX e CPSKER2.hex). Conviene fare questo prima di trasferire i file sull'Apple.

Il prossimo passo consiste nel portare i file dal PC all'Apple. Se si dispone sull'AppleII di un protocollo di trasmissione e/o emulazione di terminale si possono seguire le indicazioni riportate all'interno della guida del cpkermit. Per quelli che invece utilizzano ADT occorrera' creare un'immagine .dsk sul PC (immagine .dsk di 143k in *dos order*) ad es. con FishWings (ma ci sono anche altri programmi che lo fanno), importare i file .hex all'interno dell'immagine (con FishWings e' un'operazione abbastanza intuitiva) e poi trasferire l'immagine sull'Apple con ADT. Notare che FishWings importa i file in Prodos (anche se l'ordine dei settori e' quello del dos3.3). In seguito, per permettere ad APDOS di vedere i file occorrera' copiarli su un disco dos3.3 .

A questo punto si fa il boot dell'AppleII con il cp/m, avviare APDOS e trasferire i file su un disco cp/m. Ad esempio, al prompt di APDOS immettere:

d1:MLOAD.HEX=d2:MLOAD.HEX
per trasferire il file MLOAD. (d1 e d2 sono rispettivamente il disco di destinazione e quello di partenza)

Ripetere l'operazione con tutti i file da trasferire, dopodiche' uscire da APDOS (control-c mi pare).

Ora si hanno tutti i file all'interno del cp/m. Occorre innanzitutto riunire il file CPSKER con il comando PIP:

PIP d1:CPSKER.HEX=d2:CPSKER1.HEX[O],CPSKER2.HEX

Il parametro [O] serve ad evitare che PIP cerchi il segnale di "end-of-file" (che si trova alla fine di CPSKER2.HEX), altrimenti si avrebbe un errore del tipo: "premature end of file" (o qualcosa del genere).

A questo punto si utilizza il programma LOAD.COM (Io l'ho trovato in tutti i dischi di sistema cp/m per l'AppleII) per convertire in binario MLOAD.HEX:

LOAD d1:MLOAD.HEX
e si ottiene il file MLOAD.COM .

Infine, con MLOAD, si uniscono e convertono i due moduli del Kermit:

MLOAD KERMIT=CPSKER.HEX,CPVAPL.HEX
(l'ordine dei file e' importante).

Il risultato e' un file KERMIT.COM eseguibile!