Differences

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

--- en:emulators:mz8emu:doc [2012/06/14 08:45] – Translated up to harddisk hajdam
+++ en:emulators:mz8emu:doc [2014/06/24 12:13] (current) – hajdam
@@ Line 92: / Line 92: @@
 {{ en:emulators:mz8emu:doc:zacmtopen.gif }}
-=== Loading Files Using Virtual Načítání CMT ===
+=== Loading Files Using Virtual CMT ===
 If the option "CMT patch in ROM" is disabled, or application does not read data using monitor routines, data are expected to be retrieved from the virtual tape. This behavior is typically for programming languages such as BASIC and multipart cassette games. Virtual tape window can be opened from the menu Hardware / Virtual CMT or from cassette icon on the panel.
@@ Line 250: / Line 250: @@
 ==== Harddisk ====
-<wrap todo>TODO: It is emulated (?) 8/16-bitové IDE disks according to specifications...</wrap>
+<wrap todo>TODO: It is emulated (?) 8/16-bits IDE disks according to specifications...</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í (dissasembling), zobrazuje aktuální stav registrů a příznaků procesoru (flag).\\
+Emulator provides an integrated debugger tool designed for debugging Z80 architecture processors. Debugger can be used to trace your programs written in machine code. The debugger window shows the current position and continuously disassemble instructions (disassembling), shows the current state of processor registers and flags (CPU 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í.
+Currently running program can be paused, run-time debugged using the buttons and contents of the registers and status flags can be changed any time. The value of registers can be changed by double clicking and entering new values into the input line. Flags can be changed by checking the boxes.
-V okně debuggeru je možné používat následující klávesové zkratky:
+In the debugger you can use the following keyboard shortcuts:
-^ Klávesa ^ Funkce ^ Popis ^
+^ Key ^ Function ^ Description ^
-| F7 | Step | provedení právě jedné instrukce |
+| F7 | Step | single instruction execution |
-| F8 | Pause | pozastavení běhu programu |
+| F8 | Pause | pause the program |
-| F9 | Run | spuštění programu |
+| F9 | Run | run the program |
-{{ en:emulators:mz8emu:doc:zadebug.gif |Okno debuggeru}}
+{{ en:emulators:mz8emu:doc:zadebug.gif |Debugger window}}
-==== Výpis paměti a zásobníku ====
+==== Memory and Stack Dump ====
-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.\\
+There is a window to list the content of memory and also a window to list the current state of the stack. You can see only current mapping of content of addressable memory within range available to the processor $0000 to $FFFF.\\
-{{ en:emulators:mz8emu:doc:zastack.gif |Obsah zásobníku procesoru }}
+{{ en:emulators:mz8emu:doc:zastack.gif |Stack content window}}
-{{ en:emulators:mz8emu:doc:zamemdmp.gif |Okno s výpisem části paměti}}
+{{ en:emulators:mz8emu:doc:zamemdmp.gif |Memory listing window}}
-==== Body přerušení ====
+==== Breakpoints ====
-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.\\
+You can set multiple breakpoints in which instruction execution stops before executing the next instruction at the memory.\\
-Body přerušení je možné nastavovat dvěma způsoby:\\
+Breakpoints can be set in two ways:\\
-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í.\\
+In the debugger window, you can set a breakpoint by right-clicking on the specific instruction in the list of instructions.\\
-{{ en:emulators:mz8emu:doc:zadebf1.gif |Nastavení bodu přerušení (breakpoint)}}\\
+{{ en:emulators:mz8emu:doc:zadebf1.gif |Setting new 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.\\
+Another option is to directly edit the list of breakpoints and insert there a new breakpoint by entering a specific location in memory.\\
-{{ en:emulators:mz8emu:doc:zadebbrk.gif |Jiný způsob nastavení bodu přerušení (breakpoint)}}
+{{ en:emulators:mz8emu:doc:zadebbrk.gif |Alternative method for setting breakpoint}}
-==== Integrovaný assembler / disassembler ====
+==== Integrated Assembler / Disassembler ====
-Debugger umožňuje provádět jak normální (assembling), tak zpětný překlad (dissasembling) instrukcí.\\
+Debugger allows you to perform both normal (assembling) and reverse translation (disassembling) of the processor instructions.\\
-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.\\
+You can change any instruction in the list of instructions. Just select it and type its name into the input box that appears after pressing the first key.\\
 {{ 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.
+It is also possible to load a text file and perform its translation into machine code at a specific location in memory and you can also save re-translated code as a text file.
-{{ en:emulators:mz8emu:doc:zadisas2.gif |Dissasembler}}
+{{ en:emulators:mz8emu:doc:zadisas2.gif |Disassembler}}
-==== Načtení a ukládání MZF souborů ====
+==== Loading and Saving MZF Files ====
-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.
+You can also load and save memory space as MZF files. Following procedure allows you to load programs or data into other memory address than the one stored in the header of the file.
-{{ en:emulators:mz8emu:doc:za_dbmzf.jpg |Funkce debuggeru pro načítání MZF souborů}}
+{{ en:emulators:mz8emu:doc:za_dbmzf.jpg |Debugger function of loading MZF files}}
-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.
+After selecting the file to load it is possible to change the target location in memory where the data is stored and possibly choose for storing smaller part of file only.
-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ář.
+To save you need to enter address ranges and address of the start of execution, then the header is also advisable to specify a file name and optionally a comment.
-{{ en:emulators:mz8emu:doc:za_dbmzfsave.gif |Uložení části paměti v debuggeru}}
+{{ en:emulators:mz8emu:doc:za_dbmzfsave.gif |Save part of memory in debugger}}
-Kromě toho je také možné do paměti načíst libovolný soubor jako binární data bez hlavičky.
+It is also possible to load into memory from any file as binary data without header.
-===== Nástroje =====
+===== Tools =====
-==== Převaděč formátů ====
+==== Format Convertor ====
-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.
+This tool allows you to convert files between MZF, WAV and BIN formats. It is available from the Tools menu -> Format converter. The most common use is probably a two-way conversion between MZF <-> WAV, which can be used to transfer programs from cassettes to PC but also to play-back it directly to the MZ, or back to tape.
 {{ en:emulators:mz8emu:doc:emu_formcnv.gif }}
-==== Správa disků ====
+==== Disk Tools ====
-Slouží k lepší a pohodlnější práci s obrazy disket. Umožňuje následující věci:\\
+It serves for better and more comfortable working with disk images. It provides the following functions:\\
-=== Struktura disku (Disc structure) ===
+=== 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:\\
+Graphical browser for the distribution sector on a floppy disk, with different color for bad sectors, or unformatted space. To show / hide information press "Legend" button. If it is a double-sided floppy disk, you can choose to display zero or first page using Combobox on the bottom of left side. Underneath it there is selection combobox for displaying a floppy disk in drives A: - D:\\
 {{ en:emulators:mz8emu:doc:emu_dtoolsds.gif }}
-=== Přenos souborů (File transfer) ===
+=== 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.\\
+It is designed not only to extract individual files from a floppy disk image, but also to extract the boot loader. It detect three basic formats of floppies on MZ-800 so far, and CP/M LEC, the original P-CP/M 80 and DISK BASIC. If you do not want to detect format automatically, uncheck "Autodetect disc format" option. The actual extraction of files is done as follows: a standard way to indicate the files you want extracted from the image (you can select multiple files at once if you hold the Shift key or Ctrl) and press the disc icon in the bottom toolbar. Thereafter the emulator displays the standard dialog box for each item to save the extracted file, where you have can edit the file name. The emulator automatically replaces all characters that are not allowed as the name of the file in Windows as the character "_" (underscore). You can extract the bootloader by pressing the red disk icon labeled IPL. Transferring files back into the image will only be possible in future versions of the emulator.\\
 {{ en:emulators:mz8emu:doc:emu_dtoolsft.gif }}
-=== Základní informace o disketě (General info) ===
+=== Floppy Disk 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.
+ * Show number of tracks and the disk sides. If the disk is bootable, it displays the name of the system. Otherwise, it only shows three question-marks.
 {{ en:emulators:mz8emu:doc:emu_dtoolsgi.gif }}
-==== Screenshot obrazovky ====
+==== Screenshot ====
-Je možné vytvořit screenshot aktuálního stavu emulace jako BMP obrázek.
+You can create a screenshot of the current state of emulated system as a BMP file.
 {{ en:emulators:mz8emu:doc:zascrsht.gif }}