Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.


Vorhergehende Überarbeitung
Letzte Überarbeitung
—z9001:software:edas [2019/03/01 10:12] – [Beispiel] volkerp
Zeile 1: Zeile 1:
 +====== EDAS ======
 +
 +**ein Editor/Assembler für den Z9001**
 +
 +Mit dem EDAS können Programme in Assemblersprache geschrieben und in Maschinencode übersetzt werden. Der Editor ist recht einfach aufgebaut und arbeitet zeilenorientiert. Der Assembler benutzt ebenso wie der IDAS die SYPS-K-1520-Syntax. Der Assembler ist ein Absolutassembler, d.h. er kann nur direkt Maschinencode erzeugen, aber keine REL-Dateien. Er ist leider auch nicht makrofähig.
 +
 +===== Speicherbelegung =====
 +
 +RAM-Version 1000H-37FFh
 +
 +ROM-Version C000h-E7FFh
 +
 +Der Speicher von 0300h-0FFFh wird als Arbeitspeicher genutzt.
 +
 +Der Speicher von 3800H bis RAM-Ende (RAM-Version) bzw. 1000H-RAM-Ende (ROM-Version) wird als Textspeicher genutzt. Mit dem Kommando #A des Editors kann dieser Bereich geändert werden, um Speicherplatz für den übersetzten Maschinencode freizuhalten.
 +
 +===== Editor =====
 +
 +Der Editor wird vom OS durch Eingabe von **EDIT** gestartet.
 +
 +Nach dem Start meldet sich der Editor mit "EDIT:". Wird hier "N" (Neustart) eingegeben, wir der Editor initialisiert; vorher eingegebener Text ist verloren. Jede andere Taste bewirken einen Restart des Editors. Ein im Textpuffer stehender Text bleibt erhalten. 
 +
 +Durch die Ausgabe von "+" auf dem Bildschirm wird die nächste Bedienereingabe angefordert.
 +
 +Der Editor arbeitet zeilenorientiert, d.h., es werden stets vollständige Zeilen
 +verarbeitet. Die Spezifizierung der Zeilen kann sowohl durch die
 +Zeilennummer als auch durch eine zu Beginn der Zeile stehende
 +Zeichenkette erfolgen. 
 +
 +Korrekturen während der Eingabe einer Zeile sind durch Betätigen der Kursortaste <- und anschließende Eingabe der richtigen Zeichen möglich. Beginnt die Bedienereingabe mit dem Zeichen # (Kommandokennzeichen), so wird die nachfolgend eingegebene Zeile als Kommentar interpretiert. Andernfalls wird sie als neue Zeile in den Quelltext übernommen. Die maximale Länge einer Zeile beträgt 72 Zeichen.
 +
 +EDIT realisiert folgende Funktionen:
 +  * Streichen von Zeilen,
 +  * Einfügen von Zeilen,
 +  * Substituieren von Zeichenketten,
 +  * Anfügen von Kommentar,
 +  * Streichen von Kommentar,
 +  * Anzeigen des Textpufferinhaltes auf dem Bildschirm,
 +  * Ausgeben des Textpufferinhaltes auf Magnetbandkassette,
 +  * Eingeben von Quelltexten von der Magnetbandkassette in den Textpuffer.
 +
 +^ Kommando ^ Syntax ^ Erläuterung ^
 +| assign | #A | Anzeigen und Modifizieren des Textpufferbereiches\\ Eingabe hexadezimal als "neue Textpufferanfangsadresse,Endeadresse[N]" in der Form XXXXX,XXXXX[N]. Das "N" (Neustart) bewirkt ein Leeren des Textpuffers. |
 +| begin | #B | Neustart des Aufbereitungsvorganges, Rücksetzen auf Textanfang |
 +| end| #E | Beenden der Arbeit mit dem Editor |
 +| read| #R"Name" | Eingabe von der Kassette in den Textpuffer |
 +| write | #W"Name" | Ausgabe des Textpufferinhaltes auf Magnetband |
 +| text | #Tn,m | Ausschreiben des Textpufferinhaltes | 
 +| insert | #In | Einfügen von Zeilen NACH Zeile n |
 +| kill | #Kn,m | Streichen von Zeilen n bis einschließlich m |
 +| comment | #Cn,m | Anfügen von Kommentar |
 +| no comment | #Nn,m | Streichen von Kommentar |
 +| substitute | #Sn,m\\ /ZKa1/ZKn1/,/ZKa2/ZKn2/,...,/ZKan/ZKnn/ | Substituieren von Teilzeichenketten |
 +| uppercase | #UN oder #U[Y] | Umwandlung von Kleinbuchstaben in Großbuchstaben |
 +| ??? | #D | Kommando ist nicht dokumentiert |
 +| (list) | #Ln,m | (Kommando ist nicht dokumentiert) Ausgabe auf Drucker |
 +
 +
 +**Fehlermeldungen**
 +
 +| +++CE (command error) | Das eingegebene Kommando ist syntaktisch fehlerhaft oder nicht sinnfällig. |
 +| +++LE (length error) | Die maximale Zeilenlänge (72) wurde überschritten. |
 +| +++NF (not found) | Eine spezifizierte Zeile wurde im Textpuffer nicht gefunden. |
 +| +++TB (textbuffer) | Das Ende des Textpuffers ist erreicht. |
 +| +++SE (substitution error) | Bei einem S-Kommando konnte keine der angegebenen Substitutionen ausgeführt werden |
 +
 +
 +===== Assembler =====
 +
 +Der Assembler wird vom OS durch Eingabe von **ASM** gestartet.
 +Er meldet sich nach dem Start mit der Ausschrift "ASM--HC:" und erwartet die Eingabe eines Pflichtkommandos. Beim ersten Start muß ein "N" eingegeben werden.
 +
 +ASM realisiert folgende Funktionen:
 +  * Quellprogrammeingabe aus dem Textpuffer des Editors EDIT,
 +  * Maschinencodeausgabe in den Speicher,
 +  * Maschinencodeausgabe auf das Magnetband,
 +  * Ausgabe der Assemblerprotokolle auf dem Listgerät (Bildschirm oder Drucker). Es kann zwischen Übersetzungsliste, Fehlerliste, Crossreferenztabelle und Symbolreferenztabelle gewählt werden.
 +
 +ASM übersetzt den Inhalt des Textpuffers des Editors EDIT in den Maschinencode. Die Ausgabe erfolgt auf das Magnetband oder in den Arbeitsspeicher (RAM) des Heimcomputers.
 +Das Assemblerprotokoll kann über den Bildschirm oder einen Drucker, falls ein Drucker und das entsprechende Druckerbedienungsprogramm vorhanden sind, ausgegeben werden.
 +
 +ASM benötigt 2 Durchläufe (Pässe) zur Übersetzung. Im 1. Durchlauf
 +erzeugt er die Symboltabelle. Im 2. Durchlauf kann gewählt werden
 +zwischen: 
 +  * Ausgabe der Übersetzungsliste,
 +  * Ausgabe des Maschinencodes in den Arbeitsspeicher oder auf Kassette,
 +  * Ausgabe der Fehlerliste der Assemblerquelle,
 +  * Ausgabe der Crossreferenztabelle,
 +  * Ausgabe der Symbolreferenztabelle.
 +
 +Mit der Ausschrift "PASS:" fordert ASM die Spezifikation des aktuellen Passes an. Es sind folgende Eingaben möglich:
 +
 +| 1 | Ausführung des 1. Durchlaufs. Von dem Quelltext, der im Textpuffer des EDIT steht, wird eine Symboltabelle im RAM erzeugt. Dieser Paß ist für die Übersetzung eines Programmes unbedingt notwendig. |
 +| P (print) | P[Zeilennummer1,Zeilennummer2[,Programmende]]\\ Ausgabe der Übersetzungsliste auf dem Listgerät. |
 +| M (MC-Output) | Ausgabe des Maschinencodes auf Magnetbandkassette oder in den Arbeitsspeicher entsprechend der Angabe "T" oder "R".\\ NAME: Bis 8 Zeichen, in Hochkommas; ADDRESS: Startadresse oder einfach Enter  |
 +| F (fault) | Syntaktische Prüfung des Quellcodes und Ausgabe der Fehlermeldungen bei syntaktisch falschem Programm. |
 +| X (cross-reference) | Ausgabe der Crossreferenztabelle |
 +| A (adress-dictionary) | Ausgabe der Symbolreferenztabelle |
 +| V (variation) | Änderung des Datenflusses für die Ausgabe des Maschinencodes und der Assemblerprotokolle.\\ Nach der Ausschrift "MO:" wird durch die Eingabe von "T" oder "R" festgelegt, ob die MC-Ausgabe bei der Ausführung des Kommandos M auf die Magnetbandkassette  oder in den RAM oder erfolgen soll.\\ Nach der Ausgabe von "LO:" wird durch die Eingabe von "C" der Bildschirm (Console) oder "F" der Drucker als Listgerät festgelegt. | 
 +| E (end) | Rücksprung in das Steuerprogramm (Monitor). |
 +
 +Der 1. Paß ist Voraussetzung für die Übersetzungsläufe P, F, M, X und A.
 +Diese können in beliebiger Reihenfolge durchgeführt werden.
 +
 +==== Syntax ====
 +
 +:!: ASM versteht nur Befehle (Mnemoniks) mit Großbuchstaben. Mnemoniks mit Kleinbuchstaben weist ASM als syntaktisch falsch aus.
 +
 +Gegenüberstellung der Schreibweise einiger Beispielbefehle:
 +
 +<code>
 +     ROBOTRON      Zilog             ROBOTRON    Zilog
 +
 +M1:  LD M,A   M1:  LD (HL),A         OUT 80H     OUT (80H),A
 +     JR M1-#       JR M1             IN  3CH     IN A,(3CH)
 +     JMP M1        JP M1             CMP 0       CP 0
 +     JRC M1-#      JR C,M1           ADD B       ADD A,B
 +     JPZ M1        JP Z,M1           JMP M       JP (HL)
 +     CANZ M1       CALL NZ,M1        RNC         RET NC
 +     DJNZ M1-#     DJNZ M1
 +</code>
 +
 +=== Steueranweisungen für den Assembler ===
 +
 +| ORG adresse        | Anfangsadresse ; muss im MC-Bereich liegen | 
 +| konstante:EQU wert | Wertzuweisung zu einem Symbolnamen | 
 +| BER anzahl         | Bereich freihalten (wird nicht gelöscht) | 
 +| DB byte            | Byte definieren | 
 +| DB 'text'          | Text definieren. Max. 35 Zeichen. | 
 +| DA adr             | Adresse (Doppelbyte) definieren | 
 +| END                | Ende des Quelltextes ; danach dürfen keine Befehle mehr stehen, sonst Absturz möglich | 
 +
 +Zahlenwerte können dezimal (ohne Kennzeichnung) oder hexadezimal (mit nachgestelltem 'H') angegeben werden.
 +Zahlen  müssen mit einer Ziffer beginnen, d.h. Hexadezimalzahlen größer 9FH benötigen eine Vornull (z.B.: 0CBH).
 +Die  Verwendung von ASCII-Zeichen ist möglich, wenn diese in Hochkommas eingeschlossen werden.
 +
 +Bsp.:   LD A,75     LD A,4BH     LD A,'K'     sind  identisch.
 +
 +==== Fehlermeldungen ====
 +
 +Folgende Fehlerausschriften können auftreten:
 +
 +| OVERFLOW | Überlauf der Symbol- oder Crossreferenztabelle, oder Textpuffer enthält kein vollständiges Programm (PN ... END) |
 +| NO PN: | Programm beginnt nicht mit der PN-Anweisung. Durch Eingabe eines "C" wird PN weiter im Quellcode gesucht. |
 +| +A+ | Adressierungsfehler |
 +| +C+ | Falsche Mnemonik |
 +| +F+ | Formatfehler |
 +| +M+ | mehrfach definiertes Symbol |
 +| +N+ | nicht definiertes Symbol |
 +| +O+ | Operandenfehler |
 +
 +
 +===== Hinweise =====
 +
 +Versionitis:
 +
 +**RAM-Version von Kassette R0121**\\
 +1. Block CRC = FF06, SUM = F6D4\\
 +2. Block CRC = D060, SUM = A690\\
 +3. Block CRC = 58BB, SUM = E640\\
 +4. Block CRC = 2BD6, SUM = FB4F\\
 +5. Block CRC = 2868, SUM = F82A
 +
 +**ROM-Version V. Pohlers ASM.COM**\\
 +1. Block CRC = A06F, SUM = 750A\\
 +2. Block CRC = 62E2, SUM = E05D\\
 +3. Block CRC = CCE5, SUM = 542C\\
 +4. Block CRC = 9249, SUM = 6ABC  <-- fehlerhaft, Version UZ ist korrekt\\
 +5. Block CRC = 1397, SUM = 6FF4
 +
 +**ROM-Version U. Zander edas__c0.851**\\
 +1. Block CRC = A06F, SUM = 750A\\
 +2. Block CRC = 62E2, SUM = E05D\\
 +3. Block CRC = CCE5, SUM = 542C\\
 +4. Block CRC = B883, SUM = 718E\\
 +5. Block CRC = 1397, SUM = 6FF4
 +
 +**ROM-Version Torsten Paul asm_tpaul.rom**\\
 +1. Block CRC = 1253, SUM = 6CD3\\
 +2. Block CRC = D3D1, SUM = EBE3\\
 +3. Block CRC = 9467, SUM = 51DC\\
 +4. Block CRC = 3F16, SUM = 8D99\\
 +5. Block CRC = 64BF, SUM = 8434
 +
 +**ASM-Modul von AS**\\
 +1. Block CRC = 1253\\
 +2. Block CRC = 0E96\\
 +3. Block CRC = 9467\\
 +4. Block CRC = 9D54\\
 +5. Block CRC = C6FD
 +
 +===== Tipps =====
 +
 +
 +  * Beim Assembler ASM auf Adresse 18C2H: CD 4E 17 ändern in 3 x NOP (00). Dann wird beim Speichern aus dem Editor nicht mehr mit gelistet, das Speichern geht wesentlich flotter.
 +  * Quelltexte bekommen die Endung TXT
 +
 +===== Beispiel =====
 +
 +<code>
 +robotron  Z 9001 Einschaltmeldung
 +
 +OS
 +>ASM EDAS laden, nach dem Laden stehen die 
 + Kommandos "EDIT" und "ASM" im Speicher
 +
 +>EDIT Den Editor starten
 +EDIT:N Neustart
 ++#R"V24A3Q" Datei V24A3Q.TXT laden
 ++#T, Quellcode auflisten
 ++#E Editor beenden
 +
 +OS
 +>ASM Assembler starten
 +ASM--HC:N Neustart
 +HL:
 +MO: T Ausgabe auf Tape (bzw. USB)
 +LO: C Listing auf Bildschirm (Console)
 +PASS: 1 1. Pass muss sein
 +PASS: M Ausgabe des Maschinencodes
 + Datei V24A3.COM wird erzeugt
 +NAME :"V24A3" Name in Gänsefüßchen
 +ADDRESS: Enter, Startadresse = Anfangsadresse
 +VERIFY ((Y)/N)? N
 +ASM--HC:
 +PASS: E Assembler beenden
 +
 +OS
 +>
 +</code>
 +
 +
  
  • z9001/software/edas.txt
  • Zuletzt geändert: 2020/04/30 07:50
  • von volkerp