as_de.tex

万能汇编工具

%%---------------------------------------------------------------------------

\section{Format der Eingabedateien}
\label{AttrTypes}

Wie die meisten Assembler auch erwartet AS genau einen Befehl pro Zeile
(Leerzeilen sind nat"urlich auch zugelassen).  Die Zeilen d"urfen nicht
l"anger als 255 Zeichen werden, dar"uber hinaus gehende Zeichen werden
abgeschnitten.
\par
Eine einzelne Zeile hat folgendes Format:
\begin{verbatim}
[Label[:]]<Befehl>[.Attribut] [Parameter[,Parameter..]] [;Kommentar]
\end{verbatim}
Eine Zeile darf dabei auch "uber mehrere Zeilen in der Quelldatei
verteilt sein, Folgezeichen (\verb!\!) verketten diese Teile dann zu
einer einzigen Zeile.  Zu beachten ist allerdings, da"s aufgrund der 
internen Pufferstruktur die Gesamtzeile nicht 256 Zeichen "uberschreiten
darf.  Zeilenangaben in Fehlermeldungen beziehen sich immer auf die
letzte Zeile einer solchen zusammengesetzten Zeile.
\par
Der Doppelpunkt nach dem Label ist optional, falls das Label in der
ersten Spalte beginnt (woraus folgt, da"s der Befehl niemals in Spalte
1 beginnen darf).  Man mu"s ihn aber setzen, falls das Label nicht
in der ersten Spalte beginnt, damit AS es von einem Befehl unterscheiden
kann.  In letzterem Fall mu"s "ubrigens zwischen Doppelpunkt und dem
Befehl mindestens ein Leerzeichen stehen, falls der eingestellte
Zielprozessor zu denjenigen geh"ort, bei denen das Attribut auch
eine mit einem Doppelpunkt abgetrennte Formatangabe sein darf.  Dieser
Knopf ist aus Eindeutigkeitsgr"unden n"otig, da sonst keine
Unterscheidung zwischen Befehl mit Format und Label mit Befehl m"oglich
w"are.
\par
Einige Signalprozessorreihen von Texas Instruments verwenden den f"ur das
Label vorgesehenen Platz wahlweise auch f"ur einen Doppelstrich
(\verb!||!), der die parallele Ausf"uhrung mit der vorangehenden
Instruktion anzeigt.  Wenn diese beiden Instruktionen auf Maschinenebene
in einem einzigen Wort vereinigt werden (C3x), macht ein zus"atzliches
Label vor der zweiten Anweisung nat"urlich keinen Sinn und ist auch nicht
vorgesehen.  Anders sieht es beim C6x mit seinen Instruktionspaketen
variabler L"ange aus: Wer dort (unsch"onerweise...) mitten in ein Paket
hineinspringen will, mu"s das Label daf"ur in eine Extrazeile davor setzen
(das gleiche gilt "ubrigens auch f"ur Bedingungen, die aber zusammen mit
dem Doppelstrich in einer Zeile stehen d"urfen).
\par
Das Attribut wird von einer Reihe von Prozessoren benutzt, um
Spezialisierungen oder Kodierungsvarianten eines bestimmten Befehls zu
spezifizieren.  Die bekannteste Nutzung des Attributs ist die Angabe der
Operandengr"o"se, wie z. B. bei der 680x0-Familie (Tabelle
\ref{TabAttrs}).
\begin{table*}[htb]
\begin{center}\begin{tabular}{|l|l|l|}
\hline
Attribut & arithmetisch-logischer Befehl & Sprungbefehl \\
\hline
\hline
B     & Byte (8 Bit)                   & --------- \\
W     & Wort (16 Bit)                  & --------- \\
L     & Langwort (32 Bit)              & 16-Bit-Displacement \\
Q     & Vierfachwort (64 Bit)          & --------- \\
S     & Single Precision (32 Bit)      & 8-Bit-Displacement \\
D     & Double Precision (64 Bit)      & --------- \\
X     & Extended Precision (80/96 Bit) & 32-Bit-Displacement \\
P     & Dezimalgleitkomma (80/96 Bit)  & --------- \\
\hline
\end{tabular}\end{center}
\caption{Erlaubte Attribute (Beispiel 680x0) \label{TabAttrs}}
\end{table*}
\par
Da sich diese Anleitung nicht gleichzeitig als Handbuch f"ur die von AS
unterst"utzten Prozessorfamilien versteht, ist dies leider auch nicht der
richtige Platz, um hier alle m"oglichen Attribute f"ur alle unterst"utzten
Familien aufzuz"ahlen.  Es sei aber angemerkt, da"s i.a. nicht alle Befehle
alle Attribute zulassen, andererseits das Fortlassen eines Attributs meist
zur Verwendung der f"ur diese Familie ,,nat"urlichen'' Operandengr"o"se
f"uhrt.  Zum genaueren Studium greife man auf ein Programmierhandbuch f"ur
die jeweilige Familie zur"uck, z.B. in \cite{Williams} f"ur die 68000er.
\par
Bei TLCS-9000, H8/500 und M16(C) dient das Attribut sowohl der Angabe der
Operandengr"o"se, falls diese nicht durch die Operanden klar sein sollte,
als auch der des zu verwendenden Befehlsformates.
Dieses mu"s durch einen Doppelpunkt von der Operandengr"o"se getrennt werden,
z.B. so:
\begin{verbatim}
    add.w:g   rw10,rw8
\end{verbatim}
Was dieses Beispiel nicht zeigt, ist, da"s die Formatangabe auch ohne
Operandengr"o"se geschrieben werden darf.  Steht demgegen"uber eine
Operandengr"o"se ohne Formatangabe, verwendet AS automatisch das
k"urzeste Format.  Die erlaubten Befehlsformate und Operandengr"o"sen
sind vom Maschinenbefehl abh"angig und k"onnen z.B. \cite{Tosh9000},
\cite{HitH8_5}, \cite{MitM16} bzw. \cite{MitM16C} entnommen werden.
\par
Die Zahl der Befehlsparameter ist abh"angig vom Befehl und kann
prinzipiell zwischen 0 und 20 liegen.  Die Trennung der Parameter
voneinander erfolgt ausschlie"slich durch Kommas (Ausnahme: DSP56xxx,
dessen parallele Datentransfers durch Leerzeichen getrennt werden),
wobei in Klammern oder Hochkommas eingeschlossene Kommas nat"urlich
nicht beachtet werden.
\par
Anstelle eines Kommentars am Ende kann die Zeile auch nur aus einem
Kommentar bestehen, wenn er in der ersten Spalte beginnt.
\par
Bei den Leerzeichen zur Trennung einzelnen Komponenten darf es sich
genauso gut um Tabulatoren handeln.

%%---------------------------------------------------------------------------

\section{Format des Listings}

Das von AS bei Angabe der Kommandozeilenoptionen \tty{l} oder \tty{L}
erzeugte Listing l"a"st sich grob in folgende Teile gliedern:
\begin{enumerate}
\item{Wiedergabe des assemblierten Quellcodes;}
\item{Symbolliste;}
\item{Makroliste;}
\item{Funktionsliste;}
\item{Belegungsliste;}
\item{Querverweisliste.}
\end{enumerate}
Letztere beide werden nur erzeugt, wenn sie durch zus"atzliche
Kommandozeilenoptionen angefordert wurden.
\par
Im ersten Teil listet AS den kompletten Inhalt aller Quelldateien inklusive
des erzeugten Codes auf.  Eine Zeile in diesem Listing hat dabei folgende Form:
\begin{verbatim}
[<n>] <Zeile>/<Adresse> <Code> <Quelle>
\end{verbatim}
Im Feld $n$ zeigt AS die Include-Verschachtelungstiefe an.  Die
Hauptdatei (die Datei, mit der die Assemblierung begann), hat dabei die
Tiefe 0, von dort aus eingebundene Dateien haben Tiefe 1 usw.  Die Tiefe
0 wird dabei nicht angezeigt.
\par
Im Feld \tty{Zeile} wird die Zeilennummer bezogen auf die jeweilige Datei
ausgegeben.  Die erste Zeile einer Datei hat dabei Nummer 1.  Die Adresse,
an der der f"ur diese Zeile erzeugte Code abgelegt wurde, folgt hinter dem
Schr"agstrich im Feld \tty{Adresse}.
\par
Der erzeugte Code selber steht dahinter im Feld \tty{Code} in
hexadezimaler Schreibweise.  Je nach Prozessortyp und aktuellem Segment
k"onnen die Werte entweder als Bytes oder 16/32-Bit-Worte formatiert sein.
Sollte mehr Code erzeugt worden sein, als in das Feld hineinpa"st, so
werden im Anschlu"s an die Zeile weitere Zeilen erzeugt, in denen nur
dieses Feld belegt ist.
\par
Im Feld \tty{Quelle} schlu"sendlich wird die Zeile aus der Quelldatei in
ihrer Originalform ausgegeben.
\par
Die Symboltabelle ist so ausgelegt, da"s sie nach M"oglichkeit immer in 80
Spalten dargestellt werden kann.  F"ur Symbole ,,normaler L"ange'' wird
eine zweispaltige Ausgabe gew"ahlt.  Sollten einzelne Symbole mit ihrem
Wert die Grenze von 40 Spalten "uberschreiten, werden sie in einer
einzelnen Zeile ausgegeben.  Die Ausgabe erfolgt in alphabetischer
Reihenfolge.  Symbole, die zwar definiert, aber nie benutzt wurden,
werden mit einem vorangestellten Stern (\verb!*!) gekennzeichnet.
\par
Die bisher genannten Teile sowie die Auflistung aller definierten
Makros / Funktionen lassen sich selektiv aus dem Gesamtlisting ein-und
ausblenden, und zwar mit dem bereits erw"ahnten \tty{t}-Kommandozeilenschalter.
Intern existiert in AS ein Byte, dessen Bits repr"asentieren, welche Teile
ausgegeben werden sollen.  Die Zuordnung von Bits zu den Teilen ist in
Tabelle \ref{TabTBits} aufgelistet.
\par
\begin{table*}[p]
\begin{center}\begin{tabular}{|l|l|}
\hline
Bit & Teil \\
\hline
\hline
0   & Quelldatei(en)+erzeugter Code \\
1   & Symboltabelle \\
2   & Makroliste \\
3   & Funktionsliste \\
4   & Zeilennumerierung \\
5   & Registersymboltabelle \\
7   & Zeichentabellenliste \\
\hline
\end{tabular}\end{center}
\caption{Zuordnung der Bits zu den Listingkomponenten\label{TabTBits}}
\end{table*}
Defaultm"a"sig sind alle Bits auf 1 gesetzt, bei Verwendung des Schalters
\begin{verbatim}
-t <Maske>
\end{verbatim}
werden die in \verb!<Maske>! gesetzten Bits gel"oscht, so da"s die entsprechenden
Listing-Teile unterdr"uckt werden.  Analog lassen sich mit einem Pluszeichen
einzelne Teile wieder einschalten, falls man es in der \tty{ASCMD}-Variablen
"ubertrieben hat...will man z.B. nur die Symboltabelle haben, so reicht
\begin{verbatim}
-t 2  .
\end{verbatim}
In der Belegungsliste werden f"ur jedes Segment einzeln die belegten Bereiche
hexadezimal ausgegeben.  Handelt es sich bei einem Bereich um eine einzige
Adresse, wird nur diese ausgegeben, ansonsten erste und letzte Adresse.
\par
In der Querverweisliste wird f"ur jedes definierte Symbol in alphabetischer
Reihenfolge eine Ausgabe folgender Form erzeugt:
\begin{verbatim}
Symbol <Symbolname> (=<Wert>,<Datei>/<Zeile>):
 Datei <Datei 1>:
 <n1>[(m1)]  ..... <nk>[(mk)]
 .
 .
 Datei <Datei l>:
 <n1>[(m1)]  ..... <nk>[(mk)]
\end{verbatim}
F"ur jedes Symbol wird aufgelistet, in welchen Dateien es in welchen Zeilen
angesprochen wurde.  Sollte ein Symbol mehrmals in der gleichen Zeile
benutzt worden sein, so wird dies durch eine in Klammern gesetzte Anzahl
hinter der Zeilennummer angedeutet.  Sollte ein Symbol niemals benutzt
worden sein, erscheint es auch nicht in der Liste; entsprechend erscheint
eine Datei auch "uberhaupt nicht in der Liste eines Symbols, falls es in
der entsprechenden Datei nicht referenziert wurde.
\par
\bb{ACHTUNG!} AS kann dieses Listing nur dann korrekt aufs Papier bringen,
wenn man ihm vorher die L"ange und Breite des Ausgabemediums mit Hilfe des
\tty{PAGE}-Befehls (siehe dort) mitgeteilt hat!  Der voreingestellte
Default sind 60 Zeilen und eine unbegrenzte Zeilenbreite.

%%---------------------------------------------------------------------------

\section{Symbolkonventionen}
\label{SectSymConv}

Symbole d"urfen zwar (wie in der Einleitung bereits angedeutet) bis zu
255 Zeichen lang werden und werden auch auf der ganzen L"ange
unterschieden, die Symbolnamen m"ussen aber einigen Konventionen
gen"ugen:
\par
Symbolnamen d"urfen aus einer beliebigen Kombination von Buchstaben,
Ziffern, Unterstrichen und Punkten bestehen, wobei das erste Zeichen
keine Ziffer sein darf.  Der Punkt wurde nur zugelassen, um der
MCS-51-Notation von Registerbits zu gen"ugen, und sollte m"oglichst nicht in
eigenen Symbolnamen verwendet werden.  Zur Segmentierung von Symbolnamen
sollte auf jeden Fall der Unterstrich und nicht der Punkt verwendet werden.
\par
Defaultm"a"sig ist AS nicht case-sensitiv, es ist also egal, ob man
Gro"s-oder Kleinbuchstaben verwendet.  Mittels des Kommandozeilenschalters
\tty{U} l"a"st sich AS jedoch in einen Modus umschalten, in dem Gro"s- und
Kleinschreibung unterschieden wird. Ob AS umgeschaltet wurde, kann mit dem
vordefinierten Symbol \tty{CASESENSITIVE} ermittelt werden: TRUE bedeutet
Unterscheidung, FALSE keine.
\par
Tabelle \ref{TabPredefined} zeigt die wichtigsten, von AS vordefinierten
Symbole.
\begin{table*}[p]
\begin{center}\begin{tabular}{|l|l|}
\hline
Name             & Bedeutung \\
\hline
\hline
\tty{TRUE}             & logisch ,,wahr'' \\
\tty{FALSE}            & logisch ,,falsch'' \\
\tty{CONSTPI}          & Kreiszahl Pi (3.1415.....) \\
\tty{VERSION}          & Version von AS in BCD-Kodierung, \\
                       & z.B. 1331 hex f"ur Version 1.33p1 \\
\tty{ARCHITECTURE}     & Zielplattform, f"ur die AS "ubersetzt wurde, \\
                       & in der Form Prozesor-Hersteller-Betriebssystem \\
\tty{DATE}             & Datum und \\
\tty{TIME}             & Zeitpunkt der Assemblierung (Beginn) \\
\tty{MOMCPU}           & momentan gesetzte Ziel-CPU \\
\tty{MOMCPUNAME}       & dito, nur als voll ausgeschriebener String \\
\tty{MOMFILE}          & augenblickliche Quelldatei \\
\tty{MOMLINE}          & Zeilennummer in Quelldatei \\
\tty{MOMPASS}          & Nummer das laufenden Durchgangs \\
\tty{MOMSECTION}       & Name der aktuellen Sektion oder \\
                       & Leerstring \\
\tty{MOMSEGMENT}       & Name des mit \tty{SEGMENT} gew"ahlten \\
                       & Adre"sraumes \\
\verb!*!, \$ bzw. \tty{PC} & mom. Programmz"ahler \\
\hline
\end{tabular}\end{center}
\caption{Vordefinierte Symbole\label{TabPredefined}}
\end{table*}
\bb{VORSICHT!}  W"ahrend es im case-insensitiven Modus egal ist,
mit welcher Kombination von Gro"s- und Kleinbuchstaben man 
vordefinierte Symbole anspricht, mu"s man sich im case-sensitiven
Modus exakt an die oben angegebene Schreibweise (nur Gro"sbuchstaben)
halten!
\par
Zus"atzlich definiere