Differences

This shows you the differences between two versions of the page.

--- cs:emulators:mz8emu:doc [2012/05/30 11:50] – hajdam
+++ cs:emulators:mz8emu:doc [2012/06/14 13:04] (current) – hajdam
@@ Line 1: / Line 1: @@
-====== SHARP MZ-800 Emulátor pro Windows (autor Zdeněk Adler) ======
+====== SHARP MZ-800 Emulátor pro Windows Zdeňka Adlera ======
 Toto není oficiální dokumentace/nápověda pro uvedený emulátor.
@@ Line 9: / Line 9: @@
 ===== Základní informace =====
-Emulátor (mz8emu) je aplikace pro operační systém Windows, která umožňuje spouštět kód a aplikace určené pro počítače modelové řady SHARP MZ-800 a pracovat s vybranými zařízeními, které se s tímto počítačem používali.
+Emulátor (mz8emu) je aplikace pro operační systém Windows, která umožňuje spouštět kód a aplikace určené pro počítače modelové řady SHARP MZ-800 a pracovat s velkým počtem zařízení, které se s tímto počítačem používaly.
 {{ en:emulators:mz8emu:doc:emu_main.gif }}
@@ Line 18: / Line 18: @@
 Minimálním požadavkem pro běh emulátoru je PC se systémem alespoň Windows 95, 98, ME, 2000 nebo XP. Pod Windows NT bohužel není funkční. Dále je třeba mít korektně nainstalované DIRECTX (min. verze 7), výhodou je zvuková karta, která ale není podmínkou.
-Pro optimální běh je doporučeno PC s procesorem alespoň 600 MHz a vyšší a kvalitní AGP grafická karta. Dále je vyžadován obsah paměti ROMky SHARPa (tzv. Firmware) který není přímou součástí balíku s emulátorem. Pokud jste však majiteli skutečného MZ-800, můžete si jej stáhnout, nebo její obsah získat přímo z počítače pomocí EPROM programátoru.
+Pro optimální běh je doporučeno PC s procesorem alespoň 600 MHz a vyšší a kvalitní AGP grafická karta. Dále je vyžadován obsah paměti ROM SHARPa (tzv. Firmware), který není přímou součástí balíku s emulátorem. Pokud jste však majiteli skutečného MZ-800, můžete si jej stáhnout, nebo její obsah získat přímo z počítače pomocí EPROM programátoru.
 ===== Emulovaný hardware =====
@@ Line 39: / Line 39: @@
 ===== Licence emulátoru =====
-Emulátor je shareware, kde neregistrovaná instalace emulátoru má časově omezené spuštění na dobu 3 minut. Po vypršení tohoto času se emulátor ukončí a musíte jej spustit znovu. Oproti plné verzi jsou zde také zablokována tlačítka pro uložení / načtení stavu emulace (snapshot), při každém spuštění je také třeba odklepnout registrační okno. Dříve, než registraci provedete je však lepší si ověřit pomocí demoverze, zda emulátor bude na vašem PC bez potíží fungovat.
+Emulátor je shareware, kde neregistrovaná instalace emulátoru je časově omezena na dobu 3 minut. Po vypršení tohoto času se emulátor ukončí a musíte jej spustit znovu. Oproti plné verzi jsou také zablokována tlačítka pro uložení / načtení stavu emulace (snapshot), při každém spuštění je také třeba odklepnout registrační okno. Dříve, než registraci provedete je však lepší si ověřit pomocí demoverze, zda emulátor bude na vašem PC bez potíží fungovat.
 ==== Cena, způsob platby ====
-Registrační poplatek je 150 Kč (nebo 10$), je možné jej uhradit buďto elektronickou platbou, nebo složenkou na poště. V této ceně je zahrnuta bezplatná aktualizace - tj. registrovaný uživatel získává možnost si zdarma stáhnout z internetu novou verzi emulátoru bez nutnosti nové registrace. V případě registrace uživatele ze zahraničí je způsob platby určen vzájemnou dohodou. Bližší informace pro registraci velice rád poskytnu e-mailem zdeneka@seznam.cz.
+Registrační poplatek je 150 Kč (nebo 10$) a je možné jej uhradit buďto elektronickou platbou, nebo složenkou na poště. V této ceně je zahrnuta bezplatná aktualizace - tj. registrovaný uživatel získává možnost si zdarma stáhnout z internetu novou verzi emulátoru bez nutnosti nové registrace. V případě registrace uživatele ze zahraničí je způsob platby určen vzájemnou dohodou. Pro registraci a další informace kontaktuje autor emulátoru e-mailem: zdeneka@seznam.cz.
 ==== Postup při registraci, podmínky ====
-Po obdržení Vašeho e-mailu zašlu údaje potřebné pro uhrazení registračního poplatku, tj. Číslo účtu a konstantní symbol. Vy mi po uhrazení zašlete kopii dokladu o provedené platbě (případně informaci, kdy proběhla elektronická platba a pod jakým var. symbolem), dále jméno a příjmení kupujícího a adresa jeho bydliště (tyto údaje nejsou nijak dále shromažďovány či využívány pro jiné účely), na jejímž základě vygeneruji a obratem zašlu registrační klíč, který převážně posílám zkomprimovaný pomocí WinZIPu. Po jeho obdržení stačí klíč rozbalit do kterékoliv složky na pevném disku (doporučeno do složky, ve které máte emulátor). Poté spustíte emulátor který zobrazí registrační okno - pokračujete stiskem na tlačítko Register (vpravo dole) po němž se zobrazí dialog pro otevření souboru. Vyberete správnou cestu ke složce ve které je uložen registrační klíč (soubor s příponou .reg) a dvojklikem (případně jeho zvolením a kliknutím na tlačítko otevřít) jím aktivujete plnou verzi emulátoru. Následuje okno informující o úspěšné registraci které navíc obsahuje Vaše registrační údaje. Po tomto kroku je ještě nutné emulátor ukončit a znovu spustit.
+Po obdržení e-mailu s žádostí o registraci Vám budou zaslány údaje potřebné pro uhrazení registračního poplatku, tj. číslo účtu a konstantní symbol. Po uhrazení zašlete e-mailem kopii dokladu o provedené platbě (případně informaci, kdy proběhla elektronická platba a pod jakým var. symbolem), dále jméno a příjmení kupujícího a adresu jeho bydliště (tyto údaje nejsou nijak dále shromažďovány či využívány pro jiné účely). Na základě došlé platby Vám bude vygenerován a obratem zaslán registrační klíč (v ZIP archivu). Po jeho obdržení stačí klíč rozbalit do kterékoliv složky na pevném disku (doporučeno do složky, ve které máte emulátor). Poté spustíte emulátor který zobrazí registrační okno - pokračujete stiskem na tlačítko Register (vpravo dole) po němž se zobrazí dialog pro otevření souboru. Vyberete správnou cestu ke složce ve které je uložen registrační klíč (soubor s příponou .reg) a dvojklikem (případně jeho zvolením a kliknutím na tlačítko otevřít) jím aktivujete plnou verzi emulátoru. Následně se zobrazí okno informující o úspěšné registraci, které navíc obsahuje Vaše registrační údaje. Po tomto kroku je ještě nutné emulátor ukončit a znovu spustit.
 {{ en:emulators:mz8emu:doc:emu_reg.jpg }}
@@ Line 53: / Line 53: @@
 ==== Postup při instalaci nové verze ====
-Postačuje pouze stažení sharewarové verze z internetu a přepsání spouštěcího souboru mz8emu.exe novou verzí. Vaše registrační údaje zůstanou zachovány.
+Emulátor je potřeba stáhnout z webu autora [[http://mz-800.xf.cz/download.htm]].
-===== Práce s emulátorem =====
+<wrap important>Autor emulátoru striktně zakazuje umisťování emulátoru na jiné webové servery.</wrap>
+Emulátor je distribuován ve formě ZIP archivu, která obsahuje spustitelnou aplikaci a další informační soubory, ale neobsahuje soubory ROM ve složce ROM. Ty je potřeba z důvodu možné kolize s licencí firmy SHARP stahovat zvlášť (to se může v budoucích verzích změnit).
+Instalace se provádí rozbalením souboru do vhodné složky - například můžete vytvořit složku "MZ-800 Emulátor" ve složce pro Windows programy (Program files). V závislosti na verzi operačního systému je pak potřeba disponovat oprávněním pro instalování / spouštění programů. Při prvním spuštění si emulátor vytvoří konfigurační soubory a pokusí se asociovat soubory MZF, MZS a DSK. Toto chování můžete následně změnit v nastavení emulátoru.
+Pokud aktualizujete verzi na počítači, kde jste už provedli registraci starší verze, postačuje pouze provést stažení sharewarové verze z internetu a přepsání spouštěcího souboru mz8emu.exe novou verzí. Vaše registrační údaje zůstanou zachovány.
+V případě instalace na jiný počítač je potřeba proces registrace provést znovu.
+===== Základní práce s emulátorem =====
+Po spuštění se emulátor přepne do stejného režimu, v jakém se nachází po zapnutí i skutečný počítač. V závislosti na připojených zařízeních se zavede konkrétní systém, nebo je k dispozici základní menu s následujícími volbami:
+  * M - vstup do monitoru
+  * C - načtení a spuštění souboru z magnetofonové pásky
+  * Q - načtení a spuštění souboru z mechaniky quickdisk (pokud je připojena QD mechanika)
+  * F - načtení a spuštění souboru z mechaniky floppydisk (pokud je připojena FDD mechanika)
+Nejčastějším prvním krokem je zavedení a spuštění vybrané aplikace z některého zařízení, které jsou k dispozici.
 ==== Načítání souborů z páskových kazet ====
@@ Line 63: / Line 82: @@
 === Rychlé načítání souborů ===
-Pomocí rychlého načítání je možné otevřít jeden soubor MZF okamžitým zavedením do paměti. Emulátor je také možné asociovat se soubory MZF pro přímé spuštění...
+Emulátor ve výchozím nastavení asociuje soubory MZF pro rychlé spuštění. Z běžícího emulátoru je také možné otevírat soubory metodou rychlého spuštění (okamžitým zavedením MZF souboru do paměti), pokud je povolena volba v nastavení Hardware/Setup/Tape Enable CMT patch in ROM.
+{{ en:emulators:mz8emu:doc:zacmtpatch.gif }}
+V takovém případě se po startu systému po stisku klávesy C, nebo příkazem L z režimu monitoru vyvolá následující dialog, který umožňuje zvolit soubor pro načtení:
+{{ en:emulators:mz8emu:doc:zacmtopen.gif }}
 === Načítání souborů pomocí virtuálního magnetofonu ===
-Pro vícedílné programy je potřeba použít
+Pokud je volba "CMT patch in ROM" vypnuta, nebo aplikace nenačítá data pomocí obslužných rutin monitoru, očekávají se při načítání data z virtuálního magnetofonu. Toto chování se týká typicky jak programovacích jazyků jako např. BASIC tak i vícedílných kazetových her. Okno virtuálního magnetofonu lze otevřít z menu Hardware/Virtual CMT, nebo z panelu pomocí ikony kazety.
-FIXME
+{{ en:emulators:mz8emu:doc:zavirtcmt.gif }}
-Více viz. emulace magnetofonu.
+Při tomto způsobu načítání se pomocí tlačítka Open zvolí jeden nebo více MZF souborů a po stisknutí tlačítka Play se začnou data předávat do emulovaného systému. Průběh načítání se zobrazuje zeleným pruhem a časovým údajem.
 ==== Načítání souborů z disket typu floppy ====
+Emulátor umožňuje práci s pružnými disky uloženými ve formátu DSK vytvořeného pomocí programu CPDREAD 3.24 (viz sekce download) kde se obsah každé diskety uloží jako jeden velký soubor (360 KB, 720 KB, 1,44 MB). Tyto soubory je možné také zkopírovat zpět na disketu pomocí programu CPDWRITE 1.03 (opět v sekci download).\\
+Pokud jsou soubory *.dsk asociovány s emulátorem (Provádí se v Setupu na záložce Misc), stačí pouze dvakrát kliknout na DSK souboru - emulátor se automaticky spustí, zapne emulaci FDD, do mechaniky A: "vloží" daný DSK soubor a pokud na něm je systém, tak se pokusí nabootovat. Jestliže chcete měnit DSK soubory přímo za běhu emulátoru, existují pro to dva způsoby: Prvním je nástrojová lišta emulátoru, ve které po kliknutí na ikonu diskety se rozbalí popup menu, ve kterém máte možnost buď změnit DSK soubor v dané mechanice (Open image file), případně jej z mechaniky odstranit úplně (Eject).\\
+{{ en:emulators:mz8emu:doc:emu_fddpopup.gif }}
+Podobné nastavení je možné také provést ze Setupu. Zde je ještě navíc možnost povolení/zákazu uložení změn do image při ukončení emulátoru, nebo při výměně diskety (Save image on change or exit emulator). Dále je možné zcela zapnout nebo vypnout emulaci řadiče FDD (Enable FDD). Poslední v této nabídce jsou nástroje pro práci s obrazy disket (Disc tools), které však budou popsány v samostatné kapitole.\\
+{{ en:emulators:mz8emu:doc:emu_fddsetup.gif }}
 ==== Načítání souborů z disket typu quickdisk ====
-==== Načítání z karet typu ramdisk/romdisk/ram cartridge ====
+Emulátor podporuje otevírání médií QD v dialogu Setup v záložce QD. Pro otevření stávajícího image slouží tlačítko "Open file" a samotné zařízení je potřeba povolit, což se případně projeví až při následném restartu emulovaného systému.
+{{ en:emulators:mz8emu:doc:emu_qdsetup.gif }}
+==== Načítání z karet typu ramdisk/romdisk/cartridge ====
+<wrap todo>TODO: Ramdisk</wrap>
 ===== Emulované komponenty =====
+==== Procesor ====
+Je emulován procesor ZILOG Z-80 včetně rozšiřujících instrukčních sad. V nastavení je možné změnit rychlost běhu procesoru při potřebě zrychlení, či zpomalení vykonávání programu:
+{{ en:emulators:mz8emu:doc:zacpu.gif }}
+Základní režim běhu je možné ovlivnit také nastavením priority emulátoru a změnou přepínačů režimu (DIP switches) v ostatních volbách nastavení, kde je k dispozici také volba jazyka aplikace a asociace souborů pro spuštění z operačního systému.
+{{ en:emulators:mz8emu:doc:zamisc.gif }}
 ==== Obrazovka ====
-Jsou zde emulovány téměř všechny známé vlastnosti grafického čipu GDG a navíc i částečně nedokumentované režimy. Obraz je vykreslován přes tzv. scanlines, tzn. simuluje se zde věrně běh paprsku po televizní obrazovce včetně zpětných běhů apod. Zahrnuje taktéž i vykreslování okraje (borderu) ve stejné šířce, jak je tomu u skutečného MZ-800.Proto by v emulátoru měly správně fungovat všechny graficky náročnější programy vyžadující přesné časování (např. Slap Fight od JO, GP Simulator, Picture show, FX Sound 4, Game music, MogMog2, zavaděč u Interkarate+ a mnoho dalších...). Je možné pracovat jak v základní konfiguraci s 16-ti KB videoram, tak i s rozšířenou videoram na 32 KB\\
+Jsou emulovány téměř všechny známé vlastnosti grafického čipu GDG a navíc částečně i nedokumentované režimy. Obraz je vykreslován přes tzv. scanlines, tzn. simuluje se běh paprsku po televizní obrazovce včetně zpětných běhů apod. Zahrnuje taktéž i vykreslování okraje (borderu) ve stejné šířce, jako je tomu u skutečného MZ-800. Díky tomu by měly v emulátoru správně fungovat všechny graficky náročnější programy vyžadující přesné časování (např. Slap Fight od JO, GP Simulator, Picture show, FX Sound 4, Game music, MogMog2, zavaděč u Interkarate+ a mnoho dalších...). Je možné pracovat jak v základní konfiguraci s 16-ti KB videoram, tak i s rozšířenou videoram na 32 KB\\
 {{ en:emulators:mz8emu:doc:emu_screen.gif }}
-Pozastavme se nyní u možností nastavení obrazovky. Je zde na výběr typ monitoru který se má simulovat (na výběr mezi barevným, zeleným a odstíny šedé).\\
+Je možné zvolit typ monitoru, který se má simulovat. Na výběr je barevný a černobílý monitor v odstínech šedé, či zelené barvy.\\
-Další možností je tzv. vynechávání snímků, které může částečně pomoci majitelům pomalejších počítačů (Refresh every 4 frame). Jedná se víceméně o to, že vykreslení obrazovky SHARPa musí proběhnout 50x za jednu vteřinu, přičemž pokud použijeme vynechávání snímků, sníží se tato hodnota na 25, 17 anebo 12 snímků za vteřinu. Čím více snímků je však vynecháváno, tím více se může zdát "trhaný" pohyb například postaviček ve hrách, rolujícího textu apod. Pro majitele rychlých PC vřele doporučuji pro co nejvěrnější emulaci nastavit posuvník na hodnotu "Every 1 frame".\\
+{{ en:emulators:mz8emu:doc:zavideo3.gif }}
-Mezi další patří nastavení rozlišení pro celoobrazovkové rozlišení. Zde doporučuji použít nejvyšší možné rozlišení které zvládá Váš monitor - tím zajistíte dostatečnou kvalitu obrazu při jeho rozprostření přes celou obrazovku. Barevnou hloubku můžete zvolit víceméně jakoukoliv, doporučuji 16 bitů, naopak nedoporučuji kvůli rychlosti překreslování výběr 24-bitové barevné hloubky.\\
+{{ en:emulators:mz8emu:doc:zavideo2.gif }}
-Jako poslední nastavení naleznete položku "Double screen" kterou přepínáte mezi dvojnásobným a normálním zobrazením a položku "Extended VRAM 32K" kterou máte možnost zapnout/vypnout rozšířenou videoram - doporučuji ji mít neustále zapnutou.\\
+Další možností je tzv. vynechávání snímků, které může částečně pomoci majitelům pomalejších počítačů (Refresh every 4 frame). Jedná se víceméně o to, že vykreslení obrazovky SHARPa musí proběhnout 50x za jednu vteřinu, přičemž pokud použijeme vynechávání snímků, sníží se tato hodnota na 25, 17 anebo 12 snímků za vteřinu. Čím více snímků je však vynecháváno, tím více se může zdát "trhaný" pohyb například postaviček ve hrách, rolujícího textu apod. Pokud máte dostatečný výkon PC, doporučuje se pro co nejvěrnější emulaci nastavit posuvník na hodnotu "Every 1 frame".\\
+K dispozici je také volba zobrazení přes celou obrazovku. Doporučuje se použít nejvyšší možné rozlišení resp. nativní rozlišení vašeho monitoru - tím zajistíte dostatečnou kvalitu obrazu při jeho rozprostření přes celou obrazovku. Vyšší barevná hloubka může u starších počítačů zpomalovat vykreslování. Nastavení hloubky na 16 bitů může zlepšit vykreslování, ale vyžaduje dodatečné přepínání režimu grafické karty.\\
+Jako poslední nastavení naleznete položku "Double screen" kterou přepínáte mezi normálním a dvojnásobným zobrazením a položku "Extended VRAM 32K" kterou máte možnost zapnout/vypnout emulaci rozšířené videoram paměti - doporučuje se ponechat zapnuto.\\
 ==== Klávesnice a myš ====
@@ Line 111: / Line 166: @@
 | \          | F7         |
-Zvláštní význam má klávesa F12, která způsobí reset emulátoru. Je možné i používat kombinaci CTRL+F12, podobně jako bylo možné na SHARPu stisknout CTRL+RESET pro restart některých programů.
+Zvláštní význam má klávesa F12, která způsobí reset emulátoru. Je možné používat také kombinaci CTRL+F12, podobně jako bylo možné na SHARPu stisknout CTRL+RESET pro restart některých programů.
-Pokud by vám činilo velké potíže některý znak, číslo či písmeno nalézt na klávesnici PC, disponuje emulátor také takzvanou klávesnicí virtuální. Představuje ji zmenšená kopie skutečné klávesnice ze SHARPa, na níž si můžete pomocí myši "vyťukávat" téměř cokoliv. Nejste ani omezeni na stisk pouze jedné klávesy současně - stisk více kláves lze simulovat tak, že přidržíte stisknutou klávesu Shift (na klávesnici PC) a poté již myší označujete tlačítka, která mají být stlačena současně. Po uvolnění Shiftu na PC klávesnici se i uvolní takto současně držená tlačítka.\\
+Emulátor taktéž disponuje virtuální klávesnicí, na které může být snadnější nalézt některý znak, číslo či písmeno. Představuje ji zmenšený obrázek skutečné klávesnice ze SHARPa, na níž můžete klávesy stisknout pomocí myši. Stisk více kláves najednou lze docílit přidržením klávesy Shift (na klávesnici PC) a poté stiskem jednotlivých tlačítek, která mají být stlačena současně. Po uvolnění Shiftu na PC klávesnici se i uvolní takto současně držená tlačítka.\\
 {{ en:emulators:mz8emu:doc:emu_vkeyb.gif }}
-Myš je zde emulována podle specifikace, která pochází od firmy Tatra softer (ing. Ján Koštial) - jednalo se o klasickou paralelní myš Atari připojenou přes Joystick port, spolupracovala s mnoha programy a hrami - pro příklad uvedu Lemmings, MZ Paint 4, Return to Kyrandia, Pasians, POOL mouse, HD Setup a další... Emulována je pomocí jakékoliv myši na PC (či jiného polohovacího zařízení). V nastavení ji doporučuji vybrat na port JOY2 kam se také standardně připojovala a to jen v případě, že ji daný program podporuje!!!! Pokud program či hra očekává na tomtéž portu připojený joystick a ne myš, mohli by jste se potom divit, proč se tak podivně chová... U emulaci myši jsem téměř eliminoval její nepříjemný syndrom, který se projevoval na SHARPu - pokud jste myši jeli velmi rychle jedním směrem, kurzor se začal pohybovat směrem opačným. Pokud by se tato nectnost přecijen projevila, můžete ji korigovat v Setupu pomocí posuvníku "Mouse sensitivity" určeného k vyladění citlivosti myši.\\
+Myš je emulována podle specifikace, která pochází od firmy Tatra softer (ing. Ján Koštial) - jednalo se o klasickou paralelní myš Atari připojenou přes Joystick port, spolupracovala s mnoha programy a hrami - například Lemmings, MZ Paint 4, Return to Kyrandia, Pasians, POOL mouse, HD Setup a další... Emulována je pomocí jakékoliv myši na PC (či jiného polohovacího zařízení). V nastavení se typicky nastavuje na port JOY2, kam se také pro podporované aplikace standardně připojovala. Pokud program či hra očekává na tomtéž portu připojený joystick a ne myš, může to vést k nezvyklému chování. Emulace myši potlačuje nepříjemný jev, který se projevoval na SHARPu - pokud jste myší posouvali velmi rychle jedním směrem, kurzor se začal pohybovat směrem opačným. Pokud se tento jev přece jenom projevuje, pokuste se korigovat citlivosti myši v Setupu pomocí posuvníku "Mouse sensitivity".\\
 {{ en:emulators:mz8emu:doc:emu_setin.gif }}
-Z nastavení už zbývá jen volba toho, co je připojeno na porty JOY1 a JOY2. Na výběr jsou buď myš, joystick simulovaný pomocí numerické klávesnice (klávesy 4,8,6,2 + 5 fire) nebo že je port neobsazen. Standardně je na portu JOY1 joystick simulovaný pomocí num. klávesnice a port JOY2 není obsazený (None).
+Z nastavení už zbývá jen volba toho, co je připojeno na porty JOY1 a JOY2. Na výběr jsou buď myš, joystick simulovaný pomocí numerické klávesnice (klávesy 4,8,6,2 + 5 fire) nebo volba pro indikaci neobsazeného portu. Standardně je na portu JOY1 joystick simulovaný pomocí num. klávesnice a port JOY2 není obsazený (None).
 ==== Magnetofon ====
-Je emulován dvěma způsoby - buď pomocí úpravy v ROMce, nebo jako virtuální magnetofon. Zastavme se u způsobu prvního: slouží výhradně k nahrávání programů pouze po zapnutí (či resetu) klávesou "C", nebo z monitoru příkazem "L", případně jen v programech, které se odvolávají na rutiny monitoru. Úprava je provedena na následujících dvou adresách:\\
+Kazetový magnetofon je emulován dvěma způsoby - buď pomocí úpravy v ROMce, nebo jako virtuální magnetofon.
+Režim upravené ROM slouží převážně k nahrávání programů pouze po zapnutí (či resetu) klávesou "C", nebo z monitoru příkazem "L", případně jen v programech, které se odvolávají na rutiny monitoru. Úprava je provedena na následujících dvou adresách:\\
 D8h - Load head\\
 F8h - Load program\\
-V rutině Load head přidá emulátor instrukci OUT (01h),A která se postará o zobrazení dialogu pro výběr MZF souboru a načtení jeho hlavičky do paměti. Do rutiny Load program je přidána instrukce OUT (02),A která nahraje tělo vybraného programu. Celou tuto úpravu v ROMce je možné povolit/zakázat v Setupu pomocí položky "Enable CMT patch in ROM". Pro aktivaci tohoto nastavení je nutný reset....\\
+V rutině Load head přidá emulátor instrukci OUT (01h),A která se postará o zobrazení dialogu pro výběr MZF souboru a načtení jeho hlavičky do paměti. Do rutiny Load program je přidána instrukce OUT (02),A která nahraje tělo vybraného programu. Celou tuto úpravu v ROMce je možné povolit/zakázat v Setupu pomocí položky "Enable CMT patch in ROM". Po aktivaci tohoto nastavení je nutný reset emulovaného počítače.\\
 **Virtuální magnetofon (virtual CMT)**\\
-{{ en:emulators:mz8emu:doc:emu_virtcmt.gif }}
+{{ en:emulators:mz8emu:doc:emu_vcmt.gif }}
 Slouží téměř jako plnohodnotná náhrada klasického magnetofonu připojeného k SHARPu. Podporuje nejen MZ formáty (*.MZF, *.M12), ale i formát ze ZX spectra (*.TAP) a univerzální zvukový formát (*.WAV) ve formátu 8-bitů MONO s jakoukoliv vzorkovací frekvencí bez komprese.\\
-Po spuštění se zobrazí standardní nabídka ROM monitoru, která dává na výběr natažení programu nejen z magnetofonu, ale i z dalších připojených zařízení jako Quick disk Standardně po prvním spuštění je zapnuto zrychlené nahrávání které se děje za pomoci úpravy v ROM a po stisknutí ihned nabídne okno pro výběr MZF souboru po jehož zvolení se program okamžitě nahraje.\\
 {{ en:emulators:mz8emu:doc:emu_setcmt.gif }}
-Nyní k samotnému použití: Virtuální CMT otevřete buď z toolbaru, případně z menu Hardware->Virtual CMT. Místo kazety do něj vložíte požadovaný soubor (jeden z výše zmíněných typů), a to pomocí tlačítka Eject. Potom už jen stačí připravit daný program na to, aby očekával data z magnetofonu a stisknout tlačítko Play. Tímto způsobem je třeba nahrávat zejména vícedílné kazetové hry. Uvedeme si to na krátkém příkladu u hry Interkarate+ která má celkem 3 části (zavaděč, obrázek, vlastní program):\\
+Virtuální CMT otevřete buď z toolbaru, případně z menu Hardware->Virtual CMT. Místo kazety do něj vložíte požadovaný soubor (jeden z výše zmíněných typů), a to pomocí tlačítka Eject. Potom už jen stačí připravit daný program na to, aby očekával data z magnetofonu a stisknout tlačítko Play. Tímto způsobem je třeba nahrávat zejména vícedílné kazetové hry. Uvedeme si to na krátkém příkladu u hry Interkarate+ která má celkem 3 části (zavaděč, obrázek, vlastní program):\\
-Pokud máme (standardně) v Setupu zvolenu možnost "Enable CMT patch in ROM", bude postup následující. V monitoru stiskneme klávesu "C" - zobrazí se dialogové okno pro výběr MZF souboru kde vybereme první část hry, která se ihned nahraje. Dále je již třeba otevřít virtuální magnetofon, stisknout tlačítko Eject a vybrat druhou část hry s obrázkem a stisknout Play. Doba přehrání programu z virtuálního CMT je přímo úměrná době, kterou by jste proseděli u SHARPa při nahrávání z kazety! Po nahrání obrázku tento postup ještě jednou zopakujeme pro hlavní program. Přibližný čas do konce nahrávání lze odvodit z progressbaru, který je umístěn ve spodní části Virtual CMT.
+Rychlost přehrání programu z virtuálního CMT odpovídá rychlosti na skutečném počítači. Přibližný čas do konce nahrávání je zobrazování v okně Virtual CMT. Pokud nechcete tak dlouho čekat, je vhodné si nastavit vyšší rychlost emulace, čímž se může doba nahrávání výrazně zkrátit.
 ==== Disketová jednotka ====
-Je zde emulován řadič floppy disku kompatibilní s ROMkou SHARPa vybavený obvodem WD 2797 a čtyřmi mechanikami, prozatím do velikosti 720 KB. Disketové jednotky zde nejsou emulovány pomocí mechaniky v PC, ale pomocí tzv. diskového image. O co se jedná a proč tomu tak je? Jde o to, že vaše diskety ze SHARPa si převedete do PC pomocí programu CPDREAD 3.24 (viz sekce download) kde se obsah každé diskety uloží jako jeden velký soubor (360 KB, 720 KB, 1,44 MB) na harddisk. S tímto "obrazem diskety" který má příponu *.dsk potom spolupracuje emulátor. Výhody jsou více než jasné - tímto krokem si bezpečně zazálohujete vaše diskety - na harddisku na PC jim hrozí mnohem menší nebezpečí, než kdyby vám korodovaly někde v šuplíku... Pokud by jste se je někdy chystali použít opět na reálném SHARPu, není nic jednoduššího, než si obraz diskety zkopírovat zpět na disketu pomocí programu CPDWRITE 1.03 (opět v sekci download).\\
+Je emulován řadič floppy disku kompatibilní s ROMkou SHARPa vybavený obvodem WD 2797 a čtyřmi mechanikami, prozatím do velikosti 720 KB. Disketové jednotky zde nejsou emulovány pomocí mechaniky v PC, ale pomocí tzv. diskového image.
-Nyní už však k samotnému použití. Pokud máte soubory *.dsk asociovány s emulátorem (Provádí se v Setupu na záložce Misc), stačí pouze dvakrát kliknout na DSK souboru - emulátor se automaticky spustí, zapne emulaci FDD, do mechaniky A: "vloží" daný DSK soubor a pokud na něm je systém, tak se pokusí nabootovat. Jestliže chcete měnit DSK soubory přímo za běhu emulátoru, existují pro to dva způsoby: Prvním je nástrojová lišta emulátoru, ve které po kliknutí na ikonu diskety se rozbalí popup menu, ve kterém máte možnost buď změnit DSK soubor v dané mechanice (Open image file), případně jej z mechaniky odstranit úplně (Eject).\\
-{{ en:emulators:mz8emu:doc:emu_fddpopup.gif }}
-Podobné nastavení je možné také provést ze Setupu. Zde je ještě navíc možnost povolení/zákazu uložení změn do image při ukončení emulátoru, nebo při výměně diskety (Save image on change or exit emulator). Dále je zde možné zcela zapnout nebo vypnout emulaci řadiče FDD (Enable FDD). Poslední v této nabídce jsou nástroje pro práci s obrazy disket (Disc tools), které však budou popsány v samostatné kapitole.\\
-{{ en:emulators:mz8emu:doc:emu_fddsetup.gif }}
 ==== Quick disk ====
-V emulátoru je QD plně podporován (čtení, zápis, formátování), formát jeho image je kompatibilní s ostatními emulátory. Oproti skutečnosti (média pro QD byla oboustranná) je třeba mít pro každou stranu quick disku jeden image. Nastavení je vcelku jednoduché. Pro otevření stávajícího image slouží tlačítko "Open file", pro pomyslné vysunutí disku z jednotky je tlačítko "Eject" a nakonec pro vytvoření nového nenaformátovaného disku použijete tlačítko "Create new". Emulace QD se zapíná pomocí zatržítka "Enable QD", zákaz zápisu na disk je možné provést zatrhnutím položky "Write protect".\\
+V emulátoru je QD plně podporován (čtení, zápis, formátování), formát jeho image je kompatibilní s ostatními emulátory. Oproti skutečnosti (média pro QD byla oboustranná) je třeba mít pro každou stranu quick disku jeden image. Pro otevření stávajícího image slouží tlačítko "Open file", pro pomyslné vysunutí disku z jednotky je tlačítko "Eject" a nakonec pro vytvoření nového nenaformátovaného disku použijete tlačítko "Create new". Emulace QD se zapíná pomocí zatržítka "Enable QD", zákaz zápisu na disk je možné provést zatrhnutím položky "Write protect".\\
-**Použití QD**\\
 {{ en:emulators:mz8emu:doc:emu_qdsetup.gif }}
@@ Line 174: / Line 219: @@
 Nahrání programu - QL\\
 Uložení bloku paměti na disk - QS\\
+==== Ram Disk / Rom Disk / Cartridge ====
+{{ en:emulators:mz8emu:doc:zaromram.gif }}
 ==== Zvukový generátor ====
@@ Line 187: / Line 236: @@
 === Plotter MZ-1P16 ===
-Tento velice rozšířený plotter který byl originálním doplňkem od firmy SHARP je v emulátoru taktéž začleněn. Tiskový výstup zněj není prováděn přímo na tiskárnu (či dokonce na připojený plotter), ale do bitmapy (standardní formát *.BMP, 16 barev) kterou je možné následně buďto upravit, nebo přímo vytisknout. Je zde emulován přímo jednočipový procesor včetně programu který se v plotteru nacházel, proto by tiskové výstupy z něj měly přesně odpovídat originálu. Dokonce je zde možný i HW autotest plotteru, ke kterému se dostaneme později...\\
+Tento velice rozšířený plotter který byl originálním doplňkem od firmy SHARP je v emulátoru taktéž začleněn. Tiskový výstup z něj není prováděn přímo na tiskárnu (či dokonce na připojený plotter), ale do bitmapy (standardní formát *.BMP, 16 barev) kterou je možné následně buďto upravit, nebo přímo vytisknout. Je emulován přímo jednočipový procesor včetně programu který se v plotteru nacházel, proto by tiskové výstupy z něj měly přesně odpovídat originálu. Dokonce je možný i HW autotest plotteru, ke kterému se dostaneme později...\\
 {{ en:emulators:mz8emu:doc:emu_plotrun.gif }}
@@ Line 197: / Line 246: @@
 Dostáváme se k popisu okna plotteru - vlevo se nachází nástrojová lišta, v níž jsou (odshora) tyto tlačítka: Prvním je uložení bitmapy reprezentující papír v plotteru do souboru - tento soubor je pak možné vytisknout z jakéhokoliv grafického programu na libovolnou tiskárnu spolupracující s Windows. Další je reset plotteru - procesor plotteru (a tím i celý plotter) jsou uvedeny do výchozího stavu, pokud jste si neuložili obsah "papíru", bude vymazán. Poslední je tlačítko "Paper feed" pro odrolování papíru - pozor na to, že se toto tlačítko chová jako přepínač, tzn. že pokud chcete papír o kousek posunout, musíte toto tlačítko stisknout 2x po sobě. Pro spuštění autotestu plotteru je třeba zamáčknout nejdříve tlačítko "Paper feed" a posléze stisknout tlačítko reset - plotter následně začne tisknout celý svůj znakový generátor ve čtyřech barvách. Úplně vespod okna jsou v liště umístěny údaje o XY pozici pera a o tom, zda plotter právě vykonává některý příkaz.\\
-Samotná práce s plotterem už není nijak složitá a podobá se práci na skutečném SHARPu - nesmíte ovšem zapomenout mít okno s plotterem otevřené. Příkladem může být výstup z programu Picaso plotter od B. Dařbujana.
+==== Harddisk ====
-{{ en:emulators:mz8emu:doc:emu_plotout.gif }}
+<wrap todo>TODO: Je emulován (?) 8/16-bitové rozhraní IDE disků dle specifikace...</wrap>
-==== Harddisk ====
 ===== Debugger =====
-Emulátor poskytuje integrovaný debugger procesoru architektury Z80.
+Emulátor poskytuje integrovaný nástroj debugger určený pro ladění činnosti procesoru architektury Z80. Debugger můžete použít pro krokování vašich programů napsaných ve strojovém kódu. Okno debuggeru zobrazuje průběžně aktuální pozici a zpětný překlad instrukcí (disassembling), zobrazuje aktuální stav registrů a příznaků procesoru (flag).\\
-You can use the debugger to test your machine language programs. To this you can see your program work by showing you continuously the disassembled instructions, the registers, and the flags.\\
+Běh programu je možné pozastavit a krokovat pomocí běhových tlačítek a lze kdykoliv změnit obsah registrů a stav příznaků. Hodnotu registrů lze změnit dvojklikem myši a zadáním nové hodnoty do vstupního řádku. Příznaky je možné měnit změnou zaškrtnutí.
-You can set a break point to stop the program at each point.\\
-You can stop the program by a stop button to set the registers and the flags at each time. Double click on the register which contents you
-want to change, change it in the next window opened by the emulator and then use the run key or the single step key to let the program continue
-his work with the changed register contents and / or the changed flags, if you have changed the flags too.\\
-You can step by step see your program work using the single step button or the F7-key.\\
-This is a good way to test your program and for beginners a good way too to learn programming the Z80 machine code language. Stepping through
+V okně debuggeru je možné používat následující klávesové zkratky:
-the own program will show you how the program works, what each instruction does by watching the flags, memory, stack, and register contents.\\
-If you're one of those who don't know anything about SHARPs MZ's:\\
+^ Klávesa ^ Funkce ^ Popis ^
-Well, use only this emulator for learning programming the Z80 ;-) To this you have not to buy any expensive hardware tool.\\
+| F7 | Step | provedení právě jedné instrukce |
+| F8 | Pause | pozastavení běhu programu |
+| F9 | Run | spuštění programu |
 {{ en:emulators:mz8emu:doc:zadebug.gif |Okno debuggeru}}
-==== Výpis zásobníku ====
+==== Výpis paměti a zásobníku ====
-You can open the stack window to see the contents of the stack or you open the memory dump window to see the contents of the RAM from $0000 to $FFFF.\\
+K dispozici je okno pro výpis obsahu paměti a také okno pro vypsání aktuálního stavu zásobníku. Vypisuje se pouze obsah aktuálního namapování paměti v adresovatelném rozsahu procesoru $0000 to $FFFF.\\
 {{ en:emulators:mz8emu:doc:zastack.gif |Obsah zásobníku procesoru }}
 {{ en:emulators:mz8emu:doc:zamemdmp.gif |Okno s výpisem části paměti}}
-==== Breakpointy ====
+==== Body přerušení ====
-There are two ways to set a break point:\\
+Je možné nastavit více bodů přerušení (breakpoint), při kterých se zastaví provádění instrukcí před prováděním instrukce na daném místě v paměti.\\
-While in debugger stop the program by the Stop button, then right click on a disassembled instruction.\\
+Body přerušení je možné nastavovat dvěma způsoby:\\
+V oknu debuggeru je možné nastavit místo přerušení kliknutím pravým tlačítkem myši na konkrétní instrukci v seznamu instrukcí.\\
 {{ en:emulators:mz8emu:doc:zadebf1.gif |Nastavení bodu přerušení (breakpoint)}}\\
-Or use the debugger's Break button and insert a break point address into the next window opened by the debugger.\\
+Druhou možností je přímo editovat seznam bodů a zde vložit nový bod přerušení zadáním konkrétního umístění v paměti.\\
 {{ en:emulators:mz8emu:doc:zadebbrk.gif |Jiný způsob nastavení bodu přerušení (breakpoint)}}
-You can change any instruction. While in debugger mode press the Stop button and type in any key. Now an inline assembler window is opened. This enables you to type in an instruction which is to be replaced.\\
+==== Integrovaný assembler / disassembler ====
+Debugger umožňuje provádět jak normální (assembling), tak zpětný překlad (disassembling) instrukcí.\\
+Je možné změnit libovolnou instrukci v seznamu instrukcí. Stačí ji zvolit a napsat její název do vstupního řádku, který se objeví po stisku první klávesy.\\
 {{ en:emulators:mz8emu:doc:zadebia.gif |Inline Assembler}}
-==== Integrovaný assembler / disassembler ====
+Stejně tak je možné načíst textový soubor a provést jeho překlad do strojového kódu na konkrétní místo v paměti a také zpětně přeložený kód uložit jako textový soubor.
-The debugger allows you to assemble and to disassemble.
+{{ en:emulators:mz8emu:doc:zadisas2.gif |Disassembler}}
-You can load a file and then you can disassemble the loaded file or any other area in the MZ-800 memories.
-You can save the disassembled output to a TXT-file on disk.
-{{ en:emulators:mz8emu:doc:zadisas2.gif |Dissasembler}}
+==== Načtení a ukládání MZF souborů ====
-==== Registry ====
+Také je možné načítat a ukládat části paměti jako MZF soubory. Tímto postupem je možné načítat programy či data na jiné než v hlavičce souboru uvedené výchozí místo paměti.
-==== Load / Save MZF ====
-==== ostatní ====
+{{ en:emulators:mz8emu:doc:za_dbmzf.jpg |Funkce debuggeru pro načítání MZF souborů}}
+Po zvolení souboru pro načtení je možné případně změnit cílové místo v paměti kam budou data umístěna a případně zvolit pro načtení pouze část souboru.
+Pro uložení je potřeba zadat jak rozsahy adres, tak adresu spuštění, do hlavičky je pak také vhodné zadat název souboru a volitelně také komentář.
+{{ en:emulators:mz8emu:doc:za_dbmzfsave.gif |Uložení části paměti v debuggeru}}
+Kromě toho je také možné do paměti načíst libovolný soubor jako binární data bez hlavičky.
 ===== Nástroje =====
@@ Line 262: / Line 316: @@
 Slouží k převodu formátů MZF,WAV a BIN. Dostupný je z nabídky Tools -> Format convertor. Nejčastější využití zřejmě najde obousměrná konverzi MZF<->WAV kterou lze použít k přenosu programů z kazet do PC, ale také zpětnému přehrání programu přímo do MZ, nebo zpět na kazetu.
 {{ en:emulators:mz8emu:doc:emu_formcnv.gif }}
@@ Line 276: / Line 331: @@
 === Přenos souborů (File transfer) ===
-Je určen nejen pro extrakci jednotlivých souborů z image diskety, ale i pro extrakci zavaděče systému. Detekovány jsou zde zatím tři základní formáty disket na MZ-800, a to: CP/M LEC, originální P-CP/M 80 a DISK BASIC. Pokud nechcete, aby byl formát automaticky zvolen, zrušte zaškrtnutí políčka "Autodetect disc format". Samotná extrakce souborů se děje následovně: standardním způsobem označíte soubory, které chcete z image vytáhnout (více souborů naráz můžete označit, pokud přidržíte tlačítko Shift nebo CTRL) a stisknete ikonku diskety ve spodní nástrojové liště. Potom již emulátor pro každý soubor zobrazí standardní dialogové okno pro uložení souboru, ve kterém si ještě případně můžete upravit jméno souboru. Upozorňuji jen, že emulátor automaticky nahrazuje veškeré znaky, které nejsou povoleny pro název souboru ve Windows znakem "_" (podtržítko). Extrakci zavaděče můžete provést stiskem na červenou ikonu diskety s nápisem IPL. Přenos souborů zpět do image bude možný až v příštích verzích emulátoru.\\
+Je určen nejen pro extrakci jednotlivých souborů z image diskety, ale i pro extrakci zavaděče systému. Detekovány jsou zatím tři základní formáty disket na MZ-800, a to: CP/M LEC, originální P-CP/M 80 a DISK BASIC. Pokud nechcete, aby byl formát automaticky zvolen, zrušte zaškrtnutí políčka "Autodetect disc format". Samotná extrakce souborů se děje následovně: standardním způsobem označíte soubory, které chcete z image vytáhnout (více souborů naráz můžete označit, pokud přidržíte tlačítko Shift nebo CTRL) a stisknete ikonku diskety ve spodní nástrojové liště. Potom již emulátor pro každý soubor zobrazí standardní dialogové okno pro uložení souboru, ve kterém si ještě případně můžete upravit jméno souboru. Upozorňuji jen, že emulátor automaticky nahrazuje veškeré znaky, které nejsou povoleny pro název souboru ve Windows znakem "_" (podtržítko). Extrakci zavaděče můžete provést stiskem na červenou ikonu diskety s nápisem IPL. Přenos souborů zpět do image bude možný až v příštích verzích emulátoru.\\
 {{ en:emulators:mz8emu:doc:emu_dtoolsft.gif }}
@@ Line 282: / Line 337: @@
 === Základní informace o disketě (General info) ===
-  * zobrazí počet stop a stran diskety. Pokud je disketa systémová, zobrazí i jméno systému. V opačném případě zobrazí tři otazníky.
+  * zobrazí počet stop a stran diskety. Pokud je disketa systémová, zobrazí i jméno systému. V opačném případě se zobrazí pouze tři otazníky.
 {{ en:emulators:mz8emu:doc:emu_dtoolsgi.gif }}
@@ Line 288: / Line 343: @@
 ==== Screenshot obrazovky ====
-You can load or save a screen shot by a file name. The file is BMP-formatted.
+Je možné vytvořit screenshot aktuálního stavu emulace jako BMP obrázek.
 {{ en:emulators:mz8emu:doc:zascrsht.gif }}
-===== Tipy a triky =====
-===== Často kladené dotazy =====
 ===== Historie verzí =====
-Version 0.097 news (29.3.2006)
+**Verze 0.097 (29.3.2006)**
-An unpublished and precompiled version on disk found by the author after a long time. The project will be continued next.
+Nezveřejněná a přeložená verze, kterou našel autor odloženou. Projekt by ale snad měl pokračovat.\\
-Version 0.096 news (19.6.2003)
+**Verze 0.096 (19.6.2003)**
-No news available.
+Nejsou známy žádné novinky.\\
-(Note: The copyright screen shows incorrect information for this (last?) version: URL and version number.)
-Version 0.095 news ( beta test version )
+**Verze 0.095 ( beta test )**
-- New design of the virtual CMT
+- nový design virtuálního CMT\\
-- The emulator supports the floppy HD drive A: if the 1.44Mb floppy disk inserted contains one or more DSK-formatted files.
+- podpora pro floppy HD disky A:, pokud je vložena 1.44Mb disketa nebo je takto naformátován DSK soubor.\\
-- errors of the PIT 8253 emulation corrected
+- opraveny chyby v emulaci PIT 8253\\
-- Japanese language support in progress (unfinished)
+- rozpracovaná podpora pro japonštinu\\
-Version 0.092 news
+**Verze 0.092**
-- The emulator supports drag & drop for MZF- and MZS-files
+- Podpora drag & drop pro otevírání MZF a MZS souborů\\
-- code optimizations which improve the emulation speed
+- optimalizace kódu pro zlepšení výkonu\\
 Úplný výpis historie emulátoru:
 {{ http://mz-800.xf.cz/emu_history.htm|http://mz-800.xf.cz/emu_history.htm }}