[ddt180.git] / doc / ddt180-ref-cb.txt

Kurzreferenz zu DDT180 - Ein erweiterter DDTZ

Änderungen zum Original DDTZ [8101] sind mit "|" am                     |
rechten Rand markiert.                                                  |

Zusammenfassung der Kommandos
-----------------------------

> @
     examine [substitute] displacement register @
     Anzeigen und eventuell Ändern des Displacement-Registers

> A [startadresse]
     Assemble Zilog Z180 mnemonics
     Assemblieren von Z180-Befehlen

> B
     display all breakpoints
     Anzeigen aller Breakpoints
> B breakp [breakp..]
     set breakpoints
     Breakpoints setzen
> BX
     clear all breakpoints
     Löschen aller Breakpoints
> BX adresse [adresse..]
     clear breakpoints
     Breakpoints löschen

>>C[N][J] [befehlsanzahl]
>>C[N][J] W ausdruck
>>C[N][J] U ausdruck
     trace over calls [No list] [Jumps only] /.While./.Until.
     Tracen über 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 filenames and command line                                |
     File-Controlblocks und CP/M-Kommandozeile spezifizieren            |

> G [startadr] [;breakp..]
     Go [to start] [with temporary breakpoints]
     Starte ein geladenes Programm, eventuell mit temporären
     Breakpoints

> H                                                                     |
     display high and maximal size of files                             |
     Höchste Adresse der zuletzt geladenen Datei, höchste               |
     Adresse aller geladenen Dateien (Max) und Ende des                 |
     verfügbaren Speichers (Top) anzeigen.                              |
> HS                                                                    |
     display symbol list                                                |
     Liste der geladenen Symbole anzeigen                               |
> H ausdruck
     compute hex and other expressions
     Berechnen eines Ausdrucks
> H ausdruck ausdruck
     Hex and other sum and difference
     Summe und Differenz zweier Ausdrücke

>>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 and or symbol file [add displacement]    |
     Einlesen einer Binär- oder HEX-File und/oder einer Symboldatei     |
     in den Speicher, evtl. um "displacement" verschoben                |

> S [startadr]
     Substitute Memory
     Anzeigen und Ändern 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
     Programmzähler 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 Parität
N    Negation            NEG, DEC, SUB o.ä. wurde ausgeführt
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                Höchste Adresse der letzten gelesenen
                         File
M    Max                 Maximale Adresse aller gelesenen Files
T    Top                 Oberes Ende des Benutzerspeichers
Z    Zbase               Basis/Startadresse von von DDT180              |
                         Wenn keine Symbole geladen: Z = T              |
@                        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)

Ausdrücke
----------

In allen Situationen, in denen Zahlen eingegeben werden können,
ist auch die Eingabe von Ausdrücken erlaubt.

Ausdrücke sind im allgemeinen arithmetische Ausdrücke, können
aber auch (zum Formulieren von Bedingungen) Relationen sein.
Relationen bestehen aus zwei arithmetischen Ausdrücken, 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 letzte 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"  Binär-Zahl (beliebig mit '"' unterteilt (b=0,1)
.symbol             Wert aus Symboltabelle                              |
.s1:s2: ... :sn     "Qualifiziertes Symbol"                             |

Enthält ein Ausdruck einen Relationsoperator, so werden erst die
beiden arithmetischen Ausdrücke 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 ']'geändert werden.
Ein Pluszeichen darf, wenn dabei der Ausdruck eindeutig bleibt,
weggelassen werden; z.B. ist @1000 dasselbe wie @+1000.
Ausdrücke dürfen keine Leerzeichen enthalten!

Parameter
---------

Am Beginn von DDTZ/DDT180 sind einige Werte gespeichert, die vom
Benutzer angepaßt werden können.

Adr   Default      Bedeutung
--------------------------------------------------------------------
Z3    'RST30'      Opcode für Breakpoint (RST8 - RST38 möglich)
Z4    'NOP'        Wird beim Entritt in DDTZ ausgeführt. Kann durch
                   EI oder DI Opcode (FB/F3) ersetzt werden.
Z5    'RET'        Nicht ändern!
Z6    'JP BDOS'    Nicht ändern!                                        |
Z9    80  (50H)    Bildschirmbreite                                     |
ZA    16  (10H)    Maximal erlaubte Symbol-Länge                        |
ZB    00           Bit 0=1: Gross/Kleinschrift von Symbolen beachten    |
                   Bit 1=1: Symbole beim Laden konvertieren             |
                   Bit 2=1: In Kleinbuchstaben konvertieren             |
Commit	Line	Data
836f48ab L	1	Kurzreferenz zu DDT180 - Ein erweiterter DDTZ
	2
	3	Änderungen zum Original DDTZ [8101] sind mit "\|" am \|
	4	rechten Rand markiert. \|
	5
	6	Zusammenfassung der Kommandos
	7	-----------------------------
	8
	9	> @
	10	examine [substitute] displacement register @
	11	Anzeigen und eventuell Ändern des Displacement-Registers
	12
	13	> A [startadresse]
	14	Assemble Zilog Z180 mnemonics
	15	Assemblieren von Z180-Befehlen
	16
	17	> B
	18	display all breakpoints
	19	Anzeigen aller Breakpoints
	20	> B breakp [breakp..]
	21	set breakpoints
	22	Breakpoints setzen
	23	> BX
	24	clear all breakpoints
	25	Löschen aller Breakpoints
	26	> BX adresse [adresse..]
	27	clear breakpoints
	28	Breakpoints löschen
	29
	30	>>C[N][J] [befehlsanzahl]
	31	>>C[N][J] W ausdruck
	32	>>C[N][J] U ausdruck
	33	trace over calls [No list] [Jumps only] /.While./.Until.
	34	Tracen über CALLs [ohne Ausgabe] [nur Sprungbefehle]
	35	/.solange./.bis.
	36
	37	>>D [startadr] [endadr]
	38	Display memory in hex and ASCII
	39	Auslisten des Speichers in HEX und ASCII
	40
	41	> Fkommandozeile \|
	42	specifiy filenames and command line \|
	43	File-Controlblocks und CP/M-Kommandozeile spezifizieren \|
	44
	45	> G [startadr] [;breakp..]
	46	Go [to start] [with temporary breakpoints]
	47	Starte ein geladenes Programm, eventuell mit temporären
	48	Breakpoints
	49
	50	> H \|
	51	display high and maximal size of files \|
	52	Höchste Adresse der zuletzt geladenen Datei, höchste \|
	53	Adresse aller geladenen Dateien (Max) und Ende des \|
	54	verfügbaren Speichers (Top) anzeigen. \|
	55	> HS \|
	56	display symbol list \|
	57	Liste der geladenen Symbole anzeigen \|
	58	> H ausdruck
	59	compute hex and other expressions
	60	Berechnen eines Ausdrucks
	61	> H ausdruck ausdruck
	62	Hex and other sum and difference
	63	Summe und Differenz zweier Ausdrücke
	64
65	>>I [port]
66	Input a byte from port
67	Einlesen eines Daten-Bytes von einem Port
68
69	>>L [startadr] [endadr]
70	List disassembled code
71	Listen eines Speicherbereichs in Z80-Mnemonics
72
73	> M[V] startadr endadr zieladr
74	Move memory [and verify]
75	Umladen eines Speicherbereiches in einen anderen, evtl.
76	Vergleichen
77
78	>>O [byte] [port]
79	Output a byte to a port
80	Ausgeben eines Datenbytes an einen Ausgabeport
81
82	> Q[J] startadr endadr bytes
83	Query memory for a byte string [Justified]
84	Durchsuchen des Speichers nach einer gegebenen Folge von
85	Bytes
86
87	> R [displacement] \|
88	Read a binary or hex file and or symbol file [add displacement] \|
89	Einlesen einer Binär- oder HEX-File und/oder einer Symboldatei \|
90	in den Speicher, evtl. um "displacement" verschoben \|
91
92	> S [startadr]
93	Substitute Memory
94	Anzeigen und Ändern von Daten im Speicher
95
96	>>T[N][J] [befehlsanzahl]
97	>>T[N][J] W ausdruck
98	>>T[N][J] U ausdruck
99	Trace [no List] [Jumps only] / .While. / .Until.
100	Tracen [ohne Ausgabe] [nur Sprungbefehle] /.solange./.bis.
101
102	> Vstartadr endadr zieladr
103	Verify (compare) two memory areas
104	Vergleichen zweier Speicherbereiche
105
106	> Wstartadr endadr
107	Write a file to disk
108	Ausschreiben eines Speicherbereichs in eine File
109
110	> X
111	eXamine all cpu registers
112	Anzeigen aller Register und des Befehls, auf den der
113	Programmzähler zeigt
114	> X register
115	eXamine (and substitute) a register
116	Anzeigen und eventuell Modifizieren eines Registers
117
118	> Y
119	examine all Y variables
120	Anzeigen aller Y-Variablen
121	> Yziffer0bis9
122	examine [and substitute] an Y variable
123	Anzeigen und eventuell Modifizieren einer Y-Variablen
124
125	> Z startadr endadr bytes
126	Zap (fill) memory with a byte string
127	Vorbesetzen eines Speicherbereiches mit einer Byte-Folge
128
129
130	Registernamen
131	-------------
132
133	A , F , B , C , D , E , H , L ,BC , DE , HL
134	A', F', B', C', D', E', H', L',BC', DE', HL'
135	IX oder X , IY oder Y , Sp oder S , PC oder P , I
136
137	Flags des F- und des F'-Registers:
138
139	S Sign Vorzeichen
140	Z Zero Null
141	H Half carry Uebertrag von Bit 3 nach Bit 4
142	V oVerflow/parity Ueberlauf/ gerade Parität
143	N Negation NEG, DEC, SUB o.ä. wurde ausgeführt
144	C Carry Uebertrag von Bit 7
145	E Interrupt Enabled Das Interrupt-Flag wird im DDTZ wie
146	ein Flag des F-Registers behandelt.
147
148	Variablen und Konstanten
149	------------------------
150
151	L Low Benutzerspeicher-Anfang. Festwert 100H
152	H High Höchste Adresse der letzten gelesenen
153	File
154	M Max Maximale Adresse aller gelesenen Files
155	T Top Oberes Ende des Benutzerspeichers
156	Z Zbase Basis/Startadresse von von DDT180 \|
157	Wenn keine Symbole geladen: Z = T \|
158	@ Displacement Register
159	$ beim Assemblieren Anfangsadresse des
160	Befehls sonst = PC
161	Y0..Y9 Frei verwendbare Variablen
162	^register Inhalt eines Registers
163	(adresse) Inhalt eines Speicherplatzes (Byte)
164	(adresse). Inhalt eines Speicherplatzes (Wort)
165
166	Ausdrücke
167	----------
168
169	In allen Situationen, in denen Zahlen eingegeben werden können,
170	ist auch die Eingabe von Ausdrücken erlaubt.
171
172	Ausdrücke sind im allgemeinen arithmetische Ausdrücke, können
173	aber auch (zum Formulieren von Bedingungen) Relationen sein.
174	Relationen bestehen aus zwei arithmetischen Ausdrücken, zwischen
175	denen einer der folgenden Relationsoperatoren steht:
176	= <> > >= <= <
177
178	Relationen haben den Wert -1 (=0FFFFH), wenn die Relation wahr
179	ist, 0 sonst.
180	z.B. der Ausdruck 1+2=3 hat den Wert -1, und 'A'>'B' den Wert 0
181
182	Ein arithmetischer Ausdruck hat die folgende Form
183
184	faktor arithmetikoperator faktor arith... faktor
185
186	Die Arithmetikoperatoren sind
187	+ - * / % Addition, Subtraktion, Mult., Division, Modulo
188	& ! # bitweise AND, OR, XOR
189
190	Ein Faktor hat die Form
191	[ausdruck] geklammerter Ausdruck
192	+faktor
193	-faktor Negation
194	~faktor bitweise NOT (1er-Komplement)
195	'a' Wert eines ASCII-Zeichens (a=druckbares Zeichen)
196	'a'. " mit gesetzem Bit 7
197	'ab' Wert zweier ASCII-Zeichen (a,b=druckbare Zeichen)
198	'ab'. " das letzte Zeichen mit gesetztem Bit 7
199	(ausdruck) ein Byte im Speicher
200	(ausdruck). ein Wort im Speicher
201	hhhh[H] Hex-Zahl (h=0..9,A..F oder a..f)
202	ddddd. Dezimal-Zahl (d=0..9)
203	bbbbbbbb"bbbbbbbb" Binär-Zahl (beliebig mit '"' unterteilt (b=0,1)
204	.symbol Wert aus Symboltabelle \|
205	.s1:s2: ... :sn "Qualifiziertes Symbol" \|
206
207	Enthält ein Ausdruck einen Relationsoperator, so werden erst die
208	beiden arithmetischen Ausdrücke berechnet und dann die Relation.
209	Ein arithmetischer Ausdruck wird von links nach rechts berechnet,
210	also ohne Beachtung "Punktrechnung vor Strichrechnung", die
211	Reihenfolge kann jedoch mit Klammern '[' und ']'geändert werden.
212	Ein Pluszeichen darf, wenn dabei der Ausdruck eindeutig bleibt,
213	weggelassen werden; z.B. ist @1000 dasselbe wie @+1000.
214	Ausdrücke dürfen keine Leerzeichen enthalten!
215
216	Parameter
217	---------
218
219	Am Beginn von DDTZ/DDT180 sind einige Werte gespeichert, die vom
220	Benutzer angepaßt werden können.
221
222	Adr Default Bedeutung
223	--------------------------------------------------------------------
224	Z3 'RST30' Opcode für Breakpoint (RST8 - RST38 möglich)
225	Z4 'NOP' Wird beim Entritt in DDTZ ausgeführt. Kann durch
226	EI oder DI Opcode (FB/F3) ersetzt werden.
227	Z5 'RET' Nicht ändern!
228	Z6 'JP BDOS' Nicht ändern! \|
229	Z9 80 (50H) Bildschirmbreite \|
230	ZA 16 (10H) Maximal erlaubte Symbol-Länge \|
231	ZB 00 Bit 0=1: Gross/Kleinschrift von Symbolen beachten \|
232	Bit 1=1: Symbole beim Laden konvertieren \|
233	Bit 2=1: In Kleinbuchstaben konvertieren \|