Voraussetzungen

Vorausgesetzt werden Grundkenntnisse der Programmiersprache C. Diese Kenntnisse kann man sich online erarbeiten, z. B. mit dem C Tutorial von Helmut Schellong (Liste von C-Tutorials). Nicht erforderlich sind Vorkenntnisse in der Programmierung von Mikrocontrollern, weder in Assembler noch in einer anderen Sprache.

Vorwort

Dieses Tutorial soll den Einstieg in die Programmierung von Atmel AVR-Mikrocontrollern in der Programmiersprache C mit dem freien C-Compiler AVR-GCC aus der GNU Compiler Collection erleichtern.

In diesem Text wird häufig auf die Standardbibliothek avr-libc verwiesen, für die es eine Online-Dokumentation gibt, in der sich auch viele nützliche Informationen zum Compiler und zur Programmierung von AVR Controllern finden (beim Paket WinAVR gehört die avr-libc Dokumentation zum Lieferumfang und wird mitinstalliert).

Der Compiler und die Standardbibliothek avr-libc werden stetig weiterentwickelt. Einige Unterschiede, die sich im Verlauf der Entwicklung ergeben haben, werden im Haupttext und Anhang zwar erläutert, Anfängern sei jedoch empfohlen, die aktuellen Versionen zu nutzen (für MS-Windows: aktuelle Version des WinAVR-Pakets; für Linux: siehe Artikel AVR und Linux).

Das ursprüngliche Tutorial stammt von Christian Schifferle, viele neue Abschnitte und aktuelle Anpassungen von Martin Thomas.

Dieses Tutorial ist in PDF-Form hier erhältlich (nicht immer auf aktuellem Stand): Media:AVR-GCC-Tutorial.pdf

Weiterführende Kapitel

Um dieses riesige Tutorial etwas überschaubarer zu gestalten, wurden einige Kapitel ausgelagert, die nicht unmittelbar mit den Grundlagen von avr-gcc in Verbindung stehen. All diese Seiten gehören zur Kategorie:avr-gcc Tutorial.

→ Der UART

→ Der Watchdog

→ Die Timer und Zähler des AVR

→ Exkurs Makefiles

→ LCD-Ansteuerung

→ Alte Quellen anpassen

→ Assembler und Inline-Assembler

Benötigte Werkzeuge

Um eigene Programme für AVRs mittels avr-gcc/avr-libc zu erstellen und zu testen, wird folgende Hard- und Software benötigt:

Platine oder Versuchsaufbau für die Aufnahme eines AVR Controllers, der vom avr-gcc Compiler unterstützt wird (alle ATmegas und die meisten AT90, siehe Dokumentation der avr-libc für unterstützte Typen). Dieses Testboard kann durchaus auch selbst gelötet oder auf einem Steckbrett aufgebaut werden. Einige Registerbeschreibungen dieses Tutorials beziehen sich auf den inzwischen veralteten AT90S2313. Der weitaus größte Teil des Textes ist aber für alle Controller der AVR-Familie gültig. Brauchbare Testplattformen sind auch das STK500 und der AVR Butterfly von Atmel. Weitere Infos findet man in den Artikeln AVR Starterkits und AVR-Tutorial: Equipment.

Der avr-gcc Compiler und die avr-libc. Kostenlos erhältlich für nahezu alle Plattformen und Betriebssysteme. Für MS-Windows im Paket WinAVR; für Unix/Linux siehe auch Hinweise im Artikel AVR-GCC und im Artikel AVR und Linux.

Programmiersoftware und -hardware z. B. PonyProg (siehe auch: Pony-Prog Tutorial) oder AVRDUDE mit STK200-Dongle oder die von Atmel verfügbare Hard- und Software (STK500, Atmel AVRISP, AVR-Studio).

Nicht unbedingt erforderlich, aber zur Simulation und zum Debuggen unter MS-Windows recht nützlich: AVR-Studio (siehe Artikel Exkurs: Makefiles).

Wer unter Windows und Linux gleichermassen entwickeln will, der sollte sich die IDE Eclipse for C/C++ Developers und das AVR-Eclipse Plugin ansehen, beide sind unter Windows und Linux einfach zu installieren. Hier gibt es auch einen Artikel AVR Eclipse in dieser Wiki. Ebenfalls unter Linux und Windows verfügbar ist die Entwicklungsumgebung Code::Blocks (aktuelle, stabile Versionen sind als Nightly Builds regelmäßig im Forum verfügbar). Innerhalb dieser Entwicklungsumgebung können ohne die Installation zusätzlicher Plugins "AVR-Projekte" angelegt werden. Für Linux gibt es auch noch das KontrollerLab.

Was tun, wenn's nicht klappt?

Herausfinden, ob es tatsächlich ein avr(-gcc) spezifisches Problem ist oder nur die eigenen C-Kenntnisse einer Auffrischung bedürfen. Allgemeine C-Fragen kann man eventuell "beim freundlichen Programmierer zwei Büro-, Zimmer- oder Haustüren weiter" loswerden. Ansonsten: C-Buch (gibt's auch "gratis" online) lesen.

Die AVR Checkliste durcharbeiten.

Die Dokumentation der avr-libc lesen, vor allem (aber nicht nur) den Abschnitt Related Pages/Frequently Asked Questions = Oft gestellte Fragen (und Antworten dazu). Z.Zt leider nur in englischer Sprache verfügbar.

Den Artikel AVR-GCC in diesem Wiki lesen.

Das GCC-Forum auf www.mikrocontroller.net nach vergleichbaren Problemen absuchen.

Das avr-gcc-Forum bei AVRfreaks nach vergleichbaren Problemen absuchen.

Das Archiv der avr-gcc Mailing-Liste nach vergleichbaren Problemen absuchen.

Nach Beispielcode suchen. Vor allem im Projects-Bereich von AVRfreaks (anmelden).

Google oder yahoo befragen schadet nie.

Bei Problemen mit der Ansteuerung interner AVR-Funktionen mit C-Code: das Datenblatt des Controllers lesen (ganz und am Besten zweimal). Datenblätter sind auf den Atmel Webseiten als pdf-Dateien verfügbar. Das komplette Datenblatt (complete) und nicht die Kurzfassung (summary) verwenden.

Die Beispielprogramme im AVR-Tutorial sind zwar in AVR-Assembler verfasst, Erläuterungen und Vorgehensweisen sind aber auch auf C-Programme übertragbar.

Einen Beitrag in eines der Foren oder eine Mail an die Mailing-Liste schreiben. Dabei möglichst viel Information geben: Controller, Compilerversion, genutzte Bibliotheken, Ausschnitte aus dem Quellcode oder besser ein Testprojekt mit allen notwendigen Dateien, um das Problem nachzuvollziehen, sowie genaue Fehlermeldungen bzw. Beschreibung des Fehlverhaltens. Bei Ansteuerung externer Geräte die Beschaltung beschreiben oder skizzieren (z. B. mit Andys ASCII Circuit). Siehe dazu auch: "Wie man Fragen richtig stellt".

Erzeugen von Maschinencode

Aus dem C-Quellcode erzeugt der avr-gcc Compiler (zusammen mit Hilfsprogrammen wie z. B. Präprozessor, Assembler und Linker) Maschinencode für den AVR-Controller. Üblicherweise liegt dieser Code dann im Intel Hex-Format vor ("Hex-Datei"). Die Programmiersoftware (z. B. AVRDUDE, PonyProg oder AVRStudio/STK500-plugin) liest diese Datei ein und überträgt die enthaltene Information (den Maschinencode) in den Speicher des Controllers. Im Prinzip sind also "nur" der avr-gcc-Compiler (und wenige Hilfsprogramme) mit den "richtigen" Optionen aufzurufen, um aus C-Code eine "Hex-Datei" zu erzeugen. Grundsätzlich stehen dazu zwei verschiedene Ansätze zur Verfügung:

Die Verwendung einer integrierten Entwicklungsumgebung (IDE = Integrated Development Environment), bei der alle Einstellungen z. B. in Dialogboxen durchgeführt werden können. Unter Anderem kann AVRStudio ab Version 4.12 (kostenlos auf atmel.com) zusammen mit WinAVR als integrierte Entwicklungsumgebung für den Compiler avr-gcc genutzt werden (dazu müssen AVRStudio und WinAVR auf dem Rechner installiert sein). Weitere IDEs (ohne Anspruch auf Vollständigkeit): Eclipse for C/C++ Developers (d.h. inkl. CDT) und das AVR-Eclipse Plugin (für diverse Plattformen, u.a. Linux und MS Windows, IDE und Plugin kostenlos), KontrollerLab (Linux/KDE, kostenlos). AtmanAvr (MS Windows, relativ günstig), KamAVR (MS-Windows, kostenlos, wird augenscheinlich nicht mehr weiterentwickelt), VMLab (MS Windows, ab Version 3.12 ebenfalls kostenlos). Integrierte Entwicklungsumgebungen unterscheiden sich stark in Ihrer Bedienung und stehen auch nicht für alle Plattformen zur Verfügung, auf denen der Compiler ausführbar ist (z. B. AVRStudio nur für MS-Windows). Zur Anwendung des avr-gcc Compilers mit IDEs sei hier auf deren Dokumentation verwiesen.

Die Nutzung des Programms make mit passenden Makefiles. In den folgenden Abschnitten wird die Generierung von Maschinencode für einen AVR ("hex-Datei") aus C-Quellcode ("c-Dateien") anhand von "make" und den "Makefiles" näher erläutert. Viele der darin beschriebenen Optionen findet man auch im Konfigurationsdialog des avr-gcc-Plugins von AVRStudio (AVRStudio generiert ein makefile in einem Unterverzeichnis des Projektverzeichnisses).

Beim Wechsel vom makefile-Ansatz nach WinAVR-Vorlage zu AVRStudio ist darauf zu achten, dass AVRStudio (Stand: AVRStudio Version 4.13) bei einem neuen Projekt die Optimierungsoption (vgl. Artikel AVR-GCC-Tutorial/Exkurs: Makefiles, typisch: -Os) nicht einstellt und die mathematische Bibliothek der avr-libc (libm.a, Linker-Option -lm) nicht einbindet. (Hinweis: Bei Version 4.16 wird beides bereits gesetzt). Beides ist Standard bei Verwendung von makefiles nach WinAVR-Vorlage und sollte daher auch im Konfigurationsdialog des avr-gcc-Plugins von AVRStudio "manuell" eingestellt werden, um auch mit AVRStudio kompakten Code zu erzeugen.

Einführungsbeispiel

Zum Einstieg ein kleines Beispiel, an dem die Nutzung des Compilers und der Hilfsprogramme (der sogenannten Toolchain) demonstriert wird. Detaillierte Erläuterungen folgen in den weiteren Abschnitten dieses Tutorials.

Das Programm soll auf einem AVR Mikrocontroller einige Ausgänge ein- und andere ausschalten. Das Beispiel ist für einen ATmega16 programmiert (Datenblatt), kann aber sinngemäß für andere Controller der AVR-Familie modifiziert werden.

Ein kurzes Wort zur Hardware: Bei diesem Programm werden alle Pins von PORTB auf Ausgang gesetzt, und einige davon werden auf HIGH andere auf LOW gesetzt. Das kann je nach angeschlossener Hardware an diesen Pins kritisch sein. Am ungefährlichsten ist es, wenn nichts an den Pins angeschlossen ist und man die Funktion des Programmes durch eine Spannungsmessung mit einem Multimeter kontrolliert. Die Spannung wird dabei zwischen GND-Pin und den einzelnen Pins von PORTB gemessen.

Zunächst der Quellcode der Anwendung, der in einer Text-Datei mit dem Namen main.c abgespeichert wird.

<c> /* Alle Zeichen zwischen Schrägstrich-Stern

  und Stern-Schrägstrich sind Kommentare */

// Zeilenkommentare sind ebenfalls möglich // alle auf die beiden Schrägstriche folgenden // Zeichen einer Zeile sind Kommentar

include <avr/io.h> // (1)

int main (void) { // (2)

  DDRB  = 0xFF;             // (3)
  PORTB = 0x03;             // (4)

  while(1) {                // (5)
    /* "leere" Schleife*/   // (6)
  }                         // (7)

  /* wird nie erreicht */
  return 0;                 // (8)

} </c>

In dieser Zeile wird eine sogenannte Header-Datei eingebunden. In avr/io.h sind die Registernamen definiert, die im späteren Verlauf genutzt werden. Auch unter Windows wird ein / zur Kennzeichnung von Unterverzeichnissen in Include-Dateinamen verwendet und kein \.
Hier beginnt das eigentliche Programm. Jedes C-Programm beginnt mit den Anweisungen in der Funktion main.
Die Anschlüsse eines AVR ("Beinchen") werden zu Blöcken zusammengefasst, einen solchen Block bezeichnet man als Port. Beim ATmega16 hat jeder Port 8 Anschlüsse, bei kleineren AVRs können einem Port auch weniger als 8 Anschlüsse zugeordnet sein. Da per Definition (Datenblatt) alle gesetzten Bits in einem Datenrichtungsregister den entsprechenden Anschluss auf Ausgang schalten, werden mit DDRB=0xff alle Anschlüsse des Ports B als Ausgänge eingestellt.
stellt die Werte der Ausgänge ein. Die den ersten beiden Bits des Ports zugeordneten Anschlüsse (PB0 und PB1) werden 1, alle anderen Anschlüsse des Ports B (PB2-PB7) zu 0. Aktivierte Ausgänge (logisch 1 oder "high") liegen auf Betriebsspannung (VCC, meist 5 Volt), nicht aktivierte Ausgänge führen 0 Volt (GND, Bezugspotential). Es ist sinnvoll, sich möglichst frühzeitig eine alternative Schreibweise beizubringen, die wegen der leichteren Überprüfbarkeit und Portierbarkeit oft im weiteren Tutorial und in Forenbeiträgen benutzt wird. Die Zuordnung sieht in diesem Fall so aus, Näheres dazu im Artikel Bitmanipulation:<c>PORTB = (1<<PB1) | (1<<PB0);</c>
ist der Beginn der sogenannte Hauptschleife (main-loop). Dies ist eine Endlosschleife, welche kontinuierlich wiederkehrende Befehle enthält.
In diesem Beispiel ist die Hauptschleife leer. Der Controller durchläuft die Schleife immer wieder, ohne dass etwas passiert. Eine solche Schleife ist notwendig, da es auf dem Controller kein Betriebssystem gibt, das nach Beendigung des Programmes die Kontrolle übernehmen könnte. Ohne diese Schleife kehrt das Programm aus main zurück, alle Interrupts werden deaktiviert und eine Endlosschleife betreten.
Ende der Hauptschleife und Sprung zur passenden, öffnenden Klammer, also zu 5.
ist das Programmende. Die Zeile ist nur aus Gründen der C-Kompatibilität enthalten: <c>int main(void)</c> besagt, dass die Funktion einen int-Wert zurückgibt. Die Anweisung wird aber nicht erreicht, da das Programm die Hauptschleife nie verlässt.

Um diesen Quellcode in ein lauffähiges Programm zu übersetzen, wird hier ein Makefile genutzt. Das verwendete Makefile findet sich auf der Seite Beispiel Makefile und basiert auf der Vorlage, die in WinAVR mitgeliefert wird und wurde bereits angepasst (Controllertyp ATmega16). Man kann das Makefile bearbeiten und an andere Controller anpassen oder sich mit dem Programm MFile menügesteuert ein Makefile "zusammenklicken". Das Makefile speichert man unter dem Namen Makefile (ohne Endung) im selben Verzeichnis, in dem auch die Datei main.c mit dem Programmcode abgelegt ist. Detailliertere Erklärungen zur Funktion von Makefiles finden sich im Artikel Exkurs: Makefiles.

D:\beispiel>dir

 Verzeichnis von D:\beispiel

28.11.2006  22:53    <DIR>          .
28.11.2006  22:53    <DIR>          ..
28.11.2006  20:06               118 main.c
28.11.2006  20:03            16.810 Makefile
               2 Datei(en)         16.928 Bytes

Nun gibt man make all ein. Falls das mit WinAVR installierte Programmers Notepad genutzt wird, gibt es dazu einen Menüpunkt im Tools Menü. Sind alle Einstellungen korrekt, entsteht eine Datei main.hex, in welcher der Code für den AVR enthalten ist.

D:\beispiel>make all

-------- begin --------
avr-gcc (GCC) 3.4.6
Copyright (C) 2006 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Compiling C: main.c
avr-gcc -c -mmcu=atmega16 -I. -gdwarf-2 -DF_CPU=1000000UL -Os -funsigned-char -f
unsigned-bitfields -fpack-struct -fshort-enums -Wall -Wstrict-prototypes -Wundef
 -Wa,-adhlns=obj/main.lst  -std=gnu99 -Wundef -MD -MP -MF .dep/main.o.d main.c -
o obj/main.o

Linking: main.elf
avr-gcc -mmcu=atmega16 -I. -gdwarf-2 -DF_CPU=1000000UL -Os -funsigned-char -funs
igned-bitfields -fpack-struct -fshort-enums -Wall -Wstrict-prototypes -Wundef -W
a,-adhlns=obj/main.o  -std=gnu99 -Wundef -MD -MP -MF .dep/main.elf.d obj/main.o
--output main.elf -Wl,-Map=main.map,--cref    -lm

Creating load file for Flash: main.hex
avr-objcopy -O ihex -R .eeprom main.elf main.hex

Der Inhalt der hex-Datei kann nun zum Controller übertragen werden. Dies kann z. B. über In-System-Programming (ISP) erfolgen, das im AVR-Tutorial: Equipment beschrieben ist. Makefiles nach der WinAVR/MFile-Vorlage sind für die Nutzung des Programms AVRDUDE vorbereitet. Wenn man den Typ und Anschluss des Programmiergerätes richtig eingestellt hat, kann mit make program die Übertragung mittels AVRDUDE gestartet werden. Jede andere Software, die hex-Dateien lesen und zu einem AVR übertragen kann^[1], kann natürlich ebenfalls genutzt werden.

Startet man nun den Controller (Reset-Taster oder Stromzufuhr aus/an), werden vom Programm die Anschlüsse PB0 und PB1 auf 1 gesetzt. Man kann mit einem Messgerät nun an diesem Anschluss die Betriebsspannung messen oder eine LED leuchten lassen (Anode an den Pin, Vorwiderstand nicht vergessen). An den Anschlüssen PB2-PB7 misst man 0 Volt. Eine mit der Anode mit einem dieser Anschlüsse verbundene LED leuchtet nicht.

Ganzzahlige (Integer) Datentypen

Bei der Programmierung von Mikrokontrollern ist die Definition einiger ganzzahliger Datentypen sinnvoll, an denen eindeutig die Bit-Länge abgelesen werden kann.

Standardisierte Datentypen werden in der Header-Datei stdint.h definiert, die folgendermaßen eingebunden werden kann: <c>#include <stdint.h></c>

**int-Typen aus `stdint.h` (C99)**
Vorzeichenbehaftete int-Typen
Typname	Bit-Breite	Wertebereich		C-Entsprechung (avr-gcc)
`int8_t`	8	−128 ⋯ 127	−2⁷ ⋯ 2⁷−1	`signed char`
`int16_t`	16	−32768 ⋯ 32767	−2¹⁵ ⋯ 2¹⁵−1	`signed short`, `signed int`
`int32_t`	32	−2147483648 ⋯ 2147483647	−2³¹ ⋯ 2³¹−1	`signed long`
`int64_t`	64	−9223372036854775808 ⋯ 9223372036854775807	−2⁶³ ⋯ 2⁶³−1	`signed long long`
Vorzeichenlose int-Typen
Typname	Bit-Breite	Wertebereich		C-Entsprechung (avr-gcc)
`uint8_t`	8	0 ⋯ 255	0 ⋯ 2⁸−1	`unsigned char`
`uint16_t`	16	0 ⋯ 65535	0 ⋯ 2¹⁶−1	`unsigned short`, `unsigned int`
`uint32_t`	32	0 ⋯ 4294967295	0 ⋯ 2³²−1	`unsigned long`
`uint64_t`	64	0 ⋯ 18446744073709551615	0 ⋯ 2⁶⁴−1	`unsigned long long`

Neben den Typen gibt es auch Makros für die Bereichsgrenzen wie INT8_MIN oder UINT16_MAX. Siehe dazu auch: Dokumentation der avr-libc: Standard Integer Types.

Bitfelder

Beim Programmieren von Mikrocontrollern muss auf jedes Byte oder sogar auf jedes Bit geachtet werden. Oft müssen wir in einer Variablen lediglich den Zustand 0 oder 1 speichern. Wenn wir nun zur Speicherung eines einzelnen Wertes den kleinsten bekannten Datentypen, nämlich unsigned char, nehmen, dann verschwenden wir 7 Bits, da ein unsigned char ja 8 Bits breit ist.

Hier bietet uns die Programmiersprache C ein mächtiges Werkzeug an, mit dessen Hilfe wir 8 Bits in eine einzelne Bytevariable zusammenfassen und (fast) wie 8 einzelne Variablen ansprechen können. Die Rede ist von sogenannten Bitfeldern. Diese werden als Strukturelemente definiert. Sehen wir uns dazu doch am besten gleich ein Beispiel an:

<c> struct {

  unsigned bStatus_1:1; // 1 Bit für bStatus_1
  unsigned bStatus_2:1; // 1 Bit für bStatus_2
  unsigned bNochNBit:1; // Und hier noch mal ein Bit
  unsigned b2Bits:2;    // Dieses Feld ist 2 Bits breit
  // All das hat in einer einzigen Byte-Variable Platz.
  // die 3 verbleibenden Bits bleiben ungenutzt

} x; </c>

Der Zugriff auf ein solches Feld erfolgt nun, wie beim Strukturzugriff bekannt, über den Punkt- oder den Dereferenzierungs-Operator:

<c> x.bStatus_1 = 1; x.bStatus_2 = 0; x.b2Bits = 3; </c>

Bitfelder sparen Platz im RAM, zu Lasten von Platz im Flash, verschlechtern aber unter Umständen die Les- und Wartbarkeit des Codes. Anfängern wird deshalb geraten, ein "ganzes" Byte (uint8_t) zu nutzen, auch wenn nur ein Bitwert gespeichert werden soll.

Grundsätzlicher Programmaufbau eines µC-Programms

Wir unterscheiden zwischen 2 verschiedenen Methoden, um ein Mikrocontroller-Programm zu schreiben, und zwar völlig unabhängig davon, in welcher Programmiersprache das Programm geschrieben wird.

Sequentieller Programmablauf

Bei dieser Programmiertechnik wird eine Endlosschleife programmiert, welche im Wesentlichen immer den gleichen Aufbau hat. Es wird hier nach dem sogenannten EVA-Prinzip gehandelt. EVA steht für "Eingabe, Verarbeitung, Ausgabe":

Interruptgesteuerter Programmablauf

Bei dieser Methode werden beim Programmstart zuerst die gewünschten Interruptquellen aktiviert und dann in eine Endlosschleife gegangen, in welcher Dinge erledigt werden können, welche nicht zeitkritisch sind. Wenn ein Interrupt ausgelöst wird, so wird automatisch die zugeordnete Interruptfunktion ausgeführt.

Zugriff auf Register

Die AVR-Controller verfügen über eine Vielzahl von Registern. Die meisten davon sind sogenannte Schreib-/Leseregister. Das heißt, das Programm kann die Inhalte der Register sowohl auslesen als auch beschreiben.

Register haben einen besonderen Stellenwert bei den AVR Controllern. Sie dienen dem Zugriff auf die Ports und die Schnittstellen des Controllers. Wir unterscheiden zwischen 8-Bit und 16-Bit Registern. Vorerst behandeln wir die 8-Bit Register.

Einzelne Register sind bei allen AVRs vorhanden, andere wiederum nur bei bestimmten Typen. So sind beispielsweise die Register, welche für den Zugriff auf den UART notwendig sind, selbstverständlich nur bei denjenigen Modellen vorhanden, welche über einen integrierten Hardware UART bzw. USART verfügen.

Die Namen der Register sind in den Headerdateien zu den entsprechenden AVR-Typen definiert. Dazu muss man den Namen der controllerspezifischen Headerdatei nicht kennen. Es reicht aus, die allgemeine Headerdatei avr/io.h einzubinden:

<c>

include <avr/io.h>

</c>

Ist im Makefile der MCU-Typ z. B. mit dem Inhalt atmega8 definiert (und wird somit per -mmcu=atmega8 an den Compiler übergeben), wird beim Einlesen der io.h-Datei implizit ("automatisch") auch die iom8.h-Datei mit den Register-Definitionen für den ATmega8 eingelesen.

Intern wird diese "Automatik" wie folgt realisiert: Der Controllertyp wird dem Compiler als Parameter übergeben (vgl. avr-gcc -c -mmcu=atmega16 [...] im Einführungsbeispiel). Wird ein Makefile nach der WinAVR/mfile-Vorlage verwendet, setzt man die Variable MCU, der Inhalt dieser Variable wird dann an passender Stelle für die Compilerparameter verwendet. Der Compiler definiert intern eine dem mmcu-Parameter zugeordnete "Variable" (genauer: ein Makro) mit dem Namen des Controllers, vorangestelltem __AVR_ und angehängten Unterstrichen (z. B. wird bei -mmcu=atmega16 das Makro __AVR_ATmega16__ definiert). Beim Einbinden der Header-Datei avr/io.h wird geprüft, ob das jeweilige Makro definiert ist und die zum Controller passende Definitionsdatei eingelesen. Zur Veranschaulichung einige Ausschnitte aus einem Makefile:

[...]
# MCU Type ("name") setzen:
MCU = atmega16
[...]

[...]
## Verwendung des Inhalts von MCU (hier atmega16) fuer die 
## Compiler- und Assembler-Parameter
ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS) $(GENDEPFLAGS)
ALL_CPPFLAGS = -mmcu=$(MCU) -I. -x c++ $(CPPFLAGS) $(GENDEPFLAGS)
ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
[...]

[...]
## Aufruf des Compilers:
## mit den Parametern ($(ALL_CFLAGS) ist -mmcu=$(MCU)[...] = -mmcu=atmega16[...]
$(OBJDIR)/%.o : %.c
	@echo
	@echo $(MSG_COMPILING) $<
	$(CC) -c $(ALL_CFLAGS) $< -o $@ 
[...]

Da --mmcu=atmega16 übergeben wurde, wird __AVR_ATmega16__ definiert und kann in avr/io.h zur Fallunterscheidung genutzt werden:

<c> // avr/io.h // (bei WinAVR-Standardinstallation in C:\WinAVR\avr\include\avr) [...]

if defined (__AVR_AT94K__)
include <avr/ioat94k.h>

// [...]

elif defined (__AVR_ATmega16__)

// da __AVR_ATmega16__ definiert ist, wird avr/iom16.h eingebunden:

include <avr/iom16.h>

// [...]

else
if !defined(__COMPILING_AVR_LIBC__)
warning "device type not defined"
endif
endif

</c>

Die Beispiele in den folgenden Abschnitten demonstrieren den Zugriff auf Register anhand der Register für I/O-Ports (PORTx, DDRx, PINx), die Vorgehensweise ist jedoch für alle Register (z. B. die des UART, ADC, SPI) analog.

Schreiben in Register

Zum Schreiben kann man Register einfach wie eine Variable setzen.^[2]

Beispiel:

<c>

include <avr/io.h>

int main() {

   /* Setzt das Richtungsregister des Ports A auf 0xff 
      (alle Pins als Ausgang, vgl. Abschnitt Zugriff auf Ports): */
   DDRA = 0xff;

   /* Setzt PortA auf 0x03, Bit 0 und 1 "high", restliche "low": */
   PORTA = 0x03;

   // Setzen der Bits 0,1,2,3 und 4
   // Binär 00011111 = Hexadezimal 1F
   DDRB = 0x1F;    /* direkte Zuweisung - unübersichtlich */

   /* Ausführliche Schreibweise: identische Funktionalität, mehr Tipparbeit
      aber übersichtlicher und selbsterklärend: */
   DDRB = (1 << DDB0) | (1 << DDB1) | (1 << DDB2) | (1 << DDB3) | (1 << DDB4);

   while (1);

} </c>

Die ausführliche Schreibweise sollte bevorzugt verwendet werden, da dadurch die Zuweisungen selbsterklärend sind und somit der Code leichter nachvollzogen werden kann. Atmel verwendet sie auch bei Beispielen in Datenblätten und in den allermeisten Quellcodes zu Application-Notes. Mehr zu der Schreibweise mit "|" und "<<" findet man unter Bitmanipulation.

Der gcc C-Compiler unterstützt ab Version 4.3.0 Konstanten im Binärformat, z. B. DDRB = 0b00011111. Diese Schreibweise ist jedoch nur in GNU-C verfügbar und nicht in ISO-C definiert. Man sollte sie daher nicht verwenden, wenn Code mit anderen ausgetauscht oder mit anderen Compilern bzw. älteren Versionen des gcc genutzt werden soll.

Verändern von Registerinhalten

Einzelne Bits setzt und löscht man "Standard-C-konform" mittels logischer (Bit-) Operationen.

<c>

x |= (1 << Bitnummer);  // Hiermit wird ein Bit in x gesetzt
x &= ~(1 << Bitnummer); // Hiermit wird ein Bit in x geloescht

</c>

Es wird jeweils nur der Zustand des angegebenen Bits geändert, der vorherige Zustand der anderen Bits bleibt erhalten.

Beispiel: <c>

include <avr/io.h>

...

define MEINBIT 2

... PORTA |= (1 << MEINBIT); /* setzt Bit 2 an PortA auf 1 */ PORTA &= ~(1 << MEINBIT); /* loescht Bit 2 an PortA */ </c>

Mit dieser Methode lassen sich auch mehrere Bits eines Registers gleichzeitig setzen und löschen.

Beispiel: <c>

include <avr/io.h>

... DDRA &= ~( (1<<PA0) | (1<<PA3) ); /* PA0 und PA3 als Eingaenge */ PORTA |= (1<<PA0) | (1<<PA3); /* Interne Pull-Up fuer beide einschalten */ </c>

Bei bestimmten AVR Registern mit Bits, die durch Beschreiben mit einer logischen 1 gelöscht werden, muss eine absolute Zuweisung benutzt werden. Ein ODER löscht in diesen Registern ALLE gesetzten Bits!

Beispiel: <c>

include <avr/io.h>

... TIFR2 = (1<<OCF2A); // Nur Bit OCF2A löschen </c>

In Quellcodes, die für ältere Version den des avr-gcc/der avr-libc entwickelt wurden, werden einzelne Bits mittels der Funktionen sbi und cbi gesetzt bzw. gelöscht. Beide Funktionen sind nicht mehr erforderlich.

Siehe auch:

Bitmanipulation
Dokumentation der avr-libc Abschnitt Modules/Special Function Registers

Lesen aus Registern

Zum Lesen kann man auf Register einfach wie auf eine Variable zugreifen. In Quellcodes, die für ältere Versionen des avr-gcc/der avr-libc entwickelt wurden, erfolgt der Lesezugriff über die Funktion inp(). Aktuelle Versionen des Compilers unterstützen den Zugriff nun direkt und inp() ist nicht mehr erforderlich.

Beispiel:

<c>

include <avr/io.h>
include <stdint.h>

uint8_t foo;

//...

int main(void) {

   /* kopiert den Status der Eingabepins an PortB 
      in die Variable foo: */
   foo = PINB;    
   //...

} </c>

Die Abfrage der Zustände von Bits erfolgt durch Einlesen des gesamten Registerinhalts und ausblenden der Bits deren Zustand nicht von Interesse ist. Einige Beispiele zum Prüfen ob Bits gesetzt oder gelöscht sind:

<c>

define MEINBIT0 0
define MEINBIT2 2

uint8_t i;

extern test1();

// Funkion test1 aufrufen, wenn Bit 0 in Register PINA gesetzt (1) ist i = PINA; // Inhalt in Arbeitsvariable i = i & 0x01; // alle Bits bis auf Bit 0 ausblenden (logisches und)

                 // falls das Bit gesetzt war, hat i den Inhalt 1

if ( i != 0 ) { // Ergebnis ungleich 0 (wahr)?

 test1();         // dann muss Bit 0 in i gesetzt sein -> Funktion aufrufen

} // verkürzt: if ( ( PINA & 0x01 ) != 0 ) {

 test1();

} // nochmals verkürzt: if ( PINA & 0x01 ) {

 test1();

} // mit definierter Bitnummer: if ( PINA & ( 1 << MEINBIT0 ) ) {

 test1();

}

// Funktion aufrufen, wenn Bit 0 und/oder Bit 2 gesetzt ist. (Bit 0 und 2 also Wert 5) // (Bedenke: Bit 0 hat Wert 1, Bit 1 hat Wert 2 und Bit 2 hat Wert 4) if ( PINA & 0x05 ) {

 test1();  // Vergleich <> 0 (wahr), also mindestens eines der Bits gesetzt

} // mit definierten Bitnummern: if ( PINA & ( ( 1 << MEINBIT0 ) | ( 1 << MEINBIT2 ) ) ) {

 test1();

}

// Funktion aufrufen, wenn Bit 0 und Bit 2 gesetzt sind if ( ( PINA & 0x05 ) == 0x05 ) { // nur wahr, wenn beide Bits gesetzt

 test1();

}

// Funktion test2() aufrufen, wenn Bit 0 gelöscht (0) ist i = PINA; // einlesen in temporäre Variable i = i & 0x01; // maskieren von Bit 0 if ( i == 0 ) { // Vergleich ist wahr, wenn Bit 0 nicht gesetzt ist

 test2();

} // analog mit not-Operator if ( !i ) {

 test2();

} // nochmals verkürzt: if ( !( PINA & 0x01 ) ) {

 test2();

} </c>

Warten auf einen bestimmten Zustand

Es gibt in der Bibliothek avr-libc Funktionen, die warten, bis ein bestimmter Zustand eines Bits erreicht ist. Es ist allerdings normalerweise eine eher unschöne Programmiertechnik, da in diesen Funktionen "blockierend" gewartet wird. Der Programmablauf bleibt also an dieser Stelle stehen, bis das maskierte Ereignis erfolgt ist. Setzt man den Watchdog ein, muss man darauf achten, dass dieser auch noch getriggert wird (Zurücksetzen des Watchdogtimers).

Die Funktion loop_until_bit_is_set wartet in einer Schleife, bis das definierte Bit gesetzt ist. Wenn das Bit beim Aufruf der Funktion bereits gesetzt ist, wird die Funktion sofort wieder verlassen. Das niederwertigste Bit hat die Bitnummer 0.

<c>

include <avr/io.h>

...

/* Warten bis Bit Nr. 2 (das dritte Bit) in Register PINA gesetzt (1) ist */

define WARTEPIN PINA
define WARTEBIT PA2

// mit der avr-libc Funktion: loop_until_bit_is_set(WARTEPIN, WARTEBIT);

// dito in "C-Standard": // Durchlaufe die (leere) Schleife solange das WARTEBIT in Register WARTEPIN // _nicht_ ungleich 0 (also 0) ist. while ( !(WARTEPIN & (1 << WARTEBIT)) ) {} ... </c>

Die Funktion loop_until_bit_is_clear wartet in einer Schleife, bis das definierte Bit gelöscht ist. Wenn das Bit beim Aufruf der Funktion bereits gelöscht ist, wird die Funktion sofort wieder verlassen.

<c>

include <avr/io.h>

...

/* Warten bis Bit Nr. 4 (das fuenfte Bit) in Register PINB geloescht (0) ist */

define WARTEPIN PINB
define WARTEBIT PB4

// avr-libc-Funktion: loop_until_bit_is_clear(WARTEPIN, WARTEBIT);

// dito in "C-Standard": // Durchlaufe die (leere) Schleife solange das WARTEBIT in Register WARTEPIN // gesetzt (1) ist while ( WARTEPIN & (1<<WARTEBIT) ) {} ... </c>

Universeller und auch auf andere Plattformen besser übertragbar ist die Verwendung von C-Standardoperationen.

Siehe auch:

Dokumentation der avr-libc Abschnitt Modules/Special Function Registers
Bitmanipulation

16-Bit Register (ADC, ICR1, OCR1x, TCNT1, UBRR)

Einige der Portregister in den AVR-Controllern sind 16 Bit breit. Im Datenblatt sind diese Register üblicherweise mit dem Suffix "L" (Low-Byte) und "H" (High-Byte) versehen. Die avr-libc definiert zusätzlich die meisten dieser Variablen die Bezeichnung ohne "L" oder "H". Auf diese Register kann dann direkt zugegriffen werden. Dies ist zum Beispiel der Fall für Register wie ADC oder TCNT1. <c>

include <avr/io.h>

...

   uint16_t foo;

   /* setzt die Wort-Variable foo auf den Wert der letzten AD-Wandlung */
   foo = ADC;

</c>

Bei anderen Registern, wie zum Beispiel Baudraten-Register, liegen High- und Low-Teil nicht direkt nebeneinander im SFR-Bereich, so dass ein 16-Bit Zugriff nicht möglich ist und der Zugriff zusammengebastelt werden muss:

<c>

include <avr/io.h>

ifndef F_CPU
define F_CPU 3686400
endif
define UART_BAUD_RATE 9600

...

  uint16_t baud = F_CPU / (UART_BAUD_RATE * 16L) -1;

  UBRRH = (uint8_t) (baud >> 8);
  UBRRL = (uint8_t) baud;

... </c>

Bei einigen AVR-Typen wie ATmega8 oder ATmega16 teilen sich UBRRH und UCSRC die gleiche Speicher-Adresse. Damit der AVR trotzdem zwischen den beiden Registern unterscheiden kann, bestimmt das Bit7 (URSEL), welches Register tatsächlich beschrieben werden soll. 1000 0011 (0x83) adressiert demnach UCSRC und übergibt den Wert 3 und 0000 0011 (0x3) adressiert UBRRH und übergibt ebenfalls den Wert 3.

Speziell bei den 16-Bit-Timern und auch beim ADC ist es bei allen Zugriffen auf Datenregister erforderlich, dass diese Daten synchronisiert sind. Wenn z. B. bei einem 16-Bit-Timer das High-Byte des Zählregisters gelesen wurde und vor dem Lesezugriff auf das Low-Byte ein Überlauf des Low-Bytes stattfindet, erhält man einen völlig unsinnigen Wert. Auch die Compare-Register müssen synchron geschrieben werden, da es ansonsten zu unerwünschten Compare-Ereignissen kommen kann.

Beim ADC besteht das Problem darin, dass zwischen den Zugriffen auf die beiden Teilregister eine Wandlung beendet werden kann und der ADC ein neues Ergebnis in ADCL und ADCH schreiben will, wodurch High- und Low-Byte nicht zusammenpassen.

Um diese Datenmüllproduktion zu verhindern, gibt es in beiden Fällen eine Synchronisation, die jeweils durch den Zugriff auf das Low-Byte ausgelöst wird:

Bei den Timer-Registern (das gilt für alle TCNT-, OCR- und ICR-Register bei den 16-Bit-Timern) wird bei einem Lesezugriff auf das Low-Byte automatisch das High-Byte in ein temporäres Register, das ansonsten nach außen nicht sichtbar ist, geschoben. Greift man nun anschließend auf das High-Byte zu, dann wird eben dieses temporäre Register gelesen.
Bei einem Schreibzugriff auf eines der genannten Register wird das High-Byte in besagtem temporären Register zwischengespeichert und erst beim Schreiben des Low-Bytes werden beide gleichzeitig in das eigentliche Register übernommen.

Das bedeutet für die Reihenfolge:

Lesezugriff: Erst Low-Byte, dann High-Byte
Schreibzugriff: Erst High-Byte, dann Low-Byte

Des weiteren ist zu beachten, dass es für all diese 16-Bit-Register nur ein einziges temporäres Register gibt, so dass das Auftreten eines Interrupts, in dessen Handler ein solches Register manipuliert wird, bei einem durch ihn unterbrochenen Zugriff i.d.R. zu Datenmüll führt. 16-Bit-Zugriffe sind generell nicht atomar! Wenn mit Interrupts gearbeitet wird, kann es erforderlich sein, vor einem solchen Zugriff auf ein 16-Bit-Register die Interrupt-Bearbeitung zu deaktivieren.

Beim ADC-Datenregister ADCH/ADCL ist die Synchronisierung anders gelöst. Hier wird beim Lesezugriff (ADCH/ADCL sind logischerweise read-only) auf das Low-Byte ADCL beide Teilregister für Zugriffe seitens des ADC so lange gesperrt, bis das High-Byte ADCH ausgelesen wurde. Dadurch kann der ADC nach einem Zugriff auf ADCL keinen neuen Wert in ADCH/ADCL ablegen, bis ADCH gelesen wurde. Ergebnisse von Wandlungen, die zwischen einem Zugriff auf ADCL und ADCH beendet werden, gehen verloren!

Nach einem Zugriff auf ADCL muss grundsätzlich ADCH gelesen werden!

In beiden Fällen – also sowohl bei den Timern als auch beim ADC – werden vom C-Compiler 16-Bit Pseudo-Register zur Verfügung gestellt (z. B. TCNT1H/TCNT1L → TCNT1, ADCH/ADCL → ADC bzw. ADCW), bei deren Verwendung der Compiler automatisch die richtige Zugriffsreihenfolge regelt. In C-Programmen sollten grundsätzlich diese 16-Bit-Register verwendet werden! Sollte trotzdem ein Zugriff auf ein Teilregister erforderlich sein, sind obige Angaben zu berücksichtigen.

Es ist darauf zu achten, dass auch ein Zugriff auf die 16-Bit-Register vom Compiler in zwei 8-Bit-Zugriffe aufgeteilt wird und dementsprechend genauso nicht-atomar ist wie die Einzelzugriffe. Auch hier gilt, dass u.U. die Interrupt-Bearbeitung gesperrt werden muss, um Datenmüll zu vermeiden.

Beim ADC gibt es für den Fall, dass eine Auflösung von 8 Bit ausreicht, die Möglichkeit, das Ergebnis "linksbündig" in ADCH/ADCL auszurichten, so dass die relevanten 8 MSB in ADCH stehen. In diesem Fall muss bzw. sollte nur ADCH ausgelesen werden.

ADC und ADCW sind unterschiedliche Bezeichner für das selbe Registerpaar. Üblicherweise kann man in C-Programmen ADC verwenden, was analog zu den anderen 16-Bit-Registern benannt ist. ADCW (ADC Word) existiert nur deshalb, weil die Headerdateien auch für Assembler vorgesehen sind und es bereits einen Assembler-Befehl namens adc gibt.

Im Umgang mit 16-Bit Registern siehe auch:

Dokumentation der avr-libc Abschnitt Related Pages/Frequently Asked Questions/Nr. 8
Datenblatt Abschnitt Accessing 16-bit Registers

IO-Register als Parameter und Variablen

Um Register als Parameter für eigene Funktionen übergeben zu können, muss man sie als einen volatile uint8_t Pointer übergeben. Zum Beispiel:

<c>

include <avr/io.h>
include <util/delay.h>

uint8_t key_pressed (volatile uint8_t *inputreg, uint8_t inputbit) {

 static uint8_t last_state = 0;

 if (last_state == (*inputreg & (1<<inputbit)))
    return 0; /* keine Änderung */

 /* Wenn doch, warten bis etwaiges Prellen vorbei ist: */
 _delay_ms(20);

 /* Zustand für nächsten Aufruf merken: */
 last_state = *inputreg & (1<<inputbit);

 /* und den entprellten Tastendruck zurückgeben: */
 return *inputreg & (1<<inputbit);

}

/* Beispiel für einen Funktionsaufruf: */

void foo (void) {

  uint8_t i = key_pressed (&PINB, PB1);

} </c>

Ein Aufruf der Funktion mit call by value würde Folgendes bewirken: Beim Funktionseintritt wird nur eine Kopie des momentanen Portzustandes angefertigt, die sich unabhängig vom tatsächlichen Zustand das Ports nicht mehr ändert, womit die Funktion wirkungslos wäre. Die Übergabe eines Zeigers wäre die Lösung, wenn der Compiler nicht optimieren würde. Denn dadurch wird im Programm nicht von der Hardware gelesen, sondern wieder nur von einem Abbild im Speicher. Das Ergebnis wäre das gleiche wie oben. Mit dem Schlüsselwort volatile sagt man nun dem Compiler, dass die entsprechende Variable entweder durch andere Softwareroutinen (Interrupts) oder durch die Hardware verändert werden kann.

Siehe auch: avr-libc FAQ: "How do I pass an IO port as a parameter to a function?"

Zugriff auf IO-Ports

Jeder AVR implementiert eine unterschiedliche Menge an GPIO-Registern (GPIO - General Purpose Input/Output). Diese Register dienen dazu:

einzustellen welche der Anschlüsse ("Beinchen") des Controllers als Ein- oder Ausgänge dienen
bei Ausgängen deren Zustand festzulegen
bei Eingängen deren Zustand zu erfassen

Mittels GPIO werden digitale Zustände gesetzt und erfasst, d.h. die Spannung an einem Ausgang wird ein- oder ausgeschaltet und an einem Eingang wird erfasst, ob die anliegende Spannung über oder unter einem bestimmten Schwellwert liegt. Im Datenblatt Abschnitt Electrical Characteristics/DC Characteristics finden sich die Spannungswerte (V_OL, V_OH für Ausgänge, V_IL, V_IH für Eingänge).

Die Verarbeitung von analogen Eingangswerten und die Ausgabe von Analogwerten wird in Kapitel Analoge Ein- und Ausgabe behandelt.

Die physischen Ein- und Ausgänge werden bei AVR-Controllern zu logischen Ports gruppiert.

Alle Ports werden über Register gesteuert. Dazu sind jedem Port 3 Register zugeordnet:

DDRx	Datenrichtungsregister für Portx. x entspricht A, B, C, D usw. (abhängig von der Anzahl der Ports des verwendeten AVR). Bit im Register gesetzt (1) für Ausgang, Bit gelöscht (0) für Eingang.
PINx	Eingangsadresse für Portx. Zustand des Ports. Die Bits in PINx entsprechen dem Zustand der als Eingang definierten Portpins. Bit 1 wenn Pin "high", Bit 0 wenn Portpin low.
PORTx	Datenregister für Portx. Dieses Register wird verwendet, um die Ausgänge eines Ports anzusteuern. Bei Pins, die mittels DDRx auf Eingang geschaltet wurden, können über PORTx die internen Pull-Up Widerstände aktiviert oder deaktiviert werden (1 = aktiv).

Die folgenden Beispiele gehen von einem AVR aus, der sowohl Port A als auch Port B besitzt. Sie müssen für andere AVRs (zum Beispiel ATmega8/48/88/168) entsprechend angepasst werden.

Datenrichtung bestimmen

Zuerst muss die Datenrichtung der verwendeten Pins bestimmt werden. Um dies zu erreichen, wird das Datenrichtungsregister des entsprechenden Ports beschrieben.

Für jeden Pin, der als Ausgang verwendet werden soll, muss dabei das entsprechende Bit auf dem Port gesetzt werden. Soll der Pin als Eingang verwendet werden, muss das entsprechende Bit gelöscht sein.

Beispiel: Angenommen am Port B sollen die Pins 0 bis 4 als Ausgänge definiert werden, die noch verbleibenden Pins 5 bis 7 sollen als Eingänge fungieren. Dazu ist es daher notwendig, im für das Port B zuständigen Datenrichtungsregister DDRB folgende Bitkonfiguration einzutragen

  +---+---+---+---+---+---+---+---+
  | 0 | 0 | 0 | 1 | 1 | 1 | 1 | 1 |
  +---+---+---+---+---+---+---+---+
    7   6   5   4   3   2   1   0

In C liest sich das dann so:

<c> // in io.h wird u.a. DDRB definiert:

include <avr/io.h>

int main() {

 // Setzen der Bits 0,1,2,3 und 4
 // Binär 00011111 = Hexadezimal 1F
 // direkte Zuweisung - standardkonform */
 DDRB = 0x1F;    /*

 // übersichtliche Alternative - Binärschreibweise, aber kein ISO-C
 DDRB = 0b00011111;

 // Ausführliche Schreibweise: identische Funktionalität, mehr Tipparbeit
 // aber übersichtlicher und selbsterklärend:
 DDRB = (1 << DDB0) | (1 << DDB1) | (1 << DDB2) | (1 << DDB3) | (1 << DDB4);

</c>

Die Pins 5 bis 7 werden (da 0) als Eingänge geschaltet. Weitere Beispiele:

<c>

 // Alle Pins des Ports B als Ausgang definieren:
 DDRB = 0xff; 
 // Pin0 wieder auf Eingang und andere im ursprünglichen Zustand belassen:
 DDRB &= ~(1 << DDB0);
 // Pin 3 und 4 auf Eingang und andere im ursprünglichen Zustand belassen:
 DDRB &= ~((1 << DDB3) | (1 << DDB4));
 // Pin 0 und 3 wieder auf Ausgang und andere im ursprünglichen Zustand belassen:
 DDRB |= (1 << DDB0) | (1 << DDB3);
 // Alle Pins auf Eingang:
 DDRB = 0x00;

</c>

Vordefinierte Bitnummern für I/O-Register

Die Bitnummern (z. B. PCx, PINCx und DDCx für den Port C) sind in den io*.h-Dateien der avr-libc definiert und dienen lediglich der besseren Lesbarkeit. Man muss diese Definitionen nicht verwenden oder kann auch einfach "immer" PAx, PBx, PCx usw. nutzen, auch wenn der Zugriff auf Bits in DDRx- oder PINx-Registern erfolgt. Für den Compiler sind die Ausdrücke (1<<PC7), (1<<DDC7) und (1<<PINC7) identisch zu (1<<7) (genauer: der Präprozessor ersetzt die Ausdrücke (1<<PC7),... zu (1<<7)). Ein Ausschnitt der Definitionen für Port C eines ATmega32 aus der iom32.h-Datei zur Verdeutlichung (analog für die weiteren Ports):

<c> ... /* PORTC */

define PC7 7
define PC6 6
define PC5 5
define PC4 4
define PC3 3
define PC2 2
define PC1 1
define PC0 0

/* DDRC */

define DDC7 7
define DDC6 6
define DDC5 5
define DDC4 4
define DDC3 3
define DDC2 2
define DDC1 1
define DDC0 0

/* PINC */

define PINC7 7
define PINC6 6
define PINC5 5
define PINC4 4
define PINC3 3
define PINC2 2
define PINC1 1
define PINC0 0

</c>

Digitale Signale

Am einfachsten ist es, digitale Signale mit dem Mikrocontroller zu erfassen bzw. auszugeben.

Ausgänge

Will man als Ausgang definierte Pins (entsprechende DDRx-Bits = 1) auf Logisch 1 setzen, setzt man die entsprechenden Bits im Portregister.

Mit dem Befehl <c>

include <avr/io.h>

...

   PORTB = 0x04; /* besser PORTB=(1<<PB2) */

   // übersichtliche Alternative - Binärschreibweise
   PORTB = 0b00000100;    /* direkte Zuweisung - übersichtlich */

</c> wird also der Ausgang an Pin PB2 gesetzt (Beachte, dass die Bits immer von 0 an gezählt werden, das niederwertigste Bit ist also Bitnummer 0 und nicht etwa Bitnummer 1).

Man beachte, dass bei der Zuweisung mittels = immer alle Pins gleichzeitig angegeben werden. Man sollte also, wenn nur bestimmte Ausgänge geschaltet werden sollen, zuerst den aktuellen Wert des Ports einlesen und das Bit des gewünschten Ports in diesen Wert einfließen lassen. Will man also nur den dritten Pin (Bit Nr. 2) an Port B auf "high" setzen und den Status der anderen Ausgänge unverändert lassen, nutze man diese Form:

<c>

include <avr/io.h>

...

   PORTB = PORTB | 0x04; /* besser: PORTB = PORTB | ( 1<<PB2 ) */
   /* vereinfacht durch Nutzung des |= Operators : */
   PORTB |= (1<<PB2);

   /* auch mehrere "gleichzeitig": */
   PORTB |= (1<<PB4) | (1<<PB5); /* Pins PB4 und PB5 "high" */

</c>

"Ausschalten", also Ausgänge auf "low" setzen, erfolgt analog:

<c>

include <avr/io.h>

...

   PORTB &= ~(1<<PB2); /* löscht Bit 2 in PORTB und setzt damit Pin PB2 auf low */ 
   PORTB &= ~( (1<<PB4) | (1<<PB5) ); /* Pin PB4 und Pin PB5 "low" */

</c> Siehe auch Bitmanipulation

Falls der Anfangszustand von Ausgängen kritisch ist, muss die Reihenfolge beachtet werden, mit der die Datenrichtung (DDRx) eingestellt und der Ausgabewert (PORTx) gesetzt wird:

Für Ausgangspins, die mit Anfangswert "high" initialisiert werden sollen:

zuerst die Bits im PORTx-Register setzen
anschließend die Datenrichtung auf Ausgang stellen

Daraus ergibt sich die Abfolge für einen Pin, der bisher als Eingang mit abgeschaltetem Pull-Up konfiguriert war:

setze PORTx: interner Pull-Up aktiv
setze DDRx: Ausgang ("high")

Bei der Reihenfolge erst DDRx und dann PORTx kann es zu einem kurzen "low-Puls" kommen, der auch externe Pull-Up-Widerstände "überstimmt". Die (ungünstige) Abfolge: Eingang -> setze DDRx: Ausgang (auf "low", da PORTx nach Reset 0) -> setze PORTx: Ausgang auf high. Vergleiche dazu auch das Datenblatt Abschnitt Configuring the Pin.

Eingänge (Wie kommen Signale in den µC)

Die digitalen Eingangssignale können auf verschiedene Arten zu unserer Logik gelangen.

Signalkopplung

Am einfachsten ist es, wenn die Signale direkt aus einer anderen digitalen Schaltung übernommen werden können. Hat der Ausgang der entsprechenden Schaltung TTL-Pegel dann können wir sogar direkt den Ausgang der Schaltung mit einem Eingangspin von unserem Controller verbinden.

Hat der Ausgang der anderen Schaltung keinen TTL-Pegel so müssen wir den Pegel über entsprechende Hardware (z. B. Optokoppler, Spannungsteiler, "Levelshifter" aka Pegelwandler) anpassen.

Die Masse der beiden Schaltungen muss selbstverständlich miteinander verbunden werden. Der Software selber ist es natürlich letztendlich egal, wie das Signal eingespeist wird. Wir können ja ohnehin lediglich prüfen, ob an einem Pin unseres Controllers eine logische 1 (Spannung größer ca. 0,7*Vcc) oder eine logische 0 (Spannung kleiner ca. 0,2*Vcc) anliegt. Detaillierte Informationen darüber, ab welcher Spannung ein Eingang als 0 ("low") bzw. 1 ("high") erkannt wird, liefert die Tabelle DC Characteristics im Datenblatt des genutzten Controllers.

**Spannungstabelle**
(ca. Grenzwerte)
	Low	High
bei 5 V	1 V	3,5 V
bei 3,3 V	0,66 V	2,31 V
bei 1,8 V	0,36 V	1,26 V

Die Abfrage der Zustände der Portpins erfolgt direkt über den Registernamen.

Dabei ist wichtig, zur Abfrage der Eingänge nicht etwa Portregister PORTx zu verwenden, sondern Eingangsregister PINx. Ansonsten liest man nicht den Zustand der Eingänge, sondern den Status der internen Pull-Up-Widerstände. Die Abfrage der Pinzustände über PORTx statt PINx ist ein häufiger Fehler beim AVR-"Erstkontakt".

Will man also die aktuellen Signalzustände von Port D abfragen und in eine Variable namens bPortD abspeichern, schreibt man folgende Befehlszeilen:

<c>

include <avr/io.h>
include <stdint.h>

... uint8_t bPortD; ... bPortD = PIND; ... </c>

Mit den C-Bitoperationen kann man den Status der Bits abfragen.

<c>

include <avr/io.h>

... /* Fuehre Aktion aus, wenn Bit Nr. 1 (das "zweite" Bit) in PINC gesetzt (1) ist */ if ( PINC & (1<<PINC1) ) {

 /* Aktion */

}

/* Fuehre Aktion aus, wenn Bit Nr. 2 (das "dritte" Bit) in PINB geloescht (0) ist */ if ( !(PINB & (1<<PINB2)) ) {

 /* Aktion */

} ... </c> Siehe auch Bitmanipulation#Bits_prüfen

Interne Pull-Up Widerstände

Portpins für Ein- und Ausgänge (GPIO) eines AVR verfügen über zuschaltbare interne Pull-Up Widerstände (nominal mehrere 10kOhm, z. B. ATmega16 20-50kOhm). Diese können in vielen Fällen statt externer Widerstände genutzt werden.

Die internen Pull-Up Widerstände von Vcc zu den einzelnen Portpins werden über das Register PORTx aktiviert bzw. deaktiviert, wenn ein Pin als Eingang geschaltet ist.

Wird der Wert des entsprechenden Portpins auf 1 gesetzt, so ist der Pull-Up Widerstand aktiviert. Bei einem Wert von 0 ist der Pull-Up Widerstand nicht aktiv. Man sollte jeweils entweder den internen oder einen externen Pull-Up Widerstand verwenden, aber nicht beide zusammen.

Im Beispiel werden alle Pins des Ports D als Eingänge geschaltet und alle Pull-Up Widerstände aktiviert. Weiterhin wird Pin PC7 als Eingang geschaltet und dessen interner Pull-Up Widerstand aktiviert, ohne die Einstellungen für die anderen Portpins (PC0-PC6) zu verändern.

<c>

include <avr/io.h>

... DDRD = 0x00; /* alle Pins von Port D als Eingang */ PORTD = 0xff; /* interne Pull-Ups an allen Port-Pins aktivieren */ ... DDRC &= ~(1<<PC7); /* Pin PC7 als Eingang */ PORTC |= (1<<PC7); /* internen Pull-Up an PC7 aktivieren */ </c>

Tasten und Schalter

Der Anschluss mechanischer Kontakte an den Mikrocontroller, ist zwischen zwei unterschiedliche Methoden zu unterscheiden: Active Low und Active High.

Anschluss mechanischer Kontakte an einen µC
Active Low: Bei dieser Methode wird der Kontakt zwischen den Eingangspin des Controllers und Masse geschaltet. Damit bei offenem Schalter der Controller kein undefiniertes Signal bekommt, wird zwischen die Versorgungsspannung und den Eingangspin ein sogenannter Pull-Up Widerstand geschaltet. Dieser dient dazu, den Pegel bei geöffnetem Schalter auf logisch 1 zu ziehen.
Active High: Hier wird der Kontakt zwischen die Versorgungsspannung und den Eingangspin geschaltet. Damit bei offener Schalterstellung kein undefiniertes Signal am Controller ansteht, wird zwischen den Eingangspin und die Masse ein Pull-Down Widerstand geschaltet. Dieser dient dazu, den Pegel bei geöffneter Schalterstellung auf logisch 0 zu halten.

Der Widerstandswert von Pull-Up- und Pull-Down-Widerständen ist an sich nicht kritisch. Wird er allerdings zu hoch gewählt, ist die Wirkung eventuell nicht gegeben. Als üblicher Wert haben sich 10 kOhm eingebürgert. Die AVRs verfügen an den meisten Pins über zuschaltbare interne Pull-Up Widerstände (vgl. Abschnitt Interne Pull-Up Widerstände), welche insbesondere wie hier bei Tastern und ähnlichen Bauteilen (z. B. Drehgebern) statt externer Bauteile verwendet werden können. Interne Pull-Down-Widerstand sind nicht verfügbar und müssen daher in Form zusätzlicher Bauteile in die Schaltung eingefügt werden.

(Tasten-)Entprellung

Siehe: Entprellung: Warteschleifen-Verfahren

Analoge Ein- und Ausgabe

Analoge Eingangswerte werden in der Regel über den AVR Analog-Digital-Converter (AD-Wandler, ADC) eingelesen, der in vielen Typen verfügbar ist (typisch 10bit Auflösung). Durch diesen werden analoge Signale (Spannungen) in digitale Zahlenwerte gewandelt. Bei AVRs, die über keinen internen AD-Wandler verfügen (z. B. ATmega162), kann durch externe Beschaltung (R/C-Netzwerk und Zeitmessung) die Funktion des AD-Wandlers simuliert werden.

Es gibt innerhalb der ATMega- und ATTiny-AVR Reihe keine Typen mit eingebautem Digital-Analog-Konverter (DAC) - diese Funktion ist erst ab der XMEGA-Reihe der AVR-Familie verfügbar, die aber wegen ihrer vielen Unterschiede im Umfang dieses Tutorials nicht behandelt wird. Die Umsetzung zu einer analogen Spannung muss daher durch externe Komponenten vorgenommen werden. Das kann z. B. durch PWM und deren Filterung zu (fast) DC, oder einem sogenannten R2R-Netzwerk erfolgen.

Unabhängig davon besteht natürlich immer die Möglichkeit, spezielle Bausteine zur Analog-Digital- bzw. Digital-Analog-Wandlung zu nutzen und diese über eine digitale Schnittstelle (z.b. SPI oder I2C) mit einem AVR anzusteuern.

AC (Analog Comparator)

Der Comparator vergleicht 2 Spannungen an den Pins AIN0 und AIN1 und gibt einen Status aus welche der beiden Spannungen größer ist. AIN0 Dient dabei als Referenzspannung (Sollwert) und AIN1 als Vergleichsspannung (Istwert). Als Referenzspannung kann auch alternativ eine interne Referenzspannung ausgewählt werden.

Liegt die Vergleichsspannung (IST) unter der der Referenzspannung (SOLL) gibt der Comparator eine logische 1 aus. Ist die Vergleichsspannung hingegen größer als die Referenzspannung wird eine logische 0 ausgegeben.

Der Comparator arbeitet völlig autark bzw. parallel zum Prozessor. Für mobile Anwendungen empfiehlt es sich ihn abzuschalten sofern er nicht benötigt wird, da er ansonsten Strom benötigt. Der Comparator kann interruptgesteuert abgefragt werden oder im Pollingbetrieb.

Das Steuer- bzw. Statusregister ist wie folgt aufgebaut:

**ACSR - Analog Comparator Status Register**
Bit	7	6	5	4	3	2	1	0
Name	ACD	ACBG	ACO	ACI	ACIE	ACIC	ACIS1	ACIS0
R/W	R/W	R/W	R	R/W	R/W	R/W	R/W	R/W
Initialwert	0	0	n/a	0	0	0	0	0

Bit 7 ACD: Analog Comparator Disable: 0 = Comparator ein, 1 = Comparator aus. Wird dieses Bit geändert kann ein Interrupt ausgelöst werden. Soll dies vermieden werden muss das Bit 3 ACIE ggf. abgeschaltet werden.

Bit 6 ACBG: Analog Comparator Bandgap Select: Ermöglicht das umschalten zwischen interner und externer Referenzspannung. 1 = interne (~1,3 Volt), 0 = externe Referenzspannung (an Pin AIN0)

Bit 5 ACO

Analog Comparator Output: Hier wird das Ergebnis des Vergleichs angezeigt. Es liegt typischerweise nach 1-2 Taktzyklen vor.

IST < SOLL → 1

IST > SOLL → 0

Bit 4 ACI: Analog Comparator Interrupt Flag: Dieses Bit wird von der Hardware gesetzt, wenn ein Interruptereignis, das in Bit 0 und 1 definiert ist, eintritt. Dieses Bit löst noch keinen Interrupt aus! Die Interruptroutine wird nur dann ausgeführt, wenn das Bit 3 ACIE gesetzt ist und global Interrupts erlaubt sind (I-Bit in SREG gesetzt). Das Bit 4 ACI wird wieder gelöscht, wenn die Interruptroutine ausgeführt wurde oder wenn es manuell auf 1! gesetzt wird. Das Bit kann für Abfragen genutzt werden, steuert oder konfiguriert aber nicht den Comparator.

Bit 3 ACIE: Analog Comparator Interrupt Enable: Ist das Bit auf 1 gesetzt, wird immer ein Interrupt ausgelöst, wenn das Ereignis das in Bit 1 und 0 definiert ist, eintritt.

Bit 2 ACIC: Analog Comparator Input Capture Enable: Wird das Bit gesetzt, wird der Comparatorausgang intern mit dem Counter 1 verbunden. Es könnten damit z.b. die Anzahl der Vergleiche im Counter1 gezählt werden. Um den Comparator an den Timer1 Input Capture Interrupt zu verbinden, muss im Timerregister das TICIE1 Bit auf 1 gesetzt werden. Der Trigger wird immer dann ausgelöst, wenn das in Bit 1 und 0 definierte Ereignis eintritt.

Bit 1,0 ACIS1,ACIS0

Analog Comparator Interrupt select: Hier wird definiert, welche Ereignisse einen Interrupt auslösen sollen:

00 = Interrupt auslösen bei jedem Flankenwechsel
10 = Interrupt auslösen bei fallender Flanke
11 = Interrupt auslösen bei steigender Flanke

Werden diese Bit geändert, kann ein Interrupt ausgelöst werden. Soll dies vermieden werden, muss das Bit 3 gelöscht werden.

ADC (Analog Digital Converter)

Der Analog-Digital-Konverter (ADC) wandelt analoge Signale in digitale Werte um, welche vom Controller interpretiert werden können. Einige AVR-Typen haben bereits einen mehrkanaligen Analog-Digital-Konverter eingebaut. Die Feinheit, mit welcher ein analoges Signal aufgelöst werden kann, wird durch die Auflösung des ADC, d.h. durch die Anzahl der verwendeten Bits angegeben. So sind derzeit bspw. 8-Bit- oder 10-Bit-ADC im Einsatz. ADCs, die in AVRs enthalten sind, haben zur Zeit eine maximale Auflösung von 10-Bit.

Ein ADC mit 8 Bit Auflösung kann somit das analoge Signal in Abstufungen von 1/256 des Maximalwertes digitalisieren. Wenn wir nun mal annehmen, wir hätten eine Eingangspannung zwischen 0 und 5 Volt, eine Referenzspannung von 5 V und eine Auflösung von 3 Bit, dann könnten Intervalle mit den Grenzen 0 V, 0.625 V, 1.25 V, 1.875 V, 2.5 V, 3.125 V, 3.75 V, 4.375 V, 5 V entsprechend folgender Tabelle unterschieden werden:

Eingangsspannung am ADC / V	Entsprechender Messwert
0 – 0.625	0
0.625 – 1.25	1
1.25 – 1.875	2
1.875 – 2.5	3
2.5 – 3.125	4
3.125 – 3.75	5
3.75 – 4.375	6
4.375 – 5	7

Die Angaben sind natürlich nur ungefähr. Je höher nun die Auflösung des Analog-Digital-Konverters ist, also, je mehr Bits er hat, desto genauer kann der jeweilige Wert erfasst werden.

Der interne ADC im AVR

Oft sind auch mehrere Kanäle verfügbar. Kanäle heißt in diesem Zusammenhang, dass zwar bis zu zehn analoge Eingänge am AVR vorhanden sind, aber nur ein "echter" Analog-Digital-Wandler zur Verfügung steht. Vor der eigentlichen Messung ist also festzulegen, welcher Kanal ("Pin") mit dem Wandler verbunden und gemessen wird.

Die Umwandlung innerhalb des AVR basiert auf der schrittweisen Näherung. Beim AVR müssen die Pins AGND und AVCC beschaltet werden. Für genaue Messungen sollte AVCC über ein L-C Netzwerk mit VCC verbunden werden, um Spannungsspitzen und -einbrüche vom Analog-Digital-Wandler fernzuhalten. Im Datenblatt findet sich dazu eine Schaltung, die 10µH und 100nF vorsieht.

Das Ergebnis der Analog-Digital-Wandlung wird auf eine Referenzspannung bezogen. Aktuelle AVRs bieten drei Möglichkeiten zur Wahl dieser Spannung:

Eine externe Referenzspannung von maximal Vcc am Anschlusspin AREF. Die minimale (externe) Referenzspannung darf jedoch nicht beliebig niedrig sein, vgl. dazu das (aktuellste) Datenblatt des verwendeten Controllers.

Verfügt der AVR über eine interne Referenzspannung, kann diese genutzt werden. Alle aktuellen AVRs mit internem AD-Wandler sollten damit ausgestattet sein (vgl. Datenblatt: 2,56V oder 1,1V je nach Typ). Das Datenblatt gibt auch über die Genauigkeit dieser Spannung Auskunft.

Es kann die Spannung AVcc als Referenzspannung herangezogen werden

Bei Nutzung von AVcc oder der internen Referenz wird empfohlen, einen Kondensator zwischen dem AREF-Pin und GND anzuordnen. Die Festlegung, welche Spannungsreferenz genutzt wird, erfolgt z. B. beim ATmega16 mit den Bits REFS1/REFS0 im ADMUX-Register. Die zu messende Spannung muss im Bereich zwischen AGND und AREF (egal ob intern oder extern) liegen.

Der ADC kann in zwei verschiedenen Betriebsarten verwendet werden:

Einfache Wandlung (Single Conversion): In dieser Betriebsart wird der Wandler bei Bedarf vom Programm angestoßen für jeweils eine Messung.

Frei laufend (Free Running): In dieser Betriebsart erfasst der Wandler permanent die anliegende Spannung und schreibt diese in das ADC Data Register.

Die Register des ADC

Der ADC verfügt über eigene Register. Im Folgenden die Registerbeschreibung eines ATMega16, welcher über 8 ADC-Kanäle verfügt. Die Register unterscheiden sich jedoch nicht erheblich von denen anderer AVRs (vgl. Datenblatt).

ADCSRA

ADC Control and Status Register A.

In diesem Register stellen wir ein, wie wir den ADC verwenden möchten.
Das Register ist wie folgt aufgebaut:

Bit	7	6	5	4	3	2	1	0
Name	ADEN	ADSC	ADFR	ADIF	ADIE	ADPS2	ADPS1	ADPS0
R/W	R/W	R/W	R/W	R/W	R/W	R/W	R/W	R/W
Initialwert	0	0	0	0	0	0	0	0

ADEN (ADC Enable)

Dieses Bit muss gesetzt werden, um den ADC überhaupt zu aktivieren. Wenn das Bit nicht gesetzt ist, können die Pins wie normale I/O-Pins verwendet werden.

ADSC (ADC Start Conversion)

Mit diesem Bit wird ein Messvorgang gestartet. In der frei laufenden Betriebsart muss das Bit gesetzt werden, um die kontinuierliche Messung zu aktivieren.

Wenn das Bit nach dem Setzen des ADEN-Bits zum ersten Mal gesetzt wird, führt der Controller zuerst eine zusätzliche Wandlung und erst dann die eigentliche Wandlung aus. Diese zusätzliche Wandlung wird zu Initialisierungszwecken durchgeführt.

Das Bit bleibt nun so lange auf 1, bis die Umwandlung abgeschlossen ist, im Initialisierungsfall entsprechend bis die zweite Umwandlung erfolgt ist und geht danach auf 0.

ADFR (ADC Free Run select)

Mit diesem Bit wird die Betriebsart eingestellt.

Ist das Bit auf 1 gesetzt arbeitet der ADC im "Free Running"-Modus. Dabei wird das Datenregister permanent aktualisiert. Ist das Bit hingegen auf 0 gesetzt, macht der ADC nur eine "Single Conversion".

ADIF (ADC Interrupt Flag)

Dieses Bit wird vom ADC gesetzt, sobald eine Umwandlung erfolgt ist und das ADC Data Register aktualisiert wurde. Das Bit wird bei lesendem Zugriff auf ADC(L,H) automatisch (d.h. durch die Hardware) gelöscht.

Wenn das ADIE Bit sowie das I-Bit im AVR Statusregister gesetzt ist, wird der ADC Interrupt ausgelöst und die Interrupt-Behandlungsroutine aufgerufen.

Das Bit wird automatisch gelöscht, wenn die Interrupt-Behandlungsroutine aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1! in das Register geschrieben wird.

ADIE (ADC Interrupt Enable)

Wenn dieses Bit gesetzt ist und ebenso das I-Bit im Statusregister SREG, dann wird der ADC-Interrupt aktiviert.

ADPS2...ADPS0 (ADC Prescaler Select Bits)

Diese Bits bestimmen den Teilungsfaktor zwischen der Taktfrequenz und dem Eingangstakt des ADC.

Der ADC benötigt einen eigenen Takt, welchen er sich selber aus der CPU-Taktfreqenz erzeugt. Der ADC-Takt sollte zwischen 50 und 200kHz liegen.

Der Vorteiler muss also so eingestellt werden, dass CPU-Taktfrequenz dividiert durch den Teilungsfaktor einen Wert im Bereich (50-200)kHz ergibt.

Bei einer CPU-Taktfrequenz von 4MHz beispielsweise rechnen wir

[math]\displaystyle{ \begin{matrix} TF_{min}=\frac{CLK}{200\,\mathrm{kHz}}=\frac{4000000}{200000}=\mathbf{20} \\ \\ TF_{max}=\frac{CLK}{50\,\mathrm{kHz}}=\frac{4000000}{50000}=\mathbf{80} \end{matrix} }[/math]

Somit kann hier der Teilungsfaktor 32 oder 64 verwendet werden. Im Interesse der schnelleren Wandlungszeit werden wir hier den Faktor 32 einstellen.

ADPS2	ADPS1	ADPS0	Teilungsfaktor
0	0	0	2
0	0	1	2
0	1	0	4
0	1	1	8
1	0	0	16
1	0	1	32
1	1	0	64
1	1	1	128

ADCL

ADCH

ADC Data Register

Wenn eine Umwandlung abgeschlossen ist, befindet sich der gemessene Wert in diesen beiden Registern. Von ADCH werden nur die beiden niederwertigsten Bits verwendet. Es müssen immer beide Register ausgelesen werden, und zwar immer in der Reihenfolge: ADCL, ADCH. Der effektive Messwert ergibt sich dann zu:

<c> x = ADCL; // mit uint16_t x x += (ADCH<<8); // in zwei Zeilen (LSB/MSB-Reihenfolge und

               // C-Operatorpriorität sichergestellt)

</c>

oder

<c> x = ADCW; // je nach AVR auch x = ADC (siehe avr/ioxxx.h) </c>

ADMUX

ADC Multiplexer Select Register

Mit diesem Register wird der zu messende Kanal ausgewählt. Beim 90S8535 kann jeder Pin von Port A als ADC-Eingang verwendet werden (=8 Kanäle).
Das Register ist wie folgt aufgebaut:

Bit	7	6	5	4	3	2	1	0
Name	REFS1	REFS0	ADLAR	MUX4	MUX3	MUX2	MUX1	MUX0
R/W	R/W	R/W	R/W	R/W	R/W	R/W	R/W	R/W
Initialwert	0	0	0	0	0	0	0	0

REFS1...REFS0 (ReferenceSelection Bits)

Mit diesen Bits kann die Referenzspannung eingestellt werden. Bei der Umstellung sind Wartezeiten zu beachten, bis die ADC-Hardware einsatzfähig ist (Datenblatt und [1]):

REFS1	REFS0	Referenzspanung
0	0	Externes AREF
0	1	AVCC als Referenz
1	0	Reserviert
1	1	Interne 2,56 Volt

ADLAR (ADC Left Adjust Result)

Das ADLAR Bit verändert das Aussehen des Ergebnisses der AD-Wandlung. Bei einer logischen 1 wird das Ergebnis linksbündig ausgegeben, bei einer 0 rechtsbündig. Eine Änderung in diesem Bit beeinflusst das Ergebnis sofort, ganz egal ob bereits eine Wandlung läuft.

MUX4...MUX0

Mit diesen 5 Bits wird der zu messende Kanal bestimmt. Wenn man einen einfachen 1-kanaligen ADC verwendet wird einfach die entsprechende Pinnummer des Ports in die Bits 0...4 eingeschrieben (je nach Anzahl der Wandler des AVR, bei 8 AD-Kanälen halt nur 0...2).

Wenn das Register beschrieben wird, während eine Umwandlung läuft, so wird zuerst die aktuelle Umwandlung auf dem bisherigen Kanal beendet. Dies ist vor allem beim frei laufenden Betrieb zu berücksichtigen.

Eine Empfehlung ist deswegen diese, dass der frei laufende Betrieb nur bei einem einzelnen zu verwendenden Analogeingang verwendet werden sollte, wenn man sich Probleme bei der Umschalterei ersparen will.

Nutzung des ADC

Um den ADC zu aktivieren, müssen wir das ADEN-Bit im ADCSR-Register setzen. Im gleichen Schritt legen wir auch die Betriebsart fest.

Ein kleines Beispiel für den "single conversion"-Mode bei einem ATmega169 und Nutzung der internen Referenzspannung (beim '169 1,1V bei anderen AVRs auch 2,56V). D.h. das Eingangssignal darf diese Spannung nicht überschreiten, gegebenenfalls muss es mit einem Spannungsteiler verringert werden. Das Ergebnis der Routine ist der ADC-Wert, also 0 für 0-Volt und 1023 für V_ref-Volt.

In der praktischen Anwendung wird man zum Programmstart den ADC erst einmal grundlegend konfigurieren und dann auf verschiedenen Kanälen messen. Diese beiden Dinge sollte man meist trennen, denn das Einschalten des ADC und vor allem der Referenzspannung dauert ein paar Dutzend Mikrosekunden. Außerdem ist das erste Ergebnis nach dem Einschalten ungültig und muss verworfen werden.

<c>

/* ADC initialisieren */ void ADC_Init(void) {

 uint16_t result;

// ADMUX = (0<<REFS1) | (1<<REFS0); // AVcc als Referenz benutzen

 ADMUX = (1<<REFS1) | (1<<REFS0);      // interne Referenzspannung nutzen
 // Bit ADFR ("free running") in ADCSRA steht beim Einschalten
 // schon auf 0, also single conversion
 ADCSRA = (1<<ADPS1) | (1<<ADPS0);     // Frequenzvorteiler
 ADCSRA |= (1<<ADEN);                  // ADC aktivieren

 /* nach Aktivieren des ADC wird ein "Dummy-Readout" empfohlen, man liest
    also einen Wert und verwirft diesen, um den ADC "warmlaufen zu lassen" */

 ADCSRA |= (1<<ADSC);                  // eine ADC-Wandlung 
 while (ADCSRA & (1<<ADSC) ) {}        // auf Abschluss der Konvertierung warten
 /* ADCW muss einmal gelesen werden, sonst wird Ergebnis der nächsten
    Wandlung nicht übernommen. */
 result = ADCW;

}

/* ADC Einzelmessung */ uint16_t ADC_Read( uint8_t channel ) {

 // Kanal waehlen, ohne andere Bits zu beeinflußen
 ADMUX = (ADMUX & ~(0x1F)) | (channel & 0x1F);
 ADCSRA |= (1<<ADSC);            // eine Wandlung "single conversion"
 while (ADCSRA & (1<<ADSC) ) {}  // auf Abschluss der Konvertierung warten
 return ADCW;                    // ADC auslesen und zurückgeben

}

/* ADC Mehrfachmessung mit Mittelwertbbildung */ uint16_t ADC_Read_Avg( uint8_t channel, uint8_t average ) {

 uint32_t result = 0;

 for (uint8_t i = 0; i < average; ++i )
   result += ADC_Read( channel );

 return (uint16_t)( result / average );

}

...

/* Beispielaufrufe: */

int main() {

 uint16_t adcval;
 ADC_Init();

 while( 1 ) {
   adcval = ADC_Read(0);  // Kanal 0
   // mach was mit adcval

   adcval = ADC_Read_Avg(2, 4);  // Kanal 2, Mittelwert aus 4 Messungen
   // mach was mit adcval
 }

}

</c>

Im Beispiel läuft der ADC ständig. Für den Fall, dass man Strom sparen will, z.B. mittels Verwendung des Sleep Modes, muss man den ADC nach jeder Messung abschalten und vor der nächsten Messung wieder einschalten, wobei auch dann wieder eine kleine Pause und Anfangswandlung nötig sind.

Analog-Digital-Wandlung ohne internen ADC

Messen eines Widerstandes

Analoge Werte lassen sich ohne Analog-Digital-Wandler auch indirekt ermitteln. Im Folgenden wird die Messung des an einem Potentiometer eingestellten Widerstands anhand der Ladekurve eines Kondensators erläutert. Bei dieser Methode wird nur ein Portpin benötigt, ein Analog-Digital-Wandler oder Analog-Comparator ist nicht erforderlich. Es wird dazu ein Kondensator und der Widerstand (das Potentiometer) in Reihe zwischen Vorsorgungsspannung und Masse/GND geschaltet (sogen. RC-Netzwerk). Zusätzlich wird eine Verbindung der Leitung zwischen Kondensator und Potentiometer zu einem Portpin des Controllers hergestellt. Die folgende Abbildung verdeutlicht die erforderliche Schaltung.

Wird der Portpin des Controllers auf Ausgang konfiguriert (im Beispiel DDRD |= (1<<PD2)) und dieser Ausgang auf Logisch 1 ("High", PORTD |= (1<<PD2)) geschaltet, liegt an beiden "Platten" des Kondensators das gleiche Potential VCC an und der Kondensator somit entladen. (Klingt komisch, mit Vcc entladen, ist aber so, da an beiden Seiten des Kondensators das gleiche Potential anliegt und somit eine Potentialdifferenz von 0V besteht => Kondensator ist entladen).

Nach einer gewissen Zeit ist der Kondensator entladen und der Portpin wird als Eingang konfiguriert (DDRD &= ~(1<<PD2); PORTD &= ~(1<<PD2)), wodurch dieser hochohmig wird. Der Status des Eingangspin (in PIND) ist Logisch 1 (High). Der Kondensator lädt sich jetzt über das Poti auf, dabei steigt der Spannungsabfall über dem Kondensator und derjenige über dem Poti sinkt. Fällt nun der Spannungsabfall über dem Poti unter die Threshold-Spannung des Eingangspins (2/5 Vcc, also ca. 2V), wird das Eingangssignal als LOW erkannt (Bit in PIND wird 0). Die Zeitspanne zwischen der Umschaltung von Entladung auf Aufladung und dem Wechsel des Eingangssignals von High auf Low ist ein Maß für den am Potentiometer eingestellten Widerstand. Zur Zeitmessung kann einer der im Controller vorhandenen Timer genutzt werden. Der 220Ω Widerstand dient dem Schutz des Controllers. Es würde sonst bei Maximaleinstellung des Potentionmeters (hier 0Ω) ein zu hoher Strom fließen, der die Ausgangsstufe des Controllers zerstört.

Mit einem weiteren Eingangspin und ein wenig Software können wir auch eine Kalibrierung realisieren, um den Messwert in einen vernünftigen Bereich (z.B: 0...100 % oder so) umzurechnen.

ADC über Komparator

Es gibt einen weiteren Weg, eine analoge Spannung mit Hilfe des Komparators, welcher in fast jedem AVR integriert ist, zu messen. Siehe dazu auch die Application Note AVR400 von Atmel.

Dabei wird das zu messende Signal auf den invertierenden Eingang des Komparators geführt. Zusätzlich wird ein Referenzsignal an den nicht invertierenden Eingang des Komparators angeschlossen. Das Referenzsignal wird hier auch wieder über ein RC-Glied erzeugt, allerdings mit festen Werten für R und C.

Das Prinzip der Messung ist nun dem vorhergehenden recht ähnlich. Durch Anlegen eines LOW-Pegels an Pin 2 wird der Kondensator zuerst einmal entladen. Auch hier muss darauf geachtet werden, dass der Entladevorgang genügend lang dauert. Nun wird Pin 2 auf HIGH gelegt. Der Kondensator wird geladen. Wenn die Spannung über dem Kondensator die am Eingangspin anliegende Spannung erreicht hat, schaltet der Komparator durch. Die Zeit, welche benötigt wird, um den Kondensator zu laden, kann nun auch wieder als Maß für die Spannung an Pin 1 herangezogen werden.

Ich habe es mir gespart, diese Schaltung auch aufzubauen, und zwar aus mehreren Gründen:

3 Pins notwendig.
Genauigkeit vergleichbar mit einfacherer Lösung.
War einfach zu faul.

Der Vorteil dieser Schaltung liegt allerdings darin, dass damit direkt Spannungen gemessen werden können.

DAC (Digital Analog Converter)

Mit Hilfe eines Digital-Analog-Konverters (DAC) können wir nun auch Analogsignale ausgeben. Es gibt hier mehrere Verfahren.

DAC über mehrere digitale Ausgänge

Wenn wir an den Ausgängen des Controllers ein entsprechendes Widerstandsnetzwerk aufbauen haben wir die Möglichkeit, durch die Ansteuerung der Ausgänge über den Widerständen einen Addierer aufzubauen, mit dessen Hilfe wir eine dem Zahlenwert proportionale Spannung erzeugen können. Das Schaltbild dazu kann etwa so aussehen:

Es sollten selbstverständlich möglichst genaue Widerstände verwendet werden, also nicht unbedingt solche mit einer Toleranz von 10% oder mehr. Weiterhin empfiehlt es sich, je nach Anwendung den Ausgangsstrom über einen Operationsverstärker zu verstärken.

PWM (Pulsweitenmodulation)

Wir kommen nun zu einem Thema, welches in aller Munde ist, aber viele Anwender verstehen nicht ganz, wie PWM eigentlich funktioniert.

Wie wir alle wissen, ist ein Mikrocontroller ein rein digitales Bauteil. Definieren wir einen Pin als Ausgang, dann können wir diesen Ausgang entweder auf HIGH setzen, worauf am Ausgang die Versorgungsspannung Vcc anliegt, oder aber wir setzen den Ausgang auf LOW, wonach dann 0V am Ausgang liegt. Was passiert aber nun, wenn wir periodisch mit einer festen Frequenz zwischen HIGH und LOW umschalten? - Richtig, wir erhalten eine Rechteckspannung, wie die folgende Abbildung zeigt:

Diese Rechteckspannung hat nun einen arithmetischen Mittelwert, der je nach Pulsbreite kleiner oder größer ist.

Wenn wir nun diese pulsierende Ausgangsspannung noch über ein RC-Glied filtern/"glätten", dann haben wir schon eine entsprechende Gleichspannung erzeugt.

Mit den AVRs können wir direkt PWM-Signale erzeugen. Dazu dient der 16-Bit Zähler, welcher im sogenannten PWM-Modus betrieben werden kann.

Hinweis: In den folgenden Überlegungen wird als Controller der 90S2313 vorausgesetzt. Die Theorie ist bei anderen AVR-Controllern vergleichbar, die Pinbelegung allerdings nicht unbedingt, weshalb ein Blick ins entsprechende Datenblatt dringend angeraten wird.

Um den PWM-Modus zu aktivieren, müssen im Timer/Counter1 Control Register A TCCR1A die Pulsweiten-Modulatorbits PWM10 bzw. PWM11 entsprechend nachfolgender Tabelle gesetzt werden:

PWM11	PWM10	Bedeutung
0	0	PWM-Modus des Timers ist nicht aktiv
0	1	8-Bit PWM
1	0	9-Bit PWM
1	1	10-Bit PWM

Der Timer/Counter zählt nun permanent von 0 bis zur Obergrenze und wieder zurück, er wird also als sogenannter Auf-/Ab Zähler betrieben. Die Obergrenze hängt davon ab, ob wir mit 8, 9 oder 10-Bit PWM arbeiten wollen:

Auflösung	Obergrenze	Frequenz
8	255	f_TC1 / 510
9	511	f_TC1 / 1022
10	1023	f_TC1 / 2046

Zusätzlich muss mit den Bits COM1A1 und COM1A0 desselben Registers die gewünschte Ausgabeart des Signals definiert werden:

COM1A1	COM1A0	Bedeutung
0	0	Keine Wirkung, Pin wird nicht geschaltet.
0	1	Keine Wirkung, Pin wird nicht geschaltet.
1	0	Nicht invertierende PWM. Der Ausgangspin wird gelöscht beim Hochzählen und gesetzt beim Herunterzählen.
1	1	Invertierende PWM. Der Ausgangspin wird gelöscht beim Herunterzählen und gesetzt beim Hochzählen.

Der entsprechende Befehl, um beispielsweise den Timer/Counter als nicht invertierenden 10-Bit PWM zu verwenden, heißt dann:

alte Schreibweise (PWMxx wird nicht mehr akzeptiert) <c> TCCR1A = (1<<PWM11)|(1<<PWM10)|(1<<COM1A1); </c> neue Schreibweise <c> TCCR1A = (1<<WGM11)|(1<<WGM10)|(1<<COM1A1); </c>

Damit der Timer/Counter überhaupt läuft, müssen wir im Control Register B TCCR1B noch den gewünschten Takt (Vorteiler) einstellen und somit auch die Frequenz des PWM-Signals bestimmen.

CS12	CS11	CS10	Bedeutung
0	0	0	Stop. Der Timer/Counter wird gestoppt.
0	0	1	CK
0	1	0	CK / 8
0	1	1	CK / 64
1	0	0	CK / 256
1	0	1	CK / 1024
1	1	0	Externer Pin 1, negative Flanke
1	1	1	Externer Pin 1, positive Flanke

Also um einen Takt von CK / 1024 zu generieren, verwenden wir folgenden Befehl:

Jetzt muss nur noch der Vergleichswert festgelegt werden. Diesen schreiben wir in das 16-Bit Timer/Counter Output Compare Register OCR1A.

Die folgende Grafik soll den Zusammenhang zwischen dem Vergleichswert und dem generierten PWM-Signal aufzeigen.

Ach ja, fast hätte ich's vergessen. Das generierte PWM-Signal wird am Output Compare Pin OC1 des Timers ausgegeben und leider können wir deshalb auch beim AT90S2313 nur ein einzelnes PWM-Signal mit dieser Methode generieren. Andere AVR-Typen verfügen über bis zu vier PWM-Ausgänge. Zu beachten ist außerdem, das wenn der OC Pin aktiviert ist, er nichtmehr wie üblich funktioniert und z. B. nicht einfach über PINx ausgelesen werden kann.

Ein Programm, welches an einem ATmega8 den Fast-PWM Modus verwendet, den Modus 14, könnte so aussehen <C>

include <avr/io.h>

int main() {

 // OC1A auf Ausgang
 DDRB = (1 << PB1 );  //ATMega8
 // DDRD = (1 << PD5 ); //ATMega16
 //
 // Timer 1 einstellen
 //  
 // Modus 14:
 //    Fast PWM, Top von ICR1
 //
 //    WGM13    WGM12   WGM11    WGM10
 //      1        1       1        0
 //
 //    Timer Vorteiler: 1
 //     CS12     CS11    CS10
 //       0        0       1
 //
 //  Steuerung des Ausgangsport: Set at BOTTOM, Clear at match
 //     COM1A1   COM1A0
 //       1        0

 TCCR1A = (1<<COM1A1) | (1<<WGM11);
 TCCR1B = (1<<WGM13) | (1<<WGM12) | (1<<CS10);

 //  den Endwert (TOP) für den Zähler setzen
 //  der Zähler zählt bis zu diesem Wert

 ICR1 = 0x6FFF;

 // der Compare Wert
 // Wenn der Zähler diesen Wert erreicht, wird mit
 // obiger Konfiguration der OC1A Ausgang abgeschaltet
 // Sobald der Zähler wieder bei 0 startet, wird der
 // Ausgang wieder auf 1 gesetzt
 //
 // Durch Verändern dieses Wertes, werden die unterschiedlichen
 // PWM Werte eingestellt.

 OCR1A = 0x3FFF;

 while (1) {}

} </C>

**PWM-Mode Tabelle aus dem Datenblatt des ATmega8515**
Mode	WGM13	WGM12	WGM11	WGM10	Timer/Counter Mode of Operation	TOP	Update of OCR1x at	TOV1 Flag set on
0	0	0	0	0	Normal	0xFFFF	Immediate	MAX
1	0	0	0	1	PWM, Phase Correct, 8-Bit	0x00FF	TOP	BOTTOM
2	0	0	1	0	PWM, Phase Correct, 9-Bit	0x01FF	TOP	BOTTOM
3	0	0	1	1	PWM, Phase Correct, 10-Bit	0x03FF	TOP	BOTTOM
4	0	1	0	0	CTC	OCR1A	Immediate	MAX
5	0	1	0	1	Fast PWM, 8-Bit	0x00FF	BOTTOM	TOP
6	0	1	1	0	Fast PWM, 9-Bit	0x01FF	BOTTOM	TOP
7	0	1	1	1	Fast PWM, 10-Bit	0x03FF	BOTTOM	TOP
8	1	0	0	0	PWM, Phase an Frequency Correct	ICR1	BOTTOM	BOTTOM
9	1	0	0	1	PWM, Phase an Frequency Correct	OCR1A	BOTTOM	BOTTOM
10	1	0	1	0	PWM, Phase Correct	ICR1	TOP	BOTTOM
11	1	0	1	1	PWM, Phase an Frequency Correct	OCR1A	TOP	BOTTOM
12	1	1	0	0	CTC	ICR1	Immediate	MAX
13	1	1	0	1	Reserved	-	-	-
14	1	1	1	0	Fast PWM	ICR1	BOTTOM	TOP
15	1	1	1	1	Fast PWM	OCR1A	BOTTOM	TOP

Für Details der PWM-Möglichkeiten muss immer das jeweilige Datenblatt des Prozessors konsultiert werden, da sich die unterschiedlichen Prozessoren in ihren Möglichkeiten doch stark unterscheiden. Auch muss man aufpassen, welches zu setzende Bit in welchem Register ist. Auch hier kann es sein, dass gleichnamige Konfigurationsbits in unterschiedlichen Konfigurationsregistern (je nach konkretem Prozessortyp) sitzen.

Warteschleifen (delay.h)

Der Programmablauf kann verschiedene Arten von Wartefunktionen erfordern:

Warten im Sinn von Zeitvertrödeln
Warten auf einen bestimmten Zustand an den I/O-Pins
Warten auf einen bestimmten Zeitpunkt (siehe Timer)
Warten auf einen bestimmten Zählerstand (siehe Counter)

Der einfachste Fall, das Zeitvertrödeln, kann in vielen Fällen und mit großer Genauigkeit anhand der avr-libc Bibliotheksfunktionen _delay_ms() und _delay_us() erledigt werden. Die Bibliotheksfunktionen sind einfachen Zählschleifen (Warteschleifen) vorzuziehen, da leere Zählschleifen ohne besondere Vorkehrungen sonst bei eingeschalteter Optimierung vom avr-gcc-Compiler wegoptimiert werden. Weiterhin sind die Bibliotheksfunktionen bereits darauf vorbereitet, die in F_CPU definierte Taktfrequenz zu verwenden. Außerdem sind die Funktionen der Bibliothek wirklich getestet.

Einfach!? Schon, aber während gewartet wird, macht der µC nichts anderes mehr. Die Wartefunktion blockiert den Programmablauf. Möchte man einerseits warten, um z. B. eine LED blinken zu lassen und gleichzeitig andere Aktionen ausführen z. B. weitere LED bedienen, sollten die Timer/Counter des AVR verwendet werden.

Die Bibliotheksfunktionen funktionieren allerdings nur dann korrekt, wenn sie mit zur Übersetzungszeit (beim Compilieren) bekannten konstanten Werten aufgerufen werden. Der Quellcode muss mit eingeschalteter Optimierung übersetzt werden, sonst wird sehr viel Maschinencode erzeugt, und die Wartezeiten stimmen nicht mehr mit dem Parameter überein.

Abhängig von der Version der Bibliothek verhalten sich die Bibliotheksfunktionen etwas unterschiedlich.

avr-libc Versionen kleiner 1.6

Die Wartezeit der Funktion _delay_ms() ist auf 262,14ms/F_CPU (in MHz) begrenzt, d.h. bei 20 MHz kann man nur max. 13,1ms warten. Die Wartezeit der Funktion _delay_us() ist auf 768us/F_CPU (in MHz) begrenzt, d.h. bei 20 MHz kann man nur max. 38,4µs warten. Längere Wartezeiten müssen dann über einen mehrfachen Aufruf in einer Schleife gelöst werden.

Beispiel: Blinken einer LED an PORTB Pin PB0 im ca. 1s Rhythmus <c>

include <avr/io.h>
ifndef F_CPU

/* Definiere F_CPU, wenn F_CPU nicht bereits vorher definiert

  (z. B. durch Übergabe als Parameter zum Compiler innerhalb 
  des Makefiles). Zusätzlich Ausgabe einer Warnung, die auf die
  "nachträgliche" Definition hinweist */

warning "F_CPU war noch nicht definiert, wird nun mit 3686400 definiert"
define F_CPU 3686400UL /* Quarz mit 3.6864 Mhz */
endif
include <util/delay.h> /* in älteren avr-libc Versionen <avr/delay.h> */

lange, variable Verzögerungszeit, Einheit in Millisekunden

Die maximale Zeit pro Funktionsaufruf ist begrenzt auf 262.14 ms / F_CPU in MHz (im Beispiel: 262.1 / 3.6864 = max. 71 ms)

Daher wird die kleine Warteschleife mehrfach aufgerufen, um auf eine längere Wartezeit zu kommen. Die zusätzliche Prüfung der Schleifenbedingung lässt die Wartezeit geringfügig ungenau werden (macht hier vielleicht 2-3ms aus).

void long_delay(uint16_t ms) {

   for(; ms>0; ms--) _delay_ms(1);

}

int main( void ) {

   DDRB = ( 1 << PB0 );        // PB0 an PORTB als Ausgang setzen

   while( 1 )                  // Endlosschleife
   {                
       PORTB ^= ( 1 << PB0 );  // Toggle PB0 z. B. angeschlossene LED
       long_delay(1000);       // Eine Sekunde warten...
   }

   return 0;

} </c>

avr-libc Versionen ab 1.6

_delay_ms() kann mit einem Argument bis 6553,5 ms (= 6,5535 Sekunden) benutzt werden. Wird die früher gültige Grenze von 262,14 ms/F_CPU (in MHz) überschritten, so arbeitet _delay_ms() einfach etwas ungenauer und zählt nur noch mit einer Auflösung von 1/10 ms. Eine Verzögerung von 1000,10 ms ließe sich nicht mehr von einer von 1000,19 ms unterscheiden. Ein Verlust, der sich im Allgemeinen verschmerzen lässt. Dem Programmierer wird keine Rückmeldung gegeben, dass die Funktion ggf. gröber arbeitet, d.h. wenn es darauf ankommt, bitte den Parameter wie bisher geschickt wählen.

Die Funktion _delay_us() wurde ebenfalls erweitert. Wenn deren maximal als genau behandelbares Argument überschritten wird, benutzt diese intern _delay_ms(). Damit gelten in diesem Fall die _delay_ms() Einschränkungen.

Beispiel: Blinken einer LED an PORTB Pin PB0 im ca. 1s Rhythmus, avr-libc ab Version 1.6 <c>

include <avr/io.h>
ifndef F_CPU

/* Definiere F_CPU, wenn F_CPU nicht bereits vorher definiert

  (z. B. durch Übergabe als Parameter zum Compiler innerhalb 
  des Makefiles). Zusätzlich Ausgabe einer Warnung, die auf die
  "nachträgliche" Definition hinweist */

warning "F_CPU war noch nicht definiert, wird nun mit 3686400 definiert"
define F_CPU 3686400UL /* Quarz mit 3.6864 Mhz */
endif
include <util/delay.h>

int main( void ) {

   DDRB = ( 1 << PB0 );        // PB0 an PORTB als Ausgang setzen

   while( 1 ) {                // Endlosschleife
       PORTB ^= ( 1 << PB0 );  // Toggle PB0 z. B. angeschlossene LED
       _delay_ms(1000);        // Eine Sekunde +/-1/10000 Sekunde warten...
                               // funktioniert nicht mit Bibliotheken vor 1.6

   }
   return 0;

} </c>

Die _delay_ms() und die _delay_us aus avr-libc 1.7.0 sind fehlerhaft. _delay_ms () läuft 4x schneller als erwartet. Abhilfe ist eine korrigierte Includedatei: [2]

Programmieren mit Interrupts

Nachdem wir nun alles Wissenswerte für die serielle Programmerstellung gelernt haben nehmen wir jetzt ein völlig anderes Thema in Angriff, nämlich die Programmierung unter Zuhilfenahme der Interrupts des AVR.

Als erstes wollen wir uns noch einmal den allgemeinen Programmablauf bei der Interrupt-Programmierung zu Gemüte führen.

Man sieht, dass die Interruptroutine quasi parallel zum Hauptprogramm abläuft. Da wir nur eine CPU haben ist es natürlich keine echte Parallelität, sondern das Hauptprogramm wird beim Eintreffen eines Interrupts unterbrochen, die Interruptroutine wird ausgeführt und danach erst wieder zum Hauptprogramm zurückgekehrt.

Siehe auch

Anforderungen an Interrupt-Routinen

Um unliebsamen Überraschungen vorzubeugen, sollten einige Grundregeln bei der Implementierung der Interruptroutinen beachtet werden. Interruptroutinen sollten möglichst kurz und schnell abarbeitbar sein, daraus folgt:

Keine umfangreichen Berechnungen innerhalb der Interruptroutine. (*)
Keine langen Programmschleifen.
Obwohl es möglich ist, während der Abarbeitung einer Interruptroutine andere oder sogar den gleichen Interrupt wieder zuzulassen, wird davon ohne genaue Kenntnis der internen Abläufe dringend abgeraten.

Interruptroutinen (ISRs) sollten also möglichst kurz sein und keine Schleifen mit vielen Durchläufen enthalten. Längere Operationen können meist in einen "Interrupt-Teil" in einer ISR und einen "Arbeitsteil" im Hauptprogramm aufgetrennt werden. Z.B. Speichern des Zustands aller Eingänge im EEPROM in bestimmten Zeitabständen: ISR-Teil: Zeitvergleich (Timer,RTC) mit Logzeit/-intervall. Bei Übereinstimmung ein globales Flag setzen (volatile bei Flag-Deklaration nicht vergessen, s.u.). Dann im Hauptprogramm prüfen, ob das Flag gesetzt ist. Wenn ja: die Daten im EEPROM ablegen und Flag löschen.

(*) Hinweis: Es gibt allerdings die seltene Situation, dass man gerade eingelesene ADC-Werte sofort verarbeiten muss. Besonders dann, wenn man mehrere Werte sehr schnell hintereinander bekommt. Dann bleibt einem nichts anderes übrig, als die Werte noch in der ISR zu verarbeiten. Kommt aber sehr selten vor und sollte durch geeignete Wahl des Systemtaktes bzw. Auswahl des Controllers vermieden werden!

Interrupt-Quellen

Die folgenden Ereignisse können einen Interrupt auf einem AVR AT90S2313 auslösen, wobei die Reihenfolge der Auflistung auch die Priorität der Interrupts aufzeigt.

Reset
Externer Interrupt 0
Externer Interrupt 1
Timer/Counter 1 Capture Ereignis
Timer/Counter 1 Compare Match
Timer/Counter 1 Überlauf
Timer/Counter 0 Überlauf
UART Zeichen empfangen
UART Datenregister leer
UART Zeichen gesendet
Analoger Komparator

Die Anzahl der möglichen Interruptquellen variiert zwischen den verschiedenen Microcontroller-Typen. Im Zweifel hilft ein Blick ins Datenblatt ("Interrupt Vectors").

Register

Der AT90S2313 verfügt über 2 Register die mit den Interrupts zusammen hängen.

GIMSK

General Interrupt Mask Register.

Bit	7	6	5	4	3	2	1	0
Name	INT1	INT0	-	-	-	-	-	-
R/W	R/W	R/W	R	R	R	R	R	R
Initialwert	0	0	0	0	0	0	0	0

INT1 (External Interrupt Request 1 Enable)

Wenn dieses Bit gesetzt ist, wird ein Interrupt ausgelöst, wenn am INT1-Pin eine steigende oder fallende (je nach Konfiguration im MCUCR) Flanke erkannt wird.

Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

Der Interrupt wird auch ausgelöst, wenn der Pin als Ausgang geschaltet ist. Auf diese Weise bietet sich die Möglichkeit, Software-Interrupts zu realisieren.

INT0 (External Interrupt Request 0 Enable)

Wenn dieses Bit gesetzt ist, wird ein Interrupt ausgelöst, wenn am INT0-Pin eine steigende oder fallende (je nach Konfiguration im MCUCR) Flanke erkannt wird.

Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

Der Interrupt wird auch ausgelöst, wenn der Pin als Ausgang geschaltet ist. Auf diese Weise bietet sich die Möglichkeit, Software-Interrupts zu realisieren.

GIFR

General Interrupt Flag Register.

Bit	7	6	5	4	3	2	1	0
Name	INTF1	INTF0	-	-	-	-	-	-
R/W	R/W	R/W	R	R	R	R	R	R
Initialwert	0	0	0	0	0	0	0	0

INTF1 (External Interrupt Flag 1)

Dieses Bit wird gesetzt, wenn am INT1-Pin eine Interrupt-Bedingung, entsprechend der Konfiguration, als eingetreten erkannt wird. Wenn das Global Enable Interrupt Flag gesetzt ist, wird die Interruptroutine angesprungen.

Das Flag wird automatisch gelöscht, wenn die Interruptroutine beendet ist. Alternativ kann das Flag gelöscht werden, indem der Wert 1(!) eingeschrieben wird.

INTF0 (External Interrupt Flag 0)

Dieses Bit wird gesetzt, wenn am INT0-Pin eine Interrupt-Bedingung, entsprechend der Konfiguration, als eingetreten erkannt wird. Wenn das Global Enable Interrupt Flag gesetzt ist, wird die Interruptroutine angesprungen.

Das Flag wird automatisch gelöscht, wenn die Interruptroutine beendet ist. Alternativ kann das Flag gelöscht werden, indem der Wert 1(!) eingeschrieben wird.

MCUCR

MCU Control Register.

Das MCU Control Register enthält Kontrollbits für allgemeine MCU-Funktionen.

Bit	7	6	5	4	3	2	1	0
Name	-	-	SE	SM	ISC11	ISC10	ISC01	ISC00
R/W	R	R	R/W	R/W	R/W	R/W	R/W	R/W
Initialwert	0	0	0	0	0	0	0	0

SE (Sleep Enable)

Dieses Bit muss gesetzt sein, um den Controller mit dem SLEEP-Befehl in den Schlafzustand versetzen zu können.

Um den Schlafmodus nicht irrtümlich einzuschalten, wird empfohlen, das Bit erst unmittelbar vor Ausführung des SLEEP-Befehls zu setzen.

SM (Sleep Mode)

Dieses Bit bestimmt über den Schlafmodus.

Ist das Bit gelöscht, so wird der Idle-Modus ausgeführt. Ist das Bit gesetzt, so wird der Power-Down-Modus ausgeführt. (für andere AVR Controller siehe Abschnitt "Sleep-Mode")

ISC11, ISC10 (Interrupt Sense Control 1 Bits)

Diese beiden Bits bestimmen, ob die steigende oder die fallende Flanke für die Interrupterkennung am INT1-Pin ausgewertet wird.

ISC11	ISC10	Bedeutung
0	0	Low Level an INT1 erzeugt einen Interrupt. Der Interrupt wird getriggert, solange der Pin auf 0 bleibt.
0	1	Reserviert
1	0	Die fallende Flanke an INT1 erzeugt einen Interrupt.
1	1	Die steigende Flanke an INT1 erzeugt einen Interrupt.

ISC01, ISC00 (Interrupt Sense Control 0 Bits)

Diese beiden Bits bestimmen, ob die steigende oder die fallende Flanke für die Interrupterkennung am INT0-Pin ausgewertet wird.

ISC01	ISC00	Bedeutung
0	0	Low Level an INT0 erzeugt einen Interrupt. Der Interrupt wird getriggert, solange der Pin auf 0 bleibt.
0	1	Reserviert
1	0	Die fallende Flanke an INT0 erzeugt einen Interrupt.
1	1	Die steigende Flanke an INT0 erzeugt einen Interrupt.

Allgemeines über die Interrupt-Abarbeitung

Wenn ein Interrupt eintrifft, wird automatisch das Global Interrupt Enable Bit im Status Register SREG gelöscht und alle weiteren Interrupts unterbunden. Obwohl es möglich ist, zu diesem Zeitpunkt bereits wieder das GIE-bit zu setzen, wird dringend davon abgeraten. Dieses wird nämlich automatisch gesetzt, wenn die Interruptroutine beendet wird. Wenn in der Zwischenzeit weitere Interrupts eintreffen, werden die zugehörigen Interrupt-Bits gesetzt und die Interrupts bei Beendigung der laufenden Interrupt-Routine in der Reihenfolge ihrer Priorität ausgeführt. Dies kann eigentlich nur dann zu Problemen führen, wenn ein hoch priorisierter Interrupt ständig und in kurzer Folge auftritt. Dieser sperrt dann möglicherweise alle anderen Interrupts mit niedrigerer Priorität. Dies ist einer der Gründe, weshalb die Interrupt-Routinen sehr kurz gehalten werden sollen.

Interrupts mit dem AVR GCC Compiler (WinAVR)

Funktionen zur Interrupt-Verarbeitung werden in den Includedateien interrupt.h der avr-libc zur Verfügung gestellt (bei älterem Quellcode zusätzlich signal.h).

<c> // fuer sei(), cli() und ISR():

include <avr/interrupt.h>

</c>

Das Makro sei() schaltet die Interrupts ein. Eigentlich wird nichts anderes gemacht, als das Global Interrupt Enable Bit im Status Register gesetzt.

<c>

   sei();

</c>

Das Makro cli() schaltet die Interrupts aus, oder anders gesagt, das Global Interrupt Enable Bit im Status Register wird gelöscht.

<c>

   cli();

</c>

Oft steht man vor der Aufgabe, dass eine Codesequenz nicht unterbrochen werden darf. Es liegt dann nahe, zu Beginn dieser Sequenz ein cli() und am Ende ein sei() einzufügen. Dies ist jedoch ungünstig, wenn die Interrupts vor Aufruf der Sequenz deaktiviert waren und danach auch weiterhin deaktiviert bleiben sollen. Ein sei() würde ungeachtet des vorherigen Zustands die Interrupts aktivieren, was zu unerwünschten Seiteneffekten führen kann. Die aus dem folgenden Beispiel ersichtliche Vorgehensweise ist in solchen Fällen vorzuziehen:

<c>

include <avr/io.h>
include <avr/interrupt.h>
include <inttypes.h>

//...

void NichtUnterbrechenBitte(void) {

  uint8_t tmp_sreg;  // temporaerer Speicher fuer das Statusregister

  tmp_sreg = SREG;   // Statusregister (also auch das I-Flag darin) sichern
  cli();             // Interrupts global deaktivieren

  /* hier "unterbrechnungsfreier" Code */

  /* Beispiel Anfang
    JTAG-Interface eines ATmega16 per Software deaktivieren 
    und damit die JTAG-Pins an PORTC für "general I/O" nutzbar machen
    ohne die JTAG-Fuse-Bit zu aendern. Dazu ist eine "timed sequence"
    einzuhalten (vgl Datenblatt ATmega16, Stand 10/04, S. 229): 
    Das JTD-Bit muss zweimal innerhalb von 4 Taktzyklen geschrieben 
    werden. Ein Interrupt zwischen den beiden Schreibzugriffen wuerde 
    die erforderliche Sequenz "brechen", das JTAG-Interface bliebe
    weiterhin aktiv und die IO-Pins weiterhin für JTAG reserviert. */

  MCUCSR |= (1<<JTD);
  MCUCSR |= (1<<JTD); // 2 mal in Folge ,vgl. Datenblatt fuer mehr Information

  /* Beispiel Ende */
 
  SREG = tmp_sreg;     // Status-Register wieder herstellen 
                     // somit auch das I-Flag auf gesicherten Zustand setzen

}

void NichtSoGut(void) {

  cli();
  
  /* hier "unterbrechnungsfreier" Code */
  
  sei();

}

int main(void) {

  //...

  cli();  
  // Interrupts global deaktiviert

  NichtUnterbrechenBitte();
  // auch nach Aufruf der Funktion deaktiviert

  sei();
  // Interrupts global aktiviert

  NichtUnterbrechenBitte();
  // weiterhin aktiviert
  //...

  /* Verdeutlichung der unguenstigen Vorgehensweise mit cli/sei: */
  cli();  
  // Interrupts jetzt global deaktiviert

  NichtSoGut();
  // nach Aufruf der Funktion sind Interrupts global aktiviert 
  // dies ist mglw. ungewollt!
  //...

} </c>

Zu den aktivierten Interrupts ist eine Funktion zu programmieren, deren Code aufgerufen wird, wenn der betreffende Interrupt auftritt (Interrupt-Handler, Interrupt-Service-Routine). Dazu existiert die Definition (ein Makro) ISR.

ISR

(ISR() ersetzt bei neueren Versionen der avr-libc SIGNAL(). SIGNAL sollte nicht mehr genutzt werden, zur Portierung von SIGNAL nach ISR siehe den Anhang.)

<c>

include <avr/interrupt.h>

//... ISR(Vectorname) /* vormals: SIGNAL(siglabel) dabei Vectorname != siglabel ! */ {

   /* Interrupt Code */

} </c>

Mit ISR wird eine Funktion für die Bearbeitung eines Interrupts eingeleitet. Als Argument muss dabei die Benennung des entsprechenden Interruptvektors angegeben werden. Diese sind in den jeweiligen Includedateien IOxxxx.h zu finden. Die Bezeichnung entspricht dem Namen aus dem Datenblatt, bei dem die Leerzeichen durch Unterstriche ersetzt sind und ein _vect angehängt ist.

Als Beispiel ein Ausschnitt aus der Datei für den ATmega8 (bei WinAVR Standardinstallation in C:\WinAVR\avr\include\avr\iom8.h) in der neben den aktuellen Namen für ISR (*_vect) noch die Bezeichnungen für das inzwischen nicht mehr aktuelle SIGNAL (SIG_*) enthalten sind.

<c> //... /* $Id: iom8.h,v 1.13 2005/10/30 22:11:23 joerg_wunsch Exp $ */

/* avr/iom8.h - definitions for ATmega8 */ //...

/* Interrupt vectors */

/* External Interrupt Request 0 */

define INT0_vect _VECTOR(1)
define SIG_INTERRUPT0 _VECTOR(1)

/* External Interrupt Request 1 */

define INT1_vect _VECTOR(2)
define SIG_INTERRUPT1 _VECTOR(2)

/* Timer/Counter2 Compare Match */

define TIMER2_COMP_vect _VECTOR(3)
define SIG_OUTPUT_COMPARE2 _VECTOR(3)

/* Timer/Counter2 Overflow */

define TIMER2_OVF_vect _VECTOR(4)
define SIG_OVERFLOW2 _VECTOR(4)

/* Timer/Counter1 Capture Event */

define TIMER1_CAPT_vect _VECTOR(5)
define SIG_INPUT_CAPTURE1 _VECTOR(5)

/* Timer/Counter1 Compare Match A */

define TIMER1_COMPA_vect _VECTOR(6)
define SIG_OUTPUT_COMPARE1A _VECTOR(6)

/* Timer/Counter1 Compare Match B */

define TIMER1_COMPB_vect _VECTOR(7)
define SIG_OUTPUT_COMPARE1B _VECTOR(7)

//... </c>

Mögliche Funktionsrümpfe für Interruptfunktionen sind zum Beispiel:

<c>

include <avr/interrupt.h>

/* veraltet: #include <avr/signal.h> */

ISR(INT0_vect) /* veraltet: SIGNAL(SIG_INTERRUPT0) */ {

   /* Interrupt Code */

}

ISR(TIMER0_OVF_vect) /* veraltet: SIGNAL(SIG_OVERFLOW0) */ {

   /* Interrupt Code */

}

ISR(USART_RXC_vect) /* veraltet: SIGNAL(SIG_UART_RECV) */ {

   /* Interrupt Code */

}

// und so weiter und so fort... </c>

Auf die korrekte Schreibweise der Vektorbezeichnung ist zu achten. Der gcc-Compiler prüft erst ab Version 4.x, ob ein Signal/Interrupt der angegebenen Bezeichnung tatsächlich in der Includedatei definiert ist und gibt andernfalls eine Warnung aus. Bei WinAVR (ab 2/2005) wurde die Überprüfung auch in den mitgelieferten Compiler der Version 3.x integriert. Aus dem gcc-Quellcode Version 3.x selbst erstellte Compiler enthalten die Prüfung nicht (vgl. AVR-GCC).

Während der Ausführung der Funktion sind alle weiteren Interrupts automatisch gesperrt. Beim Verlassen der Funktion werden die Interrupts wieder zugelassen.

Sollte während der Abarbeitung der Interruptroutine ein weiterer Interrupt (gleiche oder andere Interruptquelle) auftreten, so wird das entsprechende Bit im zugeordneten Interrupt Flag Register gesetzt und die entsprechende Interruptroutine automatisch nach dem Beenden der aktuellen Funktion aufgerufen.

Ein Problem ergibt sich eigentlich nur dann, wenn während der Abarbeitung der aktuellen Interruptroutine mehrere gleichartige Interrupts auftreten. Die entsprechende Interruptroutine wird im Nachhinein zwar aufgerufen jedoch wissen wir nicht, ob nun der entsprechende Interrupt einmal, zweimal oder gar noch öfter aufgetreten ist. Deshalb soll hier noch einmal betont werden, dass Interruptroutinen so schnell wie nur irgend möglich wieder verlassen werden sollten.

Unterbrechbare Interruptroutinen

"Faustregel": im Zweifel ISR. Die nachfolgend beschriebene Methode nur dann verwenden, wenn man sich über die unterschiedliche Funktionsweise im Klaren ist.

<c>

include <avr/interrupt.h>

ISR(XXX,ISR_NOBLOCK) /* veraltet: INTERRUPT(SIG_OVERFLOW0) */ {

   /* Interrupt-Code */

} </c>

Hierbei steht XXX für den oben beschriebenen Namen des Vektors (also z. B. TIMER0_OVF_vect). Der Unterschied im Vergleich zu einer herkömmlichen ISR ist, dass hier beim Aufrufen der Funktion das Global Enable Interrupt Bit durch Einfügen einer SEI-Anweisung direkt wieder gesetzt und somit alle Interrupts zugelassen werden – auch XXX-Interrupts.

Bei unsachgemässer Handhabung kann dies zu erheblichen Problemen wie einem Stack-Overflow oder anderen unerwarteten Effekten führen und sollte wirklich nur dann eingesetzt werden, wenn man sich sicher ist, das Ganze auch im Griff zu haben.

Insbesondere sollte möglichst am ISR-Anfang die auslösende IRQ-Quelle deaktiviert und erst am Ende der ISR wieder aktiviert werden. Robuster als die Verwendung einer NOBLOCK-ISR ist daher folgender ISR-Aufbau:

<c>

include <avr/interrupt.h>

ISR (XXX) {

   // Implementiere die ISR ohne zunaechst weitere IRQs zuzulassen

   <<Dektiviere die XXX-IRQ>>

   // Erlaube alle Interrupts (ausser XXX)
   sei();

   //... Code ...

   // IRQs global deaktivieren um die XXX-IRQ wieder gefahrlos 
   // aktivieren zu koennen
   cli();

   <<Aktiviere die XXX-IRQ>>

} </c> Auf diese Weise kann sich die XXX-IRQ nicht selbst unterbrechen, was zu einer Art Endlosschleife führen würde.

Siehe auch: Hinweise in AVR-GCC

siehe dazu: http://www.nongnu.org/avr-libc/user-manual/group__avr__interrupts.html

Datenaustausch mit Interrupt-Routinen

Variablen, die sowohl in Interrupt-Routinen (ISR = Interrupt Service Routine(s)) als auch vom übrigen Programmcode geschrieben oder gelesen werden, müssen mit einem volatile deklariert werden. Damit wird dem Compiler mitgeteilt, dass der Inhalt der Variablen vor jedem Lesezugriff aus dem Speicher gelesen und nach jedem Schreibzugriff in den Speicher geschrieben wird. Ansonsten könnte der Compiler den Code so optimieren, dass der Wert der Variablen nur in Prozessorregistern zwischengespeichert wird, die nichts von der Änderung woanders mitbekommen.

Zur Veranschaulichung ein Codefragment für eine Tastenentprellung mit Erkennung einer "lange gedrückten" Taste.

<c>

include <avr/io.h>
include <avr/interrupt.h>
include <stdint.h>

//...

// Schwellwerte // Entprellung:

define CNTDEBOUNCE 10

// "lange gedrueckt:"

define CNTREPEAT 200

// hier z. B. Taste an Pin2 PortA "active low" = 0 wenn gedrueckt

define KEY_PIN PINA
define KEY_PINNO PA2

// beachte: volatile! volatile uint8_t gKeyCounter;

// Timer-Compare Interrupt ISR, wird z.B. alle 10ms ausgefuehrt ISR(TIMER1_COMPA_vect) {

  // hier wird gKeyCounter veraendert. Die übrigen
  // Programmteile müssen diese Aenderung "sehen":
  // volatile -> aktuellen Wert immer in den Speicher schreiben
  if ( !(KEY_PIN & (1<<KEY_PINNO)) ) {
     if (gKeyCounter < CNTREPEAT) gKeyCounter++;
  }
  else {
     gKeyCounter = 0;
  }

}

//...

int main(void) { //...

   /* hier: Initialisierung der Ports und des Timer-Interrupts */

//...

  // hier wird auf gKeyCounter zugegriffen. Dazu muss der in der
  // ISR geschriebene Wert bekannt sein:
  // volatile -> aktuellen Wert immer aus dem Speicher lesen
  if ( gKeyCounter > CNTDEBOUNCE ) { // Taste mind. 10*10 ms "prellfrei"
      if (gKeyCounter == CNTREPEAT) {
         /* hier: Code fuer "Taste lange gedrueckt" */
      }
      else {
         /* hier: Code fuer "Taste kurz gedrueckt" */
      }
  }

//... } </c>

Wird innerhalb einer ISR mehrfach auf eine mit volatile deklarierte Variable zugegriffen, wirkt sich dies ungünstig auf die Verarbeitungsgeschwindigkeit aus, da bei jedem Zugriff mit dem Speicherinhalt abgeglichen wird. Da bei AVR-Controllern innerhalb einer ISR keine Unterbrechungen zu erwarten sind, bietet es sich an, einen Zwischenspeicher in Form einer lokalen Variable zu verwenden, deren Inhalt zu Beginn und am Ende mit dem der volatile Variable synchronisiert wird. Lokale Variable werden bei eingeschalteter Optimierung mit hoher Wahrscheinlichkeit in Prozessorregistern verwaltet und der Zugriff darauf ist daher nur mit wenigen internen Operationen verbunden. Die ISR aus dem vorherigen Beispiel lässt sich so optimieren:

<c> //... ISR(TIMER1_COMPA_vect) {

  uint8_t tmp_kc;

  tmp_kc = gKeyCounter; // Uebernahme in lokale Arbeitsvariable

  if ( !(KEY_PIN & (1<<KEY_PINNO)) ) {
     if (tmp_kc < CNTREPEAT) {
        tmp_kc++;
     }
  }
  else {
     tmp_kc = 0;
  }

  gKeyCounter = tmp_kc; // Zurueckschreiben

} //... </c>

Zum Vergleich die Disassemblies (Ausschnitte der "lss-Dateien", compiliert für ATmega162) im Anschluss. Man erkennt den viermaligen Zugriff auf die Speicheraddresse von gKeyCounter (hier 0x032A) in der ISR ohne "Cache"-Variable und den zweimaligen Zugriff in der Variante mit Zwischenspeicher. Im Beispiel ist der Vorteil gering, bei komplexeren Routinen kann die Zwischenspeicherung in lokalen Variablen jedoch zu deutlicheren Verbesserungen führen.

ISR(TIMER1_COMPA_vect)
{
     86a:	1f 92       	push	r1
     86c:	0f 92       	push	r0
     86e:	0f b6       	in	r0, 0x3f	; 63
     870:	0f 92       	push	r0
     872:	11 24       	eor	r1, r1
     874:	8f 93       	push	r24
    if ( !(KEY_PIN & (1<<KEY_PINNO)) ) {
     876:	ca 99       	sbic	0x19, 2	; 25
     878:	0a c0       	rjmp	.+20     	; 0x88e <__vector_13+0x24>
      if (gKeyCounter < CNTREPEAT) gKeyCounter++;
     87a:	80 91 2a 03 	lds	r24, 0x032A
     87e:	88 3c       	cpi	r24, 0xC8	; 200 
     880:	40 f4       	brcc	.+16     	; 0x892 <__vector_13+0x28>
     882:	80 91 2a 03 	lds	r24, 0x032A
     886:	8f 5f       	subi	r24, 0xFF	; 255
     888:	80 93 2a 03 	sts	0x032A, r24
     88c:	02 c0       	rjmp	.+4      	; 0x892 <__vector_13+0x28>
   }
   else {
      gKeyCounter = 0;
     88e:	10 92 2a 03 	sts	0x032A, r1
     892:	8f 91       	pop	r24
     894:	0f 90       	pop	r0
     896:	0f be       	out	0x3f, r0	; 63
     898:	0f 90       	pop	r0
     89a:	1f 90       	pop	r1
     89c:	18 95       	reti

ISR(TIMER1_COMPA_vect)
{
     86a:	1f 92       	push	r1
     86c:	0f 92       	push	r0
     86e:	0f b6       	in	r0, 0x3f	; 63
     870:	0f 92       	push	r0
     872:	11 24       	eor	r1, r1
     874:	8f 93       	push	r24
   uint8_t tmp_kc;
 
   tmp_kc = gKeyCounter;
     876:	80 91 2a 03 	lds	r24, 0x032A
 
   if ( !(KEY_PIN & (1<<KEY_PINNO)) ) {
     87a:	ca 9b       	sbis	0x19, 2	; 25
     87c:	02 c0       	rjmp	.+4      	; 0x882 <__vector_13+0x18>
     87e:	80 e0       	ldi	r24, 0x00	; 0
     880:	03 c0       	rjmp	.+6      	; 0x888 <__vector_13+0x1e>
      if (tmp_kc < CNTREPEAT) {
     882:	88 3c       	cpi	r24, 0xC8	; 200
     884:	08 f4       	brcc	.+2      	; 0x888 <__vector_13+0x1e>
         tmp_kc++;
     886:	8f 5f       	subi	r24, 0xFF	; 255
      }
   }
   else {
      tmp_kc = 0;
   }
 
   gKeyCounter = tmp_kc;
     888:	80 93 2a 03 	sts	0x032A, r24
     88c:	8f 91       	pop	r24
     88e:	0f 90       	pop	r0
     890:	0f be       	out	0x3f, r0	; 63
     892:	0f 90       	pop	r0
     894:	1f 90       	pop	r1
     896:	18 95       	reti

volatile und Pointer

Bei volatile in Verbindung mit Pointern ist zu beachten, ob der Pointer selbst oder die Variable, auf die der Pointer zeigt, volatile ist.

<c> volatile uint8_t *a; // das Ziel von a ist volatile

uint8_t *volatile a; // a selbst ist volatile </c>

Falls der Pointer volatile ist (zweiter Fall im Beispiel), ist zu beachten, dass der Wert des Pointers, also eine Speicheradresse, intern in mehr als einem Byte verwaltet wird. Lese- und Schreibzugriffe im Hauptprogramm (außerhalb von Interrupt-Routinen) sind daher so zu implementieren, dass alle Teilbytes der Adresse konsistent bleiben, vgl. dazu den folgenden Abschnitt.

Variablen größer 1 Byte

Bei Variablen größer ein Byte, auf die in Interrupt-Routinen und im Hauptprogramm zugegriffen wird, muss darauf geachtet werden, dass die Zugriffe auf die einzelnen Bytes außerhalb der ISR nicht durch einen Interrupt unterbrochen werden. (Allgemeinplatz: AVRs sind 8-bit Controller). Zur Veranschaulichung ein Codefragment:

<c> //... volatile uint16_t gMyCounter16bit; //... ISR(...) { //...

  gMyCounter16Bit++;

//... }

int main(void) {

  uint16_t tmpCnt;

//...

  // nicht gut: Mglw. hier ein Fehler, wenn ein Byte von MyCounter 
  // schon in tmpCnt kopiert ist aber vor dem Kopieren des zweiten Bytes 
  // ein Interrupt auftritt, der den Inhalt von MyCounter verändert.
  tmpCnt = gMyCounter16bit;

  // besser: Änderungen "außerhalb" verhindern -> alle "Teilbytes"
  // bleiben konsistent
  cli();  // Interrupts deaktivieren
  tmpCnt = gMyCounter16Bit;
  sei();  // wieder aktivieren

  // oder: vorheriger Status des globalen Interrupt-Flags bleibt erhalten
  uint8_t sreg_tmp;
  sreg_tmp = SREG;    /* Sichern */
  cli()
  tmpCnt = gMyCounter16Bit;
  SREG = sreg_tmp;    /* Wiederherstellen */

  // oder: mehrfach lesen, bis man konsistente Daten hat
  uint16_t count1 = gMyCounter16Bit;
  uint16_t count2 = gMyCounter16Bit;
  while (count1 != count2) {
      count1 = count2;
      count2 = gMyCounter16Bit;
  }
  tmpCnt = count1;

//... } </c>

Die avr-libc bietet ab Version 1.6.0(?) einige Hilfsfunktionen/Makros, mit der im Beispiel oben gezeigten Funktionalität, die zusätzlich auch sogenannte memory barriers beinhalten. Diese stehen nach #include <util/atomic.h> zur Verfügung. <c> //...

include <util/atomic.h>

//...

   // analog zu cli, Zugriff, sei:
   ATOMIC_BLOCK(ATOMIC_FORCEON) {
       tmpCnt = gMyCounter16Bit;
   }

// oder:

   // analog zu Sicherung des SREG, cli, Zugriff und Zurückschreiben des SREG:
   ATOMIC_BLOCK(ATOMIC_RESTORESTATE) {
       tmpCnt = gMyCounter16Bit;
   }

//... </c>

siehe auch Dokumentation der avr-libc zu atomic.h

Interrupt-Routinen und Registerzugriffe

Falls Register sowohl im Hauptprogramm als auch in Interrupt-Routinen verändert werden, ist darauf zu achten, dass diese Zugriffe sich nicht überlappen. Nur wenige Anweisungen lassen sich in sogenannte "atomare" Zugriffe übersetzen, die nicht von Interrupt-Routinen unterbrochen werden können.

Zur Veranschaulichung eine Anweisung, bei der ein Bit und im Anschluss drei Bits in einem Register gesetzt werden:

<c>

include <avr/io.h>

int main(void) { //... PORTA |= (1<<PA0);

PORTA |= (1<<PA2)|(1<<PA3)|(1<<PA4); //... } </c>

Der Compiler übersetzt diese Anweisungen für einen ATmega128 bei Optimierungsstufe "S" nach:

...
        PORTA |= (1<<PA0);
  d2:	d8 9a       	sbi	0x1b, 0	; 27 (a)
	
        PORTA |= (1<<PA2)|(1<<PA3)|(1<<PA4);
  d4:	8b b3       	in	r24, 0x1b	; 27 (b)
  d6:	8c 61       	ori	r24, 0x1C	; 28 (c)
  d8:	8b bb       	out	0x1b, r24	; 27 (d)
...

Das Setzen des einzelnen Bits wird bei eingeschalteter Optimierung für Register im unteren Speicherbereich in eine einzige Assembler-Anweisung (sbi) übersetzt und ist nicht anfällig für Unterbrechungen durch Interrupts. Die Anweisung zum Setzen von drei Bits wird jedoch in drei abhängige Assembler-Anweisungen übersetzt und bietet damit zwei "Angriffspunkte" für Unterbrechungen. Eine Interrupt-Routine könnte nach dem Laden des Ausgangszustands in den Zwischenspeicher (hier Register 24) den Wert des Registers ändern, z. B. ein Bit löschen. Damit würde der Zwischenspeicher nicht mehr mit dem tatsächlichen Zustand übereinstimmen aber dennoch nach der Bitoperation (hier ori) in das Register zurückgeschrieben.

Beispiel: PORTA sei anfangs 0b00000000. Die erste Anweisung (a) setzt Bit 0, PORTA ist danach 0b00000001. Nun wird im ersten Teil der zweiten Anweisung der Portzustand in ein Register eingelesen (b). Unmittelbar darauf (vor (c)) "feuert" ein Interrupt, in dessen Interrupt-Routine Bit 0 von PORTA gelöscht wird. Nach Verlassen der Interrupt-Routine hat PORTA den Wert 0b00000000. In den beiden noch folgenden Anweisungen des Hauptprogramms wird nun der zwischengespeicherte "alte" Zustand 0b00000001 mit 0b00011100 logisch-oder-verknüft (c) und das Ergebnis 0b00011101 in PortA geschrieben (d). Obwohl zwischenzeitlich Bit 0 gelöscht wurde, ist es nach (d) wieder gesetzt.

Lösungsmöglichkeiten:

Register ohne besondere Vorkehrungen nicht in Interruptroutinen und im Hauptprogramm verändern.
Interrupts vor Veränderungen in Registern, die auch in ISRs verändert werden, deaktivieren ("cli").
Bits einzeln löschen oder setzen. sbi und cbi können nicht unterbrochen werden. Vorsicht: nur Register im unteren Speicherbereich sind mittels sbi/cbi ansprechbar. Der Compiler kann nur für diese sbi/cbi-Anweisungen generieren. Für Register außerhalb dieses Adressbereichs ("Memory-Mapped"-Register) werden auch zur Manipulation einzelner Bits abhängige Anweisungen erzeugt (lds,...,sts).

siehe auch: Dokumentation der avr-libc Frequently asked Questions/Fragen Nr. 1 und 8. (Stand: avr-libc Vers. 1.0.4)

Interruptflags löschen

Beim Löschen von Interruptflags haben AVRs eine Besonderheit, die auch im Datenblatt beschrieben ist: Es wird zum Löschen eine 1 in das betreffende Bit geschrieben.

Hinweis: Dazu nicht übliche bitweise VerODERung nehmen, sondern eine direkte Zuweisung machen (Erklärung).

Was macht das Hauptprogramm?

Im einfachsten (Ausnahme-)Fall gar nichts mehr. Es ist also durchaus denkbar, ein Programm zu schreiben, welches in der main-Funktion lediglich noch die Interrupts aktiviert und dann in einer Endlosschleife verharrt. Sämtliche Funktionen werden dann in den ISRs abgearbeitet. Diese Vorgehensweise ist jedoch bei den meisten Anwendungen schlecht: man verschenkt eine Verarbeitungsebene und hat außerdem möglicherweise Probleme durch Interruptroutinen, die zu viel Verarbeitungszeit benötigen.

Normalerweise wird man in den Interruptroutinen nur die bei Auftreten des jeweiligen Interruptereignisses unbedingt notwendigen Operationen ausführen lassen. Alle weniger kritischen Aufgaben werden dann im Hauptprogramm abgearbeitet.

siehe auch: Dokumentation der avr-libc Abschnitt Modules/Interrupts and Signals

Sleep-Modes

AVR Controller verfügen über eine Reihe von sogenannten Sleep-Modes ("Schlaf-Modi"). Diese ermöglichen es, Teile des Controllers abzuschalten. Zum Einen kann damit besonders bei Batteriebetrieb Strom gespart werden, zum Anderen können Komponenten des Controllers deaktiviert werden, die die Genauigkeit des Analog-Digital-Wandlers bzw. des Analog-Comparators negativ beeinflussen. Der Controller wird durch Interrupts aus dem Schlaf geweckt. Welche Interrupts den jeweiligen Schlafmodus beenden, ist einer Tabelle im Datenblatt des jeweiligen Controllers zu entnehmen. Die Funktionen (eigentlich Makros) der avr-libc stehen nach Einbinden der header-Datei sleep.h zur Verfügung.

set_sleep_mode (uint8_t mode): Setzt den Schlafmodus, der bei Aufruf von sleep() aktiviert wird. In sleep.h sind einige Konstanten definiert (z. B. SLEEP_MODE_PWR_DOWN). Die definierten Modi werden jedoch nicht alle von sämtlichten AVR-Controllern unterstützt.
sleep_enable(): Aktiviert den gesetzten Schlafmodus, versetzt den Controller aber noch nicht in den Schlafmodus
sleep_cpu(): Versetzt den Controller in den Schlafmodus .sleep_cpu wird im Prinzip durch die Assembler-Anweisung sleep ersetzt.
sleep_disable(): Deaktiviert den gesetzten Schlafmodus
sleep_mode(): Versetzt den Controller in den mit set_sleep_mode gewählten Schlafmodus. Das Makro entspricht sleep_enable()+sleep_cpu()+sleep_disable(), beinhaltet also nicht die Aktivierung von Interrupts (besser nicht benutzen).

Bei Anwendung von sleep_cpu() müssen Interrupts also bereits freigeben sein (sei()), da der Controller sonst nicht mehr "aufwachen" kann. sleep_mode() ist nicht geeignet für die Verwendung in ISR Interrupt-Service-Routinen, da bei deren Abarbeitung Interrupts global deaktiviert sind und somit auch die möglichen "Aufwachinterrupts". Abhilfe: stattdessen sleep_enable(), sei(), sleep_cpu(), sleep_disable() und evtl. cli() verwenden (vgl. Dokumentation der avr-libc).

<c>

include <avr/io.h>
include <avr/sleep.h>

int main(void) { ...

  while (1) {

...

     set_sleep_mode(SLEEP_MODE_PWR_DOWN);
     sleep_mode();
  
     // Code hier wird erst nach Auftreten eines entsprechenden
     // "Aufwach-Interrupts" verarbeitet

...

} </c>

In älteren Versionenen der avr-libc wurden nicht alle AVR-Controller durch die sleep-Funktionen richtig angesteuert. Mit avr-libc 1.2.0 wurde die Anzahl der unterstützten Typen jedoch deutlich erweitert. Bei nicht-unterstützten Typen erreicht man die gewünschte Funktionalität durch direkte "Bitmanipulation" der entsprechenden Register (vgl. Datenblatt) und Aufruf des Sleep-Befehls via Inline-Assembler oder sleep_cpu():

<c>

include <avr/io.h>

...

  // Sleep-Mode "Power-Save" beim ATmega169 "manuell" aktivieren
  SMCR = (3<<SM0) | (1<<SE);
  asm volatile ("sleep"::); // alternativ sleep_cpu() aus sleep.h

... </c>

Sleep Modi

Zu beachten ist, dass unterschiedliche Prozessoren aus der AVR Familie unterschiedliche Sleep-Modi unterstützen oder nicht unterstützen. Auskunft über die tatsächlichen Gegebenheiten gibt, wie immer, das zum Prozessor gehörende Datenblatt. Die unterschiedlichen Modi unterscheiden sich dadurch, welche Bereiche des Prozessors abgeschaltet werden. Damit korrespondiert unmittelbar welche Möglichkeiten es gibt, den Prozessor aus den jeweiligen Sleep Modus wieder aufzuwecken.

Idle Mode (SLEEP_MODE_IDLE): Die CPU kann durch SPI, USART, Analog Comperator, ADC, TWI, Timer, Watchdog und irgendeinen anderen Interrupt wieder aufgeweckt werden.

ADC Noise Reduction Mode (SLEEP_MODE_ADC): In diesem Modus liegt das Hauptaugenmerk darauf, die CPU soweit stillzulegen, dass der ADC möglichst keine Störungen aus dem inneren der CPU auffangen kann. Aufwachen aus diesem Modus kann ausgelöst werden durch den ADC, externe Interrupts, TWI, Timer und Watchdog.

Power-Down Mode (SLEEP_MODE_PWR_DOWN): In diesem Modus wird ein externer Oszillator (Quarz, Quarzoszillator) gestoppt. Geweckt werden kann die CPU durch einen externen Level Interrupt, TWI, Watchdog, Brown-Out-Reset

Power-Save-Mode (SLEEP_MODE_PWR_SAVE): Power-Save ist identisch zu Power-Down mit einer Ausnahme: Ist der Timer 2 auf die Verwendung eines externen Taktes konfiguriert, so läuft dieser Timer auch im Power-Save weiter und kann die CPU mit einem Interrupt aufwecken.

Standby-Mode (SLEEP_MODE_STANDBY, SLEEP_MODE_EXT_STANDBY): Voraussetzung für den Standby-Modus ist die Verwendung eines Quarzes oder eines Quarzoszillators (also einer externen Taktquelle). Ansonsten ist dieser Modus identisch zum Power-Down Modus. Vorteil dieses Modus ist eine kürzere Aufwachzeit.

Siehe auch:

Dokumentation der avr-libc Abschnitt Modules/Power Management and Sleep-Modes
Forenbeitrag zur "Nichtverwendung" von sleep_mode in ISRs.

Zeiger

Zeiger (engl. Pointer) sind Variablen, die die Adresse von Daten oder Funktionen enthalten und belegen 16 Bits. Die Größe hängt mit dem adressierbaren Speicherbereich zusammen und der GCC reserviert dann den entsprechenden Platz. Ggf. ist es also günstiger, Indizes auf Arrays (Listen) zu verwenden, so dass der GCC für die Zeigerarithmetik den erforderlichen RAM nur temporär benötigt.

Siehe auch: Zeiger

Speicherzugriffe

Atmel AVR-Controller verfügen typisch über drei Speicher:

RAM: Im RAM (genauer statisches RAM/SRAM) wird vom gcc-Compiler Platz für Variablen reserviert. Auch der Stack befindet sich im RAM. Dieser Speicher ist "flüchtig", d.h. der Inhalt der Variablen geht beim Ausschalten oder einem Zusammenbruch der Spannungsversorgung verloren.

Programmspeicher: Ausgeführt als FLASH-Speicher, seitenweise wiederbeschreibbar. Darin ist das Anwendungsprogramm abgelegt.

EEPROM: Nichtflüchtiger Speicher, d.h. der einmal geschriebene Inhalt bleibt auch ohne Stromversorgung erhalten. Byte-weise schreib/lesbar. Im EEPROM werden typischerweise gerätespezifische Werte wie z. B. Kalibrierungswerte von Sensoren abgelegt.

Einige AVRs besitzen keinen RAM-Speicher, lediglich die Register können als "Arbeitsvariablen" genutzt werden. Da die Anwendung des avr-gcc auf solch "kleinen" Controllern ohnehin selten sinnvoll ist und auch nur bei einigen RAM-losen Typen nach "Bastelarbeiten" möglich ist, werden diese Controller hier nicht weiter berücksichtigt. Auch EEPROM-Speicher ist nicht auf allen Typen verfügbar. Generell sollten die nachfolgenden Erläuterungen auf alle ATmega-Controller und die größeren AT90-Typen übertragbar sein. Für die Typen ATtiny2313, ATtiny26 und viele weitere der "ATtiny-Reihe" gelten die Ausführungen ebenfalls.

Siehe auch:

Binäre Daten zum Programm hinzufügen

RAM

Die Verwaltung des RAM-Speichers erfolgt durch den Compiler, im Regelfall ist beim Zugriff auf Variablen im RAM nichts Besonderes zu beachten. Die Erläuterungen in jedem brauchbaren C-Buch gelten auch für den vom avr-gcc-Compiler erzeugten Code.

Um Speicher dynamisch (während der Laufzeit) zu reservieren, kann malloc() verwendet werden. malloc(size) "alloziert" (~reserviert) einen gewissen Speicherblock mit size Bytes. Ist kein Platz für den neuen Block, wird NULL (0) zurückgegeben.

Wird der angelegte Block zu klein (groß), kann die Größe mit realloc() verändert werden. Den allozierten Speicherbereich kann man mit free() wieder freigeben. Wenn das Freigeben eines Blocks vergessen wird spricht man von einem "Speicherleck" (memory leak).

malloc() legt Speicherblöcke im Heap an, belegt man zuviel Platz, dann wächst der Heap zu weit nach oben und überschreibt den Stack, und der Controller kommt in Teufels Küche. Das kann leider nicht nur passieren wenn man insgesamt zu viel Speicher anfordert, sondern auch wenn man Blöcke unterschiedlicher Größe in ungünstiger Reihenfolge alloziert/freigibt (siehe Artikel Heap-Fragmentierung). Aus diesem Grund sollte man malloc() auf Mikrocontrollern sehr sparsam (am besten gar nicht) verwenden.

Beispiel zur Verwendung von malloc(): <c>

include <stdlib.h>

void foo(void) {

 // neuen speicherbereich anlegen,
 // platz für 10 uint16
 uint16_t* pBuffer = malloc(10 * sizeof(uint16_t));

 // darauf zugreifen, als wärs ein gewohnter Buffer
 pBuffer[2] = 5;

 // Speicher (unbedingt!) wieder freigeben
 free(pBuffer);

} </c>

Wenn (wie in obigem Beispiel) dynamischer Speicher nur für die Dauer einer Funktion benötigt und am Ende wieder freigegeben wird, bietet es sich an, statt malloc() alloca() zu verwenden. Der Unterschied zu malloc() ist, dass der Speicher auf dem Stack reserviert wird, und beim Verlassen der Funktion automatisch wieder freigegeben wird. Es kann somit kein Speicherleck und keine Fragmentierung entstehen.

siehe auch:

http://www.nongnu.org/avr-libc/user-manual/malloc.html

Programmspeicher (Flash)

Ein Zugriff auf Konstanten im Programmspeicher ist mittels avr-gcc nicht "transparent" möglich. D.h. es sind besondere Zugriffsfunktionen erforderlich, um Daten aus diesem Speicher zu lesen. Grundsätzlich basieren alle Zugriffsfunktionen auf der Assembler-Anweisung lpm (load program memory, bei AVR Controllern mit mehr als 64kB Flash auch elpm). Die Standard-Laufzeitbibliothek des avr-gcc (die avr-libc) stellt diese Funktionen nach Einbinden der Header-Datei pgmspace.h zur Verfügung. Mit diesen Funktionen können einzelne Bytes, Datenworte (16bit) und Datenblöcke gelesen werden.

Deklarationen von Variablen im Flash-Speicher werden durch das "Attribut" PROGMEM ergänzt. Lokale Variablen (eigentlich Konstanten) innerhalb von Funktionen können ebenfalls im Programmspeicher abgelegt werden. Dazu ist bei der Definition jedoch ein static voranzustellen, da solche "Variablen" nicht auf dem Stack bzw. (bei Optimierung) in Registern verwaltet werden können. Der Compiler "wirft" eine Warnung falls static fehlt.

<c>

include <stdint.h>
include <avr/pgmspace.h>

/* Byte */ const uint8_t pgmFooByte PROGMEM = 123;

/* Wort */ const uint16_t pgmFooWort PROGMEM = 12345;

/* Byte-Array */ const uint8_t pgmFooByteArray1[] PROGMEM = { 18, 3 ,70 }; const uint8_t pgmFooByteArray2[] PROGMEM = { 30, 7 ,79 };

/* Zeiger */ const uint8_t * const pgmPointerToArray1 PROGMEM = pgmFooByteArray1; const uint8_t * const pgmPointerArray[] PROGMEM = { pgmFooByteArray1, pgmFooByteArray2 };

void foo(void) {

 static const uint8_t pgmTestByteLocal PROGMEM = 0x55;
 static const char pgmTestStringLocal[] PROGMEM = "im Flash";
 // so nicht (static fehlt) 
 // char pgmTestStringLocalFalsch [] PROGMEM = "so nicht";

} </c>

Byte lesen

Mit der Funktion pgm_read_byte aus pgmspace.h erfolgt der Zugriff auf die Daten. Parameter der Funktion ist die Adresse des Bytes im Flash-Speicher.

<c>

include <avr/pgmspace.h>

const uint8_t pgmFooByte PROGMEM = 123; const uint8_t pgmFooByteArray1[] PROGMEM = { 18, 3, 70 };

void foo (void)

   // Wert der Ram-Variablen myByte auf den Wert von pgmFooByte setzen:
   uint8_t myByte;

   myByte = pgm_read_byte (&pgmFooByte);
   // myByte hat nun den Wert 123

   // Schleife ueber ein Array aus Byte-Werten im Flash
   uint8_t i;

   for (i = 0; i < 3; i++)
   {
       myByte = pgm_read_byte (&pgmFooByteArray1[i]);
       // mach was mit myByte
   }

</c>

Wort lesen

Für "einfache" 16-Bit breite Variablen erfolgt der Zugriff analog zum Byte-Beispiel, jedoch mit der Funktion pgm_read_word:

<c> const uint16_t pgmFooWort PROGMEM = 12345;

   uint16_t myWord = pgm_read_word (&pgmFooWort);

</c>

Zeiger auf Werte im Flash sind ebenfalls 16 Bits "groß". Damit ist der mögliche Speicherbereich für "Flash-Konstanten" auf 64kB begrenzt.^[3]

<c>

   const uint8_t *ptrToArray;

   ptrToArray = (const uint8_t*) pgm_read_word (&pgmPointerToArray1);
   // ptrToArray enthält nun die Startadresse des Byte-Arrays pgmFooByteArray1
   // Allerdings würde ein direkter Zugriff mit diesem Pointer (z. B. temp=*ptrToArray)
   // nicht den Inhalt von pgmFooByteArray1[0] liefern, sondern von einer Speicherstelle
   // im RAM, die die gleiche Adresse hat wie pgmFooByteArray1[0]
   // Daher muss nun die Funktion pgm_read_byte() benutzt werden, die die in ptrToArray
   // enthaltene Adresse benutzt und auf das Flash zugreift.

   for (i = 0; i < 3; i++)
   {
       myByte = pgm_read_byte (ptrToArray+i);
       // mach was mit myByte... (18, 3, 70)
   }

   ptrToArray = (const uint8_t*) pgm_read_word (&pgmPointerArray[1]);
   
   // ptrToArray enthält nun die Adresse des ersten Elements des Byte-Arrays pgmFooByteArray2
   // da im zweiten Element des Pointer-Arrays pgmPointerArray die Adresse
   // von pgmFooByteArray2 abgelegt ist

   for (i = 0; i < 3; i++)
   {
       myByte = pgm_read_byte (ptrToArray+i);
       // mach was mit myByte... (30, 7, 79)
   }

</c>

Block lesen

In den Standard-Flash Funktionen ist keine der pgm_read_xxxx Nomenklatur folgenden Funktion enthalten, die einen kompletten Block ausliest. Die enstprechende Funktion ist eine Variante von memcpy und heißt memcpy_P().

Was diese Funktion im Prinzip macht, ist einfach in einer Schleife pgm_read_byte zu benutzen, um einen Speicherblock von der Quelladresse im Flash an eine Zieladresse im SRAM zu kopieren.

<c> void pgm_read_block( uint8_t* pTarget, const uint8_t* pSource, size_t len ) {

 size_t i;

 for( i = 0; i < len; ++i )
   *pTarget++ = pgm_read_byte( pSource++ );

} </c>

Damit ist es dann natürlich kein Problem mehr ganze Arrays oder Strukturen aus dem Flash in das SRAM zu übertragen.

Strings lesen

Strings sind in C nichts anderes als eine Abfolge von Zeichen. Der prinzipielle Weg ist daher identisch zu "Bytes lesen", wobei allerdings auf die Besonderheiten von Strings wie 0-Terminierung geachtet werden muss, bzw. diese zur Steuerung einer Schleife über die Zeichen im String ausgenutzt werden kann

<c>

include <avr/io.h>
include <avr/pgmspace.h>

const char pgmString[] PROGMEM = "Hello world";

int main() {

 char c;
 const char* addr;

 addr = pgmString;
 while (c = pgm_read_byte (addr++), c != '\0')
 {
   // mach was mit c
 }

} </c>

Zur Unterstützung des Programmierers steht das Repertoir der str-Funktionen auch in jeweils eine Variante zur Verfügung, die mit dem Flash-Speicher arbeiten kann. Die Funktionsnamen tragen den Suffix _P.

<c>

include <avr/io.h>
include <avr/pgmspace.h>

const char pgmString[] PROGMEM = "Hallo world";

void foo (void) {

 char string[40];

 strcpy_P (string, pgmString);

} </c>

Float lesen

Auch um floats zu lesen gibt es ein Makro:

<c> float pgmFloatArray[3] PROGMEM = {1.1, 2.2, 3.3};

void read_float (void) {

  int i;
  float f;

  for (i=0; i<3; i++) 
  {
     // entspricht  f = pgmFloatArray[i];
     f = pgm_read_float (&pgmFloatArray[i]);
     // mach was mit f 
  }

} </c>

TODO: Beispiele für structs und pointer aus Flash auf struct im Flash (menues, state-machines etc.). Eine kleine Einleitung insbesondere auch in Bezug auf die auftretenden Schwierigkeiten liefert [3].

Array aus Strings im Flash-Speicher

Arrays aus Strings im Flash-Speicher werden in zwei Schritten angelegt: Zuerst die einzelnen Elemente des Arrays und im Anschluss ein Array, in dem die Startaddressen der Strings abgelegt werden. Zum Auslesen wird zuerst die Adresse des i-ten Elements aus dem Array im Flash-Speicher gelesen, die im Anschluss dazu genutzt wird, auf das Element (den String) selbst zuzugreifen.

<c>

include <stdint.h>
include <avr/pgmspace.h>

const char str1[] PROGMEM = "first_A"; const char str2[] PROGMEM = "second_A"; const char str3[] PROGMEM = "third_A";

const char * const strarray1[] PROGMEM = {

  str1,
  str2,
  str3

};

static char work[20];

void read_strings (void) {

   size_t i;

   for (i = 0; i < sizeof (strarray1) / sizeof (strarray1[0]); i++)
   {
       size_t j, len;

       // setze Pointer auf die Addresse des i-ten Elements des
       // Flash-Arrays (str1, str2, ...)
       const char *pstrflash = (const char*) pgm_read_word (&strarray1[i]);

       // kopiere den Inhalt der Zeichenkette von der
       // in pstrflash abgelegten Adresse in das work-Array
       // analog zu strcpy( work, strarray1[i]) wenn alles im RAM
       strcpy_P (work, pstrflash);

       // Gleichbedeutend damit:
       strcpy_P (work, (const char*) pgm_read_word (&strarray1[i]));
   
       // Zeichen-fuer-Zeichen
       len = strlen_P (&strarray1[i]);

       // <= da auch das Stringende-Zeichen kopiert werden soll
       for (j = 0; j <= len; j++)
       {
           // analog zu work[j] = strarray[i][j] wenn alles im RAM
           work[i] = (char) pgm_read_byte (pstrflash++);
       }
   }

} </c>

Siehe dazu auch die avr-libc FAQ: How do I put an array of strings completely in ROM?

Vereinfachung für Zeichenketten (Strings) im Flash

Zeichenketten können innerhalb des Quellcodes als "Flash-Konstanten" ausgewiesen werden. Dazu dient das Makro PSTR aus pgmspace.h. Dies erspart die getrennte Deklaration mit PROGMEM-Attribut.

<c>

include <string.h>
include <avr/pgmspace.h>

define MAXLEN 30

char StringImFlash[] PROGMEM = "Erwin Lindemann"; char StringImRam[MAXLEN];

void read_string (void) {

   strcpy (StringImRam, "Mueller-Luedenscheidt");

   if (!strncmp_P (StringImRam, StringImFlash, 5))
   {
       // mach was, wenn die ersten 5 Zeichen identisch - hier nicht
   }
   else
   {
       // der Code hier wuerde ausgefuehrt 
   }

   if (!strncmp_P (StringImRam, PSTR("Mueller-Schmitt"), 5))
   {
       // der Code hier wird ausgefuehrt, wenn die ersten 
       // 5 Zeichen uebereinstimmen
   }
   else 
   {
       // wird bei Nicht-Uebereinstimmung ausgefuehrt
   }

} </c>

Aber Vorsicht: Ersetzt man zum Beispiel <c> // Daten im "Flash" const char flashText[] PROGMEM = "mit[]"; </c> durch <c> // Hier wird "mit*" im RAM angelegt und flashPointer // enthaelt die Adresse const char* const flashPointer PROGMEM = "mit*"; </c> dann kann es zu Problemen kommen.

Übergibt man Zeichenketten, die im Flash abglegt sind an eine Funktion – also die Adresse des ersten Zeichens – so muss die Funktion entsprechend programmiert sein. Die Funktion selbst hat keine Möglichkeit zu unterscheiden, ob es sich um eine Flash-Adresse oder ein RAM-Adresse handelt. Die avr-libc und viele andere avr-gcc-Bibliotheken halten sich an die Konvention, dass Namen von Funktionen, die Flash-Adressen erwarten, mit dem Suffix _P versehen sind.

Eine Funktion, die einen im Flash abgelegten String z. B. an eine UART ausgibt, würde dann so aussehen:

<c> void uart_puts_p (const char *text) {

   char zeichen;

   while ((zeichen = pgm_read_byte (text)))
   {
       // so lange, wie mittels pgm_read_byte nicht das Stringende
       // gelesen wurde: gib dieses Zeichen aus

       uart_putc (Zeichen);
       text++;
   }

} </c>

Von einigen Bibliotheken werden Makros definiert, die "automatisch" ein PSTR bei Verwendung einer Funktion einfügen. Ein Blick in den Header-File der Bibliothek zeigt, ob dies der Fall ist. Ein Beispiel aus P. Fleurys lcd-Library:

<c> // Ausschnitt aus dem Header-File lcd.h der "Fleury-LCD-Lib." extern void lcd_puts_p (const char *progmem_s);

define lcd_puts_P(__s) lcd_puts_p(PSTR(__s))

// in einer Anwendung

include <avr/pgmspace.h>
include <string.h>
include "lcd.h"

const char StringImFlash[] PROGMEM = "Erwin Lindemann";

void my_write (coid) {

   lcd_puts_p (StringImFlash); 
   lcd_puts_P ("Dr. Kloebner");

}</c>

Flash in der Anwendung schreiben

Bei AVRs mit "self-programming"-Option – auch bekannt als Bootloader-Support – können Teile des Flash-Speichers vom Anwendungsprogramm beschrieben werden. Dies ist nur möglich, wenn die Schreibfunktion in einem besonderen Speicherbereich, der boot-section des Programmspeichers/Flash, abgelegt ist.

Bei einigen kleinen AVRs gibt es keine gesonderte Boot-Section, bei diesen kann der Flashspeicher von jeder Stelle des Programms geschrieben werden. Für Details sei hier auf das jeweilige Controller-Datenblatt und die Erläuterungen zum Modul boot.h der avr-libc verwiesen. Es existieren auch Application-Notes dazu bei atmel.com, die auf avr-gcc-Code übertragbar sind.

Siehe auch:

Forumsbeitrag Daten in Programmspeicher speichern

Warum so kompliziert?

Zu dem Thema, warum die Verabeitung von Werten aus dem Flash-Speicher so kompliziert ist, sei hier nur kurz erläutert: Die Harvard-Architektur des AVR weist getrennte Adressräume für Programm(Flash)- und Datenspeicher(RAM) auf. Der C-Standard und der gcc-Compiler sehen keine unterschiedlichen Adressräume vor.

Hat man zum Beispiel eine Funktion string_an_uart(const char* s) und übergibt an diese Funktion die Adresse einer Zeichenkette, z. B. 0x01fe, weiß die Funktion nicht, ob die Adresse auf den Flash-Speicher oder den/das RAM zeigt. Allein aus dem Pointer-Wert, also dem Zahlenwert, kann nicht auf den Ort der Ablage geschlossen werden.

Einige AVR-Compiler bilden die Harvard-Architektur ab, indem sie in einen Pointer nicht nur die Adresse speichern, sondern auch den Ablageort wie Flash oder RAM. In einem Aufruf einer Funktion wird dann bei Pointer-Parametern neben der Adresse auch der Speicherbereich, auf den der Pointer zeigt, übergeben. Dies hat jedoch auch Nachteile, denn bei jedem Zugriff über einen Zeiger muss zur Laufzeit entschieden werden, wie der Zugriff auszuführen ist und entsprechend länglicher und langsamer kann Code ausgeführt werden.

siehe auch: Dokumentation der avr-libc Abschnitte Modules/Program Space String Utilities und Abschnitt Modules/Bootloader Support Utilities

EEPROM

Man beachte, dass der EEPROM-Speicher nur eine begrenzte Anzahl von Schreibzugriffen zulässt. Beschreibt man eine EEPROM-Zelle öfter als die im Datenblatt zugesicherte Anzahl (typisch 100.000), wird die Funktion der Zelle nicht mehr garantiert. Dies gilt für jede einzelne Zelle. Bei geschickter Programmierung (z. B. Ring-Puffer), bei der die zu beschreibenden Zellen regelmäßig gewechselt werden, kann man eine deutlich höhere Anzahl an Schreibzugriffen, bezogen auf den Gesamtspeicher, erreichen.

Schreib- und Lesezugriffe auf den EEPROM-Speicher erfolgen über die im Modul eeprom.h definierten Funktionen. Mit diesen Funktionen können einzelne Bytes, Datenworte (16bit) und Datenblöcke geschrieben und gelesen werden.

Bei Nutzung des EEPROMs ist zu beachten, dass vor dem Zugriff auf diesen Speicher abgefragt wird, ob der Controller die vorherige EEPROM-Operation abgeschlossen hat. Die avr-libc-Funktionen beinhalten diese Prüfung, man muss sie nicht selbst implementieren. Man sollte auch verhindern, dass der Zugriff durch die Abarbeitung einer Interrupt-Routine unterbrochen wird, da bestimme Befehlsabfolgen vorgegeben sind, die innerhalb weniger Taktzyklen aufeinanderfolgen müssen ("timed sequence"). Auch dies muss bei Nutzung der Funktionen aus der avr-libc/eeprom.h-Datei nicht selbst implementiert werden. Innerhalb der Funktionen werden Interrupts vor der "EEPROM-Sequenz" global deaktiviert und im Anschluss, falls vorher auch schon eingeschaltet, wieder aktiviert.

Um eine Variable im EEPROM anzulegen, stellt die avr-libc das Makro EEMEM zur Verfügung^[4], das analog zu PROGMEM verwendet wird.

<c>

include <stdint.h>
include <avr/eeprom.h>

/* Byte */ uint8_t eeFooByte EEMEM = 123;

/* Wort */ uint16_t eeFooWord EEMEM = 12345;

/* float */ float eeFooFloat EEMEM;

/* Byte-Array */ uint8_t eeFooByteArray1[] EEMEM = { 18, 3, 70 }; uint8_t eeFooByteArray2[] EEMEM = { 30, 7, 79 };

/* 16-bit unsigned short feld */ uint16_t eeFooWordArray1[4] EEMEM; </c>

Bytes lesen/schreiben

Die avr-libc Funktion zum Lesen eines Bytes heißt eeprom_read_byte. Parameter ist die Adresse des Bytes im EEPROM. Geschrieben wird über die Funktion eeprom_write_byte mit den Parametern Adresse und Inhalt. Anwendungsbeispiel:

<c>

define EEPROM_DEF 0xFF

void eeprom_example (void) {

   uint8_t myByte;

   // myByte lesen (Wert = 123)
   myByte = eeprom_read_byte (&eeFooByte);

   // der Wert 99 wird im EEPROM an die Adresse der
   // Variablen eeFooByte geschrieben
   myByte = 99;
   eeprom_write_byte(&eeFooByte, myByte); // schreiben

   myByte = eeprom_read_byte (&eeFooByteArray1[1]); 
   // myByte hat nun den Wert 3

   // Beispiel zur "Sicherung" gegen leeres EEPROM nach "Chip Erase"
   // (z. B. wenn die .eep-Datei nach Programmierung einer neuen Version
   // des Programms nicht in den EEPROM uebertragen wurde und EESAVE
   // deaktiviert ist (unprogrammed/1)
   // 
   // Vorsicht: wenn EESAVE "programmed" ist, hilft diese Sicherung nicht
   // weiter, da die Speicheraddressen in einem neuen/erweiterten Programm
   // moeglicherweise verschoben wurden. An der Stelle &eeFooByte steht
   // dann u.U. der Wert einer anderen Variable aus einer "alten" Version.

   uint8_t fooByteDefault = 222;
   if ((myByte = eeprom_read_byte (&eeFooByte)) == EEPROM_DEF)
   {
       myByte = fooByteDefault;
   }

} </c>

Wort lesen/schreiben

Schreiben und Lesen von Datenworten erfolgt analog zur Vorgehensweise bei Bytes:

<c>

   // lesen
   uint16_t myWord = eeprom_read_word (&eeFooWord);

   // schreiben
   eeprom_write_word (&eeFooWord, 2222);

</c>

Block lesen/schreiben

Lesen und Schreiben von Datenblöcken erfolgt über die Funktionen eeprom_read_block() bzw. eeprom_write_block(). Die Funktionen erwarten drei Parameter: die Adresse der Quell- bzw. Zieldaten im RAM, die EEPROM-Addresse und die Länge des Datenblocks in Bytes als size_t. <c> uint8_t myByteBuffer[3]; uint16_t myWordBuffer[4];

void eeprom_block_example (void) {

   /* Datenblock aus EEPROM lesen  */

   /* liest 3 Bytes ab der von eeFooByteArray1 definierten EEPROM-Adresse
      in das RAM-Array myByteBuffer */
   eeprom_read_block (myByteBuffer, eeFooByteArray1, 3);

   /* dito mit etwas Absicherung betr. der Länge */
   eeprom_read_block (myByteBuffer, eeFooByteArray1, sizeof(myByteBuffer));

   /* und nun mit 16-Bit Array */
   eeprom_read_block (myWordBuffer, eeFooWordArray1, sizeof(myWordBuffer));

   /* Datenblock in EEPROM schreiben */
   eeprom_write_block (myByteBuffer, eeFooByteArray1, sizeof(myByteBuffer));
   eeprom_write_block (myWordBuffer, eeFooWordArray1, sizeof(myWordBuffer));

} </c>

Ebenso lassen sich float-Variablen lesen und schreiben:

<c>

include <avr/eeprom.h>

float eeFloat EEMEM = 12.34f;

float void eeprom_float_example (float value) {

  /* float in EEPROM schreiben */
  eeprom_write_float (&eeFloat, value);

  /* float aus EEPROM lesen */
  return  eeprom_read_float (&eeFloat);

}</c>

EEPROM-Speicherabbild in .eep-Datei

Mit den zum Compiler gehörenden Werkzeugen kann der aus den Variablendeklarationen abgeleitete EEPROM-Inhalt in eine Datei geschrieben werden. Die übliche Dateiendung ist .eep, Daten im Intel Hex-Format. Damit können Standardwerte für den EEPROM-Inhalt im Quellcode definiert werden.

Makefiles nach WinAVR/MFile-Vorlage enthalten bereits die notwendigen Einstellungen, siehe dazu die Erläuterungen im Exkurs Makefiles.

Der Inhalt der eep-Datei muss ebenfalls zum Mikrocontroller übertragen werden, wenn die Initialisierungswerte aus der Deklaration vom Programm erwartet werden. Ansonsten enthält der EEPROM-Speicher nach der Übertragung des Programmers mittels ISP abhängig von der Einstellung der EESAVE-Fuse^[5] nicht die korrekten Werte:

EESAVE = 0 (programmed): Die Daten im EEPROM bleiben erhalten. Werden sie nicht neu geschrieben, so enthält das EEPROM evtl. Daten, die nicht mehr zum Programm passen.
EESAVE = 1 (unprogrammed): Beim Programmieren werden die Daten im EEPROM gelöscht, also auf 0xff gesetzt.

Als Sicherung kann man im Programm nochmals die Standardwerte vorhalten, beim Lesen auf 0xFF prüfen und gegebenenfalls einen Standardwert nutzen.

Direkter Zugriff auf EEPROM-Adressen

Will man direkt auf bestimmte EEPROM Adressen zugreifen, dann sind folgende Funktionen hilfreich, um sich die Typecasts zu ersparen:

<c>

include <avr/eeprom.h>

// Byte aus dem EEPROM lesen uint8_t EEPReadByte(uint16_t addr) {

 return eeprom_read_byte((uint8_t *)addr);

}

// Byte in das EEPROM schreiben void EEPWriteByte(uint16_t addr, uint8_t val) {

 eeprom_write_byte((uint8_t *)addr, val);

} </c>

oder als Makro:

<c>

define EEPReadByte(addr) eeprom_read_byte((uint8_t *)addr)
define EEPWriteByte(addr, val) eeprom_write_byte((uint8_t *)addr, val)

</c>

Verwendung:

<c> EEPWriteByte(0x20, 128); // Byte an die Adresse 0x20 schreiben ... Val=EEPReadByte(0x20); // EEPROM-Wert von Adresse 0x20 lesen </c>

Bekannte Probleme bei den EEPROM-Funktionen

Vorsicht: Bei alten Versionen der avr-libc wurden nicht alle AVR Controller unterstützt. Z.B. bei der avr-libc Version 1.2.3 insbesondere bei AVRs "der neuen Generation" (ATmega48/88/168/169) funktionieren die Funktionen nicht korrekt (Ursache: unterschiedliche Speicheradressen der EEPROM-Register). In neueren Versionen (z. B. avr-libc 1.4.3 aus WinAVR 20050125) wurde die Zahl der unterstüzten Controller deutlich erweitert und eine Methode zur leichten Anpassung an zukünftige Controller eingeführt.

In jedem Datenblatt zu AVR-Controllern mit EEPROM sind kurze Beispielecodes für den Schreib- und Lesezugriff enthalten. Will oder kann man nicht auf die neue Version aktualisieren, kann der dort gezeigte Code auch mit dem avr-gcc (ohne avr-libc/eeprom.h) genutzt werden ("copy/paste", gegebenfalls Schutz vor Unterbrechnung/Interrupt ergänzen uint8_t sreg; sreg=SREG; cli(); [EEPROM-Code] ; SREG=sreg; return;, siehe Abschnitt Interrupts). Im Zweifel hilft ein Blick in den vom Compiler erzeugten Assembler-Code (lst/lss-Dateien).

siehe auch: Dokumentation der avr-libc Abschnitt Modules/EEPROM handling

EEPROM Register

Um das EEPROM anzusteuern, sind drei Register von Bedeutung:

EEAR: Hier werden die Adressen eingetragen zum Schreiben oder Lesen. Dieses Register unterteilt sich nochmal in EEARH und EEARL, da in einem 8-Bit-Register keine 512 Adressen adressiert werden können.
EEDR: Hier werden die Daten eingetragen, die geschrieben werden sollen, bzw. es enthält die gelesenen Daten.
EECR: Ist das Kontrollregister für das EEPROM

Das EECR steuert den Zugriff auf das EEPROM und ist wie folgt aufgebaut:

**Aufbau des EECR-Registers**
Bit	7	6	5	4	3	2	1	0
Name	-	-	-	-	EERIE	EEMWE	EEWE	EERE
Read/Write	R	R	R	R	R/W	R/W	R/W	R/W
Init Value	0	0	0	0	0	0	0	0

Bedeutung der Bits

Bit 4-7: nicht belegt

Bit 3 (EERIE): EEPROM Ready Interrupt Enable: Wenn das Bit gesetzt ist und globale Interrupts erlaubt sind in Register SREG (Bit 7), wird ein Interrupt ausgelöst nach Beendigung des Schreibzyklus (EEPROM Ready Interrupt). Ist einer der beiden Bits 0, wird kein Interrupt ausgelöst.

Bit 2 EEMWE): EEPROM Master Write Enable: Dieses Bit bestimmt, dass, wenn EEWE = 1 gesetzt wird (innerhalb von 4 Taktzyklen), das EEPROM beschrieben wird mit den Daten in EEDR bei Adresse EEAR. Wenn EEMWE = 0 ist und EEWE = 1 gesetzt wird, hat das keine Auswirkungen. Der Schreibvorgang wird dann nicht ausgelöst. Nach 4 Taktzyklen wird das Bit EEMWE automatisch wieder auf 0 gesetzt. Dieses Bit löst den Schreibvorgang nicht aus, es dient sozusagen als Sicherungsbit für EEWE.

Bit 1 (EEWE)

EEPROM Write Enable: Dieses Bit löst den Schreibvorgang aus, wenn es auf 1 gesetzt wird, sofern vorher EEMWE gesetzt wurde und seitdem nicht mehr als 4 Taktzyklen vergangen sind. Wenn der Schreibvorgang abgeschlossen ist, wird dieses Bit automatisch wieder auf 0 gesetzt und, sofern EERIE gesetzt ist, ein Interrupt ausgelöst. Ein Schreibvorgang sieht typischerweise wie folgt aus:

EEPROM-Bereitschaft abwarten (EEWE=0)
Adresse übergeben an EEAR
Daten übergeben an EEDR
Schreibvorgang auslösen in EECR mit Bit EEMWE=1 und EEWE=1
(Optional) Warten, bis Schreibvorgang abgeschlossen ist

Bit 0 EERE

EEPROM Read Enable: Wird dieses Bit auf 1 gesetzt wird das EEPROM an der Adresse in EEAR ausgelesen und die Daten in EEDR gespeichert. Das EEPROM kann nicht ausgelesen werden, wenn bereits eine Schreiboperation gestartet wurde. Es ist daher zu empfehlen, die Bereitschaft vorher zu prüfen. Das EEPROM ist lesebereit, wenn das Bit EEWE=0 ist. Ist der Lesevorgang abgeschlossen, wird das Bit wieder auf 0 gesetzt, und das EEPROM ist für neue Lese- und Schreibbefehle wieder bereit. Ein typischer Lesevorgang kann wie folgt aufgebaut sein:

Bereitschaft zum Lesen prüfen (EEWE=0)
Adresse übergeben an EEAR
Lesezyklus auslösen mit EERE = 1
Warten, bis Lesevorgang abgeschlossen EERE = 0
Daten abholen aus EEDR

Die Nutzung von sprintf und printf

Um komfortabel, d.h. formatiert, Ausgaben auf ein Display oder die serielle Schnittstelle zu tätigen, bieten sich sprintf oder printf an. Alle *printf-Varianten sind jedoch ziemlich speicherintensiv und der Einsatz in einem Mikrocontroller mit knappem Speicher muss sorgsam abgewogen werden.

Bei sprintf wird die Ausgabe zunächst in einem Puffer vorbereitet und anschließend mit einfachen Funktionen zeichenweise ausgegeben. Es liegt in der Verantwortung des Programmierers, genügend Platz im Puffer für die erwarteten Zeichen bereitzuhalten.

<c>

include <stdio.h>
include <stdint.h>

// ... // nicht dargestellt: Implementierung von uart_puts (vgl. Abschnitt UART) // ...

uint16_t counter;

// Ausgabe eines unsigned Integerwertes void uart_puti( uint16_t value ) {

   uint8_t puffer[20];

   sprintf( puffer, "Zählerstand: %u", value );
   uart_puts( puffer );

}

int main() {

 counter = 5;

 uart_puti( counter );
 uart_puti( 42 );

} </c>

Eine weitere elegante Möglichkeit besteht darin, den STREAM stdout (Standardausgabe) auf eine eigene Ausgabefunktion umzuleiten. Dazu wird dem Ausgabemechanismus der C-Bibliothek eine neue Ausgabefunktion bekannt gemacht, deren Aufgabe es ist, ein einzelnes Zeichen auszugeben. Wohin die Ausgabe dann tatsächlich stattfindet, ist Sache der Ausgabefunktion. Im Beispiel unten wird auf UART ausgegeben. Alle anderen, höheren Funktionen wie z. B. printf, greifen letztendlich auf diese primitive Ausgabefunktion zurück.

<c>

include <avr/io.h>
include <stdio.h>

void uart_init(void);

// a. Deklaration der primitiven Ausgabefunktion int uart_putchar(char c, FILE *stream);

// b. Umleiten der Standardausgabe stdout (Teil 1) static FILE mystdout = FDEV_SETUP_STREAM( uart_putchar, NULL, _FDEV_SETUP_WRITE );

// c. Definition der Ausgabefunktion int uart_putchar( char c, FILE *stream ) {

   if( c == '\n' )
       uart_putchar( '\r', stream );

   loop_until_bit_is_set( UCSRA, UDRE );
   UDR = c;
   return 0;

}

void uart_init(void) {

   /* hier µC spezifischen Code zur Initialisierung */
   /* des UART einfügen... s.o. im AVR-GCC-Tutorial */

   // Beispiel: 
   //
   // myAVR Board 1.5 mit externem Quarz Q1 3,6864 MHz
   // 9600 Baud 8N1

ifndef F_CPU
define F_CPU 3686400
endif
define UART_BAUD_RATE 9600

// Hilfsmakro zur UBRR-Berechnung ("Formel" laut Datenblatt)

define UART_UBRR_CALC(BAUD_,FREQ_) ((FREQ_)/((BAUD_)*16L)-1)

   UCSRB |= (1<<TXEN) | (1<<RXEN);    // UART TX und RX einschalten
   UCSRC |= (1<<URSEL)|(3<<UCSZ0);    // Asynchron 8N1 

   UBRRH = (uint8_t)( UART_UBRR_CALC( UART_BAUD_RATE, F_CPU ) >> 8 );
   UBRRL = (uint8_t)UART_UBRR_CALC( UART_BAUD_RATE, F_CPU );

}

int main(void) {

   int16_t antwort = 42;
   uart_init();

   // b. Umleiten der Standardausgabe stdout (Teil 2)
   stdout = &mystdout;

   // Anwendung
   printf( "Die Antwort ist %d.\n", antwort );
   return 0;

}

// Quelle: avr-libc-user-manual-1.4.3.pdf, S.74 // + Ergänzungen </c>

Sollen Fließkommazahlen ausgegeben werden, muss im Makefile eine andere (größere) Version der printflib eingebunden werden.

Anhang

Externe Referenzspannung des internen Analog-Digital-Wandlers

Die minimale (externe) Referenzspannung des ADC darf nicht beliebig niedrig sein, vgl. dazu das (aktuellste) Datenblatt des verwendeten Controllers. z. B. beim ATMEGA8 darf sie laut Datenblatt (S.245, Tabelle 103, Zeile "VREF") 2,0V nicht unterschreiten. HINWEIS: diese Information findet sich erst in der letzten Revision (Rev. 2486O-10/04) des Datenblatts.

Meiner eigenen Erfahrung nach kann man aber (auf eigene Gefahr und natürlich nicht für Seriengeräte) durchaus noch ein klein wenig weiter heruntergehen, bei dem von mir unter die Lupe genommenen ATMEGA8L (also die Low-Voltage-Variante) funktioniert der ADC bei 5V Betriebsspannung mit bis zu VREF=1,15V hinunter korrekt, ab 1,1V und darunter digitalisiert er jedoch nur noch Blödsinn). Ich würde sicherheitshalber nicht unter 1,5V gehen und bei niedrigeren Betriebsspannungen mag sich die Untergrenze für VREF am Pin AREF ggf. nach oben(!) verschieben.

In der letzten Revision des Datenblatts ist außerdem korrigiert, dass ADC4 und ADC5 sehr wohl 10 Bit Genauigkeit bieten (und nicht bloß 8 Bit, wie in älteren Revisionen irrtümlich angegeben.)

Anmerkungen

↑ z. B. Ponyprog, yapp, AVRStudio
↑ In Quellcodes, die für ältere Versionen des avr-gcc/der avr-libc entwickelt wurden, erfolgt der Schreibzugriff über die Funktion outp(). Aktuelle Versionen des Compilers unterstützen den Zugriff nun direkt, outp() ist nicht mehr erforderlich.
↑ Einige avr-libc/pgmspace-Funktionen ermöglichen den Lesezugriff auf den gesamten Flash-Speicher, intern via Assembler Anweisung ELPM. Die Initialisierungswerte des Speicherinhalts jenseits der 64kB-Marke müssen dann jedoch auf anderem Weg angelegt werden, d.h. nicht per PROGMEM; evtl. eigene Section und Linker-Optionen. Alt und nicht ganz korrekt: Die avr-libc pgmspace-Funktionen unterstützen nur die unteren 64kB Flash bei Controllern mit mehr als 64kB.
↑
In älteren Versionen der avr-libc ist EEMEM noch nicht vorhanden, und man kann sich folgendermassen behelfen: <c>
1. include <avr/eeprom.h>
1. ifndef EEMEM
2. define EEMEM __attribute__((section (".eeprom")))
3. endif
</c>
↑ vgl. Datenblatt Abschnitt Fuse Bits

TODO

Aktualisierung Register- und Bitbeschreibungen an aktuelle AVR
stdio.h, malloc()
"naked"-Funktionen
Übersicht zu den C bzw. GCC-predefined Makros (__DATE__, __TIME__,...)
Bootloader => erl. AVR Bootloader in C - eine einfache Anleitung

▶ Dieser Artikel

▶ Benutzer

▶ Suche

▶ Werkzeuge

AVR-GCC-Tutorial

Voraussetzungen

Vorwort

Weiterführende Kapitel

Benötigte Werkzeuge

Was tun, wenn's nicht klappt?

Erzeugen von Maschinencode

Einführungsbeispiel

Ganzzahlige (Integer) Datentypen

Bitfelder

Grundsätzlicher Programmaufbau eines µC-Programms

Sequentieller Programmablauf

Interruptgesteuerter Programmablauf

Zugriff auf Register

Schreiben in Register

Verändern von Registerinhalten

Lesen aus Registern

Warten auf einen bestimmten Zustand

16-Bit Register (ADC, ICR1, OCR1x, TCNT1, UBRR)

IO-Register als Parameter und Variablen

Zugriff auf IO-Ports

Datenrichtung bestimmen

Vordefinierte Bitnummern für I/O-Register

Digitale Signale

Ausgänge

Eingänge (Wie kommen Signale in den µC)

Signalkopplung

Interne Pull-Up Widerstände

Tasten und Schalter

(Tasten-)Entprellung

Analoge Ein- und Ausgabe

AC (Analog Comparator)

ADC (Analog Digital Converter)

Der interne ADC im AVR

Die Register des ADC

Nutzung des ADC

Analog-Digital-Wandlung ohne internen ADC

Messen eines Widerstandes

ADC über Komparator

DAC (Digital Analog Converter)

DAC über mehrere digitale Ausgänge

PWM (Pulsweitenmodulation)

Warteschleifen (delay.h)

avr-libc Versionen kleiner 1.6

avr-libc Versionen ab 1.6

Programmieren mit Interrupts

Anforderungen an Interrupt-Routinen

Interrupt-Quellen

Register

Allgemeines über die Interrupt-Abarbeitung

Interrupts mit dem AVR GCC Compiler (WinAVR)

ISR

Unterbrechbare Interruptroutinen

Datenaustausch mit Interrupt-Routinen

volatile und Pointer

Variablen größer 1 Byte

Interrupt-Routinen und Registerzugriffe

Interruptflags löschen

Was macht das Hauptprogramm?

Sleep-Modes

Sleep Modi

Zeiger

Speicherzugriffe

RAM

Programmspeicher (Flash)

Byte lesen

Wort lesen

Block lesen

Strings lesen

Float lesen

Array aus Strings im Flash-Speicher

Vereinfachung für Zeichenketten (Strings) im Flash

Flash in der Anwendung schreiben

Warum so kompliziert?

EEPROM

Bytes lesen/schreiben