Zobraz zdroj

Z PMD 85 Infoserver

Akciu, ktorú požadujete môže vykonať iba člen skupiny user.
Môžete si zobraziť a kopírovať zdroj tejto stránky:
{{VelkyNadpis|MRM Manager}}

{{Infobox Software
| name = MrmMngr
| licence = Copyright © 2022 RM-TEAM
| author = Roman Bórik
| version = v1.0 ''(04/2022)''
| operating_system = windows {{!}} unix
| language = angličtina
| download = '''[[download:153|mrmmngr10.zip]]''' - ZIP archív obsahujúci binárku pre win32 konzolu + zdrojové texty s Makefile pre Linux
}}

__TOC__

'''MRM Manager''' je PC konzolová utilita určená pre spravovanie '''[[MRM Booter|MRM obrazov]]''', teda súborov určených pre napálenie do EPROM/FLASH, slúžiacich ako pamäť v [[ROM_MEGAmodul|ROM MEGAmodule]].

Utilita umožňuje pohodlne vytvárať a konfigurovať súbor MRM obrazu, pridávať, mazať a extrahovať súbory i ďalšie operácie.

V rovnakom adresári, kde sa nachádza MRM Manager musia byť aj tieto súbory:
* {{Príkaz|mrm-boot.bin}} : [[MRM Booter|boot kód]], ktorý je vždy na začiatku MRM obrazu
* {{Príkaz|mrm-ldr.bin}} : kód [[MRM Booter#Univerz.C3.A1lny_loader|univerzálneho loadera]] (viď prepínač {{Kbd|-ml}})
* {{Príkaz|unpckpsc.bin}} : kód rozpakovacej rutiny pre spakované obrázky z programu [[GRED]] (viď prepínač {{Kbd|-psc}})

== Použitie ==
MRM Manager je konzolová utilita, takže sa dá s výhodou použiť v dávkových súboroch. Požadované chovanie utility sa volí príslušnými prepínačmi.

Príkazový riadok môže mať podľa použitých prepínačov niekoľko foriem - každá pre konkrétnu jednu operáciu s MRM súborom. Prepínače uvedené v hranatých zátvorkách sú pre danú operáciu voliteľné.

: {{Príkaz|mrmmngr imgname.mrm -c [fmask[.T]]}}<br />
: {{Príkaz|mrmmngr imgname.mrm -ic [-is num] [-id num] [-ib [path/]bootfile.ext]}}<br />
: {{Príkaz|mrmmngr imgname.mrm -ir [-is num] [-id num] [-ib [path/]bootfile.ext]}}<br />
: {{Príkaz|mrmmngr imgname.mrm -fa [path/]filename.ext [-fn fname.T] [-ln lname] [-sa num] [-lf] [-rf] [-ow] [-psc]}}<br />
: {{Príkaz|mrmmngr imgname.mrm -fp fname.T [-fn newfn.T] [-ln lname] [-sa num] [-lf] [-rf]}}<br />
: {{Príkaz|mrmmngr imgname.mrm -fd fmask[.T]}}<br />
: {{Príkaz|mrmmngr imgname.mrm -fx [path/]fmask[.T]}}<br />
: {{Príkaz|mrmmngr imgname.mrm -ml fname.T pname.T cname.T [-ln lname] [-sa num] [-mon MX] [-scs] [-ow]}}<br />

Jednotlivé prepínače majú nasledujúci význam. Ak sa niektorý voliteľný prepínač neuvedie, jeho predvolená hodnota je tu uvedená v hranatých zátvorkách.

* {{Príkaz|-c}}<br />zobrazí katalóg MRM obrazu; pokiaľ je uvedené {{Kbd|fmask.T}}, zobrazí sa zoznam podľa uvedenej masky
* {{Príkaz|-ic}}<br />vytvorenie nového MRM obrazu
* {{Príkaz|-ir}}<br />rekonfigurovanie MRM obrazu; je možné zmeniť geometriu obrazu aj BOOT kód
* {{Príkaz|-is}}<br />veľkosť obrazu v kB [512]
* {{Príkaz|-id}}<br />počet položiek adresára [32]
* {{Príkaz|-ib}}<br />voľba špecifického súboru MRM Bootera [mrm-boot.bin]
* {{Príkaz|-fa}}<br />pridanie súboru do obrazu
* {{Príkaz|-fp}}<br />zmena parametrov súboru (meno, dlhé meno, štart adresa, atribúty)
* {{Príkaz|-fd}}<br />zmazanie súborov z obrazu podľa uvedenej masky súborov
* {{Príkaz|-fx}}<br />extrahovanie súborov z obrazu podľa uvedenej masky súborov
* {{Príkaz|-ml}}<br />vytvorenie ''Loader'' súboru
* {{Príkaz|-fn}}<br />určenie mena súboru vo formáte 8.1 (max. 8 znakov mena + jeden znak typ)
* {{Príkaz|-ln}}<br />dlhé meno súboru pre zobrazenie v zozname spustiteľných súborov (max. 16 znakov)
* {{Príkaz|-sa}}<br />štart adresa (počiatočná/nahrávacia) [0]
* {{Príkaz|-lf}}<br />nastavenie/zmena atribútu {{Kbd|List}}
* {{Príkaz|-rf}}<br />nastavenie/zmena atribútu {{Kbd|AllRAM}}
* {{Príkaz|-ow}}<br />prepísať existujúci súbor
* {{Príkaz|-psc}}<br />vložiť rozpakovaciu rutinu pre dáta spakovaného obrázku z programu [[GRED]]
* {{Príkaz|-mon}}<br />určenie typu Monitora v Loaderi; parameter môže byť 1, 1X, 2, 2X alebo mname.T
* {{Príkaz|-scs}}<br />potlačiť zmazanie obrazovky v Loaderi
Poznámky:
* {{Kbd|`lname`}} musí byť v úvodzovkách, ak obsahuje medzery.
* {{Kbd|`fname.T`}}, {{Kbd|`newfn.T`}}, {{Kbd|`pname.T`}}, {{Kbd|`cname.T`}} a {{Kbd|`mname.T`}} sú mená súborov vo formáte 8.1 a musia byť v úvodzovkách, ak obsahujú medzery. Malé písmená sa vždy zmenia na veľké.
* {{Kbd|`fmask`}} je maska súboru, ktorá môže obsahovať zástupné znaky {{Kbd|*}} a {{Kbd|?}}.
* `T` musí byť jediný znak. Ak sa neuvedie v maske súborov, znamená to všetky typy. Pozor: znak otáznik {{Kbd|?}} je platný typ súboru.
* Všetky numerické hodnoty {{Kbd|num}} musia byť nezáporné celé čísla a môžu byť zadané desiatkovo ({{Kbd|12345}}), osmičkovo ({{Kbd|01234}}) alebo šestnástkovo ({{Kbd|0x1234}}).

== Operácie Managera ==
V nasledujúcom zhrnieme detaily jednotlivých operácií.

=== Zobrazenie katalógu MRM obrazu {{Kbd|-c}} ===
V katalógu sa zobrazujú všetky súbory, ktoré sú v adresári MRM obrazu. Ak je v prepínači použitá maska, zobrazia sa iba tie súbory, ktoré zodpovedajú maske. Ak sa neuvedie Typ súboru, znamená to všetky súbory (otáznik je platný Typ súboru, ako pri kazetových súboroch).

V zozname súborov sa vľavo zobrazuje poradové číslo súboru v adresári. Zatiaľ je to iba informatívny údaj, ale do budúcna sa uvažuje o možnosti posúvať položky v adresári a nastaviť si poradie súborov dodatočne podľa potreby, keďže '''[[MRM Booter]]''' zobrazuje súbory v zozname tak, ako sú v adresári.

=== Vytvorenie nového MRM obrazu {{Kbd|-ic}} ===
Predvolene sa vytvára MRM obraz o veľkosti 512 kB. Túto hodnotu možno určiť prepínačom {{Kbd|-is}} v intervale od 32 do 8192 (kB). Počet položiek adresára je predvolene 32. Prepínačom {{Kbd|-id}} ju možno nastaviť v intervale od 4 do 256.

Do MRM obrazu sa na jeho začiatok pripraví '''Boot kód''' zo súboru {{Príkaz|mrm-boot.bin}}. Ak je to potrebné, môže sa prepínačom {{Kbd|-ib}} zvoliť iný súbor s Boot kódom. Súbor s Boot kódom sa overuje na správnosť skontrolovaním jeho tzv. '''Prologu''' (viď zdrojové súbory).

=== Prekonfigurovanie MRM obrazu {{Kbd|-ir}} ===
Existujúci MRM obraz možno prekonfigurovať, čo znamená, že je možné zmeniť jeho veľkosť (prepínač {{Kbd|-is}}) a aj počet položiek adresára (prepínač {{Kbd|-id}}). MRM Manager zachová všetky súbory v rovnakom poradí. Samozrejme, nie je možné zvoliť menšiu veľkosť, ako je už súbormi obsadené miesto v obraze. Rovnako tak, nie je možné zvoliť menej položiek adresára, ako je už obsadených položiek.

Zároveň je možné týmto prepínačom nahradiť existujúci Boot kód novým. Ak nový Boot kód zaberá iný počet sektorov ako pôvodný, MRM Manager príslušne poposúva adresár i súbory v obraze.

=== Pridanie súboru do MRM obrazu {{Kbd|-fa}} ===
Pri pridávaní súboru do MRM obrazu je možné určiť všetky parametre, ktoré sú v adresárovej položke. Ak sa nepoužije prepínač {{Kbd|-fn}}, ako krátke Meno súboru sa použije prvých 8 znakov z {{Kbd|filename}} a ako Typ sa použije prvé písmeno z prípony {{Kbd|ext}}. Dlhé Meno súboru (prepínač {{Kbd|-ln}}) má zmysel pre súbory, ktoré sa budú zobrazovať v zozname spustiteľných súborov a krátke Meno nie je dostačujúce. Ak sa teda dlhé Meno neuvedie a súbor bude mať nastavený atribút {{Kbd|List}}, v zozname spustiteľných súborov sa použije krátke Meno súboru bez Typu. Prepínačom {{Kbd|-sa}} sa určuje štart adresa, resp. adresa od ktorej sa súbor nahrá do pamäte - predvolene je to {{Kbd|0}}. Prepínačmi {{Kbd|-lf}} a {{Kbd|-rf}} sa nastavia príslušné atribút {{Kbd|List}} - zobrazenie súboru v zozname, resp. {{Kbd|AllRAM}} - nahranie súboru do pamäte v AllRAM režime.

MRM Manager nedovolí pridať súbor s rovnakým menom, aký sa už v adresári nachádza. Prepínačom {{Kbd|-ow}} je možné vynútiť prepísanie už existujúceho súboru.

Spakovaný obrázok z programu [[GRED]] (typ {{Kbd|C}}) obsahuje iba spakované dáta bez rutiny. Pri pridávaní tohto súboru do MRM obrazu umožňuje MRM Manager pomocou prepínača {{Kbd|-psc}} vložiť na začiatok tohto súboru rozpakovaciu rutinu, ktorá je v súbore {{Príkaz|unpckpsc.bin}}. Táto rozpakovacia rutina je preložená pre beh od adresy {{Kbd|1000h}} a preto je nutné pri pridávaní súboru použiť tiež prepínač {{Kbd|-sa 0x1000}}.

=== Zmena parametrov súboru v MRM obraze {{Kbd|-fp}} ===
Konkrétnemu súboru {{Kbd|fname.T}} možno zmeniť krátke Meno ({{Kbd|-fn newfn.T}}), Dlhé meno ({{Kbd|-ln lname}}) aj štart adresu ({{Kbd|-sa num}}). Prepínačmi {{Kbd|-lf}} a {{Kbd|-rf}} sa atribút v adresárovej položke zmenia na opačné.

=== Zmazanie súborov z MRM obrazu {{Kbd|-fd}} ===
Z MRM obrazu možno zmazať súbory hromadne určením masky súborov {{Kbd|fmask[.T]}}. MRM Manager sa nepýta na potvrdenie zmazania! Po zmazaní súborov sa adresár aj dátová oblasť v MRM obraze "strasú", čím sa odstránia "diery", ktoré by v adresári alebo dátovej oblasti po zmazaní súborov vznikli.

=== Extrahovanie súborov z MRM obrazu {{Kbd|-fx}} ===
Z MRM obrazu možno extrahovať súbory hromadne určením masky súborov {{Kbd|fmask[.T]}}. Zároveň možno určiť cieľovú cestu {{Kbd|path/}}, kam sa extrahované súbory uložia. Prípadne existujúce súbory sa prepíšu.

=== Vytvorenie súboru Loadera {{Kbd|-ml}} ===
MRM Manager umožňuje vytvoriť priamo do MRM obrazu [[MRM Booter#Univerz.C3.A1lny_loader|súbor Loadera]]. Tu je nutné určiť meno súboru Loadera {{Kbd|fname.T}} (typ súboru je obvykle {{Kbd|L}}), meno súboru so spakovaným obrázkom {{Kbd|pname.T}} (typ súboru by mal byť {{Kbd|Q}} ([[QuidoScr]]) alebo {{Kbd|C}} ([[GRED]])) a meno súboru kódu hry {{Kbd|cname.T}}.

Súboru Loadera má automaticky nastavený atribút {{Kbd|List}} a tak, ak je to potrebné, možno nastaviť súboru Dlhé Meno prepínačom {{Kbd|-ln}}. Loader normálne spúšťa hlavný kód od adresy uvedenej v adresárovej položke súboru {{Kbd|cname.T}}. Prepínačom {{Kbd|-sa}} ale možno určiť inú adresu.

Ak program potrebuje pre svoj beh konkrétny Monitor, je to možné určiť prepínačom {{Kbd|-mon}}. Parametrom prepínača môže byť:
* '''1''' : súbor Monitora {{Kbd|MONIT1.?}}
* '''1X''' : súbor Monitora {{Kbd|MONIT1.?}} - nebude sa inicializovať
* '''2''' : súbor Monitora {{Kbd|MONIT2.?}}
* '''2X''' : súbor Monitora {{Kbd|MONIT2.?}} - nebude sa inicializovať
* {{Kbd|mname.T}} : meno súboru s vlastným Monitorom - nebude sa inicializovať 
Posledná možnosť sa dá využiť aj ako nahranie ďalšieho súboru programu.

Prepínač {{Kbd|-scs}} potlačí zmazanie obrazovky po spustení Loadera. Prepínačom {{Kbd|-ow}} je možné vynútiť prepísanie už existujúceho súboru Loadera s rovnakým menom.

[[Category:Utility]]
Šablóny použité na tejto stránke:
Template:! (zamknutá)
Template:Infobox Software (zamknutá)
Template:Kbd (zamknutá)
Template:Príkaz (zamknutá)
Template:VelkyNadpis (zamknutá)
Späť na Intro.
Zdroj: "https://pmd85.borik.net/wiki/MRM_Manager"