CPCSyntaxError v0.13.0
Questa versione aggiunge la scheda Albireo, il supporto a CPCtelera_next 1.04a nella finestra C e il RASM originale dal relativo GitHub. Include inoltre correzioni per CRTC e Plus evidenziate dalle schermate di test SHAKER e da una demo Plus.
Albireo (CH376: scheda SD e USB)
Espansioni > Albireo permette di alloggiare una o due schede Albireo. Ciascuna scheda dispone di un chip CH376 con uno slot per schede SD e una porta USB.
- La Scheda 1 si trova all’indirizzo &FE80. La Scheda 2 all’indirizzo &FE40 (la scheda con JP2/JP3 tagliati).
- La scheda SD corrisponde a una cartella sul tuo PC. Il CPC la rileva come un disco FAT16. Ciò che il CPC scrive viene salvato all’interno della cartella.
- La porta USB può non avere dispositivi collegati, avere una chiavetta USB (una cartella, interpretata come disco FAT16) o un mouse USB (il mouse del tuo PC, per SymbOS e FutureOS).
- UniDOS, con il suo nodo Albireo, riconosce la scheda all’avvio. SAVE e LOAD funzionano correttamente sulla scheda.
- Da riga di comando:
--albireo <cartella>, --albireo-usb <cartella|mouse|none>, --albireo2 <cartella> e --albireo2-usb <cartella|mouse|none>. Usa - per una scheda senza SD.
Non emulati: la UART e la linea di interrupt di altre versioni della scheda. Il software deve eseguire il polling del chip, come su Albireo 2.0.
Programmi in C (CPCtelera)
CPCtelera_next 1.04a ( GitHub - Arnaud6128/cpctelera: Astonishingly fast Amstrad CPC game engine for C developers · GitHub , ramo cpctelera_next) compila ora tutti i suoi 60 esempi senza bisogno di Cygwin. I nuovi passaggi per gli asset sono:
- AKS2DATA utilizza i convertitori di Arkos Tracker 3 per il tuo sistema operativo (Windows, Linux o macOS). I vecchi convertitori fungono da fallback.
- PACKRLEWB comprime i dati con l’algoritmo RLE-WB.
- IMG2SP CONVERT_PALETTE_PLUS scrive una tavolozza Plus (valori RGB a 12 bit).
- IMG2SP SET_PALETTE_PLUS imposta la tavolozza come colori RGB. Il convertitore di immagini adatta ogni pixel a questi colori.
- IMG2SP SET_IMG_FORMAT spritehardware genera sprite hardware per Plus: 16 x 16 pixel, un pen per ogni byte, senza maschere.
Altre modifiche:
- AKS2C supporta i progetti per la versione precedente CPCtelera 1.4.
- Quando SDCC 4.6 si arresta a causa di un errore interno nella propagazione delle costanti (constant propagation), la build ricompila il file interessato con
--nogenconstprop.
- La cache della libreria e i file temporanei della build risiedono ora nella cartella
cache accanto al programma (oppure sotto CPCSE_HOME), anziché nella directory temporanea di sistema.
- La finestra C è ora una finestra separata, posizionata a fianco di quella dell’assembler.
Assembler: RASM dal suo GitHub
RASM corrisponde ora all’originale (EdouardBerge/rasm, commit 0e25710), privo di nostre modifiche proprietarie.
- L’opzione WinAPE offre adesso le opzioni native di RASM:
& funge da prefisso esadecimale e le espressioni funzionano come in Maxam. RASM gestisce nativamente le seguenti direttive WinAPE: BRK, LIST, NOLIST, LET, CHARSET, RELOCATE_START, RELOCATE_END e RELOCATE_TABLE.
- Le nostre estensioni a WinAPE sono state rimosse:
BYTE, TEXT, WORD, RMEM, DEFL, END, WRITE, SAVE, CHECKSUM, memory() e RUN address,breakpoint.
- L’etichetta
BRK imposta un punto di interruzione (breakpoint) nel debugger.
Correzioni CRTC
- Protezione VSYNC (tutti i CRTC): il blocco su un nuovo VSYNC viene rimosso solo quando un incremento di C4 durante il VSYNC modifica l’uguaglianza C4=R7 rispetto al valore di R7 in quel preciso istante (ACCC §16.3).
- CRTC 0, R0=0: finché i contatori rimangono bloccati, il conflitto R6 sulla prima riga e il ripristino del display su C4=C9=0 non vengono applicati (ACCC §13.2.4).
- CRTC 0, interlacciamento: la parità di C9 cambia al termine di ciascuna riga quando R9 è dispari, qualunque sia il valore di R8.
- CRTC 2: una scrittura su R7 attiva un VSYNC «fantasma» solo all’interno dell’impulso HSYNC stesso.
- CRTC 3 e 4: ora condividono la medesima regola di avvio del VSYNC.
- Fine ritardata di HSYNC (ACCC §27.7.2): il numero di cicli di clock di inattività (idle T-states) che lasciano passare l’interrupt è ora definito per ciascun CRTC (CRTC 0 e 2: 2, CRTC 1: 0, CRTC 3 e 4: mai).
Correzioni Plus (ASIC)
- PRI (interrupt raster programmabile): l’ASIC ora lo attiva 1 microsecondo dopo il termine dell’HSYNC del Gate Array, in accordo con ACCC §27.6.1 e §27.6.5. L’effetto plasma della demo RE-WIRED copre ora lo schermo fino al bordo destro.
SYMBiFACE III
- La tabella delle ROM sulla scheda SD (
CPC\ROMTABLE\BANKnnn) funziona con il gestore ROM SF3-RM.BAS di TMTLOGIC: le ROM attualmente installate, lettura e salvataggio di una ROM, nomi delle ROM, banchi e banco di avvio.
- Il comando
|SROM della ROM SF3-RSX carica immediatamente una ROM in uno slot.
Uscita MIDI
- macOS: il segnale MIDI viene instradato verso il sintetizzatore software di Apple.
- Linux: il MIDI viene inviato a una porta sequencer ALSA «CPCSyntaxError», collegata al primo sintetizzatore disponibile (ad esempio FluidSynth o TiMidity). Il programma funziona anche senza libasound.
CPCSyntaxError v0.13.1
Questa versione introduce il collegamento seriale per la scheda Albireo 1.1 e implementa l’ultimo comando CH376 finora non emulato.
Albireo 1.1: il collegamento seriale
Le schede Albireo 1.0 e 1.1 integrano una UART (un SC16C650B) provvista di interfaccia seriale USB per il collegamento con un altro computer. Albireo 2.0 non dispone di UART.
Per installarla, spunta Serial link (Albireo 1.1) sotto Albireo 1 in Espansioni.
-
La UART si trova a &FEB0-&FEB7. Dispone di FIFO a 32 byte, controllo di flusso hardware (RTS/CTS) e software (Xon/Xoff) automatico, oltre a una modalità loopback. Opera a una frequenza di 24 MHz, consentendo alla linea di raggiungere una velocità di 1,5 Mbaud.
-
L’estremità remota può essere configurata come:
- nessuna
- una porta sul tuo PC a cui si connette un altro programma
- una connessione verso host:porta
- una porta seriale del tuo PC
- un connettore di loopback
Per i programmi su PC che accedono a una porta COM, si consiglia l’uso di una coppia di porte seriali virtuali (ad esempio com0com).
-
Interrupt: la UART inoltra l’interrupt a INT del CPC se il bit 2 di MCR vale 0, e a NMI se il bit 3 di MCR vale 0. Possono generare interrupt anche queste sorgenti:
- il segnale CURSOR del CRTC
- il CH376
- la linea DTR dell’estremità remota
-
Interruttori DIP (DIP switches):
- S1 lascia passare l’interrupt del CH376.
- S2 ripristina (reset) il CH376 contestualmente al CPC.
- S3 consente all’estremità remota di resettare il CPC.
- S4 fa sì che la linea DTR dell’estremità remota generi un interrupt.
-
Da riga di comando: --albireo-serial <linea> (tcp:host:porta, listen:porta, com:COM3, loopback o -) e --albireo-switches 1100 (da S1 a S4).
Il programma di test fornito nel manuale di Albireo (16c650.bas) funziona correttamente. Con un connettore di loopback inserito, riceve in ingresso tutti i byte trasmessi.
CH376: DISK_BOC_CMD
Il chip CH376 gestisce ora il comando 50H, utilizzato per inoltrare comandi SCSI a una chiavetta USB: INQUIRY, READ CAPACITY, TEST UNIT READY, REQUEST SENSE, MODE SENSE, START STOP e READ/WRITE (10) senza blocchi. Come sul chip reale, l’operazione restituisce un errore se eseguita sulla scheda SD.
Compilazione
- Il pacchetto macOS viene nuovamente generato in automatico a ogni rilascio di tag di versione. L’arresto da parte di GitHub della macchina di compilazione
macos-14 aveva impedito il completamento della build automatica per la v0.13.0; i pacchetti di quest’ultima sono stati ottenuti da una compilazione successiva del medesimo codice sorgente.