home *** CD-ROM | disk | FTP | other *** search
/ Computer Club Elmshorn Atari PD / CCE_PD.iso / pc / 0600 / CCE_0683.ZIP / CCE_0683 / TP206V38.LZH / TP206V38 / BEFEHLE.TXT < prev    next >
Text File  |  1993-10-26  |  9KB  |  197 lines
  1. Befehlsübersicht zu TOSPATCH V2.4:
  2. ----------------------------------
  3.  
  4. ;                   = Kommentar (d.h. Rest der Zeile überlesen).
  5. <*                  = TOS aus ROM lesen (Daten im Patchfile müssen stimmen!)
  6. <FILE.EXT           = TOS aus <FILE.EXT> lesen
  7. =TT.MM.JJJJ         = Prüfen, ob es sich um das richtige TOS handelt (Datum).
  8. >Anzahl [Relocadr]  = gepachtes TOS in <Anzahl> Datei(en) schreiben.
  9.                       Mögliche Werte für 'Anzahl' sind 1,2,4,6 und 8. Wenn
  10.                       'Relocadr' vorhanden, wird nach <Relocadr> reloziert.
  11.                       <Relocadr> wird in die Variable .RELOCADR geschrieben.
  12. §                   = CRC-Prüfsumme nach dem Patchen berechnen und setzen.
  13.                       Die Variable .CRC wird von 0 auf 1 gesetzt wenn
  14.                       die Prüfsumme berchnet werden soll.
  15. !Long,Long, ...     = Einzelne Ausnahmen beim Relozieren.
  16. !Long1..Long2, ...  = Bereich von Long1 bis Long2 vom Relozieren ausnehmen.  
  17. ?                   = Einzelne Adressen Relozieren.
  18.                       (bei Adressen, die z.B. das höchstwertige Byte benutzen
  19.                       und somit von TOSPATCH nicht erkannt werden).
  20. -Pfad               = Dateipfad ändern auf <Pfad> ändern (Ordner öfnen etc.)
  21.                       <Pfad> = .. schließt Ordner.
  22. Offset $Byte,Byte.. = Ab <Offset> die durch Kommata getrennten Bytes in das
  23.                       TOS schreiben und ~ aktualisieren. Statt Bytes können
  24.                       hier auch beliebige Ausdrücke eingesetzt werden
  25.                       (Variablen, #, Operationen etc.). Hinter einem Ausdruck
  26.                       kann auch die gewünschte Breite stehen, z.B. .B für
  27.                       Byte (Default), .W für WORD und .L für LONG.
  28.                       ~ wird aktualisiert.
  29. Offset |$Byte,Byte..= dito, jedoch ohne ~ zu aktualisieren.
  30. Offset FILE.EXT     = Ab <Offset> die Datei <FILE.EXT> ins TOS schreiben.
  31.                       Die Datei muß entweder relocatibel oder zur
  32.                       TOS-Basisadresse ($E00000) + <Offset> assembliert sein.
  33.                       ~ wird aktualisiert.
  34. Offset |FILE.EXT    = dito, jedoch ohne Aktualisieren von ~.
  35. #Wert               = <Wert> wird in den internen Speicher schreiben.
  36. +FILE.EXT           = Liest ein 2. Patchfile und wertet dies aus.
  37.                       Es können in dem File können alle hier beschriebenen
  38.                       Befehle benutzt werden bis auf diesen selbst.
  39.                       D.h. ein 2. Patchfile kann KEIN Patchfile mehr laden!
  40. _IF Ausdruck        = Wenn der Ausdruck wahr ist, werden die nachfolgenden
  41.                       Zeilen bis _ELSE oder _ENDIF (falls kein _ELSE)
  42.                       ausgeführt. Ist der Ausdruck falsch werden die
  43.                       nachfolgenden Zeilen bis _ELSE (falls vorhanden) oder
  44.                       _ENDIF übersprungen.
  45. _ELSE               = Falls die _IF-Bedingung falsch war, wird ab hier
  46.                       weitergearbeitet.
  47. _ENDIF              = Beendung einer _IF (/_ELSE) Konstruktion.
  48. _ERROR ['Text']     = Abbruch des Patchvorganges und ggf. Ausgabe von:
  49.                       'Fehler: ',Text,' in Zeile .xxx'
  50. _EVEN               = Falls ~ gerade ist passiert garnichts, sonst wird ein
  51.                       Nullbyte an Adresse ~ gepatcht, so daß ~ gerade wird.
  52. .Variable = Wert    = Schreiben von <Wert> in die Variable .Variable.
  53. .Variable:          = Schreiben von ~ in die Variable .Variable.
  54.                       Nach dem Doppelpunkt können Patches folgen.
  55. /'Text',Zahl,$Zahl  = Print-Befehl schreibt Texte ('Text'), dezimale
  56.                       Zahlen (Zahl) und hexadezimale Zahlen ($Zahl), die
  57.                       durch Komma getrennt sind, in beliebiger Reihenfolge 
  58.                       auf den Bildschirm. Für Zahlen sind beliebige
  59.                       Ausdrücke erlaubt.
  60.  
  61.  
  62. Spezielle Variablen:
  63. --------------------
  64.  
  65. .BASE = Long        = TOS-Basisadresse setzen, zu der das TOS reloziert ist.
  66.                       $FC0000 für TOS 1.xx, $E00000 für TOS 2.xx und 3.xx.
  67. .LENGTH = Long      = TOS-Länge setzen. $30000 für TOS 1.xx, $40000 für
  68.                       TOS 2.xx und $80000 für TOS 3.xx.
  69. .WIDTH = Long       = Breite des TOS setzen. Gibt an, ob das TOS 16-bittig 
  70.                       (.16) oder 32-bittig (.32) organisiert sein soll. Ist
  71.                       wichtig beim Abspeichern in mehreren Dateien zum 
  72.                       Brennen. Normal: TOS 2.06: 16, TOS 3.06: 32.
  73.                       Mögliche Werte: .8, .16, .32, .64 .
  74.  
  75. .CRC                = .CRC wird durch den §-Befehl von 0 auf 1 gesetzt.
  76.                       Diese Variable zeigt an, ob die CRC-Prüfsumme nach
  77.                       dem Patchen berechnet und gesetzt wird.
  78. .RELOCADR           = in .RELOCADR steht die Adresse, an die das TOS
  79.                       nach dem Patchen reloziert wird.
  80. ~                   = ~ zeigt auf die Adresse nach letztem abgearbeitetem
  81.                       Patch.
  82.  
  83. #<Breite>           = Ist eine einfache Variable, die durch den Befehl
  84.                       #<Wert> auf <Wert> gesetzt wird, aber nicht bei
  85.                       Operationen verwendet werden kann. Für <Breite> sind
  86.                       folgende Werte möglich: B für Byte, W für WORD und
  87.                       L für LONG. <Breite> muß mit angegeben werden.
  88.  
  89.  
  90. Aufteilung beim Abspeichern:
  91. ----------------------------
  92.  
  93. Beim Abspeichern in mehrere Dateien wird das TOS wie folgt aufgeteilt:
  94.  
  95. WIDTH=.16: 1.Byte TOS.HIx
  96.            2.Byte TOS.LOx
  97.            3.Byte TOS.HIx
  98.            4.Byte TOS.LOx usw.
  99. WIDTH=.32: 1.Byte TOS.HHx
  100.            2.Byte TOS.HLx
  101.            3.Byte TOS.LHx
  102.            4.Byte TOS.LLx
  103.            5.Byte TOS.HHx
  104.            6.Byte TOS.HLx
  105.            7.Byte TOS.LHx
  106.            8.Byte TOS.LLx usw.
  107.  
  108. Das  TOS  kann  dabei  in bis zu 16 Bänke, aber max. 32 Dateien, gesplittet
  109. werden.  x  zählt  von  0-9 hoch und fährt dann mit A-P fort. Gibt es keine
  110. zwei Dateien mit gleicher Extension, wird x weggelassen.
  111.  
  112.  
  113. Ausdrücke und Variablen:
  114. ------------------------
  115.  
  116. Ab  jetzt  kann  man  auch  für (fast) jede Zahl im Patchfile eine Ausdruck
  117. angeben. Die Breite diese Ausdruck kann an das Ende des Ausdrucks angehängt
  118. werden: Ausdruck.B, Ausdruck.W oder Ausdruck.L (Default: .B)
  119.  
  120. Soll eine Zahl dezimal sein muß sie eine Punkt als Prefix haben:
  121. .20 = dezimal 20, 20 = hexadezimal 20!
  122.  
  123. Alle  Variablen  beginnen  mit  einem  Punkt. Groß- und Kleinschreibung ist
  124. egal.  Von  dem  Variablenname  nach  dem  Punkt werden nur die ersten acht
  125. Stellen ausgewertet, d.h. .VARIABLEA ist gleich .VARIABLEB!
  126.  
  127. Als  Zeichen  im  Variablenname  sind  erlaubt: A bis Z , 0 bis 9 sowie _ ,
  128. wobei 0 bis 9 nicht an erster Stelle des Variablennamens stehe darf.
  129.  
  130. Eine  spezielle  Variable ist ~. In ihr steht das Ende des letzten Patches.
  131. Vor  ihr,  sowie  auch  vor  #, darf kein Punkt stehen. Diese Variable kann
  132. z.B. genutzt werden, um mehrere Patches hintereinander zu laden:
  133. 30000 PATCH1.ABS
  134. ~     PATCH2.ABS
  135. ~     PATCH3.ABS
  136. patcht ab Offset 30000 PATCH1.ABS, PATCH2.ABS und PATCH3.ABS hintereinander
  137. in den Speicher
  138.  
  139.  
  140. Prioritäten:
  141. ------------
  142.  
  143. Als Operationen sind möglich (in Reihenfolge ihrer Priorität):
  144. ^              : Potenzierung
  145. *,/            : Multiplikation, Division
  146. +,-            : Addition, Subtraktion
  147. !A! oder !AND! : Und
  148. !O! oder !OR!  : Oder
  149. !X! oder !XOR! : Exklusiv Oder
  150.  
  151. Als Vergleiche sind möglich (auch als Operationen zu verwenden):
  152. <> : Ungleich
  153. <= : Kleiner oder Gleich
  154. <  : Kleiner
  155. >= : Größer oder Gleich
  156. >  : Größer
  157. =  : Gleich
  158.  
  159. Die  Vergleichszeichen können dabei auch in Ausrufungszeichen eingeklammert
  160. werden, z.B. a<>b ist das gleiche wie a!<>!b.
  161.  
  162. Die  Vergleiche  liefern  als  wahr eine 1 und als falsch eine 0 zurück und
  163. haben die niedrigste Priorität.
  164.  
  165. Klammerungen sind in bis zu 8 Ebenen möglich.
  166.  
  167.  
  168. Allgemeines:
  169. ------------
  170.  
  171. Die maximale Größe des Hauptpatchfiles beträgt 64kByte.
  172. Die maximale Größe des zweiten Patchfiles beträgt jedoch 'nur' 32kByte!
  173.  
  174. TOSPATCH erzeugt als Ausgabefile immer TOS.IMG!
  175. Benennt  also das ausgelesene Original-TOS, falls es erhalten bleiben soll,
  176. um, z.B. in STE_TOS.IMG oder TT_TOS.IMG! 
  177.  
  178.  
  179. Zusätzliche Programme:
  180. ----------------------
  181.  
  182. Das  Programm  AUTO_206.PRG/AUTO_306.PRG gehört in den AUTO-Ordner. Es lädt
  183. von  dort  ein  TOS.IMG  aus  dem ROOT-Directory (der Pfad kann im Programm
  184. gepatcht werden) an die im TOS.IMG angegebene Adresse.
  185. Zum  Konfigurieren  von  AUTO_206.PRG/AUTO_306.PRG  dient AUTOCONF.PRG. Mit
  186. AUTOCONF.PRG  lassen  sich die Hotkeys, die Startup-Zeit und das zu ladende
  187. TOS in AUTO_206.PRG/AUTO_306.PRG verändern.
  188.  
  189. Das  Programm  RESETTOS.PRG dient dazu das TOS, wenn es mit RAMRESET reset-
  190. fest  gemacht  wurde,  aus dem Speicher zu entfernen, ohne den Rechner aus-
  191. schalten zu müssen.
  192.  
  193. >>>   Wenn   Ihr   neue  Patches  einbaut,  mailt  sie  mir  bitte!!!  <<<
  194.  
  195.    Viel Spaß wünscht
  196.      Markus Heiden
  197.