Pfad: Home => AVR-Assembler gavrasm => Einführung    (This page in English: )

Einführung in Gerd's AVR Assembler

1. 1 Aufruf des Assemblers auf der Kommandozeile
2. 2 Aufruf des Assemblers mit einer Batch oder in einer Shell
   • 2.1 Batch unter Windows
     • 2.1.1 Mit Fehlerauswertung
   • 2.2 Shell unter Linux
     • 2.2.1 Shell mit Fehlerauswertung
3. 3 Hilfsprogramm zum Aufruf unter Windows
4. 4 Verwendung von IF-ELSE-ENDIF
5. 5 Verwendung von EXIT
6. 6 Verwendung von Makros
7. 7 Verwendung von besonderen literalen Konstanten
8. 8 Verwendung von Trennzeichen in Konstanten

1 Aufruf des Assemblers auf der Kommandozeile

1. Man öffnet eine Kommandozeile (Win: meistens unter Start/Programme/Zubehör/Eingabeaufforderung) oder Shell (Linux-KDE) und wechselt mit cd [Pfad] in das Verzeichnis mit dem Quelltext.
2. Das Assemblieren wird mit [gavrasm-pfad]gavrasm -optionen quelltext[.asm] gestartet.

• Die Option -a ist nur unter Linux sinnvoll zu verwenden. Sie schaltet die Ausgabe der einzelnen Zeilennummern während des Kompiliervorganges aus.
• Die Option -b ist sinnvoll, um bei Fehlermeldungen eine ausführlichere Kommentierung der Parameter einer Instruktion zusätzlich zu erhalten. Sie funktioniert nur, wenn gleichzeitig die Option -e gewählt wird (z.B. -eb).
• Die Option -l schaltet die Erzeugung der List-Datei generell aus. Nur für Puristen sinnvoll, die unbedingt knappen Plattenplatz sparen wollen.
• Die Option -q sperrt generell die Ausgabe von Meldungen auf der Kommandozeile. Die einzigen Nachrichten sind INCLUDEs, die Pass-Information und der Erfolg/Misserfolg des Kompiliervorganges (Anzahl Fehler).
• Die Option -s schaltet die Ausgabe der verwendeten Symbole in der List-Datei an, sofern die Listausgabe nicht mit der Direktive .NOLIST im Quellcode ausgeschaltet ist. Alle Symbole werden am Ende der Datei sortiert nach ihrem Typ aufgelistet.
  • R: Register,
  • L: Label oder Marke,
  • C: EQU-Konstante,
  • V: SET-Variable,
  • M: Lokales Makro-Symbol (Label/Marke in einem Makro),
  • G: Globalisiertes Makro-Symbol
  Dabei erhält man als zusätzliche Information, wie oft das Symbol definiert wurde (nDef, sinnvoll bei Variablen), verwendet wird (nUsed) und den letzten Wert des Symbols in dezimaler und hexadezimaler Form.
• Die Option -w erlaubt das Wrap-Around, also Sprünge vorwärts über das Ende des Flash-Programmspeichers hinaus (an den Anfang des Adressraums) bzw. rückwärts vor den Beginn des Speichers (an das Ende des Adressraums). Die Option ist nur sinnvoll, wenn der AVR einen über 4k großen Flash verfügt und damit einen sehr langen Adressraum hat, der mit relativen Sprüngen nicht mehr direkt überbrückt werden kann. Das Wrap-Around funktioniert in gavrasm auch mit den relativen Branch-Instruktionen (z.B. BRCC oder BREQ). Weil das andere Assembler aber nicht beherrschen, sind solche Quelltexte nicht mit anderen Assemblern kompilierbar!
• Die Optionen -?, -h, -d und -t veranlassen gavrasm ausschließlich zur Ausgabe der gewünschten Informationen (-? und -h: zulässige Optionen, -d: implementierte Direktiven, -t: zulässige AVR-Typen und deren Eigenschaften). Eine gleichzeitig angegebene Quelldatei wird dabei ignoriert und nicht assembliert!

2 Aufruf des Assemblers mit einer Batch oder in einer Shell

2.1 Windows-Batch

REM Batch-Aufrufdatei
[Laufwerk]:
CD [Pfad-zur-Sourcedatei]
[gavrasm-pfad\]gavrasm [-optionen] quelldatei[.asm]
PAUSE

2.1.1 Windows-Batch mit Errorlevel-Auswertung

REM
REM Testet Rueckgabewert vom Assembler
REM
[Laufwerk]
CD [Pfad zur Sourcedatei]
[gavrasm-pfad\]gavrasm -optionen Quelldatei[.asm]
If errorlevel 1 Goto Fehler
REM Kein Fehler, weitere Instruktionen hierhin
goto ende
:Fehler
REM Fehler aufgetreten, weitere Instruktionen hierhin
echo Fehlerbehandlung!
notepad.exe Quelldatei.err
:ende
pause

2.2 Linux-Shell

#!/bin/bash
cd [Pfad-zur-Sourcedatei]
[Pfad-zu-gavrasm/]gavrasm [-optionen] Quelldatei[.asm]
read key

2.2.1 Linux-Shell mit Fehlerauswertung

#!/bin/bash
# Diese Batch ruft gavrasm auf und verzweigt
cd [Pfad-zur-Sourcedatei]
[Pfad-zu-gavrasm/]gavrasm [-optionen] Quelldatei[.asm]
if [ "$?" = "0" ]; then
  # Dieser Zweig wird ausgeführt wenn kein Fehler auftritt
  echo "Shell: Kein Fehler beim Assemblieren"
else
  # Dieser Zweig wird ausgeführt wenn ein Fehler auftritt
  echo "Shell: Fehler beim Assemblieren"
  # Aufruf des Editors mit der Fehlerdatei von gavrasm
  kwrite "fehler.err"
fi

3 Window Caller - Werkzeug für den Aufruf unter Windows

• Die Source- und Include-Dateien lassen sich auch editieren, dabei werden Zeile und Spalte angezeigt (anders als bei den anderen simplen Windows-Editoren).
• Der Editor arbeitet auch mit Tab-Zeichen.
• Mit Include eingebundene Dateien werden automatisch erkannt und können editiert werden. Das funktioniert auch rekursiv mit bis zu maximal fünf Include-Dateien.
• Wird nach dem Assemblieren die List-Datei angezeigt, können Fehler im Quelltext komfortabel gesucht werden. Auf Wunsch werden die Dateien, in denen der Fehler auftrat, in den Editor geladen und direkt die fehlerhafte Stelle angesteuert.
• Es können jetzt beliebig viele Dateien gleichzeitig angeschaut und editiert werden.

4 Verwendung von IF-ELSE-ENDIF

.EQU taktfrequenz=40000000
.IF taktfrequenz>4000000
.EQU teiler=4
.ELSE
.EQU teiler=2
.ENDIF

;
; Definiere Prozessor im Kopf
;
.EQU aTyp=2313 ; Prozessor ist ein 2313
;
.EQU aTyp=2323 ; Prozessor wäre ein 2323
;
.EQU aTyp=8515 ; Prozessor wäre ein 8515
;
; Abschnitt mit den Int-Vektoren
;
.CSEG
.ORG $0000
	rjmp Main ; für alle Typen gleich
	rjmp IntVecInt0 ; External Int Vector, wird verwendet
; Int-Vektoren für 2313
.IF aTyp == 2313
	reti ; IntVecInt1 ; External Int Vector, nicht verwendet
	reti ; Timer1Capt, nicht verwendet
	reti ; Timer1/Comp, nicht benutzt
	reti ; Timer1/Ovf, nicht benutzt
	rjmp IntVecTC0Ovf ; TC0-Overflow, verwendet
	reti ; UartRX, nicht benutzt
	reti ; UartUdre, nicht benutzt
	reti ; UartTx, nicht verwendet
.ENDIF
; Int-Vektoren für 2323
.IF aTyp == 2323
	rjmp IntVecTC0Ovf ; TC0-Overflow, verwendet
.ENDIF
; Int-Vektoren für 8515
.IF aTyp == 8515
	reti ; IntVecInt1 ; External Int Vector, nicht verwendet
	reti ; Timer1Capt, nicht verwendet
	reti ; Timer1/CompA, nicht benutzt
	reti ; Timer1/CompB, nicht benutzt
	reti ; Timer1/Ovf, nicht benutzt
	rjmp IntVecTC0Ovf ; TC0-Overflow, verwendet
	reti ; SpiStc, nicht verwendet
	reti ; UartRX, nicht benutzt
	reti ; UartUdre, nicht benutzt
	reti ; UartTx, nicht verwendet
	reti ; AnaComp, nicht verwendet
.ENDIF
;
; Interrupt-Service-Routine INT0
;
IntVecInt0:
	[...]
	reti
;
; Interrupt-Service-Routine TC0-Overflow
;
IntVecTC0Ovf:
	[...]
	reti
;
; Hauptprogramm
;
Main:
	[...]

.IF (aTyp == 2313) || (aTyp == 8515)

5 Verwendung von EXIT

.EQU taktfrequenz=4000000
.EQU teiler=64
.EXIT (taktfrequenz/teiler)>65535

6 Verwendung von Makros

.MACRO mtest
  nop
.ENDM
;
; Hier wird das Makro eingefügt
;
	mtest

;
; Register global definieren
;
.DEF rmp,R16
.MACRO mtest
	ldi @0,@1 ; Erwartet Register als ersten Param, Konstante als zweiten
	clr @0
.ENDM
;
; Makro einfügen
;
	mtest rmp,50

7 Verwendung von besonderen literalen Konstanten

.DB "Dies ist die erste Zeile.\m\jDies ist die zweite Zeile."

8 Trennzeichen in Binär- und Hex-Konstanten

.EQU abc = 0b0001.0010
.EQU def = 0x0FFF.FFFF