ZX ROM

Z PMD 85 Infoserver

ZX ROM
Autor:	Busy soft
Verzia:	ZXROM01, v01 (2016) (PMD 85-1,2,2A,3)
Lokalizácia:	angličtina
Download:	zxrom01.zip

ZXrom01 je štandardná ROMka zo ZX Spektra 16/48k preportovaná na platformu PMD 85. Po platformách C64 a Ondra si takto už aj na PMD 85 môžete užívať výhody skvelého ZX Spektrum basicu. :)

ROMka je zároveň doplnená o jednoduchú funkcionalitu, ktorej cieľom je zjednodušiť import a export programov z/do okolitého sveta.

Spustenie (ako si ROMku spustiť aby sa s ňou dalo pracovať)

ZX ROMka je distribuovaná ako klasický TAP súbor zxrom01.ptp alebo čistá binárka ZXrom01.cod bez akýchkoľvek hlavičiek. Z PTP súboru sa ROMka nahraje do pamäti klasiky pomocou MGLD 00, súbor COD treba nahrať do pamäti od adresy 0. Spustenie je pomocou príkazu JUMP 0000 alebo stlačením Shift+DEL.

Hardvérové odlišnosti (popis odlišností kvôli inému hardwéru PMD 85)

Vzhľadom na HW rozdiely medzi PMD 85 a ZX Spektrom, sú v porte ROMky nasledujúce odlišnosti:

• Atribútové kolízie - Vzhľadom na 6-bodovú šírku atribútu na PMD 85 sa môže stať, že sa farbou použitou v danom znaku môžu zafarbiť aj časti susedných znakov.
• Farby v atribúte - Keďže jednou z dvoch farieb, ktoré PMD 85 môže zobraziť v jednom atribúte, musí byť čierna, nie je možné mať naraz PAPER aj INK rôzny od čiernej. Buď je INK čierny a PAPER môže byť inej farby, alebo PAPER čierny a INK iný. Ktorý bude natvrdo čierny, závisí od aktivácie inverzného režimu (pozri ďalej).
• S farbami súvisí aj BRIGHT a FLASH - tieto príkazy sú ignorované a na výslednom obraze sa nijak neprejavia.
• S inou HW realizáciou farieb súvisí aj odlišná činnosť funkcie ATTR(a,b). Táto funkcia by mala vracať hodnotu ZX atribútu, avšak vzhľadom na inú organizáciu PMD 85 videoramky, nie je možné vrátiť presnú hodnotu atribútu podľa toho aký PAPER/INK/BRIGHT/FLASH obsahuje. Hodnota atribútu je len približná - vždy je buď INK alebo PAPER nulový (podľa zvoleného režimu zobrazovania). BRIGHT a FLASH (bity 6 a 7) sa vracajú vždy nulové.

Implementačné odlišnosti (čo bolo naprogramované odlišne a funguje inak)

• ZX Printer bol úplne zrušený. Preto už nefunguje výpis 8x vyššieho písma pomocou POKE 23681,x.
• Vzhľadom na zmenený kód v ROMke, nemusia správne fungovať úsporné formy zápisu čísel založené na funkcii PEEK, kde adresa pre PEEK je väčšia ako 7.
• Taktiež vzhľadom na zmenený (a tým aj poposúvaný) kód, už neplatia žiadne štandardne používané vstupné body pre funkciu USR. Napríklad klasické zistenie voľného miesta PRINT 65535-USR 7962. Ak chcete zistiť voľné miesto v BASICu, môžete použiť príkaz PRINT USR 45.

Konfiguračný blok (ako si ROMku pred spustením nakonfigurovať)

V binárnom súbore ROMky ZXrom01.cod (resp. v pamäti), sa od offsetu +12 nachádza blok o dĺžke 4 bajty, ktorý slúži na užívateľskú konfiguráciu ROMky:

• +12 ... Nastavenie režimov činnosti (pozri nasledujúcu časť) (defaultne: 0Fh)
• +13 ... Vyšší bajt adresy, od ktorej už ROMka nepoužíva pamäť (defaultne: 0C0h)
• +14 ... Rezerva
• +15 ... Rezerva

Tieto štyri bajty si užívateľ môže priamo v súbore ROMky prednastaviť na požadované hodnoty. Keď potom súbor s ROMkou nahrá do PMD 85 a spustí, ROMka bude pracovať podľa týchto užívateľom zvolených nastavení.

Nastavenie režimov činnosti na offsete +12 špecifikuje, ako bude ROMka zobrazovať farby a ako sa budú v pamäti mapovať ZX videoramka a systémové premenné basicu. Presný popis je v nasledujúcej kapitole.

Pomocou vyššieho bajtu adresy na offsete +13 sa ROMke určuje horná hranica pamäte, ktorú môže pre BASIC použiť. V skutočnosti je to iba limit, po ktorý ide úvodný test pamäte pri jej testovaní. Štandardne je tu hodnota 0C0h, čo je začiatok videoramky a znamená to, že ROMka môže používať celú dostupnú RAMku až do adresy 0BFFFh.

Príklad: Ak ROMku spúšťame pomocou programu RUNNER, ktorý sa nahráva od adresy 9C00h a chceme, aby po spustení RUNNERa ostal v pamäti k dispozícii, nastavíme bajt na offsete +13 na hodnotu 9Ch. Tým pádom bude ROMka využívať iba pamäť po adresu 9BFFh a RUNNER zostane nepoškodený.

Poznámka: Tento limit používanej pamäte sa nevzťahuje na príkaz POKE. Príkazom POKE teda možno modifikovať pamäť aj nad touto adresou. Napríklad, dá sa priamo zapisovať do PMD 85 videoramky.

Režimy činnosti (popis základných užívateľských nastavení ROMky)

ZXrom01 má niekoľko režimov činnosti. Po spustení ROMky sa režimy nastavia podľa aktuálnej hodnoty bajtu na offsete +12 v konfiguračnom bloku (pozri vyššie). Tieto režimy je možné meniť priamo z basicu pomocou príkazu OUT 256,X, kde X je nová hodnota bajtu na offsete +12.

Jednotlivé bity hodnoty majú nasledujúci význam:

• Bit.0 - Inverzný režim - 0:vypnutý 1:zapnutý
• Bit.1 - Použitie ColorACE farieb - 0:nie 1:áno
• Bit.2 - Virtuálne mapovanie systémových premenných basicu - 0:nie 1:áno
• Bit.3 - Virtuálne mapovanie videoramky a print buffera 4000h-5BFFh - 0:nie 1:áno

Aký režim je aktuálne nastavený, sa dá zistiť pomocou funkcie IN 256. Ďalej nasleduje podrobnejšie vysvetlenie jednotlivých režimov.

Bit.0 ... Inverzný režim

ZX Spectrum defaultné zobrazuje čierne písmo na svetlom podklade. Naproti tomu u PMD 85 je zvykom mať svetlé písmo na čiernom podklade. Dalo by sa napísať, že tento filozofický rozpor rieši inverzný režim.

Inverzný režim určuje, či sa defaultne bude zobrazovať tmavá kresba (INK) na svetlom podklade (PAPER) alebo svetlá kresba na tmavom podklade. V prípade, že je povolené používanie farieb (viď Bit.1), svetlá farba sa dá nastaviť na jednu zo štandardných ZX farieb od 1 (tmavomodrá) až do 7 (biela).

• Bit.0 = 0 ... svetlé písmo na tmavom pozadí. PAPER je vždy 0, INK je od 1 do 7.
• Bit.0 = 1 ... tmavé písmo na svetlom pozadí. INK je vždy 0, PAPER je od 1 do 7.

V prípade, ak niečo (PAPER alebo INK) môže mať hodnoty farieb od 1 do 7, pri jeho nastavení na čiernu farbu (0) bude zobrazená tmavomodrá farba (1).

Bit.1 ... Použitie ColorACE farieb

V prípade že máte RGB výstup (zelená, červená, modrá, fialová) alebo ideálne ColorACE, nastavte tento Bit na 1 a môžete využívať všetkých osem farieb ZX Spektra.

Ak ale máte iba monochromatický výstup, nastavte tento Bit na 0 a potom čierna farba (0) bude zobrazená ako tmavá a všetky ostatné farby (1 až 7) ako svetlá farba. Príkazy PAPER aj INK budú v tomto režime ignorované.

Bit.2 ... Virtuálne mapovanie systémových premenných BASICu

V BASICových programoch bývajú často POKE do systémových premenných (sysvars). Vzhľadom na to, že sysvars sú umiestnené v pamäti inde (viď pamäťový model nižšie), je možné zapnúť tzv. virtuálne mapovanie. Po zapnutí tohto režimu (Bit.2=1), budú sysvars v príkazoch POKE a PEEK viditeľné na svojich obvyklých a známych adresách od 23552 presne tak, ako na ZX Spektre. Mapovanie platí pre 256 bajtov na adresách 23552-23807, takže je tu vidno aj začiatok BASICu - môže to byť užitočné napr. keď chcete pomocou POKE vytvoriť nultý riadok, alebo niečo uložiť za REM.

V prípade, že máte v pamäti svoje dáta, ktoré si spravujete z BASICu pomocou POKE, a ktoré práve zasahujú do týchto 256-tich bajtov, nastavením Bit.2=0 virtuálne mapovanie vypnite a potom POKE/PEEK do oblasti od 23552 budú normálne pracovať s vašimi dátami.

Bit.3 ... Virtuálne mapovanie videoramky a print buffera 4000h-5BFFh

V BASICových programoch sa okrem POKE do systémových premenných sem-tam vyskytnú aj POKE do oblasti videoramky 4000h-5AFFh a ZX printer buffera 5B00h-5BFFh. Keďže PMD 85 má videoramku inde, takéto POKE by sa v obraze nielenže nijak neprejavilo, ale dokonca by mohlo byť nebezpečné, ak by sa práve strafilo do oblasti, kde reálne ležia systémové premenné a BASIC program. Preto bolo zavedené virtuálne mapovanie videoramky a ZX Printer buffera, ktoré toto ošetruje.

Pri zapnutom virtuálnom mapovaní (Bit.3=1) sa v príkazoch POKE a PEEK všetky adresy do týchto oblastí odchytia a spracujú nasledujúcim spôsobom:

• 4000h-57FFh - Pixelová časť videoramky: Všetky POKE sa prepočítajú na osmice pixelov a zapíšu do videoramky PMD 85 tak, aby obraz bol presne taký istý, ako na ZX Spektre. Pri čítaní hodnôt pomocou PEEK sa vezmú údaje z videoramky PMD 85 a spätne prepočítajú tak, aby funkcia PEEK vrátila presne takú istú hodnotu, ako by vrátila na ZX Spektre. To znamená, že čo do pixelov príkazom POKE zapíšete, to tam uvidíte a to odtiaľ aj funkciou PEEK načítate.

• 5800h-5AFFh - Atribútová časť videoramky: POKE do atribútov funguje presne tak isto ako nastavenie farieb v atribútoch pri výpise znaku. Vzhľadom na iný hardvér tu platia dva nasledujúce rozdiely (viď úvodná časť Hardvérové odlišnosti):
  • okrem samotného meneného atribútu sa môžu zmeniť farby aj v susedných atribútoch
  • v normálnom režime sa dá nastaviť len INK, v inverznom len PAPER

V prípade, že nie je povolené použitie ColorACE farieb (Bit.1=0), všetky zápisy do atribútov su ignorované.

Pri čítaní atribútu funkciou PEEK, vzhľadom na spomenuté HW odlišnosti, žiaľ, nie je možné zrekonštruovať pôvodnú hodnotu, ktorá bola do atribútu zapísaná. Funkcia PEEK preto vráti hodnotu, ktorá obsahuje nenulový INK (normálny režim) alebo nenulový PAPER (inverzný režim). Všetky ostatné farby sú v hodnote nulové. Presne týmto istým spôsobom pracuje aj funkcia ATTR(a,b).

• 5B00h-5BFFh - ZX Printer buffer: V aktuálnej verzii ROMky nie je podporovaný, to znamená, že akékoľvek POKE do tejto oblasti je ignorované a akýkoľvek PEEK z tejto oblasti vráti natvrdo nulu.

Poznámka: Niektoré samomodifikujúce sa BASICové programy si môžu čítaním systémovej premennej PROG (23635) zisťovať, kde práve ležia a od tejto adresy sa modifikovať pomocou POKE. Keďže BASIC v tejto preportovanej ROMke na PMD 85 začína na nižších adresách, ako na ZX Spektre (viď pamäťový model nižšie), môže sa stať, že sa takéto samomodifikačné POKE strafí práve do mapovaného priestoru 4000h-5BFFh. V takomto prípade sa odporúča virtuálne mapovanie videoramky vypnúť, aby sa BASIC mohol zmodifikovať ako potrebuje.

Klávesnica (mapovanie klávesnice ZX Spektra na klávesy PMD 85)

ZX Spektrum (gumák) má 40 klávesov, Plusko (Delta, 128...) má pre pohodlnejšie písanie až 58 klávesov, avšak PMD 85 má až 77 klávesov! Vďaka tomu je písanie na PMD 85 častokrát ešte pohodlnejšie, než na plusku. :)

Shifty

ZX Spektrum má dva Shifty - Caps Shift a Symbol Shift. PMD 85 má síce iba jeden Shift, avšak je tu kláves STOP, ktorý na modeloch 2A a 3 slúži ako druhý pomocný Shift pre špeciálne účely. Preto základný Shift slúži ako Caps Shift a STOP ako Symbol Shift.

Gumák

Základná klávesnica ZX Spektra sa skladá z 26 písmen, 10 číslic, medzery, Enteru a dvoch Shiftov (na PMD 85 je to Shift a STOP). Týchto 40 klávesov funguje PRESNE tak isto, ako klávesy na ZX Spektre. Tým pádom, každý kto vie / je zvyknutý písať na gumákovej klávesnici, už vie automaticky čokoľvek napísať aj na PMD 85 a všetky ďalšie informácie o klávesnici môže (ak chce) kľudne preskočiť ... :)

Plusko

Kto je zvyknutý na pluskovú klávesnicu, môže využiť ďalšie klávesy pre uľahčenie písania - edit, šípky všetkými štyrmi smermi, klávesy pre zmeny režimov (Caps lock, Extend mód, Graph), a rôzne symboly ako bodka, čiarka, bodkočiarka... Úplný zoznam všetkých klávesov a ich mapovanie je uvedené v tabuľke nižšie.

Klávesy so symbolmi

Napravo od písmen a číslic sa nachádza zopár klávesov so symbolmi, samozrejme aj tieto fungujú a môžete pomocou nich písať symboly, ktoré sú na nich zobrazené. A to dokonca aj symboly \ [ ], ktoré sa normálne píšu cez Extend mód. Prázdny kláves na PMD85-1 (na ďalších PMD 85 sú to zložené zátvorky), slúži ako Caps lock.

Kľúče K0-K11

Aby sa vám ešte ľahšie písalo, môžete použiť kľúčové klávesy K0-K11. K dispozícii máte 24 kľúčov (prvých 12 bez Shiftu a ďalších 12 so Shiftom), do každého kľúča si môžete uložiť ľubovoľný znak alebo príkaz, a stlačením kľúča sa tento znak napíše. Typický príklad: Chcete často používať príkaz OUT, ale nechce sa vám ho zakaždým zložito vypisovať cez Extend mód a Symbol Shift. Keď si príkaz OUT zadefinujete do nejakého kľúča, stlačením tohto kľúča sa vám príkaz vypíše, a to dokonca bez nutnosti predtým použiť Extend mód.

Definovanie obsahu kľúčov

Na rozdiel od PMD 85, obsah sa do kľúčov nezapisuje klávesom WRK, ale na toto teraz slúži kláves STOP. Ak stlačíte STOP, držíte ho stlačený, a stlačíte niektorý z kľúčov (so Shiftom alebo bez) tak sa znak, nachádzajúci sa v editačnej zóne bezprostredne pred kurzorom, zapíše do tohto kľúča. Na dôkaz, že sa znak do kľúča úspešne zapísal, sa tento znak vypíše tak isto, ako keby ste daný kľúč normálne stlačili.

Alternatívny spôsob definovania obsahu kľúčov je pomocou príkazu POKE. Keď spravíte: POKE 100+číslo_kľúča,kód_znaku, tak sa do daného kľúča zapíše zvolený znak. Čísla kľúčov sú 0 až 11 pre kľúče bez Shiftu a 12 až 23 pre kľúče so Shiftom. Výhodou tohto alternatívneho spôsobu je, že do kľúčov si môžete zadefinovať úplne akýkoľvek znak vrátane riadiacich, napríklad delete, enter, edit...

Analogicky funkcia PEEK (100+číslo_kľúča) vráti kód znaku v danom kľúči.

Oficiálne distribuovaná verzia ROMky má v sebe kľúče preddefinované takto:

Číslo kľúča:  K0   K1  K2  K3   K4   K5      K6      K7  K8   K9   K10  K11
 Bez shiftu:  BEEP OUT IN  LINE OVER INVERSE CIRCLE  {   }    ~    |    (c)
 So shiftom:  PEEK LEN INT ABS  ŠGN  SQR     RND     VAL STR$ CHR$ CODE INKEY$

Mapovanie klávesnice

Nasleduje prehľadná tabuľka mapovania všetkých kláves PMD85 na klávesy ZX Spektra:

Klávesy =-  ^\  +;  *:  []  <,  >.  ?/  `@ píšu dané znaky (bez/so Shiftom).

Dôležitá poznámka k funkcii INKEY$. Táto funkcia vracia iba tie znaky, ktoré dokáže vrátiť aj na ZX Spektre. To znamená, že pomocou nej nie je možné testovať znaky \ [ ], ktoré sa normálne musia písať cez Externd mód. Tak isto funkcia INKEY$ nevracia ani obsah kľúčov.

Stlačenie klávesu END pri písaní riadku/príkazu/v INPUTe spôsobí výpis medzery. Toto je normálne správanie prevzaté zo ZX Spektra, kde kláves Break predstavuje kombináciu Caps shift + Space.

Pamäťový model (ako a kde ROMka obsadzuje a využíva pamäť PMD 85)

Táto časť popisuje, ako sú rozmiestnené objekty po pamäti PMD 85.

Od začiatku RAMky (adresa 0) leží samotná modifikovaná ROMka. ROMka zaberá cca 19 kB pamäti (podľa čísla aktuálnej verzie).

Hneď za ROMkou nasleduje 2 kB tabuľka pre akceleráciu prístupu do PMD 85 videoramky. Používa sa pre rýchle vykresľovanie grafiky - výpis znakov na obrazovke v príkaze PRINT a pre grafické príkazy a funkcie PLOT, DRAW, CIRCLE, POINT.

Potom nasleduje pamäť pre BASIC systém tak, ako na ZX Spektre, t.j. systémové premenné, BASIC program, premenné BASICu, editačné buffery, voľné miesto a zásobníky, RAMTOP, UDG, PRAMT.

Systémová premenná PRAMT predstavuje koniec pamäti využiteľnej pre užívateľa. Je to vlastne adresa, ktorú test pamäti pri úvodnej inicializácii vyhodnotil ako poslednú použiteľnú. Môže to byť buď posledný bajt RAMky pred začiatkom ROM monitora na 8000h, alebo pred adresou definovanou v konfiguračnom bloku na offsete +13.

Pre defaultnú hodnotu 0C0h bajtu na offsete +13 sa PRAMT pri studenom štarte inicializuje nasledovne:

• PMD 85 modely bez ALL-RAM režimu: 7FFFh
• PMD 85 modely s ALL-RAM režimom: 0BFFFh

Užitočné volania (rôzne užitočné adresy pre volanie pomocou USR)

Rôzne volania využiteľné pre USR alebo pri volaní z ROM Monitora.

• 0 ... Studený štart ROMky (ako na ZX). Všetko od sysvars vymaže a inicializuje.
• 5 ... Teplý štart ROMky. Nemaže BASIC a jeho premenné, zachová RAMTOP, UDG, PRAMT.
• 45 ... Vráti aktuálne voľné miesto v BASICU presne ako 65535-USR 7962 na ZX Spektre.

Teplý štart je užitočný vtedy, keď z ROMky vyskočíte do nejakej inej aplikácie (napr. do ROM Monitora pomocou RANDOMIZE USR 32768) a chcete sa vrátiť nazad do ZX ROMky bez zmazania pamäti a BASICového programu. Pri teplom štarte si ROMka znovu (pre istotu) inicalizuje všetky periférie (8255, 8253, prerušenia...).

Poznámka: Ak chcete zavolať ROMkový Monitor a ste v ALL-RAM režime, je postup podobný, ako pri prepínaní pamäťových baniek na ZX Spektre:

1. CLEAR 32767 - presun RAMTOP-u pod adresu, od ktorej sa prepína pamäť
2. OUT 247,9 - vypnutie ALL-RAM režimu a nastránkovanie ROM Monitora
3. PRINT USR 32768 - zavolanie Monitora

Ak je RAMTOP už nastavený pod 32768, tak ho samozrejme meniť netreba.

Informácie o systéme (výpis základných informácií o obsadení pamäti)

Nad rámec pôvodnej funkcionality, táto ROMka umožňuje užívateľovi zobraziť rôzne systémové informácie o obsadení pamäte. Ak užívateľ do dialógového riadku napíše namiesto príkazu otáznik, ROMka vypíše nasledujúce informácie:

• Prg - dĺžka samotného BASICoveho programu bez premenných
• Var - dĺžka všetkých BASICovych premenných (bez BASICu)
• Fre - voľné miesto pre BASIC (od konca dialógového riadku po zásobník)
• Rmt - systémová premenná RAMTOP - nastaviteľná príkazom CLEAR xxxxx
• Udg - systémová premenná UDG - umiestnenie užívateľských grafických znakov
• Top - systémová premenná PRAMT - horná hranica ROMkou použiteľnej pamäte

Znak ? funguje ako normálny regulérny príkaz, je možné ho použiť aj v programe.

Tape emulácia (ako do PMD85 nahrať vlastné programy zo ZX Spektra)

Aby sa dali využiť aj magnetofónové príkazy LOAD / SAVE, resp. aby vôbec bolo možné z vonku nahrať / uložiť nejaký BASIC (a dáta a bajty), je tento port ROMky vybavený maličkým tape emulátorom, ktorý umožňuje navzájom prepojiť štandartný *.TAP súbor zo ZX Spektra (ďalej len 'tapka') s magnetofónovými príkazmi LOAD / SAVE - presne tak isto, ako je to zvykom v (takmer) všetkých emulátoroch ZX Spektra.

Okrem toho ROMka umožňuje špeciálny alternatívny spôsob nahratia a uloženia BASIC programu pomocou príkazov RUN a STOP, vhodný pre prípad, keď je BASIC taký dlhý, že už nezostane dostatok miesta pre tapku.

Ako funguje tape emulátor

Tape emulátor odchytáva všetky volania load rutinky na adrese 0556h a postupne jej "podstrkáva" jednotlivé bloky z tapky. Podobne tak odchytáva volania save rutinky na adrese 04C2h a jednotlivé bloky ukladá na koniec spomenutej tapky.

Samotná tapka musí byť umiestnená priamo v pamäti. Jej nahratie z externého média do pamäti, poprípade jej uloženie z pamäti na externé médium, samotná ROMka nijak nerieši, toto zostáva na starosti samotného užívateľa. Pokiaľ užívateľ pracuje nie na reálnom PMD 85, ale v emulátore, môže využiť napríklad funkciu priameho načítania / uloženia bloku pamäti na disk hostiteľského systému.

Práca s tape emulátorom

Pre riadenie činnosti tape emulátora sú k dispozícii nasledujúce basicové príkazy:

• CAT <číslo>
• COPY <číslo> ... výpis hlavičiek v tapke, voliteľne od N-tej hlavičky.

Príkaz COPY pôvodne slúžil pre vytlačenie obrazovky na ZX printer, avšak keďže ZX printer nie je podporovaný, bol tento príkaz použitý ako alternatíva k príkazu CAT, aby sa užívateľ nemusel trápiť so zložitým písaním CAT-u :)

• MOVE číslo ... nastavenie load kurzora na daný blok (hlavičku), t.j. ktorý blok bude ako ďalší v poradí "podstrčený" load rutinke 0556h.
• ERASE číslo ... vymazanie daného bloku z tapky.

Maže hlavičku a s ňou aj všetky nasledujúce bezhlavičkové bloky až po ďalšiu hlavičku alebo koniec tapky.

• FORMAT adresa,<dĺžka> ... definovanie buffera v pamäti pre uloženie tapky.

Umožňuje užívateľovi nadefinovať miesto, kde v pamäti má byť uložená tapka použitá v tape emulátore a aká môže byť jej maximálna veľkosť. Zadaná adresa musí byť vyššia ako RAMTOP.

Dĺžka je nepovinný parameter. V prípade, že ho užívateľ nezadá, tape emulátor si dĺžku buffera sám nastaví na dĺžku tapky v pamäti.

FORMAT 0,0 prepne na build-in skúšobnú tapku, ktorá je súčasťou ROMky.

Parametre uzavreté v zobákoch < > sú nepovinné, namiesto číselnej hodnoty je samozrejme možné použiť aj akýkoľvek výraz s číselným výsledkom.

Príkazy CAT a COPY najprv vypíšu tieto aktuálne informácie o tape bufferi:

• A:xxxxx ... Adresa, kde začína tape buffer (určená príkazom FORMAT)
• L:xxxxx ... Celková dĺžka tape buffera (určená príkazom FORMAT)
• U:xxxxx ... (Used) koľko z tape buffera je aktuálne obsadené tapkou
• F:xxxxx ... (Free) koľko voľného miesta je v tape bufferi pre SAVE

Následne vypíšu hlavičky v tomto FORMATe:

N>T:Meno     Adresa:Dĺžka

• N ... poradové číslo hlavičky, pre príkazy MOVE, ERASE, CAT, LOAD <číslo> ...
• > ... aktuálna poloha load kurzora, t.j. čo sa bude nahrávať najbližšie
• T ... typ súboru: 0=basic, 1=číselné pole, 2=znakové pole, 3=bajty
• Meno ... vypíšu sa aj tokeny, riadiace kódy pod 32 sa vypíšu ako bodka
• Adresa ... druhý parameter z hlavičky: štartovací riadok, meno premennej, adresa

Rozšírená syntax LOAD príkazov

Tape emulátor prináša aj novú rozšírenú syntax pre príkazy LOAD / MERGE / VERIFY:

PRÍKAZ <číslo> <,> <meno_suboru> ...ďalšie parametre (LINE, CODE... presne ako ZX)

To znamená, že:

• Meno súboru je nepovinné. Nezadané meno súboru predstavuje prázdny reťazec.
• V rámci príkazu je možné nastaviť load kurzor na blok 'číslo', presne ako príkaz MOVE.
• Číslo bloku môže aj nemusí byť od mena oddelené čiarkou.

Prakticky to znamená, že ak váš BASIC, ktorý si chcete nahrať, pri výpise tapky (príkazmi CAT, COPY) vidno pod číslom 5, tak na jeho nahratie stačí zadať LOAD 5.

Akákoľvek podobnosť s MB02 a BSDOS-om je (samozrejme) absolútne čisto náhodná... :-)))

Build-in skúšobná tapka

Súčasťou tape emulátora je kratučká tapka so štyrmi ukážkovými súbormi pre vyskúšanie.

• HelloWorld ... kratučký jednoriadkový BASIC: 9999 PRINT "Hello world !"
• DIM n(4)' ... štvorprvkové číselné pole naplnené rôznymi hodnotami
• DIM t$(12)' ... reťazec o dĺžke 12 znakov s textom "Hello world"
• CODE 49152,16 ... blok bajtov 00 11 22 33 44 55 66 77 88 99 AA BB CC DD EE FF

Jednotlivé súbory je možné vymazať príkazom ERASE a tým získať miesto pre ukladanie príkazom SAVE. Ale ak chcete súbory ukladať, je lepšie si definovať nový vlastný buffer pre tapku - viď nasledujúcu časť.

Ukladanie dát do tapky

Aby ste vôbec mohli niečo ukladať, je potrebné mať v bufferi pre tapku voľné miesto. Voľné miesto pre ukladanie je priestor od konca tapky až po koniec buffera, popr. celý buffer, ak v ňom žiadnu tapku (ešte) nemáte.

Ak v bufferi už máte nejakú tapku, príkaz SAVE pripojí ukladaný blok vždy na koniec tejto tapky. Pred samotným uložením sa ešte skontroluje, či je v bufferi dostatok miesta pre uloženie nového bloku. V prípade, že nie je (a teda tapka by pretiekla), blok sa neuloží a vypíše sa štandardné chybové hlásenie 'Out of memory'.

Koniec tapky a prípadné nasledujúce voľné miesto v bufferi sa pozná podľa nulovej dĺžky nasledujúceho TAP bloku. To znamená, že keď si do pamäti (svojpomocne) nahráte nejakú tapku, a v pamäti za ňou nie sú aspoň dva nulové bajty, je potrebné tieto dva bajty pre istotu vynulovať, aby sa predišlo prípadu, že nasledujúce bajty (ak majú vhodné hodnoty) budú vyhodnotené, ako ďalší platný blok v tapke.

Pri mazaní blokov príkazom ERASE sa dva bajty za novým koncom tapky automaticky vynulujú.

Polopatisticky

Keďže praktický postup je častokrát oveľa lepší, ako teoretické definície, tu je maličký návod, ako nahrať nejaký existujúci program zo sveta, a následne, ako do sveta dostať niečo, čo chceme uložiť príkazom SAVE.

1. Vezmeme *.TAP súbor s našim programom. Povedzme, že súbor je dlhý 2000 bajtov.

2. Nahráme do PMD 85 ZX ROMku a spustíme od adresy 0. Prebehne úvodná inicializácia.

3. Povedzme, že tapku sa rozhodneme v pamäti PMD 85 umiestniť na adresu 30000.

Preto si príkazom CLEAR 29999 nastavíme, aby nám BASIC do tejto oblasti pamäti nijak nezasahoval.

4. Teraz nejakým spôsobom nahráme náš TAP súbor do pamäti na adresu 30000.

Môžeme to urobiť buď v emulátore funkciou na nahratie bloku pamäti, alebo na reálnom PMD 85 môžeme pomocou OUT 247,9 : RANDOMIZE USR 32768 skočiť do Monitora a urobiť to tam. Návrat nazad do ROMky je JUMP 0005.

5. Za tapkou nahranou do pamäti, v našom prípade na adrese 32000, by mali byť aspoň dva nulové bajty. Pokiaľ sme nič veľké predtým nerobili, mali by tam už byť (ZX ROMka pri studenom štarte pamäť nuluje), ale ak nie, tak ich (pre istotu) môžeme vynulovať my príkazmi POKE 32000,0 : POKE 32001,0.

V prípade, že žiadnu tapku z externého zdroja nahrávať nechceme, a chceme mať celý buffer k dispozícii pre SAVE, stačí vynulovať prvé dva bajty buffera (ak už nulové nie sú) príkazmi POKE 30000,0 : POKE 30001,0.

6. A teraz príkazom FORMAT 30000,2500 oznámime tape emulátoru, že od adresy 30000 leží naša tapka, z ktorej má nahrávať bloky, a zároveň mu tým povieme, že za tapkou je až po adresu 32500 voľne miesto, kam tape emulátor môže ukladať bloky, ktoré v budúcnosti uložíme príkazom SAVE.

Týmto máme všetko pripravené a môžeme veselo používať všetky magnetofónové príkazy LOAD SAVE VERIFY MERGE a zároveň pracovať s tapkou príkazmi CAT COPY MOVE ERASE.

7. Ak sme do tapky niečo pridali príkazom SAVE, a chceme to poslať do okolitého sveta, pomocou hodnoty U:xxxxx vypísanej v príkazoch CAT alebo COPY si zistíme koľko práve zaberá tapka v tape bufferi a presne toľko bajtov od začiatku tape buffera uložíme na externé médium. V prípade, že starú tapku ukladať nechceme, chceme len nové bloky (tie ktoré sme si uložili príkazom SAVE), a žiadne bloky sme nemazali, postačí ak uložíme novú časť tapky od adresy, kde končí stará tapka. V našom príklade to bude adresa 32000 (keďže stará tapka bola dlhá 2000 bajtov).

Na PMD 85 verziách, ktoré majú ALL-RAM režim (2A a 3), môžeme samozrejme pre tap buffer využiť adresy až po začiatok videoramky na 0C000h. Akurát keď potom skočíme do monitora, nebude tapka dostupná lebo bude prekrytá Monitorom.

Špeciálny alternatívny spôsob práce s dlhými basicmi

V prípade, že potrebujeme pracovať s BASIC programom tak dlhým, že sa nám do pamäti aj s príslušnou tapkou už nevojde, môžeme použiť tento špeciálny spôsob práce.

Aj v tomto prípade pracujeme s tapkou, avšak tapka nie je uložená v tap bufferi nad RAMTOPom, ale v reťazcovej premennej v BASICu. Pri loadnutí BASICového programu sa reťazcová premenná zmaže a s ňou prestane existovať aj tapka, a pri uložení programu do tapky sa tento program v pamäti nahradí jednou reťazcovou premennou, ktorá bude obsahovať tapku s týmto programom.

• Výhoda:

Tento spôsob umožňuje nahrávať a ukladať BASIC programy takmer tak dlhé, ako je celé voľne miesto v BASIC systéme. V ALL-RAM režime je to až cca 27500 bajtov.

• Nevýhoda:

Loadnutím programu tapka prestane v pamäti existovať, nie je preto možné takto nahrávať programy s dohrávacími blokmi (napr. keď si BASIC dohraje blok s UDG).

Ovládacie príkazy (a jedna funkcia):

• RUN a$ ... nahratie (a prípadne spustenie) BASICu z tapky uloženej v prememnej a$
• STOP a$,"Meno" <LINE autostart> ... uloženie BASICu s premennými do tapky a uloženie tapky do premennej a$
• PEEK a$ ... vráti adresu, kde v pamäti začínajú dáta v premennej a$

Namiesto a$ je samozrejme možné použiť akúkoľvek inú reťazcovú premennú, či už klasickú, deklarovanu príkazom LET alebo dimenzovanú príkazom DIM.

Nahratie BASICu príkazom RUN a$ urobí presne to isté ako príkaz LOAD "". Vezme premennú a$ (popr. akúkoľvek inú zadanú reťazcovú premennú), nájde v premennej tapku, v tapke nájde prvý BASIC program a ten nahrá do pamäti. V prípade, že BASIC má autoštart, tak sa aj hneď spustí. Reťazcová premenná s tapkou sa nahraním BASICu vymaže.

Tapka nemusí začínať od začiatku premennej, systém si tapku v premennej nájde sám podľa úvodného bajtu 13h (nižší bajt dĺžky bloku s hlavičkou). Je teda možné si najprv pomocou DIM vytvoriť dostatočne dlhú premennú a kamkoľvek do nej nahrať tapku (začínajúcu hlavičkou) z externého médiá.

Možné chyby:

• Invalid argument ... reťazcová premenná neobsahuje tapku
• Invalid I/O stream ... tapka neobsahuje BASIC alebo je poškodená
• Tape loading error ... hlavička je v poriadku, ale je poškodené telo BASICu

Príkaz STOP funguje presne ako SAVE - zabalí basic do tapky pod zadaným menom (v prípade, že za menom nasleduje LINE tak BASICu nastaví štartovací riadok), vytvorí zadanú reťazcovú premennú a uloží do nej tapku s BASICom. Dĺžka reťazcovej premennej sa nastaví presne na veľkosť tapky.

Z hľadiska užívateľa BASIC program a jeho premenné zmiznú, a v systéme zostane ako jediná iba zadaná reťazcová premenná obsahujúca tapku s BASICom. Užívateľ si potom pomocou funkcii PEEK a LEN môže zistiť adresu a dĺžku Tapky (napr. PRINT PEEK a$,LEN a$) a uložiť si ju na svoje externé médium.

Na začiatku bola spomenutá nevýhoda, že tento spôsob nie je vhodný pre nahrávanie programov, ktoré si okrem basicu potrebujú dohrať nejaké ďalšie bloky (dáta, code...). Túto nevýhodu je možné čiatočne eliminovať rozdelením tapky na samotný (dlhý) BASIC a (krátky) zvyšok tapky s dohravanými blokmi. Tapku s basicom umiestnime do reťazcovej premennej, a zvyšok tapky umiestníme do klasického tape buffera niekde nad RAMTOPom. V takomto prípade si po spustení BASICu z reťazcovej premennej tento BASIC následne príkazmi LOAD bude môcť dohrať ďalšie potrebné bloky klasickým spôsobom cez štandartný tape emulátor.

Polopatisticky

A znovu ukážka praktického postupu, ako nahrať nejaký existujúci program zo sveta, a následne, ako ho zase do sveta uložiť.

1. Vezmeme tapku s našim programom. Povedzme, že celá tapka je dlhá 22000 bajtov.
2. Príkazom DIM t$(22000) vytvoríme reťazcovu premennú.
3. Príkazom PRINT PEEK t$,LEN t$ si zistíme, kde v pamäti sú dáta premennej t$. Príkaz nám vypíše adresu a dĺžku týchto dét. Dĺžka by samozrejme mala byť 22000.
4. Od zistenej adresy nahráme do pamäti našu tapku z externého médiá.
5. Príkazom RUN t$ nahráme (a popr. spustíme) BASIC program z našej tapky.

Teraz máme program (aj s jeho prípadnými premennými) v pamäti a môžeme sa s ním hrať. Keď budeme chcieť takýto program uložiť, postup bude nasledujúci:

1. Príkazom STOP t$,"Meno" LINE 10 uložíme program s autoštartom na riadku 10. Program z pamäti zmizne a vytvorí sa premenná t$, obsahujúca tapku s programom. Keď autoštart nepotrebujeme, môžeme LINE s číslom riadku vynechať.
2. Príkazom PRINT PEEK t$,LEN t$ si zistíme, kde presne v pamäti leží naša novovytvorená tapka a aká je dlhá.
3. Tapku si uložíme na externé médium.