Einführung in Gerd's AVR Assembler

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

Aufruf des Assemblers auf der Kommandozeile

• Die Datei "gavrasm" muss das Attribut "Ausführbar" gesetzt haben, damit sie gestartet werden kann!
• gavrasm wird nur noch in der i386-64 Version kompiliert zur Verfügung gestellt. Wer andere Versionen benötigt, kann diese mit dem Free-Pascal- Compiler aus den Quelldateien kompilieren!

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
  • 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
  geordnet ausgegeben. 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 dezimalem und hexadezimalem Format.
• 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 manche 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!

Aufruf des Assemblers mit einer Batch oder in einer Shell

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

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

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.

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
.IF aTyp == 2313
; Int-Vektoren für 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
.IF aTyp == 2323
; Int-Vektoren für 2323
	rjmp IntVecTC0Ovf ; TC0-Overflow, verwendet
.ENDIF
.IF aTyp == 8515
; Int-Vektoren für 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)

Verwendung von EXIT

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

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

Verwendung von besonderen literalen Konstanten

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

Trennzeichen in Binär- und Hex-Konstanten

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