diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ddtz-de.txt | 1141 | ||||
| -rw-r--r-- | doc/ddtz-help.txt | 121 | ||||
| -rw-r--r-- | doc/ddtz-ref-short.txt | 150 | ||||
| -rw-r--r-- | doc/ddtz-ref.txt | 204 |
4 files changed, 1616 insertions, 0 deletions
diff --git a/doc/ddtz-de.txt b/doc/ddtz-de.txt new file mode 100644 index 0000000..57a5271 --- /dev/null +++ b/doc/ddtz-de.txt @@ -0,0 +1,1141 @@ +
+
+
+ ***************************************
+ ***** *****
+ ***** DDTZ *****
+ ***** *****
+ ***************************************
+
+ Ein Programmentwicklungs- und Fehlersuch-Werkzeug fuer Z80-
+ Mikrocomputer
+
+
+ Einfuehrung
+ ===========
+
+ Das DDTZ ist ein komfortables Werkzeug zum Entwickeln und
+ Austesten von Z80-Programmen, sowie zum Ueberpruefen des Zusam-
+ menwirkens zwischen Programm und Hardware-System.
+
+ Folgende Komponenten sind im DDTZ enthalten:
+
+ - Assembler zum Direkt-Eingeben von Programmaenderungen oder
+ kleineren vollstaendigen Programmen in Z80-Assemblersprache.
+ - Disassembler zum Rueck-Uebersetzen von Maschinenprogrammen.
+ - Tracer zum Ausfuehren von Programmen in Einzelschritten und
+ zur Programmausfuehrung mit vorgebbaren Abbruchbedingungen.
+ - Disk Ein/Ausgaberoutinen erlauben das Lesen und Schreiben von
+ Files.
+ - Ausdruck-Interpreter erlaubt bei allen Kommandos die Verwen-
+ dung von arithmetischen und logischen Ausdruecken mit HEX-,
+ Dezimal-, Binaer- und ASCII-Werten, sowie Speicher- und
+ Registerinhalten und Variablen.
+
+ Das DDTZ laeuft unter dem CP/M-Betriebssystem (Digital
+ Research, ab Version 1.4) und anderen dazu kompatiblen Sys-
+ temen. Es benoetigt eine Z80-CPU und belegt 8,5 KBytes Spei-
+ cher.
+ Da Konsol-Eingaben nur ueber die CP/M-Stringeingabefunktion
+ erfolgen, ist das DDTZ auch mit dem CP/M-Hilfsprogramm XSUB
+ lauffaehig.
+
+ Der Gebrauch des DDTZ
+ =====================
+
+ Der Aufruf
+ ----------
+
+ Auf Ihrer DDTZ-Originaldiskette befindet sich die File
+ DDTZ.COM. Bevor Sie diese das erste Mal aufrufen, kopieren Sie
+ bitte die File auf eine andere Diskette, die Sie dann zum
+ Arbeiten benutzen. Bewahren Sie die Originaldiskette an einem
+ sicheren Ort auf und benutzen Sie sie nur zum Anfertigen
+ weiterer Arbeitsdisketten. Verwenden Sie also nie das Original
+ als Arbeitsdiskette.
+
+ Das DDTZ wird entsprechend den CP/M-Regeln folgendermassen
+ aufgerufen:
+
+ DDTZ
+ oder
+ DDTZ d:filename.ext
+
+ Bei beiden Aufrufen laedt das Disk Operating System das DDTZ
+ bei Adresse 100H beginnened in den Speicher. Das DDTZ verlagert
+ sich danach automatisch direkt vor das BDOS und ueberschreibt
+ dabei den CCP. Dadurch wird der Speicher ab 100H fuer das zu
+ untersuchende Programm frei. Der Adressteil des Befehls JP BDOS
+ auf Adresse 5 wird erniedrigt, um den Anwenderprogramm die
+ durch das DDTZ verringerte Speichergroesse mitzuteilen. Der
+ urspruenglich vom DDTZ belegte Speicher wird daraufhin mit
+ Nullen geloescht.
+ Wurde im Aufruf ein Filename angegeben, so laedt das DDTZ die
+ File in den Speicher.
+ Nach Ausgabe des Prompt-Zeichens '>' ist das DDTZ betriebs-
+ bereit.
+
+ Die Kommandos
+ -------------
+
+ Jede Taetigkeit des DDTZ, z.B. Lesen einer File, Disassemblie-
+ ren eines Programm-Abschnittes usw. wird mit einem Kommando
+ eingelei-tet. Kommandos koennen immer dann eingegeben werden,
+ wenn das DDTZ mit dem Prompt-Zeichen '> ' oder '>>' seine
+ Bereitschaft anzeigt.
+
+ Kommandos beginnen mit einem der Zeichen '@' bis 'Z', eventuell
+ gefolgt von weiteren optionalen Buchstaben, sowie Argumenten.
+ Bei einigen Kommandos sind alle Argumente obligat, d.h. alle
+ Argumente muessen angegebnenwerden. Bei anderen Kommandos sind
+ jedoch die Argumente alle oder zum Teil optional, d.h. sie
+ koennen entweder explizit angegeben werden, duerfen aber auch
+ weggelassen werden. Wird eine optionale Anfangsadresse wegge-
+ lassen, so wird die Adresse benutzt, bei der das Kommando
+ zuletzt beendet wurde. Wird eine optionale Endadresse weggelas-
+ sen, so wird das Kommando (z.B. L oder D) so lange ausgefuehrt,
+ bis etwa ein Bildschirm vollgeschrieben ist. Ein weggelassenes
+ optionales Argument, hinter dem weitere Argumente angegeben
+ werden sollen, muss durch ein Komma ersetzt werden. Optionale
+ Elemente sind in den folgenden Kommando-Beschreibungen durch
+ eckige Klammern gekennzeichnet (die Klammern sind also nicht
+ mit einzugeben). Zwischen zwei Argumenten muss ein Blank, ein
+ Tab (^I) oder ein Komma stehen.
+
+ Argumente werden im allgemeinen als HEX-Zahlen eingegeben,
+ duerfen aber auch als Dezimal- und Binaerzahlen, als ASCII-
+ Werte, Variablen oder in Form arithmetischer Ausdruecke einge-
+ geben werden. HEX-Zahlen sind im DDTZ Zahlen, die aus den
+ Ziffern 0 bis 9 und den Buchstaben A bis F (oder a bis f)
+ bestehen und nicht durch weitere Zusaetze (z.B. Buchstabe H)
+ als HEX-Zahl gekennzeichnet sein muessen. Im Gegensatz zu den
+ meisten Assemblern sind HEX-Zahlen, deren erstes Zeichen ein
+ Buchstabe ist, im DDTZ erlaubt. Dezimal-Zahlen werden zur
+ Unterscheidung mit einem Punkt abgeschlossen und Binaerzahlen
+ tragen am Ende ein doppeltes Anfuehrungszeichen. Naeheres zur
+ Eingabe von Zahlen, Variablen und Ausdruecken finden Sie bei
+ der Beschreibung des H-Kommandos und im Anhang.
+
+ Bei Kommandos, die eine Start- und eine Endadresse erfordern,
+ kann anstelle der Endadresse auch der Buchstabe 'S', gefolgt
+ von einer Laengenangabe verwendet werden.
+ z.B. bedeutet D 1000 S 100 oder D1000s100
+ das selbe wie D 1000 10FF oder d1000,10ff
+
+ Bei allen Eingaben ist es einerlei, ob Gross- oder Kleinbuch-
+ staben verwendet werden. Die einzige Ausnahme ist die Eingabe
+ von ASCII-Zeichen und Zeichenketten.
+
+ Die Wiederhol-Funktion
+ ----------------------
+
+ Beim Gebrauch des DDTZ kommt es oefters vor, dass man einen
+ Befehl nicht nur einmal benutzt und danach einen anderen Befehl
+ anwendet, sondern das man ein und denselben Befehl mehrmals
+ wiederholen will. Moechte man z.B. ein Programm in Einzel-
+ schritten ausfuehren lassen, um nach jedem Schritt die Register
+ zu inspizieren, so waere fuer jeden Schritt die Eingabe eines
+ Trace-Kommandos ohne Argumente notwendig (also der Buchstabe
+ 'T' und die Return-Taste). Ein weiteres Beispiel ist das Ueber-
+ pruefen der Hardware eines Ausgabeports: Will man mit einem
+ Oszilloskop Signale eines Ausgabeports ueberpruefen, so waere
+ es sehr laestig, zur wiederholten Ausgabe eines Testbytes an
+ den Port waehrend der Beobachtung des Oszilloskops immer wieder
+ das 'O'-Kommando eingeben zu muessen.
+ Aus diesen Gruenden besitzt das DDTZ die Wiederholfunktion.
+ Diese bewirkt, dass bei einer leeren Eingabe (nur Return-Taste)
+ das letzte Kommando ohne Argumente wiederholt wird. Die Bereit-
+ schaft der Wiederhol-Funktion wird durch einen doppelten Prompt
+ '>>' anstelle des einfachen '> ' angezeigt.
+
+ Die Kommandos des DDTZ
+ ======================
+
+ Im Folgenden werden alle Kommandos des DDTZ erklaert und mit
+ Beispielen verdeutlicht. Im Bereich der Computertechnik hat es
+ sich international eingebuergert, englische Bezeichnungnen zu
+ benutzen. Deshalb sind auch beim DDTZ die Kommandos Abkuer-
+ zungen englischer Woerter. Diese sind neben einer deutschen
+ Bezeichnung am Anfang jeder Kommando-Erklaerung mit angegeben.
+ Zur Einarbeitung empfiehlt es sich, an dieser Stelle des DDTZ
+ schon einmal zu starten und die im kommenden Abschnitt erklaer-
+ ten Kommandos der Reihe nach auszuprobieren. Assemblieren Sie
+ ein simples Testprogramm mit dem A-Kommando,
+
+ z.B.: > A100
+ 0100 NOP ld a,0
+ 0102 NOP dec a
+ 0103 NOP jp nz,102
+ 0106 NOP jp 0
+ 0109 NOP .
+
+ Listen Sie das Programm dann mit dem L-Kommando in disassem-
+ blierter Form aus, setzen Sie einen Breakpoint auf Adresse 0
+ mit dem B-Kommando und starten Sie es mit dem G-Kommando usw.
+ Nach einigem Ausprobieren und Spielen mit dem DDTZ werden Sie
+ sicher schnell die vielen Moeglichkeiten dieses komfortablen
+ Werkzeugs kennen und nutzen koennen.
+
+ @
+ -
+
+ Anzeigen und eventuell Aendern des Displacement-Registers.
+ (examin [substitude] displacement register @)
+
+ Der derzeitige Wert wird angezeigt und ein neuer - angefor-
+ dert. Eine leere Eingabe (nur Return-Taste) belaesst den alten
+ Wert.
+
+ Ein mit dem DDTZ zu bearbeitendes Programm kann natuerlich nur
+ innerhalb des verfuegbaren Adressraums in den Speicher geladen
+ werden, muss also mindestens bei Adresse 100H beginnen und darf
+ sich nicht mit dem DDTZ oder dem System ueberlappen. Um ein
+ Programm, das beispielsweise bei Adresse 0 oder F000H beginnt,
+ zu bearbeiten, muss dieses entsprechend verschoben in den Spei-
+ cher geladen werden. Damit beim Disassemblieren, Modifizieren
+ mit Hilfe des eingebauten Assemblers, Auslisten in HEX/ASCII
+ usw. trotzdem die korrekten Adressen angezeigt werden, ist ein
+ Displacement-Register @ (Verschiebungsregister) vorhanden,
+ dessen Wert auf die Differenz Solladresse minus Ladeadresse
+ gesetzt werden kann. Ist @ ungleich Null, so zeigt das DDTZ
+ ueberall, wo Adressen ausgelistet werden, die Adressen auch in
+ der Form @xxxx an, wobei xxxx die Solladresse des verschobenen
+ Programms ist.
+ Eine andere Anwendungsmoeglichkeit des Displacement-Registers
+ ist das Bearbeiten von Subroutinen, die mit Hilfe eines Linkers
+ in ein Programm eingebunden wurden, und zu denen im Allgemeinen
+ nur ein Listing beginnend ab Adresse 0 vorhanden ist. In diesem
+ Fall wird das @-Register auf die aus der Symboltabelle des
+ Linkers zu entnehmende Anfangsadresse der Routine gesetzt.
+ Jeder Adresse xxxx im Listing entspricht dann die Adresse @xxxx
+ im Speicher.
+ Achtung: Programme, die (ohne Linker) im Speicher verschoben
+ wurden, koennen zwar z.B. disassembliert oder modifiziert,
+ jedoch nicht ausgefuehrt werden.
+
+ A
+ -
+ Assemblieren von Z80-Befehlen.
+ (Assemble Zilog Z80 mnemonics)
+
+ Beginnend bei der optionalen Anfangsadresse werden als Z80-
+ Mnemonics eingegebene Befehle direkt in den Speicher assem-
+ bliert. Das DDTZ zeigt jeweils den an dem betreffenden Spei-
+ cherplatz bereits stehenden Befehl zur Kontrolle an, worauf ein
+ neuer Z80-Befehl eingegeben werden oder mit einer leeren Ein-
+ gabe zum naechsten Befehl uebergegangen werden kann. Die Ein-
+ gabe eines Minuszeichens bewirkt ein Ruecksetzen auf den vor-
+ letzten Befehl zur Kontrolle oder Korrektur, ein Punkt beendet
+ das Assemblieren. Die Form der Befehle ist Zilog-kompatibel mit
+ einigen Erweiterungen:
+ Statt ADD A,... SBC A,... usw. koennen auch Kurzformen ADD ...
+ SBC ... usw. benutzt werden. Bei den Befehlen IN A,(ausdruck)
+ und OUT (ausdruck),A koennen die Klammern weggelassen werden.
+ Der Opcode ist von dem Argument durch Tabs oder Blanks ge-
+ trennt.
+ Auf die Adresse des Z80-Befehls kann - wie bei Assemblern
+ ueblich - mittels des $-Zeichens Bezug genommen werden, z.B.
+ ist der Befehl JR Z,$+4 identisch mit JR 204, wenn der Befehl
+ bei Adresse 200 steht.
+ Achtung: Da beim DDTZ HEX-Zahleneingaben ohne fuehrende Dezi-
+ malziffer zulaessig sind, koennen beim Assemblieren Zweideut-
+ igkeiten entstehen oder Fehler unerkannt bleiben, z.B. soll das
+ Register A mit dem Hex-Wert 0B geladen werden, so ist LD A,0B
+ einzugeben, da mit LD A,B das Register B angesprochen wird. Der
+ Befehl LD BC,DE wird als LD BC,0DE interpretiert, da es einen
+ Z80-Befehl, der das BC-Register aus dem DE-Register laedt,
+ nicht gibt.
+
+ B
+ -
+
+ Anzeigen aller Breakpoints.
+ (display all breakpoints)
+
+ Die Adressen, Wiederholungszaehler und Bedingungen aller ge-
+ setzten Breakpoints werden aufgelistet.
+
+
+ B breakp [breakp..]
+ -------------------
+
+ Breakpoints setzen.
+ (set breakpoints)
+
+ Zum Austesten eines Programms ist es erforderlich, das Programm
+ nicht nur starten zu koennen, sondern der Ablauf des Programms
+ muss sich auch bequem verfolgen und beobachten lassen. Neben
+ den Tracen (siehe Kommandos T und C) ist das Setzen von Break-
+ points (Unterbrechungspunkten) eine sehr komfortable Moeglich-
+ keit, den Programmablauf zu verfolgen.
+ Ein Breakpoint wird auf das erste Byte (den Opcode) eines
+ Maschinenbefehls gesetzt und bewirkt, dass der Programmablauf
+ unterbrochen wird, sobald der Programmzaehler bei dieser Adres-
+ se angekommen ist. Man kann dann die Registerinhalte inspizie-
+ ren, Speicherinhalte kontrollieren usw., um danach den Pro-
+ grammablauf fortzusetzen oder an einer anderen Stelle fortzu-
+ fahren.
+ Neben der Adresse, die bestimmt, wo der Breakpoint zu setzen
+ ist, koennen noch zusaetzliche Optionen gewaehlt werden.
+
+ Ein Breakpoint wird in folgender Form definiert:
+ [R] adresse [:zaehler] [I bedingung]
+ Der optionale Buchstabe R bedeutet, dass jedesmal beim Errei-
+ chen des Breakpoints die CPU-Registerinhalte ausgelistet werden
+ sollen, auch dann, wenn wegen eines Zaehlers oder einer Bedin-
+ gung der Breakpoint keinen Programmstopp bewirkt.
+ Die Adresse ist ein beliebiger Ausdruck, der auf einen Opcode
+ zeigen muss.
+ Der Zaehler kann auf einen Wert n<>1 gesetzt werden und be-
+ wirkt, dass jedesmal, wenn die Breakpointadresse durchlaufen
+ wird, der Zaehler um Eins erniedrigt wird und erst beim n-ten
+ Mal ein Programmstop erfolgt. Er steht dann auf 1.
+ Eine Bedingung (der Buchstabe I fuer 'if'='wenn', gefolgt von
+ einem Ausdruck) bestimmt, ob ein Programmstop bzw. ein Dekre-
+ mentieren des Wiederholungs-Zaehlers erfolgen soll.
+ z.B.: > B R 200 I ^A=0
+ listet jedesmal, wenn Adresse 200 angelaufen wird, die
+ Register aus und unterbricht den Programmlauf, falls das
+ A-Register den Wert 0 hat.
+ > B Y0:16., R $ I0
+ setzt zwei Breakpoints:
+ 1. Wird 16 mal die Adresse, die in der Variablen Y0
+ steht, angelaufen, so wird das Programm unterbrochen.
+ 2. Wird die Adresse, auf der der Programmzaehler zum
+ Zeitpunkt der Breakpoint-Eingabe stand, durchlaufen,
+ so werden die Register ausgelistet, aber nicht unter-
+ brochen (Bedingung immer 'falsch').
+
+ Um den Benutzer zusaetzliche Eingriffsmoeglichkeiten zu geben,
+ werden alle Breakpoints, auch mit Zaehlern ungleich Null oder
+ unerfuellten Bedingungen, trotzdem aktiv, wenn eine beliebige
+ Taste an der Konsole gedrueckt wird.
+ Wird ein Breakpoint auf eine Adresse gesetzt, auf der sich
+ bereits ein Breakpoint befindet, so wird der bereits vorhandene
+ automatisch geloescht.
+ Achtung: Breakpoints koennen nur im RAM gesetzt werden; in
+ Programmen die in ROM's oder EPROM's enthalten sind, sind
+ Breakpoints nicht moeglich (Siehe folgenden Abschnitt).
+
+ Interne Breakpointbehandlung des DDTZ:
+
+ Wird ein Programm mit dem G-Kommando gestartet, so ersetzt das
+ DDTZ alle Opcodes, auf die eine Breakpoint-Adresse zeigt, durch
+ einen Restart-Befehl RST n und bewahrt die Opcodes auf. In die
+ Adresse n, auf die der RST-Befehl springt, wird ein Sprungbe-
+ fehl eingesetzt, der in den Breakpoint-Handler des DDTZ fuehrt.
+ Nach einem Programmstop werden die Opcodes wieder eingesetzt,
+ sodass das Programm immer dann, wenn es dem Benutzer zugaeng-
+ lich ist, unmodifiziert ist. Als RST-Adresse ist 38H voreinge-
+ stellt. Ist die Adresse 38H jedoch fuer andere Zwecke bereits
+ vergeben, so kann der RST-Befehl geaendert werden, z.B. auf
+ 30H:
+ > AT4
+ xxx9 RST 38 rst 30
+ xxxA xxx .
+
+
+ BX
+ --
+
+ Loeschen aller Breakpoints.
+ (clear all breakpoints)
+
+ BX adresse [adresse..]
+ ----------------------
+
+ Loeschen der Breakpoints an den angegebenen Adressen.
+ (clear breakpoints)
+
+ C[N][J] ]befehlsanzahl]
+ C[N][J] W ausdruck
+ C[N][J] U ausdruck
+ ------------------
+
+ Tracen ueber CALLs [ohne Ausgabe] [nue Sprungbefehle]
+ / ..solange.. / ..bis..
+ (trace over CALLs [No list] [Jumps only] /..While../..Until..
+
+ Tracen wie mit dem T-Kommando, nur mit dem Unterschied, dass
+ eine Subroutine wie ein einzelner Maschinenbefehl gehandhabt
+ wird. Bei jedem CALL-Befehl wird also die aufgerufene Routine
+ in Echtzeit abgearbeitet und erst bei Erreichen des auf den
+ CALL-Befehl folgenden Befehls wird wieder in den Trace-Modus
+ zurueckgekehrt. (siehe T-Kommando).
+ Achtung: Das C-Kommando funktioniert nur dann, wenn die Subrou-
+ tine nach ihrer Beendigung zu der auf den CALL-Befehl folgenden
+ Adresse zurueckkehrt. Ein Programm der Form
+ CALL SUBR
+ DB ARG
+ mit einer Routine SUBR, die nach Abarbeitung hinter dem Argu-
+ ment ankommt, kann nicht mit C bearbeitet werden.
+
+
+ D [startadr] [endadr]
+ ---------------------
+
+ Auslisten des Speichers in HEX und ASCII
+ (Display memory in hex and ASCII)
+
+ Der Speicher-Inhalt wird beginnend bei der Startadresse bis zur
+ Endadresse in HEX und ASCII auf der Konsole ausgelistet. Die
+ ASCII-Anzeige ignoriert das Bit 7 des jeweiligen Bytes. Ist der
+ Wert eines Bytes nicht als ASCII-Zeichen druckbar, so wird
+ statt dessen ein Punkt ausgegeben.
+
+ F-Kommandozeile
+ ---------------
+
+ File-Cointrolblock und CP/M-Kommandozeile spezifizieren.
+ (specify Filename and command line)
+
+ Dieses Kommando hat zwei Anwendungen:
+
+ 1. Vor einem Einlesen oder Ausschreiben einer File vom DDTZ aus
+ wird mit dem F-Kommando der Filename angegeben.
+ z.B. Einlesen eines zu testenden Kopier-Programms mit dem
+ Namen 'COPY.COM' von der Diskette A:
+ > Fa:copy.com
+ > R
+ 2. Soll ein Programm ausgetestet werden, das beim Aufruf vom
+ CP/M aus eine Kommandozeile im Kommandopuffer bei 80H und
+ File-Control-Blocks bei 5CH und 6CH erwartet, so kann mit
+ dem F-Kommando des DDTZ der CP/M-Aufruf simuliert werden.
+ z.B. Das im obigen Beispiel eingelesene Programm soll so ab-
+ laufen als sei es vom CP/M aus mit dem Aufruf
+ A>COPY A:DESTIN.*=B:SOURCE.*
+ gestartet worden. Die Kommandozeile wird deshalb vor
+ dem Programmablauf mit
+ > FA:DESTIN.*=B:SOURCE.*
+ eingegeben.
+
+
+ G [startadr] [;breakp..]
+ ------------------------
+
+ Starte ein geladenes Programm, eventuell mit temporaeren Breakpoints.
+ (Go [to start] [with temporary breakpoints])
+
+ Wird eine Startadresse angegeben, so wird der Programmzaehler
+ des Z80 auf diese Adresse gesetzt, andernfalls wird bei dem
+ letzten Programmzaehlerstand fortgefahren. Im G-Kommando koen-
+ nen temporaere Breakpoints angegeben werden. Sie werden in der
+ gleichen Form wie die permanenten Breakpoints beim B-Kommando
+ spezifiziert und haben auch die gleiche Wirkung mit dem Unter-
+ schied, dass bei einem Programmstop an einem der temporaeren
+ oder permanenten Breakpoints die temporaeren automatisch ge-
+ loescht werden.
+ z.B. Vollstaendiges Abarbeiten eines CP/M-Programms, das mit
+ JP 0 endet:
+ > GL;0
+
+ H
+ -
+
+ Groesse und maximale Groesse von Files anzeigen.
+ (display High and maximal size of files)
+
+ Die hoechste von der zuletzt eingelesenen File belegte Adresse
+ wird angezeigt, sowie die hoechste von irgendeiner der einge-
+ lesenen Files belegte Adresse. Erstere ist auch in der Varia-
+ blen H, letztere in der Variablen M enthalten. (Siehe auch W-
+ und R-Kommando)
+
+ H ausdruck
+ H ausdruck ausdruck
+ -------------------
+
+ Berechnen eines Ausdrucks / Summe und Differenz zweier Ausdrucke.
+ (compute expressions / Hex and other sum and difference)
+
+ Wird ein Ausdruck angegeben, so zeigt das DDTZ dessen Ergebnis
+ an, werden zwei Ausdruecke angegeben, so werden deren Summe und
+ Differenz angezeigt. Ergebnisse werden in HEX, als negative
+ HEX-Zahl, in Dezimal, als negative Dezimalzahl, in Binaer und
+ das niederwertige Byte zusaetzlich als ASCII-Zeichen darge-
+ stellt. Nicht druckbare ASCII-Zeichen werden dabei als Control-
+ Zeichen in der Form Buchstabe minus '@' angezeigt.
+
+ Wie Ausdruecke formuliert werden, ist der Uebersichtlichkeit
+ halber im Anhang angegeben.
+
+ z.B.: Was ist die Endadresse eines 17 KByte langen Programms,
+ das bei Adresse 100H beginnt?
+ > H17.*1024.+100
+ 4500 -BB00 17664. -47872. 01000101"00000000" '@'-'@'
+ Der freie Speicher beginnt also bei 4500H.
+ z.B.: Beim Disassemblieren eines unbekannten Programms wird
+ eine Subroutine gefunden, die nacheinander mit den Werten
+ D8F0H, FC18H, FF9CH usw. in den Registern aufgerufen
+ wird. Was kann das fuer eine Routine sein?
+ > HD8F0
+ D8F0 -2710 55536. -10000. 11011000"11110000" 'p'.
+ > H fc18
+ FC18 -03E8 64536. -1000 11111100"00011000" 'X'-'@'
+ > H FF9CH
+ FF9C -0064 65436. -100 ...
+ Bei den Werten handelt es sich offenbar um dezimal -
+ 10000, -1000 usw.; die Routine hat also wahrscheinlich
+ etwas mit einer Binaer-zu-Dezimal-Umrechnung zu tun.
+
+ I [port]
+ --------
+
+ Einlesen eines Daten-Bytes von einem Port.
+ (input a byte from port)
+
+ Zum Austesten der Computer-Hardware koennen mit diesem Kommando
+ Bytes von Ports eingelesen und in HEX und binaer angezeigt
+ werden. Wird die Portadresse nicht angegeben, so wird der
+
+ zuletzt in einem frueheren I-Kommando angegebene Port ange-
+ sprochen. Die Moeglichkeit, bei Z80-I/O-Befehlen hardwareseitig
+ auch die Adressleitungen A15 bis A8 zur Informationsuebertra-
+ gung mitzuverwenden, ist im DDTZ realisiert. DDTZ-intern wird
+ die Portadresse als Zwei-Byte-Wort in das BC-Register
+ geladen und mit IN A,(C) der Port gelesen.
+ Bei diesem Kommando zeigt zeigt sich besonders der Vorteil der
+ Wiederholungsfunktion des DDTZ: Nachdem einmal das I-Kommando
+ explizit gegeben wurde, kann man, waehrend man verschiedene
+ Pegel an die Anschluesse des Ports anlegt, durch einfaches
+ Druecken der Return-Taste die Portabfrage wiederholen.
+
+ L [startadr] [endadr]
+ ---------------------
+
+ Listen eines Speicherbereichs in Z80-Mnemonics.
+ (List disassembled code)
+
+ Dieses Kommando disassembliert im Speicher stehende Programme.
+ (Beispiel: siehe Q-Kommando)
+
+
+ M[V] startadr endadr zieladr
+ ----------------------------
+
+ Umladen eines Speicherbereichs in einen anderen, eventuell vergleichen.
+ (Move memory [and verify])
+
+ Der Speicherinhalt beginnend bei der angegebenen Startadresse
+ bis (einschliesslich) zur angegebenen Endadresse wird in einen
+ anderen Bereich, beginnend bei der angegebenen Zieladresse,
+ kopiert. Wird der optionale Buchstabe V gegeben, so wird die
+ Kopie mit dem Original verglichen und etwaige Diffrenzen in HEX
+ ausgelistet. Differenzen koennen bei defektem Speicher ent-
+ stehen oder dann, wenn versehentlich in Bereiche kopiert wird,
+ die kein RAM enthalten. Das M-Kommando wird auch dann korrekt
+ ausgefuehrt, wenn der Quell- und der Zielbereich gegenseitig
+ ueberlappen. In diesem Fall ist ein Vergleichen allerdings
+ nicht moeglich, da beim Kopieren ja ein Teil des Quellbereichs
+ ueberschrieben wird.
+ Achten Sie bei diesem Kommando besonders darauf, dass Sie nicht
+ das DDTZ oder das Disk Operating System versehentlich ueber-
+ schreiben.
+
+ O [byte] [port]
+ ---------------
+
+ Ausgeben eines Datenbytes an einen Ausgabeport.
+ (Output a byte to a port)
+
+ Zum Austesten der Computer-Hardware koennen mit diesem Kommando
+ Bytes an Ports des Computersystems ausgegeben werden.
+ Achtung: Im Gegensatz zu dem Z80-Befehl OUT port,byte ist hier
+ aus folgendem Grund erst das Datenbyte und dann die Portadresse
+ anzugeben:
+ Die Portadresse kann weggelassen werden, falls ein Datenbyte an
+ den selben Port, wie in einem vorherigen O-Kommando spezifi-
+ ziert, ausgegeben werden soll.
+ Die Moeglichkeit, bei Z80-I/O-Befehlen hardwareseitig auch die
+ Adressleitungen A15 bis A8 zur Informationsuebertragung mitzu-
+ verwenden, ist im DDTZ realisiert. DDTZ-intern wird die Port-
+ adresse als Zwei-Byte-Wort in das BC-Register geladen und mit
+ OUT (C),A das Byte an den Port ausgegeben.
+
+ Q[J] startadr endadr bytes
+ --------------------------
+
+ Durchsuchen des Speichers nach einer gegebenen Folge von Bytes.
+ (Query memory for a byte string [justified])
+
+ Der Speicher wird beginnend bei der angegebnen Startadresse und
+ endet (einschliesslich) bei der angegebenen Endadresse auf eine
+ angegebene Byte-Folge hin durchsucht. Fundstellen werden wie
+ beim D-Kommando in HEX und ASCII ausgelistet. Das erste ge-
+ suchte Byte steht dabei jeweils am linken Bildrand. Wird der
+ optionale Buchstabe J gegeben, so werden jeweils noch 8 vorher-
+ gehende Bytes mit ausgelistet, sodass die gesuchte Byte-Folge
+ in der Bildmitte beginnt. Die Byte-Folge kann wie beim S-
+ Kommando eine Folge von HEX-Zahlen, Ausdruecken, Worten und
+ Text-Strings sein.
+
+ z.B. Ein zu untersuchendes Programm gibt an einem bestimmten
+ Punkt seines Ablaufes aus unbekannter Ursache die Meldung
+ "Hardware error" auf die Konsole aus und stoppt. Woher
+ kommt diese Meldung ?
+ > QJ l h 'Hardwar'
+ 1502 73 74 65 64 24 4E 6F 20 48 61 72 64 77 61 ...
+ Der Text "Hardware error beginnt also bei Adresse 150A. Wo
+ wird er ausgegeben ?
+ > QJ l h w150a
+ >
+ (Keine Meldung) Auf die Adresse wird also nicht direkt
+ zugegriffen. Vielleicht haben wir Glueck, indem wir
+ suchen, wo 'No Hardware error" ausgegeben wird. Dieser
+ Text beginnt bei 1507H.
+ > QJ l h w1507
+ 08FE 00 00 00 00 00 AF C9 21 07 15 CD 65 07 30 ...
+ > L8FE+7
+ 0905 LD HL,1507
+ 0908 CALL 0765
+ 090B JR NC,0910
+ 090D INC HL
+ 090E INC HL
+ 090F INC HL
+ 0910 CALL 0654
+ Die Subroutine, die bei Adresse 908 aufgerufen wird,
+ fuehrt also offenbar einen Test durch und meldet einen
+ Fehler im Carry-Flag. Der Text wird dann bei Adresse 910
+ ausgegeben.
+
+ R [displacement]
+ ----------------
+
+ Einlesen einer Binaer- oder HEX-File in den Speicher, eventuell
+ verschoben.
+ (Read a binary or hex file [add displacement])
+
+ Eine File, deren Name mit dem F-Kommando spezifiziert worden
+ sein muss, wird von der Diskette in den Speicher eingelesen.
+ Eine File, deren Name mit ".HEX" endet, wird als Intel-HEX-File
+ interpretiert; die Daten werden bei den in der File enthaltenen
+ Adressen im Speicher abgelegt. Jede andere File wird ohne jede
+ weitere Interpretation bei Adresse 100H beginnend in den Spei-
+ cher geladen.
+
+ Wird im R-Kommando ein Displacement angegeben, so wird eine
+ HEX-File bei der entsprechenden Adresse erhoeht um das Dis-
+ placement abgelegt, andere Files bei 100H+Displacement. Nach
+ dem Einlesen der File wird erst die hoechste von dieser File
+ belgte Speicheradresse ausgelistet und dann die hoechste von
+ irgendeiner File seit Starten des DDTZ belegte Adresse. Falls
+ das DDTZ statt dessen ein Fragezeichen ausgibt, konnte entweder
+ die File nicht gefunden werden, beim Lesen einer HEX-File wurde
+ ein Checksummenfehler entdeckt, oder die File belegt Speicher-
+ plaetze ausserhalb des Bereichs L bis T.
+ z.B.: Eine File TEST.BIN soll bei Adresse 2000H beginnend in
+ den Speicher geladen werden:
+ > Ftest.bin
+ > R2000-l
+ High = 277F Max = 277F
+
+ S [startadr]
+ ------------
+
+ Anzeigen und Aendern von Daten im Speicher
+ (Substitute memory)
+
+ Die Startadresse, oder wenn diese nicht angegeben wurde, die
+ Adresse bei der das letzte S-Kommando beendet wurde, wird auf
+ der Konsole ausgegeben, und danach wird das an dieser Stelle im
+ Speicher befindliche Byte in HEX angezeigt. Anschliessend
+ erwartet das DDTZ eine Eingabe, und zwar gibt es folgende
+ Moeglichkeiten:
+ - Eine leere Eingabe (nur Return-Taste) schreitet ohne Spei-
+ cheraenderung zur naechsten Adresse weiter.
+ - Ein Minus-Zeichen geht ohne Speicheraenderung einen
+ AdressSchritt zurueck.
+ - Ein Punkt (alleine in einer Zeile) beendet das Kommando.
+ - Ein Datenbyte oder eine Folge von von Datenbytes wird in
+ den Speicher eingetragen.
+
+ Datenbytes koennen folgendermassen eingegeben werden:
+ - Ausdruecke (im einfachsten Fall HEX-Zahlen) werden der
+ Reihe nach berechnet und eingetragen.
+ - W ausdruck berechnet den Ausdruck als Zwei-Byte-Wort und
+ traegt ihn in zwei Speicher-Bytes ein; erst das niederwer-
+ tige, dann das hoeherwertige Byte.
+ - Ein Apostroph, gefolgt von ASCII-Zeichen und einem
+ weiteren Apostroph bewirkt ein Eintragen einer ASCII-
+ Zeichenfolge. Kommt der Apostroph selbst in der Zeichen-
+ folge vor, so muss er zweimal gegeben werden. Folgt
+ auf den abschliessenden Apostroph ein Punkt, so wird das
+ Bit 7 des letzten Zeichens auf Eins gesetzt.
+ z.B. der Programmteil
+ 0200 CALL 1234H
+ 0203 DM 'Test ''1''' ; Test '1'
+ kann mit dem S-Kommando folgendermassen eingegeben werden:
+ > S200
+ 0200 00 cdW1234
+ 0203 00 'Test ''1'''.
+ 020B 00 -
+ 020A A7 .
+
+ T[N][J] ]befehlsanzahl]
+ T[N][J] W ausdruck
+ T[N][J] U ausdruck
+ ------------------
+
+ Tracen [ohne Ausgabe] [nur Sprungbefehle] / ..solange.. / ..bis..
+ (Trace [no list] [Jumps only] / ..While.. / ..Until..)
+
+ Im Gegensatz zum Starten eines Programms mit dem G-Kommando,
+ bei dem die Kontrolle voll dem auszufuehrenden Programm ueber-
+ geben wird und erst bei einem Breakpoint dem DDTZ zurueckge-
+ geben wird, behaelt beim Tracen das DDTZ die ganze Zeit die
+ Kontrolle. Das wird dadurch erreicht, dass das DDTZ automatisch
+ hinter jedem Befehl, bevor er ausgefuehrt wird, einen Break-
+ point einsetzt und nach Ausfuehrung des Befehls wieder loescht.
+ Bei bedingten Spruengen werden sogar zwei Breakpoints gesetzt,
+ einer hinter dem Sprungbefehl, der andere am Sprungziel. Das
+ Programm wird also in Einzelschritten ausgefuehrt. Nach jedem
+ Schritt legt das DDTZ die aktuellen Werte aller Register in
+ Speicherplaetze innerhalb des DDTZ ab, sodass die Register-
+ inhalte jederzeit ueberwacht werden koennen.
+ Das Tracen beginnt jeweils beim derzeitigen Stand des Programm-
+ zaehlers. Soll an einer anderen Stelle mit dem Tracen begonnen
+ werden, so muss der Programmzaehler mit dem X-Kommando neu
+ gesetzt werden.
+ Nach jedem Schritt werden alle Registerinhalte und der naechste
+ Z80-Befehl wie beim X-Kommando angezeigt.
+ Die einfachste Form des T-Kommandos ist nur der Buchstabe T
+ (gefolgt von der Return-Taste), worauf ein Einzelschritt ausge-
+ fuehrt wird. Falls das letzte Kommando bereits ein T-Kommando
+ war, genuegt wegen der Wiederholfunktion des DDTZ auch die
+ Return-Taste alleine, was das Einzelschritt-Tracen sehr er-
+ leichtert.
+ Wird im T-Kommando eine Befehlsanzahl angegeben, so werden
+ entsprechend viele Schritte hintereinander ausgefuehrt. In
+ diesem Fall kann, wie auch bei dem im Folgenden erlaeuterten
+ Tracen mit Abbruchkriterium, der Trace-Vorgang durch Druecken
+ einer beliebigen Taste der Konsole vorzeitig abgebrochen
+ werden. Das Tracen wird unabhaengig von einer angegebenen
+ Befehlsanzahl oder Bedingung abgebrochen, wenn ein Breakpoint
+ erreicht wird.
+ Wird der Buchstabe W, gefolgt von einem Ausdruck angegeben, so
+ wird das Programm solange im Trace-Modus abgearbeitet, wie der
+ Ausdruck 'wahr' ist, d.h. vor jedem Schritt wird der Ausdruck
+ berechnet und nur dann fortgefahren, wenn er ein von Null ver-
+ schiedenes Ergebnis hat.
+ Wird der Buchstabe U, gefolgt von einem Ausdruck angegeben, so
+ wird das Tracen dann abgebrochen, wenn der Ausdruck ein von
+ Null verschiedenes Ergebnis hat.
+ Bei allen Formen des T-Kommandos kann man durch Angabe des
+ Buchstaben N das Auslisten der Register abschalten, was die
+ Ausfuehrungszeit erheblich verkuerzt. In diesem Fall werden nur
+ beim Beenden des Trace die Registerinhalte angezeigt.
+ Die Angabe des Buchstabens J veranlasst das DDTZ, nur hinter
+ Befehle, die den Programmzaehler beeinflussen, Breakpoints zu
+ setzen, also bei den Befehlen JP,JR,CALL,RET. Es werden dann
+ auch nur bei diesen Befehlen die Registerinhalte angezeigt und
+ ein Abbruchkriterium geprueft.
+
+ Achtung: Da die Einzelschritt-Abarbeitung durch automatisches
+ Setzen von Breakpoints erreicht wird, ist es unmoeglich, Pro-
+ gramme in ROMs zu tracen. Subroutinen in ROMs koennen mit dem
+ G-Kommando und geeigneten Breakpoints oder mit dem C-Kommando
+ uebersprungen werden. Falls Teile des BIOS in ROMs stehen,
+ stoert dies nicht, solange das zu untersuchende Programm nur
+ BDOS-Aufrufe enthaelt. Bei BDOS-Aufrufen wird der Trace-Modus
+ verlassen und erst nach der Rueckkehr aus dem BDOS wieder
+ aufgenommen.
+ z.B.: > TNU(1234)='A'
+ traced das Programm ohne Registeranzeige, bis der Spei-
+ cherplatz 1234H das ASCII-Zeichen A enthaelt.
+ > TJW[^hl=0]&[^a<80]
+ traced die Sprungbefehle, solange das HL-Register Null
+ ist und das A-Register kleiner als 80H ist.
+
+
+ V startadr endadr zieladr
+ -------------------------
+ Vergleichen zweier Speicherbereiche.
+ (Verify (compare) two memory areas)
+
+ Der Inhalt des Speichers beginnend bei der angegebenen Start-
+ adresse bis (einschliesslich) zur angegebenen Endadresse wird
+ mit dem Inhalt eines gleich langen Bereichs beginnend bei der
+ angegebenen Zieladresse verglichen. Unterschiede werden in HEX
+ ausgelistet. Das Auslisten kann durch Druecken einer beliebigen
+ Taste der Konsole abgebrochen werden.
+
+
+ W startadr endadr
+ -----------------
+
+ Ausschreiben eines Speicherbereichs in eine File.
+ (Write a file to disk)
+
+ Der Inhalt des Speichers beginnend bei der angegebenen Start-
+ adresse bis (einschliesslich) zur angegebenen Endadresse wird
+ in eine File auf der Diskette geschrieben. Der Filename muss
+ vorher mit dem F-Kommando spezifiziert werden. Die Laenge des
+ abgespeicherten Bereiches wird vom DDTZ auf volle Saetze aufge-
+ rundet.
+ z.B.: In ein Programm namens PROG-ALT.COM sollen Aenderungen,
+ die in einer File PATCH.HEX enthalten sind, eingefuegt
+ werden, und das modifizierte Programm soll in einer File
+ namens PROG-NEU.COM auf Diskette B: abgelegt werden:
+ > Fprog-alt.com
+ > R
+ High = 257F Max = 257F
+ > Fpatch.hex
+ > R
+ High = 2345 Max = 257F
+ > Fb:prog-neu.com
+ > Wl m
+
+ X
+ -
+
+ Anzeigen aller Register und des Befehls, auf den der Programm-
+ zaehler zeigt.
+ (eXamine all cpu registers)
+
+ Jedesmal, wenn ein Breakpoint angelaufen wird oder ein Pro-
+ grammschritt getraced wird, legt das DDTZ die Registerinhalte
+ in einem innerhalb des DDTZ befindlichen Speicherbereich ab.
+ Wird mit G oder T die Ausfuehrung des Programms fortgesetzt, so
+ laedt das DDTZ vorher diese Daten wieder in die Register. Mit
+ dem X-Kommando koennen diese abgespeicherten Registerinhalte
+ jederzeit kontrolliert werden. Die Anzeige erfolgt, wie immer
+ im DDTZ, in HEX.
+ Die sechs gueltigen Bits des F- und des F'-Registers werden als
+ Buchstaben dargestellt. Das Interrupt-Flag wird wie ein Bit des
+ F-Registers angezeigt.
+ Der Z80-Befehl, auf den der Programmzaehler zeigt, wird in dis-
+ assemblierter Form ausgegeben. Falls das Displacement-Register
+ @ von Null verschieden ist, wird der Programmzaehler auch
+ relativ dazu angezeigt.
+ z.B. Das Displacement-Register enthalte den Wert F00H, alle
+ Flags seien gesetzt, der Interrupt sei eingeschaltet und
+ die Register enthalten willkuerliche Werte:
+ > X
+ SZHVNCE A =12 BC =3456 DE =789A HL =BCDE SP=F012 PC=3456..
+ SZHVNC A'=78 BC'=9ABC DE'=DEF0 HL'=1234 IX=5678 IY=9ABC..
+ Nach einem Neustart des DDTZ enthalten die Register
+ folgende Werte:
+ E A =00 BC =0000 DE =0000 HL =0000 SP=AC00 PC=0100..
+ A'=00 BC'=0000 DE'=0000 HL'=0000 IX=0000 IY=0000..
+ Das Interrupt-Enabled-Flag ist gesetzt, falls beim Start des
+ DDTZ der Interrupt eingeschaltet war. Das I-Register enthaelt
+ den Wert, den es beim Start des DDTZ enthielt. Der Programm-
+ zaehler steht auf 100H, zeigt also auf den Anfang des Benutzer-
+ speichers. Der Stackpointer zeigt auf das obere Ende des Be-
+ nutzerspeichers, abgerundet auf volle 100H. Alle anderen Re-
+ gister enthalten Nullen.
+
+ X register
+ ----------
+
+ Anzeigen und eventuell modifizieren eines Registers.
+ (eXamine [and substitute] a register)
+
+ Nach Eingabe des Buchstabens X, gefolgt von einem Register-
+ namen, wird der betreffende Registerinhalt ausgegeben und ein
+ neuer Wert angefordert. Eine leere Eingabe (nur Return-Taste)
+ laesst den Registerinhalt unveraendert; ein eingegebener Wert
+ oder Ausdruck wird in das Register eingetragen. Ist das ange-
+ waehlte Register das F- oder F'-Register, so werden die Flags
+ als Buchstaben angezeigt. Daraufhin koennen durch Eingabe neuer
+ Buchstaben in beliebiger Reihenfolge die entsprechenden Flags
+ gesetzt werden, wobei nicht gegebene Flags zurueckgesetzt
+ werden. Das Interrupt-Flag wird im DDTZ wie ein Flag des F-
+ Registers behandelt.
+
+ Die Namen der Register und der Flags der F-Register sind im
+ Anhang aufgelistet.
+
+ z.B. Setzen des HL-Registers auf ABCDH, des C-Registers auf den
+ ASCII-Wert 'A', und Setzen des Carryflags des F-Registers
+ und des Interrupt-Flags:
+ > Xhl
+ HL=1234 abcd
+ > Xc
+ C=40 'A'
+ > Xf
+ S VNCE ce
+
+
+ Y
+ -
+
+ Anzeigen aller Y-Variablen.
+ (examine all Y variables)
+
+ Beim Untersuchen eines Programms ist es vielfach von Vorteil,
+ wenn man bestimmte Adressen, Registerstaende, Zwischenergebnis-
+ se bei Berechnungen usw. festhalten kann und bei weiteren
+ Berechnungen oder DDTZ-Kommandos als Argumente einsetzen kann.
+ Fuer diesen Zweck haelt das DDTZ zehn frei verfuegbare Varia-
+ blen bereit, die mit Y0 bis Y9 bezeichnet sind. Die derzeitigen
+ Werte in diesen Variablen koennen mit dem Y-Kommando angezeigt
+ werden.
+ z.B. Nach dem Starten des DDTZ enthalten die Y-Variablen alle
+ den Wert Null:
+ > Y
+ Y0=0000 Y1=0000
+ Y2=0000 Y3=0000
+ Y4=0000 Y5=0000
+ Y6=0000 Y7=0000
+ Y8=0000 Y9=0000
+
+ Yziffer0bis9
+ ------------
+
+ Anzeigen und eventuell Modifizieren einer Y-Variablen.
+ (examine [and substitute] an Y variable)
+
+ Nach Eingabe des Buchstabens Y, unmittelbar gefolgt von einer
+ Ziffer 0 bis 9, wird der derzeitige Wert der berteffenden Y-
+ Variable angezeigt und ein neuer Wert angefordert. Eine leere
+ Eingabe (nur Return-Taste) laesst den Wert unveraendert, ein
+ angegebener Wert wird in die Variable eingetragen.
+ z.B. Ein File-Control-Block (33 Bytes lang), auf den zur Zeit
+ das DE-Register zeigt, soll im weiteren Verlauf eines
+ Programmtests oefters inspiziert werden. Statt sich den
+ Stand des DE-Registers zu merken oder zu notieren und
+ immer wieder einzugeben, kann er in eine Variable, z.B.
+ Y1, eingetragen werden:
+ > Y1
+ Y1=0000 ^de
+ Mit D y1 s 33. oder dy1s21 kann jetzt jederzeit der File-
+ Control-Block angesehen werden.
+
+
+ Z startadr endadr bytes
+ -----------------------
+
+ Vorbesetzen eines Speicherbereiches mit einer Byte-Folge.
+ (Zap (fill) memory with a byte string)
+
+ Der Speicher wird beginnend bei der angegebenen Startadresse
+ bis (einschliesslich) zur angegebenen Endadresse mit der ange-
+ gebenen Bytefolge belegt. Die Bytefolge wird genauso wie beim
+ S-Kommando angegeben. Ist sie kuerzer als der zu besetzende
+ Speicher, so wird die Bytefolge wiederholt, bis die Endadresse
+ erreicht ist.
+ z.B. Loeschen des gesamten Benutzerspeichers mit Nullen:
+ > Z l t 0
+ z.B. Fuellen eines bei der Adresse 1000H beginnenden, 10H Bytes
+ langen Puffers mit dem Text 'leer!', Carriage Return,
+ Linefeed:
+ > Z1000s10 'leer!',d,a
+ > D1000s12
+ 1000 6C 65 65 72 21 0D 0A 6C 65 65 72 21 0D 0A 6C..
+ 1010 00 00 ..
+ z.B. Durchfuehren eines einfachen Speichertests: Erst wird der
+ gesamte Benutzerspeicher mit einer krummen Anzahl, z.B.
+ sieben, Testbytes gefuellt und dann der Speicher mit sich
+ selbst, um die Laenge der Testbytefolge verschoben, ver-
+ glichen:
+ > Zl t 0 ff aa 55 a5 5a 0f
+ > Vl t-7 l+7
+
+ ANHANG
+ ======
+
+ Zusammenfassung der Kommandos
+ -----------------------------
+
+ > @
+ examine [substitute] displacement register @
+ Anzeigen und eventuell Aendern des Displacement-Registers
+
+ > A [startadresse]
+ Assemble Zilog Z80 mnemonics
+ Assemblieren von Z80-Befehlen
+
+ > B
+ display all breakpoints
+ Anzeigen aller Breakpoints
+ > B breakp [breakp..]
+ set breakpoints
+ Breakpoints setzen
+ > BX
+ clear all breakpoints
+ Loeschen aller Breakpoints
+ > BX adresse [adresse..]
+ clear breakpoints
+ Breakpoints loeschen
+
+ >>C[N][J] [befehlsanzahl]
+ >>C[N][J] W ausdruck
+ >>C[N][J] U ausdruck
+ trace over calls [No list] [Jumps only] /.While./.Until.
+ Tracen ueber CALLs [ohne Ausgabe] [nur Sprungbefehle]
+ /.solange./.bis.
+
+ >>D [startadr] [endadr]
+ Display memory in hex and ASCII
+ Auslisten des Speichers in HEX und ASCII
+
+ > Fkommandozeile
+ specifiy filename and command line
+ File-Controlblock und CP/M-Kommandozeile spezifizieren
+
+ > G [startadr] [;breakp..]
+ Go [to start] [with temporary breakpoints]
+ Starte ein geladenes Programm, eventuell mit temporaeren
+ Breakpoints
+
+ > H
+ display High and maximal size of files
+ Groesse und maximale Groesse von Files anzeigen
+ > H ausdruck
+ compute hex and other expressions
+ Berechnen eines Ausdrucks
+ > H ausdruck ausdruck
+ Hex and other sum and difference
+ Summe und Differenz zweier Ausdruecke
+
+ >>I [port]
+ Input a byte from port
+ Einlesen eines Daten-Bytes von einem Port
+
+ >>L [startadr] [endadr]
+ List disassembled code
+ Listen eines Speicherbereichs in Z80-Mnemonics
+
+ > M[V] startadr endadr zieladr
+ Move memory [and verify]
+ Umladen eines Speicherbereiches in einen anderen, evtl.
+ Vergleichen
+
+ >>O [byte] [port]
+ Output a byte to a port
+ Ausgeben eines Datenbytes an einen Ausgabeport
+
+ > Q[J] startadr endadr bytes
+ Query memory for a byte string [Justified]
+ Durchsuchen des Speichers nach einer gegebenen Folge von
+ Bytes
+
+ > R [displacement]
+ Read a binary or hex file ]add displacement]
+ Einlesen einer Binaer- oder HEX-File in den Speicher,
+ evtl. verschoben
+
+ > S [startadr]
+ Substitute Memory
+ Anzeigen und Aendern von Daten im Speicher
+
+ >>T[N][J] [befehlsanzahl]
+ >>T[N][J] W ausdruck
+ >>T[N][J] U ausdruck
+ Trace [no List] [Jumps only] / .While. / .Until.
+ Tracen [ohne Ausgabe] [nur Sprungbefehle] /.solange./.bis.
+
+ > Vstartadr endadr zieladr
+ Verify (compare) two memory areas
+ Vergleichen zweier Speicherbereiche
+
+ > Wstartadr endadr
+ Write a file to disk
+ Ausschreiben eines Speicherbereichs in eine File
+
+ > X
+ eXamine all cpu registers
+ Anzeigen aller Register und des Befehls, auf den der Pro-
+ grammzaehler zeigt
+ > X register
+ eXamine [and substitute] a register
+ Anzeigen und eventuell Modifizieren eines Registers
+
+ > Y
+ examine all Y variables
+ Anzeigen aller Y-Variablen
+ > Yziffer0bis9
+ examine [and substitute] an Y variable
+ Anzeigen und eventuell Modifizieren einer Y-Variablen
+
+ > Z startadr endadr bytes
+ Zap (fill) memory with a byte string
+ Vorbesetzen eines Speicherbereiches mit einer Byte-Folge
+
+
+ Registernamen
+ -------------
+
+ A , F , B , C , D , E , H , L ,BC , DE , HL
+ A', F', B', C', D', E', H', L',BC', DE', HL'
+ IX oder X , IY oder Y , Sp oder S , PC oder P , I
+
+ Flags des F- und des F'-Registers:
+
+ S Sign Vorzeichen
+ Z Zero Null
+ H Half carry Uebertrag von Bit 3 nach Bit 4
+ V oVerflow/parity Ueberlauf/ gerade Paritaet
+ N Negation NEG, DEC, SUB o.ae. wurde ausgefuehrt
+ C Carry Uebertrag von Bit 7
+ E Interrupt Enabled Das Interrupt-Flag wird im DDTZ wie
+ ein Flag des F-Registers behandelt.
+
+ Variablen und Konstanten
+ ------------------------
+
+ L Low Benutzerspeicher-Anfang. Festwert 100H
+ H High Hoechste Adresse der letzten gelesenen
+ File
+ M Max Maximale Adresse aller gelesenen Files
+ T Top Oberes Ende des Benutzerspeichers
+ @ Displacement Register
+ $ beim Assemblieren Anfangsadresse des
+ Befehls sonst = PC
+ Y0..Y9 Frei verwendbare Variablen
+ ^register Inhalt eines Registers
+ (adresse) Inhalt eines Speicherplatzes (Byte)
+ (adresse). Inhalt eines Speicherplatzes (Wort)
+
+ Ausdruecke
+ ----------
+
+ In allen Situationen, in denen Zahlen eingegeben werden koen-
+ nen, ist auch die Eingabe von Ausdruecken erlaubt.
+
+ Ausdruecke sind im allgemeinen arithmetische Ausdruecke, koen-
+ nen aber auch (zum Formulieren von Bedingungen) Relationen
+ sein. Relationen bestehen aus zwei arithmetischen Ausdruecken,
+ zwischen denen einer der folgenden Relationsoperatoren steht:
+ = <> > >= <= <
+
+ Relationen haben den Wert -1 (=0FFFFH), wenn die Relation wahr
+ ist, 0 sonst.
+ z.B. der Ausdruck 1+2=3 hat den Wert -1, und 'A'>'B' den Wert 0
+
+ Ein arithmetischer Ausdruck hat die folgende Form
+
+ faktor arithmetikoperator faktor arith... faktor
+
+
+ Die Arithmetikoperatoren sind
+ + - * / % Addition, Subtraktion, Mult., Division, Modulo
+ & ! # bitweise AND, OR, XOR
+
+ Ein Faktor hat die Form
+ [ausdruck] geklammerter Ausdruck
+ +faktor
+ -faktor Negation
+ ~faktor bitweise NOT (1er-Komplement)
+ 'a' Wert eines ASCII-Zeichens (a=druckbares Zeichen)
+ 'a'. " mit gesetzem Bit 7
+ 'ab' Wert zweier ASCII-Zeichen (a,b=druckbare Zeichen)
+ 'ab'. " das niederwertige Zeichen mit gesetztem Bit 7
+ (ausdruck) ein Byte im Speicher
+ (ausdruck). ein Wort im Speicher
+ hhhh[H] Hex-Zahl (h=0..9,A..F oder a..f)
+ ddddd. Dezimal-Zahl (d=0..9)
+ bbbbbbbb"bbbbbbbb" Binaer-Zahl (beliebig mit '"' unterteilt (b=0,1)
+
+ Enthaelt ein Ausdruck einen Relationsoperator, so werden erst
+ die beiden arithmetischen Ausdruecke berechnet und dann die
+ Relation.
+ Ein arithmetischer Ausdruck wird von links nach rechts be-
+ rechnet, also ohne Beachtung "Punktrechnung vor Strichrech-
+ nung", die Reihenfolge kann jedoch mit Klammern '[' und ']'
+ geaendert werden.
+ Ein Pluszeichen darf, wenn dabei der Ausdruck eindeutig bleibt,
+ weggelassen werden; z.B. ist @1000 dasselbe wie @+1000.
+ Ausdruecke duerfen keine Leerzeichen enthalten!
+
diff --git a/doc/ddtz-help.txt b/doc/ddtz-help.txt new file mode 100644 index 0000000..13bea7f --- /dev/null +++ b/doc/ddtz-help.txt @@ -0,0 +1,121 @@ +DDT/Z180 (ROM) Commands:
+> @ examine/substitute the displacement register @
+> A [address] Assemble
+> B[X] display [or clear] all Breakpoints
+ B breakp [:count] [breakp..] set Breakpoints
+ BX address [address..] clear Breakpoints
+>>C[N][J] [count] trace over Calls [No list] [Jumps only]
+ C[N][J] W|U expression trace over Calls While|Until ...
+>>D [startadr] [endadr] Display memory in hex and ascii
+> G [startadr] [;breakp..] Go [to start] [temporary breakpoints]
+> H display High and max load address (set by R cmd)
+> H expression [expression] compute Hex and other expressions
+>>I [port] Input a byte from port
+>>L [startadr] [endadr] List disassembled code
+> M[V] startadr endadr destadr Move memory [and verify]
+>>O [byte] [port] Output a byte to port
+> Q[J] startadr endadr bytes Qery memory for byte string [Justified]
+> R [displacement] Read intel hex from console [add displacemt]
+> S address Substitute memory
+>>T[N][J] [count] Trace [No list] [Jumps only] [count steps]
+ T[N][J] W|U expression Trace While|Until ...
+> V startadr endadr destadr Verify (compare) two memory areas
+> X[register] eXamine [and substitute] registers
+> Y[0..9] eXamine [and substitute] Y variables
+> Z startadr endadr bytes Zap (fill) memory with a byte string
+
+
+
+Registernamen:
+
+A , F , B , C , D , E , H , L ,BC , DE , HL
+A', F', B', C', D', E', H', L',BC', DE', HL'
+IX oder X , IY oder Y , SP oder S , PC oder P , I
+
+Flags des F- und des F'-Registers:
+
+S Sign Vorzeichen
+Z Zero Null
+H Half carry Uebertrag von bit 3 nach bit 4
+V oVerflow/parity Ueberlauf/gerade Paritaet
+N Negation NEG, DEC, SUB o.ae. ausgefuehrt
+C Carry Uebertrag von bit 7
+E interrupt Enabled das Interrupt flag wird im DDTZ wie
+ ein Flag des F-Registers behandelt.
+
+Variablen und Konstanten:
+
+L Low Benutzerspeicher-Anfang. Festwert 100H
+H High Hoechste Adresse der letzten gelesenen File
+M Max Maximale Adresse aller gelesenen Files
+T Top Oberes Ende des Benutzerspeichers
+@ Displacement Register
+$ beim Assemblieren Anfangsadresse des Befehls
+ sonst = PC
+Y0..Y9 frei verwendbare Variablen
+^register Inhalt eines Registers
+(adresse) Inhalt eines Speicherplatzes (Byte)
+(adresse). Inhalt eines Speicherplatzes (Wort)
+
+
+Allgemeines zum Gebrauch des DDTZ:
+
+Ausdruecke:
+
+In allen Situationen, in denen Zahlen eingegeben werden koennen, ist
+auch die Eingabe von Ausdruecken erlaubt.
+Ausdruecke haben die Form
+ arithmetischerexpression
+ oder arithmetischerexpression relationsoperator arithmetischerexpression
+Die relationsoperatoren sind
+= <> > >= <= <
+Der expression hat den Wert -1, wenn die Relation wahr ist, sonst 0.
+z.B: der expression 1+2=3 hat den Wert -1, und 'A'<'B' den Wert 0
+Ein arithmetischer expression hat die allgemeine Form
+ faktor arithmetikoperator faktor arith... faktor
+Die Arithmetikoperatoren sind
++ - * / % Plus, Minus, Multiplikation, Division, Modulo
+& ! # bitweise AND, OR, XOR
+
+Ein Faktor hat die Form
+[expression] geklammerter expression
++faktor
+-faktor Negation
+~faktor bitweise NOT
+'a' Wert eines ASCII-Zeichens
+'a'. mit gesetztem Bit 7
+'ab' Wert zweier ASCII-Zeichen
+'ab'. das niederwertige mit gesetztem bit 7
+(expression) ein Byte im Speicher
+(expression). ein Wort im Speicher
+variable eine der oben aufgezaehlten Variablen
+hhhh[H] Hex-Zahl
+ddddd. Dezimal-Zahl
+bbbbbbbb"bbbbbbbb" Binaer-Zahl (beliebig mit '"' unterteilt)
+
+Enthaelt ein expression einen Relationsoperator, so werden erst die
+beiden arithmetischen Ausdruecke berechnet und dann die Relation.
+Ein arithmetischer expression wird von links nach rechts berechnet,
+also ohne Beachtung 'Punktrechnung vor Strichrechnung', die Reihenfolge
+kann jedoch mit Klammern '[' und ']' geaendert werden.
+Ausdruecke duerfen keine Blanks enthalten.
+
+Befehle:
+
+Befehle beginnen mit einem der Zeichen '@' bis 'Z', eventuell gefolgt
+von weiteren optionalen Buchstaben, sowie Argumenten. Wird eine
+optionale Anfangsadresse weggelassen, so wird die Adresse benutzt,
+bei der Befehl zuletzt beendet wurde. Wird eine optionale Endadresse
+weggelassen, so wird der Befehl (z.B. L oder D) so lange ausgefuehrt,
+bis etwa ein Bildschirm vollgeschrieben ist. Ein weggelassenes
+optionales Argument, hinter dem weitere Argumente angegeben werden
+sollen, muss durch ein Komma ersetzt werden. Zwischen zwei Argumenten
+muss ein Blank, ein Tab (^I) oder ein Komma stehen.
+
+
+Bei Befehlen, die eine Start- und eine Endadresse erfordern, kann
+anstelle der Endadresse auch der Buchstabe 'S', gefolgt von einer
+Laengenangabe verwendet werden.
+ z.B. bedeutet D 1000 S 100 oder D1000S100
+ das selbe wie D 1000 10FF oder D1000,10FF
+
diff --git a/doc/ddtz-ref-short.txt b/doc/ddtz-ref-short.txt new file mode 100644 index 0000000..e44450f --- /dev/null +++ b/doc/ddtz-ref-short.txt @@ -0,0 +1,150 @@ +ANLEITUNG zum DDTZ
+Development Debugging Tool for Z80 microcomputers
+
+Zusammenfassung der Befehle:
+
+> @ examine [and substitute]
+ the displacement register @
+> A [startadresse] Assemble
+> B display all Breakpoints
+ B breakp [breakp..] [:count] set Breakpoints
+ BX clear all Breakpoints
+ BX adresse [adresse..] clear Breakpoints
+>>C[N][J] [befehlsanzahl] trace over Calls [no list] [jumps only]
+ C[N][J] W ausdruck ..while..
+ C[N][J] U ausdruck ..until..
+>>D [startadr] [endadr] Display memory in hex and ascii
+> F kommandozeile specify Filename and command line
+> G [startadr] [;breakp..] Go [to start] [temporary breakpoints]
+> H display High and maximal size of files
+> H ausdruck compute Hex and other expressions
+ H ausdruck ausdruck Hex and other sum and difference
+>>I [port] Input a byte from port
+>>L [startadr] [endadr] List disassembled code
+> M[V] startadr endadr zieladr Move memory [and verify]
+>>O [byte] [port] Output a byte to port
+> Q[J] startadr endadr bytes Qery memory for byte string [justified]
+> R [displacement] Read binary or hex file [add displacemt]
+> S startadr Substitute memory
+>>T[N][J] [befehlsanzahl] Trace [no list] [Jumps only]
+ T[N][J] W ausdruck ..while..
+ T[N][J] U ausdruck ..until..
+> V startadr endadr zieladr Verify (compare) two memory areas
+> W startadr endadr Write a file to disk
+> X eXamine all cpu registers
+ X register eXamine [and substitute] a register
+> Y eXamine all Y variables
+ Yziffer0bis9 eXamine [and substitute] an Y variable
+> Z startadr endadr bytes Zap (fill) memory with a byte string
+
+
+
+Registernamen:
+
+A , F , B , C , D , E , H , L ,BC , DE , HL
+A', F', B', C', D', E', H', L',BC', DE', HL'
+IX oder X , IY oder Y , SP oder S , PC oder P , I
+
+Flags des F- und des F'-Registers:
+
+S Sign Vorzeichen
+Z Zero Null
+H Half carry Uebertrag von bit 3 nach bit 4
+V oVerflow/parity Ueberlauf/gerade Paritaet
+N Negation NEG, DEC, SUB o.ae. ausgefuehrt
+C Carry Uebertrag von bit 7
+E interrupt Enabled das Interrupt flag wird im DDTZ wie
+ ein Flag des F-Registers behandelt.
+
+Variablen und Konstanten:
+
+L Low Benutzerspeicher-Anfang. Festwert 100H
+H High Hoechste Adresse der letzten gelesenen File
+M Max Maximale Adresse aller gelesenen Files
+T Top Oberes Ende des Benutzerspeichers
+@ Displacement Register
+$ beim Assemblieren Anfangsadresse des Befehls
+ sonst = PC
+Y0..Y9 frei verwendbare Variablen
+^register Inhalt eines Registers
+(adresse) Inhalt eines Speicherplatzes (Byte)
+(adresse). Inhalt eines Speicherplatzes (Wort)
+
+Aufruf des DDTZ:
+
+ DDTZ
+ oder DDTZ d:filename.ext
+
+Bei beiden Aufrufen laedt das Disk Operating System das DDTZ bei
+Adresse 100H beginnend in den Speicher. Das DDTZ verlagert sich
+danach direkt vor das BDOS und ueberschreibt dabei den CCP. Der
+Adressteil des Befehls JP BDOS auf Adresse 5 wird erniedrigt,
+um dem Anwenderprogramm die durch das DDTZ verringerte Speichergroesse
+mitzuteilen. Der urspruenglich vom DDTZ belegte Speicher wird daraufhin
+mit Nullen geloescht.
+Wurde im Aufruf ein Filename angegeben, so laedt das DDTZ die File
+in den Speicher. Nach Ausgabe des Prompt-Zeichens '>' ist das DDTZ
+betriebsbereit.
+
+
+Allgemeines zum Gebrauch des DDTZ:
+
+Ausdruecke:
+
+In allen Situationen, in denen Zahlen eingegeben werden koennen, ist
+auch die Eingabe von Ausdruecken erlaubt.
+Ausdruecke haben die Form
+ arithmetischerausdruck
+ oder arithmetischerausdruck relationsoperator arithmetischerausdruck
+Die relationsoperatoren sind
+= <> > >= <= <
+Der Ausdruck hat den Wert -1, wenn die Relation wahr ist, sonst 0.
+z.B: der Ausdruck 1+2=3 hat den Wert -1, und 'A'<'B' den Wert 0
+Ein arithmetischer Ausdruck hat die allgemeine Form
+ faktor arithmetikoperator faktor arith... faktor
+Die Arithmetikoperatoren sind
++ - * / % Plus, Minus, Multiplikation, Division, Modulo
+& ! # bitweise AND, OR, XOR
+
+Ein Faktor hat die Form
+[ausdruck] geklammerter Ausdruck
++faktor
+-faktor Negation
+~faktor bitweise NOT
+'a' Wert eines ASCII-Zeichens
+'a'. mit gesetztem Bit 7
+'ab' Wert zweier ASCII-Zeichen
+'ab'. das niederwertige mit gesetztem bit 7
+(ausdruck) ein Byte im Speicher
+(ausdruck). ein Wort im Speicher
+variable eine der oben aufgezaehlten Variablen
+hhhh[H] Hex-Zahl
+ddddd. Dezimal-Zahl
+bbbbbbbb"bbbbbbbb" Binaer-Zahl (beliebig mit '"' unterteilt)
+
+Enthaelt ein Ausdruck einen Relationsoperator, so werden erst die
+beiden arithmetischen Ausdruecke berechnet und dann die Relation.
+Ein arithmetischer Ausdruck wird von links nach rechts berechnet,
+also ohne Beachtung 'Punktrechnung vor Strichrechnung', die Reihenfolge
+kann jedoch mit Klammern '[' und ']' geaendert werden.
+Ausdruecke duerfen keine Blanks enthalten.
+
+Befehle:
+
+Befehle beginnen mit einem der Zeichen '@' bis 'Z', eventuell gefolgt
+von weiteren optionalen Buchstaben, sowie Argumenten. Wird eine
+optionale Anfangsadresse weggelassen, so wird die Adresse benutzt,
+bei der Befehl zuletzt beendet wurde. Wird eine optionale Endadresse
+weggelassen, so wird der Befehl (z.B. L oder D) so lange ausgefuehrt,
+bis etwa ein Bildschirm vollgeschrieben ist. Ein weggelassenes
+optionales Argument, hinter dem weitere Argumente angegeben werden
+sollen, muss durch ein Komma ersetzt werden. Zwischen zwei Argumenten
+muss ein Blank, ein Tab (^I) oder ein Komma stehen.
+
+
+Bei Befehlen, die eine Start- und eine Endadresse erfordern, kann
+anstelle der Endadresse auch der Buchstabe 'S', gefolgt von einer
+Laengenangabe verwendet werden.
+ z.B. bedeutet D 1000 S 100 oder D1000S100
+ das selbe wie D 1000 10FF oder D1000,10FF
+
diff --git a/doc/ddtz-ref.txt b/doc/ddtz-ref.txt new file mode 100644 index 0000000..5d54569 --- /dev/null +++ b/doc/ddtz-ref.txt @@ -0,0 +1,204 @@ + Zusammenfassung der Kommandos + ----------------------------- + + > @ + examine [substitute] displacement register @ + Anzeigen und eventuell Aendern des Displacement-Registers + + > A [startadresse] + Assemble Zilog Z80 mnemonics + Assemblieren von Z80-Befehlen + + > B + display all breakpoints + Anzeigen aller Breakpoints + > B breakp [breakp..] + set breakpoints + Breakpoints setzen + > BX + clear all breakpoints + Loeschen aller Breakpoints + > BX adresse [adresse..] + clear breakpoints + Breakpoints loeschen + + >>C[N][J] [befehlsanzahl] + >>C[N][J] W ausdruck + >>C[N][J] U ausdruck + trace over calls [No list] [Jumps only] /.While./.Until. + Tracen ueber CALLs [ohne Ausgabe] [nur Sprungbefehle] + /.solange./.bis. + + >>D [startadr] [endadr] + Display memory in hex and ASCII + Auslisten des Speichers in HEX und ASCII + + > Fkommandozeile + specifiy filename and command line + File-Controlblock und CP/M-Kommandozeile spezifizieren + + > G [startadr] [;breakp..] + Go [to start] [with temporary breakpoints] + Starte ein geladenes Programm, eventuell mit temporaeren + Breakpoints + + > H + display High and maximal size of files + Groesse und maximale Groesse von Files anzeigen + > H ausdruck + compute hex and other expressions + Berechnen eines Ausdrucks + > H ausdruck ausdruck + Hex and other sum and difference + Summe und Differenz zweier Ausdruecke + + >>I [port] + Input a byte from port + Einlesen eines Daten-Bytes von einem Port + + >>L [startadr] [endadr] + List disassembled code + Listen eines Speicherbereichs in Z80-Mnemonics + + > M[V] startadr endadr zieladr + Move memory [and verify] + Umladen eines Speicherbereiches in einen anderen, evtl. + Vergleichen + + >>O [byte] [port] + Output a byte to a port + Ausgeben eines Datenbytes an einen Ausgabeport + + > Q[J] startadr endadr bytes + Query memory for a byte string [Justified] + Durchsuchen des Speichers nach einer gegebenen Folge von + Bytes + + > R [displacement] + Read a binary or hex file ]add displacement] + Einlesen einer Binaer- oder HEX-File in den Speicher, + evtl. verschoben + + > S [startadr] + Substitute Memory + Anzeigen und Aendern von Daten im Speicher + + >>T[N][J] [befehlsanzahl] + >>T[N][J] W ausdruck + >>T[N][J] U ausdruck + Trace [no List] [Jumps only] / .While. / .Until. + Tracen [ohne Ausgabe] [nur Sprungbefehle] /.solange./.bis. + + > Vstartadr endadr zieladr + Verify (compare) two memory areas + Vergleichen zweier Speicherbereiche + + > Wstartadr endadr + Write a file to disk + Ausschreiben eines Speicherbereichs in eine File + + > X + eXamine all cpu registers + Anzeigen aller Register und des Befehls, auf den der Pro- + grammzaehler zeigt + > X register + eXamine [and substitute] a register + Anzeigen und eventuell Modifizieren eines Registers + + > Y + examine all Y variables + Anzeigen aller Y-Variablen + > Yziffer0bis9 + examine [and substitute] an Y variable + Anzeigen und eventuell Modifizieren einer Y-Variablen + + > Z startadr endadr bytes + Zap (fill) memory with a byte string + Vorbesetzen eines Speicherbereiches mit einer Byte-Folge + + + Registernamen + ------------- + + A , F , B , C , D , E , H , L ,BC , DE , HL + A', F', B', C', D', E', H', L',BC', DE', HL' + IX oder X , IY oder Y , Sp oder S , PC oder P , I + + Flags des F- und des F'-Registers: + + S Sign Vorzeichen + Z Zero Null + H Half carry Uebertrag von Bit 3 nach Bit 4 + V oVerflow/parity Ueberlauf/ gerade Paritaet + N Negation NEG, DEC, SUB o.ae. wurde ausgefuehrt + C Carry Uebertrag von Bit 7 + E Interrupt Enabled Das Interrupt-Flag wird im DDTZ wie + ein Flag des F-Registers behandelt. + + Variablen und Konstanten + ------------------------ + + L Low Benutzerspeicher-Anfang. Festwert 100H + H High Hoechste Adresse der letzten gelesenen + File + M Max Maximale Adresse aller gelesenen Files + T Top Oberes Ende des Benutzerspeichers + @ Displacement Register + $ beim Assemblieren Anfangsadresse des + Befehls sonst = PC + Y0..Y9 Frei verwendbare Variablen + ^register Inhalt eines Registers + (adresse) Inhalt eines Speicherplatzes (Byte) + (adresse). Inhalt eines Speicherplatzes (Wort) + + Ausdruecke + ---------- + + In allen Situationen, in denen Zahlen eingegeben werden koen- + nen, ist auch die Eingabe von Ausdruecken erlaubt. + + Ausdruecke sind im allgemeinen arithmetische Ausdruecke, koen- + nen aber auch (zum Formulieren von Bedingungen) Relationen + sein. Relationen bestehen aus zwei arithmetischen Ausdruecken, + zwischen denen einer der folgenden Relationsoperatoren steht: + = <> > >= <= < + + Relationen haben den Wert -1 (=0FFFFH), wenn die Relation wahr + ist, 0 sonst. + z.B. der Ausdruck 1+2=3 hat den Wert -1, und 'A'>'B' den Wert 0 + + Ein arithmetischer Ausdruck hat die folgende Form + + faktor arithmetikoperator faktor arith... faktor + + Die Arithmetikoperatoren sind + + - * / % Addition, Subtraktion, Mult., Division, Modulo + & ! # bitweise AND, OR, XOR + + Ein Faktor hat die Form + [ausdruck] geklammerter Ausdruck + +faktor + -faktor Negation + ~faktor bitweise NOT (1er-Komplement) + 'a' Wert eines ASCII-Zeichens (a=druckbares Zeichen) + 'a'. " mit gesetzem Bit 7 + 'ab' Wert zweier ASCII-Zeichen (a,b=druckbare Zeichen) + 'ab'. " das niederwertige Zeichen mit gesetztem Bit 7 + (ausdruck) ein Byte im Speicher + (ausdruck). ein Wort im Speicher + hhhh[H] Hex-Zahl (h=0..9,A..F oder a..f) + ddddd. Dezimal-Zahl (d=0..9) + bbbbbbbb"bbbbbbbb" Binaer-Zahl (beliebig mit '"' unterteilt (b=0,1) + + Enthaelt ein Ausdruck einen Relationsoperator, so werden erst + die beiden arithmetischen Ausdruecke berechnet und dann die + Relation. + Ein arithmetischer Ausdruck wird von links nach rechts be- + rechnet, also ohne Beachtung "Punktrechnung vor Strichrech- + nung", die Reihenfolge kann jedoch mit Klammern '[' und ']' + geaendert werden. + Ein Pluszeichen darf, wenn dabei der Ausdruck eindeutig bleibt, + weggelassen werden; z.B. ist @1000 dasselbe wie @+1000. + Ausdruecke duerfen keine Leerzeichen enthalten! + + |