doc/ddt180-ref-cb.txt

   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             |