doc/ddtz-help.txt

   1 DDT/Z180 (ROM) Commands:
   2 > @                             examine/substitute the displacement register @
   3 > A [address]                   Assemble
   4 > B[X]                          display [or clear] all Breakpoints
   5   B breakp [:count] [breakp..]  set Breakpoints
   6   BX address [address..]        clear Breakpoints
   7 >>C[N][J] [count]               trace over Calls [No list] [Jumps only]
   8   C[N][J] W|U expression        trace over Calls While|Until ...
   9 >>D [startadr] [endadr]         Display memory in hex and ascii
  10 > G [startadr] [;breakp..]      Go [to start] [temporary breakpoints]
  11 > H                             display High and max load address (set by R cmd)
  12 > H expression [expression]     compute Hex and other expressions
  13 >>I [port]                      Input a byte from port
  14 >>L [startadr] [endadr]         List disassembled code
  15 > M[V] startadr endadr destadr  Move memory [and verify]
  16 >>O [byte] [port]               Output a byte to port
  17 > Q[J] startadr endadr bytes    Qery memory for byte string [Justified]
  18 > R [displacement]              Read intel hex from console [add displacemt]
  19 > S address                     Substitute memory
  20 >>T[N][J] [count]               Trace [No list] [Jumps only] [count steps]
  21   T[N][J] W|U expression        Trace While|Until ...
  22 > V startadr endadr destadr     Verify (compare) two memory areas
  23 > X[register]                   eXamine [and substitute] registers
  24 > Y[0..9]                       eXamine [and substitute] Y variables
  25 > Z startadr endadr bytes       Zap (fill) memory with a byte string
  26
  27
  28
  29 Registernamen:
  30
  31 A , F , B , C , D , E , H , L ,BC , DE , HL
  32 A', F', B', C', D', E', H', L',BC', DE', HL'
  33 IX oder X , IY oder Y , SP oder S , PC oder P , I
  34
  35 Flags des F- und des F'-Registers:
  36
  37 S    Sign                 Vorzeichen
  38 Z    Zero                 Null
  39 H    Half carry           Uebertrag von bit 3 nach bit 4
  40 V    oVerflow/parity      Ueberlauf/gerade Paritaet
  41 N    Negation             NEG, DEC, SUB o.ae. ausgefuehrt
  42 C    Carry                Uebertrag von bit 7
  43 E    interrupt Enabled    das Interrupt flag wird im DDTZ wie
  44                           ein Flag des F-Registers behandelt.
  45
  46 Variablen und Konstanten:
  47
  48 L    Low                  Benutzerspeicher-Anfang. Festwert 100H
  49 H    High                 Hoechste Adresse der letzten gelesenen File
  50 M    Max                  Maximale Adresse aller gelesenen Files
  51 T    Top                  Oberes Ende des Benutzerspeichers
  52 @                         Displacement Register
  53 $                         beim Assemblieren Anfangsadresse des Befehls
  54                           sonst = PC
  55 Y0..Y9                    frei verwendbare Variablen
  56 ^register                 Inhalt eines Registers
  57 (adresse)                 Inhalt eines Speicherplatzes (Byte)
  58 (adresse).                Inhalt eines Speicherplatzes (Wort)
  59
  60
  61 Allgemeines zum Gebrauch des DDTZ:
  62
  63 Ausdruecke:
  64
  65 In allen Situationen, in denen Zahlen eingegeben werden koennen, ist
  66 auch die Eingabe von Ausdruecken erlaubt.
  67 Ausdruecke haben die Form
  68         arithmetischerexpression
  69   oder  arithmetischerexpression relationsoperator arithmetischerexpression
  70 Die relationsoperatoren sind
  71 =  <>  >  >=  <=  <
  72 Der expression hat den Wert -1, wenn die Relation wahr ist, sonst 0.
  73 z.B:    der expression 1+2=3 hat den Wert -1, und 'A'<'B' den Wert 0
  74 Ein arithmetischer expression hat die allgemeine Form
  75         faktor arithmetikoperator faktor arith... faktor
  76 Die Arithmetikoperatoren sind
  77 + - * / %            Plus, Minus, Multiplikation, Division, Modulo
  78 & ! #                bitweise AND, OR, XOR
  79
  80 Ein Faktor hat die Form
  81 [expression]         geklammerter expression
  82 +faktor
  83 -faktor              Negation
  84 ~faktor              bitweise NOT
  85 'a'                  Wert eines ASCII-Zeichens
  86 'a'.                 mit gesetztem Bit 7
  87 'ab'                 Wert zweier ASCII-Zeichen
  88 'ab'.                das niederwertige mit gesetztem bit 7
  89 (expression)         ein Byte im Speicher
  90 (expression).        ein Wort im Speicher
  91 variable             eine der oben aufgezaehlten Variablen
  92 hhhh[H]              Hex-Zahl
  93 ddddd.               Dezimal-Zahl
  94 bbbbbbbb"bbbbbbbb"   Binaer-Zahl (beliebig mit '"' unterteilt)
  95
  96 Enthaelt ein expression einen Relationsoperator, so werden erst die
  97 beiden arithmetischen Ausdruecke berechnet und dann die Relation.
  98 Ein arithmetischer expression wird von links nach rechts berechnet,
  99 also ohne Beachtung 'Punktrechnung vor Strichrechnung', die Reihenfolge
 100 kann jedoch mit Klammern '[' und ']' geaendert werden.
 101 Ausdruecke duerfen keine Blanks enthalten.
 102
 103 Befehle:
 104
 105 Befehle beginnen mit einem der Zeichen '@' bis 'Z', eventuell gefolgt
 106 von weiteren optionalen Buchstaben, sowie Argumenten. Wird eine
 107 optionale Anfangsadresse weggelassen, so wird die Adresse benutzt,
 108 bei der Befehl zuletzt beendet wurde. Wird eine optionale Endadresse
 109 weggelassen, so wird der Befehl (z.B. L oder D) so lange ausgefuehrt,
 110 bis etwa ein Bildschirm vollgeschrieben ist. Ein weggelassenes
 111 optionales Argument, hinter dem weitere Argumente angegeben werden
 112 sollen, muss durch ein Komma ersetzt werden. Zwischen zwei Argumenten
 113 muss ein Blank, ein Tab (^I) oder ein Komma stehen.
 114
 115
 116 Bei Befehlen, die eine Start- und eine Endadresse erfordern, kann
 117 anstelle der Endadresse auch der Buchstabe 'S', gefolgt von einer
 118 Laengenangabe verwendet werden.
 119   z.B. bedeutet   D 1000 S 100  oder D1000S100
 120          das selbe wie   D 1000 10FF oder D1000,10FF
 121