SHARP MZ-800 Fans Community Web

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== SHARP MZ-800 Emulátor pro Windows Zdeňka Adlera ======

Toto není oficiální dokumentace/nápověda pro uvedený emulátor.

Použité zdroje:
  * {{ http://mz-800.xf.cz/emulator.htm|http://mz-800.xf.cz/emulator.htm }}
  * {{ http://sharpmz.org/zaemul.htm|http://sharpmz.org/zaemul.htm }}

===== 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 velkým počtem zařízení, které se s tímto počítačem používaly.

{{ en:emulators:mz8emu:doc:emu_main.gif }}

Emulátor je určen nejen pro běžné uživatele kteří si rádi oživí svoji počítačovou historii, ale i pro programátory, pro něž je určen integrovaný řádkový assembler, disassembler, debugger s jejichž pomocí je možné programy vyvíjet a ladit přímo na PC.

===== Minimální systémové požadavky =====

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 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 =====

Emulován je veškerý hardware SHARPa a to:

    * Procesor Z80 včetně nedokumentovaných instrukcí s přesným časováním
    * Grafický procesor GDG - obrazovka emulovaná přes scanlines, možnost výběru 16/32 KB Videoram, emulovány všechny grafické mody včetně dvou nedokumentovaných (3 a 7)
    * Z80-PIO, 8253, 8255
    * Zvuk - PSG emulovány všechny 3 kanály + 1 šumový (bílý i synchronní šum) + jeden kanál z 8253, vše v kvalitě 44100 Hz, 8 bitů
    * Řadič floppy disku kompatibilní s WD279X, emulace disketové jednotky pomocí image
    * Emulace MZ-IDE (8-bitové rozhraní pro připojení harddisku), viz. další text.
    * Quick disk MZ-1F11 včetně řadiče
    * Virtuální magnetofon
    * Ramdisk zálohovaný (komp. s originálem) až do velikosti 1 MB nebo nezálohovaný Pezik 512KB
    * Emulace barevného/černobílého/zeleného monitoru
    * Emulace myši
    * Čtyřbarevný plotter MZ-1P16

===== Licence emulátoru =====

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$) 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í 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 }}

==== Postup při instalaci nové verze ====

Emulátor je potřeba stáhnout z webu autora [[http://mz-800.xf.cz/download.htm]].

<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 ====

Emulátor poskytuje dva způsoby načítání souborů z kazet.

=== Rychlé načítání souborů ===

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 ===

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.

{{ en:emulators:mz8emu:doc:zavirtcmt.gif }}

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 ====

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 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 }}

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.\\

{{ en:emulators:mz8emu:doc:zavideo3.gif }}

{{ en:emulators:mz8emu:doc:zavideo2.gif }}

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š ====

V následující tabulce naleznete rozložení některých speciálních kláves které nebylo kam umístit a jejichž hledání by vám mohlo zabrat spoustu času. Většinu ostatních kláves již najdete na podobných místech, kde byly přímo na SHARPu. Pozor však na to, že na MZ bylo například nad středníkem znaménko plus...

^ Klávesa MZ ^ Klávesa PC ^
| ?          | F8         |
| BREAK/ESC  | End        |
| DEL        | Backspace  |
| INST       | Insert     |
| TAB        | TAB        |
| GRAPH      | Caps Lock  |
| ALPHA      | \          |
| BLANK KEY  | ~          |
| @          | F6         |
| \          | F7         |

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ů.

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 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 volba pro indikaci neobsazeného portu. Standardně je na portu JOY1 joystick simulovaný pomocí num. klávesnice a port JOY2 není obsazený (None).

==== Magnetofon ====

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:\\

04D8h - Load head\\
04F8h - 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". Po aktivaci tohoto nastavení je nutný reset emulovaného počítače.\\

**Virtuální magnetofon (virtual CMT)**\\

{{ 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.\\

{{ en:emulators:mz8emu:doc:emu_setcmt.gif }}

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):\\

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 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.

==== 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. 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".\\

{{ en:emulators:mz8emu:doc:emu_qdsetup.gif }}

Následuje příklad použití pomocí základní softwarové výbavy uložené v ROMce SHARPa. Po vytvoření nového image je třeba jej před použitím zformátovat. To provedete z monitoru pomocí příkazu QF.\\

{{ en:emulators:mz8emu:doc:emu_qdformat.gif }}

Nahrání programu z kazety na disk - QX\\
Výpis adresáře disku - QD\\
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 ====

Je plně emulován - 3 kanály tónové a 1 šumový (čip SN 76489AN). Šumový generátor je dělaný přesně podle originálu, emuluje se jak bílý, tak i synchronní šum. To vše je v kvalitě 44100 Hz, 8 bitů mono. Zvuk by měl být na rychlém PC (>500 MHz) dostatečně čistý a kvalitní.\\

{{ en:emulators:mz8emu:doc:emu_psgsetup.gif }}

Nastavení je vcelku jednoduché - je možné v něm řídit hlasitost zvukového výstupu (neovlivňuje mixer systému Windows), z hlediska co nejvyšší kvality ale doporučuji mít tento prvek nastavený na maximum - v opačném případě by se mohly ztrácet tóny s nízkou hlasitostí. Dále je možné zvuk úplně umlčet zatržítkem "Mute" nebo kliknutím na ikonku reproduktoru v hlavní nástrojové liště emulátoru, případně je tu možnost umlčet pouze šumový generátor (položka "Emulate noise").

==== Tiskárny ====

=== 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 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 }}

Emulaci plotteru spustíme jednoduše - buď z menu Hardware->Plotter MZ-1P16, nebo v hlavní nástrojové liště emulátoru kliknutím na ikonku tiskárny. POZOR - plotter je emulován pouze tehdy, je-li jeho okno otevřené (nemusí být aktivní). Jakmile jeho okno zavřete, bude tvářit, jako by byl vypnutý a programy s ním nebudou spolupracovat!\\

{{ en:emulators:mz8emu:doc:emu_plot.gif }}

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.\\

==== Harddisk ====

<wrap todo>TODO: Je emulován (?) 8/16-bitové rozhraní IDE disků dle specifikace...</wrap>

===== Debugger =====

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).\\

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í.

V okně debuggeru je možné používat následující klávesové zkratky:

^ Klávesa ^ Funkce ^ Popis ^
| 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 paměti a zásobníku ====

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}}

==== Body přerušení ====

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.\\

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)}}\\

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)}}

==== 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}}

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.

{{ en:emulators:mz8emu:doc:zadisas2.gif |Disassembler}}

==== Načtení a ukládání MZF souborů ====

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.

{{ 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 =====

==== Převaděč formátů ====

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 }}

==== Správa disků ====

Slouží k lepší a pohodlnější práci s obrazy disket. Umožňuje následující věci:\\

=== Struktura disku (Disc structure) ===

Graficky znázorní rozložení sektorů na disketě, barevně dokáže odlišit vadné sektory, nebo neformátovaný prostor. Pro zobrazení / skrytí legendy stiskněte tlačítko "Legend". Pokud se jedná o oboustrannou disketu, můžete vybrat zobrazení nulté nebo první strany pomocí comboboxu vlevo dole. Ještě pod ním se nachází combobox pro výběr zobrazení diskety v mechanice A: - D:\\

{{ en:emulators:mz8emu:doc:emu_dtoolsds.gif }}

=== 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 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 }}

=== 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ě se zobrazí pouze tři otazníky.

{{ en:emulators:mz8emu:doc:emu_dtoolsgi.gif }}

==== Screenshot obrazovky ====

Je možné vytvořit screenshot aktuálního stavu emulace jako BMP obrázek.

{{ en:emulators:mz8emu:doc:zascrsht.gif }}

===== Historie verzí =====

**Verze 0.097 (29.3.2006)**

Nezveřejněná a přeložená verze, kterou našel autor odloženou. Projekt by ale snad měl pokračovat.\\

**Verze 0.096 (19.6.2003)**

Nejsou známy žádné novinky.\\

**Verze 0.095 ( beta test )**

- nový design virtuálního CMT\\
- podpora pro floppy HD disky A:, pokud je vložena 1.44Mb disketa nebo je takto naformátován DSK soubor.\\
- opraveny chyby v emulaci PIT 8253\\
- rozpracovaná podpora pro japonštinu\\

**Verze 0.092**

- Podpora drag & drop pro otevírání MZF a MZS souborů\\
- 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 }}