Mikrocontroller.net - Benutzerbeiträge [de]

Stromversorgung für FPGAs

2016-07-05T08:49:54Z

129.247.247.238: Rechtschreibfehler

In diesem Artikel soll eine kurze Erklärung zum Entwurf von Stromversorgungen für Hochleistungs-[[FPGA]]s gegeben werden. Auch wird ein neuer Ansatz zur Messung des Frequenzgangs dargestellt und praktische Messergebnisse gezeigt.

== Problemstellung ==

FPGAs werden immer öfter Bestandteil moderner Digitalelektronik. Die Bausteine selbst werden stetig größer, schneller und leistungsstärker und somit steigt auch die Stromaufnahme. Zwar verringert sich der Leistungsbedarf pro Gatter durch bessere Technologien und kleinere Geometrien, doch steigen die Taktfrequenz und die Anzahl der Gatter pro Bauteil überproportional an. Mit steigender Schaltgeschwindigkeit wird die Stromversorgung zu einem immer kritischeren Teil des Systementwurfs. Das Stromversorgungsnetz muss eine niedrige Impedanz besitzen und über einen sehr weiten Frequenzbereich stabil arbeiten. Anderenfalls könnnen Überschwinger, Spannungseinbrüche oder Störpulse auf VCC/GND die Funktion des FPGAs beeinträchtigen.

== Breitbandentkopplung ist Teamwork ==

Der Spannungsregler muss in erster Linie die Gleichstromkomponente für das Stromversorgungsnetzwerk liefern, d.h. er muss bei maximaler Leistung und höchster Umgebungstemperatur immer noch sauber funktionieren, ohne zu überhitzen oder unzulässige Spannungseinbrüche zu produzieren. Seine Aufgabe ist es damit, auf niederfrequente Lastsprünge (im Bereich von ca. 0..30kHz) zu reagieren und diese zu kompensieren.

Im mittleren Frequenzbereich kann der Spannungsregler nicht mehr schnell genug reagieren, da er zu langsam ist. Der Strom muss dann von ausreichend großen Elektrolytkondensatoren geliefert werden. Diese Kondensatoren können bis zu Frequenzen von einigen wenigen MHz Strom liefern, darüber begrenzen der parasitäre Widerstand (ESR, engl. equivalent series resistance) bzw. die parasitäre Induktivität (ESL, engl. equivalent series inductance) die Stromlieferfähigkeit des Kondensators und machen ihn so für höheren Frequenzen im Bereich der Schaltgeschwindigkeiten von FPGAs nutzlos.

Ab diesem Punkt gewinnen die kleinen Keramikkondensatoren, typisch 10 oder 100nF an Bedeutung. Diese gibt es in kleinen [[SMD]]-Gehäusen wie 0603 und kleiner. Sie besitzen eine sehr geringe parasitäre Induktivität und können Stromspitzen im Bereich von einigen hundert MHz liefern. Damit werden sie praktisch eine niederohmige Quelle für Hochfrequenzströme.

Für sehr schnell schaltende ICs sind diese Keramikkondensatoren aber immer noch nicht ausreichend, um das Stromversorgungsnetzwerk ausreichend zu stabilisieren und von Störungen zu entkoppeln. Hier braucht man zusätzlich die Kapazität der Stromversorgungsflächen, welche in mehrlagigen Platinen durch die VCC- und Masseflächen gebildet werden. Um hier ein Maximum an Kapazität zu erreichen, sollte ein dünnes Dielektrikum mit einer hohen Dielektrizitätskonstante und niedrigen Verlusten benutzt werden. Außerdem sollte man bezüglich der Durchkontaktierung jeweils ein einziges VIA für jeden VCC/GND Pin benutzen, um die parasitären Induktivitäten zu minimieren, nicht etwa ein VIA für mehrere Pins! [[IC-Gehäuseformen#BGA | BGA-Gehäuse]] bieten zusätzlich kürzere Verbindungen vom eigentlichen IC zur Platine, sie sind aber schwieriger zu handhaben (Layout und [[SMD Löten | Löten]]).

== Der klassische Ansatz ==

Es gibt viele Theorien und Application Notes zum Thema Entkopplung von Stromversorgungen. Einige nehmen einfach die Brechstange und bauen einen Friedhof für unzählige Kondensatoren, andere sind schlauer. Es gibt auch sehr viele Simulationen zu dem Thema. Aber am Ende sind die Eigenschaften des Stromversorgungsnetzes definiert duch das Zusammenspiel von

* dem FPGA und dessen Leistungsaufnahme, welche von der Schaltfrequenz abhängt
* dem Layout der Platine mit der Platzierung der verschiedenen Kondensatoren

Eine Möglichkeit zur Messung der Qualität des Stromversorgungsnetzwerkes ist die Nutzung eines Netzwerkanalysators. Dafür benötigt man eine Platine, welche nur mit den passiven Komponenten bestückt ist. Dabei wird ein Testsignal in das Netzwerk eingespeist (meist an Stelle des Spannungsreglers) und an einer anderen Stelle gemessen (meist an Stelle der ICs). Der Netzwerkanalysator variiert dann die Frequenz und zeichnet eine Kurve des Widerstands über die Frequenz auf. Diese Methode hat einige Nachteile.

*Man braucht einen teuren Netzwerkanalysator.
*Man benötigt ein zusätzliches Board, das nur mit den Kondensatoren bestückt ist.
*Die Messung spiegelt nicht die wahren Bedingungen wieder, weil alle ICs und aktiven Teile fehlen. Außerdem sind nur Punkt zu Punkt Messungen möglich, welche das reale Verhalten nicht korrekt wiedergeben.

Die Methode in diesem Artikel versucht, die meisten Nachteile zu vermeiden.

== Ein direkter Ansatz ==

Da wir hier über FPGAs reden, haben wir die Möglichkeit, '''jede''' beliebige digitale Funktion hineinzuprogrammieren. Also sollten wir eine digitale Funktion entwerfen, welche dem schlimmstmöglichen Fall der Belastung der Stromversorgung entspricht. Aus der Theorie der linearen Netzwerke wissen wir, dass der Frequenzgang eines linearen Systems aus der Sprungantwort am Eingang und der Reaktion am Ausgang gemessen werden kann. Für das Stromversorgungsnetzwerk funktioniert das sogar wenn es nicht vollständig linear ist, da wir ja die reale Reaktion auf konstante Last und Lastsprünge messen wollen. Was ist nun der schlimmste Belastungsfall für die Stromversorgung? Da fast alle ICs auf CMOS-Technologie beruhen, wird die meiste Leistung umgesetzt, wenn Signalnetze ihren Pegel wechseln. Bei einem FPGA heißt das, dass alle [[FlipFlop]]s ihren Pegel gleichzeitig wechseln und dabei große Signalnetze treiben (parasitäre Kapazität). Also entwerfen wir die folgende Schaltung.

[[bild:Schematic.gif|thumb|left|600px|Logik für Lasttest]]
{{clear}}

Der Kern besteht aus einer Matrix aus 30x50 FlipFlops, wobei jeweils 50 FlipFlops aus einem Puffer-FlipFlop gespeist werden, um die Ausgangslast relativ niedrig zu halten und damit eine hohe Taktfrequenz zu erreichen. Um etwas kombinatorische Logik zu erzeugen und um die HDL Compiler davon abzuhalten, die FlipFlops wegzuoptimieren, verbinden wir alle FlipFlops über ein gigantisches ODER-Gatter und leiten den Ausgang auf ein IO-Pad. Dieser Ausgang wird aber nicht weiter genutzt. Dann haben wir noch einen 16-Bit Zähler und etwas Steuerlogik, welche das Toggle-FlipFlop gemäß folgender Tabelle steuert.

{| class="wikitable"
|+ '''Steuerung der Testlogik'''
|-
! sel<1> || sel<0> || Modus
|-
| 0 || 0 || inaktiv
|-
| 0 || 1 || konstante Umschaltung
|-
| 1 || 0 || Burstbetrieb
|}

== VHDL Code ==

Wenn der Code synthetisiert wird, muss die Option "remove duplicate registers" in der Synthesesoftware ausgeschaltet werden. Es sollten zwei Dateien angelegt werden, top.vhd und row.vhd.

Datei top.vhd

<syntaxhighlight lang="vhdl">
library IEEE;
use IEEE.STD_LOGIC_1164.ALL;
use IEEE.STD_LOGIC_ARITH.ALL;
use IEEE.STD_LOGIC_UNSIGNED.ALL;

entity power is
Port ( clk_in : in std_logic; -- clock input
sel : in std_logic_vector(1 downto 0); -- select modulation ON/OFF
gnd : out std_logic_vector(5 downto 0); -- artificial gnd
mod_out : out std_logic; -- modulation signal
reset : in std_logic; -- reset for DLL
dummy : out std_logic); -- dummy out, to fool the synthesizer

end power;

architecture Behavioral of power is

COMPONENT row
PORT(
clk : IN std_logic;
data : IN std_logic;
dout : OUT std_logic
);
END COMPONENT;

-- DLL (Delay Locked Loop), a Virtex primitive

component CLKDLL
port (
CLKIN : in std_logic;
CLKFB : in std_logic;
RST : in std_logic;
CLK0 : out std_logic;
CLK90 : out std_logic;
CLK180 : out std_logic;
CLK270 : out std_logic;
CLK2X : out std_logic;
CLKDV : out std_logic;
LOCKED : out std_logic);
end component;

-- BUFG (Global Clock buffer), a Virtex primitive

component BUFG
port ( I : in std_logic;
O : out std_logic);
end component;

-- IBUFG (Global Clock input buffer ), aa Virtex primitive

component IBUFG
port ( I : in std_logic;
O : out std_logic);
end component;

component SRL16 -- virtex primitive
port (
D : in std_logic;
CLK : in std_logic;
A0 : in std_logic;
A1 : in std_logic;
A2 : in std_logic;
A3 : in std_logic;
Q : out std_logic
);
end component;

constant rows: integer:=30;

type flop_array is array (rows-1 downto 0) of std_logic_vector(49 downto 0);

signal toggle : std_logic; -- a toggle flipflop
signal ff_ar : flop_array;
signal drive_ar : std_logic_vector (rows-1 downto 0); -- driver array for toggeling rows
signal dout_ar : std_logic_vector (rows-1 downto 0); -- driver array for toggeling rows
signal or_ar : std_logic_vector (rows-1 downto 0); -- driver array for toggeling rows
signal cnt : std_logic_vector (15 downto 0); -- modulation divider

signal CLKIN_w, RESET_w, CLK2X_dll, CLK2X_g, CLK4X_dll, CLK4X_g, CLK8X_dll, CLK8X_g: std_logic;
signal LOCKED2X, LOCKED2X_delay, RESET4X, RESET8X, LOCKED4X, LOCKED4X_delay, LOCKED8X : std_logic;

signal logic1,clk : std_logic;

signal clk2x,clk4x,clk8x, clkmux: std_logic;

begin

-- use two DLL to get 147 MHz

logic1<='1';

clkpad : IBUFG port map (I=>CLK_IN, O=>CLKIN_w);

dll2x : CLKDLL port map (CLKIN=>CLKIN_w, CLKFB=>CLK2X_g, RST=>RESET,
CLK0=>open, CLK90=>open, CLK180=>open, CLK270=>open,
CLK2X=>CLK2X_dll, CLKDV=>open, LOCKED=>LOCKED2X);

clk2xg : BUFG port map (I=>CLK2X_dll, O=>CLK2X_g);

rstsrl : SRL16 port map (D=>LOCKED2X, CLK=>CLK2X_g, Q=>LOCKED2X_delay,
A3=>logic1, A2=>logic1, A1=>logic1, A0=>logic1);

RESET4X <= not LOCKED2X_delay;

dll4x : CLKDLL port map (CLKIN=>CLK2X_g, CLKFB=>CLK4X_g, RST=>RESET4X,
CLK0=>open, CLK90=>open, CLK180=>open, CLK270=>open,
CLK2X=>CLK4X_dll, CLKDV=>open, LOCKED=>LOCKED4X);

clk4xg : BUFG port map (I=>CLK4X_dll, O=>CLK4X_g);

clk<=clk4x_g;

-- the toggeling array

l_rows: for i in 0 to rows-1 generate
Inst_row: row PORT MAP(
clk => clk,
data => drive_ar(i),
dout => dout_ar(i)
);
end generate;

-- combine all douts via a BIG or-gate

process(dout_ar)
variable tmp: std_logic;
begin
tmp:='0';
l_or: for i in 0 to rows-1 loop
tmp:=tmp or dout_ar(i);
end loop;
dummy<=tmp;
end process;

-- prescaler

process(clk)
begin
if clk='1' and clk'event then
cnt<=cnt+1;
end if;
end process;

-- toggle fliplop and distribution

process(clk)
begin
if clk='1' and clk'event then
case sel is
when "00" => toggle <= '0';
when "01" => toggle <= not toggle;
when "10" => if cnt(15)='1' then toggle <= not toggle; else toggle<='0'; end if;
when others => null;
end case;
drive_ar<=(others=>toggle);
end if;
end process;

gnd<=(others=>'0');
mod_out<=cnt(15);

end Behavioral;
</syntaxhighlight>

Datei row.vhd

<syntaxhighlight lang="vhdl">
library IEEE;
use IEEE.STD_LOGIC_1164.ALL;
use IEEE.STD_LOGIC_ARITH.ALL;
use IEEE.STD_LOGIC_UNSIGNED.ALL;

entity row is
Port ( clk : in std_logic;
data : in std_logic;
dout : out std_logic);
end row;

architecture Behavioral of row is

signal my_array: std_logic_vector (49 downto 0);

begin

-- generate 50 FFs with clock enable

process (clk)
begin
if clk='1' and clK'event then
my_array<=(others=>data);
end if;
end process;

-- combine all into a BIG OR

process(my_array)
variable tmp: std_logic;
begin
tmp:='0';
l: for i in 0 to 49 loop
tmp:=tmp or my_array(i);
end loop;
dout<=tmp;
end process;

end Behavioral;
</syntaxhighlight>

== Messungen ==

[[bild:Term1.gif|thumb|right|220px|Terminierung 1: 50Ω vor dem Koppelkondensator, fg = 10 Hz]]
[[bild:Term2.gif|thumb|right|220px|Terminierung 2: 50Ω nach dem Koppelkondensator, fg = 200 kHz]]

Die nachfolgenden Messungen wurden mit einem Spartan-II Demoboard von Insight Electronics durchgeführt. Es ist mit einem XC2S100-5 im PQ208 Gehäuse bestückt. Es nutzt eine Kernspannung von 2,5V und eine IO-Spannung von 3,3V. Beide Spannungen werden durch Linearregler geliefert. Ein 36.864 MHz Oszillator wurde hinzugefügt. Für die Messung wurde der Takt mittels DLL vervierfacht auf 147 MHz. Diese hohe Frequenz wurde gewählt, um die Effekte gut demonstrieren zu können. In einer praktischen Anwendung wird man diesen Test nur mit der normalen Frequenz betreiben, welche auch in der realen Anwendung genutzt wird. Das Board wird durch ein starkes Netzteil versorgt.

Die Kernspannung wird mit einem Stück Koaxialkabel vom Typ RG 174 gemessen, welches direkt an ein VCC/GND-Pin des FPGAs angelötet ist. Das [[Oszilloskop]] ist auf 50Ω Eingangsimpedanz mit AC-Kopplung geschaltet. Wir sind nicht an der absoluten Größe der Versorgungsspannung interessiert sind, nur an Wechselanteilen, welche hoffentlich deutlich kleiner sind. Mit AC-Kopplung kann man einen deutlich kleineren Messbereich für die vertikale Auflösung verwenden. Dieser Aufbau hat eine gute Abschirmung gegen Störungen und eine sehr hohe Bandbreite zur Messung der hochfrequenten Störungen.

Während der Messung wurde festgestellt, dass es zwei verschiedene [[Wellenwiderstand | Terminierungsmethoden]] in Oszilloskopen gibt. Das alte Tektronix CSA 404 mit einem 11A34 Verstärker nutzt Terminierung 1 am 50Ω Eingang. Daraus ergibt sich eine untere Grenzfrequenz des Hochpasses von ~10 Hz. Das zweite Oszilloskop, ein Tektronix TDS 3034, mit welchem die Screenshots gemacht wurden, nutz Terminierung 2, welche in einer unteren Grenzfrequenz von ~200 kHz resultiert. Das ist nicht akzeptabel für die Messung der Sprungantwort, weswegen die 1 MΩ Eingangsterminierung benutzt wurde. Das ist OK für die Messung niedriger Frequenzen (<10 MHz). Zur Messung der Hochfrequenzstörungen (Messung 4) ist die Grenzfrequenz von 200 kHz kein Problem.
{{Absatz}}

== Messung 1 - FPGA unkonfiguriert ==

Bei diesem Schritt können wir die Leistungsaufnahme in Ruhezustand messen, welche größtenteils durch Leckströme verursacht wird. Zu beachten ist auch, dass unser Oszilloskop mit Eingangsschaltung 1 viel Strom zieht (50Ω @ 2,5V = 50mA). Wir können mittles Multimeter messen, ob unsere Spannungsregler die korrekte Spannung liefern. Wir schreiben den aktuellen Stromverbrauch und Kernspannung auf. Dabei ist der Stromverbrauch der Eingangstermninierung nicht enthalten, weil für alle Messungen das zweite Oszilloskop mit Schaltung 2 verwendet wurde.

== Messung 2 - FPGA mit leerer Logik ==

Ein Design mit einer einfachen Schleife von einem Eingang auf einen Ausgang ist jetzt in das FPGA geladen. Nach der Konfiguration '''sinkt''' der Stromverbrauch, weil die Konfigurationslogik im FPGA abgeschaltet wurde, welche permanant den Konfigurationsspeicher löscht. Die Leistungsaufnahme dieser Minimalschaltung wird als Kalibrierungspunkt für alle nachfolgenden Messungen verwendet.

== Messung 3 - FPGA konfiguriert ohne schaltende Logik ==

Jetzt steigt die Leistungsaufnahme deutlich. Auf den ersten Blick ist das unerwartet, denn im FPGA werden keinerlei Signale geschaltet , die FlipFlops laden immer den gleichen Wert. Aber das ist nicht ganz korrekt. Das Taktnetzwerk läuft auf voller Leistung. Daran erkennt man, dass die Taktverteilung signifikant Leistung benötigt. Darum nutzen [[Ultra low power | stromsparende ICs]] eine saubere Methode zur [[Taktung FPGA/CPLD | Taktabschaltung (clock gating)]], um die Leitungsaufnahme zu verringern. Aber das muss auf sichere Weise erfolgen.

== Messung 4 - FPGA mit dauerhaft schaltenden Signalen ==

Jetzt starten wir ein Feurwerk! Die Stromversorgung erfährt jetzt ihren schlimmsten Albtraum. 1500 FlipFlops die gleichzeitig mit 147 MHz umschalten (togglen)
ist kein Kindergeburtstag! Schau auf den Strommesser! Das FPGA wird schnell sehr heiß. Aber was sehen wir auf dem Oszilloskop? Da die Stromaufnahme konstant ist, können wir nur Hochfrequenzstörungen durch die schaltende Logik sehen, welche durch unzureichende Entkopplung der Keramikkondensatoren verursacht werden könnte. Mit einem schnellen Oszilloskop (1GHz++) und schlechten Versorgungslagen und Keramikkondensatoren, könnte man die '''wirklich''' hochfrequenten Störungen sehen. Mit dem 1 GHz-Oszilloskop sieht man in diesem Fall aber nichts, eben weil die Kondensatoren und Stromversorgungslagen gut funktionieren. Mit langsameren Oszilloskopen (300MHz oder weniger) sieht man nur den Effekt der Kondensatoren. Hier können wir auch die Kernspannung unter Volllast messen. Aber man muss sicherstellen, die Spannung zu messen, welche wirklich am FPGA ankommt, d.h. man muss '''direkt''' an den Pins des FPGA messen, nicht irgendwo auf dem Board! Denn das Stromversorgungsnetz hat einen endlichen Widerstand, welcher einen Spannungsabfall vom Spannungsregler bis zum FPGA verursacht. In einem guten Entwurf sollte der Spannungsabfall kleiner als 1% der Nennspannung sein.

== Messung 5 - Burstbetrieb ==

Zum Schluß erreichen wir den interessantesten Punkt. Mit dem 16-Bit Zähler wird das Umschalten des FlipFlop-Arrays mit einer niedrigen Frequenz moduliert, die Modulationsfrequenz ist 1/65356 der Taktfrequenz, hier ~2,2 kHz. Das ist die Sprungfunktion, welche in den Abschnitten weiter oben genannt wurde. Und wir sehen die Reaktion des Stromversorgungsnetzes. Wenn es ideal wäre, würden wir nur eine gerade Linie auf dem Oszilloskop sehen. Aber da es numal keine Idealfälle gibt, sehen wir Überschwinger und einen verbleibenden Offset. Das nachfolgende Bild zeigt das deutlich. Der blaue Kanal ist das Modulationssignal des 16-Bit Zählers (MSB), der gelbe Kanal die Kernspannung.

<gallery widths="140">
bild:01.gif| Sprungantwort mit 10µF
bild:02.gif| Sprungantwort mit 110µF
bild:03.gif| Abschaltflanke 10µF
bild:04.gif| Abschaltflanke 110µF
bild:05.gif| Zoom, Abschaltflanke 110µF
bild:06.gif| Anschaltflanke 10µF
bild:07.gif| Anschaltflanke 110µF
bild:08.gif| Zoom, Anschaltflanke 110µF
</gallery>

== Erklärung ==

Der Unterschwinger beim Einschalten wird durch die unzureichende Entkopplung im mittleren Frequenzbereich verursacht. Der sprunghaft steigende Stromverbrauch kann nicht von den Mittelfrequenz-Kondensatoren geliefert werden (zu wenig Kapazität), auch nicht vom Spannungsregler (er ist zu langsam dafür). Das originale Demoboard ist nur mit einem 10µF Tantalkondensator hinter dem Spannungsregler bestückt, welcher für so eine große Last viel zu klein ist. Durch Ergänzung eines 100µF Kondensatores kann der Unterschwinger deutlich verkleinert werden.

Der Überschwinger beim Abschalten ist ähnlich, aber hier ist der Spannungsregler zu langsam, um den Ausgangsstrom herunterzuregeln. Der überschüssige Strom (Ladung) wird in den Mittelfrequenz-Kondensatoren gespeichert, aber da dieser nur 10µF hat, steigt die Spannung schnell an. Ein einfacher Vergleich. Es ist genauso wie wenn man mit einem kleinen Fass das Regenwasser von einem großen Dach auffangen will, das Faß füllt sich schnell.

Was verursacht den verbliebenden Offset? Nun, das ist der Gleichstromwiderstand des Stromversorgungsnetzwerks vom Spannungsregler (wo dieser die Ausgangsspanung misst und regelt) bis zum VCC-Pin des FPGAs. Die Stromaufnahme des FPGAs schwankt zwischen Messung 3 (kein Umschalten) und Messung 4 (konstantes Umschalten). Auf dem Oszilloskop sehen wir eine Spannungsdifferenz von ~70mV bei einer Stromdifferenz von 912 mA, woraus ca. 76mΩ Widerstand resultieren. Die Schlußfolgerung daraus ist, dass die Verbindung zwischen dem Punkt der Spannungsmessung durch den Spannungsregler und den VCC-Pins einen möglichst niedrigen Widerstand haben muss. Das beste sind komplette Lagen für die Stromversorgung (Power Planes), aber kurze, dicke Leitungen sind meist auch OK. Es gibt auch Spannungsregler mit extra Messeingängen, welche den Spannungsabfall über der Zuleitung kompensieren können, weil sie direkt am Verbraucher die Spannung messen. Als weitere Möglichkeit werden heutzutage meist sog. Point of Load Module eingesetzt. Das sind Spannungsregler (Schaltregler), welche direkt am zu versorgenden FPGA sitzen und mit einer hohen Spannung von 5..48V über das Board versorgt werden.

{| class="wikitable"
|+ '''Messergebnisse'''
|-
! Messung || FPGA-Inhalt || Icc [mA] || Vcc [V] || P [mW]
|-
| 1 || keine Konfiguration || 80 || 2.501 || 200
|-
| 2 || Minimallogik || 40 || 2.502 || 100
|-
| 3 || Testlogik, inaktiv || 235 || 2.487 || 584
|-
| 4 || Testlogik, konstantes Umschalten || 1147 || 2.433 || 2790
|-
| 5 || Testlogik, Burstbetrieb || 690 || 2.464 || 1700
|}

== Zusammenfassung ==

In diesem Artikel wurde eine einfache aber leistungsfähige Methode zur Messung des Frequenzgangs des Stromversorgungsnetzwerks für FPGAs gezeigt. Die Messung kann deutlich einfacher und mit leicht verfügbaren Messgeräten unter realistischeren Bedingungen durchgeführt werden als eine klassische Messung mit einem Netzwerkanalysator. Es läßt viel Raum für Experimente mit der Entkopplung der Stromversorgung in Bezug auf die Platzierung und Werte der Kondensatoren.

== Weblinks ==

*[http://processors.wiki.ti.com/index.php/General_hardware_design/BGA_PCB_design/BGA_decoupling General hardware design/BGA PCB design/BGA decoupling, Texas Instruments (engl.)]
*[http://www.signalintegrity.com/Pubs/pubsKeyword.htm#power%20system Signal integrity of power systems] by Howard Johnson (engl.)

[[Kategorie:Spannungsversorgung und Energiequellen]]
[[Kategorie:FPGA und Co]]
[[Kategorie:VHDL]]

Stromversorgung für FPGAs

2016-07-05T08:48:26Z

129.247.247.238: Rechtschreibfehler

In diesem Artikel soll eine kurze Erklärung zum Entwurf von Stromversorgungen für Hochleistungs-[[FPGA]]s gegeben werden. Auch wird ein neuer Ansatz zur Messung des Frequenzgangs dargestellt und praktische Messergebnisse gezeigt.

== Problemstellung ==

FPGAs werden immer öfter Bestandteil moderner Digitalelektronik. Die Bausteine selbst werden stetig größer, schneller und leistungsstärker und somit steigt auch die Stromaufnahme. Zwar verringert sich der Leistungsbedarf pro Gatter durch bessere Technologien und kleinere Geometrien, doch steigen die Taktfrequenz und die Anzahl der Gatter pro Bauteil überproportional an. Mit steigender Schaltgeschwindigkeit wird die Stromversorgung zu einem immer kritischeren Teil des Systementwurfs. Das Stromversorgungsnetz muss eine niedrige Impedanz besitzen und über einen sehr weiten Frequenzbereich stabil arbeiten. Anderenfalls könnnen Überschwinger, Spannungseinbrüche oder Störpulse auf VCC/GND die Funktion des FPGAs beeinträchtigen.

== Breitbandentkopplung ist Teamwork ==

Der Spannungsregler muss in erster Linie die Gleichstromkomponente für das Stromversorgungsnetzwerk liefern, d.h. er muss bei maximaler Leistung und höchster Umgebungstemperatur immer noch sauber funktionieren, ohne zu überhitzen oder unzulässige Spannungseinbrüche zu produzieren. Seine Aufgabe ist es damit, auf niederfrequente Lastsprünge (im Bereich von ca. 0..30kHz) zu reagieren und diese zu kompensieren.

Im mittleren Frequenzbereich kann der Spannungsregler nicht mehr schnell genug reagieren, da er zu langsam ist. Der Strom muss dann von ausreichend großen Elektrolytkondensatoren geliefert werden. Diese Kondensatoren können bis zu Frequenzen von einigen wenigen MHz Strom liefern, darüber begrenzen der parasitäre Widerstand (ESR, engl. equivalent series resistance) bzw. die parasitäre Induktivität (ESL, engl. equivalent series inductance) die Stromlieferfähigkeit des Kondensators und machen ihn so für höheren Frequenzen im Bereich der Schaltgeschwindigkeiten von FPGAs nutzlos.

Ab diesem Punkt gewinnen die kleinen Keramikkondensatoren, typisch 10 oder 100nF an Bedeutung. Diese gibt es in kleinen [[SMD]]-Gehäusen wie 0603 und kleiner. Sie besitzen eine sehr geringe parasitäre Induktivität und können Stromspitzen im Bereich von einigen hundert MHz liefern. Damit werden sie praktisch eine niederohmige Quelle für Hochfrequenzströme.

Für sehr schnell schaltende ICs sind diese Keramikkondensatoren aber immer noch nicht ausreichend, um das Stromversorgungsnetzwerk ausreichend zu stabilisieren und von Störungen zu entkoppeln. Hier braucht man zusätzlich die Kapazität der Stromversorgungsflächen, welche in mehrlagigen Platinen durch die VCC- und Masseflächen gebildet werden. Um hier ein Maximum an Kapazität zu erreichen, sollte ein dünnes Dielektrikum mit einer hohen Dielektrizitätskonstante und niedrigen Verlusten benutzt werden. Außerdem sollte man bezüglich der Durchkontaktierung jeweils ein einziges VIA für jeden VCC/GND Pin benutzen, um die parasitären Induktivitäten zu minimieren, nicht etwa ein VIA für mehrere Pins! [[IC-Gehäuseformen#BGA | BGA-Gehäuse]] bieten zusätzlich kürzere Verbindungen vom eigentlichen IC zur Platine, sie sind aber schwieriger zu handhaben (Layout und [[SMD Löten | Löten]]).

== Der klassische Ansatz ==

Es gibt viele Theorien und Application Notes zum Thema Entkopplung von Stromversorgungen. Einige nehmen einfach die Brechstange und bauen einen Friedhof für unzählige Kondensatoren, andere sind schlauer. Es gibt auch sehr viele Simulationen zu dem Thema. Aber am Ende sind die Eigenschaften des Stromversorgungsnetzes definiert duch das Zusammenspiel von

* dem FPGA und dessen Leistungsaufnahme, welche von der Schaltfrequenz abhängt
* dem Layout der Platine mit der Platzierung der verschiedenen Kondensatoren

Eine Möglichkeit zur Messung der Qualität des Stromversorgungsnetzwerkes ist die Nutzung eines Netzwerkanalysators. Dafür benötigt man eine Platine, welche nur mit den passiven Komponenten bestückt ist. Dabei wird ein Testsignal in das Netzwerk eingespeist (meist an Stelle des Spannungsreglers) und an einer anderen Stelle gemessen (meist an Stelle der ICs). Der Netzwerkanalysator variiert dann die Frequenz und zeichnet eine Kurve des Widerstands über die Frequenz auf. Diese Methode hat einige Nachteile.

*Man braucht einen teuren Netzwerkanalysator.
*Man benötigt ein zusätzliches Board, das nur mit den Kondensatoren bestückt ist.
*Die Messung spiegelt nicht die wahren Bedingungen wieder, weil alle ICs und aktiven Teile fehlen. Außerdem sind nur Punkt zu Punkt Messungen möglich, welche das reale Verhalten nicht korrekt wiedergeben.

Die Methode in diesem Artikel versucht, die meisten Nachteile zu vermeiden.

== Ein direkter Ansatz ==

Da wir hier über FPGAs reden, haben wir die Möglichkeit, '''jede''' beliebige digitale Funktion hineinzuprogrammieren. Also sollten wir eine digitale Funktion entwerfen, welche dem schlimmstmöglichen Fall der Belastung der Stromversorgung entspricht. Aus der Theorie der linearen Netzwerke wissen wir, dass der Frequenzgang eines linearen Systems aus der Sprungantwort am Eingang und der Reaktion am Ausgang gemessen werden kann. Für das Stromversorgungsnetzwerk funktioniert das sogar wenn es nicht vollständig linear ist, da wir ja die reale Reaktion auf konstante Last und Lastsprünge messen wollen. Was ist nun der schlimmste Belastungsfall für die Stromversorgung? Da fast alle ICs auf CMOS-Technologie beruhen, wird die meiste Leistung umgesetzt, wenn Signalnetze ihren Pegel wechseln. Bei einem FPGA heißt das, dass alle [[FlipFlop]]s ihren Pegel gleichzeitig wechseln und dabei große Signalnetze treiben (parasitäre Kapazität). Also entwerfen wir die folgende Schaltung.

[[bild:Schematic.gif|thumb|left|600px|Logik für Lasttest]]
{{clear}}

Der Kern besteht aus einer Matrix aus 30x50 FlipFlops, wobei jeweils 50 FlipFlops aus einem Puffer-FlipFlop gespeist werden, um die Ausgangslast relativ niedrig zu halten und damit eine hohe Taktfrequenz zu erreichen. Um etwas kombinatorische Logik zu erzeugen und um die HDL Compiler davon abzuhalten, die FlipFlops wegzuoptimieren, verbinden wir alle FlipFlops über ein gigantisches ODER-Gatter und leiten den Ausgang auf ein IO-Pad. Dieser Ausgang wird aber nicht weiter genutzt. Dann haben wir noch einen 16-Bit Zähler und etwas Steuerlogik, welche das Toggle-FlipFlop gemäß folgender Tabelle steuert.

{| class="wikitable"
|+ '''Steuerung der Testlogik'''
|-
! sel<1> || sel<0> || Modus
|-
| 0 || 0 || inaktiv
|-
| 0 || 1 || konstante Umschaltung
|-
| 1 || 0 || Burstbetrieb
|}

== VHDL Code ==

Wenn der Code synthetisiert wird, muss die Option "remove duplicate registers" in der Synthesesoftware ausgeschaltet werden. Es sollten zwei Dateien angelegt werden, top.vhd und row.vhd.

Datei top.vhd

<syntaxhighlight lang="vhdl">
library IEEE;
use IEEE.STD_LOGIC_1164.ALL;
use IEEE.STD_LOGIC_ARITH.ALL;
use IEEE.STD_LOGIC_UNSIGNED.ALL;

entity power is
Port ( clk_in : in std_logic; -- clock input
sel : in std_logic_vector(1 downto 0); -- select modulation ON/OFF
gnd : out std_logic_vector(5 downto 0); -- artificial gnd
mod_out : out std_logic; -- modulation signal
reset : in std_logic; -- reset for DLL
dummy : out std_logic); -- dummy out, to fool the synthesizer

end power;

architecture Behavioral of power is

COMPONENT row
PORT(
clk : IN std_logic;
data : IN std_logic;
dout : OUT std_logic
);
END COMPONENT;

-- DLL (Delay Locked Loop), a Virtex primitive

component CLKDLL
port (
CLKIN : in std_logic;
CLKFB : in std_logic;
RST : in std_logic;
CLK0 : out std_logic;
CLK90 : out std_logic;
CLK180 : out std_logic;
CLK270 : out std_logic;
CLK2X : out std_logic;
CLKDV : out std_logic;
LOCKED : out std_logic);
end component;

-- BUFG (Global Clock buffer), a Virtex primitive

component BUFG
port ( I : in std_logic;
O : out std_logic);
end component;

-- IBUFG (Global Clock input buffer ), aa Virtex primitive

component IBUFG
port ( I : in std_logic;
O : out std_logic);
end component;

component SRL16 -- virtex primitive
port (
D : in std_logic;
CLK : in std_logic;
A0 : in std_logic;
A1 : in std_logic;
A2 : in std_logic;
A3 : in std_logic;
Q : out std_logic
);
end component;

constant rows: integer:=30;

type flop_array is array (rows-1 downto 0) of std_logic_vector(49 downto 0);

signal toggle : std_logic; -- a toggle flipflop
signal ff_ar : flop_array;
signal drive_ar : std_logic_vector (rows-1 downto 0); -- driver array for toggeling rows
signal dout_ar : std_logic_vector (rows-1 downto 0); -- driver array for toggeling rows
signal or_ar : std_logic_vector (rows-1 downto 0); -- driver array for toggeling rows
signal cnt : std_logic_vector (15 downto 0); -- modulation divider

signal CLKIN_w, RESET_w, CLK2X_dll, CLK2X_g, CLK4X_dll, CLK4X_g, CLK8X_dll, CLK8X_g: std_logic;
signal LOCKED2X, LOCKED2X_delay, RESET4X, RESET8X, LOCKED4X, LOCKED4X_delay, LOCKED8X : std_logic;

signal logic1,clk : std_logic;

signal clk2x,clk4x,clk8x, clkmux: std_logic;

begin

-- use two DLL to get 147 MHz

logic1<='1';

clkpad : IBUFG port map (I=>CLK_IN, O=>CLKIN_w);

dll2x : CLKDLL port map (CLKIN=>CLKIN_w, CLKFB=>CLK2X_g, RST=>RESET,
CLK0=>open, CLK90=>open, CLK180=>open, CLK270=>open,
CLK2X=>CLK2X_dll, CLKDV=>open, LOCKED=>LOCKED2X);

clk2xg : BUFG port map (I=>CLK2X_dll, O=>CLK2X_g);

rstsrl : SRL16 port map (D=>LOCKED2X, CLK=>CLK2X_g, Q=>LOCKED2X_delay,
A3=>logic1, A2=>logic1, A1=>logic1, A0=>logic1);

RESET4X <= not LOCKED2X_delay;

dll4x : CLKDLL port map (CLKIN=>CLK2X_g, CLKFB=>CLK4X_g, RST=>RESET4X,
CLK0=>open, CLK90=>open, CLK180=>open, CLK270=>open,
CLK2X=>CLK4X_dll, CLKDV=>open, LOCKED=>LOCKED4X);

clk4xg : BUFG port map (I=>CLK4X_dll, O=>CLK4X_g);

clk<=clk4x_g;

-- the toggeling array

l_rows: for i in 0 to rows-1 generate
Inst_row: row PORT MAP(
clk => clk,
data => drive_ar(i),
dout => dout_ar(i)
);
end generate;

-- combine all douts via a BIG or-gate

process(dout_ar)
variable tmp: std_logic;
begin
tmp:='0';
l_or: for i in 0 to rows-1 loop
tmp:=tmp or dout_ar(i);
end loop;
dummy<=tmp;
end process;

-- prescaler

process(clk)
begin
if clk='1' and clk'event then
cnt<=cnt+1;
end if;
end process;

-- toggle fliplop and distribution

process(clk)
begin
if clk='1' and clk'event then
case sel is
when "00" => toggle <= '0';
when "01" => toggle <= not toggle;
when "10" => if cnt(15)='1' then toggle <= not toggle; else toggle<='0'; end if;
when others => null;
end case;
drive_ar<=(others=>toggle);
end if;
end process;

gnd<=(others=>'0');
mod_out<=cnt(15);

end Behavioral;
</syntaxhighlight>

Datei row.vhd

<syntaxhighlight lang="vhdl">
library IEEE;
use IEEE.STD_LOGIC_1164.ALL;
use IEEE.STD_LOGIC_ARITH.ALL;
use IEEE.STD_LOGIC_UNSIGNED.ALL;

entity row is
Port ( clk : in std_logic;
data : in std_logic;
dout : out std_logic);
end row;

architecture Behavioral of row is

signal my_array: std_logic_vector (49 downto 0);

begin

-- generate 50 FFs with clock enable

process (clk)
begin
if clk='1' and clK'event then
my_array<=(others=>data);
end if;
end process;

-- combine all into a BIG OR

process(my_array)
variable tmp: std_logic;
begin
tmp:='0';
l: for i in 0 to 49 loop
tmp:=tmp or my_array(i);
end loop;
dout<=tmp;
end process;

end Behavioral;
</syntaxhighlight>

== Messungen ==

[[bild:Term1.gif|thumb|right|220px|Terminierung 1: 50Ω vor dem Koppelkondensator, fg = 10 Hz]]
[[bild:Term2.gif|thumb|right|220px|Terminierung 2: 50Ω nach dem Koppelkondensator, fg = 200 kHz]]

Die nachfolgenden Messungen wurden mit einem Spartan-II Demoboard von Insight Electronics durchgeführt. Es ist mit einem XC2S100-5 im PQ208 Gehäuse bestückt. Es nutzt eine Kernspannung von 2,5V und eine IO-Spannung von 3,3V. Beide Spannungen werden durch Linearregler geliefert. Ein 36.864 MHz Oszillator wurde hinzugefügt. Für die Messung wurde der Takt mittels DLL vervierfacht auf 147 MHz. Diese hohe Frequenz wurde gewählt, um die Effekte gut demonstrieren zu können. In einer praktischen Anwendung wird man diesen Test nur mit der normalen Frequenz betreiben, welche auch in der realen Anwendung genutzt wird. Das Board wird durch ein starkes Netzteil versorgt.

Die Kernspannung wird mit einem Stück Koaxialkabel vom Typ RG 174 gemessen, welches direkt an ein VCC/GND-Pin des FPGAs angelötet ist. Das [[Oszilloskop]] ist auf 50Ω Eingangsimpedanz mit AC-Kopplung geschaltet. Wir sind nicht an der absoluten Größe der Versorgungsspannung interessiert sind, nur an Wechselanteilen, welche hoffentlich deutlich kleiner sind. Mit AC-Kopplung kann man einen deutlich kleineren Messbereich für die vertikale Auflösung verwenden. Dieser Aufbau hat eine gute Abschirmung gegen Störungen und eine sehr hohe Bandbreite zur Messung der hochfrequenten Störungen.

Während der Messung wurde festgestellt, dass es zwei verschiedene [[Wellenwiderstand | Terminierungsmethoden]] in Oszilloskopen gibt. Das alte Tektronix CSA 404 mit einem 11A34 Verstärker nutzt Terminierung 1 am 50Ω Eingang. Daraus ergibt sich eine untere Grenzfrequenz des Hochpasses von ~10 Hz. Das zweite Oszilloskop, ein Tektronix TDS 3034, mit welchem die Screenshots gemacht wurden, nutz Terminierung 2, welche in einer unteren Grenzfrequenz von ~200 kHz resultiert. Das ist nicht akzeptabel für die Messung der Sprungantwort, weswegen die 1 MΩ Eingangsterminierung benutzt wurde. Das ist OK für die Messung niedriger Frequenzen (<10 MHz). Zur Messung der Hochfrequenzstörungen (Messung 4) ist die Grenzfrequenz von 200 kHz kein Problem.
{{Absatz}}

== Messung 1 - FPGA unkonfiguriert ==

Bei diesem Schritt können wir die Leistungsaufnahme in Ruhezustand messen, welche größtenteils durch Leckströme verursacht wird. Zu beachten ist auch, dass unser Oszilloskop mit Eingangsschaltung 1 viel Strom zieht (50Ω @ 2,5V = 50mA). Wir können mittles Multimeter messen, ob unsere Spannungsregler die korrekte Spannung liefern. Wir schreiben den aktuellen Stromverbrauch und Kernspannung auf. Dabei ist der Stromverbrauch der Eingangstermninierung nicht enthalten, weil für alle Messungen das zweite Oszilloskop mit Schaltung 2 verwendet wurde.

== Messung 2 - FPGA mit leerer Logik ==

Ein Design mit einer einfachen Schleife von einem Eingang auf einen Ausgang ist jetzt in das FPGA geladen. Nach der Konfiguration '''sinkt''' der Stromverbrauch, weil die Konfigurationslogik im FPGA abgeschaltet wurde, welche permanant den Konfigurationsspeicher löscht. Die Leistungsaufnahme dieser Minimalschaltung wird als Kalibrierungspunkt für alle nachfolgenden Messungen verwendet.

== Messung 3 - FPGA konfiguriert ohne schaltende Logik ==

Jetzt steigt die Leistungsaufnahme deutlich. Auf den ersten Blick ist das unerwartet, denn im FPGA werden keinerlei Signale geschaltet , die FlipFlips laden immer den gleichen Wert. Aber das ist nicht ganz korrekt. Das Taktnetzwerk läuft auf voller Leistung. Daran erkennt man, dass die Taktverteilung signifikant Leistung benötigt. Darum nutzen [[Ultra low power | stromsparende ICs]] eine saubere Methode zur [[Taktung FPGA/CPLD | Taktabschaltung (clock gating)]], um die Leitungsaufnahme zu verringern. Aber das muss auf sichere Weise erfolgen.

== Messung 4 - FPGA mit dauerhaft schaltenden Signalen ==

Jetzt starten wir ein Feurwerk! Die Stromversorgung erfährt jetzt ihren schlimmsten Albtraum. 1500 FlipFlops die gleichzeitig mit 147 MHz umschalten (togglen)
ist kein Kindergeburtstag! Schau auf den Strommesser! Das FPGA wird schnell sehr heiß. Aber was sehen wir auf dem Oszilloskop? Da die Stromaufnahme konstant ist, können wir nur Hochfrequenzstörungen durch die schaltende Logik sehen, welche durch unzureichende Entkopplung der Keramikkondensatoren verursacht werden könnte. Mit einem schnellen Oszilloskop (1GHz++) und schlechten Versorgungslagen und Keramikkondensatoren, könnte man die '''wirklich''' hochfrequenten Störungen sehen. Mit dem 1 GHz-Oszilloskop sieht man in diesem Fall aber nichts, eben weil die Kondensatoren und Stromversorgungslagen gut funktionieren. Mit langsameren Oszilloskopen (300MHz oder weniger) sieht man nur den Effekt der Kondensatoren. Hier können wir auch die Kernspannung unter Volllast messen. Aber man muss sicherstellen, die Spannung zu messen, welche wirklich am FPGA ankommt, d.h. man muss '''direkt''' an den Pins des FPGA messen, nicht irgendwo auf dem Board! Denn das Stromversorgungsnetz hat einen endlichen Widerstand, welcher einen Spannungsabfall vom Spannungsregler bis zum FPGA verursacht. In einem guten Entwurf sollte der Spannungsabfall kleiner als 1% der Nennspannung sein.

== Messung 5 - Burstbetrieb ==

Zum Schluß erreichen wir den interessantesten Punkt. Mit dem 16-Bit Zähler wird das Umschalten des FlipFlop-Arrays mit einer niedrigen Frequenz moduliert, die Modulationsfrequenz ist 1/65356 der Taktfrequenz, hier ~2,2 kHz. Das ist die Sprungfunktion, welche in den Abschnitten weiter oben genannt wurde. Und wir sehen die Reaktion des Stromversorgungsnetzes. Wenn es ideal wäre, würden wir nur eine gerade Linie auf dem Oszilloskop sehen. Aber da es numal keine Idealfälle gibt, sehen wir Überschwinger und einen verbleibenden Offset. Das nachfolgende Bild zeigt das deutlich. Der blaue Kanal ist das Modulationssignal des 16-Bit Zählers (MSB), der gelbe Kanal die Kernspannung.

<gallery widths="140">
bild:01.gif| Sprungantwort mit 10µF
bild:02.gif| Sprungantwort mit 110µF
bild:03.gif| Abschaltflanke 10µF
bild:04.gif| Abschaltflanke 110µF
bild:05.gif| Zoom, Abschaltflanke 110µF
bild:06.gif| Anschaltflanke 10µF
bild:07.gif| Anschaltflanke 110µF
bild:08.gif| Zoom, Anschaltflanke 110µF
</gallery>

== Erklärung ==

Der Unterschwinger beim Einschalten wird durch die unzureichende Entkopplung im mittleren Frequenzbereich verursacht. Der sprunghaft steigende Stromverbrauch kann nicht von den Mittelfrequenz-Kondensatoren geliefert werden (zu wenig Kapazität), auch nicht vom Spannungsregler (er ist zu langsam dafür). Das originale Demoboard ist nur mit einem 10µF Tantalkondensator hinter dem Spannungsregler bestückt, welcher für so eine große Last viel zu klein ist. Durch Ergänzung eines 100µF Kondensatores kann der Unterschwinger deutlich verkleinert werden.

Der Überschwinger beim Abschalten ist ähnlich, aber hier ist der Spannungsregler zu langsam, um den Ausgangsstrom herunterzuregeln. Der überschüssige Strom (Ladung) wird in den Mittelfrequenz-Kondensatoren gespeichert, aber da dieser nur 10µF hat, steigt die Spannung schnell an. Ein einfacher Vergleich. Es ist genauso wie wenn man mit einem kleinen Fass das Regenwasser von einem großen Dach auffangen will, das Faß füllt sich schnell.

Was verursacht den verbliebenden Offset? Nun, das ist der Gleichstromwiderstand des Stromversorgungsnetzwerks vom Spannungsregler (wo dieser die Ausgangsspanung misst und regelt) bis zum VCC-Pin des FPGAs. Die Stromaufnahme des FPGAs schwankt zwischen Messung 3 (kein Umschalten) und Messung 4 (konstantes Umschalten). Auf dem Oszilloskop sehen wir eine Spannungsdifferenz von ~70mV bei einer Stromdifferenz von 912 mA, woraus ca. 76mΩ Widerstand resultieren. Die Schlußfolgerung daraus ist, dass die Verbindung zwischen dem Punkt der Spannungsmessung durch den Spannungsregler und den VCC-Pins einen möglichst niedrigen Widerstand haben muss. Das beste sind komplette Lagen für die Stromversorgung (Power Planes), aber kurze, dicke Leitungen sind meist auch OK. Es gibt auch Spannungsregler mit extra Messeingängen, welche den Spannungsabfall über der Zuleitung kompensieren können, weil sie direkt am Verbraucher die Spannung messen. Als weitere Möglichkeit werden heutzutage meist sog. Point of Load Module eingesetzt. Das sind Spannungsregler (Schaltregler), welche direkt am zu versorgenden FPGA sitzen und mit einer hohen Spannung von 5..48V über das Board versorgt werden.

{| class="wikitable"
|+ '''Messergebnisse'''
|-
! Messung || FPGA-Inhalt || Icc [mA] || Vcc [V] || P [mW]
|-
| 1 || keine Konfiguration || 80 || 2.501 || 200
|-
| 2 || Minimallogik || 40 || 2.502 || 100
|-
| 3 || Testlogik, inaktiv || 235 || 2.487 || 584
|-
| 4 || Testlogik, konstantes Umschalten || 1147 || 2.433 || 2790
|-
| 5 || Testlogik, Burstbetrieb || 690 || 2.464 || 1700
|}

== Zusammenfassung ==

In diesem Artikel wurde eine einfache aber leistungsfähige Methode zur Messung des Frequenzgangs des Stromversorgungsnetzwerks für FPGAs gezeigt. Die Messung kann deutlich einfacher und mit leicht verfügbaren Messgeräten unter realistischeren Bedingungen durchgeführt werden als eine klassische Messung mit einem Netzwerkanalysator. Es läßt viel Raum für Experimente mit der Entkopplung der Stromversorgung in Bezug auf die Platzierung und Werte der Kondensatoren.

== Weblinks ==

*[http://processors.wiki.ti.com/index.php/General_hardware_design/BGA_PCB_design/BGA_decoupling General hardware design/BGA PCB design/BGA decoupling, Texas Instruments (engl.)]
*[http://www.signalintegrity.com/Pubs/pubsKeyword.htm#power%20system Signal integrity of power systems] by Howard Johnson (engl.)

[[Kategorie:Spannungsversorgung und Energiequellen]]
[[Kategorie:FPGA und Co]]
[[Kategorie:VHDL]]

Reichelt-Wishlist

2008-05-05T14:42:10Z

129.247.247.238: /* Controller/FPGA/CPLD */

== Reichelt Wunschliste ==

Auf dieser Seite können Wünsche zur Erweiterung des Reichelt-Lieferprogramms eingetragen werden. Es ist keine offizelle Wunschliste von Reichelt und es ist nicht bekannt, ob Reichelt-Mitarbeiter diese Seite regelmässig sichten. Reichelt sollte sicherheitshalber regelmäßig angeschrieben werden, damit diese Liste nicht in Vergessenheit gerät.

Damit sich die beliebtesten Artikel herauskristallisieren, macht jeder einfach '''einen''' virtuellen Strich dahinter: | (Windows: ALT-GR Taste und < Taste drücken, Mac OS X: Alt-Taste und 7 Taste drücken). Alle fünf Striche (|||||) bitte immer ein Leerzeichen einfügen.

Neue Artikel einfügen darf und soll natürlich auch jeder - aber bitte die Liste vorher durchgehen (Tipp: Browser-Suchfunktion nutzen)! Einfach ganz viele Striche auf einmal hinter einem Artikel einzufügen ist zwecklos. Das erkennt man in der History und es gibt viele Leute, die diese Seite überwachen...

'''Nicht sinnvoll''' ist etwas sehr exotisches, wie z.B. einen ganz bestimmten super schnellen AD-Wandler hier aufzulisten! Neue Artikel müssen sich für Reichelt ja auch rentieren und wirtschaftlich "an den Mann bringbar" sein.

= Wunschliste =
== Halbleiter ==
=== Controller/FPGA/CPLD ===

* ALTERA MAX-II (CPLDs) ||||| ||||| ||
* ALTERA CPLD EPM30xx - Familie ||
* ALTERA CPLD EPM70xx - Familie ||||| ||||| ||||| |||||
* ALTERA Flex10K - Familie |||
* ALTERA Cyclone2 - Familie ||||| ||||| ||||| ||
* Atmel AVR32 im TQFP |||| |
* Atmel AVR mit USB AT90USB82, AT90USB162, AT90USB646, AT90USB1286 und AT90USB1287 ||||| |||
* Atmel ATtiny261 (auch 461; bevorzugt DIP) ||
* Atmel Atmega 16L und 32L in TQFP (waere ATMEGA 16/32L8 TQ) ||||
* Atmel ATmega324P in TQFP und PDIP |||||
* Atmel ATmega644p in TQFP |||||
* Atmel AVR Controller mit Funkanbindung z.B. AT86RF230, AT86RF211, AT86RF401, dazu passende Quarze (evtl. SMD) 18,080 MHz (Crystek P/N 016758), Spulen 39nH. ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||| |
* Atmel AT90PWM3B (µC für Servosteuerungen und z.b. Motorsteuerungen) ||||| ||||| ||||| |||
* Atmel AT89LP4052 PDIP ||||| |||||
* Atmel Dream Sound Synthesizer Chips, z.B. ATSAM3103 und ATSAM3308 ||||| ||||
* Atmel XMega wie ATMega16 Belegung bedrahtet nicht SMD sondern normale Bauform ||||
* Axis Etrax 100LX Risc Processor (kostenloses Linux-System vorhanden) ||||||||
* Freescale Prozessoren (Coldfire) (16 + 32 Bit) ||
* Freescale DSP56F801 ||||
* Freescale HCS12 Controller ||||| ||||| ||||| |||||
* Freescale MC9S08QG8 (DIP 16) ||||| ||||
* Freescale MC9S08QEx |
* Infineon XC866 ||||| ||||| ||||| ||||| |
* Lattice ispMACH 4032C / 4064C / 4128C ||||
* Luminarymicro Stellaris Serie (Cortex-M3) |
* Microchip PIC 10F2xx (+ Programmiergerät) |||| ||||| ||||| |||
* Microchip PIC 18F2585 |||
* Microchip PIC 18F4523 (12/2007: PIC mit 12-Bit A/D-Wandler) |
* Microchip PIC 18F4550 (PIC mit USB) ||||| ||||| |||| ||||| ||||| ||||
* Microchip PIC 18F6585
* Microchip PIC 24 ||||| ||||| ||
* Microchip mehr dsPIC30F |||||
* Microchip dsPIC33 ||||
* Microchip PIC32 (MIPS) ||||| |
* NXP LPC214x-Serie ARM7-Controller ||||| ||||| |
* NXP LPC23xx/24xx ||
* NXP SAA5281 Videotextinterface ||||| |||
* Parallax Propeller CPU, 8 Cogs - DIP 40 ||||| ||||| ||||| |||
* Renesas M16C |||||
* Silabs C8051F320 USB Mikrocontroller ||
* SSV DIL/NetPCs [http://www.dilnetpc.com]http://www.dilnetpc.com ||||| ||||| |||
* ST ST7MC... (µC für Servosteuerungen, und vor allem Brushless-Motoren) ||||| ||
* ST STR7 Serie (ARM7TDMI) |
* ST STM32 Serie (Cortex-M3) |
* TI TMS470 Arm7 ||||| |||| ||||| ||||| |
* TI MSP430F167, TI MSP430F168 |||
* TI MSP430F2001/2/3 etc. im RSA-Gehäuse ||||| |
* TI TUSB3210 ||||| ||
* Ubicom SX20 SX28 IP2022 ||
* Zilog Z8 Encore-Microcontroller (bis 64k Flash, I²C, SPI, 2xUART, ADC, on-Chip Debugger ...) [http://www.zilog.com/products/family.asp?fam=225]www.zilog.com ||||| |
* Zilog ZNEO-Microcontroller (Z16Fxxx, bis 128k Flash, 4k RAM, bis zu 76 I/Os, 3 Timer, 10-bit A/D, externer Daten-/Adressbus, on-Chip Debugger) [http://www.zilog.com/products/family.asp?fam=236] www.zilog.com |
* CY7C68013A-56PVXC (Cypress EZ-USB FX2LP) ||
* XC3S 400 TQ144 |
* Mehr FPGAs (v.a aktuellere) von Xilinx, z.B. Spartan III , ALTERA CYCLONE II (v.a. auch größere Typen, die noch im TQFP-Gehäuse zu haben sind wie z.B. XC3S400 oder XC3S500E (PQFP208)) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Ajile aj-100 (Java Real-Time Prozessor) |
* Western Design Center 65c816 ||

=== Speicher ===
* Atmel DataFlash, z.B. AT45DB081B (8 MBit Flash-Speicher an seriellen Bus im 8poligen Gehäuse) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* NexFlash spiFlash NX25P16 (16MBit serial Flash im SO8-Gehäuse) ||||| ||||| |||||||
* Schnelles RAM (10, 15 oder 20ns, z.B. Samsung K6R1008C1D-UI10) (5V/3,3V) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||
* RAMs (SRAM oder DRAM) mit ordentlicher Kapazität (z.B. HY57V641620HG oder besser) ||||| ||||| ||
* 3.3V DRAM |||
* 3.3V async SRAM ab 16KByte ||
* 24LC256 oder 24AA256 oder 24LC512 oder 24AA512 ||||| ||||
* FPGA Konfigurations-EEPROMS AT17LV256, AT17C65/128/256.../XCF04S/... ||||| ||||| |
* EEPROM mit SPI Schnittstelle 25XX Serien ||||| |
* F-RAM mit SPI von RAMTRON |||

=== ICs ===
* National Semiconductor CLC020 und CLC021 Parallel Component nach SDI-Converter ||
* Ethernet-Controller RTL8019AS und Übertrager FB2022 oder 20F-001N ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Ethernet-Controller CS8900A ||||| |
* SPI-Ethernet-Controller ENC28J60 und passender Übertrager und passenden '''Grundton'''-Quarz (25,0000 MHz Grundton) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||| ||||| ||||| ||||| ||||| |
* DP83848C (Ethernet Physical Layer Transceiver/PHY, MII/RMII-Schnittstelle, passend zu AT91SAM7X) |||
* Ethernet-Connector RJ-45 mit integriertem Übertrager (z.B. Taimag RJLBC-060TC1) ||||| ||||| |
* ADS8320 ADC 16 Bit seriell ||||| ||||| ||||| ||||| ||||| |||
* DAC7612 DAC 12 Bit seriell ||||| ||||| ||||| ||||| ||
* DTMF-Dekoder-Enkoder (8870, 8880) ||||| ||||| ||||| ||||| ||||
* AD7524 in SMD ||||| |||| |||||
* MCP23016 16Bit I²C I/O Expander ||||| ||||| ||
* ISD 5116 (Sprachaufnahme bis 16min & I2C-Interface) ||||| ||||| |||||
* I²C-Bus Temperatursensor DS1631Z ||||| ||||| ||||| |||
* RS485 isoliert: z.B. Burr-Brown ISO485 o.ä. |||||
* Maxim MAX629, MAX1795, MAX1703 (Aufwärtsregler / Step-Up-Konverter) ||||| |||| ||||| |
* DAC8830 IDT (16Bit-DAC,ser. Input) ||||| |
* MAX6958 / MAX6959 (I²C 4-Digit, 9-Segment LED Display Drivers with Keyscan) |||| ||||
* LM3886 ||||| |
* Leistungs-OP LM675 von National ||
* ZHB6718 (H-Bridge für 1,5V - 20V Motoren) |||| |||||
* Philips PCA82C252 oder TJA1054A oder vergleichbar ("Fault-Tolerant" CAN Transceiver, 11898-3) ||||| ||||
* Maxim Switched Capacitor Tiefpass-Filter (z.B. MAX297, MAX7410) |||||
* Philips PCA9555 (I2C IO, 16 Bit par. I/O, c't Project Soundcheck II) ||||
* ISD 2560 -> SOIC Gehäuse (Sprachaufnahme IC) ||||| |
* MCP25050 CAN-Bus Input/Output Expander ||||| ||||
* STP08CL596M SO16 STM, LOW VOLTAGE 8-BIT CONSTANT CURRENT LED SINK DRIVER ||||
* STP16CL596M SO24 STM, LOW VOLTAGE 8-BIT CONSTANT CURRENT LED SINK DRIVER |||
* STP16CL596B1R DIP24 STM, LOW VOLTAGE 16-BIT CONSTANT CURRENT LED SINK DRIVER ||
* STP08CL596B1 DIP16 STM, LOW VOLTAGE 8-BIT CONSTANT CURRENT LED SINK DRIVER ||
* MAX6675 Typ-K Thermoelement nach SPI ||||| ||||| |||||
* Motortreiber TLE 4205 |||
* LTC24xx |||
* MAX6650 ||
* QT511-ISSG (iPod-like Touch-Wheel-Sensor ''siehe'' [http://www.qprox.com/products/qwheel_qt510.php]) ||||| ||||
* DDS-IC von Analog wie AD9833, AD9835 ||||| ||||| ||||| ||||| ||||| |||
* IP101 PHY von IC+ (Distri für DE [http://www.topas.de/tt/cfs/icp_cfs_mai05.htm Topas]) ||
* UDN 2987 LW (Source Driver UDN2987 in SMD-Bauform) ||
* MAX7311AWG 2Wire Interface von Maxim ||
* IR2011 MOSFET Treiber |||
* MAX 4420 Mosfet Driver ||
* MAX 4429 Mosfet Driver ||
* CCS-Akkulade-IC (z.B. CCS9620SL) (siehe [[http://bticcs.com/]]) |||||
* LM1117MPX-1.8 und LM1117MPX-3.3 (SMD-Spannungsregler SOT-223) |||||
* LTC1694-1 (I2C/SMBus Accelerator) |||
* P82B86 (I2C Dual Bi-Directional Bus Buffer) ||
* CS5641 von Cirrus...The CS5461 incl. two delta-sigma A/D converters.... ||
* DS1616 von Dallas Datalogger-IC |
* TEA5757 FM-Tuner IC von Philips |||
* TEA5768HL FM-Tuner IC von Philips |||||
* VS1053 MP3/AAC/WMA/Ogg Decoder von VLSI ||
* TH3122 K-Line Interface von MELEXIS ||||
* MAX7313 16 LED-PWM-Dimmer (Im gegensatz zu den Philips-ICs ist jede einzelne LED-Dimmbar, dafür nur in 16 Schritten) ||||| ||||
* LMX2306/LMX2316/LMX2326 PLL Synthesizer von National ||||| |
* MAX127/128 8-Kanal 12bit ADC mit I2C interface |||
* MIC6315 von Micrel (3,3/5V Reset Baustein mit manual Reset) ||
* MMI4832 (Geber Interface Baustein EnDat, SSI, Incrementalgeber ||
* CP2120 single-chip SPI to I2C bridge and GPIO port expander |
* AD623 Single Supply,Rail-Rail, InstrOpamp |||||
* AD628 InstrOpAmp, high voltage inputs |
* L6205 Motortreiber (2Kanal, 2,8A, DMOS)|||||
* TLV2382ID Rail-Rail-OP von TI |
* TLV320AIC23B Audio-Codec ||
* Cypress CY7C67300 dual role USB controller mit OTG |||||| ||||| ||||| ||||| ||
* High Side Current Sense ICs wie MAX4172 |||||
* LM397, LM321 o.ä. single op-amp in SOT23-5 5-30V supply ||
* LTC3490 ||||| |||
* QT160 6-fach Touch Sensor IC |||
* TPIC6B595 (oder ähnliche 74xx595 high current (150 mA) shift register) ||
* HV9910 Schaltregler für die Hochleistungs LED^s Ub=8-450V; I beliebig; Eff. besser 90% |||
* LM267X SimpleSwitcher Step-Down-Konverter in SO-8 Bauform |
* Schnellere und gleichzeitig günstige OpAmps; Beispiel AD8055 ||

* Clock generator IC's, z.B. PCK20?? von Philips |
* uC supervisor chips + watchdog z.B.: MAX6864 ist z.Z. der beste (0.2uA!) |||
* Mehr FET-Treiber (TI UCC3372x, HIPxxx , die neueren Brückentreiber von Maxim ||||| |
* D/A Wandler mit 4 oder mehr Ausgängen, z.B. TLC5620/TLV5629/AD5325 ||||| ||||| |
* PLL Schaltkreise für Frequenzerzeugung. z.B. MC / ML145170 (SOIC16) / TSA5060A ||||| ||||| |||
* Digital Potentiometer (z.B. 2-Wire MAX546x, AD526x, X9C10x) ||||| ||||| ||||| ||||| ||
* Power over Ethernet Bausteine z.B. LM7050
* Automotiv ICs z.B. LM1815, LM1915, LM1949, LM9011, LM9040, LM9044, LMD18400... ||||| |
* 16-bit A/D-Wandler (waren von Maxim schon im Programm, sind aber wieder herausgeflogen?) |||
* Video-AD-Wandler z.B. LTC2208 (16 Bit 130 MS/s) für FPGA und SDR |
*MAX528 8-fach 8Bit DAC mit Output Buffer seriell |
*LM1117 - 3,3V SOT-223 ||


* Ethernet Magnetics (Auch POE) ||||| |||
* Generell mehr DAC's (auch die teureren) von TI |||||
* Generell mehr I2S IC (ADC, DAC, DSP, u.a. Crystal, BurrBrown etc.) |
* Generell mehr I²C IC ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||
* Generell mehr 1-Wire IC ||||| ||||| ||||| ||||| ||||| ||||| |
* Generell mehr PWM-SIC's ||
* Generell mehr SPI IC ||||| ||||| ||||| ||| (viele µC haben SPI aber kein I2C )
* 74VHC-Serie komplettieren (z.B. 74VHC125D) ||||| |
* MagJacks ||

=== Diskrete ===
* LM317EMP oder LM317AEMP SMD-Spannungsregler einstellbar (SMD TO-223 Gehäuse) ||||| ||||| |||
* L4941 Spannungsregler 5V/1A in SMD-Ausführung (DPAK) ||||| |||
* LM2734 Schaltregler ||
* MIC29300/29301 Spannungsregler 5,0V 3A im TO263(SMD) Gehäuse ||
* MC78LCxx Serie - Ultra Low Drop Spannungsregler 3-5 Volt mit 1 Mikro-Ampere Ruhestrom ||||| ||
* R-783.3-0.5 Schaltregler 4,75V - ca. 18V Eingang; 3,3V Ausgang (Hersteller Recom) ||||||
* R-785.0-0.5 Schaltregler 6,5V - 30V Eingang; 5,0V Ausgang (Hersteller Recom) ||||
* R-785.0-1.0 Schaltregler, Ausgang 5,0V, 1A |
* ZRA250F005 Referenzspanungsquelle 2,5V 0.5% SOT23 gehäuse ||||| ||||
* Spannungsregler in SMD-Version (7805 etc., nicht nur der 78L05) ||||| ||||| ||||| ||||| ||||| ||||| |||
* 3,3V-Längsregler SMD zu vernünfitgen Preisen (Bsp: LF33 --> Best.Nr.: LF 33 CV, Preis: 0,76€)(der LT1086 kostet 4 Euro) ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Größere Auswahl an Step-up Reglern ||||| ||||| ||||| ||||| |||
* 5,2V Lowdrop Längsregler LF52 im TO252AA von STM |||||
* Spannungsregler SMD in DPAK ||||| ||||| ||||| |

* IPW60R045CS Infineon Mosfet 600V 45mOhm Rdson 30ns tr+tf (niedrigster Rdson in der Klasse) |
* SPP20N60C3 Infineon Mosfet 600V 190mOhm Rdson <10ns tr+tf (Schnellste Schaltzeit in der Klasse) ||||| |
* SDT06S60 Infineon SiC 600V 6A Silizium-Carbid Schottky-Diode (kein trr, daher keine Schaltverluste) |||
* mehr FETs und IGBTs (nichtnur IRF, sehr gut IXYS <- und sauteuer!) ||||| |||
* Digitaltransistoren (BCR*), auch als Pärchen NPN/PNP (BCR10, BCR08pn) ||||| ||||
* Niederohm-FETs in SO8, N und P ||||| |||||
* Si4562DY N- and P-Channel 2.5-V (G-S) MOSFET SMD ||||| ||||| |
* IRF7503/IRF7506 Dual Mosfet SMD ||||| ||||
* PhotoMOS Relay (z.B. AQV257 von Panasonic; http://www.mew.co.jp/ac/e/control/relay/photomos/index.jsp) |
* IPS5451S intelligenter Leistungsschalter 50 V, 35 A, 25 mΩ |
* BSH205 P-Channel 1.5V(GS), 0.75A, 12V D-S |
* SMD Doppeldiode Schottky 12A 60V im TO252AA z.B. 12CWQ06FN von IOR ||||| ||||| ||||| |
* IR3313 o.ä. Intelligenter Leistungsschalter 32V/90A, einstellbare Strombegrenzung |

* BUF420AW Schaltnetzteil Transistor von STM |||||
* Philips PDTD113E/123E und PDTB113E/123E (PNP und NPN im sot23 mit internen Widerständen für Basis und PullUp/Down ||
* 2SC1971 Transistor mit hoher Frequenz und viel Leistung für Endstufen |

== Sensoren/Aktoren ==
* Sensirion SHT11/SHT71 (oder auch SHT15/SHT75) ||||| ||||| ||||| ||||| ||||| ||||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Sharp Entfernungssensoren (zb den GP2D120 oder den GP2D12) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||
* kleine Feuchtigkeitssensoren zur 'on-board-Montage' ||||| ||||| ||||| ||||| |
* IS471 Selbstmodulierende IR-Lichtschranke ||||| ||||| ||||| ||||| |||
* FSRs (Force Sensing Resistor) von Interlink Electronics ||||| ||||| |
* Drehwinkelgeber, Gyro, Kreiselsensoren ähnl. Tokin CG-L43 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||
* Summer mit 20mA@5V ähnlich Conrad Nr.751553 (TDB05 kann mit 30mA@5V nicht von allen Controllern direkt getrieben werden) ||||| ||||
* NanoMuscle Aktuatoren ||||| |||||
* Flexinol |||||
* Hall-Sensor UGN3503, KMZ51 ||||| ||||| |||
* Magnetfeld-Sensor (Kompass-Anwendung) KMZ52 ||||
* günstige Temp. Sensoren TC77 ||||| ||||| |
* Motorola/Freescale Drucksensoren z.b. MPX4250 mit AP Druckanschluss ||||| ||||| ||||| ||||| ||
* K-Typ (J-Typ) Thermocouple Temperatursensoren und passende Steckverbinder ||||| |||||
* Induktions-Stromsensoren Coilcraft #J9199-A o.ä. ||||
* Durchflussmesser (z.B. wie Conrad Nr.155374) ||||| ||||| |
* Linear- und 360° Soft-Pots wie von spectrasymbol ||||
* iMEMs Acceleration Sensors ADXL Series von Analog Devices ||||| ||||| ||
* LEM Stromsensoren (Transducer) der HAIS-Serie, speziell HAIS 50-P und 100-P ||||| ||||| |
* Allegro Stromsensoren (z.B. ACS713, ACS756) |
* 4Hz Supersense µblox LEA-4S GPS module (Importer pointis.de) + Passende Passives Patch antenna (zB. von inpaq.com) ||||
* Hallsensoren z.B. TLE4905 wieder ins Programm nehmen ||
* Anemometer ||
* TSic Temperatursensoren von ZMD |||
* Piezo Minimotoren/Lienearaktoren von Elliptec/Siemens einzeln und günstig ||
*Temperatursensor mit SPI-Interface LM74 |

== Baugruppen ==
* Atmel ATNGW100 von [http://www.atmel.com/dyn/corporate/view_detail.asp?FileName=AVR32NGKit_3_26.html Atmel] = billiges Linux Board ($69=51.69€) --> [http://www.avrfreaks.net/wiki/index.php/Documentation:NGW/NGW100_Hardware_reference Dokumentation] ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Atmel ATSTK600 von [http://www.atmel.com/dyn/products/tools_card.asp?tool_id=4254 Atmel] |
* Atmel ATSTK1000 von [http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3918 Atmel] ||||| ||||| ||||| |||
* Atmel AVR Dragon von [http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3891 Atmel] ||||| ||||| ||||| |||||
* Axis Etrax 100LX MCM (Multi Chip Module) A full Linux computer on a single chip! ||||| |||||
* CentiPad/DevKit Embedded Linux Modul ([http://www.centipad.de www.centipad.com]) ||||| ||
* DS9490R USB zu 1-Wire Dongle (auch mit Linux Treiber) |||
* Easy-Radio Module zur seriellen Datenübertragung (ER400 RS/TS/RTS) ||||| ||||| ||||| |
* Foxboard = Betriebsfertiges Micro Linux System mit Axis Etrax 100LX MCM 66mm x 72mm ||||| ||||| ||||| |||||
* FoxVHDL = FPGA Erweiterungskarte für das ACME Foxboard ||||
* kostengünstige Funkschaltmodule (TLP/RLP) ||||| ||||| ||||| ||
* kostengünstige Funkempfänger/Funksender 433 & 868 Mhz ||||| ||||| ||||| ||||| ||||| ||||| ||||
* Lantronix XPort Embedded Device Server ([http://www.lantronix.com www.lantronix.com]) ||||| ||
* low-cost Experimentierplatinen für FPGA ||||| ||||| |||||
* Mini-Bluetooth Module (RS232-Bluetooth-"Wandler"-Platinchen) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||| |||
* Mini-WLan Module (RS232 zu WLan) ||||| ||||| ||
* MT1390 FM Tuner-Modul von Microtune |||
* NetDCU8 von F & S Elektronik Systeme GmbH (http://www.fs-net.de) - Linux-Computerplatine mit 400MHz Samsung-ARM mit 32MB RAM, 16MB Flash und SD/Ethernet/CAN/USB/TFT/RS232 für ca. 100 Euro ||||| ||||| ||
* OM5610 FM Tuner-Matchbox von Philips |||
* TI - MSP430 Wireless Development Tool (AEC13895U) |
* Gyro Sensoren MURATA, ENC-03J A/B ||

== "Passive" Bauteile ==

=== Spulen etc. ===
* Ordentliche Trafospulen + Kerne, z.b. ETD-Serie, oder RM10 ||||| ||||| ||||| ||||| ||||| ||||| ||||
* Passende Ferrite dazu: N27,N41,N67,N87,N97 ||||| ||||| ||||| ||||| ||
* Magnetics CoolMu Ringkerne ||||| |||||||
* Magnetics MPP Ringkerne ||||| ||||| ||
* Die Micrometals Pulverkerne (-18 und -26) auch in größer ||||| |
* Funk-Entstördrosseln 16A, div. Werte ||||| ||||
* Funk-Entstördrosseln 47µF |||
* Würth Induktivitäten ||||| ||||| |||
* Übertrager für Schaltregler z.B. Epcos Typ B78304 |||||

=== Kondensatoren ===
* Low-ESR Elkos (definiertes Fabrikat/Typ, und nicht einfach irgendwelche! (Rubycon?)) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||
* Low-ESR Elkos RM 3,5mm 1.000uF 6,3V (Mainboardaustausch Elko) |
* Low-ESR SMD Tantal-Elkos (definiertes Fabrikat/Typ, und nicht einfach irgendwelche! (AVX?, Epcos?)) ||||| ||||| ||||| |||||
* Zum MAX232 so20 passende SMD-Kerkos im Wert 1uF (0805,0603, 1206) ||||| ||||| ||||| ||||
* Generell SMD-Kerkos im Wert > 100nF ||||| ||||| |||||
* Kleine Niedervolt-Polyproplyenkondis mit mehr Kapazität ||
* Wima MKP4 ||||
* Wima MKP-X2 (~275V, klein und ideal für Kondensatornetzteile) |
* Günstige hochkapazitive Doppelschichtkondensatoren (z.B. Maxfarad MES2245 220F 2,3V) ||||
* Keramikkond. SMD 0603/0805/1206: mehr Zwischenwerte (56p, 82p, 560p) ||||| |
* Drehkondensator 20-500pf |

=== Widerstände ===
* SMD-Widerstande in Bauform 0603 0402 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* SMD-Widerstände 0805 und 1206 auch unterhalb von 1 Ohm ||||| ||||| ||||| |||
* SMD-Widerstände unterhalb 1 Ohm, andere Gehäuse als 0805/1206 (leichter erfüllbarer Wunsch) |||||
* SMD-Widerstände 0805 auch aus der E24-Reihe ||||| ||||| |||||
* Durchsteck-Widerstände in kleiner Bauform 0204. ||||| ||||
* R2R-Widerstandsnetzwerke (z. B. 10/20kOhm für DA-Wandler an Microcontrollern) ||||| ||||| ||||| ||||| ||||| ||||| |||
* Präzisionswiderstände 0,05% und besser, ev. Drahtgewickelt ||||| ||||| |||||
* Niederohm-Widerstände (Shunts ab 1mOhm im guten Gehäuse z.B. TO220) ||||| ||||| ||||| ||||| ||||| ||
* 25/50W-Widerstände (~20/50 Ohm auch weniger) ||||| ||||| ||||
* Präzisions-Spannunsgteilernetzwerke ||||| ||||
*Präzisionsspannungsteiler 1:10, 1:100, 1:1000 (10MOhm Gesamtwiderstand) ||
* SMD-Präzisionswiderstände (0,1% TC10ppm/K =>0,1W indukt.arm) ||||| ||||| |||
* Null-Ohm Widerstände (Drahtbrücken) Baugröße wie 1/4W |||

=== Quarze und Quarzoszillatoren ===
* SMD-Quarze mit Standardgehäuse (z.B. HC49/US & HC49/UP) ||||| |||
* Quarzoszillator 9,8304 Mhz ||
* Quarz mit 3,200 Mhz |
* 13,5600 MHz Quarz (benötigt für RFID) ||
* Quarz mit 13,56 MHz (SMD+bedrahtet) |
* 24,0000 MHz Standardquarz Grundton ('''kein 3. Oberton!!!''') (benötigt für USB-DMX-Interface) | ||
* 25,0000 Mhz '''Grundton'''-Quarz (wird benötigt für Microchip TCP/IP Controller ENC28J60) ||||| |||
* Allgemein mehr Grundtonquarze bei höheren Frequenzen |
* SMD Quarze/ Oszillatoren in flachen, kleinen SMD Gehäusen (SMX-A/-B) ||

=== Sonstiges ===
* Varistoren 14V auch als bedrahtetes Bauteil (für KFZ-Bordnetz) ||||| ||
* Suppressordioden mit Spannungsbereich zwischen 15V und 30V |
* die Auswahl läßt hier sehr stark nach
* Netzfilter FFP Reihe Schurter |
* Metallbrückengleichrichter für 50A ||

== HF Baumaterialien ==
* Filter SFE10.7MA19 360khz SZP2026 |
* Keramische Filter CFM455... ganzes Sortiment |||
* Quarze 32 MHz 10ppm Oscillatorfrequenz 0 bis +70°C
* Quarze 6,500000 MHz ||
* MC68160FB
* S3C4510B
* MT48LC4M32B2TG-7
* MC68EN302PV20
* Zirkulatoren ALD4302SB statt LM239
* Transistoren MRFG35010
* µP Compatible CTCSS Encoder,Decoder FX 365
* Durchführungskondensatoren 1nF/160V (waren Ende '06 noch im Programm) |||
* ZF-Quarzfilter für versch. Frequenzen (10, 20, 40 MHz) |
* MMICs und Ringmischer von Mini-Circuits
* PLL ICs z.B. von NXP und National für HF-UHF ||
* MICRF002/022, MICRF102/103 von Micrel |||||

== Optoelektronik und Leuchtmittel ==
* low current SMD LEDs (z.B. Osram LG T679 - Anm.: hier gleich die neuen Varianten Lx T67K bestellen, nicht die alten 9er) ||||| ||||| ||||| |||
* SMD LED Bauform 0402 rot/gelb/grün/blau/weiss ||||| ||||| ||||| |||
* weisse SMD LED Bauform 0603 ||||| ||||| ||||
* warm weisse LED ||||| ||||| ||||
* OSRAM Hyper TOPLEDS weiss LW T67C-T2U2-5K8L ||
* OSRAM Halogen Decostar 51 12V 20W GU5,3 statt des billigen NoName Zeugs ||
* OSRAM Hyper TOPLEDS gelb LY T676-S1T1-26 ||
* Everlight SMD-RGB (fullcolor) 19-337/R6GHBHC-A01/2T ||||
* 7-Segment-Anzeige, allgemein Low-Current bzw. High Efficiency Versionen anbieten ||||| |||
* 7-Segment-Anzeige, blau, gem. Anode ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* 7-Segment-Anzeige, weiss, gem. Kathode ||||| ||||| ||||| |||||
* 7-Segment-Anzeige, weiss, gem. Anode ||||| ||||| ||||| ||||| ||||| |
* 7-Segment-Anzeige, blau, gem. Kathode ||||| ||||| ||||| ||||| ||||
* Diese 4-Stelligen Dot-Matrix LED Anzeigen Siemens SLG 2016 oder von HP oder ähnliches |||||
* Generell alle 7-Segment-Anzeigen auch in Blau und bis zu 100mm höhe |
* Vakuum-Fluoreszenz-Displays (Dot Matrix mit Standardcontroller, z.B. Futaba "LCD Emulators") ||||| ||||
* IL207AT (SMD Optokoppler von Infineon) ||||| ||
* ILD256T (SMD AC-Optokoppler) ||||| |||||
* ILD620 (DIP Optokoppler) ||||| ||||| ||||| ||
* SFH6106, SFH6206 4 Pin Optokoppler SMD ||||||
* TLP113 (SMD Optokoppler) |||||
* Vactrol Optokoppler (mit Fotowiderstand zur Analogsignalregelung) |||||
* IR-Diode mit viel power ttp://www.lc-led.com/Catalog/department/36/category/49/1 |
* IrDA-Tranceiver TFDS4500 (oder TFDU4100) wieder anbieten (war im 07/2005er Katalog noch drin) ||||| |||
* Seoul Zled P4 (100lm bei 350mA, 240lm bei 1A!) ||||| |||||
* Generell: Z-Power LEDs von Seoul (günstiger und heller als Luxeon) ||||| ||
* Seoul Z-LED RGB auf Platine ||
* EA DOG-M128 128x64 Grafikdisplay aufbau ähnlich EA DOGM162 ||||
* TLP 3617

== Mechanisches ==
* Getriebemotoren wie RB35 oder RB40 ||||| ||||
* Muttern M2 ||
* Zylinderkopfschrauben M2,5 x 12mm ||||
* Zylinderkopfschrauben M2,5 x 20mm ||||
* Zylinderkopfschrauben M2,5 x 30mm ||||
* Zylinderkopfschrauben M3 x 25mm |||||
* Bopla ABP oder ABPH 800-100 (10cm) Aluprofil Gehäuse |
* microSD / Transflash sockel mit push-push technik (ist nervig die immer für teuren versand aus amiland kommen zu lassen) ||||| ||||| ||||| ||||| |||||
* M2 Gewindebohrer und Senker ||

=== Schalter/Potis etc. ===
* Drehimpulsgeber DDM Hopt+Schuler 427 SMD (evt auch normal, stehend & liegend) ||||| ||||| ||||| ||||| |||||
* Folientastaturen ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||
* Drucktastenfeld Matrix 3x4 ||||| ||||| ||||| |||
* kleiner Joystick wie beim Atmel Butterfly ||||| ||||| ||||| ||||| ||||| ||||| ||
* statt Radiohm potis bitte Prehostat oder Alphastat 16 63256-026xx ||||| ||||| |||
* Drehschalter Serie DS in allen Versionen nur vom Hersteller C&K; auch brückende Versionen anbieten ||||| |||||
* bistabile Relais mit 2 Wicklungen ||||| ||||| ||
* passende Touchpanels für die coolen Blue-Line-Grafikdisplays ||||| ||||
* mehrpolige Fußschalter, FS 35 bitte bei Druckschalter einordnen |||
* möglichst kleine und flache Druckschalter rastend! ||||
* iPod-Wheel (Siehe: IC's=>QT511-ISSG; siehe 360° Soft-Pots - weiter oben) |||
* Taster Radiohm ST-1034 in rot, grün, gelb, blau, grau und schwarz
* Leitplastikpotis im Servogehäuse |
* Relais mit hohen Wirkungsgrad (daher nur geringer Spulenstrom nötig) |
* Tastköpfe für Taster9308, wie zb Omron B32-2000 oder B32-2010 |
* Batteriehalter für 4 Mignonzellen mit Lötfahne (statt Druckknopf) |
* SMD-Schiebeschalter |||
* Hohlwellen-Drehgeber (z.B. EC35B-Serie von Alps) ||
* Taster und Kappen aus der Multimec-Reihe |

=== (Steck-) Verbindungen ===
* Modulare Buchse RJ45 mit Übertrager und LEDs für Ethernet 10/100, z.B. SI-40138 MagJack von BEL-STEWART oder Taimag RJLBC-060TC1 ||||| ||||| |
* Modulare Buchse RJ45 (''ohne Übertrager'') mit LEDs (oder Lichtleiter für SMD-LEDs) |
* Buchsenleisten zum Crimpen (allseitig anreihbar!, 1x1, 1x2, z.B. [http://www.newproduct.molex.com/datasheet.aspx?ProductID=92125 Molex 2081 ?] oder Harwin M20 ) ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||| |||||
* Für die LC-Displays: Adapterplatine mit anschlüssen im Raster 2,54mm (EA 9907-DIP) siehe http://www.lcd-module.de/ ||||| ||||| ||||| |||| |||
* TEXTOOL-Fassungen (Breite 7-15,24mm)/ Nullkraftsockel für kleine Mikrokontroller: DIL-20 ||||| || DIL-28 | PLCC-44 ||||| ||||| ||||| (und andere)
* Nullkraftsockel für SO- oder TQFP-Gehäuse (z.B. Yamaichi) ||||| ||||| |||||
* Nullkraftsockel für 6-Pin SOT23 (SOT23-6) z.B. für Programmierung v. PIC10F ||||
* Nullkraftsockel für DIL20 Gehäuse |
* Chipkartenkontaktiereinrichtung, die die Kontakte anhebt (keine Schleifkontakte) ||||| ||
* WOL-Verbindungskabel / Stecker / Print-Connectoren: |||||
* gängige Platinenverbinder einreihig RM 2mm mit 2-15 Kontakten (in vielen Geräten verwendet, z.B. [http://www.newproduct.molex.com/datasheet.aspx?ProductID=19945 Molex 51004, 53015]): ||||| Molex 71226 |||
* Floppy Stromversorgungstecker 3,5" Printausführung ||||| |
* Hochwertigere 1/4" Klinkenbuchsen, z.B. von Rean oder Cliff ||||
* mehrpolige, hochwertige Miniatursteckverbinder (z.B. http://www.binder-connector.de/pdfs/serien/711.pdf) |
* preiswerte! Hochspannungssteckverbinder >2kV ||||
* Höherwertige 3,5mm Klinkenbuchsen / -stecker (statt "EBS35" oder "KK(S/M) ..") ||||| ||
* Ordentliche Lautsprecherbuchsen "Strich-Punkt" (Print oder Wand) (die Stecker sind OK) |
* Schuko-Einbausteckdose (Maschinensteckdose) (mit oder ohne Klappdeckel); Flanschmaß möglichst klein (50mmx50mm); div. Farben (sw,grau,...) ||||| |||||
* Euro-Einbausteckdose (230V~, gab's früher mal) ||||
* Carrier-IC-Sockel
* JST HR Steckverbinder |||
* Wannenstecker(gerade) + Pfostensteckverbinder 6-Pol. (Pfostenbuchsen gibt es 6-Pol.) ||||| ||||| ||||| ||||| ||||| ( z.B. Harting SEK 18 Serie http://www.harting.com/en/en/de/sol/verbtech/prod/ios/description/03005/index.de.html)
* Wannenstecker 2,54mm Raster auch als SMD |||||
* Günstigere SD/MMC-Steckverbinder z.B.SDBMF-00915B0T2 von MULTICOMP(selbst bei Farnell für 1,80Euro) ||
* Einpolige Steckerleiste 2.54 |||||
* Foliensteckverbinder (FFC) RM1,25 (z.B. 9pol, 11pol ...) ||||
* Triaxstecker /-buchse (Coax mit 2.tem Schirm als 3. Kontakt) |
* vernünftige Koax-Stecker und Kupplungen z. Bsp. von Hirschmann
* Platinensteckverbinder für Rastermass 2,00mm ||||
* Molex Steckerreihe Minifit Jr 4,2mm Rastermaß (verwendet als Stromstecker in Computern, Mainboard, PCI-E, P4/EPS ...) |
* Mini SD Card Connector mit Auswurffunktion für Oberflächenmontage ||||
* Steckverbinder für PICTIVA OLED Display Folienkabel |||||
* Leiterplattenbuchse Hirschmann 4mm auch in *rot* (gab es schonmal als "PB 4 RT) ||
* E10-Schraubsockel, wie sie Glühbiren haben, mit Lötstiften (Achtung es ist nicht die Fassung gemeint) ||||
* RP-SMA-Buchse/-Stecker (gewinkelt/gerade) ||
* WAGO 215-4mm-Stecker (Bananenstecker mit Käfigzugklemme) zur schnellen Montage bei Versuchsaufbauten ||||| ||||| ||||
* Die PSK-Kontakte in anderen Packungen als 20/10k.100Stk. wäre z.b. gut.1k auch. |||
* OBD-Stecker. ||
* Adapterprogramm SMA auf SMB ausbauen |
* Micro-USB Steckverbinder |
* 2.5mm Stereo Klinkenbuchsen (3-polig) SMD ||
* BNC-Stecker (wie UG 88U, Lötmontage) aber für RG174-Kabel ||
* U.FL bzw. IPEX Steckbüchsen zum selbskonfektionieren von HF Kabeln |

=== Kabel etc. ===
* dünner Schaltdraht (< 1mm Durchmesser, isoliert mit Tefzel oder Kynar) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||
* Flachbandkabel im 2,54mm Raster und dazu passende Aufpressstecker und -buchsen ||||| ||||| ||||| ||||| |||||
* versilberten Kupferdraht auch < 0,6mm und alle Stärken in grösserer VPE (z.B. 500g Rolle) ||||||
* Flexible Einzellitze, 0,5² in verschiedenen Farben ||||| ||||| ||||| ||||| |
* bzw. angebotene Schaltlitze (H05VK) um weitere Farben erweitern! |||
* das qualitativ mangelhafte 4mm Laborsteckerprogramm rausnehmen und nur noch Hirschmann anbieten ||||| ||||| ||||| ||
* Zwillingslitze 2x0.14mm, z.B. Artikel: ZL214SWW-10M Kessler Elektronik |||||
* Heizdraht zB.: Kanthal A1 ||
* LYIF Litze (verschiedene Farben) ||||| |
* dickere Mantel(Feuchtraum)leitungen, z.B. NYM J5x10 |
* Folienflachkabel (FFC) RM1,25 (z.B. 9pol, 11pol ... /Länge 20cm) ||
* Flachbandkabel im 1,00mm Raster, passend für Pfostenverbinder PL 2X25G 2,00 . Wird für notebookplatten benötigt. ||||
*Folienflachkabel (FFC) RM 0,8 (z.B. 30pol. Länge125mm) für 8"TFT Monitor
* H155 (HF-Kabel) ||
* Schnepp "Laborkabel" Messleitungen ||
* Litze, LiY 0,25mm^2, diverse Farben (beispielsweise von Lapp Kabel) |

== Platinen/Prototypen ==
* Laser-Folien für die Druckformerstellung(Zweckform 3491) ||||| ||||| ||||| ||||| ||||| |||
* SOIC auf PDIP Gehäuse-Adapter zwecks Prototypen-Bau ||||| ||||| ||||| ||||| ||||| ||||
* Tonerverdichter (www.Huber-Troisdorf.com) ||||| ||||| ||||| ||||| |||||
* Adapter TQFP (versch. PinZahlen) auf DIL/QIL ||||| ||||| ||||| ||||| ||||| |
* Adapter QSOP (versch. PinZahlen) auf DIL/QIL ||||
* Lötstopplaminat ||||| ||||| ||||| ||||| |||
* www.schmartboard.com hat super einfach zu lötende SMD-Adapter in allen Größen, nur leider keinen Vertriebspartner in Deutschland (doch: ELV). Wie wäre es mit Reichelt? ||||| ||||| ||||| ||||| ||||| ||||
* Cadsoft Eagle ||||| |
* Hohlkehlenlötspitzen (Ersa 0832HD) ||||| |
* Hohlkehlenlötspitzen f. Weller MLR21 |||||
* Fotoplatinen, zweiseitig, Hartpapier(!) |||||
* Entwickler NaOH-Frei von Bungard (SENO 4007 Universalentwickler) |
* chemisches Zinnbad ||||| |
* Bungard-Fotoplatinen auch in 80x100mm (halbes Euroformat), nicht nur 75x100mm |
* Bungard-Fotoplatinen BLAU div. Formate |
* Fotoplatinen aus Hartpapier von Markenhersteller |

== Werkzeug und Zubehör ==
* robuste Allzweck- und Teppichmesser |||||
* zöllische Gewindeschneider g1/4" und g 1/8" insbesondere interessant für Wasserkühlungen |||
* einzelne Hartmetallbohrer in diversen Grössen (z.B. 0,8 1,0 1,3 1,5) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |
* Arbeitsschalen zum Entwickeln und Ätzen von Platinen(*) ||||| ||||| ||
* Gewindebohrer M2 und M2,5 ||||| ||
* Konturenfräser/Gravurstichel, etc. zum Fräsen von Platinenprototypen (z.B. Bungard G60N/G30N) ||||| |
* Tri-Wing Schraubendreher |
* Ballistol Universalöl |

== Unsortiert/Unspezifisch ==
* Kundenkarte so wie bei ELV (Grundgebühr für ein Jahr, keine Versandkosten, evtl kleiner Rabatt) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |
* Reichelt Katalog als PDF zum Download ||||| ||||| ||
* (durch pdf-download überflüssig:) der Reichelt Katalog auf CD/DVD ||||
* In Bereichen wie Multimedia etc. (z.B. Spielekonsolen) ein aktuelleres Angebot, und nich wie z.B. bei der PS2 erst wenn schon fast das Nachfolgemodell draussen ist (Multimedia ist hier nur ein Beispiel, einfach mal an der Konkurrenz orientieren (Zum beispiel am grossen C)
* mehr, aber als solche gekennzeichnete billig-Alternativprodukte, nicht nur High-End |
* Modellbau und Zubehör ||||| ||||| | (Wird immer mehr, man sieht, Reichelt hört dankenswerterweise auf diese Wishlist!!)
* mehr SMD Bauteile ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |
* HCT-Logik in SMD ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||
* Kleinere SMD-Bauformen (bes. bei ICs) ||||| |||||
* mehr und v.a. kleine (Hand-) Gehäuse ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||
* gleicher Mindestbestellwert in Österreich und in der Schweiz wie in Deutschland ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* gleicher Mindestbestellwert in Niederlande wie in Deutschland
* Kein Mindestbestellwert (ich bezahle eh' Porto) ||||| |||||
* Filialen in Österreich und der Schweiz :-) ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||| |||||| |||| (man beachte das ":-)", es gibt auch in D keine "Filialen" - mt)
* Versand nach Österreich über GLS oder sonstigen Paketdienst & auf Rechnung, damit die Spesen halbwegs im Rahmen bleiben (bei der letzten Bestellung ca. EUR 40) ||||| ||||| ||||| ||||| ||||| ||
* Günstige Versandkonditionen für die EU ||||| ||||| ||||| ||||| |||| |||
* Selbstabholer-Option bei der Bestellung. Vergisst man es unter "Bemerkung" kommt es per Post :( ||| (für Plz 26xxx kommt eine Option für Abholer, Tip: falsche Plz eintragen)
* Versand von Kleinteilen als Maxibrief, zwecks niedrigerem Versand ||||| ||||| ||||| ||||| ||||| |||
* Option zum anklicken beim Versand, "nichtverfügbare Artikel automatisch streichen", wenn man das ins Kommentarfeld schreibt wirds nicht beachtet, oder bis das jemand liest dauert es wieder mehrere tage. ||||| ||||
* mehr Familien von Logik-ICs, z.B. AC, ACT, LVC (in SMD) ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||
* LiPoly-Zellen (aufladbare Lithiumakkus "Suppentüten") ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Allgemein mehr Sensoren ||||| ||||| ||||| |||
* Preiswertere Alu Druckgussgehäuse, wie z.B. von Hammond Manufacturing ||||| ||||| |||
* nicht wie die Konkurrenz jetzt schon im April den Juli-Katalog rausbringen ||||| ||||| ||||
* Neuere, bessere NiMh Akkus (z.b. GP1100 2/3A, GP2000 AF, GP2200 4/5SubC) ||||| ||||| |
* Funk-Entstördrosseln 16A, div. Werte |||||
* Taster Schalter und LED-Fassungen aus der Mentor FEL-Reihe ||
* Lötfähige (SMD-) Kühlkörper (Fischer) ||||| ||||| ||||
* Toner für Laserdrucker Kyocera FS-1010 TK17 ||||| ist ja eigentlich der gängigste Kyocera Toner
* Microchip PICkit 2 ||||| |||
* Möglichkeit für Selbstabholen eine Bestellung unter 10Euro abzuliefern. |
* Bessere Auswahl: statt MSP430F147, F148, F149 wenigstens einen mit DAC -> MSP430F16x
* Cypress PSoC Mikrocontroller |||| |||| |||| |||| |
* Günstigere Osziloskope z.B. Multimetrix oder Grundig |||||
* Digitale Speicherosziloskope für PC ||||| |||
* Sortieren und Spezifizieren der Angebotsliste in Transistoren / FET (bessere Übersicht) ||||| ||||| ||| z.B. 400V/6A würde schonmal ganz grob helfen und senkt außerdem unnötigen Traffic weil nicht extra jedes Datenblatt angeschaut wird
* Vorschaltgeräte mit G23 Fassung (zum Bau von UV-Belichtern geeigent)|||
* Speicherkarten-Adapter von SD auf CF (bzw. CFII) ||
* ein Abendessen mit Angela :-) (hier dürfte wohl Angelika gemeint sein) |||
* USB-Leergehäuse (z.B. wie USB-Stick, WLAN-Dongle, o.ä.) ||||| ||
* Nicht so viele Tackerklammern/Gummibänder/Tesafilm/Beutel in die Verpackungstüten machen, das nervt beim Auspacken (die kaputten Tüten kann dann auch keiner mehr brauchen, die wenigen nicht kaputt getackerten hebe ich aber gerne auf! Aber bitte weiterhin alles getrennt verpacken... oder wenigstens nicht den Zip-Verschluss tackern) ||||| ||||| ||||| ||||| ||||| ||
* Reflektoren für 10mm LEDs |
* Beamer Casio YC-400
* OBD2 Kabel auf RJ45 Stecker |
* mehr Verpackungsmaterial z.B. kleine Schachteln oder die Plastik IC-"Schienen" einzeln (und unzerschnitten) verkaufen
* PCMCIA Wlan-Karten (Linux kompatibel) mit externem Antennenanschluss
* Warenkorb immer in gleicher Reihenfolge sortiert, nicht bei jedem Aufruf anders ||
* PIC_BASIC_II | Programm mit HardwareKey [z.B. für Azubi's]

==Messgeräte==
* FS300 Messgerät Antennenanalyzer Massenpreis 50000 Stück 
* Smart Tweezer (SMD-Pinzette mit Komponentenmessung) siehe [http://www.trgcomponents.de/TrgDE/Internet/ProductShow.aspx?ItemID=680&CategoryID=2426] |
* Hameg HM2008 Oziloscope || ( ist möglich über Service -> Produktservice -> neue Artikel anfragen)
*Tektronix TDS Series Osziloskope

= Bereits im Sortiment =

* Atmel AT91SAM7S32 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||| (=> Best.: AT 91SAM7S64-AU)
* Atmel AT91R40008 (32bit controller 256KB-RAM 100-lead TQFP) ||||| ||||| | (=> Best.: AT 91R40008)
* LCD: auch ein- und dreizeilige Variante der DOG-Serie (EA DOGM081 & 163) |||||
* Platinen Basismaterial, einseitig Cu-beschichtet, 0,5..1 mm dick ||||| ||||| ||| -->0,8mm: BEL 160x100-1-8
* Atmel ATtiny45 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| => ATTINY 45-20PU, ATTINY 45-20SU, ATTINY 45V-10PU, ATTINY 45V-10SU
* Atmel ATMEGA48 TQFP ||||| |||| => ATMEGA 48-20 AU
* Atmel ATMEGA 88 || => ATMEGA 88-20 AU, ATMEGA 88-20 PU, ATMEGA 88V-10 AU, ATMEGA 88V-10 PU
* Atmel ATMEGA644 ||||| ||||| ||||| ||||| => ATMEGA 644-20 AU, ATMEGA 644-20 PU, ATMEGA 644V-10AU, ATMEGA 644V-10MU, ATMEGA 644V-10PU
* Atmel ATMEGA2560 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| || => ATMEGA 2560-16AU, ATMEGA 2560V-8AU
* Atmel ATMEGA2561 ||||| | => ATMEGA 2561-16AU, ATMEGA 2561V-8AU
* Philips LPC2000-Serie ARM7-Controller (LPC214x, LPC213X, LPC21xx und LPC22xx) |||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| | => Bauelemente, aktiv / Controller, Speicher / Controller, Prozessoren / Philips-Controller 80C51 / 87LPC.. / 89C51
* TI MSP430F2xxx (Typen mit 16 MIPS) ||||| ||||| | => Bauelemente, aktiv / Controller, Speicher / Controller, Prozessoren / Texas MSP430 Controller
* Breadboards/"Steckbretter" ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||| => STECKBOARD 1K2V, STECKBOARD 2K1V, STECKBOARD 2K4V, STECKBOARD 3K5V, STECKBOARD 4K7V (zu finden unter 'Diverses/Spielwaren' :)
* RS485 ESD fest: MAX3086E oder 75180 oder ISL83086E ||||| || =>MAX485ECPA
* Microchip PIC 18F2550 || => PIC 18F2550-I/P
* Microchip PIC 16F88 |||| || => PIC 16F88-I/P
* Microchip dsPIC ||||| ||||| ||||| ||||| | => PIC 30F2010-30 SP/SO
* Logicanalyzer | => ME ANT 8 und ME ANT 16
* Atmel ATMEGA8 TQFP |||| => ATMEGA 8-16 TQ
* 3,3V Laengsregler (LT1086-Serie z.B.) ||||| => vgl z.B. [http://reichelt.de/?ARTIKEL=LT%201086%20CM3%2C3 LT 1086 CM3,3] (SMD) oder [http://reichelt.de/?ARTIKEL=LT%201086%20CT3%2C3 LT 1086 CT3,3] (TO-220) bei Reichelt
* Flexible Messleitungen: Wie gesagt Reichelt bietet ja die ganze Palette an Bananen/Laborsteckern, Krokodilklemmen usw. an, nur die Leitungen dazu fehlen im Programm. (Sind schon im Sortiment. Fertig konfektionierte z.B.: ML 100 SW, Meterware z.B.: MESSLEITUNG 10SW)
* FTDI USB Chips ||||| ||||| ||||| ||||| ||||| || => Best-Nr. FT232BL, FT232RL (sehr interessant), FT245BM und FT2232BM (2xUART auf USB)(noch nicht unter USB einsortiert)
* CAN-Bus Controller MCP2515 |||||
* VLSI MP3 Decoder ||||| ||||| ||||| | z.Zt. unter CAN-Bus(!) einsortiert. Bitte auch die neuen Gehäuse (ROHS) und Typen mit ins Angebot nehmen.
* Atmel AT90CAN128 ||||| |
* MMC / SDC slot ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ==> Bestell-Nr.: CONNECTOR MMC 11, CONNECTOR MMC 12, CONNECTOR SD 21 und CONNECTOR SD 22
* lineare Potentiometer als Schiebepoti ||||| | - Bestell-Nr. PSM-LIN* ("mono") PSS-LIN* ("stereo")
* Echtzeituhr DALAS DS1307 (auch SMD) ||||||| - Bestell-Nr. DS1307/DS1307Z
* Konkret: Neuer PIC ... und PIC18F2550 ||||| |||
* MSP430F1232 |
* Fädelstift, Draht und Kämme ||||| || - Bestell-Nr. Fädelstift/Fädeldraht/Fädelkamm (Warum sind diese Stifte ùnd der Draht nur so "erschreckend" teuer? => immerhin billiger als bei C...) (vielleicht weil jeder die nur 1x kauft und dann mit Draht aus anderen Quellen selber neu bewickelt?? ;-)
* Mini-GPS-Module ||||| ||||| ||||| ||||| ||| - Bestell-Nr. GPS ET 102/GPS ET 202/GPS EM 401
* Atmel ATmega48, ATmega168, ATtiny13 ||||| ||||| ||||| | (im neuen katalog und online verfügbar!)
* CompactFlash Stecker ||||| ||||| ||||| || - Bestell-Nr. connector CF 01/ Connector CF 02
* DCF77 Empfangsmodule ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| (DCF77 Modul) (4.5.2005 ist jetzt verfügbar unter DCF77 MODUL, aber leider 50% teurer als bei der Konkurenz, störempfindlicher, grotesk schwache Ausgangstreiber)
* Microchip PIC 12F683 (8pin PIC mit PWM !) => Bereits im Sortiment: Best. Nr PIC 12F683-I/P bzw. PIC 12F683-I/SN
* MSP430F135 ||||| ||||| | ||||| (MSP430F135 im Programm Bestellnr.: MSP430F135 IPM)
* SMD 0 Ohm in Bauform 0805 |||| -> SMD-0805 0,00
* Shunt-Widerstände ||||| ||||| ||||| ||||| | (neu im Sortiment: Widerstandsdraht, Best.-Nr. "RD100/x,xx", Leider nur in teuren 100g Spulen)
* dünner isolierter Draht, wie Klingeldraht nur dünner, vielleicht 0.2-0.3mm zum Fädeln von Platinen |||| => Fädeldraht nun im Sortiment
* dünner Silberdraht zur Verdrahtung auf Lochrasterplatinen ||||| | (mögl. bereits im Sortiment "SILBER 0,6MM" ???)Kupferlackdraht geht nicht?
* Hartmetallbohrer in mehr verschiedenen Größen (z.B. 0,6mm 0,8mm 1,1mm 1,2mm etc.) ||||| |||| => Gibt es beides Bestellnummern: "Bohrerset" oder für einzelne Bohrer "Bohrer + Größe in mm" Bsp: "Bohrer 0,6" => die kosten aber einiges, eine etwas preiswertere Alternative wäre auch nicht schlecht...
* 68HC908GP32 |
* überhaupt: Freescale 68HC908- und vor allem 68HCS08-Mikrocontroller fehlen total im Sortiment!
* RJ45-Buchse ||| - schon im Sortiment: MEBP 8-8''x'' unter Modular-Stecker bei TK
* Elektromotoren ||||| ||| (Suche: Gleichstommotor)
* Microchip ICD2 || => Bestell-Nr.: DV 164005 <= Fehlt im Papierkatalog
* 14,7456 MHz Quarze ||||| ||||| ||||| ||||| ||| (Bst: 14,7456-HC18)
* SMD Widerstande in Bauform 1206 (SMD 1/4W...)
* Atmel Atmega 128 in TQFP || (ATMEGA 128-16 TQ)
* Atmel Atmega 169 in TQFP || (ATMEGA 169-16 TQ)
* Atmel ATMEGA1280 ||||| ||||| ||||| |||| (ATMEGA 1280-16AU, ATMEGA 1280V-8AU)
* Atmel ATMEGA8515 | (ATMEGA 8515-*)
* Atmel ATtiny24/44 ||||| ||||| (ATTINY 24-*, ATTINY 44-*)
* Atmel ATtiny25/85 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| | (ATTINY-25-*, ATTINY-85-* gelistet aber erst verfuegbar ab II/07)
* Atmel AT91SAM7S64, AT91SAM7S256 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||| (suche AT91*)
* Atmel AT91SAM7X64-256 ||||| ||| (suche AT91*)
* TI MSP430F1611 (10k RAM, 48k Flash) ||||| ||||| ||||| ||||| ||||| ||||| || (MSP430F1611 IPM)
* PCA9306 Dual Bi-Directional I2C-Bus and SMBus Voltage Level-Translator ||
* PCA9531D 8Bit I2C_BUS LED-Dimmer ||||| |||||
* PCA9551D 8Bit I2C-BUS LED-Blinker ||||| ||||
* PCA9530D 2Bit I2C_BUS LED-Dimmer ||||| |
* PCA9532D 16Bit I2C_BUS LED-Dimmer ||||| |||||
* PCA9533D 4Bit I2C_BUS LED-Dimmer ||||| ||||
* PCA9550D 2Bit I2C-BUS LED-Blinker ||||| |
* PCA9553D 4Bit I2C-BUS LED-Blinker ||||| ||
* PCA9552D 16Bit I2C-BUS LED-Blinker ||||| |||
* Microchip PIC 18F2550 (USB, 32 KBytes Flash) | (bereits im Sortiment)
* Microchip PIC 16F628A (weil: besser als 16F628) ||||
* Microchip PIC 16F648 (weil mehr Programmspeicher, als 16F628) |||||
* Microchip PIC 16F684 |||||
* Microchip PIC 16F688 ||||| ||
* Microchip PIC 16F690 ||||| ||||| |||
* Atmel ATtiny84 ||||| ||||| |||| (gelistet aber erst verfuegbar ab II/07)
* TI MSP430F169 |
* FT245RL (alt bekannte FTDI Chips in neuer und besserer Version, FT232RL bereits vorhanden) ||||| ||
* 3,3V Längsregler SMD Ultra Low drop |||| (-> Zetex)
* Schiebepotis mit passenden Knöpfen | (Bestell-Nr. PSM-LIN* ("mono") PSS-LIN* ("stereo") nicht passed?) |
* OLED-Displays (zum Beispiel: [http://www.litearray.com/products-oled.php]) || (Reichelt hat jetzt Osram Pictiva Oleds im Programm. Nach "Pictiva" suchen)
* OSRAM "Golden Dragon" LEDs (http://www.osram-os.com/goldendragon) ||||
* Stift-/Buchsenleisten 2.54mm *zum Auseinanderbrechen* ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ("BL 1x<Polzahl>G 2,54" wird mittlerweile als teilbare Variante geliefert)
* Microcontroller mit USB-Anschluss (von Cypress oder Atmel in PDIP z.B. AT89C5131, AT43USB355, CY7C637xx) ||||| ||||| ||||| ||||| ||||| ->Bereits im Sortiment: Cypress EZ-USB TQFP-44 Best. Nr AN2131 SC, Atmel AT89C5131 SO-28/PLCC-52
* Renesas R8C
* zu Schaltreglern LM257x u.a. passende Speicherspulen mit hohem L , niedrigem R und großer Strombelastbarkeit (zB. Würth WE-PD4) (keine "Entstörspulen") ||||| ||||| ||||| ||||| ||||| ||||| |||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| || (suche L-PIS*)
* IL300 (linear Optokoppler z.B. von Vishay egal ob DIP oder SMD) ||||| ||||
* IL300H (linear Optokoppler von Siemens als DIP) - andere IL300 Varianten im Programm |||
* "optische" Drehgeber Fabrikat Grayhill sind lieferbar (Bst. ENC 62P22-*)
* mechanische Drehimpulsgeber von Alps im Programm (suche STEC*)
** Drehimpulsgeber (konkreter Vorschlag von O.R.: PEC16-4220F-S0024 von Bourns) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||
** Drehimpulsgeber- weiterer Vorschlag: ALPS Encoder ST EC 11B ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||| Im Programm (STEC11B01)
* PCA9633D16 4-bit I2C-bus LED driver ||
* I²C-Bus to 1-Wire DALLAS DS2482-100 bzw. DS2482-800 ||||| ||||| ||||| ||||| ||||| ||||
* Step-Down-Konverter in SMD Bauform (z.b. MC 34063): ||||| (->Artikel-Nr: MC 34063 AD)
* Preiswerte Kontaktierungen für SD/MMC ||| (Bereits im Programm: Bestell-Nummern: CONNECTOR MMC 11 / CONNECTOR MMC 12 / CONNECTOR SD 21 / CONNECTOR SD 22) // ~9 EUR sind wohl kaum preiswert!

= Wird es nicht geben =
* Eisen(III)-Chlorid ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||

* Warum nicht?
* Echt mal warum nicht?

= Sonstiges =

== zur Webseite ==

Besserer Umgang mit Cookies es kommt manchmal vor das der über längere Zeit erstellt Warenkorb plötzlich leer ist, trotzdas man keine Cookies löscht oder verhindert. Eine Exportfunktion so das diese evtl. selbst sichern und wieder einbinden kann. Bei einer Registrierung(Benutzername/Passwort) könnte man evtl. den Warenkorb Serverseitig speichern.

Eine Webseite ohne Frames ist eigentlich heute Stand der Technik. Oder vielleicht ist es das auch nicht mehr - ich weiss es nicht aber nach meiner Auffassung sollte es Stand der Technik sein. Denn dann hat man für jedes Produkt auch einen eindeutigen Link und kann ggf. auch in Beiträgen, Mails und Anfragen darauf verlinken.

Anmerkung dazu:
Verlinken auf Artikel geht schon, und zwar in der Form:
http://www.reichelt.de/?ARTIKEL=ATMEGA%208-16%20DIP
bzw.
http://www.reichelt.de/index.html?ARTIKEL=ATMEGA%208-16%20DIP

Neu zu lesen unter "Info zum Shop":
Zitat:
"Frames
In vielen Votings wurden wir auf die Verwendung von Frames hingewiesen und dass diese Technik nicht mehr -State Of The Art- sei. Dieser Meinung schliessen wir uns in vollem Umfang an. In unserem neuen Shop werden KEINE FRAMES verwendet."

Reichelt selbst macht das in seinen PDF-Prospekten auch so. Das Problem liegt nur darin, die URL jedesmal von Hand zusammenzubauen (und dabei auf die Ersetzung der Leerzeichen durch %20 zu achten) oder von einer kopierten URL alles überflüssige zu entfernen.

Einfach mal einen "Permalink" button neben "artikel empfgehlen" ? Oder zurück mit der früheren Druckansicht.

Hinweis: Viele Browser ersetzen Leerzeichen im Adressfeld automatisch durch %20.

----

Die Webseite sollte auch in Standard-Browsern wie FireFox korrekt angezeigt werden.

Ich nutze reichelt schon immer mit firefox, klappt doch alles.

Zitat aus "Info zum Shop":
"Getestet wurden unsere Seiten mit:
FireFox ab Version 1.5.0.7. für Windows und Linux
Opera ab Version 9.01 für Windows
Mozilla ab Version 1.7.13 für Windows
Netscape ab Version 8.1 für Windows
Internet Explorer ab Verion 6.0.28..."

----

Ferner sollte es möglich sein, Bestellungen, welche noch nicht bearbeitet werden zu verändern, also z.B. was hinzuzufügen oder zu entfernen. Bei einer Wartezeit von ca. 3 Tagen bis zum Versand fällt einem doch noch was ein :-)

Das wird bereits gemacht! Einfach E-Mail an service@reichelt.de mit den Bauteilen, die man noch haben will. I-Net-Nummer nicht vergessen.

Andere Möglichkeit ist anrufen, das mache ich eh immer, um eventuell nicht lieferbare Dinge zu streichen oder zu ersetzen. Geht immer, es sei denn Lieferung wird schon verpackt.
----

Shopprogramm: Wär es nicht komfortabel, ein Programm auf dem heimischen Rechner zu haben, welches das aktuelle Sortiment mit den aktuellen Preisen führt, wo dann auch offline Bestellungen zusammengestellt und hochgeladen werden können? So ließen sich die Merklisten auch besser verwalten.

Ja, das fände ich auch sehr toll, sollte man mal drüber nachdenken.

----

Passwortschutz: Die derzeitige Lösung der Anmeldung im Shop ist für den heutigen Stand der Dinge recht unsicher. Ein zur Kundennummer gehörendes Passwort sollte schon sein. Was soll schon passieren, die Versandadresse ist ja bekannt, und wenn jemand anderes auf meinen Namen bestellt. läßt er sich über die Versandadresse rausfinden, außerdem weiß ja auch nicht jeder meine Kundennummer.

----

Eine Art Lagerbestand im Onlineshop wäre sinnvoll. Es ist mehr als ärgerlich, wenn bei einer Bestellung z.B. Kleinteile wie Kondensatoren oder Schalter fehlen, weil sie nicht auf Lager waren. Dabei gibt es gerade bei solchen Teilen genug Alternativen, sei es Farbe, Bauart oder Wert, auf die man umsteigen könnte, damit die Bestellung vollständig ist. Es würde ja vollkommen ausreichen den Bestand in Form einer Ampel, wie bei anderen Shops, mit grün, gelb und rot zu realisieren.

Im Warenkorb werden Artikel, die nicht auf lager sind, mittlerweile auch so gekennzeichnet.

----

Früher würden neue Artiekle mit einem gelben "NEU" gekennzeichnet, jetzt ist das nicht mehr so. Hätte gerne wieder einen überblick was neu hinzugekommen ist ohne jede Artikelgruppe aufrufen zu müssen.
----

Nummerierung der Bauteile: Warum wird der Warenkorb nicht numeriert. Ich hasse es wenn ich manuell mit Hand zaehlen muss! Das ist auch nervig wenn man manuell per Hand vergleichen will!!

----

Virtuelle Bauteilekisten (vbox): Wer bei Reichelt bestellt ordert oft viele viele Kleinteile. Wenn man nun ein Gerät zum wiederholten mal baut, muss man alle Teile erneut eingeben. Könnte ich nun neben dem Warenkorb auch noch virtuelle Bauteilekisten füllen würde das neue Bestellungen sehr beschleunigen. Der Kunde als Wiederholungstäter sozusagen.

Konkret:
Ich habe vier verschiedene Elektronikprojekte entwickelt.Für jedes dieser Projekte lege ich bei Reichelt.de eine virtuelle Bauteilekiste mit eigenem Namen an. Die Zusammenstellung der Artikel funktioniert wie beim normalen Warenkorb. Wenn ich nun ein Projekt erneut bauen möchte, kopiere ich einfach den Inhalt der virtuellen Bauteilekiste per Knopfdruck in meinen Warenkorb. Wenn ich Projekt2 also dreimal nachbauen möchte kopiere ich die virtuelle Bauteilebox "Projekt2" dreifach in den Warenkorb.
Schön wäre es auch die virtuellen Bauteilekisten mit Schaltplan und ev. Eagle - Dateien veröffentlichen zu können.

Konkret:
Ich habe eine Schaltung entwickelt für die ich eine persönliche virtuelle Bauteilekiste bei Reichelt.de zusammengestellt habe. Jetzt gebe ich meine persönliche virtuelle Bauteilekiste mit einer Kurzbeschreibung und einem Link auf meine Homepage(Projekthomepage) auf vbox.reichelt.de frei. Gleichzeitig setze ich auf meiner Homepage einen link auf meine öffentliche "vbox" bei Reichelt. Die öffentliche "vbox" ist dabei nur eine Referenz auf die persönliche "vbox" (synchron) und ist nur von mir veränderbar.
Ich hoffe die Idee ist verständlich formuliert.

EDIT: Nur so nebenbei - in anderen Shops geht das bereits RUDIMENTÄR (natürlich nicht mit öffentlichem Zugang...) in Form von Merkzetteln - die kann man meist unbegrenzt lang speichern und später einfach immer wieder in den Warenkorb legen. Das sollte das mindeste sein was man dem Kunden in einem modernen Shopsystem bietet!

Und wieso ist der Login, den es früher mal gab weg? Da konnte man zumindest den aktuellen warenkorb speichern soweit ich mich erinnern kann, aber seit der neuen Website gibt's den Login nicht mehr. Ausserdem muss ich jetzt jedesmal meine Kundennummer rauskramen um meine Bestellung abzusenden - Conrad löst das beispielsweise besser. (dafür haben die aber auch ne besch...eidene Suchfunktion und nen unübersichtlichen Shop)

Nebenanregung:
Damit die "Bauteilekisten" nicht unmengen Platz beim Anbieter verschwenden könnte man diese auslagern.
Also Nach erstellen Download als einfaches File und bei Bedarf einfach bei Bestellung übertragen.
So könnte sie jeder in Ruhe offline vorbereiten und verwalten.

Einfacher Kompromiss: Ein einfacher CSV-Import, -Export (Text mit Tabulator oder Semikolon getrennt) währe auch eine Alternative. Im aller einfachsten Fall könnte man das über eine Textbox realisieren. So könnte man auch eigene Projekte schneller eingeben bzw. sichern.

Ich habe ein Makro für MS Excel gesschrieben, welches die Daten aus einer Tabelle in den Warenkorb von Reichelt Elektronik überträgt.
--> http://pierreone.pi.funpic.de/makros/Reichelt-St%FCcklisten-Wizard.html

IDEE: Offenlegung der Datenbank: Offenlegung der Datenbank oder zumindest Export fuer die User. Somit koennten die Datenbank in eine Art Datenbank gespeichert werden. Als Katalogprogramm koennte dann soetwas aehnliches wie das von Segor zum Einsatz kommen. Gibt es einen Standard dann koennten Reichelt, Conrad, Segor, etc. mit einem Programm genutzt und verglichen werden:
siehe auch http://www.mikrocontroller.net/forum/read-7-363596.html
Programmierunterstuetzung findet sich bestimmt. Abgesehen davon haben die Distributoren den Vorteil die Katalogdaten uebers Internet upzudaten.

Zum offenlegen der Datenbank: Wie wäre es mit einem Webservice, mit dem man über SOAP auf die Datenbank zugreifen kann? Ähnlich wie bei Amazon oder auch Google.

Aktuell bei Reichelt: unter MyReichelt sollen Kunden sich einloggen können und BOMs getrennt speichern können und in einem Rutsch zum Warenkorb hinzufügen können, sowie auch Links zu diesen BOMs erstellen können, die dann jeder einsehen kann. Siehe auch http://www.mikrocontroller.net/topic/62628

Lösung in HTML: 
Ich hatte für das Projekt [http://www.mikrocontroller.net/topic/82127 "Webserver ATmega32/644DIP ENC28J60"] ein Bestellformular ([http://www.mikrocontroller.net/attachment/29451/reichelt.htm reichelt.htm] [Version vom 22.12.2007]) gebastelt um schnell alle nötigen teile in den Reichelt – Warenkorb zulegen. Mit etwas HTML-Kenntnis dürfte eine Anpassung nicht das Problem darstellen. 
In JavaScript, des '''reichelt.htm''' Bestellformulars, die Funktion <code>'''send()''' ''Zeile 42:'' var maxElements = 40;</code> die '''40''' durch die Anzahl der unterschiedlichen Bauteile Anpassen.

== zu Artikeln ==

* Kupferlackdraht: Auf der Website sind Plastikspulen abgebildet, geliefert wird jedoch seit Jahren schon lose aufgewickelter Draht, der so schlecht zu verarbeiten ist. Bitte ändern! Am besten vernünftigen Draht auf Spulen, zumindest aber das Bild anpassen.

* Spitze fände ich eine verbesserte Suche für Gehäuse. Oft stehe ich vor dem Problem, meine Baugruppe ist so-und-so groß und ich brauche ein Gehäuse, in das diese Baugruppe hineinpasst. Zur Zeit muss ich mich manuell durch alle Gehäusegrößen "durchwühlen", bis ich ein passendes gefunden habe. Die Suche stelle ich mir so vor: Ich gebe die Maße ein, die das Gehäuse mindestens haben ''muss'', und bekomme alle Gehäuse angezeigt, die genau so groß oder etwas größer sind als meine Vorgaben.

== Abwicklung ==

* Sammelbestellung: Wenn ich etwas bei Reichelt bestelle, bestelle ich für meine Kollegen auch immer etwas mit. Wenn dann das Päckchen kommt, heisst es sortieren. Wer hatte von was, wie viel? Danach kommt das rechnen dran. Ein besonderes Highlight, sind die Nettopreise. Und auch das Verteilen der Versandkosten ist nicht ohne. Währe es nicht möglich, im Bestellvorgang eine Zuordnung zu Personen oder Projekten zu realisieren, und die Zwischensummen der Personen oder Projekte auf der Rechnung oder per Mail anzugeben. Ein Schmankerl wäre die Angabe der Bruttopreise inklusive der anteiligen Versandkosten.
** Wahrscheinlich nicht möglich, siehe AGB-Klausel zu Massenbestellungen. "Garantieberechtigt" ist auch immer nur der ursprüngliche Besteller.
** Welche Klausel? Mir fällt nur 13.3 ins Auge...

== zu dieser Wunschliste ==

(gehört eigentlich in Diskussion)

* Wäre es möglich ein Script zu bauen, welches man ab und zu über diesen Artikel jagt und das die Einträge nach Anzahl der Striche ordnet?

* Dass hier jeder immer nur einen Strich macht, glaube ich nicht! Ein Script was pro IP nur einen Strich zulässt wäre gut. -> Naja, alle 24h spätestens gibt es eigendlich eine neue IP...

* Warum macht der 5te nicht anstelle |||| ein V :-) und anstelle vom nächsten V kommt dann ein X ....Daniel [[Benutzer:84.179.17.164|84.179.17.164]] 20:11, 4. Feb 2006 (CET)

* Wenn Reichelt was aus der Liste neu ins Programm aufnimmt wäre eine Benachrichtigung per Newsletter oder RSS nett. Oder zumindest eine Rubrik "Seit XX.XX.200X neu im Programm".

== Logbuch ==
03.08.2007: Das Feld für "neue Artikel" scheint aus dem Reichelt Shop entfernt worden zu sein, schade da man so schnell schauen konnte was neu im Programm ist, nun ist wieder Katalogblättern angesagt. - Nicht nachvollziehbar. siehe Startseite->Service->Neu in unserem Shop

18.05.2007: Habe Reichelt an diese Liste erinnert. -- Robin Tönniges

14.11.2006 Ich lese mir gerade euer Wishlist durch. Finde ich gut! Aber wie ihr
hier (Logbuch) über Reichelt kritisiert finde ich nicht fair! Die haben genug zu arbeiten! Bitte keine Vorurteile! Um das gehts mir hauptsächlich!
Macht weiter nur nicht so!
P.S. Schöne inforeiche Site
Steven

6.8.2006 Habe eine umfassende Kritik zu Reichelts neuem Webshop geschrieben und dabei auf unsere Wünsche bzl. Webseite, insbesondere "Virtuelle Bauteilebox" und "Gehäusesuche" hingewiesen. Verlinkung auf diese Seite ist auch erwähnt worden.

5.8.2006 Hurra, Reichelt bietet endlich den ATtiny13V an! Jetzt können wir Batteriebetriebene Geräte (2,4-3V) bauen. By the way: Gibt es blaue LED's, die dazu passen?

14.7.2006 Reichelt antwortete: (Zu lang, deshalb hier nur der Inhalt:) Wir haben ihre mail zur Kenntnis genommen (Forum wird angeblich ab und zu immer wieder kontrolliert). Entscheidender Satz (Original eines Mitarbeiters:)....Ich denke jedoch, dass die meisten und
wichtigsten Wünsche zum Herbstkatalog eingelistet werden.

14.7.2006 Reichelt erneut auf diesen Beitrag aufmerksam gemacht, erwarte Antwort.

3.7.2006: beitz-online.de eine verlinkung gemailt. Ich hoffe das ist erlaubt.

5.3.2006: Verlinkung gemailt

12.10.2005: Verlinkung gemailt und gebeten sich darum zu kümmern

07.10.2005: Reichelt eine Verlinkung gemailt und speziell auf LOW ESR Elkos und 433 Mhz Funkmodule hingewiesen. Mal sehen was die Antworten.

08.07.2005: Reichelt bescheid gegeben, man möge mal wieder hier rein schauen -- Thomas O.

13.05.2005: Antwort von Reichelt: der Versand ins Ausland bleibt leider bei 150 Eur -- nurmi

09.05.2005: Reichelt bescheid gegeben, man möge mal wieder hier rein schauen -- nurmi

08.05.2005: Pflege der Liste hier: Wenn ihr was in der Liste seht, was bereits schon im Angebot ist, löscht es bitte! Sonst ist das hier bald ein unüberschaubares Chaos. -- [http://www.reintechnisch.de Winfried Mueller]

08.02.2005: Positives Feedback von Reichelt. Freuen sich über diese Form der Anregung. In der 2. Märzhälfte sollen weitere Produkte in den neuen Katalog einfließen. -- [http://www.reintechnisch.de Winfried Mueller]

07.02.2005: Reichelt bescheid gegeben, man möge mal wieder hier rein schauen -- [http://www.reintechnisch.de Winfried Mueller]

Reichelt-Wishlist

2008-05-05T14:40:38Z

129.247.247.238: /* Platinen/Prototypen */

== Reichelt Wunschliste ==

Auf dieser Seite können Wünsche zur Erweiterung des Reichelt-Lieferprogramms eingetragen werden. Es ist keine offizelle Wunschliste von Reichelt und es ist nicht bekannt, ob Reichelt-Mitarbeiter diese Seite regelmässig sichten. Reichelt sollte sicherheitshalber regelmäßig angeschrieben werden, damit diese Liste nicht in Vergessenheit gerät.

Damit sich die beliebtesten Artikel herauskristallisieren, macht jeder einfach '''einen''' virtuellen Strich dahinter: | (Windows: ALT-GR Taste und < Taste drücken, Mac OS X: Alt-Taste und 7 Taste drücken). Alle fünf Striche (|||||) bitte immer ein Leerzeichen einfügen.

Neue Artikel einfügen darf und soll natürlich auch jeder - aber bitte die Liste vorher durchgehen (Tipp: Browser-Suchfunktion nutzen)! Einfach ganz viele Striche auf einmal hinter einem Artikel einzufügen ist zwecklos. Das erkennt man in der History und es gibt viele Leute, die diese Seite überwachen...

'''Nicht sinnvoll''' ist etwas sehr exotisches, wie z.B. einen ganz bestimmten super schnellen AD-Wandler hier aufzulisten! Neue Artikel müssen sich für Reichelt ja auch rentieren und wirtschaftlich "an den Mann bringbar" sein.

= Wunschliste =
== Halbleiter ==
=== Controller/FPGA/CPLD ===

* ALTERA MAX-II (CPLDs) ||||| ||||| ||
* ALTERA CPLD EPM30xx - Familie ||
* ALTERA CPLD EPM70xx - Familie ||||| ||||| ||||| |||||
* ALTERA Flex10K - Familie |||
* ALTERA Cyclone2 - Familie ||||| ||||| ||||| ||
* Atmel AVR32 im TQFP |||| |
* Atmel AVR mit USB AT90USB82, AT90USB162, AT90USB646, AT90USB1286 und AT90USB1287 ||||| |||
* Atmel ATtiny261 (auch 461; bevorzugt DIP) ||
* Atmel Atmega 16L und 32L in TQFP (waere ATMEGA 16/32L8 TQ) ||||
* Atmel ATmega324P in TQFP und PDIP |||||
* Atmel ATmega644p in TQFP |||||
* Atmel AVR Controller mit Funkanbindung z.B. AT86RF230, AT86RF211, AT86RF401, dazu passende Quarze (evtl. SMD) 18,080 MHz (Crystek P/N 016758), Spulen 39nH. ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||| |
* Atmel AT90PWM3B (µC für Servosteuerungen und z.b. Motorsteuerungen) ||||| ||||| ||||| |||
* Atmel AT89LP4052 PDIP ||||| |||||
* Atmel Dream Sound Synthesizer Chips, z.B. ATSAM3103 und ATSAM3308 ||||| ||||
* Atmel XMega wie ATMega16 Belegung bedrahtet nicht SMD sondern normale Bauform ||||
* Axis Etrax 100LX Risc Processor (kostenloses Linux-System vorhanden) ||||||||
* Freescale Prozessoren (Coldfire) (16 + 32 Bit) ||
* Freescale DSP56F801 ||||
* Freescale HCS12 Controller ||||| ||||| ||||| |||||
* Freescale MC9S08QG8 (DIP 16) ||||| ||||
* Freescale MC9S08QEx |
* Infineon XC866 ||||| ||||| ||||| ||||| |
* Lattice ispMACH 4032C / 4064C / 4128C ||||
* Luminarymicro Stellaris Serie (Cortex-M3) |
* Microchip PIC 10F2xx (+ Programmiergerät) |||| ||||| ||||| |||
* Microchip PIC 18F2585 |||
* Microchip PIC 18F4523 (12/2007: PIC mit 12-Bit A/D-Wandler) |
* Microchip PIC 18F4550 (PIC mit USB) ||||| ||||| |||| ||||| ||||| ||||
* Microchip PIC 18F6585
* Microchip PIC 24 ||||| ||||| ||
* Microchip mehr dsPIC30F |||||
* Microchip dsPIC33 ||||
* Microchip PIC32 (MIPS) ||||| |
* NXP LPC214x-Serie ARM7-Controller ||||| ||||| |
* NXP LPC23xx/24xx ||
* NXP SAA5281 Videotextinterface ||||| |||
* Parallax Propeller CPU, 8 Cogs - DIP 40 ||||| ||||| ||||| |||
* Renesas M16C |||||
* Silabs C8051F320 USB Mikrocontroller ||
* SSV DIL/NetPCs [http://www.dilnetpc.com]http://www.dilnetpc.com ||||| ||||| |||
* ST ST7MC... (µC für Servosteuerungen, und vor allem Brushless-Motoren) ||||| ||
* ST STR7 Serie (ARM7TDMI) |
* ST STM32 Serie (Cortex-M3) |
* TI TMS470 Arm7 ||||| |||| ||||| ||||| |
* TI MSP430F167, TI MSP430F168 |||
* TI MSP430F2001/2/3 etc. im RSA-Gehäuse ||||| |
* TI TUSB3210 ||||| ||
* Ubicom SX20 SX28 IP2022 ||
* Zilog Z8 Encore-Microcontroller (bis 64k Flash, I²C, SPI, 2xUART, ADC, on-Chip Debugger ...) [http://www.zilog.com/products/family.asp?fam=225]www.zilog.com |||||
* Zilog ZNEO-Microcontroller (Z16Fxxx, bis 128k Flash, 4k RAM, bis zu 76 I/Os, 3 Timer, 10-bit A/D, externer Daten-/Adressbus, on-Chip Debugger) [http://www.zilog.com/products/family.asp?fam=236] www.zilog.com |
* CY7C68013A-56PVXC (Cypress EZ-USB FX2LP) ||
* XC3S 400 TQ144 |
* Mehr FPGAs (v.a aktuellere) von Xilinx, z.B. Spartan III , ALTERA CYCLONE II (v.a. auch größere Typen, die noch im TQFP-Gehäuse zu haben sind wie z.B. XC3S400 oder XC3S500E (PQFP208)) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Ajile aj-100 (Java Real-Time Prozessor) |
* Western Design Center 65c816 ||

=== Speicher ===
* Atmel DataFlash, z.B. AT45DB081B (8 MBit Flash-Speicher an seriellen Bus im 8poligen Gehäuse) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* NexFlash spiFlash NX25P16 (16MBit serial Flash im SO8-Gehäuse) ||||| ||||| |||||||
* Schnelles RAM (10, 15 oder 20ns, z.B. Samsung K6R1008C1D-UI10) (5V/3,3V) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||
* RAMs (SRAM oder DRAM) mit ordentlicher Kapazität (z.B. HY57V641620HG oder besser) ||||| ||||| ||
* 3.3V DRAM |||
* 3.3V async SRAM ab 16KByte ||
* 24LC256 oder 24AA256 oder 24LC512 oder 24AA512 ||||| ||||
* FPGA Konfigurations-EEPROMS AT17LV256, AT17C65/128/256.../XCF04S/... ||||| ||||| |
* EEPROM mit SPI Schnittstelle 25XX Serien ||||| |
* F-RAM mit SPI von RAMTRON |||

=== ICs ===
* National Semiconductor CLC020 und CLC021 Parallel Component nach SDI-Converter ||
* Ethernet-Controller RTL8019AS und Übertrager FB2022 oder 20F-001N ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Ethernet-Controller CS8900A ||||| |
* SPI-Ethernet-Controller ENC28J60 und passender Übertrager und passenden '''Grundton'''-Quarz (25,0000 MHz Grundton) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||| ||||| ||||| ||||| ||||| |
* DP83848C (Ethernet Physical Layer Transceiver/PHY, MII/RMII-Schnittstelle, passend zu AT91SAM7X) |||
* Ethernet-Connector RJ-45 mit integriertem Übertrager (z.B. Taimag RJLBC-060TC1) ||||| ||||| |
* ADS8320 ADC 16 Bit seriell ||||| ||||| ||||| ||||| ||||| |||
* DAC7612 DAC 12 Bit seriell ||||| ||||| ||||| ||||| ||
* DTMF-Dekoder-Enkoder (8870, 8880) ||||| ||||| ||||| ||||| ||||
* AD7524 in SMD ||||| |||| |||||
* MCP23016 16Bit I²C I/O Expander ||||| ||||| ||
* ISD 5116 (Sprachaufnahme bis 16min & I2C-Interface) ||||| ||||| |||||
* I²C-Bus Temperatursensor DS1631Z ||||| ||||| ||||| |||
* RS485 isoliert: z.B. Burr-Brown ISO485 o.ä. |||||
* Maxim MAX629, MAX1795, MAX1703 (Aufwärtsregler / Step-Up-Konverter) ||||| |||| ||||| |
* DAC8830 IDT (16Bit-DAC,ser. Input) ||||| |
* MAX6958 / MAX6959 (I²C 4-Digit, 9-Segment LED Display Drivers with Keyscan) |||| ||||
* LM3886 ||||| |
* Leistungs-OP LM675 von National ||
* ZHB6718 (H-Bridge für 1,5V - 20V Motoren) |||| |||||
* Philips PCA82C252 oder TJA1054A oder vergleichbar ("Fault-Tolerant" CAN Transceiver, 11898-3) ||||| ||||
* Maxim Switched Capacitor Tiefpass-Filter (z.B. MAX297, MAX7410) |||||
* Philips PCA9555 (I2C IO, 16 Bit par. I/O, c't Project Soundcheck II) ||||
* ISD 2560 -> SOIC Gehäuse (Sprachaufnahme IC) ||||| |
* MCP25050 CAN-Bus Input/Output Expander ||||| ||||
* STP08CL596M SO16 STM, LOW VOLTAGE 8-BIT CONSTANT CURRENT LED SINK DRIVER ||||
* STP16CL596M SO24 STM, LOW VOLTAGE 8-BIT CONSTANT CURRENT LED SINK DRIVER |||
* STP16CL596B1R DIP24 STM, LOW VOLTAGE 16-BIT CONSTANT CURRENT LED SINK DRIVER ||
* STP08CL596B1 DIP16 STM, LOW VOLTAGE 8-BIT CONSTANT CURRENT LED SINK DRIVER ||
* MAX6675 Typ-K Thermoelement nach SPI ||||| ||||| |||||
* Motortreiber TLE 4205 |||
* LTC24xx |||
* MAX6650 ||
* QT511-ISSG (iPod-like Touch-Wheel-Sensor ''siehe'' [http://www.qprox.com/products/qwheel_qt510.php]) ||||| ||||
* DDS-IC von Analog wie AD9833, AD9835 ||||| ||||| ||||| ||||| ||||| |||
* IP101 PHY von IC+ (Distri für DE [http://www.topas.de/tt/cfs/icp_cfs_mai05.htm Topas]) ||
* UDN 2987 LW (Source Driver UDN2987 in SMD-Bauform) ||
* MAX7311AWG 2Wire Interface von Maxim ||
* IR2011 MOSFET Treiber |||
* MAX 4420 Mosfet Driver ||
* MAX 4429 Mosfet Driver ||
* CCS-Akkulade-IC (z.B. CCS9620SL) (siehe [[http://bticcs.com/]]) |||||
* LM1117MPX-1.8 und LM1117MPX-3.3 (SMD-Spannungsregler SOT-223) |||||
* LTC1694-1 (I2C/SMBus Accelerator) |||
* P82B86 (I2C Dual Bi-Directional Bus Buffer) ||
* CS5641 von Cirrus...The CS5461 incl. two delta-sigma A/D converters.... ||
* DS1616 von Dallas Datalogger-IC |
* TEA5757 FM-Tuner IC von Philips |||
* TEA5768HL FM-Tuner IC von Philips |||||
* VS1053 MP3/AAC/WMA/Ogg Decoder von VLSI ||
* TH3122 K-Line Interface von MELEXIS ||||
* MAX7313 16 LED-PWM-Dimmer (Im gegensatz zu den Philips-ICs ist jede einzelne LED-Dimmbar, dafür nur in 16 Schritten) ||||| ||||
* LMX2306/LMX2316/LMX2326 PLL Synthesizer von National ||||| |
* MAX127/128 8-Kanal 12bit ADC mit I2C interface |||
* MIC6315 von Micrel (3,3/5V Reset Baustein mit manual Reset) ||
* MMI4832 (Geber Interface Baustein EnDat, SSI, Incrementalgeber ||
* CP2120 single-chip SPI to I2C bridge and GPIO port expander |
* AD623 Single Supply,Rail-Rail, InstrOpamp |||||
* AD628 InstrOpAmp, high voltage inputs |
* L6205 Motortreiber (2Kanal, 2,8A, DMOS)|||||
* TLV2382ID Rail-Rail-OP von TI |
* TLV320AIC23B Audio-Codec ||
* Cypress CY7C67300 dual role USB controller mit OTG |||||| ||||| ||||| ||||| ||
* High Side Current Sense ICs wie MAX4172 |||||
* LM397, LM321 o.ä. single op-amp in SOT23-5 5-30V supply ||
* LTC3490 ||||| |||
* QT160 6-fach Touch Sensor IC |||
* TPIC6B595 (oder ähnliche 74xx595 high current (150 mA) shift register) ||
* HV9910 Schaltregler für die Hochleistungs LED^s Ub=8-450V; I beliebig; Eff. besser 90% |||
* LM267X SimpleSwitcher Step-Down-Konverter in SO-8 Bauform |
* Schnellere und gleichzeitig günstige OpAmps; Beispiel AD8055 ||

* Clock generator IC's, z.B. PCK20?? von Philips |
* uC supervisor chips + watchdog z.B.: MAX6864 ist z.Z. der beste (0.2uA!) |||
* Mehr FET-Treiber (TI UCC3372x, HIPxxx , die neueren Brückentreiber von Maxim ||||| |
* D/A Wandler mit 4 oder mehr Ausgängen, z.B. TLC5620/TLV5629/AD5325 ||||| ||||| |
* PLL Schaltkreise für Frequenzerzeugung. z.B. MC / ML145170 (SOIC16) / TSA5060A ||||| ||||| |||
* Digital Potentiometer (z.B. 2-Wire MAX546x, AD526x, X9C10x) ||||| ||||| ||||| ||||| ||
* Power over Ethernet Bausteine z.B. LM7050
* Automotiv ICs z.B. LM1815, LM1915, LM1949, LM9011, LM9040, LM9044, LMD18400... ||||| |
* 16-bit A/D-Wandler (waren von Maxim schon im Programm, sind aber wieder herausgeflogen?) |||
* Video-AD-Wandler z.B. LTC2208 (16 Bit 130 MS/s) für FPGA und SDR |
*MAX528 8-fach 8Bit DAC mit Output Buffer seriell |
*LM1117 - 3,3V SOT-223 ||


* Ethernet Magnetics (Auch POE) ||||| |||
* Generell mehr DAC's (auch die teureren) von TI |||||
* Generell mehr I2S IC (ADC, DAC, DSP, u.a. Crystal, BurrBrown etc.) |
* Generell mehr I²C IC ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||
* Generell mehr 1-Wire IC ||||| ||||| ||||| ||||| ||||| ||||| |
* Generell mehr PWM-SIC's ||
* Generell mehr SPI IC ||||| ||||| ||||| ||| (viele µC haben SPI aber kein I2C )
* 74VHC-Serie komplettieren (z.B. 74VHC125D) ||||| |
* MagJacks ||

=== Diskrete ===
* LM317EMP oder LM317AEMP SMD-Spannungsregler einstellbar (SMD TO-223 Gehäuse) ||||| ||||| |||
* L4941 Spannungsregler 5V/1A in SMD-Ausführung (DPAK) ||||| |||
* LM2734 Schaltregler ||
* MIC29300/29301 Spannungsregler 5,0V 3A im TO263(SMD) Gehäuse ||
* MC78LCxx Serie - Ultra Low Drop Spannungsregler 3-5 Volt mit 1 Mikro-Ampere Ruhestrom ||||| ||
* R-783.3-0.5 Schaltregler 4,75V - ca. 18V Eingang; 3,3V Ausgang (Hersteller Recom) ||||||
* R-785.0-0.5 Schaltregler 6,5V - 30V Eingang; 5,0V Ausgang (Hersteller Recom) ||||
* R-785.0-1.0 Schaltregler, Ausgang 5,0V, 1A |
* ZRA250F005 Referenzspanungsquelle 2,5V 0.5% SOT23 gehäuse ||||| ||||
* Spannungsregler in SMD-Version (7805 etc., nicht nur der 78L05) ||||| ||||| ||||| ||||| ||||| ||||| |||
* 3,3V-Längsregler SMD zu vernünfitgen Preisen (Bsp: LF33 --> Best.Nr.: LF 33 CV, Preis: 0,76€)(der LT1086 kostet 4 Euro) ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Größere Auswahl an Step-up Reglern ||||| ||||| ||||| ||||| |||
* 5,2V Lowdrop Längsregler LF52 im TO252AA von STM |||||
* Spannungsregler SMD in DPAK ||||| ||||| ||||| |

* IPW60R045CS Infineon Mosfet 600V 45mOhm Rdson 30ns tr+tf (niedrigster Rdson in der Klasse) |
* SPP20N60C3 Infineon Mosfet 600V 190mOhm Rdson <10ns tr+tf (Schnellste Schaltzeit in der Klasse) ||||| |
* SDT06S60 Infineon SiC 600V 6A Silizium-Carbid Schottky-Diode (kein trr, daher keine Schaltverluste) |||
* mehr FETs und IGBTs (nichtnur IRF, sehr gut IXYS <- und sauteuer!) ||||| |||
* Digitaltransistoren (BCR*), auch als Pärchen NPN/PNP (BCR10, BCR08pn) ||||| ||||
* Niederohm-FETs in SO8, N und P ||||| |||||
* Si4562DY N- and P-Channel 2.5-V (G-S) MOSFET SMD ||||| ||||| |
* IRF7503/IRF7506 Dual Mosfet SMD ||||| ||||
* PhotoMOS Relay (z.B. AQV257 von Panasonic; http://www.mew.co.jp/ac/e/control/relay/photomos/index.jsp) |
* IPS5451S intelligenter Leistungsschalter 50 V, 35 A, 25 mΩ |
* BSH205 P-Channel 1.5V(GS), 0.75A, 12V D-S |
* SMD Doppeldiode Schottky 12A 60V im TO252AA z.B. 12CWQ06FN von IOR ||||| ||||| ||||| |
* IR3313 o.ä. Intelligenter Leistungsschalter 32V/90A, einstellbare Strombegrenzung |

* BUF420AW Schaltnetzteil Transistor von STM |||||
* Philips PDTD113E/123E und PDTB113E/123E (PNP und NPN im sot23 mit internen Widerständen für Basis und PullUp/Down ||
* 2SC1971 Transistor mit hoher Frequenz und viel Leistung für Endstufen |

== Sensoren/Aktoren ==
* Sensirion SHT11/SHT71 (oder auch SHT15/SHT75) ||||| ||||| ||||| ||||| ||||| ||||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Sharp Entfernungssensoren (zb den GP2D120 oder den GP2D12) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||
* kleine Feuchtigkeitssensoren zur 'on-board-Montage' ||||| ||||| ||||| ||||| |
* IS471 Selbstmodulierende IR-Lichtschranke ||||| ||||| ||||| ||||| |||
* FSRs (Force Sensing Resistor) von Interlink Electronics ||||| ||||| |
* Drehwinkelgeber, Gyro, Kreiselsensoren ähnl. Tokin CG-L43 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||
* Summer mit 20mA@5V ähnlich Conrad Nr.751553 (TDB05 kann mit 30mA@5V nicht von allen Controllern direkt getrieben werden) ||||| ||||
* NanoMuscle Aktuatoren ||||| |||||
* Flexinol |||||
* Hall-Sensor UGN3503, KMZ51 ||||| ||||| |||
* Magnetfeld-Sensor (Kompass-Anwendung) KMZ52 ||||
* günstige Temp. Sensoren TC77 ||||| ||||| |
* Motorola/Freescale Drucksensoren z.b. MPX4250 mit AP Druckanschluss ||||| ||||| ||||| ||||| ||
* K-Typ (J-Typ) Thermocouple Temperatursensoren und passende Steckverbinder ||||| |||||
* Induktions-Stromsensoren Coilcraft #J9199-A o.ä. ||||
* Durchflussmesser (z.B. wie Conrad Nr.155374) ||||| ||||| |
* Linear- und 360° Soft-Pots wie von spectrasymbol ||||
* iMEMs Acceleration Sensors ADXL Series von Analog Devices ||||| ||||| ||
* LEM Stromsensoren (Transducer) der HAIS-Serie, speziell HAIS 50-P und 100-P ||||| ||||| |
* Allegro Stromsensoren (z.B. ACS713, ACS756) |
* 4Hz Supersense µblox LEA-4S GPS module (Importer pointis.de) + Passende Passives Patch antenna (zB. von inpaq.com) ||||
* Hallsensoren z.B. TLE4905 wieder ins Programm nehmen ||
* Anemometer ||
* TSic Temperatursensoren von ZMD |||
* Piezo Minimotoren/Lienearaktoren von Elliptec/Siemens einzeln und günstig ||
*Temperatursensor mit SPI-Interface LM74 |

== Baugruppen ==
* Atmel ATNGW100 von [http://www.atmel.com/dyn/corporate/view_detail.asp?FileName=AVR32NGKit_3_26.html Atmel] = billiges Linux Board ($69=51.69€) --> [http://www.avrfreaks.net/wiki/index.php/Documentation:NGW/NGW100_Hardware_reference Dokumentation] ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Atmel ATSTK600 von [http://www.atmel.com/dyn/products/tools_card.asp?tool_id=4254 Atmel] |
* Atmel ATSTK1000 von [http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3918 Atmel] ||||| ||||| ||||| |||
* Atmel AVR Dragon von [http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3891 Atmel] ||||| ||||| ||||| |||||
* Axis Etrax 100LX MCM (Multi Chip Module) A full Linux computer on a single chip! ||||| |||||
* CentiPad/DevKit Embedded Linux Modul ([http://www.centipad.de www.centipad.com]) ||||| ||
* DS9490R USB zu 1-Wire Dongle (auch mit Linux Treiber) |||
* Easy-Radio Module zur seriellen Datenübertragung (ER400 RS/TS/RTS) ||||| ||||| ||||| |
* Foxboard = Betriebsfertiges Micro Linux System mit Axis Etrax 100LX MCM 66mm x 72mm ||||| ||||| ||||| |||||
* FoxVHDL = FPGA Erweiterungskarte für das ACME Foxboard ||||
* kostengünstige Funkschaltmodule (TLP/RLP) ||||| ||||| ||||| ||
* kostengünstige Funkempfänger/Funksender 433 & 868 Mhz ||||| ||||| ||||| ||||| ||||| ||||| ||||
* Lantronix XPort Embedded Device Server ([http://www.lantronix.com www.lantronix.com]) ||||| ||
* low-cost Experimentierplatinen für FPGA ||||| ||||| |||||
* Mini-Bluetooth Module (RS232-Bluetooth-"Wandler"-Platinchen) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||| |||
* Mini-WLan Module (RS232 zu WLan) ||||| ||||| ||
* MT1390 FM Tuner-Modul von Microtune |||
* NetDCU8 von F & S Elektronik Systeme GmbH (http://www.fs-net.de) - Linux-Computerplatine mit 400MHz Samsung-ARM mit 32MB RAM, 16MB Flash und SD/Ethernet/CAN/USB/TFT/RS232 für ca. 100 Euro ||||| ||||| ||
* OM5610 FM Tuner-Matchbox von Philips |||
* TI - MSP430 Wireless Development Tool (AEC13895U) |
* Gyro Sensoren MURATA, ENC-03J A/B ||

== "Passive" Bauteile ==

=== Spulen etc. ===
* Ordentliche Trafospulen + Kerne, z.b. ETD-Serie, oder RM10 ||||| ||||| ||||| ||||| ||||| ||||| ||||
* Passende Ferrite dazu: N27,N41,N67,N87,N97 ||||| ||||| ||||| ||||| ||
* Magnetics CoolMu Ringkerne ||||| |||||||
* Magnetics MPP Ringkerne ||||| ||||| ||
* Die Micrometals Pulverkerne (-18 und -26) auch in größer ||||| |
* Funk-Entstördrosseln 16A, div. Werte ||||| ||||
* Funk-Entstördrosseln 47µF |||
* Würth Induktivitäten ||||| ||||| |||
* Übertrager für Schaltregler z.B. Epcos Typ B78304 |||||

=== Kondensatoren ===
* Low-ESR Elkos (definiertes Fabrikat/Typ, und nicht einfach irgendwelche! (Rubycon?)) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||
* Low-ESR Elkos RM 3,5mm 1.000uF 6,3V (Mainboardaustausch Elko) |
* Low-ESR SMD Tantal-Elkos (definiertes Fabrikat/Typ, und nicht einfach irgendwelche! (AVX?, Epcos?)) ||||| ||||| ||||| |||||
* Zum MAX232 so20 passende SMD-Kerkos im Wert 1uF (0805,0603, 1206) ||||| ||||| ||||| ||||
* Generell SMD-Kerkos im Wert > 100nF ||||| ||||| |||||
* Kleine Niedervolt-Polyproplyenkondis mit mehr Kapazität ||
* Wima MKP4 ||||
* Wima MKP-X2 (~275V, klein und ideal für Kondensatornetzteile) |
* Günstige hochkapazitive Doppelschichtkondensatoren (z.B. Maxfarad MES2245 220F 2,3V) ||||
* Keramikkond. SMD 0603/0805/1206: mehr Zwischenwerte (56p, 82p, 560p) ||||| |
* Drehkondensator 20-500pf |

=== Widerstände ===
* SMD-Widerstande in Bauform 0603 0402 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* SMD-Widerstände 0805 und 1206 auch unterhalb von 1 Ohm ||||| ||||| ||||| |||
* SMD-Widerstände unterhalb 1 Ohm, andere Gehäuse als 0805/1206 (leichter erfüllbarer Wunsch) |||||
* SMD-Widerstände 0805 auch aus der E24-Reihe ||||| ||||| |||||
* Durchsteck-Widerstände in kleiner Bauform 0204. ||||| ||||
* R2R-Widerstandsnetzwerke (z. B. 10/20kOhm für DA-Wandler an Microcontrollern) ||||| ||||| ||||| ||||| ||||| ||||| |||
* Präzisionswiderstände 0,05% und besser, ev. Drahtgewickelt ||||| ||||| |||||
* Niederohm-Widerstände (Shunts ab 1mOhm im guten Gehäuse z.B. TO220) ||||| ||||| ||||| ||||| ||||| ||
* 25/50W-Widerstände (~20/50 Ohm auch weniger) ||||| ||||| ||||
* Präzisions-Spannunsgteilernetzwerke ||||| ||||
*Präzisionsspannungsteiler 1:10, 1:100, 1:1000 (10MOhm Gesamtwiderstand) ||
* SMD-Präzisionswiderstände (0,1% TC10ppm/K =>0,1W indukt.arm) ||||| ||||| |||
* Null-Ohm Widerstände (Drahtbrücken) Baugröße wie 1/4W |||

=== Quarze und Quarzoszillatoren ===
* SMD-Quarze mit Standardgehäuse (z.B. HC49/US & HC49/UP) ||||| |||
* Quarzoszillator 9,8304 Mhz ||
* Quarz mit 3,200 Mhz |
* 13,5600 MHz Quarz (benötigt für RFID) ||
* Quarz mit 13,56 MHz (SMD+bedrahtet) |
* 24,0000 MHz Standardquarz Grundton ('''kein 3. Oberton!!!''') (benötigt für USB-DMX-Interface) | ||
* 25,0000 Mhz '''Grundton'''-Quarz (wird benötigt für Microchip TCP/IP Controller ENC28J60) ||||| |||
* Allgemein mehr Grundtonquarze bei höheren Frequenzen |
* SMD Quarze/ Oszillatoren in flachen, kleinen SMD Gehäusen (SMX-A/-B) ||

=== Sonstiges ===
* Varistoren 14V auch als bedrahtetes Bauteil (für KFZ-Bordnetz) ||||| ||
* Suppressordioden mit Spannungsbereich zwischen 15V und 30V |
* die Auswahl läßt hier sehr stark nach
* Netzfilter FFP Reihe Schurter |
* Metallbrückengleichrichter für 50A ||

== HF Baumaterialien ==
* Filter SFE10.7MA19 360khz SZP2026 |
* Keramische Filter CFM455... ganzes Sortiment |||
* Quarze 32 MHz 10ppm Oscillatorfrequenz 0 bis +70°C
* Quarze 6,500000 MHz ||
* MC68160FB
* S3C4510B
* MT48LC4M32B2TG-7
* MC68EN302PV20
* Zirkulatoren ALD4302SB statt LM239
* Transistoren MRFG35010
* µP Compatible CTCSS Encoder,Decoder FX 365
* Durchführungskondensatoren 1nF/160V (waren Ende '06 noch im Programm) |||
* ZF-Quarzfilter für versch. Frequenzen (10, 20, 40 MHz) |
* MMICs und Ringmischer von Mini-Circuits
* PLL ICs z.B. von NXP und National für HF-UHF ||
* MICRF002/022, MICRF102/103 von Micrel |||||

== Optoelektronik und Leuchtmittel ==
* low current SMD LEDs (z.B. Osram LG T679 - Anm.: hier gleich die neuen Varianten Lx T67K bestellen, nicht die alten 9er) ||||| ||||| ||||| |||
* SMD LED Bauform 0402 rot/gelb/grün/blau/weiss ||||| ||||| ||||| |||
* weisse SMD LED Bauform 0603 ||||| ||||| ||||
* warm weisse LED ||||| ||||| ||||
* OSRAM Hyper TOPLEDS weiss LW T67C-T2U2-5K8L ||
* OSRAM Halogen Decostar 51 12V 20W GU5,3 statt des billigen NoName Zeugs ||
* OSRAM Hyper TOPLEDS gelb LY T676-S1T1-26 ||
* Everlight SMD-RGB (fullcolor) 19-337/R6GHBHC-A01/2T ||||
* 7-Segment-Anzeige, allgemein Low-Current bzw. High Efficiency Versionen anbieten ||||| |||
* 7-Segment-Anzeige, blau, gem. Anode ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* 7-Segment-Anzeige, weiss, gem. Kathode ||||| ||||| ||||| |||||
* 7-Segment-Anzeige, weiss, gem. Anode ||||| ||||| ||||| ||||| ||||| |
* 7-Segment-Anzeige, blau, gem. Kathode ||||| ||||| ||||| ||||| ||||
* Diese 4-Stelligen Dot-Matrix LED Anzeigen Siemens SLG 2016 oder von HP oder ähnliches |||||
* Generell alle 7-Segment-Anzeigen auch in Blau und bis zu 100mm höhe |
* Vakuum-Fluoreszenz-Displays (Dot Matrix mit Standardcontroller, z.B. Futaba "LCD Emulators") ||||| ||||
* IL207AT (SMD Optokoppler von Infineon) ||||| ||
* ILD256T (SMD AC-Optokoppler) ||||| |||||
* ILD620 (DIP Optokoppler) ||||| ||||| ||||| ||
* SFH6106, SFH6206 4 Pin Optokoppler SMD ||||||
* TLP113 (SMD Optokoppler) |||||
* Vactrol Optokoppler (mit Fotowiderstand zur Analogsignalregelung) |||||
* IR-Diode mit viel power ttp://www.lc-led.com/Catalog/department/36/category/49/1 |
* IrDA-Tranceiver TFDS4500 (oder TFDU4100) wieder anbieten (war im 07/2005er Katalog noch drin) ||||| |||
* Seoul Zled P4 (100lm bei 350mA, 240lm bei 1A!) ||||| |||||
* Generell: Z-Power LEDs von Seoul (günstiger und heller als Luxeon) ||||| ||
* Seoul Z-LED RGB auf Platine ||
* EA DOG-M128 128x64 Grafikdisplay aufbau ähnlich EA DOGM162 ||||
* TLP 3617

== Mechanisches ==
* Getriebemotoren wie RB35 oder RB40 ||||| ||||
* Muttern M2 ||
* Zylinderkopfschrauben M2,5 x 12mm ||||
* Zylinderkopfschrauben M2,5 x 20mm ||||
* Zylinderkopfschrauben M2,5 x 30mm ||||
* Zylinderkopfschrauben M3 x 25mm |||||
* Bopla ABP oder ABPH 800-100 (10cm) Aluprofil Gehäuse |
* microSD / Transflash sockel mit push-push technik (ist nervig die immer für teuren versand aus amiland kommen zu lassen) ||||| ||||| ||||| ||||| |||||
* M2 Gewindebohrer und Senker ||

=== Schalter/Potis etc. ===
* Drehimpulsgeber DDM Hopt+Schuler 427 SMD (evt auch normal, stehend & liegend) ||||| ||||| ||||| ||||| |||||
* Folientastaturen ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||
* Drucktastenfeld Matrix 3x4 ||||| ||||| ||||| |||
* kleiner Joystick wie beim Atmel Butterfly ||||| ||||| ||||| ||||| ||||| ||||| ||
* statt Radiohm potis bitte Prehostat oder Alphastat 16 63256-026xx ||||| ||||| |||
* Drehschalter Serie DS in allen Versionen nur vom Hersteller C&K; auch brückende Versionen anbieten ||||| |||||
* bistabile Relais mit 2 Wicklungen ||||| ||||| ||
* passende Touchpanels für die coolen Blue-Line-Grafikdisplays ||||| ||||
* mehrpolige Fußschalter, FS 35 bitte bei Druckschalter einordnen |||
* möglichst kleine und flache Druckschalter rastend! ||||
* iPod-Wheel (Siehe: IC's=>QT511-ISSG; siehe 360° Soft-Pots - weiter oben) |||
* Taster Radiohm ST-1034 in rot, grün, gelb, blau, grau und schwarz
* Leitplastikpotis im Servogehäuse |
* Relais mit hohen Wirkungsgrad (daher nur geringer Spulenstrom nötig) |
* Tastköpfe für Taster9308, wie zb Omron B32-2000 oder B32-2010 |
* Batteriehalter für 4 Mignonzellen mit Lötfahne (statt Druckknopf) |
* SMD-Schiebeschalter |||
* Hohlwellen-Drehgeber (z.B. EC35B-Serie von Alps) ||
* Taster und Kappen aus der Multimec-Reihe |

=== (Steck-) Verbindungen ===
* Modulare Buchse RJ45 mit Übertrager und LEDs für Ethernet 10/100, z.B. SI-40138 MagJack von BEL-STEWART oder Taimag RJLBC-060TC1 ||||| ||||| |
* Modulare Buchse RJ45 (''ohne Übertrager'') mit LEDs (oder Lichtleiter für SMD-LEDs) |
* Buchsenleisten zum Crimpen (allseitig anreihbar!, 1x1, 1x2, z.B. [http://www.newproduct.molex.com/datasheet.aspx?ProductID=92125 Molex 2081 ?] oder Harwin M20 ) ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||| |||||
* Für die LC-Displays: Adapterplatine mit anschlüssen im Raster 2,54mm (EA 9907-DIP) siehe http://www.lcd-module.de/ ||||| ||||| ||||| |||| |||
* TEXTOOL-Fassungen (Breite 7-15,24mm)/ Nullkraftsockel für kleine Mikrokontroller: DIL-20 ||||| || DIL-28 | PLCC-44 ||||| ||||| ||||| (und andere)
* Nullkraftsockel für SO- oder TQFP-Gehäuse (z.B. Yamaichi) ||||| ||||| |||||
* Nullkraftsockel für 6-Pin SOT23 (SOT23-6) z.B. für Programmierung v. PIC10F ||||
* Nullkraftsockel für DIL20 Gehäuse |
* Chipkartenkontaktiereinrichtung, die die Kontakte anhebt (keine Schleifkontakte) ||||| ||
* WOL-Verbindungskabel / Stecker / Print-Connectoren: |||||
* gängige Platinenverbinder einreihig RM 2mm mit 2-15 Kontakten (in vielen Geräten verwendet, z.B. [http://www.newproduct.molex.com/datasheet.aspx?ProductID=19945 Molex 51004, 53015]): ||||| Molex 71226 |||
* Floppy Stromversorgungstecker 3,5" Printausführung ||||| |
* Hochwertigere 1/4" Klinkenbuchsen, z.B. von Rean oder Cliff ||||
* mehrpolige, hochwertige Miniatursteckverbinder (z.B. http://www.binder-connector.de/pdfs/serien/711.pdf) |
* preiswerte! Hochspannungssteckverbinder >2kV ||||
* Höherwertige 3,5mm Klinkenbuchsen / -stecker (statt "EBS35" oder "KK(S/M) ..") ||||| ||
* Ordentliche Lautsprecherbuchsen "Strich-Punkt" (Print oder Wand) (die Stecker sind OK) |
* Schuko-Einbausteckdose (Maschinensteckdose) (mit oder ohne Klappdeckel); Flanschmaß möglichst klein (50mmx50mm); div. Farben (sw,grau,...) ||||| |||||
* Euro-Einbausteckdose (230V~, gab's früher mal) ||||
* Carrier-IC-Sockel
* JST HR Steckverbinder |||
* Wannenstecker(gerade) + Pfostensteckverbinder 6-Pol. (Pfostenbuchsen gibt es 6-Pol.) ||||| ||||| ||||| ||||| ||||| ( z.B. Harting SEK 18 Serie http://www.harting.com/en/en/de/sol/verbtech/prod/ios/description/03005/index.de.html)
* Wannenstecker 2,54mm Raster auch als SMD |||||
* Günstigere SD/MMC-Steckverbinder z.B.SDBMF-00915B0T2 von MULTICOMP(selbst bei Farnell für 1,80Euro) ||
* Einpolige Steckerleiste 2.54 |||||
* Foliensteckverbinder (FFC) RM1,25 (z.B. 9pol, 11pol ...) ||||
* Triaxstecker /-buchse (Coax mit 2.tem Schirm als 3. Kontakt) |
* vernünftige Koax-Stecker und Kupplungen z. Bsp. von Hirschmann
* Platinensteckverbinder für Rastermass 2,00mm ||||
* Molex Steckerreihe Minifit Jr 4,2mm Rastermaß (verwendet als Stromstecker in Computern, Mainboard, PCI-E, P4/EPS ...) |
* Mini SD Card Connector mit Auswurffunktion für Oberflächenmontage ||||
* Steckverbinder für PICTIVA OLED Display Folienkabel |||||
* Leiterplattenbuchse Hirschmann 4mm auch in *rot* (gab es schonmal als "PB 4 RT) ||
* E10-Schraubsockel, wie sie Glühbiren haben, mit Lötstiften (Achtung es ist nicht die Fassung gemeint) ||||
* RP-SMA-Buchse/-Stecker (gewinkelt/gerade) ||
* WAGO 215-4mm-Stecker (Bananenstecker mit Käfigzugklemme) zur schnellen Montage bei Versuchsaufbauten ||||| ||||| ||||
* Die PSK-Kontakte in anderen Packungen als 20/10k.100Stk. wäre z.b. gut.1k auch. |||
* OBD-Stecker. ||
* Adapterprogramm SMA auf SMB ausbauen |
* Micro-USB Steckverbinder |
* 2.5mm Stereo Klinkenbuchsen (3-polig) SMD ||
* BNC-Stecker (wie UG 88U, Lötmontage) aber für RG174-Kabel ||
* U.FL bzw. IPEX Steckbüchsen zum selbskonfektionieren von HF Kabeln |

=== Kabel etc. ===
* dünner Schaltdraht (< 1mm Durchmesser, isoliert mit Tefzel oder Kynar) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||
* Flachbandkabel im 2,54mm Raster und dazu passende Aufpressstecker und -buchsen ||||| ||||| ||||| ||||| |||||
* versilberten Kupferdraht auch < 0,6mm und alle Stärken in grösserer VPE (z.B. 500g Rolle) ||||||
* Flexible Einzellitze, 0,5² in verschiedenen Farben ||||| ||||| ||||| ||||| |
* bzw. angebotene Schaltlitze (H05VK) um weitere Farben erweitern! |||
* das qualitativ mangelhafte 4mm Laborsteckerprogramm rausnehmen und nur noch Hirschmann anbieten ||||| ||||| ||||| ||
* Zwillingslitze 2x0.14mm, z.B. Artikel: ZL214SWW-10M Kessler Elektronik |||||
* Heizdraht zB.: Kanthal A1 ||
* LYIF Litze (verschiedene Farben) ||||| |
* dickere Mantel(Feuchtraum)leitungen, z.B. NYM J5x10 |
* Folienflachkabel (FFC) RM1,25 (z.B. 9pol, 11pol ... /Länge 20cm) ||
* Flachbandkabel im 1,00mm Raster, passend für Pfostenverbinder PL 2X25G 2,00 . Wird für notebookplatten benötigt. ||||
*Folienflachkabel (FFC) RM 0,8 (z.B. 30pol. Länge125mm) für 8"TFT Monitor
* H155 (HF-Kabel) ||
* Schnepp "Laborkabel" Messleitungen ||
* Litze, LiY 0,25mm^2, diverse Farben (beispielsweise von Lapp Kabel) |

== Platinen/Prototypen ==
* Laser-Folien für die Druckformerstellung(Zweckform 3491) ||||| ||||| ||||| ||||| ||||| |||
* SOIC auf PDIP Gehäuse-Adapter zwecks Prototypen-Bau ||||| ||||| ||||| ||||| ||||| ||||
* Tonerverdichter (www.Huber-Troisdorf.com) ||||| ||||| ||||| ||||| |||||
* Adapter TQFP (versch. PinZahlen) auf DIL/QIL ||||| ||||| ||||| ||||| ||||| |
* Adapter QSOP (versch. PinZahlen) auf DIL/QIL ||||
* Lötstopplaminat ||||| ||||| ||||| ||||| |||
* www.schmartboard.com hat super einfach zu lötende SMD-Adapter in allen Größen, nur leider keinen Vertriebspartner in Deutschland (doch: ELV). Wie wäre es mit Reichelt? ||||| ||||| ||||| ||||| ||||| ||||
* Cadsoft Eagle ||||| |
* Hohlkehlenlötspitzen (Ersa 0832HD) ||||| |
* Hohlkehlenlötspitzen f. Weller MLR21 |||||
* Fotoplatinen, zweiseitig, Hartpapier(!) |||||
* Entwickler NaOH-Frei von Bungard (SENO 4007 Universalentwickler) |
* chemisches Zinnbad ||||| |
* Bungard-Fotoplatinen auch in 80x100mm (halbes Euroformat), nicht nur 75x100mm |
* Bungard-Fotoplatinen BLAU div. Formate |
* Fotoplatinen aus Hartpapier von Markenhersteller |

== Werkzeug und Zubehör ==
* robuste Allzweck- und Teppichmesser |||||
* zöllische Gewindeschneider g1/4" und g 1/8" insbesondere interessant für Wasserkühlungen |||
* einzelne Hartmetallbohrer in diversen Grössen (z.B. 0,8 1,0 1,3 1,5) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |
* Arbeitsschalen zum Entwickeln und Ätzen von Platinen(*) ||||| ||||| ||
* Gewindebohrer M2 und M2,5 ||||| ||
* Konturenfräser/Gravurstichel, etc. zum Fräsen von Platinenprototypen (z.B. Bungard G60N/G30N) ||||| |
* Tri-Wing Schraubendreher |
* Ballistol Universalöl |

== Unsortiert/Unspezifisch ==
* Kundenkarte so wie bei ELV (Grundgebühr für ein Jahr, keine Versandkosten, evtl kleiner Rabatt) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |
* Reichelt Katalog als PDF zum Download ||||| ||||| ||
* (durch pdf-download überflüssig:) der Reichelt Katalog auf CD/DVD ||||
* In Bereichen wie Multimedia etc. (z.B. Spielekonsolen) ein aktuelleres Angebot, und nich wie z.B. bei der PS2 erst wenn schon fast das Nachfolgemodell draussen ist (Multimedia ist hier nur ein Beispiel, einfach mal an der Konkurrenz orientieren (Zum beispiel am grossen C)
* mehr, aber als solche gekennzeichnete billig-Alternativprodukte, nicht nur High-End |
* Modellbau und Zubehör ||||| ||||| | (Wird immer mehr, man sieht, Reichelt hört dankenswerterweise auf diese Wishlist!!)
* mehr SMD Bauteile ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |
* HCT-Logik in SMD ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||
* Kleinere SMD-Bauformen (bes. bei ICs) ||||| |||||
* mehr und v.a. kleine (Hand-) Gehäuse ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||
* gleicher Mindestbestellwert in Österreich und in der Schweiz wie in Deutschland ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||
* gleicher Mindestbestellwert in Niederlande wie in Deutschland
* Kein Mindestbestellwert (ich bezahle eh' Porto) ||||| |||||
* Filialen in Österreich und der Schweiz :-) ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||| |||||| |||| (man beachte das ":-)", es gibt auch in D keine "Filialen" - mt)
* Versand nach Österreich über GLS oder sonstigen Paketdienst & auf Rechnung, damit die Spesen halbwegs im Rahmen bleiben (bei der letzten Bestellung ca. EUR 40) ||||| ||||| ||||| ||||| ||||| ||
* Günstige Versandkonditionen für die EU ||||| ||||| ||||| ||||| |||| |||
* Selbstabholer-Option bei der Bestellung. Vergisst man es unter "Bemerkung" kommt es per Post :( ||| (für Plz 26xxx kommt eine Option für Abholer, Tip: falsche Plz eintragen)
* Versand von Kleinteilen als Maxibrief, zwecks niedrigerem Versand ||||| ||||| ||||| ||||| ||||| |||
* Option zum anklicken beim Versand, "nichtverfügbare Artikel automatisch streichen", wenn man das ins Kommentarfeld schreibt wirds nicht beachtet, oder bis das jemand liest dauert es wieder mehrere tage. ||||| ||||
* mehr Familien von Logik-ICs, z.B. AC, ACT, LVC (in SMD) ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||
* LiPoly-Zellen (aufladbare Lithiumakkus "Suppentüten") ||||| ||||| ||||| ||||| ||||| ||||| |||||
* Allgemein mehr Sensoren ||||| ||||| ||||| |||
* Preiswertere Alu Druckgussgehäuse, wie z.B. von Hammond Manufacturing ||||| ||||| |||
* nicht wie die Konkurrenz jetzt schon im April den Juli-Katalog rausbringen ||||| ||||| ||||
* Neuere, bessere NiMh Akkus (z.b. GP1100 2/3A, GP2000 AF, GP2200 4/5SubC) ||||| ||||| |
* Funk-Entstördrosseln 16A, div. Werte |||||
* Taster Schalter und LED-Fassungen aus der Mentor FEL-Reihe ||
* Lötfähige (SMD-) Kühlkörper (Fischer) ||||| ||||| ||||
* Toner für Laserdrucker Kyocera FS-1010 TK17 ||||| ist ja eigentlich der gängigste Kyocera Toner
* Microchip PICkit 2 ||||| |||
* Möglichkeit für Selbstabholen eine Bestellung unter 10Euro abzuliefern. |
* Bessere Auswahl: statt MSP430F147, F148, F149 wenigstens einen mit DAC -> MSP430F16x
* Cypress PSoC Mikrocontroller |||| |||| |||| |||| |
* Günstigere Osziloskope z.B. Multimetrix oder Grundig |||||
* Digitale Speicherosziloskope für PC ||||| |||
* Sortieren und Spezifizieren der Angebotsliste in Transistoren / FET (bessere Übersicht) ||||| ||||| ||| z.B. 400V/6A würde schonmal ganz grob helfen und senkt außerdem unnötigen Traffic weil nicht extra jedes Datenblatt angeschaut wird
* Vorschaltgeräte mit G23 Fassung (zum Bau von UV-Belichtern geeigent)|||
* Speicherkarten-Adapter von SD auf CF (bzw. CFII) ||
* ein Abendessen mit Angela :-) (hier dürfte wohl Angelika gemeint sein) |||
* USB-Leergehäuse (z.B. wie USB-Stick, WLAN-Dongle, o.ä.) ||||| ||
* Nicht so viele Tackerklammern/Gummibänder/Tesafilm/Beutel in die Verpackungstüten machen, das nervt beim Auspacken (die kaputten Tüten kann dann auch keiner mehr brauchen, die wenigen nicht kaputt getackerten hebe ich aber gerne auf! Aber bitte weiterhin alles getrennt verpacken... oder wenigstens nicht den Zip-Verschluss tackern) ||||| ||||| ||||| ||||| ||||| ||
* Reflektoren für 10mm LEDs |
* Beamer Casio YC-400
* OBD2 Kabel auf RJ45 Stecker |
* mehr Verpackungsmaterial z.B. kleine Schachteln oder die Plastik IC-"Schienen" einzeln (und unzerschnitten) verkaufen
* PCMCIA Wlan-Karten (Linux kompatibel) mit externem Antennenanschluss
* Warenkorb immer in gleicher Reihenfolge sortiert, nicht bei jedem Aufruf anders ||
* PIC_BASIC_II | Programm mit HardwareKey [z.B. für Azubi's]

==Messgeräte==
* FS300 Messgerät Antennenanalyzer Massenpreis 50000 Stück 
* Smart Tweezer (SMD-Pinzette mit Komponentenmessung) siehe [http://www.trgcomponents.de/TrgDE/Internet/ProductShow.aspx?ItemID=680&CategoryID=2426] |
* Hameg HM2008 Oziloscope || ( ist möglich über Service -> Produktservice -> neue Artikel anfragen)
*Tektronix TDS Series Osziloskope

= Bereits im Sortiment =

* Atmel AT91SAM7S32 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||| (=> Best.: AT 91SAM7S64-AU)
* Atmel AT91R40008 (32bit controller 256KB-RAM 100-lead TQFP) ||||| ||||| | (=> Best.: AT 91R40008)
* LCD: auch ein- und dreizeilige Variante der DOG-Serie (EA DOGM081 & 163) |||||
* Platinen Basismaterial, einseitig Cu-beschichtet, 0,5..1 mm dick ||||| ||||| ||| -->0,8mm: BEL 160x100-1-8
* Atmel ATtiny45 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| => ATTINY 45-20PU, ATTINY 45-20SU, ATTINY 45V-10PU, ATTINY 45V-10SU
* Atmel ATMEGA48 TQFP ||||| |||| => ATMEGA 48-20 AU
* Atmel ATMEGA 88 || => ATMEGA 88-20 AU, ATMEGA 88-20 PU, ATMEGA 88V-10 AU, ATMEGA 88V-10 PU
* Atmel ATMEGA644 ||||| ||||| ||||| ||||| => ATMEGA 644-20 AU, ATMEGA 644-20 PU, ATMEGA 644V-10AU, ATMEGA 644V-10MU, ATMEGA 644V-10PU
* Atmel ATMEGA2560 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| || => ATMEGA 2560-16AU, ATMEGA 2560V-8AU
* Atmel ATMEGA2561 ||||| | => ATMEGA 2561-16AU, ATMEGA 2561V-8AU
* Philips LPC2000-Serie ARM7-Controller (LPC214x, LPC213X, LPC21xx und LPC22xx) |||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| | => Bauelemente, aktiv / Controller, Speicher / Controller, Prozessoren / Philips-Controller 80C51 / 87LPC.. / 89C51
* TI MSP430F2xxx (Typen mit 16 MIPS) ||||| ||||| | => Bauelemente, aktiv / Controller, Speicher / Controller, Prozessoren / Texas MSP430 Controller
* Breadboards/"Steckbretter" ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||| => STECKBOARD 1K2V, STECKBOARD 2K1V, STECKBOARD 2K4V, STECKBOARD 3K5V, STECKBOARD 4K7V (zu finden unter 'Diverses/Spielwaren' :)
* RS485 ESD fest: MAX3086E oder 75180 oder ISL83086E ||||| || =>MAX485ECPA
* Microchip PIC 18F2550 || => PIC 18F2550-I/P
* Microchip PIC 16F88 |||| || => PIC 16F88-I/P
* Microchip dsPIC ||||| ||||| ||||| ||||| | => PIC 30F2010-30 SP/SO
* Logicanalyzer | => ME ANT 8 und ME ANT 16
* Atmel ATMEGA8 TQFP |||| => ATMEGA 8-16 TQ
* 3,3V Laengsregler (LT1086-Serie z.B.) ||||| => vgl z.B. [http://reichelt.de/?ARTIKEL=LT%201086%20CM3%2C3 LT 1086 CM3,3] (SMD) oder [http://reichelt.de/?ARTIKEL=LT%201086%20CT3%2C3 LT 1086 CT3,3] (TO-220) bei Reichelt
* Flexible Messleitungen: Wie gesagt Reichelt bietet ja die ganze Palette an Bananen/Laborsteckern, Krokodilklemmen usw. an, nur die Leitungen dazu fehlen im Programm. (Sind schon im Sortiment. Fertig konfektionierte z.B.: ML 100 SW, Meterware z.B.: MESSLEITUNG 10SW)
* FTDI USB Chips ||||| ||||| ||||| ||||| ||||| || => Best-Nr. FT232BL, FT232RL (sehr interessant), FT245BM und FT2232BM (2xUART auf USB)(noch nicht unter USB einsortiert)
* CAN-Bus Controller MCP2515 |||||
* VLSI MP3 Decoder ||||| ||||| ||||| | z.Zt. unter CAN-Bus(!) einsortiert. Bitte auch die neuen Gehäuse (ROHS) und Typen mit ins Angebot nehmen.
* Atmel AT90CAN128 ||||| |
* MMC / SDC slot ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ==> Bestell-Nr.: CONNECTOR MMC 11, CONNECTOR MMC 12, CONNECTOR SD 21 und CONNECTOR SD 22
* lineare Potentiometer als Schiebepoti ||||| | - Bestell-Nr. PSM-LIN* ("mono") PSS-LIN* ("stereo")
* Echtzeituhr DALAS DS1307 (auch SMD) ||||||| - Bestell-Nr. DS1307/DS1307Z
* Konkret: Neuer PIC ... und PIC18F2550 ||||| |||
* MSP430F1232 |
* Fädelstift, Draht und Kämme ||||| || - Bestell-Nr. Fädelstift/Fädeldraht/Fädelkamm (Warum sind diese Stifte ùnd der Draht nur so "erschreckend" teuer? => immerhin billiger als bei C...) (vielleicht weil jeder die nur 1x kauft und dann mit Draht aus anderen Quellen selber neu bewickelt?? ;-)
* Mini-GPS-Module ||||| ||||| ||||| ||||| ||| - Bestell-Nr. GPS ET 102/GPS ET 202/GPS EM 401
* Atmel ATmega48, ATmega168, ATtiny13 ||||| ||||| ||||| | (im neuen katalog und online verfügbar!)
* CompactFlash Stecker ||||| ||||| ||||| || - Bestell-Nr. connector CF 01/ Connector CF 02
* DCF77 Empfangsmodule ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| (DCF77 Modul) (4.5.2005 ist jetzt verfügbar unter DCF77 MODUL, aber leider 50% teurer als bei der Konkurenz, störempfindlicher, grotesk schwache Ausgangstreiber)
* Microchip PIC 12F683 (8pin PIC mit PWM !) => Bereits im Sortiment: Best. Nr PIC 12F683-I/P bzw. PIC 12F683-I/SN
* MSP430F135 ||||| ||||| | ||||| (MSP430F135 im Programm Bestellnr.: MSP430F135 IPM)
* SMD 0 Ohm in Bauform 0805 |||| -> SMD-0805 0,00
* Shunt-Widerstände ||||| ||||| ||||| ||||| | (neu im Sortiment: Widerstandsdraht, Best.-Nr. "RD100/x,xx", Leider nur in teuren 100g Spulen)
* dünner isolierter Draht, wie Klingeldraht nur dünner, vielleicht 0.2-0.3mm zum Fädeln von Platinen |||| => Fädeldraht nun im Sortiment
* dünner Silberdraht zur Verdrahtung auf Lochrasterplatinen ||||| | (mögl. bereits im Sortiment "SILBER 0,6MM" ???)Kupferlackdraht geht nicht?
* Hartmetallbohrer in mehr verschiedenen Größen (z.B. 0,6mm 0,8mm 1,1mm 1,2mm etc.) ||||| |||| => Gibt es beides Bestellnummern: "Bohrerset" oder für einzelne Bohrer "Bohrer + Größe in mm" Bsp: "Bohrer 0,6" => die kosten aber einiges, eine etwas preiswertere Alternative wäre auch nicht schlecht...
* 68HC908GP32 |
* überhaupt: Freescale 68HC908- und vor allem 68HCS08-Mikrocontroller fehlen total im Sortiment!
* RJ45-Buchse ||| - schon im Sortiment: MEBP 8-8''x'' unter Modular-Stecker bei TK
* Elektromotoren ||||| ||| (Suche: Gleichstommotor)
* Microchip ICD2 || => Bestell-Nr.: DV 164005 <= Fehlt im Papierkatalog
* 14,7456 MHz Quarze ||||| ||||| ||||| ||||| ||| (Bst: 14,7456-HC18)
* SMD Widerstande in Bauform 1206 (SMD 1/4W...)
* Atmel Atmega 128 in TQFP || (ATMEGA 128-16 TQ)
* Atmel Atmega 169 in TQFP || (ATMEGA 169-16 TQ)
* Atmel ATMEGA1280 ||||| ||||| ||||| |||| (ATMEGA 1280-16AU, ATMEGA 1280V-8AU)
* Atmel ATMEGA8515 | (ATMEGA 8515-*)
* Atmel ATtiny24/44 ||||| ||||| (ATTINY 24-*, ATTINY 44-*)
* Atmel ATtiny25/85 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| | (ATTINY-25-*, ATTINY-85-* gelistet aber erst verfuegbar ab II/07)
* Atmel AT91SAM7S64, AT91SAM7S256 ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||| (suche AT91*)
* Atmel AT91SAM7X64-256 ||||| ||| (suche AT91*)
* TI MSP430F1611 (10k RAM, 48k Flash) ||||| ||||| ||||| ||||| ||||| ||||| || (MSP430F1611 IPM)
* PCA9306 Dual Bi-Directional I2C-Bus and SMBus Voltage Level-Translator ||
* PCA9531D 8Bit I2C_BUS LED-Dimmer ||||| |||||
* PCA9551D 8Bit I2C-BUS LED-Blinker ||||| ||||
* PCA9530D 2Bit I2C_BUS LED-Dimmer ||||| |
* PCA9532D 16Bit I2C_BUS LED-Dimmer ||||| |||||
* PCA9533D 4Bit I2C_BUS LED-Dimmer ||||| ||||
* PCA9550D 2Bit I2C-BUS LED-Blinker ||||| |
* PCA9553D 4Bit I2C-BUS LED-Blinker ||||| ||
* PCA9552D 16Bit I2C-BUS LED-Blinker ||||| |||
* Microchip PIC 18F2550 (USB, 32 KBytes Flash) | (bereits im Sortiment)
* Microchip PIC 16F628A (weil: besser als 16F628) ||||
* Microchip PIC 16F648 (weil mehr Programmspeicher, als 16F628) |||||
* Microchip PIC 16F684 |||||
* Microchip PIC 16F688 ||||| ||
* Microchip PIC 16F690 ||||| ||||| |||
* Atmel ATtiny84 ||||| ||||| |||| (gelistet aber erst verfuegbar ab II/07)
* TI MSP430F169 |
* FT245RL (alt bekannte FTDI Chips in neuer und besserer Version, FT232RL bereits vorhanden) ||||| ||
* 3,3V Längsregler SMD Ultra Low drop |||| (-> Zetex)
* Schiebepotis mit passenden Knöpfen | (Bestell-Nr. PSM-LIN* ("mono") PSS-LIN* ("stereo") nicht passed?) |
* OLED-Displays (zum Beispiel: [http://www.litearray.com/products-oled.php]) || (Reichelt hat jetzt Osram Pictiva Oleds im Programm. Nach "Pictiva" suchen)
* OSRAM "Golden Dragon" LEDs (http://www.osram-os.com/goldendragon) ||||
* Stift-/Buchsenleisten 2.54mm *zum Auseinanderbrechen* ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ("BL 1x<Polzahl>G 2,54" wird mittlerweile als teilbare Variante geliefert)
* Microcontroller mit USB-Anschluss (von Cypress oder Atmel in PDIP z.B. AT89C5131, AT43USB355, CY7C637xx) ||||| ||||| ||||| ||||| ||||| ->Bereits im Sortiment: Cypress EZ-USB TQFP-44 Best. Nr AN2131 SC, Atmel AT89C5131 SO-28/PLCC-52
* Renesas R8C
* zu Schaltreglern LM257x u.a. passende Speicherspulen mit hohem L , niedrigem R und großer Strombelastbarkeit (zB. Würth WE-PD4) (keine "Entstörspulen") ||||| ||||| ||||| ||||| ||||| ||||| |||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| || (suche L-PIS*)
* IL300 (linear Optokoppler z.B. von Vishay egal ob DIP oder SMD) ||||| ||||
* IL300H (linear Optokoppler von Siemens als DIP) - andere IL300 Varianten im Programm |||
* "optische" Drehgeber Fabrikat Grayhill sind lieferbar (Bst. ENC 62P22-*)
* mechanische Drehimpulsgeber von Alps im Programm (suche STEC*)
** Drehimpulsgeber (konkreter Vorschlag von O.R.: PEC16-4220F-S0024 von Bourns) ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||
** Drehimpulsgeber- weiterer Vorschlag: ALPS Encoder ST EC 11B ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||| Im Programm (STEC11B01)
* PCA9633D16 4-bit I2C-bus LED driver ||
* I²C-Bus to 1-Wire DALLAS DS2482-100 bzw. DS2482-800 ||||| ||||| ||||| ||||| ||||| ||||
* Step-Down-Konverter in SMD Bauform (z.b. MC 34063): ||||| (->Artikel-Nr: MC 34063 AD)
* Preiswerte Kontaktierungen für SD/MMC ||| (Bereits im Programm: Bestell-Nummern: CONNECTOR MMC 11 / CONNECTOR MMC 12 / CONNECTOR SD 21 / CONNECTOR SD 22) // ~9 EUR sind wohl kaum preiswert!

= Wird es nicht geben =
* Eisen(III)-Chlorid ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| ||||| |||||

* Warum nicht?
* Echt mal warum nicht?

= Sonstiges =

== zur Webseite ==

Besserer Umgang mit Cookies es kommt manchmal vor das der über längere Zeit erstellt Warenkorb plötzlich leer ist, trotzdas man keine Cookies löscht oder verhindert. Eine Exportfunktion so das diese evtl. selbst sichern und wieder einbinden kann. Bei einer Registrierung(Benutzername/Passwort) könnte man evtl. den Warenkorb Serverseitig speichern.

Eine Webseite ohne Frames ist eigentlich heute Stand der Technik. Oder vielleicht ist es das auch nicht mehr - ich weiss es nicht aber nach meiner Auffassung sollte es Stand der Technik sein. Denn dann hat man für jedes Produkt auch einen eindeutigen Link und kann ggf. auch in Beiträgen, Mails und Anfragen darauf verlinken.

Anmerkung dazu:
Verlinken auf Artikel geht schon, und zwar in der Form:
http://www.reichelt.de/?ARTIKEL=ATMEGA%208-16%20DIP
bzw.
http://www.reichelt.de/index.html?ARTIKEL=ATMEGA%208-16%20DIP

Neu zu lesen unter "Info zum Shop":
Zitat:
"Frames
In vielen Votings wurden wir auf die Verwendung von Frames hingewiesen und dass diese Technik nicht mehr -State Of The Art- sei. Dieser Meinung schliessen wir uns in vollem Umfang an. In unserem neuen Shop werden KEINE FRAMES verwendet."

Reichelt selbst macht das in seinen PDF-Prospekten auch so. Das Problem liegt nur darin, die URL jedesmal von Hand zusammenzubauen (und dabei auf die Ersetzung der Leerzeichen durch %20 zu achten) oder von einer kopierten URL alles überflüssige zu entfernen.

Einfach mal einen "Permalink" button neben "artikel empfgehlen" ? Oder zurück mit der früheren Druckansicht.

Hinweis: Viele Browser ersetzen Leerzeichen im Adressfeld automatisch durch %20.

----

Die Webseite sollte auch in Standard-Browsern wie FireFox korrekt angezeigt werden.

Ich nutze reichelt schon immer mit firefox, klappt doch alles.

Zitat aus "Info zum Shop":
"Getestet wurden unsere Seiten mit:
FireFox ab Version 1.5.0.7. für Windows und Linux
Opera ab Version 9.01 für Windows
Mozilla ab Version 1.7.13 für Windows
Netscape ab Version 8.1 für Windows
Internet Explorer ab Verion 6.0.28..."

----

Ferner sollte es möglich sein, Bestellungen, welche noch nicht bearbeitet werden zu verändern, also z.B. was hinzuzufügen oder zu entfernen. Bei einer Wartezeit von ca. 3 Tagen bis zum Versand fällt einem doch noch was ein :-)

Das wird bereits gemacht! Einfach E-Mail an service@reichelt.de mit den Bauteilen, die man noch haben will. I-Net-Nummer nicht vergessen.

Andere Möglichkeit ist anrufen, das mache ich eh immer, um eventuell nicht lieferbare Dinge zu streichen oder zu ersetzen. Geht immer, es sei denn Lieferung wird schon verpackt.
----

Shopprogramm: Wär es nicht komfortabel, ein Programm auf dem heimischen Rechner zu haben, welches das aktuelle Sortiment mit den aktuellen Preisen führt, wo dann auch offline Bestellungen zusammengestellt und hochgeladen werden können? So ließen sich die Merklisten auch besser verwalten.

Ja, das fände ich auch sehr toll, sollte man mal drüber nachdenken.

----

Passwortschutz: Die derzeitige Lösung der Anmeldung im Shop ist für den heutigen Stand der Dinge recht unsicher. Ein zur Kundennummer gehörendes Passwort sollte schon sein. Was soll schon passieren, die Versandadresse ist ja bekannt, und wenn jemand anderes auf meinen Namen bestellt. läßt er sich über die Versandadresse rausfinden, außerdem weiß ja auch nicht jeder meine Kundennummer.

----

Eine Art Lagerbestand im Onlineshop wäre sinnvoll. Es ist mehr als ärgerlich, wenn bei einer Bestellung z.B. Kleinteile wie Kondensatoren oder Schalter fehlen, weil sie nicht auf Lager waren. Dabei gibt es gerade bei solchen Teilen genug Alternativen, sei es Farbe, Bauart oder Wert, auf die man umsteigen könnte, damit die Bestellung vollständig ist. Es würde ja vollkommen ausreichen den Bestand in Form einer Ampel, wie bei anderen Shops, mit grün, gelb und rot zu realisieren.

Im Warenkorb werden Artikel, die nicht auf lager sind, mittlerweile auch so gekennzeichnet.

----

Früher würden neue Artiekle mit einem gelben "NEU" gekennzeichnet, jetzt ist das nicht mehr so. Hätte gerne wieder einen überblick was neu hinzugekommen ist ohne jede Artikelgruppe aufrufen zu müssen.
----

Nummerierung der Bauteile: Warum wird der Warenkorb nicht numeriert. Ich hasse es wenn ich manuell mit Hand zaehlen muss! Das ist auch nervig wenn man manuell per Hand vergleichen will!!

----

Virtuelle Bauteilekisten (vbox): Wer bei Reichelt bestellt ordert oft viele viele Kleinteile. Wenn man nun ein Gerät zum wiederholten mal baut, muss man alle Teile erneut eingeben. Könnte ich nun neben dem Warenkorb auch noch virtuelle Bauteilekisten füllen würde das neue Bestellungen sehr beschleunigen. Der Kunde als Wiederholungstäter sozusagen.

Konkret:
Ich habe vier verschiedene Elektronikprojekte entwickelt.Für jedes dieser Projekte lege ich bei Reichelt.de eine virtuelle Bauteilekiste mit eigenem Namen an. Die Zusammenstellung der Artikel funktioniert wie beim normalen Warenkorb. Wenn ich nun ein Projekt erneut bauen möchte, kopiere ich einfach den Inhalt der virtuellen Bauteilekiste per Knopfdruck in meinen Warenkorb. Wenn ich Projekt2 also dreimal nachbauen möchte kopiere ich die virtuelle Bauteilebox "Projekt2" dreifach in den Warenkorb.
Schön wäre es auch die virtuellen Bauteilekisten mit Schaltplan und ev. Eagle - Dateien veröffentlichen zu können.

Konkret:
Ich habe eine Schaltung entwickelt für die ich eine persönliche virtuelle Bauteilekiste bei Reichelt.de zusammengestellt habe. Jetzt gebe ich meine persönliche virtuelle Bauteilekiste mit einer Kurzbeschreibung und einem Link auf meine Homepage(Projekthomepage) auf vbox.reichelt.de frei. Gleichzeitig setze ich auf meiner Homepage einen link auf meine öffentliche "vbox" bei Reichelt. Die öffentliche "vbox" ist dabei nur eine Referenz auf die persönliche "vbox" (synchron) und ist nur von mir veränderbar.
Ich hoffe die Idee ist verständlich formuliert.

EDIT: Nur so nebenbei - in anderen Shops geht das bereits RUDIMENTÄR (natürlich nicht mit öffentlichem Zugang...) in Form von Merkzetteln - die kann man meist unbegrenzt lang speichern und später einfach immer wieder in den Warenkorb legen. Das sollte das mindeste sein was man dem Kunden in einem modernen Shopsystem bietet!

Und wieso ist der Login, den es früher mal gab weg? Da konnte man zumindest den aktuellen warenkorb speichern soweit ich mich erinnern kann, aber seit der neuen Website gibt's den Login nicht mehr. Ausserdem muss ich jetzt jedesmal meine Kundennummer rauskramen um meine Bestellung abzusenden - Conrad löst das beispielsweise besser. (dafür haben die aber auch ne besch...eidene Suchfunktion und nen unübersichtlichen Shop)

Nebenanregung:
Damit die "Bauteilekisten" nicht unmengen Platz beim Anbieter verschwenden könnte man diese auslagern.
Also Nach erstellen Download als einfaches File und bei Bedarf einfach bei Bestellung übertragen.
So könnte sie jeder in Ruhe offline vorbereiten und verwalten.

Einfacher Kompromiss: Ein einfacher CSV-Import, -Export (Text mit Tabulator oder Semikolon getrennt) währe auch eine Alternative. Im aller einfachsten Fall könnte man das über eine Textbox realisieren. So könnte man auch eigene Projekte schneller eingeben bzw. sichern.

Ich habe ein Makro für MS Excel gesschrieben, welches die Daten aus einer Tabelle in den Warenkorb von Reichelt Elektronik überträgt.
--> http://pierreone.pi.funpic.de/makros/Reichelt-St%FCcklisten-Wizard.html

IDEE: Offenlegung der Datenbank: Offenlegung der Datenbank oder zumindest Export fuer die User. Somit koennten die Datenbank in eine Art Datenbank gespeichert werden. Als Katalogprogramm koennte dann soetwas aehnliches wie das von Segor zum Einsatz kommen. Gibt es einen Standard dann koennten Reichelt, Conrad, Segor, etc. mit einem Programm genutzt und verglichen werden:
siehe auch http://www.mikrocontroller.net/forum/read-7-363596.html
Programmierunterstuetzung findet sich bestimmt. Abgesehen davon haben die Distributoren den Vorteil die Katalogdaten uebers Internet upzudaten.

Zum offenlegen der Datenbank: Wie wäre es mit einem Webservice, mit dem man über SOAP auf die Datenbank zugreifen kann? Ähnlich wie bei Amazon oder auch Google.

Aktuell bei Reichelt: unter MyReichelt sollen Kunden sich einloggen können und BOMs getrennt speichern können und in einem Rutsch zum Warenkorb hinzufügen können, sowie auch Links zu diesen BOMs erstellen können, die dann jeder einsehen kann. Siehe auch http://www.mikrocontroller.net/topic/62628

Lösung in HTML: 
Ich hatte für das Projekt [http://www.mikrocontroller.net/topic/82127 "Webserver ATmega32/644DIP ENC28J60"] ein Bestellformular ([http://www.mikrocontroller.net/attachment/29451/reichelt.htm reichelt.htm] [Version vom 22.12.2007]) gebastelt um schnell alle nötigen teile in den Reichelt – Warenkorb zulegen. Mit etwas HTML-Kenntnis dürfte eine Anpassung nicht das Problem darstellen. 
In JavaScript, des '''reichelt.htm''' Bestellformulars, die Funktion <code>'''send()''' ''Zeile 42:'' var maxElements = 40;</code> die '''40''' durch die Anzahl der unterschiedlichen Bauteile Anpassen.

== zu Artikeln ==

* Kupferlackdraht: Auf der Website sind Plastikspulen abgebildet, geliefert wird jedoch seit Jahren schon lose aufgewickelter Draht, der so schlecht zu verarbeiten ist. Bitte ändern! Am besten vernünftigen Draht auf Spulen, zumindest aber das Bild anpassen.

* Spitze fände ich eine verbesserte Suche für Gehäuse. Oft stehe ich vor dem Problem, meine Baugruppe ist so-und-so groß und ich brauche ein Gehäuse, in das diese Baugruppe hineinpasst. Zur Zeit muss ich mich manuell durch alle Gehäusegrößen "durchwühlen", bis ich ein passendes gefunden habe. Die Suche stelle ich mir so vor: Ich gebe die Maße ein, die das Gehäuse mindestens haben ''muss'', und bekomme alle Gehäuse angezeigt, die genau so groß oder etwas größer sind als meine Vorgaben.

== Abwicklung ==

* Sammelbestellung: Wenn ich etwas bei Reichelt bestelle, bestelle ich für meine Kollegen auch immer etwas mit. Wenn dann das Päckchen kommt, heisst es sortieren. Wer hatte von was, wie viel? Danach kommt das rechnen dran. Ein besonderes Highlight, sind die Nettopreise. Und auch das Verteilen der Versandkosten ist nicht ohne. Währe es nicht möglich, im Bestellvorgang eine Zuordnung zu Personen oder Projekten zu realisieren, und die Zwischensummen der Personen oder Projekte auf der Rechnung oder per Mail anzugeben. Ein Schmankerl wäre die Angabe der Bruttopreise inklusive der anteiligen Versandkosten.
** Wahrscheinlich nicht möglich, siehe AGB-Klausel zu Massenbestellungen. "Garantieberechtigt" ist auch immer nur der ursprüngliche Besteller.
** Welche Klausel? Mir fällt nur 13.3 ins Auge...

== zu dieser Wunschliste ==

(gehört eigentlich in Diskussion)

* Wäre es möglich ein Script zu bauen, welches man ab und zu über diesen Artikel jagt und das die Einträge nach Anzahl der Striche ordnet?

* Dass hier jeder immer nur einen Strich macht, glaube ich nicht! Ein Script was pro IP nur einen Strich zulässt wäre gut. -> Naja, alle 24h spätestens gibt es eigendlich eine neue IP...

* Warum macht der 5te nicht anstelle |||| ein V :-) und anstelle vom nächsten V kommt dann ein X ....Daniel [[Benutzer:84.179.17.164|84.179.17.164]] 20:11, 4. Feb 2006 (CET)

* Wenn Reichelt was aus der Liste neu ins Programm aufnimmt wäre eine Benachrichtigung per Newsletter oder RSS nett. Oder zumindest eine Rubrik "Seit XX.XX.200X neu im Programm".

== Logbuch ==
03.08.2007: Das Feld für "neue Artikel" scheint aus dem Reichelt Shop entfernt worden zu sein, schade da man so schnell schauen konnte was neu im Programm ist, nun ist wieder Katalogblättern angesagt. - Nicht nachvollziehbar. siehe Startseite->Service->Neu in unserem Shop

18.05.2007: Habe Reichelt an diese Liste erinnert. -- Robin Tönniges

14.11.2006 Ich lese mir gerade euer Wishlist durch. Finde ich gut! Aber wie ihr
hier (Logbuch) über Reichelt kritisiert finde ich nicht fair! Die haben genug zu arbeiten! Bitte keine Vorurteile! Um das gehts mir hauptsächlich!
Macht weiter nur nicht so!
P.S. Schöne inforeiche Site
Steven

6.8.2006 Habe eine umfassende Kritik zu Reichelts neuem Webshop geschrieben und dabei auf unsere Wünsche bzl. Webseite, insbesondere "Virtuelle Bauteilebox" und "Gehäusesuche" hingewiesen. Verlinkung auf diese Seite ist auch erwähnt worden.

5.8.2006 Hurra, Reichelt bietet endlich den ATtiny13V an! Jetzt können wir Batteriebetriebene Geräte (2,4-3V) bauen. By the way: Gibt es blaue LED's, die dazu passen?

14.7.2006 Reichelt antwortete: (Zu lang, deshalb hier nur der Inhalt:) Wir haben ihre mail zur Kenntnis genommen (Forum wird angeblich ab und zu immer wieder kontrolliert). Entscheidender Satz (Original eines Mitarbeiters:)....Ich denke jedoch, dass die meisten und
wichtigsten Wünsche zum Herbstkatalog eingelistet werden.

14.7.2006 Reichelt erneut auf diesen Beitrag aufmerksam gemacht, erwarte Antwort.

3.7.2006: beitz-online.de eine verlinkung gemailt. Ich hoffe das ist erlaubt.

5.3.2006: Verlinkung gemailt

12.10.2005: Verlinkung gemailt und gebeten sich darum zu kümmern

07.10.2005: Reichelt eine Verlinkung gemailt und speziell auf LOW ESR Elkos und 433 Mhz Funkmodule hingewiesen. Mal sehen was die Antworten.

08.07.2005: Reichelt bescheid gegeben, man möge mal wieder hier rein schauen -- Thomas O.

13.05.2005: Antwort von Reichelt: der Versand ins Ausland bleibt leider bei 150 Eur -- nurmi

09.05.2005: Reichelt bescheid gegeben, man möge mal wieder hier rein schauen -- nurmi

08.05.2005: Pflege der Liste hier: Wenn ihr was in der Liste seht, was bereits schon im Angebot ist, löscht es bitte! Sonst ist das hier bald ein unüberschaubares Chaos. -- [http://www.reintechnisch.de Winfried Mueller]

08.02.2005: Positives Feedback von Reichelt. Freuen sich über diese Form der Anregung. In der 2. Märzhälfte sollen weitere Produkte in den neuen Katalog einfließen. -- [http://www.reintechnisch.de Winfried Mueller]

07.02.2005: Reichelt bescheid gegeben, man möge mal wieder hier rein schauen -- [http://www.reintechnisch.de Winfried Mueller]

AVR-GCC-Tutorial

2006-05-30T09:45:47Z

129.247.247.238: /* Zugriff auf Ports */

[[Category:AVR]]

= Vorwort =

Dieses Tutorial soll den Einstieg in die Programmierung von Atmel [[AVR]]-Mikrocontroller in der Programmiersprache [[C]] mit dem freien ("kostenlosen") C-Compiler avr-gcc erleichtern.

Die ursprüngliche Version stammt von Christian Schifferle, viele neue Abschnitte und aktuelle Anpassungen von Martin Thomas. Viele der im Original-Dokument verwendeten Funktionen sind in aktuellen Versionen des [[AVR-GCC|avr-gcc]] C-Compilers und der Laufzeitbibliothek avr-libc nicht mehr enthalten oder sollen nicht mehr genutzt werden. Dieses Tutorial wurde an die neuen Funktionen/Methoden angepasst.

Die Erläuterungen und Beispiele beziehen sich auf die Versionen 3.4.5 des avr-gcc-Compiler und 1.4.3 der avr-libc, so wie sie in WinAVR 20060125 enthalten sind. Die Unterschiede zu älternen Versionen werden im Haupttext und Anhang zwar erläutert, Anfängern sei jedoch empfohlen, die aktuellen Versionen zu nutzen.

In diesem Text wird häufig auf die Standardbibliothek für den avr-gcc-Compiler, die avr-libc, verwiesen. Die online-Version der '''avr-libc Dokumentation''' findet sich [http://www.nongnu.org/avr-libc/user-manual/index.html hier]. Bei [[WinAVR]] gehört die Dokumentation zum Lieferumfang und wird mitinstalliert.

Eine Version als PDF zum Ausdrucken ist hier erhältlich (nicht immer auf aktuellem Stand): http://www.siwawi.arubi.uni-kl.de/avr_projects/AVR-GCC-Tutorial_-_www_mikrocontroller_net.pdf

= 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:

* Testboard 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 Testplattform sind auch das [[STK500]] und der [[AVR Butterfly]] von Atmel.[[http://www.mikrocontroller.net/articles/AVR#Starterkits |mehr..]
* 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]].
* Programmiersoftware und -[[AVR In System Programmer |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 Abschnitt [[AVR-GCC-Tutorial#Exkurs: makefiles|Exkurs: makefiles]]).

= Was tun, wenn's nicht "klappt"? =

* Herausfinden, ob es tatsächlich ein avr(-gcc) spezifisches Problem ist oder die 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.
*[[AVR Checkliste]]
* Die [http://www.nongnu.org/avr-libc/user-manual/index.html 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 [http://www.mikrocontroller.net www.mikrocontroller.net] nach vergleichbaren Problemen absuchen.
* Das avr-gcc-Forum bei [http://www.avrfreaks.net avrfreaks] nach vergleichbaren Problemen absuchen.
* Das [http://lists.gnu.org/archive/html/avr-gcc-list/ Archiv der avr-gcc Mailing-Liste] nach vergleichbaren Problemen absuchen.
* Nach Beispielcode suchen. Vor allem in der Academy von [http://www.avrfreaks.net AVRFREAKS] (anmelden).
* Google oder alltheweb befragen schadet nie.
* Bei Problemen mit der Ansteuerung interner AVR-Funktionen mit C-Code: das Datenblatt des Controllers lesen (ganz und am Besten zweimal)
* 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, genaue Fehlermeldungen bzw. Beschreibung des Fehlverhaltens. Bei Ansteuerung externer Geräte die Beschaltung beschreiben oder skizzieren (z.B. mit [http://www.tech-chat.de/ Andys ASCII Circuit]). Siehe dazu auch: [http://www.lugbz.org/documents/smart-questions_de.html "Wie man Fragen stellt"].

= Erzeugen von Maschinencode =

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

* Die Verwendung einer Integrierten Enwicklungsumgebung (IDE), bei der alle Einstellungen z.B. in Dialogboxen durchgeführt werden können. Unter Anderen kann AVRStudio ab Version 4.12 (kostenlos bei atmel.com) zusammen mit WinAVR als intergrierte Entwicklungsumgebung für den Compiler avr-gcc genutzt werden (dazu muessen AVRStudio und WinAVR auf dem Rechner installiert sein). Weitere IDEs fuer den avr-gcc (ohne Anspruch auf Vollständigkeit): AtmanAvr C (relativ günstig), KamAVR (kostenlos) VMLab (ab Version 3.12 ebenfalls kostenlos).

* Die Nutzung des Programms make mit passenden Makefiles.

Integrierte Enwicklungsumgebungen 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 Nutzung des avr-gcc Compilers mit IDEs sei hier auf deren Dokumentation verwiesen.

Im folgenden Abschnitt wird die Generierung von Maschinencode ("hex-Datei") für einen AVR aus C-Quellcode ("c-Dateien") anhand der universellen und plattformunabhänigen Vorgehensweise mittels make und 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 Projectverzeichnisses). Beim Wechsel vom makefile-Ansatz nach WinAVR-Vorlage zu AVRStudio ist darauf zu achten, dass AVRStudio (Stand: AVRStudio Version 4.12SP1) bei einem neuen Projekt die Optimierungsoption (vgl. nächster Abschnitt, typisch: -Os) nicht einstellt und die mathematische Bibliothek der avr-libc (libm.a, Linker-Option -lm) nicht einbindet. 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.

= Exkurs: Makefiles =

Wenn man bisher gewohnt ist, mit integrierten Entwicklungsumgebung à la Visual-C Programme zu erstellen, wirkt das makefile-Konzept auf den ersten Blick etwas kryptisch. Nach kurzer Einarbeitung ist diese Vorgehensweise jedoch sehr praktisch. Diese Dateien (üblicher Name: 'Makefile' ohne Dateiendung) dienen der Ablaufsteuerung des Programms make, das auf allen Unix/Linux-Systemen installiert sein sollte, und in einer Fassung fuer MS-Windows auch in [[WinAVR]] (Unterverzeichnis utils/bin) enthalten ist.

Im Unterverzeichnis ''sample'' einer WinAVR-Installation findet man eine sehr brauchbare Vorlage, die sich einfach an das eigene Projekt anpassen lässt ([[Media:Makefile|lokale Kopie Stand Sept. 2004]]). Wahlweise kann man auch [http://www.sax.de/~joerg/mfile/ mfile] von Jörg Wunsch nutzen. mfile erzeugt ein makefile nach Einstellungen in einer grafischen Nutzeroberfläche, wird bei WinAVR mitinstalliert, ist aber als TCL/TK-Programm auf nahezu allen Plattformen lauffähig.

''Die folgenden Ausführungen beziehen sich auf das WinAVR Beispiel-Makefile.''

Ist im Makefile alles richtig eingestellt genügt es, sich drei Parameter zu merken, die über die shell bzw. die Windows-Kommandozeile (cmd.exe/command.com) als Parameter an "make" übergeben werden. Das Programm make sucht sich "automatisch" das Makefile im aktuellen Arbeitsverzeichnis und führt die darin definierten Operationen für den entsprechenden Aufrufparameter durch.

{| border=1
| ''make all''
| Erstellt aus den im Makefile angegebenen Quellcodes eine ''hex''-Datei (und ggf. auch ''eep''-Datei).
|-
| ''make program''
| Überträgt die hex-Datei (und wahlweise auch die eep-Datei für den EEPROM) zum AVR.
|-
| ''make clean''
| löscht alle temporären Dateien, also auch die hex-Datei
|}

Diese Aufrufe können in die allermeisten Editoren in "Tool-Menüs" eingebunden werden. Dies erspart den Kontakt mit der Kommandozeile. (Bei WinAVR sind die Aufrufe bereits im Tools-Menü des mitgelieferten Editors Programmers-Notepad eingefügt.)

Üblicherweise sind folgende Daten im Makefile anzupassen:
* Controllertyp
* Quellcode-Dateien (c-Dateien)
* Typ und Anschluss des Programmiergeräts

seltener sind folgende Einstellungen durchzuführen:
* Grad der Optimierung
* Methode zur Erzeugung der Debug-Symbole (Debug-Format)
* Assembler-Quellcode-Dateien (S-Dateien)

Die in den folgenden Unterabschnitten gezeigten Makefile-Ausschnitte sind für ein Programm, das auf einem ATmega8 ausgeführt werden soll. Der Quellcode besteht aus den c-Dateien superprog.c (darin main()), uart.c, lcd.c und 1wire.c. Im Quellcodeverzeichnis befinden sich diese Dateien: superprog.c, uart.h, uart.c, lcd.h, lcd.c, 1wire.h, 1wire.c und das makefile (die angepasste Kopie des WinAVR-Beispiels).

Der Controller wird mittels [[AVRDUDE]] über ein [[STK200]]-Programmierdongle an der Schnittstelle lpt1 (bzw. /dev/lp0) programmiert. Im Quellcode sind auch Daten für die ''section .eeprom'' definiert (siehe Abschnitt [[AVR-GCC-Tutorial#EEPROM|Speicherzugriffe]]), diese sollen beim Programmieren gleich mit ins EEPROM geschrieben werden.

== Controllertyp setzen ==

Dazu wird die "make-Variable" MCU entsprechend dem Namen des verwendeten Controllers gesetzt. Ein Liste der von avr-gcc und der avr-libc untersützten Typen findet sich in der [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc].

<pre class="code">
# Kommentare in Makefiles beginnen mit einem Doppelkreuz
...

# ATmega8 at work
MCU = atmega8
# oder MCU = atmega16
# oder MCU = at90s8535
# oder ...
...
</pre>

== Quellcode-Dateien einstellen ==

Den Namen der Quellcodedatei welche die Funktion main enthält, wird hinter TARGET eingetragen. Dies jedoch ohne die Endung ''.c''.

<pre class="code">
...
TARGET = superprog
...
</pre>

Besteht das Projekt wie im Beispiel aus mehr als einer Quellcodedatei, sind die weiteren c-Dateien (nicht die Header-Dateien, vgl. [[Include-Files (C)]]) durch Leerzeichen getrennt bei SRC einzutragen. Die bei TARGET definierte Datei ist schon in der SRC-Liste enthalten. Diesen Eintrag nicht löschen!

<pre class="code">
...
SRC = $(TARGET).c uart.c lcd.c 1wire.c
...
</pre>

Alternativ kann man die Liste der Quellcodedateien auch mit dem Operator += erweitern.

<pre class="code">
SRC = $(TARGET).c uart.c 1wire.c
# lcd-Code fuer Controller xyz123 (auskommentiert)
# SRC += lcd_xyz.c
# lcd-Code fuer "Standard-Controller" (genutzt)
SRC += lcd.c
</pre>

== Programmiergerät einstellen ==

Die Vorlagen sind auf die Programmiersoftware [[AVRDUDE]] angepasst, jedoch lässt sich auch andere Programmiersoftware einbinden, sofern diese über Kommandozeile gesteuert werden kann (z.B. stk500.exe, uisp, sp12).

<pre class="code">
...
# Einstellung fuer STK500 an com1 (auskommentiert)
# AVRDUDE_PROGRAMMER = stk500
# com1 = serial port. Use lpt1 to connect to parallel port.
# AVRDUDE_PORT = com1 # programmer connected to serial device

# Einstellung fuer STK200-Dongle an lpt1
AVRDUDE_PROGRAMMER = stk200
AVRDUDE_PORT = lpt1
...
</pre>

Sollen Flash(=.hex) und EEPROM(=.eep) zusammen auf den Controller programmiert werden, ist das Kommentarzeichen vor AVRDUDE_WRITE_EEPROM zu löschen.

<pre class="code">
...
# auskommentiert: EERPOM-Inhalt wird nicht mitgeschrieben
#AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep

# nicht auskommentiert: EERPOM-Inhalt wird mitgeschrieben
AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep
...
</pre>

todo: fuse-bits

== Anwendung ==

Die Eingabe von ''make all'' im Arbeitsverzeichnis mit dem Makefile und den Quellcodedateien erzeugt (unter anderem) die Dateien superprog.hex und superprog.eep. Abhängigkeiten zwischen den einzelnen c-Dateien werden dabei automatisch berücksichtigt. Die ''superprog.hex'' und ''superprog.eep'' werden mit ''make program'' zum Controller übertragen. Mit ''make clean'' werden alle temporären Dateien gelöscht (="aufgeräumt").

== Sonstige Einstellungen ==

=== Optimierungsgrad ===

Der gcc-Compiler kennt verschiedene Stufen der Optimierung. Nur zu Testzwecken sollte die Optimierung ganz deaktiviert werden (''OPT = 0''). Die weiteren möglichen Optionen weisen den Compiler an, möglichst kompakten oder möglichst schnellen Code zu erzeugen. In den weitaus meisten Fällen ist ''OPT = s'' die optimale (sic) Einstellung, damit wird kompakter und oft auch der "schnellste" Maschinencode erzeugt.

=== Debug-Format ===

Unterstützt werden die Formate stabs und dwarf-2. Das Format wird hinter ''DEBUG ='' eingestellt. Siehe dazu Abschnitt ''Eingabedateien zur Simulation''.

=== Assembler-Dateien ===

Die im Projekt genutzten Assembler-Dateien werden hinter ASRC durch Leerzeichen getrennt aufgelistet. Assembler-Dateien haben immer die Endung .S (großes S). Ist zum Beispiel der Assembler-Quellcode eines Software-UARTs in einer Datei softuart.S enthalten lautet die Zeile: ''ASRC = softuart.S''

=== Taktfrequenz ===

Neuere Versionen der WinAVR/Mfile Vorlage für Makefiles beinhalten die Definition einer Variablen F_CPU (WinAVR 2/2005). Darin wird die Taktfrequenz des Controllers in Hertz eingetragen. Die Definition steht dann im gesamten Projekt ebenfalls unter der Bezeichnung F_CPU zur Verfügung (z.B. um daraus UART-, SPI- oder ADC-Frequenzeinstellungen abzuleiten).

Die Angabe hat rein "informativen" Charakter, die tatsächliche Taktrate wird über den externen Takt (z.B. Quarz) bzw. die Einstellung des internen R/C-Oszillators bestimmt. Die Nutzung von F_CPU macht also nur Sinn, wenn die Angabe mit dem tatsächlichen Takt übereinstimmt.

Innerhalb der avr-libc ab Version 1.2 (in WinAVR ab 2/2005 enthalten) wird die Definition der Taktfrequenz (F_CPU) zur Berechnung der Wartefunktionen in avr/delay.h genutzt. Diese funktionieren nur dann korrekt, wenn F_CPU mit der tatsächlichen Taktfrequenz übereinstimmt.
F_CPU muss dazu jedoch nicht unbedingt im makefile definiert werden. Es reicht aus, wird aber bei mehrfacher Anwendung unübersichtlich, vor ''#include <avr/delay.h>'' ein ''#define F_CPU [hier Takt in Hz]UL'' einzufügen.
Vgl. dazu den [http://www.nongnu.org/avr-libc/user-manual/group__avr__delay.html entsprechenden Abschnitt der Dokumentation].

== Eingabedateien zur Simulation in AVR-Studio ==

Mit älteren AVR-Studio-Versionen kann man nur auf Grundlage sogenannter ''coff''-Dateien simulieren. Neuere Versionen von AVR-Studio (ab 4.10.356) unterstützen zudem das modernere aber noch experimentelle dwarf-2-Format, das ab WinAVR 20040722 (avr-gcc 3.4.1/Binutils inkl. Atmel add-ons) "direkt" vom Compiler erzeugt wird.

; Vorgehensweise bei extcoff:
* im Makefile bei DEBUG: <pre class="code">DEBUG=stabs</pre>
* ''make extcoff'' (evtl. vorher ''make clean'')
* die erzeugte ''cof''-Datei (im Beispiel oben ''superprog.cof'') in AVR-Studio laden
* AVR-Simulator und zu simulierenden Controller wählen, "Finish"
* weiteres siehe AVR-Studio Online-Hilfe

; Vorgehensweise bei dwarf-2:
* im Makefile bei DEBUG: <pre class="code">DEBUG=dwarf-2</pre>
* ''make all'' (evtl. vorher ''make clean'')
* die erzeugte ''elf''-Datei (im Beispiel oben ''superprog.elf'') in AVR-Studio laden
* AVR-Simulator und zu simulierenden Controller wählen, "Finish"
* weiteres siehe AVR-Studio Online-Hilfe

Beim Simulieren scheinen oft "Variablen zu fehlen". Ursache dafür ist, dass der Compiler die "Variablen" direkt Registern zuweist. Dies kann vermieden werden, indem die Optimierung abgeschaltet wird (im makefile). Man simuliert dann jedoch ein vom optimierten Code stark abweichendes Programm. Das Abschalten der Optimierung wird nicht empfohlen.

Statt des Software-Simulators kann das AVR-Studio auch genutzt werden, um mit dem ATMEL JTAGICE, ein Nachbau davon (BootICE, Evertool o.ä.) oder dem ATMEL JTAGICE MKII "im System" zu debuggen. Dazu sind keine speziellen Einstellungen im makefile erforderlich. Debugging bzw. "In-System-Emulation" mit dem JTAGICE und JTAGICE MKII sind in der AVR-Studio Online-Hilfe beschrieben.

= 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.

== Selbstdefinierte (nicht-standardisierte) ganzzahlige Datentypen ==

Bei den im Folgenden genannten Typdefinitionen ist zu beachten, dass die Bezeichnungen für "Worte" teilweise je nach Prozessorplattform unterschiedlich verwendet werden. Die angegebenen Definitionen beziehen sich auf die im Zusammenhang mit AVR/8-bit-Controllern üblichen "Bit-Breiten" (In Erläuterungen zum ARM7TDMI z.B. werden oft 32-bit Integer mit "Wort" ohne weitere Ergänzung bezeichnet). Es empfiehlt sich daher, die im nachfolgenden Abschnitt beschriebenen ''standardisierten ganzzahligen Datentypen'' zu nutzen und damit "Missverständnissen" vorzubeugen, die z.B. bei der Portierung von C-Code zwischen verschiedenen Plattformen auftreten können.

<pre class="code">
typedef unsigned char BYTE; // besser: uint8_t aus <inttypes.h>
typedef unsigned short WORD; // besser: uint16_t aus <inttypes.h>
typedef unsigned long DWORD; // besser: uint32_t aus <inttypes.h>
typedef unsigned long long QWORD; // besser: uint64_t aus <inttypes.h>
</pre>

; BYTE : Der Datentyp BYTE definiert eine Variable mit 8 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 255.

; WORD : Der Datentyp WORD definiert eine Variable mit 16 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 65535.

; DWORD : Der Datentyp DWORD (gesprochen: Double-Word) definiert eine Variable mit 32 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 4294967295.

; QWORD : Der Datentyp QWORD (gesprochen: Quad-Word) definiert eine Variable mit 64 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 18446744073709551615.

== Standardisierte Integer(Ganzzahl)-Typen ==

Standardisierte Datentypen werden in der Header-Datei inttypes.h definiert. In neueren Version der avr-libc (ab V1.2.0) heisst die Datei entsprechend aktuellem Standard stdint.h. inttypes.h existiert aus Kompatibiltätsgründen weiterhin und enthält ein ''#include <stdint.h>''.
Zur Nutzung der standardisierten Typen bindet man die "Definitionsdatei" wie folgt ein:

<pre class="code">
#include <inttypes.h>

// oder - ab avr-libc Version 1.2.0 möglich und empfohlen:
#include <stdint.h>
</pre>

Einige der dort definierten Typen (avr-libc Version 1.0.4):

<pre class="code">
typedef signed char int8_t;
typedef unsigned char uint8_t;

typedef short int16_t;
typedef unsigned short uint16_t;

typedef long int32_t;
typedef unsigned long uint32_t;

typedef long long int64_t;
typedef unsigned long long uint64_t;
</pre>

Ein Vierfach-Wort (64Bit) entspricht beim AVR ''uint64_t'', ein Doppel-Wort (32bit) entspricht ''uint32_t'', ein Wort (16bit) entspricht ''uint16_t'' und ein Byte (8bit) entspricht ''uint8_t''.
Die Typen ohne vorangestelltes ''u'' können auch vorzeichenbehaftete Zahlen speichern. ''int8_t'' geht also von -128 bis 127, ''uint8_t'' dagegen geht von 0 bis 255.

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/(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 Bit breit ist.

Hier bietet uns die Programmiersprache C ein mächtiges Werkzeug an, mit dessen
Hilfe wir 8 Bits in eine einzelne Bytevariable zusammen fassen 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:

<pre class="code">
struct {
unsigned char bStatus_1:1; // 1 Bit für bStatus_1
unsigned char bStatus_2:1; // 1 Bit für bStatus_2
unsigned char bNochNBit:1; // Und hier noch mal ein Bit
unsigned char b2Bits:2; // Dieses Feld ist 2 Bits breit
// All das hat in einer einzigen Byte-Variable Platz.
// die 3 verbleibenden Bits bleiben ungenutzt
} x;
</pre>

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

<pre class="code">
x.bStatus_1 = 1;
x.bStatus_2 = 0;
x.b2Bits = 3;
</pre>

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 geraten,
ein "ganzes" Byte (uint8_t) zu nutzen auch wenn nur ein Bitwert gespeichert
werden soll.

Wenn man nur eine paar wenige Variablen vom Typ bool verwenden möchte, kann man
auch die Headerdatei <stdbool.h> einbinden und sich dann wie gewohnt einen Booltyp anlegen.
Bei vielen Variablen vom Typ Bool und knappem Speicher ist die Verwendung von Bitfeldern zu empfehlen (? Wie wird der stdbool intern abgewickelt ?)

= 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:

[[Image:Sequentielle Programme.gif]]

== 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.

[[Image:Interrupt Programme.gif]]

= Allgemeiner 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.

Einige Register haben spezielle Funktionen, andere wiederum können für allgemeine Zwecke (Speichern von Datenwerten) verwendet werden.

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. Wenn im Makefile der MCU-Typ definiert ist, wird vom System automatisch die zum Typen passende Definitionsdatei genutzt, sobald man im Code die allgemeine "io.h" Header-Datei einbindet.

<pre class="code">
#include <avr/io.h>
</pre>

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

== I/O-Register ==

Die I/O-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 mal
die 8-Bit Register.

=== Lesen eines I/O-Registers ===

Zum Lesen kann man auf I/O-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üzen den Zugriff nun direkt und inp() ist nicht mehr erforderlich.

Beispiel:

<pre class="code">
#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;
...
}
</pre>

==== Lesen eines Bits ====

Die AVR-Bibliothek (avr-libc) stellt auch Funktionen zur Abfrage eines einzelnen Bits eines Registers zur Verfügung:

;bit_is_set (<Register>,<Bitnummer>) : Die Funktion ''bit_is_set'' prüft, ob ein Bit gesetzt ist. Wenn das Bit gesetzt ist, wird ein Wert ungleich 0 zurückgegeben. Genau genommen ist es die Wertigkeit des abgefragten Bits, also 1 für Bit0, 2 für Bit1, 4 für Bit2 etc.

;bit_is_clear (<Register>,<Bitnummer>) : Die Funktion ''bit_is_clear'' prüft, ob ein Bit gelöscht ist. Wenn das Bit gelöscht ist, also auf 0 ist, wird ein Wert ungleich 0 zurückgegeben.

Die Funktionen bit_is_clear bzw. bit_is_set sind ''nicht erforderlich'', man kann auch "einfache" C-Syntax verwenden, die universell verwendbar ist. ''bit_is_set'' entspricht dabei z.B. (Registername & (1 << Bitnummer)). Das Ergebnis ist <>0 ("wahr") wenn das Bit gesetzt und 0 ("falsch") wenn es nicht gesetzt ist. Die Negierung des Ausdrucks, also '''!'''((Registername & (1 << Bitnummer)), entspricht ''bit_is_clear'' und gibt einen Wert <>0 ("wahr") zurück, falls das Bit nicht gesetzt ist,

* siehe auch [[Bitmanipulation]]

=== Schreiben eines I/O-Registers ===

Zum Schreiben kann man I/O-Register einfach wie eine Variable setzen. 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 und outp() ist nicht mehr erforderlich.

Beispiel:

<pre class="code">
#include <avr/io.h>

...

int main(void)
{
/* Setzt das Richtungsregister des Ports A auf 0xff
(alle Pins als Ausgang): */
DDRA = 0xff;

/* Setzt PortA auf 0x03, Bit 0 und 1 "high", restliche "low": */
PORTA = 0x03;
...
}
</pre>

==== Schreiben von Bits ====

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

mit dem Ausdruck:
<pre class="code">
x |= (1 << Bitnummer); // wird ein Bit in x gesetzt
x &= ~(1 << Bitnummer); // wird ein Bit in x geloescht
</pre>

Das niederwertigste Bit (für 1) eines Bytes hat die Bitnummer 0, das "höchstwertige" (für 128) die Nummer 7.

Beispiel:
<pre class="code">
#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 */
</pre>

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

Beispiel:
<pre class="code">
#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 */
</pre>

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]]
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Special Function Registers

=== Warten auf einen bestimmten Zustand ===

Es gibt in der Bibliothek sogar Funktionen, die warten, bis ein bestimmter Zustand auf einem Bit erreicht ist. Es ist allerdings normalerweise eine eher unschöne Programmiertechnik, da in diesen Funktionen "blockierend gewartet" wird. D.h., der Programmablauf bleibt 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.

<pre class="code">
#include <avr/io.h>
...

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

#define WARTEPIN PINA
#define WARTEBIT 2

// 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)) ) ;
...
</pre>

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. Das niederwertigste Bit hat die Bitnummer 0.

<pre class="code">
#include <avr/io.h>
...

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

// 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) ) ;
...
</pre>

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

siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Special Function Registers
* [[Bitmanipulation]]

= Zugriff auf Ports =

Alle Ports der AVR-Controller werden über Register gesteuert. Dazu sind
jedem Port 3 Register zugeordnet:

{| border="1"
|-
| '''DDRx'''
| Datenrichtungsregister für Port'''x'''.
'''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 Port'''x'''.

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 Port'''x'''.
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).
|}



== 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.

Wollen wir also beispielsweise Pin 0 bis 4 von Port B als Ausgänge
definieren so schreiben wir folgende Zeile:

<pre class="code">
#include <avr/io.h>

...

// Setzen der Bits 0,1,2,3 und 4
// Binär 00011111 = Hexadezimal 1F

DDRB = 0x1F; /* direkte Zuweisung - unuebersichtlich */

/* mehr Tipparbeit aber uebersichtlicher: */
DDRB = (1 << DDB0) | (1 << DDB1) | (1 << DDB2) | (1 << DDB3) | (1 << DDB4);
...
</pre>

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

=== Ganze Ports ===

Um einen ganzen Port als Ausgang zu definieren, kann der folgende Befehl
verwendet werden:
<pre class="code">
DDRB = 0xff;
</pre>

Im Beispiel wird der Port B als Ganzes als Ausgang geschaltet. Dazu muss die Header-Datei avr/io.h eingebunden sein (darin wird u.a. DDRB definiert).

== 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: (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):

<pre class="code">
...
/* 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
</pre>

== 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
<pre class="code">
#inlude <avr/io.h>
...
PORTB=0x04; /* besser PORTB=(1<<PB2) */
</pre>
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:

<pre class="code">
#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" */
</pre>

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

<pre class="code">
#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" */
</pre>

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 in aktuellen Versionen der avr-libc nicht mehr enthalten und auch nicht mehr erforderlich.

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 Angangswert "high" initialisiert werden, zuerst die Bits im PORTx-Register setzen und anschliessend die Datenrichtung auf Ausgang stellen. Daraus ergibt sich die Abfolge Eingang -> setze PORTx: interner Pull-Up aktiv -> setze DDRx: Ausgang "high". Bei der Reihenfolge erst DDRx and PORTx, kann es zu einem kurzen "low-Puls" kommen, der auch exterene 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") 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.

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'''. Die Abfrage der Pinzustände über PORTx statt PINx ist ein häufiger Fehler beim AVR-"Erstkontakt". (Ansonsten liest man nicht den Zustand der Eingänge, sondern den Status der internen Pull-Up-Widerstände.)

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

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
...
uint8_t bPortD;
...
bPortD = PIND;
...
</pre>

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

<pre class="code">
#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 */
}
...
</pre>

=== Tasten und Schalter ===

Der Anschluss mechanischer Kontakte an den Mikrocontroller gestaltet sich ebenfalls ganz einfach, wobei wir zwei unterschiedliche Methoden unterscheiden müssen (''Active Low'' und ''Active High''):

{| border="1"
|-
| '''Active Low'''
| '''Active High'''
|-
| [[Image:Active Low.gif]]
| [[Image:Active High.gif]]
|-
| 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.

Der Widerstandswert des Pull-Up Widerstands ist an sich nicht kritisch. Es muss jedoch beachtet werden, dass über den Widerstand ein Strom in den Eingang fliesst, also sollte er nicht zu klein gewählt werden um den Controller nicht zu zerstören. Wird er allerdings zu hoch gewählt ist die Wirkung eventuell nicht gegeben. Als üblicher Wert haben sich 10 Kiloohm eingebürgert.

Die AVRs haben sogar an den meisten Pins softwaremässig zuschaltbare interne Pull-Up Widerstände, welche wir natürlich auch verwenden können.

| 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.
|}

==== Pull-Up Widerstände aktivieren ====

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.

<pre class="code">
#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<<DDC7); /* Pin PC7 als Eingang */
PORTC |= (1<<PC7); /* internen Pull-Up an PC7 aktivieren */
</pre>

==== (Tasten-)Entprellung ====

Nun haben alle mechanischen Kontakte, sei es von Schaltern, Tastern oder auch von Relais, die unangenehme Eigenschaft zu prellen. Dies bedeutet, dass beim Schliessen des Kontaktes derselbe nicht direkt Kontakt herstellt, sondern mehrfach ein- und ausschaltet bis zum endgültigen Herstellen des Kontaktes.

Soll nun mit einem schnellen Mikrocontroller gezählt werden, wie oft ein solcher Kontakt geschaltet wird, dann haben wir ein Problem, weil das Prellen als mehrfache Impulse gezählt wird. Diesem Phänomen muss beim Schreiben des Programms unbedingt Rechnung getragen werden.

<pre class="code">
#include <avr/io.h>
#include <inttypes.h>
#ifndef F_CPU
#define F_CPU 3686400UL /* Quarz mit 3.6864 Mhz */
#endif
#include <avr/delay.h> /* definiert _delay_ms() ab avr-libc Version 1.2.0 */

/* Einfache Funktion zum Entprellen eines Tasters */
inline uint8_t debounce(volatile uint8_t *port, uint8_t pin)
{
if ( ! (*port & (1 << pin)) )
{
/* Pin wurde auf Masse gezogen, 100ms warten */
_delay_ms(100);
if ( ! (*port & (1 << pin)) )
{
/* Anwender Zeit zum Loslassen des Tasters geben */
_delay_ms(100);
return 1;
}
}
return 0;
}

int main(void)
{
DDRB &= ~( 1 << PB0 ); /* PIN PB0 auf Eingang (Taster) */
PORTB |= ( 1 << PB0 ); /* Pullup-Widerstand aktivieren */
...
if (debounce(&PINB, PB0)) /* Falls Taster an PIN PB0 gedrueckt.. */
PORTD = PIND ^ ( 1 << PD7 ); /* ..LED an Port PD7 an-
bzw. ausschalten */
...
}
</pre>

Bei diesem Beispiel ist zu beachten, dass der AVR im Falle eines Tastendrucks 200ms wartet, also brach liegt. Zeitkritische Anwendungen sollten ein anderes Verfahren wählen.

Zum Thema Entprellen siehe auch:
* Artikel [[Entprellung]]

== Analog ==

Die Verarbeitung von analogen Eingangswerten und die Ausgabe von Analogwerten wird in Kapitel [[AVR-GCC-Tutorial#Analoge_Ein-_und_Ausgabe|Analoge Ein- und Ausgabe]] behandelt.

== 16-Bit Portregister (ADC, ICR1, OCR1, TCNT1, UBRR) ==

Einige der Portregister in den AVR-Controllern sind 16 Bit breit. Im Datenblatt sind diese Register üblicherweise mit dem Suffix "L" (LSB) und "H" (MSB) versehen. Die avr-libc definiert zusätzlich die meisten dieser Variablen die Bezeichnung ohne "L" oder "H". Auf diese kann direkt zugewiesen bzw. zugegriffen werden. Die Konvertierung von 16-bit Wort nach 2*8-bit Byte erfolgt intern.

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
...
uint16_t foo;

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

Falls benötigt, kann eine 16-Bit Variable auch recht einfach manuell in ihre zwei 8-Bit Bestandteile zerlegt werden. Folgendes Beispiel demonstriert dies anhand des pseudo- 16-Bit Registers UBRR.

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
#ifndef F_CPU
#define F_CPU 3686400
#endif
#define UART_BAUD_RATE 9600

typedef union {
uint16_t i16;
struct {
uint8_t i8l;
uint8_t i8h;
};
} convert16to8;

...
convert16to8 baud;
baud.i16 = F_CPU / (UART_BAUD_RATE * 16L) -1;
UBRRH = baud.i8h;
UBRRL = baud.i8l;
...

/*alternativ:*/
#include <inttypes.h>

uint16_t wFoo16;
uint8_t bFooLow, bFooHigh;

...

wFoo16 = 0xAA55; /* zu "zerlegende" 16Bit-Integer */
bFooHigh = (uint8_t)(wFoo16 >> 8); /* MS-Byte */
bFooLow = (uint8_t)(wFoo16); /* LS-Byte */
...
</pre>

Bei einigen AVR-Typen (z.B. ATmega8) teilen sich UBRRH und UCSRC die gleiche Memory-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''.

Bei einigen 16-bit Registern (insbesondere die der 16-bit Timer) erfolgen Schreibzugriffe über das sogenannte ''temporary Register''. Die Reihenfolge der Zugriffe bestimmt, wann der Wert tatsächlich ins Register geschrieben wird. Typisch wird erst das High-Byte beschrieben (xxxH) und intern im temporary Register zwischengespeichert. Nachdem das Low-Byte (xxxL) geschrieben wurde, setzt der Controller mit diesem und dem im temporary Register zwischengespeicherten Wert für das High-Byte das 16-bit Register. Dabei ist zu beachten, dass intern nur ein temporary Register verfügbar ist, welches in Interruptroutinen mglw. mit einem anderen Wert überschrieben wird, wenn dort ebenfalls 16-bit Register beschrieben werden. avr-gcc/avr-libc berücksichtigen die korrekte Reihenfolge automatisch, wenn die Register mit ihrem "16-bit Label" (ohne H bzw. L) angesprochen werden, dabei ist der Schutz des temporary Registers vor Überschreiben durch Interruptroutinen dennoch zu beachten (im Zweifel beim Schreibzugriff die Interrupts kurzzeitig global deaktivieren).

Im Umgang mit 16-Bit Registern siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Related Pages/Frequently Asked Questions/Nr. 8
* Datenblatt Abschnitt ''Accessing 16-bit Registers''

= Der UART =

== Allgemeines zum UART ==

Über den [[UART]] kann ein AVR leicht mit einer [[RS232]]-Schnittstelle eines PC oder sonstiger Geräte mit "serieller Schnittstelle" verbunden werden.

Mögliche Anwendungen des UART:

* Debug-Schnittstelle: z.B. zur Anzeige von Zwischenergebnissen ("printf-debugging" - hier besser "UART-debugging") auf einem PC. Auf dem Rechner reicht dazu eine Terminal-Software (MS-Windows: Hyperterm oder besser Bray-Terminal, [http://www.mikrocontroller.net/forum/read-8-155472.html#new HTerm]; Unix/Linux z.B. minicom). Ein direkter Anschluss ist aufgrund unterschiedlicher Pegel nicht möglich, jedoch sind entsprechende Schnittstellen-ICs wie z.B. ein MAX232 günstig und leicht zu integrieren. Rechner ohne serielle Schnittstelle können über fertige USB-seriell-Adapter angeschlossen werden.
* "Mensch-Maschine Schnittstelle": z.B. Konfiguration und Statusabfrage über eine "Kommandozeile" oder Menüs
* Übertragen von gespeicherten Werten: z.B. bei einem Datenlogger
* Anschluss von Geräten mit serieller Schnittstelle (z.B. (Funk-)Modems, Mobiltelefone, Drucker, Sensoren, "intelligente" LC-Displays, GPS-Empfänger).
* "Feldbusse" auf RS485/RS422-Basis mittels entsprechenden Bustreiberbausteinen (z.B. MAX485)
* DMX, Midi etc.
* LIN-Bus ('''L'''ocal '''I'''nterconnect '''N'''etwork): Preiswerte Sensoren/Aktoren in der Automobiltechnik und darüber hinaus

Einige AVR-Controller haben ein bis zwei vollduplexfähigen UART ('''U'''niversal '''A'''synchronous '''R'''eceiver and '''T'''ransmitter) schon eingebaut ("Hardware-UART").
Übrigens: Vollduplex heisst nichts anderes, als dass der Baustein gleichzeitig senden und empfangen kann.

Neuere AVRs (ATmega, ATtiny) verfügen über einen oder zwei U'''S'''ART(s), dieser unterschiedet sich vom UART hauptsächlich durch interne FIFO-Puffer für Ein- und Ausgabe und erweiterte Konfigurationsmöglichkeiten. Die Puffergröße ist allerdings nur 1 Byte.

Der UART wird über vier separate Register angesprochen. USARTs der ATMEGAs verfügen über mehrere zusätzliche Konfigurationsregsiter. Das Datenblatt gibt darüber Auskunft. Die Folgende Tabelle gibt nur die Register für die (veralteten) UARTs wieder.

{| border="1"
|-
| '''UCR   '''
| '''U'''ART '''C'''ontrol '''R'''egister. 
In diesem Register stellen wir ein, wie wir den UART verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''RXCIE'''
| align="center" | '''TXCIE'''
| align="center" | '''UDRIE'''
| align="center" | '''RXEN'''
| align="center" | '''TXEN'''
| align="center" | '''CHR9'''
| align="center" | '''RXB8'''
| align="center" | '''TXB8'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
|}

'''RXCIE''' ('''RX''' '''C'''omplete '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART RX Complete Interrupt ausgelöst, wenn ein Zeichen vom UART empfangen wurde. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''TXCIE''' ('''TX''' '''C'''omplete '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART TX Complete Interrupt ausgelöst, wenn ein Zeichen vom UART gesendet wurde. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''UDRIE''' ('''U'''ART '''D'''ata '''R'''egister '''E'''mpty '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART Datenregister Leer Interrupt ausgelöst, wenn der UART wieder bereit ist um ein neues zu sendendes Zeichen zu übernehmen. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''RXEN''' ('''R'''eceiver '''E'''nable)
:Nur wenn dieses Bit gesetzt ist, arbeitet der Empfänger des UART überhaupt. Wenn das Bit nicht gesetzt ist, kann der entsprechende Pin des AVR als normaler I/O-Pin verwendet werden.

'''TXEN''' ('''T'''ransmitter '''E'''nable)
:Nur wenn dieses Bit gesetzt ist, arbeitet der Sender des UART überhaupt. Wenn das Bit nicht gesetzt ist, kann der entsprechende Pin des AVR als normaler I/O-Pin verwendet werden.

'''CHR9''' (9 Bit Characters)
:Wenn dieses Bit gesetzt ist, können 9 Bit lange Zeichen übertragen und empfangen werden. Das 9. Bit kann bei Bedarf als zusätzliches Stopbit oder als Paritätsbit verwendet werden. Man spricht dann von einem 11-Bit Zeichenrahmen:
:1 Startbit + 8 Datenbits + 1 Stopbit + 1 Paritätsbit = 11 Bits

'''RXB8''' (Receive Data Bit 8)
:Wenn das vorher erwähnte CHR9-Bit gesetzt ist, dann enthält dieses Bit das 9. Datenbit eines empfangenen Zeichens.

'''TXB8''' (Transmit Data Bit 8)
:Wenn das vorher erwähnte CHR9-Bit gesetzt ist, dann muss in dieses Bit das 9. Bit des zu sendenden Zeichens eingeschrieben werden bevor das eigentliche Datenbyte in das Datenregister geschrieben wird.

|-
| '''USR   '''
| '''U'''ART '''S'''tatus '''R'''egister. 
Hier teilt uns der UART mit, was er gerade so macht.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''RXC'''
| align="center" | '''TXC'''
| align="center" | '''UDRE'''
| align="center" | '''FE'''
| align="center" | '''OR'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''RXC''' (UART Receive Complete)
:Dieses Bit wird vom AVR gesetzt, wenn ein empfangenes Zeichen vom Empfangs-Schieberegister in das Empfangs-Datenregister transferiert wurde.
:Das Zeichen muss nun schnellstmöglich aus dem Datenregister ausgelesen werden. Falls dies nicht erfolgt bevor ein weiteres Zeichen komplett empfangen wurde wird eine Überlauf-Fehlersituation eintreffen. Mit dem Auslesen des Datenregisters wird das Bit automatisch gelöscht.

'''TXC''' (UART Transmit Complete)
:Dieses Bit wird vom AVR gesetzt, wenn das im Sende-Schieberegister befindliche Zeichen vollständig ausgegeben wurde und kein weiteres Zeichen im Sendedatenregister ansteht. Dies bedeutet also, wenn die Kommunikation vollumfänglich abgeschlossen ist.
:Dieses Bit ist wichtig bei Halbduplex-Verbindungen, wenn das Programm nach dem Senden von Daten auf Empfang schalten muss. Im Vollduplexbetrieb brauchen wir dieses Bit nicht zu beachten.
:Das Bit wird nur dann automatisch gelöscht, wenn der entsprechende Interrupthandler aufgerufen wird, ansonsten müssen wir das Bit selber löschen.

'''UDRE''' ('''U'''ART '''D'''ata '''R'''egister '''E'''mpty)
:Dieses Bit wird vom AVR gesetzt, wenn ein Zeichen vom Sendedatenregister in das Send-Schieberegister übernommen wurde und der UART nun wieder bereit ist, ein neues Zeichen zum Senden aufzunehmen.
:Das Bit wird automatisch gelöscht, wenn ein Zeichen in das Sendedatenregister geschrieben wird.

'''FE''' ('''F'''raming '''E'''rror)
:Dieses Bit wird vom AVR gesetzt, wenn der UART einen Zeichenrahmenfehler detektiert, d.h. wenn das Stopbit eines empfangenen Zeichens 0 ist.
:Das Bit wird automatisch gelöscht, wenn das Stopbit des empfangenen Zeichens 1 ist.

'''OR''' ('''O'''ver'''R'''un) 
:Dieses Bit wird vom AVR gesetzt, wenn unser Programm das im Empfangsdatenregister bereit liegende Zeichen nicht abholt bevor das nachfolgende Zeichen komplett empfangen wurde.
:Das nachfolgende Zeichen wird verworfen.
:Das Bit wird automatisch gelöscht, wenn das empfangene Zeichen in das Empfangsdatenregister transferiert werden konnte.

|-
| '''UDR'''
| '''U'''ART '''D'''ata '''R'''egister. 
Hier werden Daten zwischen UART und CPU übertragen. Da der UART im
Vollduplexbetrieb gleichzeitig empfangen und senden kann, handelt es sich
hier physikalisch um 2 Register, die aber über die gleiche I/O-Adresse
angesprochen werden. Je nachdem, ob ein Lese- oder ein Schreibzugriff auf
den UART erfolgt wird automatisch das richtige UDR angesprochen.
|-
| '''UBRR'''
| '''U'''ART '''B'''aud '''R'''ate '''R'''egister. 
In diesem Register müssen wir dem UART mitteilen, wie schnell wir gerne
kommunizieren möchten. Der Wert, der in dieses Register geschrieben
werden muss, errechnet sich nach folgender Formel:

<math>
\begin{matrix}
\mathrm{UBRR} = \frac{\mathrm{Taktfrequenz}}{\mathrm{Baudrate} \cdot 16} - 1
\end{matrix}
</math>

Es sind Baudraten bis zu 115200 Baud und höher möglich.
|}

== Die Hardware ==

Der UART basiert auf normalem TTL-Pegel mit 0V (LOW) und 5V (HIGH). Die
Schnittstellenspezifikation für RS232 definiert jedoch -3V ... -12V (LOW) und
+3 ... +12V (HIGH). Zudem muss der Signalaustausch zwischen AVR und
Partnergerät invertiert werden. Für die Anpassung der Pegel und das
Invertieren der Signale gibt es fertige Schnittstellenbausteine. Der bekannteste
davon ist wohl der MAX232.


Streikt die Kommunikation per UART, so ist oft eine fehlerhafte Einstellung der Baudrate die Ursache. Die Konfiguration auf eine bestimmte Baudrate ist abhängig von der Taktfrequenz des Controllers. Gerade bei neu aufgebauten Schaltungen (bzw. neu gekauften Controllern) sollte man sich daher noch einmal vergewissern, dass der Controller auch tatsächlich mit der vermuteten Taktrate arbeitet und nicht z.B. den bei einigen Modellen werksseitig eingestellten internen [[Oszillator]] statt eines externen Quarzes nutzt. Die Werte der verschiedenen fuse-bits im Fehlerfall also beispielsweise mit ''[[AVRDUDE]]'' kontrollieren und falls nötig anpassen. Grundsätzlich empfiehlt sich auch immer ein Blick in die [[AVR_Checkliste]].

== Senden mit dem UART ==

Wir wollen nun Daten mit dem UART auf die serielle Schnittstelle ausgeben.

Dazu müssen wir den UART zuerst mal initialisieren. Dazu setzen wir je nach
gewünschter Funktionsweise die benötigten Bits im '''U'''ART '''C'''ontrol '''R'''egister.

Da wir vorerst nur senden möchten und (noch) keine Interrupts auswerten wollen, gestaltet sich die Initialisierung wirklich sehr einfach, da wir lediglich das '''Transmitter Enable''' Bit setzen müssen:

<pre class="code">
UCR |= (1<<TXEN);
</pre>

Neuere AVRs mit USART(s) haben mehrere Konfigurationsregister und erfordern eine etwas andere Konfiguration. Für einen ATmega16 z.B.:

<pre class="code">
UCSRB |= (1<<TXEN); // UART TX einschalten
UCSRC |= (1<<URSEL)|(3<<UCSZ0); // Asynchron 8N1
</pre>

Nun ist noch das bzw. sind noch die Baudratenregister einzustellen (UBRR bzw. UBRRL/UBRRH). Der Wert dafür ergibt sich aus der angegebenen Formel durch Einsetzen der Taktfrequenz und der gewünschten Übertragungsrate. (Das Berechnen der Formel kann man dem [[C-Präprozessor|Präprozessor]] überlassen).

<pre class="code">
/* UART-Init beim AT90S2313 */

#ifndef F_CPU
/* In neueren Version der WinAVR/Mfile Makefile-Vorlage kann
F_CPU im Makefile definiert werden, eine nochmalige Definition
hier wuerde zu einer Compilerwarnung fuehren. Daher "Schutz" durch
#ifndef/#endif */
/* Zum Beispiel 4Mhz-Quarz (falls nicht schon im Makefile definiert): */
#define F_CPU 4000000;
#endif
#define UART_BAUD_RATE 9600 // 9600 Baud

UBRR = F_CPU / (UART_BAUD_RATE * 16L) - 1;
</pre>

Wieder für den Mega16 mit einem 16bit-Register eine etwas andere Programmierung.

<pre class="code">
/* USART-Init beim ATmega16 */
#ifndef F_CPU
#define F_CPU 3686400 /* Oszillator-Frequenz in Hz */
#endif

// Hilfsmakro zur UBRR-Berechnung ("Formel" laut Datenblatt)
#define UART_UBRR_CALC(BAUD_,FREQ_) ((FREQ_)/((BAUD_)*16L)-1)

#define UART_BAUD_RATE 9600

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

/* alternativ bei der avr-libc "direkt 16bit" : */
UBRR = UART_UBRR_CALC(UART_BAUD_RATE,F_CPU);
</pre>

Teilweise kann man im Datenblatt der jeweiligen CPU auch den entsprechenden Wert nachschlagen. Ein Beispiel für einen ATmega32 bei 16MHz und für 19200 Baud: im Datenblatt des ATmega32 Tabelle "Examples of UBRR Settings" liest man für diese Vorgaben den Wert 51 ab. Dieser wird nun auf die Register UBRRH und UBRRL verteilt.

Die Initialisierung für den USART könnte dann so aussehen:

<pre class="code">
/* USART-Init 19200 Baud bei 16MHz für Mega32 */
UCSRB |= ( 1 << TXEN ); // UART TX einschalten
UCSRC |= ( 1 << URSEL )|( 3<<UCSZ0 ); // Asynchron 8N1
UBRRH = 0; // Highbyte ist 0
UBRRL = 51; // Lowbyte ist 51 ( dezimal )
</pre>

Der obige Code ist gegenüber den Versionen mit '#define ...' nicht so portabel, dafür aber etwas übersichtlicher.

=== Senden einzelner Zeichen ===

Um nun ein Zeichen auf die Schnittstelle auszugeben, müssen wir dasselbe
lediglich in das '''U'''ART '''D'''ata '''R'''egister schreiben. Vorher ist zu prüfen, ob das UART-Modul bereit ist das zu sendende Zeichen entgegenzunehmen. Die Bezeichnungen des/der Statusregisters mit dem Bit UDRE ist abhängig vom Controllertypen (vgl. Datenblatt).

<pre class="code">
// bei AVR mit einem UART ("classic AVR" z.B. AT90S8515)
while (!(USR & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = 'x'; /* schreibt das Zeichen x auf die Schnittstelle */

/** ODER **/

// bei neueren AVRs steht der Status in UCSRA/UCSR0A/UCSR1A, hier z.B. fuer ATmega16:
while (!(UCSRA & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = 'x'; /* schreibt das Zeichen x auf die Schnittstelle */
</pre>

=== Schreiben einer Zeichenkette (String) ===

Die Aufgabe "String senden" wird durch zwei Funktionen abgearbeitet. Die universelle/controllerunabhängige Funktion uart_puts übergibt jeweils ein Zeichen der Zeichenkette an eine Funktion uart_putc, die abhängig von der vorhandenen Hardware implementiert werden muss. In der Funktion zum Senden eines Zeichens ist darauf zu achten, dass vor dem Senden geprüft wird, ob der UART bereit ist den "Sendeauftrag" entgegenzunehmen.

<pre class="code">
// putc fuer AVR mit einem UART (z.B. AT90S8515)
int uart_putc(unsigned char c)
{
while(!(USR & (1 << UDRE))); /* warte, bis UDR bereit */
UDR = c; /* sende Zeichen */
return 0;
}

/** ODER **/

// bei neueren AVRs andere Bezeichnung fuer die Statusregister, hier ATmega16:
int uart_putc(unsigned char c)
{
while (!(UCSRA & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = c; /* sende Zeichen */
return 0;
}

/* puts ist unabhaengig vom Controllertyp */
void uart_puts (char *s)
{
while (*s)
{ /* so lange *s != '\0' also ungleich dem "String-Endezeichen" */
uart_putc(*s);
s++;
}
}


</pre>

Warteschleifen sind insofern etwas kritisch, da während des Sendens eines Strings nicht mehr auf andere Ereignisse reagieren werden kann. Universeller ist die Nutzung von FIFO(first-in first-out)-Puffern, in denen die zu sendenden bzw. empfangenen Zeichen/Bytes zwischengespeichert und mittels Interruptroutinen an den U(S)ART weitergegeben bzw. ausgelesen werden. Dazu existieren fertige Komponenten (Bibliotheken, Libraries), die man recht einfach in eigene Entwicklungen integrieren kann. Es empfiehlt sich, diese Komponenten zu nutzen und das Rad nicht neu zu erfinden.

== Zeichen Empfangen ==

Zum Empfang von Zeichen muss der Empfangsteil des UART bei der Initialisierung aktiviert werden, indem das RXEN-Bit im jeweiligen Konfigurationsregister (UCSRB bzw UCSR0B/UCSR1B) gesetzt wird. Im einfachsten Fall wird solange gewartet, bis ein Zeichen empfangen wurde, dieses steht dann im UART-Datenregister (UDR bzw. UDR0 und UDR1 bei AVRs mit 2 UARTS) zur Verfügung (sogen. "Polling-Betrieb"). Ein Beispiel für den ATmega16:

<pre class="code">
#include <inttypes.h>
#include <avr/io.h>

/* Zusaetzlich zur Baudrateneinstellung und der weiteren Initialisierung: */
void Usart_EnableRX()
{
UCSRB |= ( 1 << RXEN );
}

/* Zeichen empfangen */
uint8_t Usart_Rx(void)
{
while (!(UCSRA & (1<<RXC))); // warten bis Zeichen verfuegbar
return UDR; // Zeichen aus UDR an Aufrufer zurueckgeben
}
</pre>

Diese Funktion blockiert den Programmablauf. Alternativ kann das RXC-Bit in einer Programmschleife abgefragt werden und dann nur bei gesetztem RXC-Bit UDR ausgelesen werden. Eleganter und in den meisten Anwendungsfällen "stabiler" ist die Vorgehensweise, die empfangenen Zeichen in einer Interrupt-Routine einzulesen und zur späteren Verarbeitung in einem Eingangsbuffer (FIFO-Buffer) zwischenzuspeichern. Dazu existieren fertige und gut getestete [[Libraries|Bibliotheken]]  und Quellcodekomponenten (z.B. UART-Library von P. Fleury, procyon-avrlib und einige in der "Academy" von avrfreaks.net).

TODO: 9bit

== Software-UART ==

Falls die Zahl der vorhandenen Hardware-UARTs nicht ausreicht, können weitere Schnittstellen über sogennante Software-UARTs ergänzt werden. Es gibt dazu (mindestens) zwei Ansätze:
* Der bei AVRs üblichste Ansatz basiert auf dem Prinzip, dass ein externer Interrupt-Pin für den Empfang ("RX") genutzt wird. Das Startbit löst den Interrupt aus, in der Interrupt-Routine (ISR) wird der externe Interrupt deaktiviert und ein Timer aktiviert. In der Interrupt-Routine des Timers wird der Zustand des Empfangs-Pins entsprechend der Baudrate abgetastet. Nach Empfang des Stop-Bits wird der externe Interrupt wieder aktiviert. Senden kann über einen beliebigen Pin ("TX") erfolgen, der entsprechend der Baudrate und dem zu sendenden Zeichen auf 0 oder 1 gesetzt wird. Die Implementierung ist nicht ganz einfach, es existieren dazu aber fertige Bibliotheken (z.B. bei [http://www.avrfreaks.net/ avrfreaks] oder in der [http://hubbard.engr.scu.edu/embedded/avr/avrlib/ Procyon avrlib]).
* Ein weiterer Ansatz erfordert keinen Pin mit "Interrupt-Funktion" aber benötigt mehr Rechenzeit. Jeder Input-Pin kann als Empfangspin (RX) dienen. Über einen Timer wird der Zustand des RX-Pins mit einem vielfachen der Baudrate abgetastet (dreifach scheint üblich) und High- bzw. Lowbits anhand einer Mindestanzahl identifiziert. (Beispiel: "Generic Software Uart" Application-Note von IAR)

Neuere AVRs (z.B. ATtiny26 oder ATmega48,88,168,169) verfügen über ein Universal Serial Interface (USI), das teilweise UART-Funktion übernehmen kann. Atmel stellt eine Application-Note bereit, in der die Nutzung des USI als UART erläutert wird (im Prinzip "Hardware-unterstützter Software-UART").

* siehe auch: Weiterführende Informationen inkl. Beispielen für die Nutzung von stdio-Funktionen (printf etc.) im [[AVR-Tutorial - UART]].
* [http://homepage.hispeed.ch/peterfleury/ Peter Fleurys] UART-Bibiliothek fuer avr-gcc/avr-libc

= 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 analogen Signale (Spannungen) in digitale Zahlenwerte gewandelt. Bei AVRs, die über keinen internen AD-Wandler verfügen (z.B. ATmega162, ATtiny2313), kann durch externe Beschaltung (R/C-Netzwerk und "Zeitmessung") die Funktion des AD-Wandlers "emuliert" werden.

Es existieren keine AVRs mit eingebautem Digital-Analog-Konverter (DAC). Diese Funktion muss durch externe Komponenten nachgebildet werden (z.B. PWM und "Glättung").

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.

== 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 Genauigkeit, mit welcher ein analoges Signal aufgelöst werden kann, wird durch die Auflösung des ADC in Anzahl Bits angegeben, man hört bzw. liest jeweils von 8-Bit-ADC oder 10-Bit-ADC oder noch höher.

Ein ADC mit 8 Bit Auflösung kann somit das analoge Signal mit einer Genauigkeit von 1/256 des Maximalwertes darstellen. Wenn wir nun mal annehmen, wir hätten eine Spannung zwischen 0 und 5 Volt und eine Auflösung von 3 Bit, dann könnten
die Werte 0V, 0.625V, 1.25, 1.875V, 2.5V, 3.125V, 3.75, 4.375, 5V
daherkommen, siehe dazu folgende Tabelle:

<div align="center"><center>

{| border="1"
|-
| align="center" | '''Eingangsspannung am ADC'''
| align="center" | '''Entsprechender Messwert'''
|-
| align="center" | 0...<0.625V
| align="center" | 0
|-
| align="center" | 0.625...<1.25V
| align="center" | 1
|-
| align="center" | 1.25...<1.875V
| align="center" | 2
|-
| align="center" | 1.875...<2.5V
| align="center" | 3
|-
| align="center" | 2.5...<3.125V
| align="center" | 4
|-
| align="center" | 3.125...<3.75V
| align="center" | 5
|-
| align="center" | 3.75...<4.375V
| align="center" | 6
|-
| align="center" | 4.375...5V
| align="center" | 7
|}

</center>
</div>

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, um so genauer kann der Wert erfasst werden.

=== Der interne ADC im AVR ===

Wenn es einmal etwas genauer sein soll, dann müssen wir auf einen AVR mit eingebautem Analog-Digital-Wandler (ADC) zurückgreifen, die über mehrere Kanäle verfügen. Kanäle heisst in diesem Zusammenhang, dass zwar bis zu zehn analoge Eingänge am AVR verfügbar sind, aber nur ein "echter" Analog-Digital-Wandler zur Verfügung steht, vor der eigentlichen Messung ist also einzustellen, 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 Mikrohenry und 100 nF 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.
* Die '''interne''' Referenzspannung wird auf '''Vcc''' bezogen, eine externe Referenzspannung auf '''GND (Masse)'''. Davon unabhängig werden digitalisierte Spannungen '''immer''' auf GND bezogen. Beim ATMEGA8 z.B. ist der Pin AREF über 32kOhm mit GND verbunden, d.h. man muss diese doch extrem niedrige Eingangsimpedanz mit in die Berechnung für einen Spannungsteiler einbeziehen, bzw. kann diesen Widerstand als R2 gleich mit benutzen. Formel für Spannungsteiler: Udiv=U/((R1+R2)/R2)

Bei Nutzung von Vcc 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 angestossen 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 (inzwischen veralteten) AT90S8535, welcher über 8 ADC-Kanäle verfügt. Die Register unterscheiden sich jedoch nicht erheblich von denen aktueller AVRs (vgl. Datenblatt).

{| border="1"
|-
| '''ADCSR   '''
| '''ADC''' '''C'''ontrol and '''S'''tatus '''R'''egister. 
In diesem Register stellen wir ein, wie wir den '''ADC''' verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''ADEN'''
| align="center" | '''ADSC'''
| align="center" | '''ADFR'''
| align="center" | '''ADIF'''
| align="center" | '''ADIE'''
| align="center" | '''ADPS2'''
| align="center" | '''ADPS1'''
| align="center" | '''ADPS0'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
|}

'''ADEN''' ('''AD'''C '''En'''able)
: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''' ('''AD'''C '''S'''tart '''C'''onversion)
: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''' ('''AD'''C '''Fr'''ee Running Select)
:Mit diesem Bit wird die Betriebsart eingestellt.
:Eine logische 1 aktiviert den frei laufenden Modus. Der ''' ADC''' misst nun ständig den ausgewählten Kanal und schreibt den gemessenen Wert in das '''ADC Data Register'''.

'''ADIF''' ('''AD'''C '''I'''nterrupt '''F'''lag)
:Dieses Bit wird vom ''' ADC''' gesetzt, wenn eine Umwandlung erfolgt und das '''ADC Data Register''' aktualisiert ist.
: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 (So steht es in der AVR-Dokumentation).

'''ADIE''' ('''AD'''C '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist und ebenso das ''' I-Bit''' im Statusregister '''SREG''', dann wird der ''' ADC-Interrupt''' aktiviert.

'''ADPS2...ADPS0''' ('''AD'''C '''P'''rescaler '''S'''elect 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 sein.
:Der Vorteiler muss also so eingestellt werden, dass die CPU-Taktfrequenz dividiert durch den Teilungsfaktor einen Wert zwischen 50-200kHz ergibt.
:Bei einer CPU-Taktfrequenz von 4MHz beispielsweise rechnen wir

:<math>
\begin{matrix}
TF_{min}=\frac{CLK}{200kHz}=\frac{4000000}{200000}=\mathbf{20}
\\
\\
TF_{max}=\frac{CLK}{50kHz}=\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.
<dl><dd>
{| style="" border="1"
|-
| align="center" | '''ADPS2'''
| align="center" | '''ADPS1'''
| align="center" | '''ADPS0'''
| align="center" | '''Teilungsfaktor'''
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 2
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 2
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 4
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| align="center" | 8
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 16
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| align="center" | 32
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| align="center" | 64
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| align="center" | 128
|}
</dd></dl>
|-
| '''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:

<pre class="code">
x = ADCL; // mit uint16_t x
x += (ADCH<<8); // in zwei Zeilen (LSB/MSB-Reihenfolge und
C-Operatorprioritaet sichergestellt)
</pre>

oder

<pre class="code">
x = ADCW; // je nach AVR auch x = ADC (siehe avr/ioxxx.h)
</pre>

|-
| '''ADMUX  '''
| '''AD'''C '''Mu'''ltiple'''x'''er 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:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''MUX2'''
| align="center" | '''MUX1'''
| align="center" | '''MUX0'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''MUX2...MUX0'''
:Mit diesem 3 Bits wird der zu messende Kanal bestimmt. Es wird einfach die entsprechende Pinnummer des Ports eingeschrieben.
:Wenn das Register beschrieben wird, während dem 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.

:Meine Empfehlung ist deswegen klar 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.
|}

==== Aktivieren des ADC ====

Um den ''' ADC''' zu aktivieren, müssen wir das '''ADEN'''-Bit im '''ADCSR'''-Register
setzen. Im gleichen Schritt legen wir auch gleich 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 mit Spannungsteiler konditionieren. Ergebnis der Routine ist der ADC-Wert, also 0 für 0-Volt und 1024 für V_ref-Volt.

<pre class="code">

uint16_t ReadChannel(uint8_t mux)
{
uint8_t i;
uint16_t result = 0; //Initialisieren wichtig, da lokale Variablen
//nicht automatisch initialisiert werden und
//zufällige Werte haben. Sonst kann Quatsch rauskommen
ADCSRA = (1<<ADEN) | (1<<ADPS1) | (1<<ADPS0); // Frequenzvorteiler
// setzen auf 8 (1) und ADC aktivieren (1)

ADMUX = mux; // Kanal waehlen
ADMUX |= (1<<REFS1) | (1<<REFS0); // interne Referenzspannung nutzen

/* 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



/* Eigentliche Messung - Mittelwert aus 4 aufeinanderfolgenden Wandlungen */
for(i=0;i<4;i++)
{
ADCSRA |= (1<<ADSC); // eine Wandlung "single conversion"

while ( ADCSRA & (1<<ADSC) ); // auf Abschluss der Konvertierung warten
result += ADCW; // Wandlungsergebnisse aufaddieren
}
ADCSRA &= ~(1<<ADEN); // ADC deaktivieren (2)

result /= 4; // Summe durch vier teilen = arithm. Mittelwert

return result;
}

...

/* Beispielaufrufe: */

void foo(void)
{
uint16_t adcval;

adcval = ReadChannel(0); /* MUX-Bits auf 0b0000 -> Channel 0 */
...
adcval = ReadChannel(2); /* MUX-Bits auf 0b0010 -> Channel 2 */
...
}

</pre>

Im Beispiel wird bei jedem Aufruf der ADC aktiviert und nach der Wandlung wieder abgeschaltet, das spart Strom. Will man dies nicht, verschiebt man die mit (1) gekennzeichneten Zeilen in eine Funktion adc_init() o.ä. und löscht die mit (2) markierten Zeilen. Das Löschen des ADIF-Flags sollte, '''entgegen''' der [http://www.nongnu.org/avr-libc/user-manual/FAQ.html#faq_intbits FAQ], mit
<pre class="code">
...
ADCSRA |= (1<<ADIF);
...
</pre>
erfolgen. Die Methode in der FAQ eignet sich nur für Register in denen '''nur''' Interrupt-Flags stehen.

=== 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 eine 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.

[[Image:Poti.gif]]

Wird der Portpin des Controllers auf Ausgang konfiguriert (im Beispiel ''DDRD |= (1<<PD3)'') und dieser Ausgang auf Logisch 1 ("High", ''PORTD |= (1<<PD3)'') 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<<PD3); PORTD &= (1<<PD3)''), 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 Thresholdspannung 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 Ohm Widerstand dient dem Schutz des Controllers. Es würde sonst bei Maximaleinstellung des Potentionmeters (hier 0 Ohm) ein zu hoher Strom fliessen, der die Eingangsstufe 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. Ein Beispielprogramm findet sich auf [http://www.mypage.bluewin.ch/ch_schifferle/ Christian Schifferles Web-Seite] im Archiv ''ATMEL.ZIP'', welches unter den Titel ''Tutorial "Programmieren mit C für Atmel Mikrocontroller'' heruntergeladen werden kann.



==== 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.

[[Image:ADC ueber Komparator.gif]]

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:

[[Image:DAC R2R.gif]]

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:

[[Image:PWM Theorie 1.gif]]

Diese Rechteckspannung hat nun einen geometrischen Mittelwert,
der je nach Pulsbreite kleiner oder grösser ist.

[[Image:PWM Theorie 2.gif]]

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

Mit den AVR's 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:

{| border="1"
|-
| align="center" | '''PWM11'''
| align="center" | '''PWM10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| PWM-Modus des Timers ist nicht aktiv.
|-
| align="center" | 0
| align="center" | 1
| 8-Bit PWM.
|-
| align="center" | 1
| align="center" | 0
| 9-Bit PWM.
|-
| align="center" | 1
| align="center" | 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:

{| border="1"
|-
| align="center" | '''Auflösung'''
| align="center" | '''Obergrenze'''
| '''Frequenz'''
|-
| align="center" | 8
| align="center" | 255
| fTC1 / 510
|-
| align="center" | 9
| align="center" | 511
| fTC1 / 1022
|-
| align="center" | 10
| align="center" | 1023
| fTC1 / 2046
|}

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

{| border="1"
|-
| align="center" | '''COM1A1'''
| align="center" | '''COM1A0'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Keine Wirkung, Pin wird nicht geschaltet.
|-
| align="center" | 0
| align="center" | 1
| Keine Wirkung, Pin wird nicht geschaltet.
|-
| align="center" | 1
| align="center" | 0
| Nicht invertierende PWM. 
Der Ausgangspin wird gelöscht beim Hochzählen und gesetzt beim
Herunterzählen.
|-
| align="center" | 1
| align="center" | 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 heisst dann:

<pre class="code">
TCCR1A = (1<<PWM11)|(1<<PWM10)|(1<<COM1A1);
</pre>

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.

{| border="1"
|-
| align="center" | '''CS12'''
| align="center" | '''CS11'''
| align="center" | '''CS10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stop. Der Timer/Counter wird gestoppt.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CK
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CK / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CK / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CK / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CK / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin 1, negative Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin 1, positive Flanke
|}

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

<pre class="code">
TCCR1B = (1<<CS12) | (1<<CS10);
</pre>

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

<pre class="code">
OCR1A = xxx;
</pre>

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

[[Image:PWM Theorie 3.gif]]

[[Image:PWM Theorie 4.gif]]

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.

= Die Timer/Counter des AVR =

Die heutigen Mikrocontroller und insbesondere die RISC-AVRs sind für viele Steuerungsaufgaben zu schnell. Wenn wir beispielsweise eine LED oder Lampe blinken lassen wollen, können wir selbstverständlich nicht die CPU-Frequenz verwenden, da ja dann nichts mehr vom Blinken zu bemerken wäre.

Wir brauchen also eine Möglichkeit, Vorgänge in Zeitabständen durchzuführen, die geringer als die Taktfrequenz des Controllers sind. Selbstverständlich sollte die resultierende Frequenz auch noch möglichst genau und stabil sein.

Hier kommen die im AVR vorhandenen Timer/Counter zum Einsatz.

Ein anderes Anwendungsgebiet ist die Zählung von Signalen, welche über einen I/O-Pin zugeführt werden können.

Die folgenden Ausführungen beziehen sich auf den AT90S2313. Für andere Modelltypen müsst ihr euch die allenfalls notwendigen Anpassungen aus den Datenblättern der entsprechenden Controller herauslesen.

Wir unterscheiden grundsätzlich zwischen 8-Bit Timern, welche eine Auflösung von 256 aufweisen und 16-Bit Timern mit (logischerweise) einer Auflösung von 65536. Als Eingangstakt für die Timer/Counter kann entweder die CPU-Taktfrequenz, der Vorteiler-Ausgang oder ein an einen I/O-Pin angelegtes Signal verwendet werden. Wenn ein externes Signal verwendet wird, so darf dessen Frequenz nicht höher sein als die Hälfte des CPU-Taktes.

== Der Vorteiler (Prescaler) ==


Der Vorteiler dient dazu, den CPU-Takt vorerst um einen einstellbaren Faktor zu reduzieren. Die so geteilte Frequenz wird den Eingängen der Timer zugeführt.

Wenn wir mit einem CPU-Takt von 4 MHz arbeiten und den Vorteiler auf 1024 einstellen, wird also der Timer mit einer Frequenz von 4 MHz / 1024, also mit ca. 4 kHz versorgt. Wenn also der Timer läuft, so wird das Daten- bzw. Zählregister (TCNTx) mit dieser Frequenz inkrementiert.

== 8-Bit Timer/Counter ==

Alle AVR-Modelle verfügen über mindestens einen, teilweise sogar zwei, 8-Bit Timer.

Der 8-Bit Timer wird z.B bei AT90S2313 über folgende Register angesprochen (bei anderen Typen weitestgehend analog):

{| border="1"
|-
| '''TCCR0'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister
Timer '''0'''

In diesem Register stellen wir ein, wie wir den Timer/Counter verwenden möchten.

Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''CS02'''
| align="center" | '''CS01'''
| align="center" | '''CS00'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''CS02, CS01, CS00''' ('''C'''lock '''S'''elect Bits)
:Diese 3 Bits bestimmen die Quelle für den Timer/Counter:
<dl><dd>
{| border="1"
|-
| align="center" | CS02
| align="center" | CS01
| align="center" | CS00
| Resultat
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stopp, Der Timer/Counter wird angehalten.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CPU-Takt
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CPU-Takt / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CPU-Takt / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CPU-Takt / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CPU-Takt / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin '''TO''', fallende Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin '''TO''', steigende Flanke
|}
</dd>
</dl>
:Wenn als Quelle der externe Pin '''TO''' verwendet wird, so wird ein Flankenwechsel auch erkannt, wenn der Pin '''TO''' als Ausgang geschaltet ist.

|-
| '''TCNT0'''
| '''T'''imer/'''C'''ou'''nt'''er Daten Register Timer '''0''' 
Dieses ist als 8-Bit Aufwärtszähler mit Schreib- und Lesezugriff
realisiert. Wenn der Zähler den Wert 255 erreicht hat beginnt er beim
nächsten Zyklus wieder bei 0.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}
|}

Um nun also den Timer0 in Betrieb zu setzen und ihn mit einer Frequenz von 1/1024-tel des CPU-Taktes zählen zu lassen, schreiben wir die folgende Befehlszeile:

<pre class="code">
TCCR0 |= (1<<CS00)|(1<<CS02);
</pre>

Der Zähler zählt nun aufwärts bis 255, um dann wieder bei 0 zu beginnen. Der aktuelle Zählerstand steht in TCNT0. Bei jedem Überlauf von 255 auf 0 wird das Timer Overflow Flag '''TOV0''' im Timer Interrupt Flag '''TIFR'''-Register gesetzt und, falls so konfiguriert, ein entsprechender Timer-Overflow-Interrupt ausgelöst und die daran gebundene Interrupt-Routine abgearbeitet.

== 16-Bit Timer/Counter ==

Viele AVR-Modelle besitzen ausser den 8-Bit Timern auch 16-Bit Timer. Die 16-Bit Timer/Counter sind etwas komplexer aufgebaut als die 8-Bit Timer/Counter, bieten dafür aber auch viel mehr Möglichkeiten, als da sind:

* Die [[PWM]]-Betriebsart Erzeugung eines pulsweitenmodulierten Ausgangssignals.
* Vergleichswert-Überprüfung mit Erzeugung eines Ausgangssignals (Output Compare Match).
* Einfangen eines Eingangssignals mit Speicherung des aktuellen Zählerwertes (Input Capturing), mit zuschaltbarer Rauschunterdrückung (Noise Filtering).

Folgende Register sind dem Timer/Counter 1 zugeordnet:

{| border="1"
|-
| '''TCCR1A'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister '''A''' Timer '''1''' 
In diesem und dem folgenden Register stellen wir ein, wie wir den Timer/Counter verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''COM1A1'''
| align="center" | '''COM1A0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''PWM11'''
| align="center" | '''PWM10'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''COM1A1''', '''COM1A0''' ('''Co'''mpare '''M'''atch Control Bits)
:Diese 2 Bits bestimmen die Aktion, welche am Output-Pin '''OC1''' ausgeführt werden soll, wenn der Wert des Datenregisters des Timer/Counter 1 den Wert des Vergleichsregisters erreicht, also ein so genannter Compare Match auftritt.
:Der Pin '''OC1''' ('''PB3''' beim 2313) muss mit dem Datenrichtungsregister als Ausgang konfiguriert werden.

<dl><dd>
{| border="1"
|-
| align="center" | COM1A1
| align="center" | COM1A0
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 0
| align="center" | 1
| Das Signal am Pin '''OC1''' wird invertiert (Toggle).
|-
| align="center" | 1
| align="center" | 0
| Der Output Pin '''OC1''' wird auf 0 gesetzt.
|-
| align="center" | 1
| align="center" | 1
| Der Output Pin '''OC1''' wird auf 1 gesetzt.
|}
</dd></dl>
:In der PWM-Betriebsart haben diese Bits eine andere Funktion.
<dl><dd>
{| border="1"
|-
| align="center" | COM1A1
| align="center" | COM1A0
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 0
| align="center" | 1
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 1
| align="center" | 0
| Wird beim Hochzählen der Wert im Vergleichsregister erreicht, so wird der Pin '''OC1''' auf 0 gesetzt.
Wird beim Herunterzählen der Wert im Vergleichsregister erreicht, so wird der Pin auf 1 gesetzt.

Man nennt dies ''nicht invertierende PWM''.
|-
| align="center" | 1
| align="center" | 1
| Wird beim Hochzählen der Wert im Vergleichsregister erreicht, so wird der Pin '''OC1''' auf 1 gesetzt.
Wird beim Herunterzählen der Wert im Vergleichsregister erreicht, so wird der Pin auf 0 gesetzt.

Man nennt dies ''invertierende PWM''.
|}
</dd></dl>

'''PWM11''', '''PWM10''' ('''PWM''' Mode Select Bits)
:Mit diesen 2 Bits wird die PWM-Betriebsart des Timer/Counter 1 gesteuert.
<dl><dd>
{| border="1"
|-
| align="center" | PWM11
| align="center" | PWM10
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Die PWM-Betriebsart ist nicht aktiviert. Timer/Counter 1 arbeitet als normaler Timer bzw. Zähler.
|-
| align="center" | 0
| align="center" | 1
| 8-Bit PWM Betriebsart aktivieren.
|-
| align="center" | 1
| align="center" | 0
| 9-Bit PWM Betriebsart aktivieren.
|-
| align="center" | 1
| align="center" | 1
| 10-Bit PWM Betriebsart aktivieren.
|}
</dd></dl>
|-
| '''TCCR1B'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister '''B''' Timer '''1'''

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''ICNC1'''
| align="center" | '''ICES1'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''CTC1'''
| align="center" | '''CS12'''
| align="center" | '''CS11'''
| align="center" | '''CS10'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''ICNC1''' ('''I'''nput '''C'''apture '''N'''oise '''C'''anceler (4 CKs) Timer/Counter 1
:oder auf Deutsch Rauschunterdrückung des Eingangssignals.
:Wenn dieses Bit gesetzt ist und mit dem Input Capture Signal gearbeitet wird so werden nach der Triggerung des Signals mit der entsprechenden Flanke (steigend oder fallend) am Input Capture Pin '''ICP''' jeweils 4 Messungen mit der CPU-Frequenz des Eingangssignals abgefragt. Nur dann, wenn alle 4 Messungen den gleichen Zustand aufweisen gilt das Signal als erkannt.

'''ICES1''' ('''I'''nput '''C'''apture '''E'''dge '''S'''elect Timer/Counter '''1''')
:Mit diesem Bit wird bestimmt, ob die steigende ('''ICES1'''=1) oder fallende ('''ICES1'''=0) Flanke zur Auswertung des Input Capture Signals an Pin '''ICP''' heran gezogen wird.

'''CTC1''' ('''C'''lear '''T'''imer/'''C'''ounter on Compare Match Timer/Counter '''1''')
:Wenn dieses Bit gesetzt ist, so wird nach einer Übereinstimmung des Datenregisters '''TCNT1H'''/'''TCNT1L''' mit dem Vergleichswert in '''OCR1H'''/'''OCR1L''' das Datenregister '''TCNT1H'''/'''TCNT1L''' auf 0 gesetzt.
:Da die Übereinstimmung im Takt nach dem Vergleich behandelt wird, ergibt sich je nach eingestelltem Vorteiler ein etwas anderes Zählverhalten:
:Wenn der Vorteiler auf 1 gestellt ist und C der jeweilige Zählerwert ist, dann nimmt das Datenregister, im CPU-Takt betrachtet, folgende Werte an:
:... | C-2 | C-1 | C | 0 | 1 |...
:Wenn der Vorteiler z.B. auf 8 eingestellt ist, dann nimmt das Datenregister folgende Werte an:
:... | C-2, C-2, C-2, C-2, C-2, C-2, C-2, C-2 | C-1, C-1, C-1, C-1, C-1, C-1, C-1, C-1 | C, 0, 0, 0, 0, 0, 0, 0 |...
:In der PWM-Betriebsart hat dieses Bit keine Funktion.

'''CS12''', '''CS11''', '''CS10''' ('''C'''lock '''S'''elect Bits)
:Diese 3 Bits bestimmen die Quelle für den Timer/Counter:
<dl><dd>
{| border="1"
|-
| align="center" | CS12
| align="center" | CS11
| align="center" | CS10
| Resultat
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stopp, Der Timer/Counter wird angehalten.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CPU-Takt
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CPU-Takt / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CPU-Takt / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CPU-Takt / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CPU-Takt / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin TO, fallende Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin T0, steigende Flanke
|}
</dd></dl>
:Wenn als Quelle der externe Pin T0 verwendet wird, so wird ein Flankenwechsel auch erkannt, wenn der Pin T0 als Ausgang geschaltet ist.
|-
| '''TCNT1H''' '''TCNT1L'''
| '''T'''imer/'''C'''ou'''nt'''er Daten Register Timer/Counter '''1'''
Dieses ist als 16-Bit Aufwärtszähler mit Schreib- und Lesezugriff realisiert. Wenn der Zähler den Wert 65535 erreicht hat, beginnt er beim nächsten Zyklus wieder bei 0.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''TCNT1H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''TCNT1L'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

In der PWM-Betriebsart wird das Register als Auf/Ab-Zähler verwendet, d.h. der Wert steigt zuerst von 0 bis er den Überlauf von 65535 auf 0 erreicht hat. Dann zählt das Register rückwärts wiederum bis 0.

Zum Auslesen des Registers wird von der CPU ein internes TEMP-Register verwendet. Das gleiche Register wird auch verwendet, wenn auf '''OCR1''' oder '''ICR1''' zugegriffen wird.

Deshalb müssen vor dem Zugriff auf eines dieser Register alle Interrupts gesperrt werden, weil sonst die Möglichkeit des gleichzeitigen Zugriffs auf das Temporärregister gegeben ist, was natürlich zu fehlerhaftem Verhalten des Programms führt.. Zudem muss zuerst '''TCNT1L''' und erst danach '''TCNT1H''' ausgelesen werden.

Wenn in das Register geschrieben werden soll, müssen ebenfalls alle Interrrupts gesperrt werden. Dann muss zuerst das '''TCNT1H'''-Register und erst danach das '''TCNT1L'''-Register geschrieben werden, also genau die umgekehrte Reihenfolge wie beim Lesen des Registers.
|-
| '''OCR1H''' '''OCR1L'''
| Timer/Counter '''O'''utput '''C'''ompare '''R'''egister Timer/Counter '''1'''
{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''OCR1H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''OCR1L'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

Der Wert im Output Compare Register wird ständig mit dem aktuellen Wert im Datenregister TCNT1H/TCNT1L verglichen. Stimmen die beiden Werte überein, so wird ein sogenannter Output Compare Match ausgelöst. Die entsprechenden Aktionen werden über die Timer/Counter 1 Control und Status Register eingestellt.

Zum Auslesen des Registers wird von der CPU ein internes TEMP-Register verwendet. Das gleiche Register wird auch verwendet, wenn auf '''OCR1''' oder '''ICR1''' zugegriffen wird.
Deshalb müssen vor dem Zugriff auf eines dieser Register alle Interrupts gesperrt werden, weil sonst die Möglichkeit des gleichzeitigen Zugriffs auf das Temporärregister gegeben ist, was natürlich zu fehlerhaftem Verhalten des Programms führt.. Zudem muss zuerst '''OCR1L''' und erst danach '''OCR1H''' ausgelesen werden.

Wenn in das Register geschrieben werden soll, müssen ebenfalls alle Interrupts gesperrt werden. Dann muss zuerst das '''OCR1H'''-Register und erst danach das '''OCR1L'''-Register geschrieben werden, also genau die umgekehrte Reihenfolge wie beim Lesen des Registers.
|-
| '''ICR1H''' '''ICR1L'''
| Timer/Counter '''I'''nput '''C'''apture '''R'''egister Timer/Counter '''1''' 
{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''ICR1''''''H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''ICR1''''''L'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

Das Input Capture Register ist ein 16-Bit Register mit Lesezugriff. Es kann nicht beschrieben werden.

Wenn am Input Capture Pin '''ICP''' die gemäß Einstellungen im '''TCCR1B''' definierte Flanke erkannt wird, so wird der aktuelle Inhalt des Datenregisters '''TCNT1H'''/'''TCNT1L''' sofort in dieses Register kopiert und das Input Capture Flag '''ICF1''' im Timer Interrupt Flag Register '''TIFR''' gesetzt.

Wie bereits oben erwähnt, müssen vor dem Zugriff auf dieses Register alle Interrupts gesperrt werden. Zudem müssen Low- und Highbyte des Registers in der richtigen Reihenfolge bearbeitet werden:

{| border="0"
|-
| Lesen:
| '''ICR1L''' -> '''ICR1H'''
|-
| Schreiben:
| '''ICR1H''' -> '''ICR1L'''
|}
|}

=== Die PWM-Betriebsart ===

Wenn der Timer/Counter 1 in der PWM-Betriebsart betrieben wird, so bilden das Datenregister '''TCNT1H'''/'''TCNT1L''' und das Vergleichsregister '''OCR1H'''/'''OCR1L''' einen 8-, 9- oder 10-Bit, frei laufenden PWM-Modulator, welcher als PWM-Signal am '''OC1'''-Pin ('''PB3''' beim 2313) abgegriffen werden kann. Das Datenregister '''TCNT1H'''/'''TCNT1L''' wird dabei als Auf-/Ab-Zähler betrieben, welcher von 0 an aufwärts zählt bis zur Obergrenze und danach wieder zurück auf 0.
Die Obergrenze ergibt sich daraus, ob 8-, 9- oder 10-Bit PWM verwendet wird, und zwar gemäss folgender Tabelle:

{| border="1"
|-
| align="center" | '''Auflösung'''
| align="center" | '''Obergrenze'''
| '''Frequenz'''
|-
| align="center" | 8
| align="center" | 255
| fTC1 / 510
|-
| align="center" | 9
| align="center" | 511
| fTC1 / 1022
|-
| align="center" | 10
| align="center" | 1023
| fTC1 / 2046
|}

Wenn nun der Zählerwert im Datenregister den in '''OCR1H'''/'''OCR1L''' gespeicherten Wert erreicht, wird der Ausgabepin '''OC1''' gesetzt bzw. gelöscht, je nach Einstellung von '''COM1A1''' und '''COM1A0''' im '''TCCR1A'''-Register.

Ich habe versucht, die entsprechenden Signale in der folgenden Grafik zusammenzufassen

[[Image:PWM Theorie 3.gif]]

[[Image:PWM Theorie 4.gif]]

=== Vergleichswert-Überprüfung ===

Hier wird in ein spezielles Vergleichswertregister ('''OCR1H'''/'''OCR1L''') ein Wert eingeschrieben, welcher ständig mit dem aktuellen Zählerwert verglichen wird.
Erreicht der Zähler den in diesem Register eingetragenen Wert, so kann ein Signal (0 oder 1) am Pin '''OC1''' erzeugt und/oder ein Interrupt ausgelöst werden.

=== Einfangen eines Eingangssignals (Input Capturing) ===

Bei dieser Betriebsart wird an den Input Capturing Pin (ICP) des Controllers eine Signalquelle angeschlossen.
Nun kann je nach Konfiguration entweder ein Signalwechsel von 0 nach 1 (steigende Flanke) oder von 1 nach 0 (fallende Flanke) erkannt werden und der zu diesem Zeitpunkt aktuelle Zählerstand in ein spezielles Register abgelegt werden. Gleichzeitig kann auch ein entsprechender Interrupt ausgelöst werden.
Wenn die Signalquelle ein starkes Rauschen beinhaltet, kann die Rauschunterdrückung eingeschaltet werden. Dann wird beim Erkennen der konfigurierten Flanke über 4 Taktzyklen das Signal überwacht und nur dann, wenn alle 4 Messungen gleich sind, wird die entsprechende Aktion ausgelöst.

== Gemeinsame Register ==

Verschiedene Register beinhalten Zustände und Einstellungen, welche sowohl
für den 8-Bit, als auch für den 16-Bit Timer/Counter in ein und demselben
Register zu finden sind.

{| border="1"
|-
| '''TIMSK'''
| '''T'''imer/Counter '''I'''nterrupt '''M'''a'''sk'''
Register

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''TOIE1'''
| align="center" | '''OCIE1A'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''TICIE'''
| align="center" | '''-'''
| align="center" | '''TOIE0'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''TOIE1''' ('''T'''imer/Counter '''O'''verflow '''I'''nterrupt '''E'''nable Timer/Counter '''1''')
:Wenn dieses Bit gesetzt ist, wird bei einem Überlauf des Datenregisters des Timer/Counter 1 ein Timer Overflow 1 Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''OCIE1A''' ('''O'''utput '''C'''ompare Match '''I'''nterrupt '''E'''nable Timer/Counter '''1''')
:Beim Timer/Counter 1 kann zusätzlich zum Überlauf ein Vergleichswert definiert werden.

:Wenn dieses Bit gesetzt ist, wird beim Erreichen des Vergleichswertes ein Compare Match Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''TICIE''' ('''T'''imer/Counter '''I'''nput '''C'''apture '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein Capture Event Interrupt ausgelöst, wenn ein entsprechendes Signalereignis am Pin PD6(ICP) auftritt. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein, wenn auch ein entsprechender Interrupt ausgelöst werden soll.

'''TOIE0''' ('''T'''imer/Counter '''O'''verflow '''I'''nterrupt '''E'''nable Timer/Counter '''0''')
:Wenn dieses Bit gesetzt ist, wird bei einem Überlauf des Datenregisters des Timer/Counter 0 ein Timer Overflow 0 Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

|-
| '''TIFR'''
| '''T'''imer/Counter '''I'''nterrupt '''F'''lag '''R'''egister

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''TOV1'''
| align="center" | '''OCF1A'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''ICF1'''
| align="center" | '''-'''
| align="center" | '''TOV0'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''TOV1''' ('''T'''imer/Counter '''O'''verflow Flag Timer/Counter '''1''')
:Dieses Bit wird vom Controller gesetzt, wenn beim Timer 1 ein Überlauf des Datenregisters stattfindet.

:In der PWM-Betriebsart wird das Bit gesetzt, wenn die Zählrichtung von auf- zu abwärts und umgekehrt geändert wird (Zählerwert = 0).

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''OCF1A''' ('''O'''utput '''C'''ompare '''F'''lag Timer/Counter '''1''')
:Dieses Bit wird gesetzt, wenn der aktuelle Wert des Datenregisters von Timer/Counter 1 mit demjenigen im Vergleichsregister '''OCR1''' übereinstimmt.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''ICF1''' ('''I'''nput '''C'''apture '''F'''lag Timer/Counter '''1''')
:Dieses Bit wird gesetzt, wenn ein Capture-Ereignis aufgetreten ist, welches anzeigt, dass der Wert des Datenregisters des Timer/Counter 1 in das Input Capture Register ICR1 übertragen wurde.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''TOV0''' ('''T'''imer/Counter '''O'''verflow Flag Timer/Counter '''0''')
:Dieses Bit wird vom Controller gesetzt, wenn beim Timer 0 ein Überlauf des Datenregisters stattfindet.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.
|}

 

= 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 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_mode()'''
:Versetzt den Controller in den mit set_sleep_mode gewählten Schlafmodus.

<pre class="code">
#include <avr/io.h>
#include <avr/sleep.h>
...
set_sleep_mode(SLEEP_MODE_PWR_DOWN);
sleep_mode();

// Code hier wird erst nach Auftreten eines entsprechenden
// "Aufwach-Interrupts" verarbeitet
...
</pre>

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:

<pre class="code">
#include <avr/io.h>
...
// Sleep-Mode "Power-Save" beim ATmega169 "manuell" aktivieren
SMCR = (3<<SM0) | (1<<SE);
asm volatile ("sleep"::);
...
</pre>

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Power Management and Sleep-Modes

= Der Watchdog =

Und hier kommt das ultimative Mittel gegen die Unvollkommenheit von uns
Programmierern, der Watchdog.

So sehr wir uns auch anstrengen, es wird uns kaum je gelingen, das absolut
perfekte und fehlerfreie Programm zu entwickeln.

Der Watchdog kann uns zwar auch nicht zu besseren Programmen verhelfen aber er
kann dafür sorgen, dass unser Programm, wenn es sich wieder mal in's Nirwana
verabschiedet hat, neu gestartet wird, indem ein Reset des Controllers
ausgelöst wird.

Betrachten wir doch einmal folgende Codesequenz:

<pre class="code">
uint8_t x;

x = 10;

while (x >= 0) {
// tu was

x--;
}
</pre>

Wenn wir die Schleife mal genau anschauen sollte uns auffallen, dass dieselbe niemals beendet wird. Warum nicht? Ganz einfach, weil eine als '''''unsigned''''' deklarierte Variable niemals kleiner als Null werden kann (der Compiler sollte jedoch eine ensprechende Warnung ausgeben).
Das Programm würde sich also hier aufhängen und auf ewig in der Schleife drehen.
Und hier genau kommt der Watchdog zum Zug.

== Wie funktioniert nun der Watchdog ==

Der Watchdog enthält einen separaten Timer/Counter, welcher mit einem intern erzeugten Takt von 1 MHz bei 5V Vcc getaktet wird.
Nachdem der Watchdog aktiviert und der gewünschte Vorteiler eingestellt wurde beginnt der Counter von 0 an hochzuzählen.
Wenn nun die je nach Vorteiler eingestellte Anzahl Zyklen erreicht wurde, löst der Watchdog einen Reset aus. Um nun also im Normalbetrieb den Reset zu verhindern müssen wir den Watchdog regelmässig wieder neu starten bzw. Rücksetzen (Watchdog Reset).
Dies sollte innerhalb unserer Hauptschleife passieren.

Um ein unbeabsichtigtes Ausschalten des Watchdogs zu verhindern muss ein spezielles Prozedere verwendet werden, um den WD auszuschalten und zwar müssen zuerst die beiden Bits WDTOE und WDE in einer einzelnen Operation (also nicht mit sbi) auf 1 gesetzt werden.
Dann muss innerhalb der nächsten 4 Taktzyklen das Bit WDE auf 0 gesetzt werden.

Das Watchdog Control Register:

{| border="1"
|-
| '''WDTCR'''
| '''W'''atchog '''T'''imer  '''C'''ontrol '''R'''egister

In diesem Register stellen wir ein, wie wir den Watchdog verwenden möchten.

Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''WDTOE'''
| align="center" | '''WDE'''
| align="center" | '''WDP2'''
| align="center" | '''WDP1'''
| align="center" | '''WDP0'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''WDTOE''' ('''W'''atch'''d'''og '''T'''urn '''O'''ff '''E'''nable)
:Dieses Bit muss gesetzt sein, wenn das Bit '''WDE''' gelöscht wird, andernfalls wird der Watchdog nicht ausgeschaltet.
:Wenn das Bit einmal gesetzt ist wird es von der Hardware nach 4 Taktzyklen automatisch wieder gelöscht.

'''WDE''' ('''W'''atch'''d'''og '''E'''nable)
:Wenn dieses Bit gesetzt wird, so wird der Watchdog aktiviert.
:Das Bit kann nur gelöscht werden, solange das Bit '''WDTOE''' auf 1 steht.

'''WDP2''', '''WDP1''', '''WDP0''' ('''W'''atch'''d'''og Timer '''P'''rescaler Bits)
:Diese 3 Bits bestimmen die Anzahl Oszillatorzyklen für den Watchdog, also, wie lange es dauert, bis ein Reset ausgelöst wird:
<dl><dd>
{| border="1"
|-
| align="center" | WDP2
| align="center" | WDP1
| align="center" | WDP0
| align="center" | Anzahl Zyklen
| align="center" | Typ. Timeoutzeit bei Vcc = 3V
| align="center" | Typ. Timeoutzeit bei Vcc = 5V
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 16K
| align="center" | 47ms
| align="center" | 15ms
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 32K
| align="center" | 94ms
| align="center" | 30ms
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 64K
| align="center" | 0.19s
| align="center" | 60ms
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| align="center" | 128K
| align="center" | 0.38s
| align="center" | 0.12s
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 256K
| align="center" | 0.75s
| align="center" | 0.24s
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| align="center" | 512K
| align="center" | 1.5s
| align="center" | 0.49s
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| align="center" | 1024K
| align="center" | 3s
| align="center" | 0.97s
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| align="center" | 2048K
| align="center" | 6s
| align="center" | 1.9s
|}
</dd></dl>
|}

Um den Watchdog mit dem AVR-GCC Compiler zu verwenden, muss die Headerdatei ''wdt.h'' (''#include <avr/wdt.h>'') in die Quelldatei eingebunden werden.

Danach können die folgenden Funktionen verwendet werden:

* '''wdt_enable(uint8_t timeout)'''
:Aktiviert den Watchdog und stellt den Vorteiler auf den gewünschten Wert ein bzw. der in timeout übergebene Wert wird in das WDTCR-Register eingetragen. Einige Timeout-Werte sind als Konstanten vordefiniert
:Mögliche Timeoutwerte:
<div align="center">
{| border="1"
! Konstante
! Wert
! TimeOut
|-
| WDTO_15MS
| 0
| 15 ms
|-
| WDTO_30MS
| 1
| 30 ms
|-
| WDTO_60MS
| 2
| 60 ms
|-
| WDTO_120MS
| 3
| 120 ms
|-
| WDTO_250MS
| 4
| 250 ms
|-
| WDTO_500MS
| 5
| 500 ms
|-
| WDTO_1S
| 6
| 1 S
|-
| WDTO_2S
| 7
| 2s
|}
</div>
* '''wdt_disable()'''
:Mit dieser Funktion kann der Watchdog ausgeschaltet werden. Dabei wird das notwendige Prozedere, wie oben beschrieben, automatisch ausgeführt.
* '''wdt_reset()'''
:Dies ist wohl die wichtigste der Watchdog-Funktionen. Sie erzeugt einen Watchdog-Reset, welcher periodisch, und zwar vor Ablauf der Timeoutzeit, ausgeführt werden muss, damit der Watchdog nicht den AVR zurücksetzt.

Selbstverständlich kann das '''WDTCR'''-Register auch mit den uns bereits bekannten Funktionen für den Zugriff auf Register programmiert werden.

== Watchdog-Anwendungshinweise ==

Ob nun der Watchdog als Schutzfunktion überhaupt verwendet werden soll, hängt stark von der Anwendung, der genutzten Peripherie und dem Umfang und der Qualitätssicherung des Codes ab. Will man sicher gehen, dass ein Programm sich nicht in einer Endlosschleife verfängt, ist der Wachdog das geeignete Mittel dies zu verhindern. Weiterhin kann bei geschickter Programmierung der Watchdog dazu genutzt werden, bestimmte Stromsparfunktionen zu implementieren. Ausserdem bietet der WD die einzige Möglichkeit einen beabsichtigten System-Reset (ein "richtiger Reset", kein "jmp 0x0000") ohne externe Beschaltung auszulösen, was z.B. bei der Implementierung eines Bootloaders nützlich ist. Bei bestimmten Anwendungen kann die Nutzung des WD als "ultimative Deadlock-Sicherung für nicht bedachte Zustände" natürlich immer als zusätzliche Sicherung dienen.

Es besteht die Möglichkeit herauszufinden, ob ein Reset durch den Watchdog ausgelöst wurde (beim ATmega16 z.B. Bit WDRF in MCUCSR). Diese Information sollte auch genutzt werden, falls ein WD-Reset in der Anwendung nicht planmässig implementiert wurde. Zum Beispiel kann man eine LED an einen freien Pin hängen, die nur bei einem Reset durch den WD aufleuchtet oder aber das "Ereignis WD-Reset" im internen EEPROM des AVR absichern, um die Information später z.B. über UART oder ein Display auszugeben (oder einfach den EEPROM-Inhalt über die ISP/JTAG-Schnittstelle auslesen).

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Watchdog timer handling

= 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.

[[Image:Interrupt Programme.gif]]

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.

[http://www.mikrocontroller.net/forum/read-1-235092.html#new Ausführlicher Thread im Forum]

== Anforderungen an Interrupt-Routinen ==

Um unliebsamen Überraschungen vorzubeugen, sollten einige Grundregeln bei der Implementierung der Interruptroutinen beachtet werden. Interruptroutinen soll 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.

== 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 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.

{| border="1"
|-
| '''GIMSK'''
| '''G'''eneral '''I'''nterrupt '''M'''ask '''R'''egister. 

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''INT1'''
| align="center" | '''INT0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''INT1''' (External '''Int'''errupt 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 '''Int'''errupt 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'''
| '''G'''eneral '''I'''nterrupt '''F'''lag '''R'''egister.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''INTF1'''
| align="center" | '''INTF0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''INTF1''' (External '''Int'''errupt Flag '''1''')
:Dieses Bit wird gesetzt, wenn am '''INT1'''-Pin eine Interrupt-Kondition, entsprechend der Konfiguration, 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 '''Int'''errupt Flag '''0''')
:Dieses Bit wird gesetzt, wenn am '''INT0'''-Pin eine Interrupt-Kondition, entsprechend der Konfiguration, 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''' '''C'''ontrol '''R'''egister.

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

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''SE'''
| align="center" | '''SM'''
| align="center" | '''ISC11'''
| align="center" | '''ISC10'''
| align="center" | '''ISC01'''
| align="center" | '''ISC00'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''SE''' ('''S'''leep '''E'''nable)
: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''' ('''S'''leep '''M'''ode)
:Dieses Bit bestimmt der 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''' ('''I'''nterrupt '''S'''ense '''C'''ontrol '''1''' Bits)
:Diese beiden Bits bestimmen, ob die steigende oder die fallende Flanke für die Interrupterkennung am '''INT1'''-Pin ausgewertet wird.
<dl><dd>
{| border="1"
|-
| align="center" | '''ISC11'''
| align="center" | '''ISC10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Low Level an '''INT1''' erzeugt einen Interrupt.

In der Beschreibung heisst es, der Interrupt wird getriggert, solange der Pin auf 0 bleibt, also eigentlich unbrauchbar.
|-
| align="center" | 0
| align="center" | 1
| Reserviert
|-
| align="center" | 1
| align="center" | 0
| Die fallende Flanke an '''INT1''' erzeugt einen Interrupt.
|-
| align="center" | 1
| align="center" | 1
| Die steigende Flanke an '''INT1''' erzeugt einen Interrupt.
|}
</dd></dl>
'''ISC01''', '''ISC00''' ('''I'''nterrupt '''S'''ense '''C'''ontrol '''0''' Bits)
:Diese beiden Bits bestimmen, ob die steigende oder die fallende Flanke für die Interrupterkennung am '''INT0'''-Pin ausgewertet wird.

<dl><dd>
{| border="1"
|-
| align="center" | '''ISC01'''
| align="center" | '''ISC00'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Low Level an '''INT0''' erzeugt einen Interrupt.

In der Beschreibung heisst es, der Interrupt wird getriggert, solange der Pin auf 0 bleibt, also eigentlich unbrauchbar.
|-
| align="center" | 0
| align="center" | 1
| Reserviert
|-
| align="center" | 1
| align="center" | 0
| Die fallende Flanke an '''INT0''' erzeugt einen Interrupt.
|-
| align="center" | 1
| align="center" | 1
| Die steigende Flanke an '''INT0''' erzeugt einen Interrupt.
|}
</dd></dl>
|}

== 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, rate ich dringend davon ab. 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'').

<pre class="code">
// fuer sei(), cli() und ISR():
#include <avr/interrupt.h>

</pre>

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

<pre class="code">
sei();
</pre>

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

<pre class="code">
cli();
</pre>

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 Interrups aktivieren, was zu unerwünschten Seiteneffekten führen kann. Die aus dem folgenden Beispiel ersichtliche Vorgehensweise ist in solchen Fällen vorzuziehen:

<pre class="code">
#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!
...

}
</pre>



Nachdem nun die Interrupts aktiviert sind, braucht es selbstverständlich noch den auszuführenden Code, der ablaufen soll, wenn ein Interrupt eintrifft. Dazu existiert die Definition (ein Makro) '''ISR'''. SIGNAL sollte nicht mehr genutzt werden, zur Portierung von SIGNAL nach ISR siehe Abschnitt (TODO: verlinken) im Anhang.


=== ISR ===

(''ISR()'' ersetzt bei neueren Versionen der avr-libc ''SIGNAL()''. vgl. Anhang (TODO:link))



<pre class="code">
#include <avr/interrupt.h>
...
ISR(Vectorname) /* vormals: SIGNAL(siglabel) dabei Vectorname != siglabel ! */
{
/* Interrupt Code */
}
</pre>

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.

<pre class="code">
[...]
/* $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)

[...]
</pre>


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

<pre class="code">
#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...
</pre>

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 Interuptroutinen ===

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



<pre class="code">
#include <avr/interrupt.h>
...
void XXX_vect(void) __attribute__((interrupt));
void XXX_vect(void) {
...
}
</pre>

Hierbei steht XXX für den oben beschriebenen Namen des Vektors (also z.B. ''void TIMER0_OVF_vect(void)...''). Der Unterschied im Vergleich zu ISR ist, dass bei hier beim Aufrufen der Funktion das '''Global Enable Interrupt''' Bit automatisch wieder gesetzt und somit weitere Interrupts zugelassen werden. Dies kann zu nicht unerheblichen Problemen von im einfachsten Fall einem Stack overflow bis zu sonstigen unerwarteten Effekten führen und sollte wirklich '''nur dann''' angewendet werden, wenn man sich absolut sicher ist, das Ganze auch im Griff zu haben. 

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.

<pre class="code">
#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 uebrigen
// Programmteile muessen 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" */
}
}
...
}
</pre>

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 ausserhalb der ISR nicht durch einen Interrupt unterbrochen werden. (Allgemeinplatz: AVRs sind 8-bit Controller). Zur Veranschaulichung ein Codefragment:

<pre class="code">
...
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 veraendert.
tmpCnt = gMyCounter16bit;

// besser: Aenderungen "ausserhalb" verhindern -> alle "Teilbytes"
// bleiben konsistent
cli(); // Interupts 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 */
...
}
</pre>

== 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:

<pre class="code">
#include <avr/io.h>

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

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

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

<pre class="code">
...
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)
...
</pre>

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 Unterbrechnungen 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 Unterbrechnungen. 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 ausserhalb dieses Adressbereichs ("Memory-Mapped"-Register) werden auch zur Manipulation einzelner Bits abhängige Anweisungen erzeugt (lds,...,sts).

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Frequently asked Questions/Fragen Nr. 1 und 8 (Stand: avr-libc Vers. 1.0.4)

== 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 ausserdem möglicherweise Probleme durch Interruptroutinen, die zu viel Verarbeitungszeit benötigen.

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

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Interrupts and Signals

= 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 [http://lightner.net/avr/ATtinyAvrGcc.html "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 und ATtiny26 der "tiny-Reihe" gelten die Ausführungen ebenfalls.

== 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.

== 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). 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.

<pre class="code">
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <inttypes.h>

...

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

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

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

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

void foo(void)
{
static /*const*/ uint8_t pgmTestByteLocal PROGMEM = 0x55;
static /*const*/ char pgmTestStringLocal[] PROGMEM = "im Flash";
...
</pre>

=== 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.

<pre class="code">
// 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....
}
</pre>

=== Wort lesen ===

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

<pre class="code">
uint16_t myWord;

myWord = pgm_read_word(&pgmFooWord);
</pre>

Zeiger auf Werte im Flash sind ebenfalls 16 Bits "gross" (Stand avr-gcc 3.4.x). Damit ist der mögliche Speicherbereich für "Flash-Konstanten" auf 64kB begrenzt. 

<pre class="code">
uint8_t *ptrToArray;

ptrToArray = (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 muß 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 = (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)
}
</pre>

=== Floats und Structs lesen ===

Um komplexe Datentypen (structs), nicht-integer Datentypen (floats) aus dem Flash auszulesen, sind Hilfsfunktionen erforderlich. Einige Beispiele:

<pre class="code">
/* Beispiel float aus Flash */

float pgmFloatArray[3] PROGMEM = {1.1, 2.2, 3.3};
...

/* liest float von Flash-Addresse addr und gibt diese als return-value zurueck */
inline float pgm_read_float(const float *addr)
{
union
{
uint16_t i[2]; // 2 16-bit-Worte
float f;
} u;

u.i[0]=pgm_read_word((PGM_P)addr);
u.i[1]=pgm_read_word((PGM_P)addr+2);

return u.f;
}
...

void egal(void)
{
int i;
float f;

for (i=0;i<3;i++) {
f = pgm_read_float(&pgmFloatArray[i]); // entspr. "f = pgmFloatArray[i];"
// mach' was mit f
}
}
</pre>

TODO: Beispiele fuer structs und pointer aus flash auf struct im flash (menues, state-machines etc.)

=== 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.

<pre class="code">
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <string.h>

#define MAXLEN 30

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

...
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 wuerde ausgefuehrt, die ersten 5 Zeichen stimmen ueberein
}
else {
// wuerde bei nicht-Uebereinstimmung ausgefuehrt
}
...
</pre>

Aber Vorsicht: Ersetzt man zum Beispiel
<pre class="code">
const char textImFlashOK[] PROGMEM = "mit[]";
// = Daten im "Flash", textImFlashOK* zeigt auf Flashadresse
</pre>
durch
<pre class="code">
const char* textImFlashProblem PROGMEM = "mit*";
// Konflikt: Daten im BSS (lies: RAM), textImFlashFAIL* zeigt auf Flashadresse
</pre>
dann kann es zu Problemen mit AVR-GCC kommen. Zu erkennen daran, dass der Initialisierungsstring von "textImFlashProblem" zu den Konstanten ans Ende des Programmcodes gelegt wird (BSS), von dem aus er zur Benutzung eigentlich ins RAM kopiert werden sollte (und wird). Da der lesende Code (mittels pgm_read*) trotzdem an einer Stelle vorne im Flash sucht, wird Unsinn gelesen. Dies scheint ein weiters Problem des AVR-GCC (gesehen bei avr-gcc 3.4.1 und 3.4.2) bei der Anpassung an die Harvard-Architektur zu sein (konstanter Pointer auf variable Daten?!). Abhilfe ("Workaround"): Initialisierung bei Zeichenketten mit [] oder gleich im Code PSTR("...") nutzen.

Übergibt man Zeichenketten (genauer: die Adresse des ersten Zeichens), die im Flash abglegt sind an eine Funktion, muss diese entsprechend programmiert sein. Die Funktion selbst hat keine Möglichkeit zu unterscheiden, ob es sich um eine Adresse im Flash oder im RAM 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 (oder _P) versehen sind.

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:

<pre class="code">
// 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 (wieauchimmmer.c)
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <string.h>
#include "lcd.h"

char StringImFlash[] PROGMEM = "Erwin Lindemann"; // im "Flash"

...
lcd_puts_p(StringImFlash);
lcd_puts_P("Dr. Kloebner");
// daraus wird wg. #define lcd_put_P...: lcd_puts_p( PSTR("Dr. Kloebner") );
...
</pre>

=== Flash in der Anwendung schreiben ===

Bei AVRs mit "self-programming"-Option (auch bekannt als Bootloader-Support) können Teile des Flash-Speichers auch vom Anwendungsprogramm selbst beschrieben werden. Dies ist nur möglich, wenn die Schreibfunktionen in einem besonderen Speicherbereich (boot-section) des Programmspeichers/Flash abgelegt sind. Bei wenigen "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.

=== 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 (einen Pointer, z.B. 0x01fe), "weiss" die Funktion nicht, ob die Adresse auf den Flash-Speicher oder den/das RAM zeigt. Allein aus dem Pointer-Wert (der Zahl) kann nicht geschlossen werden, ob ein "einfaches" zeichen_an_uart(s[i]) oder zeichen_an_uart(pgm_read_byte(&s[i]) genutzt werden muss, um das i-te Zeichen auszugeben.

Einige AVR-Compiler "tricksen" etwas, in dem sie für einen Pointer nicht nur die Adresse anlegen, sondern zusätzlich zu jedem Pointer den Ablageort (Flash oder RAM) intern sichern. Bei Aufruf einer Funktion wird dann bei Pointer-Parametern neben der Adresse auch der Speicherbereich, auf den der Pointer zeigt, übergeben. Dies hat jedoch nicht nur Vorteile; Erläuterungen warum dies so ist, führen an dieser Stelle zu weit.

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html 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ässig 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.

Der Compiler schreibt den aus der Variablendeklaration abgeleiteten EEPROM Inhalt in die eine Datei (.eep), die zusätzlich zum Flashen des Programms in den Mikrocontroller geschrieben werden muß. Sonst wird beim Lesen zufälliger Datenmüll zurückgegeben.

Bei der Deklaration einer Variable im EEPROM, ist das Attribut für die Section ".eeprom" zu ergänzen. 

<pre class="code">
#include <avr/io.h>
#include <avr/eeprom.h>
#include <avr/interrupt.h>
#include <inttypes.h> // wird in aktuellen Versionen der avr-lib mit xx.h eingebunden

// EEMEM wird bei aktuellen Versionen der avr-lib in eerpom.h definiert
// hier: definiere falls noch nicht bekannt ("alte" avr-libc)
#ifndef EEMEM
// alle Textstellen EEMEM im Quellcode durch __attribute__ ... ersetzen
#define EEMEM __attribute__ ((section (".eeprom")))
#endif

...

/* Byte */
uint8_t eeFooByte EEMEM = 123;

/* Wort */
uint16_t eeFooWord EEMEM = 12345;

/* float */
float eeFooFloat EEMEM;

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

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

=== Bytes lesen/schreiben ===

Die avr-libc Funktion zum Lesen eines Bytes heisst 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:

<pre class="code">
...
uint8_t myByte;

myByte = eeprom_read_byte(&eeFooByte); // lesen
// myByte hat nun den Wert 123
...
myByte = 99;
eeprom_write_byte(&eeFooByte, myByte); // schreiben
...
myByte = eeprom_read_byte(&eeFooByteArray1[1]);
// myByte hat nun den Wert 3
...
</pre>

=== Wort lesen/schreiben ===

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

<pre class="code">
...
uint16_t myWord;

myWord = eeprom_read_word(&eeFooWord); // lesen
// myWord hat nun den Wert 12345
...
myWord = 2222;
eeprom_write_word(&eeFooWord, myWord); // schreiben
...
</pre>

=== 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 (size_t).

TODO: '''Vorsicht!''' die folgenden Beispiele sind noch nicht geprueft, erstmal nur als Hinweis auf "das Prinzip". Evtl. fehlen "casts" und mglw. noch mehr.

<pre class="code">
...
uint8_t myByteBuffer[3];
uint16_t myWordBuffer[4];

/* Datenblock aus EEPROM LESEN */

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

/* dito etwas anschaulicher aber "unnuetze Tipparbeit": */
eeprom_read_block(&myByteBuffer[0],&eeFooByteArray[0],3);

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

/* und nun mit "16bit" */
eeprom_read_block(myWordBuffer,eeFooWordArray1,sizeof(myWordBuffer));

/* Datenlock in EEPROM SCHREIBEN */
eeprom_write_block(myByteBuffer,eeFooByteArray1,sizeof(myByteBuffer));
eeprom_write_block(myWordBuffer,eeFooWordArray1,sizeof(myWordBuffer));
...
</pre>

"Nicht-Integer"-Datentypen wie z.B. Fliesskommazahlen lassen sich recht praktisch über eine ''union'' in "Byte-Arrays" konvertieren und wieder "zurückwandeln". Dies erweist sich hier (aber nicht nur hier) als nützlich.

<pre class="code">
...
float myFloat = 12.34;

union {
float r;
uint8_t i[sizeof(float)];
} u;

u.r = myFloat;

/* float in EEPROM */
eeprom_write_block(&(u.i),&eeFooFloat,sizeof(float));

/* float aus EEPROM */
eeprom_read_block(&(u.i),&eeFooFloat,sizeof(float));
/* u.r wieder 12.34 */
...
</pre>

Auch zusammengesetzte Typen lassen sich mit den Block-Routinen verarbeiten.

<pre class="code">
...
typedef struct {
uint8_t label[8];
uint8_t rom_code[8];
} tMyStruct;

#define MAXSENSORS 3
tMyStruct eeMyStruct[MAXSENSORS] EEMEM;

...

void egal(void)
{
tMyStruct work;

strcpy(work.label,"Flur");
GetRomCode(work.rom_code); // Dummy zur Veranschaulichung - setzt rom-code

/* Sichern von "work" im EEPROM */
eeprom_write_block(&work,&eeMyStruct[0],sizeof(tMyStruct)); // f. Index 0
strcpy(work.label,"Bad");
GetRomCode(work.rom_code);
eeprom_write_block(&work,&eeMyStruct[1],sizeof(tMyStruct)); // f. Index 1
...
/* Lesen der Daten EEPROM Index 0 in "work" */
eeprom_read_block(&work,&eeMyStruct[0],sizeof(tMyStruct));
// work.label hat nun den Inhalt "Flur"
...
}
...
</pre>

=== EEPROM-Speicherabbild in .eep-Datei ===

Eine besondere Funktion des avr-gcc ist, dass mit entsprechenden Optionen im Makefile aus den Initialisierungswerten der Variablen im Quellcode eine Datei erzeugt werden kann, die man auf den Controller programmieren kann (.eep-Datei). Damit können sehr elegant Standardwerte für den EEPROM-Inhalt im Quellcode definiert werden. Die Vorgehensweise wird aus dem WinAVR-Beispielmakefile ersichtlich. Siehe dazu die Erläuterungen im Abschnitt Exkurs: Makefiles.

=== Bekannte Probleme bei den EEPROM-Funktionen ===

Vorsicht: Bei alten Versionen der avr-libc wurden nicht alle AVR Controller untersü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: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/EEPROM handling

= Die Nutzung von printf =

Um komfortabel Ausgaben auf ein Display oder die serielle Schnittstelle zu tätigen, bietet sich printf/sprintf an.
<pre class="code">
...
#include <stdio.h>
#include <stdint.h>

uint16_t counter;
uint8_t s[20];
...
sprintf( s, "Zählerstand: %d", counter);
LCDSoftText( s, x, y);
...
</pre>

Die Funktion LCDSoftText muss natürlich dafür sorgen, dass die Zeichenkette auf das Display kommt.

Eine weitere elegante Möglichkeit, bietet sich darin, die Ausgabe stdout auf eigene Funktionen umzubiegen:
<pre class="code">
#include <stdio.h>
static int uart_putchar(char c, FILE *stream);
static FILE mystdout = FDEV_SETUP_STREAM(uart_putchar, NULL,
_FDEV_SETUP_WRITE);
static int
uart_putchar(char c, FILE *stream)
{
if (c == ?\n?)
uart_putchar(?\r?);
loop_until_bit_is_set(UCSRA, UDRE);
UDR = c;
return 0;
}

int
main(void)
{
init_uart();
stdout = &mystdout;
printf("Hello, world!\n");
return 0;
}
</pre>
(Quelle: avr-libc-user-manual-1.4.3.pdf, S.74)

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

Der Nachteil aller printf-Varianten: sie sind recht speicherintensiv.

= Assembler und Inline-Assembler =

Gelegentlich erweist es sich als nützlich, C und Assembler-Code in einer Anwendung zu nutzen. Typischerweise wird das Hauptprogramm in C verfasst und wenige, extrem zeitkritische oder hardwarenahe Operationen in Assembler.

Die "gnu-Toolchain" bietet dazu zwei Möglichkeiten:

; Inline-Assembler : Die Assembleranweisungen werden direkt in den C-Code integriert. Eine Quellcode-Datei enthält somit C- und Assembleranweisungen

; Assembler-Dateien : Der Assembler-Codecode befindet sich in eigenen Quellcodedateien. Diese werden vom gnu-Assembler (avr-as) zu Object-Dateien assembliert ("compiliert") und mit den aus dem C-Code erstellten Object-Dateien zusammengebunden (gelinkt).

== Inline-Assembler ==

Inline-Assembler bietet sich an, wenn nur wenig Assembleranweisungen benötigt werden. Typische Anwendung sind kurze Codesequenzen für zeitkritische Operationen in Interrupt-Routinen oder sehr präzise Warteschleifen (z.B. 1-Wire). Inline-Assembler wird mit '''asm volatile''' eingeleitet, die Assembler-Anweisungen werden in einer Zeichenkette zusammengefasst, die als "Parameter" übergeben wird. Durch Doppelpunkte getrennt werden die Ein- und Ausgaben sowie die "Clobber-Liste" angegeben.

Ein einfaches Beispiel für Inline-Assembler ist das Einfügen einer NOP-Anweisung (NOP steht für No Operation). Dieser Assembler-Befehl benötigt genau einen Taktzyklus, ansonsten "tut sich nichts". Sinnvolle Anwendungen für NOP sind genaue Delay(=Warte)-Funktionen.

<pre class="code">
...
/* Verzoegern der weiteren Programmausfuehrung um
genau 3 Taktzyklen */
asm volatile ("nop");
asm volatile ("nop");
asm volatile ("nop");
...
</pre>

Weiterhin kann mit einem NOP verhindert werden, dass leere Schleifen, die als Warteschleifen gedacht sind, wegoptimiert werden. Der Compiler erkennt ansonsten die vermeindlich nutzlose Schleife und erzeugt dafür keinen Code im ausführbaren Programm.

<pre class="code">
...
uint16_t i;

/* leere Schleife - wird bei eingeschalteter Compiler-Optimierung wegoptimiert */
for (i=0;i<1000;i++);

...

/* Schleife erzwingen (keine Optimierung): "NOP-Methode" */
for (i=0;i<1000;i++) asm volatile("NOP");

...

/* alternative Methode (keine Optimierung): */
volatile uint16_t j;
for (j=0;j<1000;j++);
</pre>

Ein weiterer nützlicher "Assembler-Einzeiler" ist der Aufruf von sleep (''asm volatile ("sleep");''), da hierzu keine eigene Funktion in der avr-libc existiert.

Als Beispiel für mehrzeiligen Inline-Assembler eine präzise Delay-Funktion. Die Funktion erhält ein 16-bit Wort als Parameter, prüft den Parameter auf 0 und beendet die Funktion in diesem Fall oder durchläuft die folgende Schleife sooft wie im Wert des Parameters angegeben. Inline-Assembler hat hier den Vorteil, dass die Laufzeit unabhängig von der Optimierungsstufe (Parameter -O, vgl. makefile) und der Compiler-Version ist.

<pre class="code">
static inline void delayloop16 (uint16_t count)
{
asm volatile ("cp %A0, __zero_reg__ \n\t"
"cpc %B0, __zero_reg__ \n\t"
"breq 2f \n\t"
"1: \n\t"
"sbiw %0,1 \n\t"
"brne 1b \n\t"
"2: "
: "=w" (count)
: "0" (count)
);
}
</pre>

* Jede Anweisung wird mit '''\n\t''' abgeschlossen. Der Zeilenumbruch teilt dem Assembler mit, daß ein neuer Befehl beginnt.
* Als Sprung-Marken (Labels) werden Ziffern verwendet. Diese speziellen Labels sind mehrfach im Code verwendbar. Gesprungen wird jeweils zurück (b) oder vorwärts (f) zum nächsten ausffindbaren Label.

Das Resultat zeigt ein Blick in die Assembler-Datei, die der Compiler mit der option <tt>-save-temps</tt> nicht löscht:
<pre class="code">
cp r24, __zero_reg__ ; count
cpc r25, __zero_reg__ ; count
breq 2f
1:
sbiw r24,1 ; count
brne 1b
2:
</pre>

Detaillierte Ausführungen zum Thema Inline-Assembler finden sich in der Dokumentation der avr-libc im Abschnitt [http://www.nongnu.org/avr-libc/user-manual/inline_asm.html Related Pages/Inline Asm].

Siehe auch:
*[http://www.atmel.com/dyn/resources/prod_documents/doc0856.pdf AVR Assembler-Anweisungsliste]
*[http://www.roboternetz.de/wissen/index.php/Inline-Assembler_in_avr-gcc Deutsche Einführung in Inline-Assembler]

== Assembler-Dateien ==

Assembler-Dateien erhalten die Endung .S (''grosses'' S) und werden im makefile nach WinAVR/mfile-Vorlage hinter ''ASRC='' durch Leerzeichen getrennt aufgelistet.

Im Beispiel eine Funktion ''superFunc'' die alle Pins des Ports D auf "Ausgang" schaltet, eine Funktion ''ultraFunc'', die die Ausgänge entsprechend des übergebenen Parameters schaltet, eine Funktion ''gigaFunc'', die den Status von Port A zurückgibt und eine Funktion ''addFunc'', die zwei Bytes zu einem 16-bit-Wort addiert. Die Zuweisungen im C-Code (PORTx = ) verhindern, dass der Compiler die Aufrufe wegoptimiert und dienen nur zur Veranschaulichung der Parameterübergaben.

Zuerst der Assembler-Code. Der Dateiname sei useful.S:

<pre class="code">
#include "avr/io.h"

// Arbeitsregister (ohne "r")
workreg = 16
workreg2 = 17

// Konstante:
ALLOUT = 0xff

// ** Setze alle Pins von PortD auf Ausgang **
// keine Parameter, keine Rueckgabe
.global superFunc
.func superFunc
superFunc:
push workreg
ldi workreg, ALLOUT
out _SFR_IO_ADDR(DDRD), workreg // beachte: _SFR_IO_ADDR()
pop workreg
ret
.endfunc

// ** Setze PORTD auf uebergebenen Wert **
// Parameter in r24 (LSB immer bei "graden" Nummern)
.global ultraFunc
.func ultraFunc
ultraFunc:
out _SFR_IO_ADDR(PORTD), 24
ret
.endfunc

// ** Zustand von PINA zurueckgeben **
// Rueckgabewerte in r24:r25 (LSB:MSB), hier nur LSB genutzt
.global gigaFunc
.func gigaFunc
gigaFunc:
in 24, _SFR_IO_ADDR(PINA)
ret
.endfunc

// ** Zwei Bytes addieren und 16-bit-Wort zurueckgeben **
// Parameter in r24 (Summand1) und r22 (Summand2) -
// Parameter sind Word-"aligned" d.h. LSB immer auf "graden"
// Registernummern. Bei 8-Bit und 16-Bit Paramtern somit
// beginnend bei r24 dann r22 dann r20 etc.
// Rueckgabewert in r24:r25
.global addFunc
.func addFunc
addFunc:
push workreg
push workreg2
clr workreg2
mov workreg, 22
add workreg, 24
adc workreg2, 1 // r1 - assumed to be always zero ...
movw r24, workreg
pop workreg2
pop workreg
ret
.endfunc

// oh je - sorry - Mein AVR-Assembler ist eingerostet, hoffe das stimmt so...

.end

</pre>

Im Makefile ist der Name der Assembler-Quellcodedatei einzutragen:

<pre class="code">
ASRC = useful.S
</pre>

Der Aufruf erfolgt dann im C-Code so:

<pre class="code">
extern void superFunc(void);
extern void ultraFunc(uint8_t setVal);
extern uint8_t gigaFunc(void);
extern uint16_t addFunc(uint8_t w1, uint8_t w2);

int main(void)
{
[...]
superFunc();

ultraFunc(0x55);

PORTD = gigaFunc();

PORTA = (addFunc(0xF0, 0x11) & 0xff);
PORTB = (addFunc(0xF0, 0x11) >> 8);
[...]
}
</pre>

Das Ergebnis wird wieder in der lss-Datei ersichtlich:

<pre class="code">
[...]
superFunc();
148: 0e 94 f6 00 call 0x1ec

ultraFunc(0x55);
14c: 85 e5 ldi r24, 0x55 ; 85
14e: 0e 94 fb 00 call 0x1f6

PORTD = gigaFunc();
152: 0e 94 fd 00 call 0x1fa
156: 82 bb out 0x12, r24 ; 18

PORTA = (addFunc(0xF0, 0x11) & 0xff);
158: 61 e1 ldi r22, 0x11 ; 17
15a: 80 ef ldi r24, 0xF0 ; 240
15c: 0e 94 ff 00 call 0x1fe
160: 8b bb out 0x1b, r24 ; 27
PORTB = (addFunc(0xF0, 0x11) >> 8);
162: 61 e1 ldi r22, 0x11 ; 17
164: 80 ef ldi r24, 0xF0 ; 240
166: 0e 94 fc 00 call 0x1f8
16a: 89 2f mov r24, r25
16c: 99 27 eor r25, r25
16e: 88 bb out 0x18, r24 ; 24

[...]
000001ec <superFunc>:
// setze alle Pins von PortD auf Ausgang
.global superFunc
.func superFunc
superFunc:
push workreg
1ec: 0f 93 push r16
ldi workreg, ALLOUT
1ee: 0f ef ldi r16, 0xFF ; 255
out _SFR_IO_ADDR(DDRD), workreg
1f0: 01 bb out 0x11, r16 ; 17
pop workreg
1f2: 0f 91 pop r16
ret
1f4: 08 95 ret

000001f6 <ultraFunc>:
.endfunc

// setze PORTD auf uebergebenen Wert
.global ultraFunc
.func ultraFunc
ultraFunc:
out _SFR_IO_ADDR(PORTD), 24
1f6: 82 bb out 0x12, r24 ; 18
ret
1f8: 08 95 ret

000001fa <gigaFunc>:
.endfunc

// Zustand von PINA zurueckgeben
.global gigaFunc
.func gigaFunc
gigaFunc:
in 24, _SFR_IO_ADDR(PINA)
1fa: 89 b3 in r24, 0x19 ; 25
ret
1fc: 08 95 ret

000001fe <addFunc>:
.endfunc

// zwei Bytes addieren und 16-bit-Wort zurueckgeben
.global addFunc
.func addFunc
addFunc:
push workreg
1fe: 0f 93 push r16
push workreg2
200: 1f 93 push r17
clr workreg2
202: 11 27 eor r17, r17
mov workreg, 22
204: 06 2f mov r16, r22
add workreg, 24
206: 08 0f add r16, r24
adc workreg2, 1 // r1 - assumed to be always zero ...
208: 11 1d adc r17, r1
movw r24, workreg
20a: c8 01 movw r24, r16
pop workreg2
20c: 1f 91 pop r17
pop workreg
20e: 0f 91 pop r16
ret
210: 08 95 ret

[...]
</pre>

Die Zuweisung von Registern zu Parameternummer und die Register für die Rückgabewerte sind in den "Register Usage Guidelines" der avr-libc-Dokumentation erläutert.

Siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/assembler.html avr-libc-Dokumentation: Related Pages/avr-libc and assembler programs]
* [http://www.nongnu.org/avr-libc/user-manual/FAQ.html#faq_reg_usage avr-libc-Dokumentation: Related Pages/FAQ/"What registers are used by the C compiler?"]

== Globale Variablen für Datenaustausch ==

Oftmals kommt man um globale Variablen nicht herum, z.B. um den Datenaustausch zwischen Hauptprogramm und Interrupt-Routinen zu realisieren.
Hierzu muß man im Assembler wissen, wo genau die Variable vom C-Compiler abgespeichert wird.

Hierzu muß die Variable, hier "zaehler" genannt, zuerst im C-Code als Global definiert werden, z.B. so:

<pre class = "code">

#include <avr/io.h>

volatile uint8_t zaehler;

int16_t main (void)
{
// irgendein Code, in dem zaehler benutzt werden kann

}
</pre>

Im foldenden Assembler-Beispiel wird der Externe Interrupt0 verwendet, um den Zähler hochzuzählen. Es fehlen die Initialisierungen des Interrupts und die Interrupt-Freigabe, so richtig sinnvoll ist der Code auch nicht, aber er zeigt (hoffentlich) wie es geht.
Im Umgang mit Interrupt-Vektoren gilt beim GCC-Assembler das Gleiche, wie bei C: Man muß die exakte Schreibweise beachten, ansonsten wird nicht der Interrupt-Vektor angelegt, sondern eine neue Funktion - und man wundert sich, daß nichts funktionert (vgl. das AVR-GCC Handbuch).

<pre class = "code">

#include "avr/io.h"

temp = 16

.extern zaehler

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

push temp // wichtig: Benutzte Register und das
in temp,_SFR_IO_ADDR(SREG) // Status-Register (SREG) sichern !
push temp

lds temp,zaehler // Wert aus dem Speicher lesen
inc temp // bearbeiten
sts zaehler,temp // und wieder zurückschreiben

pop temp // die benutzten Register wiederherstellen
out _SFR_IO_ADDR(SREG),temp
pop temp
reti

.end

</pre>

=== Globale Variablen im Assemblerfile anlegen ===

Alternativ können Variablen aber auch im Assemblerfile angelegt werden. Dadurch kann auf eine .c-Datei verzichtet werden. Für das obige Beispiel könnte der Quelltext dann die Dateien zaehl_asm.S und zaehl_asm.h abgelegt werden, so dass nur noch zaehl_asm.S mit kompiliert werden müsste.

Anstatt im Assemblerfile über das Schlüsselwort ''.extern '' auf eine vorhandene Variable zu verweisen, wird dazu mit dem Schlüsselwort ''.comm'' die benötigte Anzahl von Bytes für eine Variable reserviert.

'''zaehl_asm.S'''
<pre class = "code">

#include "avr/io.h"

temp = 16

// 1 Byte im RAM für den Zähler reservieren
.comm zaehler, 1

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

...

</pre>

In der Headerdatei wird dann auf die Variable nur noch verwiesen (Schlüsselwort ''extern''):

'''zaehl_asm.h'''
<pre class = "code">
#ifndef ZAEHL_ASM_H
#define ZAEHL_ASM_H

extern volatile uint8_t zaehler;

#endif
</pre>

Im Gegensatz zu globalen Variablen in C werden so angelegte Variablen nicht automatisch mit dem Wert 0 initialisiert.

=== Variablen größer als 1 Byte ===

Variablen, die größer als ein Byte sind, können in Assembler auf ähnliche Art angesprochen werden. Hierzu müssen nur genug Bytes angefordert werden, um die Variable aufzunehmen. Soll z.B. für den Zähler eine Variable vom Typ ''unsigned long'', also ''uint32_t'' verwendet werden, so müssen 4 Bytes reserviert werden:

<pre class = "code">
...
// 4 Byte im RAM für den Zähler reservieren
.comm zaehler, 4
...
</pre>

Die dazugehörige Deklaration im Headerfile wäre dann:
<pre class = "code">
...
extern volatile uint32_t zaehler;
...
</pre>

Bei Variablen, die größer als ein Byte sind, werden die Werte beginnend mit dem niederwertigsten Byte im RAM abgelegt. Das folgende Codeschnippsel zeigt, wie unter Assembler auf die einzelnen Bytes zugegriffen werden kann. Dazu wird im Interrupt nun ein 32-Bit Zähler erhöht:
<pre class = "code">
#include "avr/io.h"

temp = 16

// 4 Byte im RAM für den Zähler reservieren
.comm zaehler, 4

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

push temp // wichtig: Benutzte Register und das
in temp,_SFR_IO_ADDR(SREG) // Status-Register (SREG) sichern !
push temp

// 32-Bit-Zähler incrementieren
lds temp, (zaehler + 0) // 0. Byte (niederwertigstes Byte)
inc temp
sts (zaehler + 0), temp
brne RAUS

lds temp, (zaehler + 1) // 1. Byte
inc temp
sts (zaehler + 1), temp
brne RAUS

lds temp, (zaehler + 2) // 2. Byte
inc temp
sts (zaehler + 2), temp
brne RAUS

lds temp, (zaehler + 3) // 3. Byte (höchstwertigstes Byte)
inc temp
sts (zaehler + 3), temp
brne RAUS

RAUS:
pop temp // die benutzten Register wiederherstellen
out _SFR_IO_ADDR(SREG),temp
pop temp
reti

.end

</pre>

'''TODO:''' 16-Bit / 32-Bit Variablen, Zugriff auf Arrays (Strings)

= Anhang =

== Besonderheiten bei der Anpassung bestehenden Quellcodes ==

Einige Funktionen, die in frühren Versionen der avr-libc vorhanden waren, werden inzwischen als veraltet angesehen. Sie sind nicht mehr vorhanden oder als ''deprecated'' (abgelehnt) ausgewiesen. Es empfiehlt sich, vorhandenen Code zu portieren und die alten Funktionen nicht mehr zu nutzen, auch wenn diese noch zur Verfügung stehen.

=== Veraltete Funktionen zur Deklaration von Interrupt-Routinen ===

Die Funktionen (eigentlich Makros) ''SIGNAL'' und ''INTERRUPT'' zur Deklaration von Interruptroutinen sollten nicht mehr genutzt werden.

In aktuellen Versionen der avr-libc (z.B. avr-libc 1.4.3 aus WinAVR 20060125) werden Interruptroutinen, die '''nicht''' durch andere Interrupts '''unterbrechbar''' sind, mit ISR deklariert (siehe Abschnitt im Hauptteil). Auch die Benennung wurden vereinheitlicht und an die üblichen Bezeichnungen in den AVR Datenblättern angepasst. In der Dokumentation der avr-libc sind alte und neue Bezeichnungen in der Tabelle gegenübergestellt. Die erforderlichen Schritte zur Portierung:

* #include von avr/signal.h entfernen
* SIGNAL duch ISR ersetzen
* Name des Interrupt-Vektors anpassen (SIG_* durch entsprechendes *_vect)

Ein Beispiel für die Anpassung zuerst ein "alter" Code:

<pre class="code">
#include <avr/interrupt.h>
#include <avr/signal.h>

...

/* Timer2 Output Compare bei einem ATmega8 */
SIGNAL(SIG_OUTPUT_COMPARE2)
{
...
}
</pre>

Im Datenblatt wird der Vektor mit TIMER2 COMP bezeichnet. Die Bezeichnung in der avr-libc entspricht dem Namen im Datenblatt, Leerzeichen werden durch Unterstriche (_) ersetzt und ein _vect angehängt.

Der neue Code sieht dann so aus:

<pre class="code">
#include <avr/interrupt.h>
/* signal.h entfällt */

ISR(TIMER2_COMP_vect)
{
...
}
</pre>

Bei Unklarheiten bezüglich der neuen Vektorlabels hilft (noch) ein Blick in die Headerdatei des entspechenden Controllers. Für das vorherige Beispiel also der Blick in die Datei iom8.h für den ATmega8, dort findet man die veraltete Bezeichnung unterhalb der aktuellen.

<pre class="code">
...
/* Timer/Counter2 Compare Match */
#define TIMER2_COMP_vect _VECTOR(3)
#define SIG_OUTPUT_COMPARE2 _VECTOR(3)
...
</pre>

Konnte in alten Versionen signal.h ohne interrupt.h eingebunden werden, erhält man bei Verwendung der avr-libc Version 1.4.3 (WinAVR 2/2005) beim Compilieren eine Fehlermeldung, da mit signal.h nicht die erforderlichen Definitionen eingebunden werden. Der Lösungsvorschlag in signal.h auch interrupt.h einzubinden, wurde von den avr-libc-Enwicklern akzeptiert und das Problem ist im Quellcode (CVS) bereits behoben. Es is aber noch keine avr-libc-"Release" bzw. noch kein WinAVR mit dieser avr-libc-Korrektur verfuegbar (Stand 5.2.2006). Will oder kann man den Quellcode nicht aktualisieren, gibt es folgende Alternativen:
* in Quellcodedateien, in denen nur avr/signal.h eingebunden wird, interrupt.h einbinden (''#include <avr/interrupt.h>''). signal.h weiterhin einbinden, falls Kompatibiltät mit alten Versionen gewünscht ist.
* in der Datei signal.h (bein WinAVR in c:/WinAVR/avr/include/avr/signal.h) ein (''#include <avr/interrupt.h>'') ergänzen

Für '''unterbrechbare''' Interruptroutinen, die mittels ''INTERRUPT'' deklariert sind, gibt es keinen direkten Ersatz in Form eines Makros. Die Routinen sind lt. Dokumentation der avr-libc in folgender Form zu Deklarieren unterbrechbarer Interrupt-Handler:

<pre class="code">
void XXX_vect(void) __attribute__((interrupt));
void XXX_vect(void) {
...
}
</pre>

Beispiel:

<pre class="code">
#include <avr/interrupt.h>

// alt:
INTERRUPT(SIG_OVERFLOW0)
{
...
}

// neu:
void TIMER0_OVF_vect(void) __attribute__((interrupt));
void TIMER0_OVF_vect(void)
{
...
}
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von ''INTERRUPT'' die Header-Datei ''compat/deprecated.h'' einzubinden. Man sollte bei dieser Gelegenheit jedoch nochmals überprüfen, ob die Funktionalität von ''INTERRUPT'' tatsächlich gewollt ist. In vielen Fällen wurde ''INTTERRUPT'' dort genutzt, wo eigentlich ''SIGNAL'' (nunmehr ''ISR'') hätte genutzt werden sollen.

=== Veraltete Funktionen zum Portzugriff ===

''inp'' und ''outp'' zum Einlesen bzw. Schreiben von Registern sind nicht mehr erforderlich, der Compiler unterstützt dies ohne diesen Umweg.

<pre class="code">
unsigned char i, j;

// alt:
i = inp(PINA);
j = 0xff;
outp(PORTB, j);

// neu (nicht mehr wirklich neu...):
i = PINA
j = 0xff;
PORTB = j;
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von inp und outp die Header-Datei '''compat/deprecated.h''' einzubinden.

=== Veraltete Funktionen zum Zugriff auf Bits in Registern ===

''cbi'' und ''sbi'' zum Löschen und Setzen von Bits sind nicht mehr erforderlich, der Compiler unterstützt dies ohne diesen Umweg. Die Bezeichnung ist ohnehin irreführend da die Funktionen nur für Register mit Adressen im unteren Speicherbereich tatsächlich in die Assembleranweisungen cbi und sbi übersetzt werden.

<pre class="code">
// alt:
sbi(PORTB, PB2);
cbi(PORTC, PC1);

// neu (auch nicht mehr wirklich neu...):
PORTB |= (1<<PB2);
PORTC &= ~(1<<PC1);
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von sbi und cbi die Header-Datei '''compat/deprecated.h''' einzubinden. Wer unbedingt will, kann sich natürlich eigene Makros mit aussagekräftigeren Namen definieren. Zum Beispiel:

<pre class="code">
#define SET_BIT(PORT, BITNUM) ((PORT) |= (1<<(BITNUM)))
#define CLEAR_BIT(PORT, BITNUM) ((PORT) &= ~(1<<(BITNUM)))
#define TOOGLE_BIT(PORT, BITNUM) ((PORT) ^= (1<<(BITNUM)))
</pre>

== Externe Referenzspannung des internen Analog-Digital-Wandlers ==

Die minimale (externe) Referenzspannung des ADC darf nicht beliebig niedrig sein, vlg. dazu das (aktuellste) Datenblatt des verwendeten Controllers. z.B. beim ATMEGA8 darf sie lt. 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.)

= TODO =
* fuse-bits im make file
* Assembler-Dateien/Datenaustausch auf neue Vectornamen anpassen SIG_->_vect
* stdio.h, malloc() ???
* Code-Optimierungen ("tricks")
* "naked"-Functionen ??
* IO-Register als Parameter/"Variablen" (volatile uint8_t *mybusport; mybusport=&PORTB; void sendbus(uint8_t *parm)...)
* JTAG?
* SPI ?
* I²C Bus
* LC-Display ansteuern
* Software USB
* Bootloader

AVR-GCC-Tutorial

2006-05-30T09:38:53Z

129.247.247.238: /* Schreiben eines I/O-Registers */

[[Category:AVR]]

= Vorwort =

Dieses Tutorial soll den Einstieg in die Programmierung von Atmel [[AVR]]-Mikrocontroller in der Programmiersprache [[C]] mit dem freien ("kostenlosen") C-Compiler avr-gcc erleichtern.

Die ursprüngliche Version stammt von Christian Schifferle, viele neue Abschnitte und aktuelle Anpassungen von Martin Thomas. Viele der im Original-Dokument verwendeten Funktionen sind in aktuellen Versionen des [[AVR-GCC|avr-gcc]] C-Compilers und der Laufzeitbibliothek avr-libc nicht mehr enthalten oder sollen nicht mehr genutzt werden. Dieses Tutorial wurde an die neuen Funktionen/Methoden angepasst.

Die Erläuterungen und Beispiele beziehen sich auf die Versionen 3.4.5 des avr-gcc-Compiler und 1.4.3 der avr-libc, so wie sie in WinAVR 20060125 enthalten sind. Die Unterschiede zu älternen Versionen werden im Haupttext und Anhang zwar erläutert, Anfängern sei jedoch empfohlen, die aktuellen Versionen zu nutzen.

In diesem Text wird häufig auf die Standardbibliothek für den avr-gcc-Compiler, die avr-libc, verwiesen. Die online-Version der '''avr-libc Dokumentation''' findet sich [http://www.nongnu.org/avr-libc/user-manual/index.html hier]. Bei [[WinAVR]] gehört die Dokumentation zum Lieferumfang und wird mitinstalliert.

Eine Version als PDF zum Ausdrucken ist hier erhältlich (nicht immer auf aktuellem Stand): http://www.siwawi.arubi.uni-kl.de/avr_projects/AVR-GCC-Tutorial_-_www_mikrocontroller_net.pdf

= 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:

* Testboard 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 Testplattform sind auch das [[STK500]] und der [[AVR Butterfly]] von Atmel.[[http://www.mikrocontroller.net/articles/AVR#Starterkits |mehr..]
* 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]].
* Programmiersoftware und -[[AVR In System Programmer |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 Abschnitt [[AVR-GCC-Tutorial#Exkurs: makefiles|Exkurs: makefiles]]).

= Was tun, wenn's nicht "klappt"? =

* Herausfinden, ob es tatsächlich ein avr(-gcc) spezifisches Problem ist oder die 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.
*[[AVR Checkliste]]
* Die [http://www.nongnu.org/avr-libc/user-manual/index.html 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 [http://www.mikrocontroller.net www.mikrocontroller.net] nach vergleichbaren Problemen absuchen.
* Das avr-gcc-Forum bei [http://www.avrfreaks.net avrfreaks] nach vergleichbaren Problemen absuchen.
* Das [http://lists.gnu.org/archive/html/avr-gcc-list/ Archiv der avr-gcc Mailing-Liste] nach vergleichbaren Problemen absuchen.
* Nach Beispielcode suchen. Vor allem in der Academy von [http://www.avrfreaks.net AVRFREAKS] (anmelden).
* Google oder alltheweb befragen schadet nie.
* Bei Problemen mit der Ansteuerung interner AVR-Funktionen mit C-Code: das Datenblatt des Controllers lesen (ganz und am Besten zweimal)
* 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, genaue Fehlermeldungen bzw. Beschreibung des Fehlverhaltens. Bei Ansteuerung externer Geräte die Beschaltung beschreiben oder skizzieren (z.B. mit [http://www.tech-chat.de/ Andys ASCII Circuit]). Siehe dazu auch: [http://www.lugbz.org/documents/smart-questions_de.html "Wie man Fragen stellt"].

= Erzeugen von Maschinencode =

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

* Die Verwendung einer Integrierten Enwicklungsumgebung (IDE), bei der alle Einstellungen z.B. in Dialogboxen durchgeführt werden können. Unter Anderen kann AVRStudio ab Version 4.12 (kostenlos bei atmel.com) zusammen mit WinAVR als intergrierte Entwicklungsumgebung für den Compiler avr-gcc genutzt werden (dazu muessen AVRStudio und WinAVR auf dem Rechner installiert sein). Weitere IDEs fuer den avr-gcc (ohne Anspruch auf Vollständigkeit): AtmanAvr C (relativ günstig), KamAVR (kostenlos) VMLab (ab Version 3.12 ebenfalls kostenlos).

* Die Nutzung des Programms make mit passenden Makefiles.

Integrierte Enwicklungsumgebungen 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 Nutzung des avr-gcc Compilers mit IDEs sei hier auf deren Dokumentation verwiesen.

Im folgenden Abschnitt wird die Generierung von Maschinencode ("hex-Datei") für einen AVR aus C-Quellcode ("c-Dateien") anhand der universellen und plattformunabhänigen Vorgehensweise mittels make und 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 Projectverzeichnisses). Beim Wechsel vom makefile-Ansatz nach WinAVR-Vorlage zu AVRStudio ist darauf zu achten, dass AVRStudio (Stand: AVRStudio Version 4.12SP1) bei einem neuen Projekt die Optimierungsoption (vgl. nächster Abschnitt, typisch: -Os) nicht einstellt und die mathematische Bibliothek der avr-libc (libm.a, Linker-Option -lm) nicht einbindet. 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.

= Exkurs: Makefiles =

Wenn man bisher gewohnt ist, mit integrierten Entwicklungsumgebung à la Visual-C Programme zu erstellen, wirkt das makefile-Konzept auf den ersten Blick etwas kryptisch. Nach kurzer Einarbeitung ist diese Vorgehensweise jedoch sehr praktisch. Diese Dateien (üblicher Name: 'Makefile' ohne Dateiendung) dienen der Ablaufsteuerung des Programms make, das auf allen Unix/Linux-Systemen installiert sein sollte, und in einer Fassung fuer MS-Windows auch in [[WinAVR]] (Unterverzeichnis utils/bin) enthalten ist.

Im Unterverzeichnis ''sample'' einer WinAVR-Installation findet man eine sehr brauchbare Vorlage, die sich einfach an das eigene Projekt anpassen lässt ([[Media:Makefile|lokale Kopie Stand Sept. 2004]]). Wahlweise kann man auch [http://www.sax.de/~joerg/mfile/ mfile] von Jörg Wunsch nutzen. mfile erzeugt ein makefile nach Einstellungen in einer grafischen Nutzeroberfläche, wird bei WinAVR mitinstalliert, ist aber als TCL/TK-Programm auf nahezu allen Plattformen lauffähig.

''Die folgenden Ausführungen beziehen sich auf das WinAVR Beispiel-Makefile.''

Ist im Makefile alles richtig eingestellt genügt es, sich drei Parameter zu merken, die über die shell bzw. die Windows-Kommandozeile (cmd.exe/command.com) als Parameter an "make" übergeben werden. Das Programm make sucht sich "automatisch" das Makefile im aktuellen Arbeitsverzeichnis und führt die darin definierten Operationen für den entsprechenden Aufrufparameter durch.

{| border=1
| ''make all''
| Erstellt aus den im Makefile angegebenen Quellcodes eine ''hex''-Datei (und ggf. auch ''eep''-Datei).
|-
| ''make program''
| Überträgt die hex-Datei (und wahlweise auch die eep-Datei für den EEPROM) zum AVR.
|-
| ''make clean''
| löscht alle temporären Dateien, also auch die hex-Datei
|}

Diese Aufrufe können in die allermeisten Editoren in "Tool-Menüs" eingebunden werden. Dies erspart den Kontakt mit der Kommandozeile. (Bei WinAVR sind die Aufrufe bereits im Tools-Menü des mitgelieferten Editors Programmers-Notepad eingefügt.)

Üblicherweise sind folgende Daten im Makefile anzupassen:
* Controllertyp
* Quellcode-Dateien (c-Dateien)
* Typ und Anschluss des Programmiergeräts

seltener sind folgende Einstellungen durchzuführen:
* Grad der Optimierung
* Methode zur Erzeugung der Debug-Symbole (Debug-Format)
* Assembler-Quellcode-Dateien (S-Dateien)

Die in den folgenden Unterabschnitten gezeigten Makefile-Ausschnitte sind für ein Programm, das auf einem ATmega8 ausgeführt werden soll. Der Quellcode besteht aus den c-Dateien superprog.c (darin main()), uart.c, lcd.c und 1wire.c. Im Quellcodeverzeichnis befinden sich diese Dateien: superprog.c, uart.h, uart.c, lcd.h, lcd.c, 1wire.h, 1wire.c und das makefile (die angepasste Kopie des WinAVR-Beispiels).

Der Controller wird mittels [[AVRDUDE]] über ein [[STK200]]-Programmierdongle an der Schnittstelle lpt1 (bzw. /dev/lp0) programmiert. Im Quellcode sind auch Daten für die ''section .eeprom'' definiert (siehe Abschnitt [[AVR-GCC-Tutorial#EEPROM|Speicherzugriffe]]), diese sollen beim Programmieren gleich mit ins EEPROM geschrieben werden.

== Controllertyp setzen ==

Dazu wird die "make-Variable" MCU entsprechend dem Namen des verwendeten Controllers gesetzt. Ein Liste der von avr-gcc und der avr-libc untersützten Typen findet sich in der [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc].

<pre class="code">
# Kommentare in Makefiles beginnen mit einem Doppelkreuz
...

# ATmega8 at work
MCU = atmega8
# oder MCU = atmega16
# oder MCU = at90s8535
# oder ...
...
</pre>

== Quellcode-Dateien einstellen ==

Den Namen der Quellcodedatei welche die Funktion main enthält, wird hinter TARGET eingetragen. Dies jedoch ohne die Endung ''.c''.

<pre class="code">
...
TARGET = superprog
...
</pre>

Besteht das Projekt wie im Beispiel aus mehr als einer Quellcodedatei, sind die weiteren c-Dateien (nicht die Header-Dateien, vgl. [[Include-Files (C)]]) durch Leerzeichen getrennt bei SRC einzutragen. Die bei TARGET definierte Datei ist schon in der SRC-Liste enthalten. Diesen Eintrag nicht löschen!

<pre class="code">
...
SRC = $(TARGET).c uart.c lcd.c 1wire.c
...
</pre>

Alternativ kann man die Liste der Quellcodedateien auch mit dem Operator += erweitern.

<pre class="code">
SRC = $(TARGET).c uart.c 1wire.c
# lcd-Code fuer Controller xyz123 (auskommentiert)
# SRC += lcd_xyz.c
# lcd-Code fuer "Standard-Controller" (genutzt)
SRC += lcd.c
</pre>

== Programmiergerät einstellen ==

Die Vorlagen sind auf die Programmiersoftware [[AVRDUDE]] angepasst, jedoch lässt sich auch andere Programmiersoftware einbinden, sofern diese über Kommandozeile gesteuert werden kann (z.B. stk500.exe, uisp, sp12).

<pre class="code">
...
# Einstellung fuer STK500 an com1 (auskommentiert)
# AVRDUDE_PROGRAMMER = stk500
# com1 = serial port. Use lpt1 to connect to parallel port.
# AVRDUDE_PORT = com1 # programmer connected to serial device

# Einstellung fuer STK200-Dongle an lpt1
AVRDUDE_PROGRAMMER = stk200
AVRDUDE_PORT = lpt1
...
</pre>

Sollen Flash(=.hex) und EEPROM(=.eep) zusammen auf den Controller programmiert werden, ist das Kommentarzeichen vor AVRDUDE_WRITE_EEPROM zu löschen.

<pre class="code">
...
# auskommentiert: EERPOM-Inhalt wird nicht mitgeschrieben
#AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep

# nicht auskommentiert: EERPOM-Inhalt wird mitgeschrieben
AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep
...
</pre>

todo: fuse-bits

== Anwendung ==

Die Eingabe von ''make all'' im Arbeitsverzeichnis mit dem Makefile und den Quellcodedateien erzeugt (unter anderem) die Dateien superprog.hex und superprog.eep. Abhängigkeiten zwischen den einzelnen c-Dateien werden dabei automatisch berücksichtigt. Die ''superprog.hex'' und ''superprog.eep'' werden mit ''make program'' zum Controller übertragen. Mit ''make clean'' werden alle temporären Dateien gelöscht (="aufgeräumt").

== Sonstige Einstellungen ==

=== Optimierungsgrad ===

Der gcc-Compiler kennt verschiedene Stufen der Optimierung. Nur zu Testzwecken sollte die Optimierung ganz deaktiviert werden (''OPT = 0''). Die weiteren möglichen Optionen weisen den Compiler an, möglichst kompakten oder möglichst schnellen Code zu erzeugen. In den weitaus meisten Fällen ist ''OPT = s'' die optimale (sic) Einstellung, damit wird kompakter und oft auch der "schnellste" Maschinencode erzeugt.

=== Debug-Format ===

Unterstützt werden die Formate stabs und dwarf-2. Das Format wird hinter ''DEBUG ='' eingestellt. Siehe dazu Abschnitt ''Eingabedateien zur Simulation''.

=== Assembler-Dateien ===

Die im Projekt genutzten Assembler-Dateien werden hinter ASRC durch Leerzeichen getrennt aufgelistet. Assembler-Dateien haben immer die Endung .S (großes S). Ist zum Beispiel der Assembler-Quellcode eines Software-UARTs in einer Datei softuart.S enthalten lautet die Zeile: ''ASRC = softuart.S''

=== Taktfrequenz ===

Neuere Versionen der WinAVR/Mfile Vorlage für Makefiles beinhalten die Definition einer Variablen F_CPU (WinAVR 2/2005). Darin wird die Taktfrequenz des Controllers in Hertz eingetragen. Die Definition steht dann im gesamten Projekt ebenfalls unter der Bezeichnung F_CPU zur Verfügung (z.B. um daraus UART-, SPI- oder ADC-Frequenzeinstellungen abzuleiten).

Die Angabe hat rein "informativen" Charakter, die tatsächliche Taktrate wird über den externen Takt (z.B. Quarz) bzw. die Einstellung des internen R/C-Oszillators bestimmt. Die Nutzung von F_CPU macht also nur Sinn, wenn die Angabe mit dem tatsächlichen Takt übereinstimmt.

Innerhalb der avr-libc ab Version 1.2 (in WinAVR ab 2/2005 enthalten) wird die Definition der Taktfrequenz (F_CPU) zur Berechnung der Wartefunktionen in avr/delay.h genutzt. Diese funktionieren nur dann korrekt, wenn F_CPU mit der tatsächlichen Taktfrequenz übereinstimmt.
F_CPU muss dazu jedoch nicht unbedingt im makefile definiert werden. Es reicht aus, wird aber bei mehrfacher Anwendung unübersichtlich, vor ''#include <avr/delay.h>'' ein ''#define F_CPU [hier Takt in Hz]UL'' einzufügen.
Vgl. dazu den [http://www.nongnu.org/avr-libc/user-manual/group__avr__delay.html entsprechenden Abschnitt der Dokumentation].

== Eingabedateien zur Simulation in AVR-Studio ==

Mit älteren AVR-Studio-Versionen kann man nur auf Grundlage sogenannter ''coff''-Dateien simulieren. Neuere Versionen von AVR-Studio (ab 4.10.356) unterstützen zudem das modernere aber noch experimentelle dwarf-2-Format, das ab WinAVR 20040722 (avr-gcc 3.4.1/Binutils inkl. Atmel add-ons) "direkt" vom Compiler erzeugt wird.

; Vorgehensweise bei extcoff:
* im Makefile bei DEBUG: <pre class="code">DEBUG=stabs</pre>
* ''make extcoff'' (evtl. vorher ''make clean'')
* die erzeugte ''cof''-Datei (im Beispiel oben ''superprog.cof'') in AVR-Studio laden
* AVR-Simulator und zu simulierenden Controller wählen, "Finish"
* weiteres siehe AVR-Studio Online-Hilfe

; Vorgehensweise bei dwarf-2:
* im Makefile bei DEBUG: <pre class="code">DEBUG=dwarf-2</pre>
* ''make all'' (evtl. vorher ''make clean'')
* die erzeugte ''elf''-Datei (im Beispiel oben ''superprog.elf'') in AVR-Studio laden
* AVR-Simulator und zu simulierenden Controller wählen, "Finish"
* weiteres siehe AVR-Studio Online-Hilfe

Beim Simulieren scheinen oft "Variablen zu fehlen". Ursache dafür ist, dass der Compiler die "Variablen" direkt Registern zuweist. Dies kann vermieden werden, indem die Optimierung abgeschaltet wird (im makefile). Man simuliert dann jedoch ein vom optimierten Code stark abweichendes Programm. Das Abschalten der Optimierung wird nicht empfohlen.

Statt des Software-Simulators kann das AVR-Studio auch genutzt werden, um mit dem ATMEL JTAGICE, ein Nachbau davon (BootICE, Evertool o.ä.) oder dem ATMEL JTAGICE MKII "im System" zu debuggen. Dazu sind keine speziellen Einstellungen im makefile erforderlich. Debugging bzw. "In-System-Emulation" mit dem JTAGICE und JTAGICE MKII sind in der AVR-Studio Online-Hilfe beschrieben.

= 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.

== Selbstdefinierte (nicht-standardisierte) ganzzahlige Datentypen ==

Bei den im Folgenden genannten Typdefinitionen ist zu beachten, dass die Bezeichnungen für "Worte" teilweise je nach Prozessorplattform unterschiedlich verwendet werden. Die angegebenen Definitionen beziehen sich auf die im Zusammenhang mit AVR/8-bit-Controllern üblichen "Bit-Breiten" (In Erläuterungen zum ARM7TDMI z.B. werden oft 32-bit Integer mit "Wort" ohne weitere Ergänzung bezeichnet). Es empfiehlt sich daher, die im nachfolgenden Abschnitt beschriebenen ''standardisierten ganzzahligen Datentypen'' zu nutzen und damit "Missverständnissen" vorzubeugen, die z.B. bei der Portierung von C-Code zwischen verschiedenen Plattformen auftreten können.

<pre class="code">
typedef unsigned char BYTE; // besser: uint8_t aus <inttypes.h>
typedef unsigned short WORD; // besser: uint16_t aus <inttypes.h>
typedef unsigned long DWORD; // besser: uint32_t aus <inttypes.h>
typedef unsigned long long QWORD; // besser: uint64_t aus <inttypes.h>
</pre>

; BYTE : Der Datentyp BYTE definiert eine Variable mit 8 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 255.

; WORD : Der Datentyp WORD definiert eine Variable mit 16 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 65535.

; DWORD : Der Datentyp DWORD (gesprochen: Double-Word) definiert eine Variable mit 32 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 4294967295.

; QWORD : Der Datentyp QWORD (gesprochen: Quad-Word) definiert eine Variable mit 64 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 18446744073709551615.

== Standardisierte Integer(Ganzzahl)-Typen ==

Standardisierte Datentypen werden in der Header-Datei inttypes.h definiert. In neueren Version der avr-libc (ab V1.2.0) heisst die Datei entsprechend aktuellem Standard stdint.h. inttypes.h existiert aus Kompatibiltätsgründen weiterhin und enthält ein ''#include <stdint.h>''.
Zur Nutzung der standardisierten Typen bindet man die "Definitionsdatei" wie folgt ein:

<pre class="code">
#include <inttypes.h>

// oder - ab avr-libc Version 1.2.0 möglich und empfohlen:
#include <stdint.h>
</pre>

Einige der dort definierten Typen (avr-libc Version 1.0.4):

<pre class="code">
typedef signed char int8_t;
typedef unsigned char uint8_t;

typedef short int16_t;
typedef unsigned short uint16_t;

typedef long int32_t;
typedef unsigned long uint32_t;

typedef long long int64_t;
typedef unsigned long long uint64_t;
</pre>

Ein Vierfach-Wort (64Bit) entspricht beim AVR ''uint64_t'', ein Doppel-Wort (32bit) entspricht ''uint32_t'', ein Wort (16bit) entspricht ''uint16_t'' und ein Byte (8bit) entspricht ''uint8_t''.
Die Typen ohne vorangestelltes ''u'' können auch vorzeichenbehaftete Zahlen speichern. ''int8_t'' geht also von -128 bis 127, ''uint8_t'' dagegen geht von 0 bis 255.

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/(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 Bit breit ist.

Hier bietet uns die Programmiersprache C ein mächtiges Werkzeug an, mit dessen
Hilfe wir 8 Bits in eine einzelne Bytevariable zusammen fassen 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:

<pre class="code">
struct {
unsigned char bStatus_1:1; // 1 Bit für bStatus_1
unsigned char bStatus_2:1; // 1 Bit für bStatus_2
unsigned char bNochNBit:1; // Und hier noch mal ein Bit
unsigned char b2Bits:2; // Dieses Feld ist 2 Bits breit
// All das hat in einer einzigen Byte-Variable Platz.
// die 3 verbleibenden Bits bleiben ungenutzt
} x;
</pre>

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

<pre class="code">
x.bStatus_1 = 1;
x.bStatus_2 = 0;
x.b2Bits = 3;
</pre>

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 geraten,
ein "ganzes" Byte (uint8_t) zu nutzen auch wenn nur ein Bitwert gespeichert
werden soll.

Wenn man nur eine paar wenige Variablen vom Typ bool verwenden möchte, kann man
auch die Headerdatei <stdbool.h> einbinden und sich dann wie gewohnt einen Booltyp anlegen.
Bei vielen Variablen vom Typ Bool und knappem Speicher ist die Verwendung von Bitfeldern zu empfehlen (? Wie wird der stdbool intern abgewickelt ?)

= 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:

[[Image:Sequentielle Programme.gif]]

== 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.

[[Image:Interrupt Programme.gif]]

= Allgemeiner 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.

Einige Register haben spezielle Funktionen, andere wiederum können für allgemeine Zwecke (Speichern von Datenwerten) verwendet werden.

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. Wenn im Makefile der MCU-Typ definiert ist, wird vom System automatisch die zum Typen passende Definitionsdatei genutzt, sobald man im Code die allgemeine "io.h" Header-Datei einbindet.

<pre class="code">
#include <avr/io.h>
</pre>

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

== I/O-Register ==

Die I/O-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 mal
die 8-Bit Register.

=== Lesen eines I/O-Registers ===

Zum Lesen kann man auf I/O-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üzen den Zugriff nun direkt und inp() ist nicht mehr erforderlich.

Beispiel:

<pre class="code">
#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;
...
}
</pre>

==== Lesen eines Bits ====

Die AVR-Bibliothek (avr-libc) stellt auch Funktionen zur Abfrage eines einzelnen Bits eines Registers zur Verfügung:

;bit_is_set (<Register>,<Bitnummer>) : Die Funktion ''bit_is_set'' prüft, ob ein Bit gesetzt ist. Wenn das Bit gesetzt ist, wird ein Wert ungleich 0 zurückgegeben. Genau genommen ist es die Wertigkeit des abgefragten Bits, also 1 für Bit0, 2 für Bit1, 4 für Bit2 etc.

;bit_is_clear (<Register>,<Bitnummer>) : Die Funktion ''bit_is_clear'' prüft, ob ein Bit gelöscht ist. Wenn das Bit gelöscht ist, also auf 0 ist, wird ein Wert ungleich 0 zurückgegeben.

Die Funktionen bit_is_clear bzw. bit_is_set sind ''nicht erforderlich'', man kann auch "einfache" C-Syntax verwenden, die universell verwendbar ist. ''bit_is_set'' entspricht dabei z.B. (Registername & (1 << Bitnummer)). Das Ergebnis ist <>0 ("wahr") wenn das Bit gesetzt und 0 ("falsch") wenn es nicht gesetzt ist. Die Negierung des Ausdrucks, also '''!'''((Registername & (1 << Bitnummer)), entspricht ''bit_is_clear'' und gibt einen Wert <>0 ("wahr") zurück, falls das Bit nicht gesetzt ist,

* siehe auch [[Bitmanipulation]]

=== Schreiben eines I/O-Registers ===

Zum Schreiben kann man I/O-Register einfach wie eine Variable setzen. 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 und outp() ist nicht mehr erforderlich.

Beispiel:

<pre class="code">
#include <avr/io.h>

...

int main(void)
{
/* Setzt das Richtungsregister des Ports A auf 0xff
(alle Pins als Ausgang): */
DDRA = 0xff;

/* Setzt PortA auf 0x03, Bit 0 und 1 "high", restliche "low": */
PORTA = 0x03;
...
}
</pre>

==== Schreiben von Bits ====

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

mit dem Ausdruck:
<pre class="code">
x |= (1 << Bitnummer); // wird ein Bit in x gesetzt
x &= ~(1 << Bitnummer); // wird ein Bit in x geloescht
</pre>

Das niederwertigste Bit (für 1) eines Bytes hat die Bitnummer 0, das "höchstwertige" (für 128) die Nummer 7.

Beispiel:
<pre class="code">
#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 */
</pre>

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

Beispiel:
<pre class="code">
#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 */
</pre>

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]]
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Special Function Registers

=== Warten auf einen bestimmten Zustand ===

Es gibt in der Bibliothek sogar Funktionen, die warten, bis ein bestimmter Zustand auf einem Bit erreicht ist. Es ist allerdings normalerweise eine eher unschöne Programmiertechnik, da in diesen Funktionen "blockierend gewartet" wird. D.h., der Programmablauf bleibt 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.

<pre class="code">
#include <avr/io.h>
...

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

#define WARTEPIN PINA
#define WARTEBIT 2

// 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)) ) ;
...
</pre>

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. Das niederwertigste Bit hat die Bitnummer 0.

<pre class="code">
#include <avr/io.h>
...

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

// 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) ) ;
...
</pre>

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

siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Special Function Registers
* [[Bitmanipulation]]

= Zugriff auf Ports =

Alle Ports der AVR-Controller werden über Register gesteuert. Dazu sind
jedem Port 3 Register zugeordnet:

{| border="1"
|-
| '''DDRx'''
| Datenrichtungsregister für Port'''x'''.
'''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 Port'''x'''.

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 Port'''x'''.
Dieses Register wird verwendet, um die Ausgänge eines Ports anzusteuern. Bei Pins, die mittels DDRx auf Eingang geschaltet wurden, koenen ueber PORTx
die internen Pull-Up Widerstände aktiviert oder deaktiviert werden (1 = aktiv).
|}



== 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.

Wollen wir also beispielsweise Pin 0 bis 4 von Port B als Ausgänge
definieren so schreiben wir folgende Zeile:

<pre class="code">
#include <avr/io.h>

...

// Setzen der Bits 0,1,2,3 und 4
// Binär 00011111 = Hexadezimal 1F

DDRB = 0x1F; /* direkte Zuweisung - unuebersichtlich */

/* mehr Tipparbeit aber uebersichtlicher: */
DDRB = (1 << DDB0) | (1 << DDB1) | (1 << DDB2) | (1 << DDB3) | (1 << DDB4);
...
</pre>

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

=== Ganze Ports ===

Um einen ganzen Port als Ausgang zu definieren, kann der folgende Befehl
verwendet werden:
<pre class="code">
DDRB = 0xff;
</pre>

Im Beispiel wird der Port B als Ganzes als Ausgang geschaltet. Dazu muss die Header-Datei avr/io.h eingebunden sein (darin wird u.a. DDRB definiert).

== 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: (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):

<pre class="code">
...
/* 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
</pre>

== 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
<pre class="code">
#inlude <avr/io.h>
...
PORTB=0x04; /* besser PORTB=(1<<PB2) */
</pre>
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:

<pre class="code">
#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" */
</pre>

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

<pre class="code">
#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" */
</pre>

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 in aktuellen Versionen der avr-libc nicht mehr enthalten und auch nicht mehr erforderlich.

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 Angangswert "high" initialisiert werden, zuerst die Bits im PORTx-Register setzen und anschliessend die Datenrichtung auf Ausgang stellen. Daraus ergibt sich die Abfolge Eingang -> setze PORTx: interner Pull-Up aktiv -> setze DDRx: Ausgang "high". Bei der Reihenfolge erst DDRx and PORTx, kann es zu einem kurzen "low-Puls" kommen, der auch exterene 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") 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.

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'''. Die Abfrage der Pinzustände über PORTx statt PINx ist ein häufiger Fehler beim AVR-"Erstkontakt". (Ansonsten liest man nicht den Zustand der Eingänge, sondern den Status der internen Pull-Up-Widerstände.)

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

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
...
uint8_t bPortD;
...
bPortD = PIND;
...
</pre>

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

<pre class="code">
#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 */
}
...
</pre>

=== Tasten und Schalter ===

Der Anschluss mechanischer Kontakte an den Mikrocontroller gestaltet sich ebenfalls ganz einfach, wobei wir zwei unterschiedliche Methoden unterscheiden müssen (''Active Low'' und ''Active High''):

{| border="1"
|-
| '''Active Low'''
| '''Active High'''
|-
| [[Image:Active Low.gif]]
| [[Image:Active High.gif]]
|-
| 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.

Der Widerstandswert des Pull-Up Widerstands ist an sich nicht kritisch. Es muss jedoch beachtet werden, dass über den Widerstand ein Strom in den Eingang fliesst, also sollte er nicht zu klein gewählt werden um den Controller nicht zu zerstören. Wird er allerdings zu hoch gewählt ist die Wirkung eventuell nicht gegeben. Als üblicher Wert haben sich 10 Kiloohm eingebürgert.

Die AVRs haben sogar an den meisten Pins softwaremässig zuschaltbare interne Pull-Up Widerstände, welche wir natürlich auch verwenden können.

| 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.
|}

==== Pull-Up Widerstände aktivieren ====

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.

<pre class="code">
#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<<DDC7); /* Pin PC7 als Eingang */
PORTC |= (1<<PC7); /* internen Pull-Up an PC7 aktivieren */
</pre>

==== (Tasten-)Entprellung ====

Nun haben alle mechanischen Kontakte, sei es von Schaltern, Tastern oder auch von Relais, die unangenehme Eigenschaft zu prellen. Dies bedeutet, dass beim Schliessen des Kontaktes derselbe nicht direkt Kontakt herstellt, sondern mehrfach ein- und ausschaltet bis zum endgültigen Herstellen des Kontaktes.

Soll nun mit einem schnellen Mikrocontroller gezählt werden, wie oft ein solcher Kontakt geschaltet wird, dann haben wir ein Problem, weil das Prellen als mehrfache Impulse gezählt wird. Diesem Phänomen muss beim Schreiben des Programms unbedingt Rechnung getragen werden.

<pre class="code">
#include <avr/io.h>
#include <inttypes.h>
#ifndef F_CPU
#define F_CPU 3686400UL /* Quarz mit 3.6864 Mhz */
#endif
#include <avr/delay.h> /* definiert _delay_ms() ab avr-libc Version 1.2.0 */

/* Einfache Funktion zum Entprellen eines Tasters */
inline uint8_t debounce(volatile uint8_t *port, uint8_t pin)
{
if ( ! (*port & (1 << pin)) )
{
/* Pin wurde auf Masse gezogen, 100ms warten */
_delay_ms(100);
if ( ! (*port & (1 << pin)) )
{
/* Anwender Zeit zum Loslassen des Tasters geben */
_delay_ms(100);
return 1;
}
}
return 0;
}

int main(void)
{
DDRB &= ~( 1 << PB0 ); /* PIN PB0 auf Eingang (Taster) */
PORTB |= ( 1 << PB0 ); /* Pullup-Widerstand aktivieren */
...
if (debounce(&PINB, PB0)) /* Falls Taster an PIN PB0 gedrueckt.. */
PORTD = PIND ^ ( 1 << PD7 ); /* ..LED an Port PD7 an-
bzw. ausschalten */
...
}
</pre>

Bei diesem Beispiel ist zu beachten, dass der AVR im Falle eines Tastendrucks 200ms wartet, also brach liegt. Zeitkritische Anwendungen sollten ein anderes Verfahren wählen.

Zum Thema Entprellen siehe auch:
* Artikel [[Entprellung]]

== Analog ==

Die Verarbeitung von analogen Eingangswerten und die Ausgabe von Analogwerten wird in Kapitel [[AVR-GCC-Tutorial#Analoge_Ein-_und_Ausgabe|Analoge Ein- und Ausgabe]] behandelt.

== 16-Bit Portregister (ADC, ICR1, OCR1, TCNT1, UBRR) ==

Einige der Portregister in den AVR-Controllern sind 16 Bit breit. Im Datenblatt sind diese Register üblicherweise mit dem Suffix "L" (LSB) und "H" (MSB) versehen. Die avr-libc definiert zusätzlich die meisten dieser Variablen die Bezeichnung ohne "L" oder "H". Auf diese kann direkt zugewiesen bzw. zugegriffen werden. Die Konvertierung von 16-bit Wort nach 2*8-bit Byte erfolgt intern.

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
...
uint16_t foo;

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

Falls benötigt, kann eine 16-Bit Variable auch recht einfach manuell in ihre zwei 8-Bit Bestandteile zerlegt werden. Folgendes Beispiel demonstriert dies anhand des pseudo- 16-Bit Registers UBRR.

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
#ifndef F_CPU
#define F_CPU 3686400
#endif
#define UART_BAUD_RATE 9600

typedef union {
uint16_t i16;
struct {
uint8_t i8l;
uint8_t i8h;
};
} convert16to8;

...
convert16to8 baud;
baud.i16 = F_CPU / (UART_BAUD_RATE * 16L) -1;
UBRRH = baud.i8h;
UBRRL = baud.i8l;
...

/*alternativ:*/
#include <inttypes.h>

uint16_t wFoo16;
uint8_t bFooLow, bFooHigh;

...

wFoo16 = 0xAA55; /* zu "zerlegende" 16Bit-Integer */
bFooHigh = (uint8_t)(wFoo16 >> 8); /* MS-Byte */
bFooLow = (uint8_t)(wFoo16); /* LS-Byte */
...
</pre>

Bei einigen AVR-Typen (z.B. ATmega8) teilen sich UBRRH und UCSRC die gleiche Memory-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''.

Bei einigen 16-bit Registern (insbesondere die der 16-bit Timer) erfolgen Schreibzugriffe über das sogenannte ''temporary Register''. Die Reihenfolge der Zugriffe bestimmt, wann der Wert tatsächlich ins Register geschrieben wird. Typisch wird erst das High-Byte beschrieben (xxxH) und intern im temporary Register zwischengespeichert. Nachdem das Low-Byte (xxxL) geschrieben wurde, setzt der Controller mit diesem und dem im temporary Register zwischengespeicherten Wert für das High-Byte das 16-bit Register. Dabei ist zu beachten, dass intern nur ein temporary Register verfügbar ist, welches in Interruptroutinen mglw. mit einem anderen Wert überschrieben wird, wenn dort ebenfalls 16-bit Register beschrieben werden. avr-gcc/avr-libc berücksichtigen die korrekte Reihenfolge automatisch, wenn die Register mit ihrem "16-bit Label" (ohne H bzw. L) angesprochen werden, dabei ist der Schutz des temporary Registers vor Überschreiben durch Interruptroutinen dennoch zu beachten (im Zweifel beim Schreibzugriff die Interrupts kurzzeitig global deaktivieren).

Im Umgang mit 16-Bit Registern siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Related Pages/Frequently Asked Questions/Nr. 8
* Datenblatt Abschnitt ''Accessing 16-bit Registers''

= Der UART =

== Allgemeines zum UART ==

Über den [[UART]] kann ein AVR leicht mit einer [[RS232]]-Schnittstelle eines PC oder sonstiger Geräte mit "serieller Schnittstelle" verbunden werden.

Mögliche Anwendungen des UART:

* Debug-Schnittstelle: z.B. zur Anzeige von Zwischenergebnissen ("printf-debugging" - hier besser "UART-debugging") auf einem PC. Auf dem Rechner reicht dazu eine Terminal-Software (MS-Windows: Hyperterm oder besser Bray-Terminal, [http://www.mikrocontroller.net/forum/read-8-155472.html#new HTerm]; Unix/Linux z.B. minicom). Ein direkter Anschluss ist aufgrund unterschiedlicher Pegel nicht möglich, jedoch sind entsprechende Schnittstellen-ICs wie z.B. ein MAX232 günstig und leicht zu integrieren. Rechner ohne serielle Schnittstelle können über fertige USB-seriell-Adapter angeschlossen werden.
* "Mensch-Maschine Schnittstelle": z.B. Konfiguration und Statusabfrage über eine "Kommandozeile" oder Menüs
* Übertragen von gespeicherten Werten: z.B. bei einem Datenlogger
* Anschluss von Geräten mit serieller Schnittstelle (z.B. (Funk-)Modems, Mobiltelefone, Drucker, Sensoren, "intelligente" LC-Displays, GPS-Empfänger).
* "Feldbusse" auf RS485/RS422-Basis mittels entsprechenden Bustreiberbausteinen (z.B. MAX485)
* DMX, Midi etc.
* LIN-Bus ('''L'''ocal '''I'''nterconnect '''N'''etwork): Preiswerte Sensoren/Aktoren in der Automobiltechnik und darüber hinaus

Einige AVR-Controller haben ein bis zwei vollduplexfähigen UART ('''U'''niversal '''A'''synchronous '''R'''eceiver and '''T'''ransmitter) schon eingebaut ("Hardware-UART").
Übrigens: Vollduplex heisst nichts anderes, als dass der Baustein gleichzeitig senden und empfangen kann.

Neuere AVRs (ATmega, ATtiny) verfügen über einen oder zwei U'''S'''ART(s), dieser unterschiedet sich vom UART hauptsächlich durch interne FIFO-Puffer für Ein- und Ausgabe und erweiterte Konfigurationsmöglichkeiten. Die Puffergröße ist allerdings nur 1 Byte.

Der UART wird über vier separate Register angesprochen. USARTs der ATMEGAs verfügen über mehrere zusätzliche Konfigurationsregsiter. Das Datenblatt gibt darüber Auskunft. Die Folgende Tabelle gibt nur die Register für die (veralteten) UARTs wieder.

{| border="1"
|-
| '''UCR   '''
| '''U'''ART '''C'''ontrol '''R'''egister. 
In diesem Register stellen wir ein, wie wir den UART verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''RXCIE'''
| align="center" | '''TXCIE'''
| align="center" | '''UDRIE'''
| align="center" | '''RXEN'''
| align="center" | '''TXEN'''
| align="center" | '''CHR9'''
| align="center" | '''RXB8'''
| align="center" | '''TXB8'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
|}

'''RXCIE''' ('''RX''' '''C'''omplete '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART RX Complete Interrupt ausgelöst, wenn ein Zeichen vom UART empfangen wurde. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''TXCIE''' ('''TX''' '''C'''omplete '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART TX Complete Interrupt ausgelöst, wenn ein Zeichen vom UART gesendet wurde. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''UDRIE''' ('''U'''ART '''D'''ata '''R'''egister '''E'''mpty '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART Datenregister Leer Interrupt ausgelöst, wenn der UART wieder bereit ist um ein neues zu sendendes Zeichen zu übernehmen. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''RXEN''' ('''R'''eceiver '''E'''nable)
:Nur wenn dieses Bit gesetzt ist, arbeitet der Empfänger des UART überhaupt. Wenn das Bit nicht gesetzt ist, kann der entsprechende Pin des AVR als normaler I/O-Pin verwendet werden.

'''TXEN''' ('''T'''ransmitter '''E'''nable)
:Nur wenn dieses Bit gesetzt ist, arbeitet der Sender des UART überhaupt. Wenn das Bit nicht gesetzt ist, kann der entsprechende Pin des AVR als normaler I/O-Pin verwendet werden.

'''CHR9''' (9 Bit Characters)
:Wenn dieses Bit gesetzt ist, können 9 Bit lange Zeichen übertragen und empfangen werden. Das 9. Bit kann bei Bedarf als zusätzliches Stopbit oder als Paritätsbit verwendet werden. Man spricht dann von einem 11-Bit Zeichenrahmen:
:1 Startbit + 8 Datenbits + 1 Stopbit + 1 Paritätsbit = 11 Bits

'''RXB8''' (Receive Data Bit 8)
:Wenn das vorher erwähnte CHR9-Bit gesetzt ist, dann enthält dieses Bit das 9. Datenbit eines empfangenen Zeichens.

'''TXB8''' (Transmit Data Bit 8)
:Wenn das vorher erwähnte CHR9-Bit gesetzt ist, dann muss in dieses Bit das 9. Bit des zu sendenden Zeichens eingeschrieben werden bevor das eigentliche Datenbyte in das Datenregister geschrieben wird.

|-
| '''USR   '''
| '''U'''ART '''S'''tatus '''R'''egister. 
Hier teilt uns der UART mit, was er gerade so macht.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''RXC'''
| align="center" | '''TXC'''
| align="center" | '''UDRE'''
| align="center" | '''FE'''
| align="center" | '''OR'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''RXC''' (UART Receive Complete)
:Dieses Bit wird vom AVR gesetzt, wenn ein empfangenes Zeichen vom Empfangs-Schieberegister in das Empfangs-Datenregister transferiert wurde.
:Das Zeichen muss nun schnellstmöglich aus dem Datenregister ausgelesen werden. Falls dies nicht erfolgt bevor ein weiteres Zeichen komplett empfangen wurde wird eine Überlauf-Fehlersituation eintreffen. Mit dem Auslesen des Datenregisters wird das Bit automatisch gelöscht.

'''TXC''' (UART Transmit Complete)
:Dieses Bit wird vom AVR gesetzt, wenn das im Sende-Schieberegister befindliche Zeichen vollständig ausgegeben wurde und kein weiteres Zeichen im Sendedatenregister ansteht. Dies bedeutet also, wenn die Kommunikation vollumfänglich abgeschlossen ist.
:Dieses Bit ist wichtig bei Halbduplex-Verbindungen, wenn das Programm nach dem Senden von Daten auf Empfang schalten muss. Im Vollduplexbetrieb brauchen wir dieses Bit nicht zu beachten.
:Das Bit wird nur dann automatisch gelöscht, wenn der entsprechende Interrupthandler aufgerufen wird, ansonsten müssen wir das Bit selber löschen.

'''UDRE''' ('''U'''ART '''D'''ata '''R'''egister '''E'''mpty)
:Dieses Bit wird vom AVR gesetzt, wenn ein Zeichen vom Sendedatenregister in das Send-Schieberegister übernommen wurde und der UART nun wieder bereit ist, ein neues Zeichen zum Senden aufzunehmen.
:Das Bit wird automatisch gelöscht, wenn ein Zeichen in das Sendedatenregister geschrieben wird.

'''FE''' ('''F'''raming '''E'''rror)
:Dieses Bit wird vom AVR gesetzt, wenn der UART einen Zeichenrahmenfehler detektiert, d.h. wenn das Stopbit eines empfangenen Zeichens 0 ist.
:Das Bit wird automatisch gelöscht, wenn das Stopbit des empfangenen Zeichens 1 ist.

'''OR''' ('''O'''ver'''R'''un) 
:Dieses Bit wird vom AVR gesetzt, wenn unser Programm das im Empfangsdatenregister bereit liegende Zeichen nicht abholt bevor das nachfolgende Zeichen komplett empfangen wurde.
:Das nachfolgende Zeichen wird verworfen.
:Das Bit wird automatisch gelöscht, wenn das empfangene Zeichen in das Empfangsdatenregister transferiert werden konnte.

|-
| '''UDR'''
| '''U'''ART '''D'''ata '''R'''egister. 
Hier werden Daten zwischen UART und CPU übertragen. Da der UART im
Vollduplexbetrieb gleichzeitig empfangen und senden kann, handelt es sich
hier physikalisch um 2 Register, die aber über die gleiche I/O-Adresse
angesprochen werden. Je nachdem, ob ein Lese- oder ein Schreibzugriff auf
den UART erfolgt wird automatisch das richtige UDR angesprochen.
|-
| '''UBRR'''
| '''U'''ART '''B'''aud '''R'''ate '''R'''egister. 
In diesem Register müssen wir dem UART mitteilen, wie schnell wir gerne
kommunizieren möchten. Der Wert, der in dieses Register geschrieben
werden muss, errechnet sich nach folgender Formel:

<math>
\begin{matrix}
\mathrm{UBRR} = \frac{\mathrm{Taktfrequenz}}{\mathrm{Baudrate} \cdot 16} - 1
\end{matrix}
</math>

Es sind Baudraten bis zu 115200 Baud und höher möglich.
|}

== Die Hardware ==

Der UART basiert auf normalem TTL-Pegel mit 0V (LOW) und 5V (HIGH). Die
Schnittstellenspezifikation für RS232 definiert jedoch -3V ... -12V (LOW) und
+3 ... +12V (HIGH). Zudem muss der Signalaustausch zwischen AVR und
Partnergerät invertiert werden. Für die Anpassung der Pegel und das
Invertieren der Signale gibt es fertige Schnittstellenbausteine. Der bekannteste
davon ist wohl der MAX232.


Streikt die Kommunikation per UART, so ist oft eine fehlerhafte Einstellung der Baudrate die Ursache. Die Konfiguration auf eine bestimmte Baudrate ist abhängig von der Taktfrequenz des Controllers. Gerade bei neu aufgebauten Schaltungen (bzw. neu gekauften Controllern) sollte man sich daher noch einmal vergewissern, dass der Controller auch tatsächlich mit der vermuteten Taktrate arbeitet und nicht z.B. den bei einigen Modellen werksseitig eingestellten internen [[Oszillator]] statt eines externen Quarzes nutzt. Die Werte der verschiedenen fuse-bits im Fehlerfall also beispielsweise mit ''[[AVRDUDE]]'' kontrollieren und falls nötig anpassen. Grundsätzlich empfiehlt sich auch immer ein Blick in die [[AVR_Checkliste]].

== Senden mit dem UART ==

Wir wollen nun Daten mit dem UART auf die serielle Schnittstelle ausgeben.

Dazu müssen wir den UART zuerst mal initialisieren. Dazu setzen wir je nach
gewünschter Funktionsweise die benötigten Bits im '''U'''ART '''C'''ontrol '''R'''egister.

Da wir vorerst nur senden möchten und (noch) keine Interrupts auswerten wollen, gestaltet sich die Initialisierung wirklich sehr einfach, da wir lediglich das '''Transmitter Enable''' Bit setzen müssen:

<pre class="code">
UCR |= (1<<TXEN);
</pre>

Neuere AVRs mit USART(s) haben mehrere Konfigurationsregister und erfordern eine etwas andere Konfiguration. Für einen ATmega16 z.B.:

<pre class="code">
UCSRB |= (1<<TXEN); // UART TX einschalten
UCSRC |= (1<<URSEL)|(3<<UCSZ0); // Asynchron 8N1
</pre>

Nun ist noch das bzw. sind noch die Baudratenregister einzustellen (UBRR bzw. UBRRL/UBRRH). Der Wert dafür ergibt sich aus der angegebenen Formel durch Einsetzen der Taktfrequenz und der gewünschten Übertragungsrate. (Das Berechnen der Formel kann man dem [[C-Präprozessor|Präprozessor]] überlassen).

<pre class="code">
/* UART-Init beim AT90S2313 */

#ifndef F_CPU
/* In neueren Version der WinAVR/Mfile Makefile-Vorlage kann
F_CPU im Makefile definiert werden, eine nochmalige Definition
hier wuerde zu einer Compilerwarnung fuehren. Daher "Schutz" durch
#ifndef/#endif */
/* Zum Beispiel 4Mhz-Quarz (falls nicht schon im Makefile definiert): */
#define F_CPU 4000000;
#endif
#define UART_BAUD_RATE 9600 // 9600 Baud

UBRR = F_CPU / (UART_BAUD_RATE * 16L) - 1;
</pre>

Wieder für den Mega16 mit einem 16bit-Register eine etwas andere Programmierung.

<pre class="code">
/* USART-Init beim ATmega16 */
#ifndef F_CPU
#define F_CPU 3686400 /* Oszillator-Frequenz in Hz */
#endif

// Hilfsmakro zur UBRR-Berechnung ("Formel" laut Datenblatt)
#define UART_UBRR_CALC(BAUD_,FREQ_) ((FREQ_)/((BAUD_)*16L)-1)

#define UART_BAUD_RATE 9600

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

/* alternativ bei der avr-libc "direkt 16bit" : */
UBRR = UART_UBRR_CALC(UART_BAUD_RATE,F_CPU);
</pre>

Teilweise kann man im Datenblatt der jeweiligen CPU auch den entsprechenden Wert nachschlagen. Ein Beispiel für einen ATmega32 bei 16MHz und für 19200 Baud: im Datenblatt des ATmega32 Tabelle "Examples of UBRR Settings" liest man für diese Vorgaben den Wert 51 ab. Dieser wird nun auf die Register UBRRH und UBRRL verteilt.

Die Initialisierung für den USART könnte dann so aussehen:

<pre class="code">
/* USART-Init 19200 Baud bei 16MHz für Mega32 */
UCSRB |= ( 1 << TXEN ); // UART TX einschalten
UCSRC |= ( 1 << URSEL )|( 3<<UCSZ0 ); // Asynchron 8N1
UBRRH = 0; // Highbyte ist 0
UBRRL = 51; // Lowbyte ist 51 ( dezimal )
</pre>

Der obige Code ist gegenüber den Versionen mit '#define ...' nicht so portabel, dafür aber etwas übersichtlicher.

=== Senden einzelner Zeichen ===

Um nun ein Zeichen auf die Schnittstelle auszugeben, müssen wir dasselbe
lediglich in das '''U'''ART '''D'''ata '''R'''egister schreiben. Vorher ist zu prüfen, ob das UART-Modul bereit ist das zu sendende Zeichen entgegenzunehmen. Die Bezeichnungen des/der Statusregisters mit dem Bit UDRE ist abhängig vom Controllertypen (vgl. Datenblatt).

<pre class="code">
// bei AVR mit einem UART ("classic AVR" z.B. AT90S8515)
while (!(USR & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = 'x'; /* schreibt das Zeichen x auf die Schnittstelle */

/** ODER **/

// bei neueren AVRs steht der Status in UCSRA/UCSR0A/UCSR1A, hier z.B. fuer ATmega16:
while (!(UCSRA & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = 'x'; /* schreibt das Zeichen x auf die Schnittstelle */
</pre>

=== Schreiben einer Zeichenkette (String) ===

Die Aufgabe "String senden" wird durch zwei Funktionen abgearbeitet. Die universelle/controllerunabhängige Funktion uart_puts übergibt jeweils ein Zeichen der Zeichenkette an eine Funktion uart_putc, die abhängig von der vorhandenen Hardware implementiert werden muss. In der Funktion zum Senden eines Zeichens ist darauf zu achten, dass vor dem Senden geprüft wird, ob der UART bereit ist den "Sendeauftrag" entgegenzunehmen.

<pre class="code">
// putc fuer AVR mit einem UART (z.B. AT90S8515)
int uart_putc(unsigned char c)
{
while(!(USR & (1 << UDRE))); /* warte, bis UDR bereit */
UDR = c; /* sende Zeichen */
return 0;
}

/** ODER **/

// bei neueren AVRs andere Bezeichnung fuer die Statusregister, hier ATmega16:
int uart_putc(unsigned char c)
{
while (!(UCSRA & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = c; /* sende Zeichen */
return 0;
}

/* puts ist unabhaengig vom Controllertyp */
void uart_puts (char *s)
{
while (*s)
{ /* so lange *s != '\0' also ungleich dem "String-Endezeichen" */
uart_putc(*s);
s++;
}
}


</pre>

Warteschleifen sind insofern etwas kritisch, da während des Sendens eines Strings nicht mehr auf andere Ereignisse reagieren werden kann. Universeller ist die Nutzung von FIFO(first-in first-out)-Puffern, in denen die zu sendenden bzw. empfangenen Zeichen/Bytes zwischengespeichert und mittels Interruptroutinen an den U(S)ART weitergegeben bzw. ausgelesen werden. Dazu existieren fertige Komponenten (Bibliotheken, Libraries), die man recht einfach in eigene Entwicklungen integrieren kann. Es empfiehlt sich, diese Komponenten zu nutzen und das Rad nicht neu zu erfinden.

== Zeichen Empfangen ==

Zum Empfang von Zeichen muss der Empfangsteil des UART bei der Initialisierung aktiviert werden, indem das RXEN-Bit im jeweiligen Konfigurationsregister (UCSRB bzw UCSR0B/UCSR1B) gesetzt wird. Im einfachsten Fall wird solange gewartet, bis ein Zeichen empfangen wurde, dieses steht dann im UART-Datenregister (UDR bzw. UDR0 und UDR1 bei AVRs mit 2 UARTS) zur Verfügung (sogen. "Polling-Betrieb"). Ein Beispiel für den ATmega16:

<pre class="code">
#include <inttypes.h>
#include <avr/io.h>

/* Zusaetzlich zur Baudrateneinstellung und der weiteren Initialisierung: */
void Usart_EnableRX()
{
UCSRB |= ( 1 << RXEN );
}

/* Zeichen empfangen */
uint8_t Usart_Rx(void)
{
while (!(UCSRA & (1<<RXC))); // warten bis Zeichen verfuegbar
return UDR; // Zeichen aus UDR an Aufrufer zurueckgeben
}
</pre>

Diese Funktion blockiert den Programmablauf. Alternativ kann das RXC-Bit in einer Programmschleife abgefragt werden und dann nur bei gesetztem RXC-Bit UDR ausgelesen werden. Eleganter und in den meisten Anwendungsfällen "stabiler" ist die Vorgehensweise, die empfangenen Zeichen in einer Interrupt-Routine einzulesen und zur späteren Verarbeitung in einem Eingangsbuffer (FIFO-Buffer) zwischenzuspeichern. Dazu existieren fertige und gut getestete [[Libraries|Bibliotheken]]  und Quellcodekomponenten (z.B. UART-Library von P. Fleury, procyon-avrlib und einige in der "Academy" von avrfreaks.net).

TODO: 9bit

== Software-UART ==

Falls die Zahl der vorhandenen Hardware-UARTs nicht ausreicht, können weitere Schnittstellen über sogennante Software-UARTs ergänzt werden. Es gibt dazu (mindestens) zwei Ansätze:
* Der bei AVRs üblichste Ansatz basiert auf dem Prinzip, dass ein externer Interrupt-Pin für den Empfang ("RX") genutzt wird. Das Startbit löst den Interrupt aus, in der Interrupt-Routine (ISR) wird der externe Interrupt deaktiviert und ein Timer aktiviert. In der Interrupt-Routine des Timers wird der Zustand des Empfangs-Pins entsprechend der Baudrate abgetastet. Nach Empfang des Stop-Bits wird der externe Interrupt wieder aktiviert. Senden kann über einen beliebigen Pin ("TX") erfolgen, der entsprechend der Baudrate und dem zu sendenden Zeichen auf 0 oder 1 gesetzt wird. Die Implementierung ist nicht ganz einfach, es existieren dazu aber fertige Bibliotheken (z.B. bei [http://www.avrfreaks.net/ avrfreaks] oder in der [http://hubbard.engr.scu.edu/embedded/avr/avrlib/ Procyon avrlib]).
* Ein weiterer Ansatz erfordert keinen Pin mit "Interrupt-Funktion" aber benötigt mehr Rechenzeit. Jeder Input-Pin kann als Empfangspin (RX) dienen. Über einen Timer wird der Zustand des RX-Pins mit einem vielfachen der Baudrate abgetastet (dreifach scheint üblich) und High- bzw. Lowbits anhand einer Mindestanzahl identifiziert. (Beispiel: "Generic Software Uart" Application-Note von IAR)

Neuere AVRs (z.B. ATtiny26 oder ATmega48,88,168,169) verfügen über ein Universal Serial Interface (USI), das teilweise UART-Funktion übernehmen kann. Atmel stellt eine Application-Note bereit, in der die Nutzung des USI als UART erläutert wird (im Prinzip "Hardware-unterstützter Software-UART").

* siehe auch: Weiterführende Informationen inkl. Beispielen für die Nutzung von stdio-Funktionen (printf etc.) im [[AVR-Tutorial - UART]].
* [http://homepage.hispeed.ch/peterfleury/ Peter Fleurys] UART-Bibiliothek fuer avr-gcc/avr-libc

= 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 analogen Signale (Spannungen) in digitale Zahlenwerte gewandelt. Bei AVRs, die über keinen internen AD-Wandler verfügen (z.B. ATmega162, ATtiny2313), kann durch externe Beschaltung (R/C-Netzwerk und "Zeitmessung") die Funktion des AD-Wandlers "emuliert" werden.

Es existieren keine AVRs mit eingebautem Digital-Analog-Konverter (DAC). Diese Funktion muss durch externe Komponenten nachgebildet werden (z.B. PWM und "Glättung").

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.

== 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 Genauigkeit, mit welcher ein analoges Signal aufgelöst werden kann, wird durch die Auflösung des ADC in Anzahl Bits angegeben, man hört bzw. liest jeweils von 8-Bit-ADC oder 10-Bit-ADC oder noch höher.

Ein ADC mit 8 Bit Auflösung kann somit das analoge Signal mit einer Genauigkeit von 1/256 des Maximalwertes darstellen. Wenn wir nun mal annehmen, wir hätten eine Spannung zwischen 0 und 5 Volt und eine Auflösung von 3 Bit, dann könnten
die Werte 0V, 0.625V, 1.25, 1.875V, 2.5V, 3.125V, 3.75, 4.375, 5V
daherkommen, siehe dazu folgende Tabelle:

<div align="center"><center>

{| border="1"
|-
| align="center" | '''Eingangsspannung am ADC'''
| align="center" | '''Entsprechender Messwert'''
|-
| align="center" | 0...<0.625V
| align="center" | 0
|-
| align="center" | 0.625...<1.25V
| align="center" | 1
|-
| align="center" | 1.25...<1.875V
| align="center" | 2
|-
| align="center" | 1.875...<2.5V
| align="center" | 3
|-
| align="center" | 2.5...<3.125V
| align="center" | 4
|-
| align="center" | 3.125...<3.75V
| align="center" | 5
|-
| align="center" | 3.75...<4.375V
| align="center" | 6
|-
| align="center" | 4.375...5V
| align="center" | 7
|}

</center>
</div>

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, um so genauer kann der Wert erfasst werden.

=== Der interne ADC im AVR ===

Wenn es einmal etwas genauer sein soll, dann müssen wir auf einen AVR mit eingebautem Analog-Digital-Wandler (ADC) zurückgreifen, die über mehrere Kanäle verfügen. Kanäle heisst in diesem Zusammenhang, dass zwar bis zu zehn analoge Eingänge am AVR verfügbar sind, aber nur ein "echter" Analog-Digital-Wandler zur Verfügung steht, vor der eigentlichen Messung ist also einzustellen, 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 Mikrohenry und 100 nF 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.
* Die '''interne''' Referenzspannung wird auf '''Vcc''' bezogen, eine externe Referenzspannung auf '''GND (Masse)'''. Davon unabhängig werden digitalisierte Spannungen '''immer''' auf GND bezogen. Beim ATMEGA8 z.B. ist der Pin AREF über 32kOhm mit GND verbunden, d.h. man muss diese doch extrem niedrige Eingangsimpedanz mit in die Berechnung für einen Spannungsteiler einbeziehen, bzw. kann diesen Widerstand als R2 gleich mit benutzen. Formel für Spannungsteiler: Udiv=U/((R1+R2)/R2)

Bei Nutzung von Vcc 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 angestossen 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 (inzwischen veralteten) AT90S8535, welcher über 8 ADC-Kanäle verfügt. Die Register unterscheiden sich jedoch nicht erheblich von denen aktueller AVRs (vgl. Datenblatt).

{| border="1"
|-
| '''ADCSR   '''
| '''ADC''' '''C'''ontrol and '''S'''tatus '''R'''egister. 
In diesem Register stellen wir ein, wie wir den '''ADC''' verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''ADEN'''
| align="center" | '''ADSC'''
| align="center" | '''ADFR'''
| align="center" | '''ADIF'''
| align="center" | '''ADIE'''
| align="center" | '''ADPS2'''
| align="center" | '''ADPS1'''
| align="center" | '''ADPS0'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
|}

'''ADEN''' ('''AD'''C '''En'''able)
: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''' ('''AD'''C '''S'''tart '''C'''onversion)
: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''' ('''AD'''C '''Fr'''ee Running Select)
:Mit diesem Bit wird die Betriebsart eingestellt.
:Eine logische 1 aktiviert den frei laufenden Modus. Der ''' ADC''' misst nun ständig den ausgewählten Kanal und schreibt den gemessenen Wert in das '''ADC Data Register'''.

'''ADIF''' ('''AD'''C '''I'''nterrupt '''F'''lag)
:Dieses Bit wird vom ''' ADC''' gesetzt, wenn eine Umwandlung erfolgt und das '''ADC Data Register''' aktualisiert ist.
: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 (So steht es in der AVR-Dokumentation).

'''ADIE''' ('''AD'''C '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist und ebenso das ''' I-Bit''' im Statusregister '''SREG''', dann wird der ''' ADC-Interrupt''' aktiviert.

'''ADPS2...ADPS0''' ('''AD'''C '''P'''rescaler '''S'''elect 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 sein.
:Der Vorteiler muss also so eingestellt werden, dass die CPU-Taktfrequenz dividiert durch den Teilungsfaktor einen Wert zwischen 50-200kHz ergibt.
:Bei einer CPU-Taktfrequenz von 4MHz beispielsweise rechnen wir

:<math>
\begin{matrix}
TF_{min}=\frac{CLK}{200kHz}=\frac{4000000}{200000}=\mathbf{20}
\\
\\
TF_{max}=\frac{CLK}{50kHz}=\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.
<dl><dd>
{| style="" border="1"
|-
| align="center" | '''ADPS2'''
| align="center" | '''ADPS1'''
| align="center" | '''ADPS0'''
| align="center" | '''Teilungsfaktor'''
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 2
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 2
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 4
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| align="center" | 8
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 16
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| align="center" | 32
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| align="center" | 64
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| align="center" | 128
|}
</dd></dl>
|-
| '''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:

<pre class="code">
x = ADCL; // mit uint16_t x
x += (ADCH<<8); // in zwei Zeilen (LSB/MSB-Reihenfolge und
C-Operatorprioritaet sichergestellt)
</pre>

oder

<pre class="code">
x = ADCW; // je nach AVR auch x = ADC (siehe avr/ioxxx.h)
</pre>

|-
| '''ADMUX  '''
| '''AD'''C '''Mu'''ltiple'''x'''er 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:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''MUX2'''
| align="center" | '''MUX1'''
| align="center" | '''MUX0'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''MUX2...MUX0'''
:Mit diesem 3 Bits wird der zu messende Kanal bestimmt. Es wird einfach die entsprechende Pinnummer des Ports eingeschrieben.
:Wenn das Register beschrieben wird, während dem 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.

:Meine Empfehlung ist deswegen klar 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.
|}

==== Aktivieren des ADC ====

Um den ''' ADC''' zu aktivieren, müssen wir das '''ADEN'''-Bit im '''ADCSR'''-Register
setzen. Im gleichen Schritt legen wir auch gleich 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 mit Spannungsteiler konditionieren. Ergebnis der Routine ist der ADC-Wert, also 0 für 0-Volt und 1024 für V_ref-Volt.

<pre class="code">

uint16_t ReadChannel(uint8_t mux)
{
uint8_t i;
uint16_t result = 0; //Initialisieren wichtig, da lokale Variablen
//nicht automatisch initialisiert werden und
//zufällige Werte haben. Sonst kann Quatsch rauskommen
ADCSRA = (1<<ADEN) | (1<<ADPS1) | (1<<ADPS0); // Frequenzvorteiler
// setzen auf 8 (1) und ADC aktivieren (1)

ADMUX = mux; // Kanal waehlen
ADMUX |= (1<<REFS1) | (1<<REFS0); // interne Referenzspannung nutzen

/* 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



/* Eigentliche Messung - Mittelwert aus 4 aufeinanderfolgenden Wandlungen */
for(i=0;i<4;i++)
{
ADCSRA |= (1<<ADSC); // eine Wandlung "single conversion"

while ( ADCSRA & (1<<ADSC) ); // auf Abschluss der Konvertierung warten
result += ADCW; // Wandlungsergebnisse aufaddieren
}
ADCSRA &= ~(1<<ADEN); // ADC deaktivieren (2)

result /= 4; // Summe durch vier teilen = arithm. Mittelwert

return result;
}

...

/* Beispielaufrufe: */

void foo(void)
{
uint16_t adcval;

adcval = ReadChannel(0); /* MUX-Bits auf 0b0000 -> Channel 0 */
...
adcval = ReadChannel(2); /* MUX-Bits auf 0b0010 -> Channel 2 */
...
}

</pre>

Im Beispiel wird bei jedem Aufruf der ADC aktiviert und nach der Wandlung wieder abgeschaltet, das spart Strom. Will man dies nicht, verschiebt man die mit (1) gekennzeichneten Zeilen in eine Funktion adc_init() o.ä. und löscht die mit (2) markierten Zeilen. Das Löschen des ADIF-Flags sollte, '''entgegen''' der [http://www.nongnu.org/avr-libc/user-manual/FAQ.html#faq_intbits FAQ], mit
<pre class="code">
...
ADCSRA |= (1<<ADIF);
...
</pre>
erfolgen. Die Methode in der FAQ eignet sich nur für Register in denen '''nur''' Interrupt-Flags stehen.

=== 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 eine 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.

[[Image:Poti.gif]]

Wird der Portpin des Controllers auf Ausgang konfiguriert (im Beispiel ''DDRD |= (1<<PD3)'') und dieser Ausgang auf Logisch 1 ("High", ''PORTD |= (1<<PD3)'') 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<<PD3); PORTD &= (1<<PD3)''), 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 Thresholdspannung 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 Ohm Widerstand dient dem Schutz des Controllers. Es würde sonst bei Maximaleinstellung des Potentionmeters (hier 0 Ohm) ein zu hoher Strom fliessen, der die Eingangsstufe 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. Ein Beispielprogramm findet sich auf [http://www.mypage.bluewin.ch/ch_schifferle/ Christian Schifferles Web-Seite] im Archiv ''ATMEL.ZIP'', welches unter den Titel ''Tutorial "Programmieren mit C für Atmel Mikrocontroller'' heruntergeladen werden kann.



==== 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.

[[Image:ADC ueber Komparator.gif]]

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:

[[Image:DAC R2R.gif]]

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:

[[Image:PWM Theorie 1.gif]]

Diese Rechteckspannung hat nun einen geometrischen Mittelwert,
der je nach Pulsbreite kleiner oder grösser ist.

[[Image:PWM Theorie 2.gif]]

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

Mit den AVR's 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:

{| border="1"
|-
| align="center" | '''PWM11'''
| align="center" | '''PWM10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| PWM-Modus des Timers ist nicht aktiv.
|-
| align="center" | 0
| align="center" | 1
| 8-Bit PWM.
|-
| align="center" | 1
| align="center" | 0
| 9-Bit PWM.
|-
| align="center" | 1
| align="center" | 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:

{| border="1"
|-
| align="center" | '''Auflösung'''
| align="center" | '''Obergrenze'''
| '''Frequenz'''
|-
| align="center" | 8
| align="center" | 255
| fTC1 / 510
|-
| align="center" | 9
| align="center" | 511
| fTC1 / 1022
|-
| align="center" | 10
| align="center" | 1023
| fTC1 / 2046
|}

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

{| border="1"
|-
| align="center" | '''COM1A1'''
| align="center" | '''COM1A0'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Keine Wirkung, Pin wird nicht geschaltet.
|-
| align="center" | 0
| align="center" | 1
| Keine Wirkung, Pin wird nicht geschaltet.
|-
| align="center" | 1
| align="center" | 0
| Nicht invertierende PWM. 
Der Ausgangspin wird gelöscht beim Hochzählen und gesetzt beim
Herunterzählen.
|-
| align="center" | 1
| align="center" | 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 heisst dann:

<pre class="code">
TCCR1A = (1<<PWM11)|(1<<PWM10)|(1<<COM1A1);
</pre>

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.

{| border="1"
|-
| align="center" | '''CS12'''
| align="center" | '''CS11'''
| align="center" | '''CS10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stop. Der Timer/Counter wird gestoppt.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CK
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CK / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CK / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CK / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CK / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin 1, negative Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin 1, positive Flanke
|}

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

<pre class="code">
TCCR1B = (1<<CS12) | (1<<CS10);
</pre>

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

<pre class="code">
OCR1A = xxx;
</pre>

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

[[Image:PWM Theorie 3.gif]]

[[Image:PWM Theorie 4.gif]]

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.

= Die Timer/Counter des AVR =

Die heutigen Mikrocontroller und insbesondere die RISC-AVRs sind für viele Steuerungsaufgaben zu schnell. Wenn wir beispielsweise eine LED oder Lampe blinken lassen wollen, können wir selbstverständlich nicht die CPU-Frequenz verwenden, da ja dann nichts mehr vom Blinken zu bemerken wäre.

Wir brauchen also eine Möglichkeit, Vorgänge in Zeitabständen durchzuführen, die geringer als die Taktfrequenz des Controllers sind. Selbstverständlich sollte die resultierende Frequenz auch noch möglichst genau und stabil sein.

Hier kommen die im AVR vorhandenen Timer/Counter zum Einsatz.

Ein anderes Anwendungsgebiet ist die Zählung von Signalen, welche über einen I/O-Pin zugeführt werden können.

Die folgenden Ausführungen beziehen sich auf den AT90S2313. Für andere Modelltypen müsst ihr euch die allenfalls notwendigen Anpassungen aus den Datenblättern der entsprechenden Controller herauslesen.

Wir unterscheiden grundsätzlich zwischen 8-Bit Timern, welche eine Auflösung von 256 aufweisen und 16-Bit Timern mit (logischerweise) einer Auflösung von 65536. Als Eingangstakt für die Timer/Counter kann entweder die CPU-Taktfrequenz, der Vorteiler-Ausgang oder ein an einen I/O-Pin angelegtes Signal verwendet werden. Wenn ein externes Signal verwendet wird, so darf dessen Frequenz nicht höher sein als die Hälfte des CPU-Taktes.

== Der Vorteiler (Prescaler) ==


Der Vorteiler dient dazu, den CPU-Takt vorerst um einen einstellbaren Faktor zu reduzieren. Die so geteilte Frequenz wird den Eingängen der Timer zugeführt.

Wenn wir mit einem CPU-Takt von 4 MHz arbeiten und den Vorteiler auf 1024 einstellen, wird also der Timer mit einer Frequenz von 4 MHz / 1024, also mit ca. 4 kHz versorgt. Wenn also der Timer läuft, so wird das Daten- bzw. Zählregister (TCNTx) mit dieser Frequenz inkrementiert.

== 8-Bit Timer/Counter ==

Alle AVR-Modelle verfügen über mindestens einen, teilweise sogar zwei, 8-Bit Timer.

Der 8-Bit Timer wird z.B bei AT90S2313 über folgende Register angesprochen (bei anderen Typen weitestgehend analog):

{| border="1"
|-
| '''TCCR0'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister
Timer '''0'''

In diesem Register stellen wir ein, wie wir den Timer/Counter verwenden möchten.

Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''CS02'''
| align="center" | '''CS01'''
| align="center" | '''CS00'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''CS02, CS01, CS00''' ('''C'''lock '''S'''elect Bits)
:Diese 3 Bits bestimmen die Quelle für den Timer/Counter:
<dl><dd>
{| border="1"
|-
| align="center" | CS02
| align="center" | CS01
| align="center" | CS00
| Resultat
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stopp, Der Timer/Counter wird angehalten.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CPU-Takt
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CPU-Takt / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CPU-Takt / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CPU-Takt / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CPU-Takt / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin '''TO''', fallende Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin '''TO''', steigende Flanke
|}
</dd>
</dl>
:Wenn als Quelle der externe Pin '''TO''' verwendet wird, so wird ein Flankenwechsel auch erkannt, wenn der Pin '''TO''' als Ausgang geschaltet ist.

|-
| '''TCNT0'''
| '''T'''imer/'''C'''ou'''nt'''er Daten Register Timer '''0''' 
Dieses ist als 8-Bit Aufwärtszähler mit Schreib- und Lesezugriff
realisiert. Wenn der Zähler den Wert 255 erreicht hat beginnt er beim
nächsten Zyklus wieder bei 0.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}
|}

Um nun also den Timer0 in Betrieb zu setzen und ihn mit einer Frequenz von 1/1024-tel des CPU-Taktes zählen zu lassen, schreiben wir die folgende Befehlszeile:

<pre class="code">
TCCR0 |= (1<<CS00)|(1<<CS02);
</pre>

Der Zähler zählt nun aufwärts bis 255, um dann wieder bei 0 zu beginnen. Der aktuelle Zählerstand steht in TCNT0. Bei jedem Überlauf von 255 auf 0 wird das Timer Overflow Flag '''TOV0''' im Timer Interrupt Flag '''TIFR'''-Register gesetzt und, falls so konfiguriert, ein entsprechender Timer-Overflow-Interrupt ausgelöst und die daran gebundene Interrupt-Routine abgearbeitet.

== 16-Bit Timer/Counter ==

Viele AVR-Modelle besitzen ausser den 8-Bit Timern auch 16-Bit Timer. Die 16-Bit Timer/Counter sind etwas komplexer aufgebaut als die 8-Bit Timer/Counter, bieten dafür aber auch viel mehr Möglichkeiten, als da sind:

* Die [[PWM]]-Betriebsart Erzeugung eines pulsweitenmodulierten Ausgangssignals.
* Vergleichswert-Überprüfung mit Erzeugung eines Ausgangssignals (Output Compare Match).
* Einfangen eines Eingangssignals mit Speicherung des aktuellen Zählerwertes (Input Capturing), mit zuschaltbarer Rauschunterdrückung (Noise Filtering).

Folgende Register sind dem Timer/Counter 1 zugeordnet:

{| border="1"
|-
| '''TCCR1A'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister '''A''' Timer '''1''' 
In diesem und dem folgenden Register stellen wir ein, wie wir den Timer/Counter verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''COM1A1'''
| align="center" | '''COM1A0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''PWM11'''
| align="center" | '''PWM10'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''COM1A1''', '''COM1A0''' ('''Co'''mpare '''M'''atch Control Bits)
:Diese 2 Bits bestimmen die Aktion, welche am Output-Pin '''OC1''' ausgeführt werden soll, wenn der Wert des Datenregisters des Timer/Counter 1 den Wert des Vergleichsregisters erreicht, also ein so genannter Compare Match auftritt.
:Der Pin '''OC1''' ('''PB3''' beim 2313) muss mit dem Datenrichtungsregister als Ausgang konfiguriert werden.

<dl><dd>
{| border="1"
|-
| align="center" | COM1A1
| align="center" | COM1A0
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 0
| align="center" | 1
| Das Signal am Pin '''OC1''' wird invertiert (Toggle).
|-
| align="center" | 1
| align="center" | 0
| Der Output Pin '''OC1''' wird auf 0 gesetzt.
|-
| align="center" | 1
| align="center" | 1
| Der Output Pin '''OC1''' wird auf 1 gesetzt.
|}
</dd></dl>
:In der PWM-Betriebsart haben diese Bits eine andere Funktion.
<dl><dd>
{| border="1"
|-
| align="center" | COM1A1
| align="center" | COM1A0
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 0
| align="center" | 1
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 1
| align="center" | 0
| Wird beim Hochzählen der Wert im Vergleichsregister erreicht, so wird der Pin '''OC1''' auf 0 gesetzt.
Wird beim Herunterzählen der Wert im Vergleichsregister erreicht, so wird der Pin auf 1 gesetzt.

Man nennt dies ''nicht invertierende PWM''.
|-
| align="center" | 1
| align="center" | 1
| Wird beim Hochzählen der Wert im Vergleichsregister erreicht, so wird der Pin '''OC1''' auf 1 gesetzt.
Wird beim Herunterzählen der Wert im Vergleichsregister erreicht, so wird der Pin auf 0 gesetzt.

Man nennt dies ''invertierende PWM''.
|}
</dd></dl>

'''PWM11''', '''PWM10''' ('''PWM''' Mode Select Bits)
:Mit diesen 2 Bits wird die PWM-Betriebsart des Timer/Counter 1 gesteuert.
<dl><dd>
{| border="1"
|-
| align="center" | PWM11
| align="center" | PWM10
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Die PWM-Betriebsart ist nicht aktiviert. Timer/Counter 1 arbeitet als normaler Timer bzw. Zähler.
|-
| align="center" | 0
| align="center" | 1
| 8-Bit PWM Betriebsart aktivieren.
|-
| align="center" | 1
| align="center" | 0
| 9-Bit PWM Betriebsart aktivieren.
|-
| align="center" | 1
| align="center" | 1
| 10-Bit PWM Betriebsart aktivieren.
|}
</dd></dl>
|-
| '''TCCR1B'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister '''B''' Timer '''1'''

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''ICNC1'''
| align="center" | '''ICES1'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''CTC1'''
| align="center" | '''CS12'''
| align="center" | '''CS11'''
| align="center" | '''CS10'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''ICNC1''' ('''I'''nput '''C'''apture '''N'''oise '''C'''anceler (4 CKs) Timer/Counter 1
:oder auf Deutsch Rauschunterdrückung des Eingangssignals.
:Wenn dieses Bit gesetzt ist und mit dem Input Capture Signal gearbeitet wird so werden nach der Triggerung des Signals mit der entsprechenden Flanke (steigend oder fallend) am Input Capture Pin '''ICP''' jeweils 4 Messungen mit der CPU-Frequenz des Eingangssignals abgefragt. Nur dann, wenn alle 4 Messungen den gleichen Zustand aufweisen gilt das Signal als erkannt.

'''ICES1''' ('''I'''nput '''C'''apture '''E'''dge '''S'''elect Timer/Counter '''1''')
:Mit diesem Bit wird bestimmt, ob die steigende ('''ICES1'''=1) oder fallende ('''ICES1'''=0) Flanke zur Auswertung des Input Capture Signals an Pin '''ICP''' heran gezogen wird.

'''CTC1''' ('''C'''lear '''T'''imer/'''C'''ounter on Compare Match Timer/Counter '''1''')
:Wenn dieses Bit gesetzt ist, so wird nach einer Übereinstimmung des Datenregisters '''TCNT1H'''/'''TCNT1L''' mit dem Vergleichswert in '''OCR1H'''/'''OCR1L''' das Datenregister '''TCNT1H'''/'''TCNT1L''' auf 0 gesetzt.
:Da die Übereinstimmung im Takt nach dem Vergleich behandelt wird, ergibt sich je nach eingestelltem Vorteiler ein etwas anderes Zählverhalten:
:Wenn der Vorteiler auf 1 gestellt ist und C der jeweilige Zählerwert ist, dann nimmt das Datenregister, im CPU-Takt betrachtet, folgende Werte an:
:... | C-2 | C-1 | C | 0 | 1 |...
:Wenn der Vorteiler z.B. auf 8 eingestellt ist, dann nimmt das Datenregister folgende Werte an:
:... | C-2, C-2, C-2, C-2, C-2, C-2, C-2, C-2 | C-1, C-1, C-1, C-1, C-1, C-1, C-1, C-1 | C, 0, 0, 0, 0, 0, 0, 0 |...
:In der PWM-Betriebsart hat dieses Bit keine Funktion.

'''CS12''', '''CS11''', '''CS10''' ('''C'''lock '''S'''elect Bits)
:Diese 3 Bits bestimmen die Quelle für den Timer/Counter:
<dl><dd>
{| border="1"
|-
| align="center" | CS12
| align="center" | CS11
| align="center" | CS10
| Resultat
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stopp, Der Timer/Counter wird angehalten.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CPU-Takt
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CPU-Takt / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CPU-Takt / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CPU-Takt / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CPU-Takt / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin TO, fallende Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin T0, steigende Flanke
|}
</dd></dl>
:Wenn als Quelle der externe Pin T0 verwendet wird, so wird ein Flankenwechsel auch erkannt, wenn der Pin T0 als Ausgang geschaltet ist.
|-
| '''TCNT1H''' '''TCNT1L'''
| '''T'''imer/'''C'''ou'''nt'''er Daten Register Timer/Counter '''1'''
Dieses ist als 16-Bit Aufwärtszähler mit Schreib- und Lesezugriff realisiert. Wenn der Zähler den Wert 65535 erreicht hat, beginnt er beim nächsten Zyklus wieder bei 0.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''TCNT1H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''TCNT1L'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

In der PWM-Betriebsart wird das Register als Auf/Ab-Zähler verwendet, d.h. der Wert steigt zuerst von 0 bis er den Überlauf von 65535 auf 0 erreicht hat. Dann zählt das Register rückwärts wiederum bis 0.

Zum Auslesen des Registers wird von der CPU ein internes TEMP-Register verwendet. Das gleiche Register wird auch verwendet, wenn auf '''OCR1''' oder '''ICR1''' zugegriffen wird.

Deshalb müssen vor dem Zugriff auf eines dieser Register alle Interrupts gesperrt werden, weil sonst die Möglichkeit des gleichzeitigen Zugriffs auf das Temporärregister gegeben ist, was natürlich zu fehlerhaftem Verhalten des Programms führt.. Zudem muss zuerst '''TCNT1L''' und erst danach '''TCNT1H''' ausgelesen werden.

Wenn in das Register geschrieben werden soll, müssen ebenfalls alle Interrrupts gesperrt werden. Dann muss zuerst das '''TCNT1H'''-Register und erst danach das '''TCNT1L'''-Register geschrieben werden, also genau die umgekehrte Reihenfolge wie beim Lesen des Registers.
|-
| '''OCR1H''' '''OCR1L'''
| Timer/Counter '''O'''utput '''C'''ompare '''R'''egister Timer/Counter '''1'''
{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''OCR1H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''OCR1L'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

Der Wert im Output Compare Register wird ständig mit dem aktuellen Wert im Datenregister TCNT1H/TCNT1L verglichen. Stimmen die beiden Werte überein, so wird ein sogenannter Output Compare Match ausgelöst. Die entsprechenden Aktionen werden über die Timer/Counter 1 Control und Status Register eingestellt.

Zum Auslesen des Registers wird von der CPU ein internes TEMP-Register verwendet. Das gleiche Register wird auch verwendet, wenn auf '''OCR1''' oder '''ICR1''' zugegriffen wird.
Deshalb müssen vor dem Zugriff auf eines dieser Register alle Interrupts gesperrt werden, weil sonst die Möglichkeit des gleichzeitigen Zugriffs auf das Temporärregister gegeben ist, was natürlich zu fehlerhaftem Verhalten des Programms führt.. Zudem muss zuerst '''OCR1L''' und erst danach '''OCR1H''' ausgelesen werden.

Wenn in das Register geschrieben werden soll, müssen ebenfalls alle Interrupts gesperrt werden. Dann muss zuerst das '''OCR1H'''-Register und erst danach das '''OCR1L'''-Register geschrieben werden, also genau die umgekehrte Reihenfolge wie beim Lesen des Registers.
|-
| '''ICR1H''' '''ICR1L'''
| Timer/Counter '''I'''nput '''C'''apture '''R'''egister Timer/Counter '''1''' 
{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''ICR1''''''H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''ICR1''''''L'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

Das Input Capture Register ist ein 16-Bit Register mit Lesezugriff. Es kann nicht beschrieben werden.

Wenn am Input Capture Pin '''ICP''' die gemäß Einstellungen im '''TCCR1B''' definierte Flanke erkannt wird, so wird der aktuelle Inhalt des Datenregisters '''TCNT1H'''/'''TCNT1L''' sofort in dieses Register kopiert und das Input Capture Flag '''ICF1''' im Timer Interrupt Flag Register '''TIFR''' gesetzt.

Wie bereits oben erwähnt, müssen vor dem Zugriff auf dieses Register alle Interrupts gesperrt werden. Zudem müssen Low- und Highbyte des Registers in der richtigen Reihenfolge bearbeitet werden:

{| border="0"
|-
| Lesen:
| '''ICR1L''' -> '''ICR1H'''
|-
| Schreiben:
| '''ICR1H''' -> '''ICR1L'''
|}
|}

=== Die PWM-Betriebsart ===

Wenn der Timer/Counter 1 in der PWM-Betriebsart betrieben wird, so bilden das Datenregister '''TCNT1H'''/'''TCNT1L''' und das Vergleichsregister '''OCR1H'''/'''OCR1L''' einen 8-, 9- oder 10-Bit, frei laufenden PWM-Modulator, welcher als PWM-Signal am '''OC1'''-Pin ('''PB3''' beim 2313) abgegriffen werden kann. Das Datenregister '''TCNT1H'''/'''TCNT1L''' wird dabei als Auf-/Ab-Zähler betrieben, welcher von 0 an aufwärts zählt bis zur Obergrenze und danach wieder zurück auf 0.
Die Obergrenze ergibt sich daraus, ob 8-, 9- oder 10-Bit PWM verwendet wird, und zwar gemäss folgender Tabelle:

{| border="1"
|-
| align="center" | '''Auflösung'''
| align="center" | '''Obergrenze'''
| '''Frequenz'''
|-
| align="center" | 8
| align="center" | 255
| fTC1 / 510
|-
| align="center" | 9
| align="center" | 511
| fTC1 / 1022
|-
| align="center" | 10
| align="center" | 1023
| fTC1 / 2046
|}

Wenn nun der Zählerwert im Datenregister den in '''OCR1H'''/'''OCR1L''' gespeicherten Wert erreicht, wird der Ausgabepin '''OC1''' gesetzt bzw. gelöscht, je nach Einstellung von '''COM1A1''' und '''COM1A0''' im '''TCCR1A'''-Register.

Ich habe versucht, die entsprechenden Signale in der folgenden Grafik zusammenzufassen

[[Image:PWM Theorie 3.gif]]

[[Image:PWM Theorie 4.gif]]

=== Vergleichswert-Überprüfung ===

Hier wird in ein spezielles Vergleichswertregister ('''OCR1H'''/'''OCR1L''') ein Wert eingeschrieben, welcher ständig mit dem aktuellen Zählerwert verglichen wird.
Erreicht der Zähler den in diesem Register eingetragenen Wert, so kann ein Signal (0 oder 1) am Pin '''OC1''' erzeugt und/oder ein Interrupt ausgelöst werden.

=== Einfangen eines Eingangssignals (Input Capturing) ===

Bei dieser Betriebsart wird an den Input Capturing Pin (ICP) des Controllers eine Signalquelle angeschlossen.
Nun kann je nach Konfiguration entweder ein Signalwechsel von 0 nach 1 (steigende Flanke) oder von 1 nach 0 (fallende Flanke) erkannt werden und der zu diesem Zeitpunkt aktuelle Zählerstand in ein spezielles Register abgelegt werden. Gleichzeitig kann auch ein entsprechender Interrupt ausgelöst werden.
Wenn die Signalquelle ein starkes Rauschen beinhaltet, kann die Rauschunterdrückung eingeschaltet werden. Dann wird beim Erkennen der konfigurierten Flanke über 4 Taktzyklen das Signal überwacht und nur dann, wenn alle 4 Messungen gleich sind, wird die entsprechende Aktion ausgelöst.

== Gemeinsame Register ==

Verschiedene Register beinhalten Zustände und Einstellungen, welche sowohl
für den 8-Bit, als auch für den 16-Bit Timer/Counter in ein und demselben
Register zu finden sind.

{| border="1"
|-
| '''TIMSK'''
| '''T'''imer/Counter '''I'''nterrupt '''M'''a'''sk'''
Register

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''TOIE1'''
| align="center" | '''OCIE1A'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''TICIE'''
| align="center" | '''-'''
| align="center" | '''TOIE0'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''TOIE1''' ('''T'''imer/Counter '''O'''verflow '''I'''nterrupt '''E'''nable Timer/Counter '''1''')
:Wenn dieses Bit gesetzt ist, wird bei einem Überlauf des Datenregisters des Timer/Counter 1 ein Timer Overflow 1 Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''OCIE1A''' ('''O'''utput '''C'''ompare Match '''I'''nterrupt '''E'''nable Timer/Counter '''1''')
:Beim Timer/Counter 1 kann zusätzlich zum Überlauf ein Vergleichswert definiert werden.

:Wenn dieses Bit gesetzt ist, wird beim Erreichen des Vergleichswertes ein Compare Match Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''TICIE''' ('''T'''imer/Counter '''I'''nput '''C'''apture '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein Capture Event Interrupt ausgelöst, wenn ein entsprechendes Signalereignis am Pin PD6(ICP) auftritt. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein, wenn auch ein entsprechender Interrupt ausgelöst werden soll.

'''TOIE0''' ('''T'''imer/Counter '''O'''verflow '''I'''nterrupt '''E'''nable Timer/Counter '''0''')
:Wenn dieses Bit gesetzt ist, wird bei einem Überlauf des Datenregisters des Timer/Counter 0 ein Timer Overflow 0 Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

|-
| '''TIFR'''
| '''T'''imer/Counter '''I'''nterrupt '''F'''lag '''R'''egister

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''TOV1'''
| align="center" | '''OCF1A'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''ICF1'''
| align="center" | '''-'''
| align="center" | '''TOV0'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''TOV1''' ('''T'''imer/Counter '''O'''verflow Flag Timer/Counter '''1''')
:Dieses Bit wird vom Controller gesetzt, wenn beim Timer 1 ein Überlauf des Datenregisters stattfindet.

:In der PWM-Betriebsart wird das Bit gesetzt, wenn die Zählrichtung von auf- zu abwärts und umgekehrt geändert wird (Zählerwert = 0).

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''OCF1A''' ('''O'''utput '''C'''ompare '''F'''lag Timer/Counter '''1''')
:Dieses Bit wird gesetzt, wenn der aktuelle Wert des Datenregisters von Timer/Counter 1 mit demjenigen im Vergleichsregister '''OCR1''' übereinstimmt.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''ICF1''' ('''I'''nput '''C'''apture '''F'''lag Timer/Counter '''1''')
:Dieses Bit wird gesetzt, wenn ein Capture-Ereignis aufgetreten ist, welches anzeigt, dass der Wert des Datenregisters des Timer/Counter 1 in das Input Capture Register ICR1 übertragen wurde.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''TOV0''' ('''T'''imer/Counter '''O'''verflow Flag Timer/Counter '''0''')
:Dieses Bit wird vom Controller gesetzt, wenn beim Timer 0 ein Überlauf des Datenregisters stattfindet.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.
|}

 

= 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 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_mode()'''
:Versetzt den Controller in den mit set_sleep_mode gewählten Schlafmodus.

<pre class="code">
#include <avr/io.h>
#include <avr/sleep.h>
...
set_sleep_mode(SLEEP_MODE_PWR_DOWN);
sleep_mode();

// Code hier wird erst nach Auftreten eines entsprechenden
// "Aufwach-Interrupts" verarbeitet
...
</pre>

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:

<pre class="code">
#include <avr/io.h>
...
// Sleep-Mode "Power-Save" beim ATmega169 "manuell" aktivieren
SMCR = (3<<SM0) | (1<<SE);
asm volatile ("sleep"::);
...
</pre>

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Power Management and Sleep-Modes

= Der Watchdog =

Und hier kommt das ultimative Mittel gegen die Unvollkommenheit von uns
Programmierern, der Watchdog.

So sehr wir uns auch anstrengen, es wird uns kaum je gelingen, das absolut
perfekte und fehlerfreie Programm zu entwickeln.

Der Watchdog kann uns zwar auch nicht zu besseren Programmen verhelfen aber er
kann dafür sorgen, dass unser Programm, wenn es sich wieder mal in's Nirwana
verabschiedet hat, neu gestartet wird, indem ein Reset des Controllers
ausgelöst wird.

Betrachten wir doch einmal folgende Codesequenz:

<pre class="code">
uint8_t x;

x = 10;

while (x >= 0) {
// tu was

x--;
}
</pre>

Wenn wir die Schleife mal genau anschauen sollte uns auffallen, dass dieselbe niemals beendet wird. Warum nicht? Ganz einfach, weil eine als '''''unsigned''''' deklarierte Variable niemals kleiner als Null werden kann (der Compiler sollte jedoch eine ensprechende Warnung ausgeben).
Das Programm würde sich also hier aufhängen und auf ewig in der Schleife drehen.
Und hier genau kommt der Watchdog zum Zug.

== Wie funktioniert nun der Watchdog ==

Der Watchdog enthält einen separaten Timer/Counter, welcher mit einem intern erzeugten Takt von 1 MHz bei 5V Vcc getaktet wird.
Nachdem der Watchdog aktiviert und der gewünschte Vorteiler eingestellt wurde beginnt der Counter von 0 an hochzuzählen.
Wenn nun die je nach Vorteiler eingestellte Anzahl Zyklen erreicht wurde, löst der Watchdog einen Reset aus. Um nun also im Normalbetrieb den Reset zu verhindern müssen wir den Watchdog regelmässig wieder neu starten bzw. Rücksetzen (Watchdog Reset).
Dies sollte innerhalb unserer Hauptschleife passieren.

Um ein unbeabsichtigtes Ausschalten des Watchdogs zu verhindern muss ein spezielles Prozedere verwendet werden, um den WD auszuschalten und zwar müssen zuerst die beiden Bits WDTOE und WDE in einer einzelnen Operation (also nicht mit sbi) auf 1 gesetzt werden.
Dann muss innerhalb der nächsten 4 Taktzyklen das Bit WDE auf 0 gesetzt werden.

Das Watchdog Control Register:

{| border="1"
|-
| '''WDTCR'''
| '''W'''atchog '''T'''imer  '''C'''ontrol '''R'''egister

In diesem Register stellen wir ein, wie wir den Watchdog verwenden möchten.

Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''WDTOE'''
| align="center" | '''WDE'''
| align="center" | '''WDP2'''
| align="center" | '''WDP1'''
| align="center" | '''WDP0'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''WDTOE''' ('''W'''atch'''d'''og '''T'''urn '''O'''ff '''E'''nable)
:Dieses Bit muss gesetzt sein, wenn das Bit '''WDE''' gelöscht wird, andernfalls wird der Watchdog nicht ausgeschaltet.
:Wenn das Bit einmal gesetzt ist wird es von der Hardware nach 4 Taktzyklen automatisch wieder gelöscht.

'''WDE''' ('''W'''atch'''d'''og '''E'''nable)
:Wenn dieses Bit gesetzt wird, so wird der Watchdog aktiviert.
:Das Bit kann nur gelöscht werden, solange das Bit '''WDTOE''' auf 1 steht.

'''WDP2''', '''WDP1''', '''WDP0''' ('''W'''atch'''d'''og Timer '''P'''rescaler Bits)
:Diese 3 Bits bestimmen die Anzahl Oszillatorzyklen für den Watchdog, also, wie lange es dauert, bis ein Reset ausgelöst wird:
<dl><dd>
{| border="1"
|-
| align="center" | WDP2
| align="center" | WDP1
| align="center" | WDP0
| align="center" | Anzahl Zyklen
| align="center" | Typ. Timeoutzeit bei Vcc = 3V
| align="center" | Typ. Timeoutzeit bei Vcc = 5V
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 16K
| align="center" | 47ms
| align="center" | 15ms
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 32K
| align="center" | 94ms
| align="center" | 30ms
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 64K
| align="center" | 0.19s
| align="center" | 60ms
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| align="center" | 128K
| align="center" | 0.38s
| align="center" | 0.12s
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 256K
| align="center" | 0.75s
| align="center" | 0.24s
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| align="center" | 512K
| align="center" | 1.5s
| align="center" | 0.49s
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| align="center" | 1024K
| align="center" | 3s
| align="center" | 0.97s
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| align="center" | 2048K
| align="center" | 6s
| align="center" | 1.9s
|}
</dd></dl>
|}

Um den Watchdog mit dem AVR-GCC Compiler zu verwenden, muss die Headerdatei ''wdt.h'' (''#include <avr/wdt.h>'') in die Quelldatei eingebunden werden.

Danach können die folgenden Funktionen verwendet werden:

* '''wdt_enable(uint8_t timeout)'''
:Aktiviert den Watchdog und stellt den Vorteiler auf den gewünschten Wert ein bzw. der in timeout übergebene Wert wird in das WDTCR-Register eingetragen. Einige Timeout-Werte sind als Konstanten vordefiniert
:Mögliche Timeoutwerte:
<div align="center">
{| border="1"
! Konstante
! Wert
! TimeOut
|-
| WDTO_15MS
| 0
| 15 ms
|-
| WDTO_30MS
| 1
| 30 ms
|-
| WDTO_60MS
| 2
| 60 ms
|-
| WDTO_120MS
| 3
| 120 ms
|-
| WDTO_250MS
| 4
| 250 ms
|-
| WDTO_500MS
| 5
| 500 ms
|-
| WDTO_1S
| 6
| 1 S
|-
| WDTO_2S
| 7
| 2s
|}
</div>
* '''wdt_disable()'''
:Mit dieser Funktion kann der Watchdog ausgeschaltet werden. Dabei wird das notwendige Prozedere, wie oben beschrieben, automatisch ausgeführt.
* '''wdt_reset()'''
:Dies ist wohl die wichtigste der Watchdog-Funktionen. Sie erzeugt einen Watchdog-Reset, welcher periodisch, und zwar vor Ablauf der Timeoutzeit, ausgeführt werden muss, damit der Watchdog nicht den AVR zurücksetzt.

Selbstverständlich kann das '''WDTCR'''-Register auch mit den uns bereits bekannten Funktionen für den Zugriff auf Register programmiert werden.

== Watchdog-Anwendungshinweise ==

Ob nun der Watchdog als Schutzfunktion überhaupt verwendet werden soll, hängt stark von der Anwendung, der genutzten Peripherie und dem Umfang und der Qualitätssicherung des Codes ab. Will man sicher gehen, dass ein Programm sich nicht in einer Endlosschleife verfängt, ist der Wachdog das geeignete Mittel dies zu verhindern. Weiterhin kann bei geschickter Programmierung der Watchdog dazu genutzt werden, bestimmte Stromsparfunktionen zu implementieren. Ausserdem bietet der WD die einzige Möglichkeit einen beabsichtigten System-Reset (ein "richtiger Reset", kein "jmp 0x0000") ohne externe Beschaltung auszulösen, was z.B. bei der Implementierung eines Bootloaders nützlich ist. Bei bestimmten Anwendungen kann die Nutzung des WD als "ultimative Deadlock-Sicherung für nicht bedachte Zustände" natürlich immer als zusätzliche Sicherung dienen.

Es besteht die Möglichkeit herauszufinden, ob ein Reset durch den Watchdog ausgelöst wurde (beim ATmega16 z.B. Bit WDRF in MCUCSR). Diese Information sollte auch genutzt werden, falls ein WD-Reset in der Anwendung nicht planmässig implementiert wurde. Zum Beispiel kann man eine LED an einen freien Pin hängen, die nur bei einem Reset durch den WD aufleuchtet oder aber das "Ereignis WD-Reset" im internen EEPROM des AVR absichern, um die Information später z.B. über UART oder ein Display auszugeben (oder einfach den EEPROM-Inhalt über die ISP/JTAG-Schnittstelle auslesen).

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Watchdog timer handling

= 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.

[[Image:Interrupt Programme.gif]]

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.

[http://www.mikrocontroller.net/forum/read-1-235092.html#new Ausführlicher Thread im Forum]

== Anforderungen an Interrupt-Routinen ==

Um unliebsamen Überraschungen vorzubeugen, sollten einige Grundregeln bei der Implementierung der Interruptroutinen beachtet werden. Interruptroutinen soll 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.

== 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 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.

{| border="1"
|-
| '''GIMSK'''
| '''G'''eneral '''I'''nterrupt '''M'''ask '''R'''egister. 

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''INT1'''
| align="center" | '''INT0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''INT1''' (External '''Int'''errupt 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 '''Int'''errupt 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'''
| '''G'''eneral '''I'''nterrupt '''F'''lag '''R'''egister.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''INTF1'''
| align="center" | '''INTF0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''INTF1''' (External '''Int'''errupt Flag '''1''')
:Dieses Bit wird gesetzt, wenn am '''INT1'''-Pin eine Interrupt-Kondition, entsprechend der Konfiguration, 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 '''Int'''errupt Flag '''0''')
:Dieses Bit wird gesetzt, wenn am '''INT0'''-Pin eine Interrupt-Kondition, entsprechend der Konfiguration, 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''' '''C'''ontrol '''R'''egister.

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

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''SE'''
| align="center" | '''SM'''
| align="center" | '''ISC11'''
| align="center" | '''ISC10'''
| align="center" | '''ISC01'''
| align="center" | '''ISC00'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''SE''' ('''S'''leep '''E'''nable)
: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''' ('''S'''leep '''M'''ode)
:Dieses Bit bestimmt der 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''' ('''I'''nterrupt '''S'''ense '''C'''ontrol '''1''' Bits)
:Diese beiden Bits bestimmen, ob die steigende oder die fallende Flanke für die Interrupterkennung am '''INT1'''-Pin ausgewertet wird.
<dl><dd>
{| border="1"
|-
| align="center" | '''ISC11'''
| align="center" | '''ISC10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Low Level an '''INT1''' erzeugt einen Interrupt.

In der Beschreibung heisst es, der Interrupt wird getriggert, solange der Pin auf 0 bleibt, also eigentlich unbrauchbar.
|-
| align="center" | 0
| align="center" | 1
| Reserviert
|-
| align="center" | 1
| align="center" | 0
| Die fallende Flanke an '''INT1''' erzeugt einen Interrupt.
|-
| align="center" | 1
| align="center" | 1
| Die steigende Flanke an '''INT1''' erzeugt einen Interrupt.
|}
</dd></dl>
'''ISC01''', '''ISC00''' ('''I'''nterrupt '''S'''ense '''C'''ontrol '''0''' Bits)
:Diese beiden Bits bestimmen, ob die steigende oder die fallende Flanke für die Interrupterkennung am '''INT0'''-Pin ausgewertet wird.

<dl><dd>
{| border="1"
|-
| align="center" | '''ISC01'''
| align="center" | '''ISC00'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Low Level an '''INT0''' erzeugt einen Interrupt.

In der Beschreibung heisst es, der Interrupt wird getriggert, solange der Pin auf 0 bleibt, also eigentlich unbrauchbar.
|-
| align="center" | 0
| align="center" | 1
| Reserviert
|-
| align="center" | 1
| align="center" | 0
| Die fallende Flanke an '''INT0''' erzeugt einen Interrupt.
|-
| align="center" | 1
| align="center" | 1
| Die steigende Flanke an '''INT0''' erzeugt einen Interrupt.
|}
</dd></dl>
|}

== 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, rate ich dringend davon ab. 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'').

<pre class="code">
// fuer sei(), cli() und ISR():
#include <avr/interrupt.h>

</pre>

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

<pre class="code">
sei();
</pre>

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

<pre class="code">
cli();
</pre>

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 Interrups aktivieren, was zu unerwünschten Seiteneffekten führen kann. Die aus dem folgenden Beispiel ersichtliche Vorgehensweise ist in solchen Fällen vorzuziehen:

<pre class="code">
#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!
...

}
</pre>



Nachdem nun die Interrupts aktiviert sind, braucht es selbstverständlich noch den auszuführenden Code, der ablaufen soll, wenn ein Interrupt eintrifft. Dazu existiert die Definition (ein Makro) '''ISR'''. SIGNAL sollte nicht mehr genutzt werden, zur Portierung von SIGNAL nach ISR siehe Abschnitt (TODO: verlinken) im Anhang.


=== ISR ===

(''ISR()'' ersetzt bei neueren Versionen der avr-libc ''SIGNAL()''. vgl. Anhang (TODO:link))



<pre class="code">
#include <avr/interrupt.h>
...
ISR(Vectorname) /* vormals: SIGNAL(siglabel) dabei Vectorname != siglabel ! */
{
/* Interrupt Code */
}
</pre>

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.

<pre class="code">
[...]
/* $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)

[...]
</pre>


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

<pre class="code">
#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...
</pre>

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 Interuptroutinen ===

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



<pre class="code">
#include <avr/interrupt.h>
...
void XXX_vect(void) __attribute__((interrupt));
void XXX_vect(void) {
...
}
</pre>

Hierbei steht XXX für den oben beschriebenen Namen des Vektors (also z.B. ''void TIMER0_OVF_vect(void)...''). Der Unterschied im Vergleich zu ISR ist, dass bei hier beim Aufrufen der Funktion das '''Global Enable Interrupt''' Bit automatisch wieder gesetzt und somit weitere Interrupts zugelassen werden. Dies kann zu nicht unerheblichen Problemen von im einfachsten Fall einem Stack overflow bis zu sonstigen unerwarteten Effekten führen und sollte wirklich '''nur dann''' angewendet werden, wenn man sich absolut sicher ist, das Ganze auch im Griff zu haben. 

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.

<pre class="code">
#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 uebrigen
// Programmteile muessen 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" */
}
}
...
}
</pre>

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 ausserhalb der ISR nicht durch einen Interrupt unterbrochen werden. (Allgemeinplatz: AVRs sind 8-bit Controller). Zur Veranschaulichung ein Codefragment:

<pre class="code">
...
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 veraendert.
tmpCnt = gMyCounter16bit;

// besser: Aenderungen "ausserhalb" verhindern -> alle "Teilbytes"
// bleiben konsistent
cli(); // Interupts 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 */
...
}
</pre>

== 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:

<pre class="code">
#include <avr/io.h>

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

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

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

<pre class="code">
...
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)
...
</pre>

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 Unterbrechnungen 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 Unterbrechnungen. 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 ausserhalb dieses Adressbereichs ("Memory-Mapped"-Register) werden auch zur Manipulation einzelner Bits abhängige Anweisungen erzeugt (lds,...,sts).

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Frequently asked Questions/Fragen Nr. 1 und 8 (Stand: avr-libc Vers. 1.0.4)

== 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 ausserdem möglicherweise Probleme durch Interruptroutinen, die zu viel Verarbeitungszeit benötigen.

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

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Interrupts and Signals

= 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 [http://lightner.net/avr/ATtinyAvrGcc.html "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 und ATtiny26 der "tiny-Reihe" gelten die Ausführungen ebenfalls.

== 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.

== 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). 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.

<pre class="code">
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <inttypes.h>

...

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

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

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

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

void foo(void)
{
static /*const*/ uint8_t pgmTestByteLocal PROGMEM = 0x55;
static /*const*/ char pgmTestStringLocal[] PROGMEM = "im Flash";
...
</pre>

=== 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.

<pre class="code">
// 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....
}
</pre>

=== Wort lesen ===

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

<pre class="code">
uint16_t myWord;

myWord = pgm_read_word(&pgmFooWord);
</pre>

Zeiger auf Werte im Flash sind ebenfalls 16 Bits "gross" (Stand avr-gcc 3.4.x). Damit ist der mögliche Speicherbereich für "Flash-Konstanten" auf 64kB begrenzt. 

<pre class="code">
uint8_t *ptrToArray;

ptrToArray = (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 muß 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 = (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)
}
</pre>

=== Floats und Structs lesen ===

Um komplexe Datentypen (structs), nicht-integer Datentypen (floats) aus dem Flash auszulesen, sind Hilfsfunktionen erforderlich. Einige Beispiele:

<pre class="code">
/* Beispiel float aus Flash */

float pgmFloatArray[3] PROGMEM = {1.1, 2.2, 3.3};
...

/* liest float von Flash-Addresse addr und gibt diese als return-value zurueck */
inline float pgm_read_float(const float *addr)
{
union
{
uint16_t i[2]; // 2 16-bit-Worte
float f;
} u;

u.i[0]=pgm_read_word((PGM_P)addr);
u.i[1]=pgm_read_word((PGM_P)addr+2);

return u.f;
}
...

void egal(void)
{
int i;
float f;

for (i=0;i<3;i++) {
f = pgm_read_float(&pgmFloatArray[i]); // entspr. "f = pgmFloatArray[i];"
// mach' was mit f
}
}
</pre>

TODO: Beispiele fuer structs und pointer aus flash auf struct im flash (menues, state-machines etc.)

=== 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.

<pre class="code">
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <string.h>

#define MAXLEN 30

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

...
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 wuerde ausgefuehrt, die ersten 5 Zeichen stimmen ueberein
}
else {
// wuerde bei nicht-Uebereinstimmung ausgefuehrt
}
...
</pre>

Aber Vorsicht: Ersetzt man zum Beispiel
<pre class="code">
const char textImFlashOK[] PROGMEM = "mit[]";
// = Daten im "Flash", textImFlashOK* zeigt auf Flashadresse
</pre>
durch
<pre class="code">
const char* textImFlashProblem PROGMEM = "mit*";
// Konflikt: Daten im BSS (lies: RAM), textImFlashFAIL* zeigt auf Flashadresse
</pre>
dann kann es zu Problemen mit AVR-GCC kommen. Zu erkennen daran, dass der Initialisierungsstring von "textImFlashProblem" zu den Konstanten ans Ende des Programmcodes gelegt wird (BSS), von dem aus er zur Benutzung eigentlich ins RAM kopiert werden sollte (und wird). Da der lesende Code (mittels pgm_read*) trotzdem an einer Stelle vorne im Flash sucht, wird Unsinn gelesen. Dies scheint ein weiters Problem des AVR-GCC (gesehen bei avr-gcc 3.4.1 und 3.4.2) bei der Anpassung an die Harvard-Architektur zu sein (konstanter Pointer auf variable Daten?!). Abhilfe ("Workaround"): Initialisierung bei Zeichenketten mit [] oder gleich im Code PSTR("...") nutzen.

Übergibt man Zeichenketten (genauer: die Adresse des ersten Zeichens), die im Flash abglegt sind an eine Funktion, muss diese entsprechend programmiert sein. Die Funktion selbst hat keine Möglichkeit zu unterscheiden, ob es sich um eine Adresse im Flash oder im RAM 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 (oder _P) versehen sind.

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:

<pre class="code">
// 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 (wieauchimmmer.c)
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <string.h>
#include "lcd.h"

char StringImFlash[] PROGMEM = "Erwin Lindemann"; // im "Flash"

...
lcd_puts_p(StringImFlash);
lcd_puts_P("Dr. Kloebner");
// daraus wird wg. #define lcd_put_P...: lcd_puts_p( PSTR("Dr. Kloebner") );
...
</pre>

=== Flash in der Anwendung schreiben ===

Bei AVRs mit "self-programming"-Option (auch bekannt als Bootloader-Support) können Teile des Flash-Speichers auch vom Anwendungsprogramm selbst beschrieben werden. Dies ist nur möglich, wenn die Schreibfunktionen in einem besonderen Speicherbereich (boot-section) des Programmspeichers/Flash abgelegt sind. Bei wenigen "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.

=== 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 (einen Pointer, z.B. 0x01fe), "weiss" die Funktion nicht, ob die Adresse auf den Flash-Speicher oder den/das RAM zeigt. Allein aus dem Pointer-Wert (der Zahl) kann nicht geschlossen werden, ob ein "einfaches" zeichen_an_uart(s[i]) oder zeichen_an_uart(pgm_read_byte(&s[i]) genutzt werden muss, um das i-te Zeichen auszugeben.

Einige AVR-Compiler "tricksen" etwas, in dem sie für einen Pointer nicht nur die Adresse anlegen, sondern zusätzlich zu jedem Pointer den Ablageort (Flash oder RAM) intern sichern. Bei Aufruf einer Funktion wird dann bei Pointer-Parametern neben der Adresse auch der Speicherbereich, auf den der Pointer zeigt, übergeben. Dies hat jedoch nicht nur Vorteile; Erläuterungen warum dies so ist, führen an dieser Stelle zu weit.

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html 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ässig 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.

Der Compiler schreibt den aus der Variablendeklaration abgeleiteten EEPROM Inhalt in die eine Datei (.eep), die zusätzlich zum Flashen des Programms in den Mikrocontroller geschrieben werden muß. Sonst wird beim Lesen zufälliger Datenmüll zurückgegeben.

Bei der Deklaration einer Variable im EEPROM, ist das Attribut für die Section ".eeprom" zu ergänzen. 

<pre class="code">
#include <avr/io.h>
#include <avr/eeprom.h>
#include <avr/interrupt.h>
#include <inttypes.h> // wird in aktuellen Versionen der avr-lib mit xx.h eingebunden

// EEMEM wird bei aktuellen Versionen der avr-lib in eerpom.h definiert
// hier: definiere falls noch nicht bekannt ("alte" avr-libc)
#ifndef EEMEM
// alle Textstellen EEMEM im Quellcode durch __attribute__ ... ersetzen
#define EEMEM __attribute__ ((section (".eeprom")))
#endif

...

/* Byte */
uint8_t eeFooByte EEMEM = 123;

/* Wort */
uint16_t eeFooWord EEMEM = 12345;

/* float */
float eeFooFloat EEMEM;

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

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

=== Bytes lesen/schreiben ===

Die avr-libc Funktion zum Lesen eines Bytes heisst 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:

<pre class="code">
...
uint8_t myByte;

myByte = eeprom_read_byte(&eeFooByte); // lesen
// myByte hat nun den Wert 123
...
myByte = 99;
eeprom_write_byte(&eeFooByte, myByte); // schreiben
...
myByte = eeprom_read_byte(&eeFooByteArray1[1]);
// myByte hat nun den Wert 3
...
</pre>

=== Wort lesen/schreiben ===

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

<pre class="code">
...
uint16_t myWord;

myWord = eeprom_read_word(&eeFooWord); // lesen
// myWord hat nun den Wert 12345
...
myWord = 2222;
eeprom_write_word(&eeFooWord, myWord); // schreiben
...
</pre>

=== 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 (size_t).

TODO: '''Vorsicht!''' die folgenden Beispiele sind noch nicht geprueft, erstmal nur als Hinweis auf "das Prinzip". Evtl. fehlen "casts" und mglw. noch mehr.

<pre class="code">
...
uint8_t myByteBuffer[3];
uint16_t myWordBuffer[4];

/* Datenblock aus EEPROM LESEN */

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

/* dito etwas anschaulicher aber "unnuetze Tipparbeit": */
eeprom_read_block(&myByteBuffer[0],&eeFooByteArray[0],3);

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

/* und nun mit "16bit" */
eeprom_read_block(myWordBuffer,eeFooWordArray1,sizeof(myWordBuffer));

/* Datenlock in EEPROM SCHREIBEN */
eeprom_write_block(myByteBuffer,eeFooByteArray1,sizeof(myByteBuffer));
eeprom_write_block(myWordBuffer,eeFooWordArray1,sizeof(myWordBuffer));
...
</pre>

"Nicht-Integer"-Datentypen wie z.B. Fliesskommazahlen lassen sich recht praktisch über eine ''union'' in "Byte-Arrays" konvertieren und wieder "zurückwandeln". Dies erweist sich hier (aber nicht nur hier) als nützlich.

<pre class="code">
...
float myFloat = 12.34;

union {
float r;
uint8_t i[sizeof(float)];
} u;

u.r = myFloat;

/* float in EEPROM */
eeprom_write_block(&(u.i),&eeFooFloat,sizeof(float));

/* float aus EEPROM */
eeprom_read_block(&(u.i),&eeFooFloat,sizeof(float));
/* u.r wieder 12.34 */
...
</pre>

Auch zusammengesetzte Typen lassen sich mit den Block-Routinen verarbeiten.

<pre class="code">
...
typedef struct {
uint8_t label[8];
uint8_t rom_code[8];
} tMyStruct;

#define MAXSENSORS 3
tMyStruct eeMyStruct[MAXSENSORS] EEMEM;

...

void egal(void)
{
tMyStruct work;

strcpy(work.label,"Flur");
GetRomCode(work.rom_code); // Dummy zur Veranschaulichung - setzt rom-code

/* Sichern von "work" im EEPROM */
eeprom_write_block(&work,&eeMyStruct[0],sizeof(tMyStruct)); // f. Index 0
strcpy(work.label,"Bad");
GetRomCode(work.rom_code);
eeprom_write_block(&work,&eeMyStruct[1],sizeof(tMyStruct)); // f. Index 1
...
/* Lesen der Daten EEPROM Index 0 in "work" */
eeprom_read_block(&work,&eeMyStruct[0],sizeof(tMyStruct));
// work.label hat nun den Inhalt "Flur"
...
}
...
</pre>

=== EEPROM-Speicherabbild in .eep-Datei ===

Eine besondere Funktion des avr-gcc ist, dass mit entsprechenden Optionen im Makefile aus den Initialisierungswerten der Variablen im Quellcode eine Datei erzeugt werden kann, die man auf den Controller programmieren kann (.eep-Datei). Damit können sehr elegant Standardwerte für den EEPROM-Inhalt im Quellcode definiert werden. Die Vorgehensweise wird aus dem WinAVR-Beispielmakefile ersichtlich. Siehe dazu die Erläuterungen im Abschnitt Exkurs: Makefiles.

=== Bekannte Probleme bei den EEPROM-Funktionen ===

Vorsicht: Bei alten Versionen der avr-libc wurden nicht alle AVR Controller untersü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: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/EEPROM handling

= Die Nutzung von printf =

Um komfortabel Ausgaben auf ein Display oder die serielle Schnittstelle zu tätigen, bietet sich printf/sprintf an.
<pre class="code">
...
#include <stdio.h>
#include <stdint.h>

uint16_t counter;
uint8_t s[20];
...
sprintf( s, "Zählerstand: %d", counter);
LCDSoftText( s, x, y);
...
</pre>

Die Funktion LCDSoftText muss natürlich dafür sorgen, dass die Zeichenkette auf das Display kommt.

Eine weitere elegante Möglichkeit, bietet sich darin, die Ausgabe stdout auf eigene Funktionen umzubiegen:
<pre class="code">
#include <stdio.h>
static int uart_putchar(char c, FILE *stream);
static FILE mystdout = FDEV_SETUP_STREAM(uart_putchar, NULL,
_FDEV_SETUP_WRITE);
static int
uart_putchar(char c, FILE *stream)
{
if (c == ?\n?)
uart_putchar(?\r?);
loop_until_bit_is_set(UCSRA, UDRE);
UDR = c;
return 0;
}

int
main(void)
{
init_uart();
stdout = &mystdout;
printf("Hello, world!\n");
return 0;
}
</pre>
(Quelle: avr-libc-user-manual-1.4.3.pdf, S.74)

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

Der Nachteil aller printf-Varianten: sie sind recht speicherintensiv.

= Assembler und Inline-Assembler =

Gelegentlich erweist es sich als nützlich, C und Assembler-Code in einer Anwendung zu nutzen. Typischerweise wird das Hauptprogramm in C verfasst und wenige, extrem zeitkritische oder hardwarenahe Operationen in Assembler.

Die "gnu-Toolchain" bietet dazu zwei Möglichkeiten:

; Inline-Assembler : Die Assembleranweisungen werden direkt in den C-Code integriert. Eine Quellcode-Datei enthält somit C- und Assembleranweisungen

; Assembler-Dateien : Der Assembler-Codecode befindet sich in eigenen Quellcodedateien. Diese werden vom gnu-Assembler (avr-as) zu Object-Dateien assembliert ("compiliert") und mit den aus dem C-Code erstellten Object-Dateien zusammengebunden (gelinkt).

== Inline-Assembler ==

Inline-Assembler bietet sich an, wenn nur wenig Assembleranweisungen benötigt werden. Typische Anwendung sind kurze Codesequenzen für zeitkritische Operationen in Interrupt-Routinen oder sehr präzise Warteschleifen (z.B. 1-Wire). Inline-Assembler wird mit '''asm volatile''' eingeleitet, die Assembler-Anweisungen werden in einer Zeichenkette zusammengefasst, die als "Parameter" übergeben wird. Durch Doppelpunkte getrennt werden die Ein- und Ausgaben sowie die "Clobber-Liste" angegeben.

Ein einfaches Beispiel für Inline-Assembler ist das Einfügen einer NOP-Anweisung (NOP steht für No Operation). Dieser Assembler-Befehl benötigt genau einen Taktzyklus, ansonsten "tut sich nichts". Sinnvolle Anwendungen für NOP sind genaue Delay(=Warte)-Funktionen.

<pre class="code">
...
/* Verzoegern der weiteren Programmausfuehrung um
genau 3 Taktzyklen */
asm volatile ("nop");
asm volatile ("nop");
asm volatile ("nop");
...
</pre>

Weiterhin kann mit einem NOP verhindert werden, dass leere Schleifen, die als Warteschleifen gedacht sind, wegoptimiert werden. Der Compiler erkennt ansonsten die vermeindlich nutzlose Schleife und erzeugt dafür keinen Code im ausführbaren Programm.

<pre class="code">
...
uint16_t i;

/* leere Schleife - wird bei eingeschalteter Compiler-Optimierung wegoptimiert */
for (i=0;i<1000;i++);

...

/* Schleife erzwingen (keine Optimierung): "NOP-Methode" */
for (i=0;i<1000;i++) asm volatile("NOP");

...

/* alternative Methode (keine Optimierung): */
volatile uint16_t j;
for (j=0;j<1000;j++);
</pre>

Ein weiterer nützlicher "Assembler-Einzeiler" ist der Aufruf von sleep (''asm volatile ("sleep");''), da hierzu keine eigene Funktion in der avr-libc existiert.

Als Beispiel für mehrzeiligen Inline-Assembler eine präzise Delay-Funktion. Die Funktion erhält ein 16-bit Wort als Parameter, prüft den Parameter auf 0 und beendet die Funktion in diesem Fall oder durchläuft die folgende Schleife sooft wie im Wert des Parameters angegeben. Inline-Assembler hat hier den Vorteil, dass die Laufzeit unabhängig von der Optimierungsstufe (Parameter -O, vgl. makefile) und der Compiler-Version ist.

<pre class="code">
static inline void delayloop16 (uint16_t count)
{
asm volatile ("cp %A0, __zero_reg__ \n\t"
"cpc %B0, __zero_reg__ \n\t"
"breq 2f \n\t"
"1: \n\t"
"sbiw %0,1 \n\t"
"brne 1b \n\t"
"2: "
: "=w" (count)
: "0" (count)
);
}
</pre>

* Jede Anweisung wird mit '''\n\t''' abgeschlossen. Der Zeilenumbruch teilt dem Assembler mit, daß ein neuer Befehl beginnt.
* Als Sprung-Marken (Labels) werden Ziffern verwendet. Diese speziellen Labels sind mehrfach im Code verwendbar. Gesprungen wird jeweils zurück (b) oder vorwärts (f) zum nächsten ausffindbaren Label.

Das Resultat zeigt ein Blick in die Assembler-Datei, die der Compiler mit der option <tt>-save-temps</tt> nicht löscht:
<pre class="code">
cp r24, __zero_reg__ ; count
cpc r25, __zero_reg__ ; count
breq 2f
1:
sbiw r24,1 ; count
brne 1b
2:
</pre>

Detaillierte Ausführungen zum Thema Inline-Assembler finden sich in der Dokumentation der avr-libc im Abschnitt [http://www.nongnu.org/avr-libc/user-manual/inline_asm.html Related Pages/Inline Asm].

Siehe auch:
*[http://www.atmel.com/dyn/resources/prod_documents/doc0856.pdf AVR Assembler-Anweisungsliste]
*[http://www.roboternetz.de/wissen/index.php/Inline-Assembler_in_avr-gcc Deutsche Einführung in Inline-Assembler]

== Assembler-Dateien ==

Assembler-Dateien erhalten die Endung .S (''grosses'' S) und werden im makefile nach WinAVR/mfile-Vorlage hinter ''ASRC='' durch Leerzeichen getrennt aufgelistet.

Im Beispiel eine Funktion ''superFunc'' die alle Pins des Ports D auf "Ausgang" schaltet, eine Funktion ''ultraFunc'', die die Ausgänge entsprechend des übergebenen Parameters schaltet, eine Funktion ''gigaFunc'', die den Status von Port A zurückgibt und eine Funktion ''addFunc'', die zwei Bytes zu einem 16-bit-Wort addiert. Die Zuweisungen im C-Code (PORTx = ) verhindern, dass der Compiler die Aufrufe wegoptimiert und dienen nur zur Veranschaulichung der Parameterübergaben.

Zuerst der Assembler-Code. Der Dateiname sei useful.S:

<pre class="code">
#include "avr/io.h"

// Arbeitsregister (ohne "r")
workreg = 16
workreg2 = 17

// Konstante:
ALLOUT = 0xff

// ** Setze alle Pins von PortD auf Ausgang **
// keine Parameter, keine Rueckgabe
.global superFunc
.func superFunc
superFunc:
push workreg
ldi workreg, ALLOUT
out _SFR_IO_ADDR(DDRD), workreg // beachte: _SFR_IO_ADDR()
pop workreg
ret
.endfunc

// ** Setze PORTD auf uebergebenen Wert **
// Parameter in r24 (LSB immer bei "graden" Nummern)
.global ultraFunc
.func ultraFunc
ultraFunc:
out _SFR_IO_ADDR(PORTD), 24
ret
.endfunc

// ** Zustand von PINA zurueckgeben **
// Rueckgabewerte in r24:r25 (LSB:MSB), hier nur LSB genutzt
.global gigaFunc
.func gigaFunc
gigaFunc:
in 24, _SFR_IO_ADDR(PINA)
ret
.endfunc

// ** Zwei Bytes addieren und 16-bit-Wort zurueckgeben **
// Parameter in r24 (Summand1) und r22 (Summand2) -
// Parameter sind Word-"aligned" d.h. LSB immer auf "graden"
// Registernummern. Bei 8-Bit und 16-Bit Paramtern somit
// beginnend bei r24 dann r22 dann r20 etc.
// Rueckgabewert in r24:r25
.global addFunc
.func addFunc
addFunc:
push workreg
push workreg2
clr workreg2
mov workreg, 22
add workreg, 24
adc workreg2, 1 // r1 - assumed to be always zero ...
movw r24, workreg
pop workreg2
pop workreg
ret
.endfunc

// oh je - sorry - Mein AVR-Assembler ist eingerostet, hoffe das stimmt so...

.end

</pre>

Im Makefile ist der Name der Assembler-Quellcodedatei einzutragen:

<pre class="code">
ASRC = useful.S
</pre>

Der Aufruf erfolgt dann im C-Code so:

<pre class="code">
extern void superFunc(void);
extern void ultraFunc(uint8_t setVal);
extern uint8_t gigaFunc(void);
extern uint16_t addFunc(uint8_t w1, uint8_t w2);

int main(void)
{
[...]
superFunc();

ultraFunc(0x55);

PORTD = gigaFunc();

PORTA = (addFunc(0xF0, 0x11) & 0xff);
PORTB = (addFunc(0xF0, 0x11) >> 8);
[...]
}
</pre>

Das Ergebnis wird wieder in der lss-Datei ersichtlich:

<pre class="code">
[...]
superFunc();
148: 0e 94 f6 00 call 0x1ec

ultraFunc(0x55);
14c: 85 e5 ldi r24, 0x55 ; 85
14e: 0e 94 fb 00 call 0x1f6

PORTD = gigaFunc();
152: 0e 94 fd 00 call 0x1fa
156: 82 bb out 0x12, r24 ; 18

PORTA = (addFunc(0xF0, 0x11) & 0xff);
158: 61 e1 ldi r22, 0x11 ; 17
15a: 80 ef ldi r24, 0xF0 ; 240
15c: 0e 94 ff 00 call 0x1fe
160: 8b bb out 0x1b, r24 ; 27
PORTB = (addFunc(0xF0, 0x11) >> 8);
162: 61 e1 ldi r22, 0x11 ; 17
164: 80 ef ldi r24, 0xF0 ; 240
166: 0e 94 fc 00 call 0x1f8
16a: 89 2f mov r24, r25
16c: 99 27 eor r25, r25
16e: 88 bb out 0x18, r24 ; 24

[...]
000001ec <superFunc>:
// setze alle Pins von PortD auf Ausgang
.global superFunc
.func superFunc
superFunc:
push workreg
1ec: 0f 93 push r16
ldi workreg, ALLOUT
1ee: 0f ef ldi r16, 0xFF ; 255
out _SFR_IO_ADDR(DDRD), workreg
1f0: 01 bb out 0x11, r16 ; 17
pop workreg
1f2: 0f 91 pop r16
ret
1f4: 08 95 ret

000001f6 <ultraFunc>:
.endfunc

// setze PORTD auf uebergebenen Wert
.global ultraFunc
.func ultraFunc
ultraFunc:
out _SFR_IO_ADDR(PORTD), 24
1f6: 82 bb out 0x12, r24 ; 18
ret
1f8: 08 95 ret

000001fa <gigaFunc>:
.endfunc

// Zustand von PINA zurueckgeben
.global gigaFunc
.func gigaFunc
gigaFunc:
in 24, _SFR_IO_ADDR(PINA)
1fa: 89 b3 in r24, 0x19 ; 25
ret
1fc: 08 95 ret

000001fe <addFunc>:
.endfunc

// zwei Bytes addieren und 16-bit-Wort zurueckgeben
.global addFunc
.func addFunc
addFunc:
push workreg
1fe: 0f 93 push r16
push workreg2
200: 1f 93 push r17
clr workreg2
202: 11 27 eor r17, r17
mov workreg, 22
204: 06 2f mov r16, r22
add workreg, 24
206: 08 0f add r16, r24
adc workreg2, 1 // r1 - assumed to be always zero ...
208: 11 1d adc r17, r1
movw r24, workreg
20a: c8 01 movw r24, r16
pop workreg2
20c: 1f 91 pop r17
pop workreg
20e: 0f 91 pop r16
ret
210: 08 95 ret

[...]
</pre>

Die Zuweisung von Registern zu Parameternummer und die Register für die Rückgabewerte sind in den "Register Usage Guidelines" der avr-libc-Dokumentation erläutert.

Siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/assembler.html avr-libc-Dokumentation: Related Pages/avr-libc and assembler programs]
* [http://www.nongnu.org/avr-libc/user-manual/FAQ.html#faq_reg_usage avr-libc-Dokumentation: Related Pages/FAQ/"What registers are used by the C compiler?"]

== Globale Variablen für Datenaustausch ==

Oftmals kommt man um globale Variablen nicht herum, z.B. um den Datenaustausch zwischen Hauptprogramm und Interrupt-Routinen zu realisieren.
Hierzu muß man im Assembler wissen, wo genau die Variable vom C-Compiler abgespeichert wird.

Hierzu muß die Variable, hier "zaehler" genannt, zuerst im C-Code als Global definiert werden, z.B. so:

<pre class = "code">

#include <avr/io.h>

volatile uint8_t zaehler;

int16_t main (void)
{
// irgendein Code, in dem zaehler benutzt werden kann

}
</pre>

Im foldenden Assembler-Beispiel wird der Externe Interrupt0 verwendet, um den Zähler hochzuzählen. Es fehlen die Initialisierungen des Interrupts und die Interrupt-Freigabe, so richtig sinnvoll ist der Code auch nicht, aber er zeigt (hoffentlich) wie es geht.
Im Umgang mit Interrupt-Vektoren gilt beim GCC-Assembler das Gleiche, wie bei C: Man muß die exakte Schreibweise beachten, ansonsten wird nicht der Interrupt-Vektor angelegt, sondern eine neue Funktion - und man wundert sich, daß nichts funktionert (vgl. das AVR-GCC Handbuch).

<pre class = "code">

#include "avr/io.h"

temp = 16

.extern zaehler

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

push temp // wichtig: Benutzte Register und das
in temp,_SFR_IO_ADDR(SREG) // Status-Register (SREG) sichern !
push temp

lds temp,zaehler // Wert aus dem Speicher lesen
inc temp // bearbeiten
sts zaehler,temp // und wieder zurückschreiben

pop temp // die benutzten Register wiederherstellen
out _SFR_IO_ADDR(SREG),temp
pop temp
reti

.end

</pre>

=== Globale Variablen im Assemblerfile anlegen ===

Alternativ können Variablen aber auch im Assemblerfile angelegt werden. Dadurch kann auf eine .c-Datei verzichtet werden. Für das obige Beispiel könnte der Quelltext dann die Dateien zaehl_asm.S und zaehl_asm.h abgelegt werden, so dass nur noch zaehl_asm.S mit kompiliert werden müsste.

Anstatt im Assemblerfile über das Schlüsselwort ''.extern '' auf eine vorhandene Variable zu verweisen, wird dazu mit dem Schlüsselwort ''.comm'' die benötigte Anzahl von Bytes für eine Variable reserviert.

'''zaehl_asm.S'''
<pre class = "code">

#include "avr/io.h"

temp = 16

// 1 Byte im RAM für den Zähler reservieren
.comm zaehler, 1

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

...

</pre>

In der Headerdatei wird dann auf die Variable nur noch verwiesen (Schlüsselwort ''extern''):

'''zaehl_asm.h'''
<pre class = "code">
#ifndef ZAEHL_ASM_H
#define ZAEHL_ASM_H

extern volatile uint8_t zaehler;

#endif
</pre>

Im Gegensatz zu globalen Variablen in C werden so angelegte Variablen nicht automatisch mit dem Wert 0 initialisiert.

=== Variablen größer als 1 Byte ===

Variablen, die größer als ein Byte sind, können in Assembler auf ähnliche Art angesprochen werden. Hierzu müssen nur genug Bytes angefordert werden, um die Variable aufzunehmen. Soll z.B. für den Zähler eine Variable vom Typ ''unsigned long'', also ''uint32_t'' verwendet werden, so müssen 4 Bytes reserviert werden:

<pre class = "code">
...
// 4 Byte im RAM für den Zähler reservieren
.comm zaehler, 4
...
</pre>

Die dazugehörige Deklaration im Headerfile wäre dann:
<pre class = "code">
...
extern volatile uint32_t zaehler;
...
</pre>

Bei Variablen, die größer als ein Byte sind, werden die Werte beginnend mit dem niederwertigsten Byte im RAM abgelegt. Das folgende Codeschnippsel zeigt, wie unter Assembler auf die einzelnen Bytes zugegriffen werden kann. Dazu wird im Interrupt nun ein 32-Bit Zähler erhöht:
<pre class = "code">
#include "avr/io.h"

temp = 16

// 4 Byte im RAM für den Zähler reservieren
.comm zaehler, 4

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

push temp // wichtig: Benutzte Register und das
in temp,_SFR_IO_ADDR(SREG) // Status-Register (SREG) sichern !
push temp

// 32-Bit-Zähler incrementieren
lds temp, (zaehler + 0) // 0. Byte (niederwertigstes Byte)
inc temp
sts (zaehler + 0), temp
brne RAUS

lds temp, (zaehler + 1) // 1. Byte
inc temp
sts (zaehler + 1), temp
brne RAUS

lds temp, (zaehler + 2) // 2. Byte
inc temp
sts (zaehler + 2), temp
brne RAUS

lds temp, (zaehler + 3) // 3. Byte (höchstwertigstes Byte)
inc temp
sts (zaehler + 3), temp
brne RAUS

RAUS:
pop temp // die benutzten Register wiederherstellen
out _SFR_IO_ADDR(SREG),temp
pop temp
reti

.end

</pre>

'''TODO:''' 16-Bit / 32-Bit Variablen, Zugriff auf Arrays (Strings)

= Anhang =

== Besonderheiten bei der Anpassung bestehenden Quellcodes ==

Einige Funktionen, die in frühren Versionen der avr-libc vorhanden waren, werden inzwischen als veraltet angesehen. Sie sind nicht mehr vorhanden oder als ''deprecated'' (abgelehnt) ausgewiesen. Es empfiehlt sich, vorhandenen Code zu portieren und die alten Funktionen nicht mehr zu nutzen, auch wenn diese noch zur Verfügung stehen.

=== Veraltete Funktionen zur Deklaration von Interrupt-Routinen ===

Die Funktionen (eigentlich Makros) ''SIGNAL'' und ''INTERRUPT'' zur Deklaration von Interruptroutinen sollten nicht mehr genutzt werden.

In aktuellen Versionen der avr-libc (z.B. avr-libc 1.4.3 aus WinAVR 20060125) werden Interruptroutinen, die '''nicht''' durch andere Interrupts '''unterbrechbar''' sind, mit ISR deklariert (siehe Abschnitt im Hauptteil). Auch die Benennung wurden vereinheitlicht und an die üblichen Bezeichnungen in den AVR Datenblättern angepasst. In der Dokumentation der avr-libc sind alte und neue Bezeichnungen in der Tabelle gegenübergestellt. Die erforderlichen Schritte zur Portierung:

* #include von avr/signal.h entfernen
* SIGNAL duch ISR ersetzen
* Name des Interrupt-Vektors anpassen (SIG_* durch entsprechendes *_vect)

Ein Beispiel für die Anpassung zuerst ein "alter" Code:

<pre class="code">
#include <avr/interrupt.h>
#include <avr/signal.h>

...

/* Timer2 Output Compare bei einem ATmega8 */
SIGNAL(SIG_OUTPUT_COMPARE2)
{
...
}
</pre>

Im Datenblatt wird der Vektor mit TIMER2 COMP bezeichnet. Die Bezeichnung in der avr-libc entspricht dem Namen im Datenblatt, Leerzeichen werden durch Unterstriche (_) ersetzt und ein _vect angehängt.

Der neue Code sieht dann so aus:

<pre class="code">
#include <avr/interrupt.h>
/* signal.h entfällt */

ISR(TIMER2_COMP_vect)
{
...
}
</pre>

Bei Unklarheiten bezüglich der neuen Vektorlabels hilft (noch) ein Blick in die Headerdatei des entspechenden Controllers. Für das vorherige Beispiel also der Blick in die Datei iom8.h für den ATmega8, dort findet man die veraltete Bezeichnung unterhalb der aktuellen.

<pre class="code">
...
/* Timer/Counter2 Compare Match */
#define TIMER2_COMP_vect _VECTOR(3)
#define SIG_OUTPUT_COMPARE2 _VECTOR(3)
...
</pre>

Konnte in alten Versionen signal.h ohne interrupt.h eingebunden werden, erhält man bei Verwendung der avr-libc Version 1.4.3 (WinAVR 2/2005) beim Compilieren eine Fehlermeldung, da mit signal.h nicht die erforderlichen Definitionen eingebunden werden. Der Lösungsvorschlag in signal.h auch interrupt.h einzubinden, wurde von den avr-libc-Enwicklern akzeptiert und das Problem ist im Quellcode (CVS) bereits behoben. Es is aber noch keine avr-libc-"Release" bzw. noch kein WinAVR mit dieser avr-libc-Korrektur verfuegbar (Stand 5.2.2006). Will oder kann man den Quellcode nicht aktualisieren, gibt es folgende Alternativen:
* in Quellcodedateien, in denen nur avr/signal.h eingebunden wird, interrupt.h einbinden (''#include <avr/interrupt.h>''). signal.h weiterhin einbinden, falls Kompatibiltät mit alten Versionen gewünscht ist.
* in der Datei signal.h (bein WinAVR in c:/WinAVR/avr/include/avr/signal.h) ein (''#include <avr/interrupt.h>'') ergänzen

Für '''unterbrechbare''' Interruptroutinen, die mittels ''INTERRUPT'' deklariert sind, gibt es keinen direkten Ersatz in Form eines Makros. Die Routinen sind lt. Dokumentation der avr-libc in folgender Form zu Deklarieren unterbrechbarer Interrupt-Handler:

<pre class="code">
void XXX_vect(void) __attribute__((interrupt));
void XXX_vect(void) {
...
}
</pre>

Beispiel:

<pre class="code">
#include <avr/interrupt.h>

// alt:
INTERRUPT(SIG_OVERFLOW0)
{
...
}

// neu:
void TIMER0_OVF_vect(void) __attribute__((interrupt));
void TIMER0_OVF_vect(void)
{
...
}
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von ''INTERRUPT'' die Header-Datei ''compat/deprecated.h'' einzubinden. Man sollte bei dieser Gelegenheit jedoch nochmals überprüfen, ob die Funktionalität von ''INTERRUPT'' tatsächlich gewollt ist. In vielen Fällen wurde ''INTTERRUPT'' dort genutzt, wo eigentlich ''SIGNAL'' (nunmehr ''ISR'') hätte genutzt werden sollen.

=== Veraltete Funktionen zum Portzugriff ===

''inp'' und ''outp'' zum Einlesen bzw. Schreiben von Registern sind nicht mehr erforderlich, der Compiler unterstützt dies ohne diesen Umweg.

<pre class="code">
unsigned char i, j;

// alt:
i = inp(PINA);
j = 0xff;
outp(PORTB, j);

// neu (nicht mehr wirklich neu...):
i = PINA
j = 0xff;
PORTB = j;
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von inp und outp die Header-Datei '''compat/deprecated.h''' einzubinden.

=== Veraltete Funktionen zum Zugriff auf Bits in Registern ===

''cbi'' und ''sbi'' zum Löschen und Setzen von Bits sind nicht mehr erforderlich, der Compiler unterstützt dies ohne diesen Umweg. Die Bezeichnung ist ohnehin irreführend da die Funktionen nur für Register mit Adressen im unteren Speicherbereich tatsächlich in die Assembleranweisungen cbi und sbi übersetzt werden.

<pre class="code">
// alt:
sbi(PORTB, PB2);
cbi(PORTC, PC1);

// neu (auch nicht mehr wirklich neu...):
PORTB |= (1<<PB2);
PORTC &= ~(1<<PC1);
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von sbi und cbi die Header-Datei '''compat/deprecated.h''' einzubinden. Wer unbedingt will, kann sich natürlich eigene Makros mit aussagekräftigeren Namen definieren. Zum Beispiel:

<pre class="code">
#define SET_BIT(PORT, BITNUM) ((PORT) |= (1<<(BITNUM)))
#define CLEAR_BIT(PORT, BITNUM) ((PORT) &= ~(1<<(BITNUM)))
#define TOOGLE_BIT(PORT, BITNUM) ((PORT) ^= (1<<(BITNUM)))
</pre>

== Externe Referenzspannung des internen Analog-Digital-Wandlers ==

Die minimale (externe) Referenzspannung des ADC darf nicht beliebig niedrig sein, vlg. dazu das (aktuellste) Datenblatt des verwendeten Controllers. z.B. beim ATMEGA8 darf sie lt. 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.)

= TODO =
* fuse-bits im make file
* Assembler-Dateien/Datenaustausch auf neue Vectornamen anpassen SIG_->_vect
* stdio.h, malloc() ???
* Code-Optimierungen ("tricks")
* "naked"-Functionen ??
* IO-Register als Parameter/"Variablen" (volatile uint8_t *mybusport; mybusport=&PORTB; void sendbus(uint8_t *parm)...)
* JTAG?
* SPI ?
* I²C Bus
* LC-Display ansteuern
* Software USB
* Bootloader

AVR-GCC-Tutorial

2006-05-30T09:38:21Z

129.247.247.238: /* Schreiben eines I/O-Registers */

[[Category:AVR]]

= Vorwort =

Dieses Tutorial soll den Einstieg in die Programmierung von Atmel [[AVR]]-Mikrocontroller in der Programmiersprache [[C]] mit dem freien ("kostenlosen") C-Compiler avr-gcc erleichtern.

Die ursprüngliche Version stammt von Christian Schifferle, viele neue Abschnitte und aktuelle Anpassungen von Martin Thomas. Viele der im Original-Dokument verwendeten Funktionen sind in aktuellen Versionen des [[AVR-GCC|avr-gcc]] C-Compilers und der Laufzeitbibliothek avr-libc nicht mehr enthalten oder sollen nicht mehr genutzt werden. Dieses Tutorial wurde an die neuen Funktionen/Methoden angepasst.

Die Erläuterungen und Beispiele beziehen sich auf die Versionen 3.4.5 des avr-gcc-Compiler und 1.4.3 der avr-libc, so wie sie in WinAVR 20060125 enthalten sind. Die Unterschiede zu älternen Versionen werden im Haupttext und Anhang zwar erläutert, Anfängern sei jedoch empfohlen, die aktuellen Versionen zu nutzen.

In diesem Text wird häufig auf die Standardbibliothek für den avr-gcc-Compiler, die avr-libc, verwiesen. Die online-Version der '''avr-libc Dokumentation''' findet sich [http://www.nongnu.org/avr-libc/user-manual/index.html hier]. Bei [[WinAVR]] gehört die Dokumentation zum Lieferumfang und wird mitinstalliert.

Eine Version als PDF zum Ausdrucken ist hier erhältlich (nicht immer auf aktuellem Stand): http://www.siwawi.arubi.uni-kl.de/avr_projects/AVR-GCC-Tutorial_-_www_mikrocontroller_net.pdf

= 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:

* Testboard 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 Testplattform sind auch das [[STK500]] und der [[AVR Butterfly]] von Atmel.[[http://www.mikrocontroller.net/articles/AVR#Starterkits |mehr..]
* 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]].
* Programmiersoftware und -[[AVR In System Programmer |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 Abschnitt [[AVR-GCC-Tutorial#Exkurs: makefiles|Exkurs: makefiles]]).

= Was tun, wenn's nicht "klappt"? =

* Herausfinden, ob es tatsächlich ein avr(-gcc) spezifisches Problem ist oder die 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.
*[[AVR Checkliste]]
* Die [http://www.nongnu.org/avr-libc/user-manual/index.html 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 [http://www.mikrocontroller.net www.mikrocontroller.net] nach vergleichbaren Problemen absuchen.
* Das avr-gcc-Forum bei [http://www.avrfreaks.net avrfreaks] nach vergleichbaren Problemen absuchen.
* Das [http://lists.gnu.org/archive/html/avr-gcc-list/ Archiv der avr-gcc Mailing-Liste] nach vergleichbaren Problemen absuchen.
* Nach Beispielcode suchen. Vor allem in der Academy von [http://www.avrfreaks.net AVRFREAKS] (anmelden).
* Google oder alltheweb befragen schadet nie.
* Bei Problemen mit der Ansteuerung interner AVR-Funktionen mit C-Code: das Datenblatt des Controllers lesen (ganz und am Besten zweimal)
* 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, genaue Fehlermeldungen bzw. Beschreibung des Fehlverhaltens. Bei Ansteuerung externer Geräte die Beschaltung beschreiben oder skizzieren (z.B. mit [http://www.tech-chat.de/ Andys ASCII Circuit]). Siehe dazu auch: [http://www.lugbz.org/documents/smart-questions_de.html "Wie man Fragen stellt"].

= Erzeugen von Maschinencode =

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

* Die Verwendung einer Integrierten Enwicklungsumgebung (IDE), bei der alle Einstellungen z.B. in Dialogboxen durchgeführt werden können. Unter Anderen kann AVRStudio ab Version 4.12 (kostenlos bei atmel.com) zusammen mit WinAVR als intergrierte Entwicklungsumgebung für den Compiler avr-gcc genutzt werden (dazu muessen AVRStudio und WinAVR auf dem Rechner installiert sein). Weitere IDEs fuer den avr-gcc (ohne Anspruch auf Vollständigkeit): AtmanAvr C (relativ günstig), KamAVR (kostenlos) VMLab (ab Version 3.12 ebenfalls kostenlos).

* Die Nutzung des Programms make mit passenden Makefiles.

Integrierte Enwicklungsumgebungen 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 Nutzung des avr-gcc Compilers mit IDEs sei hier auf deren Dokumentation verwiesen.

Im folgenden Abschnitt wird die Generierung von Maschinencode ("hex-Datei") für einen AVR aus C-Quellcode ("c-Dateien") anhand der universellen und plattformunabhänigen Vorgehensweise mittels make und 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 Projectverzeichnisses). Beim Wechsel vom makefile-Ansatz nach WinAVR-Vorlage zu AVRStudio ist darauf zu achten, dass AVRStudio (Stand: AVRStudio Version 4.12SP1) bei einem neuen Projekt die Optimierungsoption (vgl. nächster Abschnitt, typisch: -Os) nicht einstellt und die mathematische Bibliothek der avr-libc (libm.a, Linker-Option -lm) nicht einbindet. 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.

= Exkurs: Makefiles =

Wenn man bisher gewohnt ist, mit integrierten Entwicklungsumgebung à la Visual-C Programme zu erstellen, wirkt das makefile-Konzept auf den ersten Blick etwas kryptisch. Nach kurzer Einarbeitung ist diese Vorgehensweise jedoch sehr praktisch. Diese Dateien (üblicher Name: 'Makefile' ohne Dateiendung) dienen der Ablaufsteuerung des Programms make, das auf allen Unix/Linux-Systemen installiert sein sollte, und in einer Fassung fuer MS-Windows auch in [[WinAVR]] (Unterverzeichnis utils/bin) enthalten ist.

Im Unterverzeichnis ''sample'' einer WinAVR-Installation findet man eine sehr brauchbare Vorlage, die sich einfach an das eigene Projekt anpassen lässt ([[Media:Makefile|lokale Kopie Stand Sept. 2004]]). Wahlweise kann man auch [http://www.sax.de/~joerg/mfile/ mfile] von Jörg Wunsch nutzen. mfile erzeugt ein makefile nach Einstellungen in einer grafischen Nutzeroberfläche, wird bei WinAVR mitinstalliert, ist aber als TCL/TK-Programm auf nahezu allen Plattformen lauffähig.

''Die folgenden Ausführungen beziehen sich auf das WinAVR Beispiel-Makefile.''

Ist im Makefile alles richtig eingestellt genügt es, sich drei Parameter zu merken, die über die shell bzw. die Windows-Kommandozeile (cmd.exe/command.com) als Parameter an "make" übergeben werden. Das Programm make sucht sich "automatisch" das Makefile im aktuellen Arbeitsverzeichnis und führt die darin definierten Operationen für den entsprechenden Aufrufparameter durch.

{| border=1
| ''make all''
| Erstellt aus den im Makefile angegebenen Quellcodes eine ''hex''-Datei (und ggf. auch ''eep''-Datei).
|-
| ''make program''
| Überträgt die hex-Datei (und wahlweise auch die eep-Datei für den EEPROM) zum AVR.
|-
| ''make clean''
| löscht alle temporären Dateien, also auch die hex-Datei
|}

Diese Aufrufe können in die allermeisten Editoren in "Tool-Menüs" eingebunden werden. Dies erspart den Kontakt mit der Kommandozeile. (Bei WinAVR sind die Aufrufe bereits im Tools-Menü des mitgelieferten Editors Programmers-Notepad eingefügt.)

Üblicherweise sind folgende Daten im Makefile anzupassen:
* Controllertyp
* Quellcode-Dateien (c-Dateien)
* Typ und Anschluss des Programmiergeräts

seltener sind folgende Einstellungen durchzuführen:
* Grad der Optimierung
* Methode zur Erzeugung der Debug-Symbole (Debug-Format)
* Assembler-Quellcode-Dateien (S-Dateien)

Die in den folgenden Unterabschnitten gezeigten Makefile-Ausschnitte sind für ein Programm, das auf einem ATmega8 ausgeführt werden soll. Der Quellcode besteht aus den c-Dateien superprog.c (darin main()), uart.c, lcd.c und 1wire.c. Im Quellcodeverzeichnis befinden sich diese Dateien: superprog.c, uart.h, uart.c, lcd.h, lcd.c, 1wire.h, 1wire.c und das makefile (die angepasste Kopie des WinAVR-Beispiels).

Der Controller wird mittels [[AVRDUDE]] über ein [[STK200]]-Programmierdongle an der Schnittstelle lpt1 (bzw. /dev/lp0) programmiert. Im Quellcode sind auch Daten für die ''section .eeprom'' definiert (siehe Abschnitt [[AVR-GCC-Tutorial#EEPROM|Speicherzugriffe]]), diese sollen beim Programmieren gleich mit ins EEPROM geschrieben werden.

== Controllertyp setzen ==

Dazu wird die "make-Variable" MCU entsprechend dem Namen des verwendeten Controllers gesetzt. Ein Liste der von avr-gcc und der avr-libc untersützten Typen findet sich in der [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc].

<pre class="code">
# Kommentare in Makefiles beginnen mit einem Doppelkreuz
...

# ATmega8 at work
MCU = atmega8
# oder MCU = atmega16
# oder MCU = at90s8535
# oder ...
...
</pre>

== Quellcode-Dateien einstellen ==

Den Namen der Quellcodedatei welche die Funktion main enthält, wird hinter TARGET eingetragen. Dies jedoch ohne die Endung ''.c''.

<pre class="code">
...
TARGET = superprog
...
</pre>

Besteht das Projekt wie im Beispiel aus mehr als einer Quellcodedatei, sind die weiteren c-Dateien (nicht die Header-Dateien, vgl. [[Include-Files (C)]]) durch Leerzeichen getrennt bei SRC einzutragen. Die bei TARGET definierte Datei ist schon in der SRC-Liste enthalten. Diesen Eintrag nicht löschen!

<pre class="code">
...
SRC = $(TARGET).c uart.c lcd.c 1wire.c
...
</pre>

Alternativ kann man die Liste der Quellcodedateien auch mit dem Operator += erweitern.

<pre class="code">
SRC = $(TARGET).c uart.c 1wire.c
# lcd-Code fuer Controller xyz123 (auskommentiert)
# SRC += lcd_xyz.c
# lcd-Code fuer "Standard-Controller" (genutzt)
SRC += lcd.c
</pre>

== Programmiergerät einstellen ==

Die Vorlagen sind auf die Programmiersoftware [[AVRDUDE]] angepasst, jedoch lässt sich auch andere Programmiersoftware einbinden, sofern diese über Kommandozeile gesteuert werden kann (z.B. stk500.exe, uisp, sp12).

<pre class="code">
...
# Einstellung fuer STK500 an com1 (auskommentiert)
# AVRDUDE_PROGRAMMER = stk500
# com1 = serial port. Use lpt1 to connect to parallel port.
# AVRDUDE_PORT = com1 # programmer connected to serial device

# Einstellung fuer STK200-Dongle an lpt1
AVRDUDE_PROGRAMMER = stk200
AVRDUDE_PORT = lpt1
...
</pre>

Sollen Flash(=.hex) und EEPROM(=.eep) zusammen auf den Controller programmiert werden, ist das Kommentarzeichen vor AVRDUDE_WRITE_EEPROM zu löschen.

<pre class="code">
...
# auskommentiert: EERPOM-Inhalt wird nicht mitgeschrieben
#AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep

# nicht auskommentiert: EERPOM-Inhalt wird mitgeschrieben
AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep
...
</pre>

todo: fuse-bits

== Anwendung ==

Die Eingabe von ''make all'' im Arbeitsverzeichnis mit dem Makefile und den Quellcodedateien erzeugt (unter anderem) die Dateien superprog.hex und superprog.eep. Abhängigkeiten zwischen den einzelnen c-Dateien werden dabei automatisch berücksichtigt. Die ''superprog.hex'' und ''superprog.eep'' werden mit ''make program'' zum Controller übertragen. Mit ''make clean'' werden alle temporären Dateien gelöscht (="aufgeräumt").

== Sonstige Einstellungen ==

=== Optimierungsgrad ===

Der gcc-Compiler kennt verschiedene Stufen der Optimierung. Nur zu Testzwecken sollte die Optimierung ganz deaktiviert werden (''OPT = 0''). Die weiteren möglichen Optionen weisen den Compiler an, möglichst kompakten oder möglichst schnellen Code zu erzeugen. In den weitaus meisten Fällen ist ''OPT = s'' die optimale (sic) Einstellung, damit wird kompakter und oft auch der "schnellste" Maschinencode erzeugt.

=== Debug-Format ===

Unterstützt werden die Formate stabs und dwarf-2. Das Format wird hinter ''DEBUG ='' eingestellt. Siehe dazu Abschnitt ''Eingabedateien zur Simulation''.

=== Assembler-Dateien ===

Die im Projekt genutzten Assembler-Dateien werden hinter ASRC durch Leerzeichen getrennt aufgelistet. Assembler-Dateien haben immer die Endung .S (großes S). Ist zum Beispiel der Assembler-Quellcode eines Software-UARTs in einer Datei softuart.S enthalten lautet die Zeile: ''ASRC = softuart.S''

=== Taktfrequenz ===

Neuere Versionen der WinAVR/Mfile Vorlage für Makefiles beinhalten die Definition einer Variablen F_CPU (WinAVR 2/2005). Darin wird die Taktfrequenz des Controllers in Hertz eingetragen. Die Definition steht dann im gesamten Projekt ebenfalls unter der Bezeichnung F_CPU zur Verfügung (z.B. um daraus UART-, SPI- oder ADC-Frequenzeinstellungen abzuleiten).

Die Angabe hat rein "informativen" Charakter, die tatsächliche Taktrate wird über den externen Takt (z.B. Quarz) bzw. die Einstellung des internen R/C-Oszillators bestimmt. Die Nutzung von F_CPU macht also nur Sinn, wenn die Angabe mit dem tatsächlichen Takt übereinstimmt.

Innerhalb der avr-libc ab Version 1.2 (in WinAVR ab 2/2005 enthalten) wird die Definition der Taktfrequenz (F_CPU) zur Berechnung der Wartefunktionen in avr/delay.h genutzt. Diese funktionieren nur dann korrekt, wenn F_CPU mit der tatsächlichen Taktfrequenz übereinstimmt.
F_CPU muss dazu jedoch nicht unbedingt im makefile definiert werden. Es reicht aus, wird aber bei mehrfacher Anwendung unübersichtlich, vor ''#include <avr/delay.h>'' ein ''#define F_CPU [hier Takt in Hz]UL'' einzufügen.
Vgl. dazu den [http://www.nongnu.org/avr-libc/user-manual/group__avr__delay.html entsprechenden Abschnitt der Dokumentation].

== Eingabedateien zur Simulation in AVR-Studio ==

Mit älteren AVR-Studio-Versionen kann man nur auf Grundlage sogenannter ''coff''-Dateien simulieren. Neuere Versionen von AVR-Studio (ab 4.10.356) unterstützen zudem das modernere aber noch experimentelle dwarf-2-Format, das ab WinAVR 20040722 (avr-gcc 3.4.1/Binutils inkl. Atmel add-ons) "direkt" vom Compiler erzeugt wird.

; Vorgehensweise bei extcoff:
* im Makefile bei DEBUG: <pre class="code">DEBUG=stabs</pre>
* ''make extcoff'' (evtl. vorher ''make clean'')
* die erzeugte ''cof''-Datei (im Beispiel oben ''superprog.cof'') in AVR-Studio laden
* AVR-Simulator und zu simulierenden Controller wählen, "Finish"
* weiteres siehe AVR-Studio Online-Hilfe

; Vorgehensweise bei dwarf-2:
* im Makefile bei DEBUG: <pre class="code">DEBUG=dwarf-2</pre>
* ''make all'' (evtl. vorher ''make clean'')
* die erzeugte ''elf''-Datei (im Beispiel oben ''superprog.elf'') in AVR-Studio laden
* AVR-Simulator und zu simulierenden Controller wählen, "Finish"
* weiteres siehe AVR-Studio Online-Hilfe

Beim Simulieren scheinen oft "Variablen zu fehlen". Ursache dafür ist, dass der Compiler die "Variablen" direkt Registern zuweist. Dies kann vermieden werden, indem die Optimierung abgeschaltet wird (im makefile). Man simuliert dann jedoch ein vom optimierten Code stark abweichendes Programm. Das Abschalten der Optimierung wird nicht empfohlen.

Statt des Software-Simulators kann das AVR-Studio auch genutzt werden, um mit dem ATMEL JTAGICE, ein Nachbau davon (BootICE, Evertool o.ä.) oder dem ATMEL JTAGICE MKII "im System" zu debuggen. Dazu sind keine speziellen Einstellungen im makefile erforderlich. Debugging bzw. "In-System-Emulation" mit dem JTAGICE und JTAGICE MKII sind in der AVR-Studio Online-Hilfe beschrieben.

= 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.

== Selbstdefinierte (nicht-standardisierte) ganzzahlige Datentypen ==

Bei den im Folgenden genannten Typdefinitionen ist zu beachten, dass die Bezeichnungen für "Worte" teilweise je nach Prozessorplattform unterschiedlich verwendet werden. Die angegebenen Definitionen beziehen sich auf die im Zusammenhang mit AVR/8-bit-Controllern üblichen "Bit-Breiten" (In Erläuterungen zum ARM7TDMI z.B. werden oft 32-bit Integer mit "Wort" ohne weitere Ergänzung bezeichnet). Es empfiehlt sich daher, die im nachfolgenden Abschnitt beschriebenen ''standardisierten ganzzahligen Datentypen'' zu nutzen und damit "Missverständnissen" vorzubeugen, die z.B. bei der Portierung von C-Code zwischen verschiedenen Plattformen auftreten können.

<pre class="code">
typedef unsigned char BYTE; // besser: uint8_t aus <inttypes.h>
typedef unsigned short WORD; // besser: uint16_t aus <inttypes.h>
typedef unsigned long DWORD; // besser: uint32_t aus <inttypes.h>
typedef unsigned long long QWORD; // besser: uint64_t aus <inttypes.h>
</pre>

; BYTE : Der Datentyp BYTE definiert eine Variable mit 8 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 255.

; WORD : Der Datentyp WORD definiert eine Variable mit 16 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 65535.

; DWORD : Der Datentyp DWORD (gesprochen: Double-Word) definiert eine Variable mit 32 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 4294967295.

; QWORD : Der Datentyp QWORD (gesprochen: Quad-Word) definiert eine Variable mit 64 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 18446744073709551615.

== Standardisierte Integer(Ganzzahl)-Typen ==

Standardisierte Datentypen werden in der Header-Datei inttypes.h definiert. In neueren Version der avr-libc (ab V1.2.0) heisst die Datei entsprechend aktuellem Standard stdint.h. inttypes.h existiert aus Kompatibiltätsgründen weiterhin und enthält ein ''#include <stdint.h>''.
Zur Nutzung der standardisierten Typen bindet man die "Definitionsdatei" wie folgt ein:

<pre class="code">
#include <inttypes.h>

// oder - ab avr-libc Version 1.2.0 möglich und empfohlen:
#include <stdint.h>
</pre>

Einige der dort definierten Typen (avr-libc Version 1.0.4):

<pre class="code">
typedef signed char int8_t;
typedef unsigned char uint8_t;

typedef short int16_t;
typedef unsigned short uint16_t;

typedef long int32_t;
typedef unsigned long uint32_t;

typedef long long int64_t;
typedef unsigned long long uint64_t;
</pre>

Ein Vierfach-Wort (64Bit) entspricht beim AVR ''uint64_t'', ein Doppel-Wort (32bit) entspricht ''uint32_t'', ein Wort (16bit) entspricht ''uint16_t'' und ein Byte (8bit) entspricht ''uint8_t''.
Die Typen ohne vorangestelltes ''u'' können auch vorzeichenbehaftete Zahlen speichern. ''int8_t'' geht also von -128 bis 127, ''uint8_t'' dagegen geht von 0 bis 255.

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/(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 Bit breit ist.

Hier bietet uns die Programmiersprache C ein mächtiges Werkzeug an, mit dessen
Hilfe wir 8 Bits in eine einzelne Bytevariable zusammen fassen 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:

<pre class="code">
struct {
unsigned char bStatus_1:1; // 1 Bit für bStatus_1
unsigned char bStatus_2:1; // 1 Bit für bStatus_2
unsigned char bNochNBit:1; // Und hier noch mal ein Bit
unsigned char b2Bits:2; // Dieses Feld ist 2 Bits breit
// All das hat in einer einzigen Byte-Variable Platz.
// die 3 verbleibenden Bits bleiben ungenutzt
} x;
</pre>

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

<pre class="code">
x.bStatus_1 = 1;
x.bStatus_2 = 0;
x.b2Bits = 3;
</pre>

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 geraten,
ein "ganzes" Byte (uint8_t) zu nutzen auch wenn nur ein Bitwert gespeichert
werden soll.

Wenn man nur eine paar wenige Variablen vom Typ bool verwenden möchte, kann man
auch die Headerdatei <stdbool.h> einbinden und sich dann wie gewohnt einen Booltyp anlegen.
Bei vielen Variablen vom Typ Bool und knappem Speicher ist die Verwendung von Bitfeldern zu empfehlen (? Wie wird der stdbool intern abgewickelt ?)

= 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:

[[Image:Sequentielle Programme.gif]]

== 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.

[[Image:Interrupt Programme.gif]]

= Allgemeiner 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.

Einige Register haben spezielle Funktionen, andere wiederum können für allgemeine Zwecke (Speichern von Datenwerten) verwendet werden.

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. Wenn im Makefile der MCU-Typ definiert ist, wird vom System automatisch die zum Typen passende Definitionsdatei genutzt, sobald man im Code die allgemeine "io.h" Header-Datei einbindet.

<pre class="code">
#include <avr/io.h>
</pre>

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

== I/O-Register ==

Die I/O-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 mal
die 8-Bit Register.

=== Lesen eines I/O-Registers ===

Zum Lesen kann man auf I/O-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üzen den Zugriff nun direkt und inp() ist nicht mehr erforderlich.

Beispiel:

<pre class="code">
#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;
...
}
</pre>

==== Lesen eines Bits ====

Die AVR-Bibliothek (avr-libc) stellt auch Funktionen zur Abfrage eines einzelnen Bits eines Registers zur Verfügung:

;bit_is_set (<Register>,<Bitnummer>) : Die Funktion ''bit_is_set'' prüft, ob ein Bit gesetzt ist. Wenn das Bit gesetzt ist, wird ein Wert ungleich 0 zurückgegeben. Genau genommen ist es die Wertigkeit des abgefragten Bits, also 1 für Bit0, 2 für Bit1, 4 für Bit2 etc.

;bit_is_clear (<Register>,<Bitnummer>) : Die Funktion ''bit_is_clear'' prüft, ob ein Bit gelöscht ist. Wenn das Bit gelöscht ist, also auf 0 ist, wird ein Wert ungleich 0 zurückgegeben.

Die Funktionen bit_is_clear bzw. bit_is_set sind ''nicht erforderlich'', man kann auch "einfache" C-Syntax verwenden, die universell verwendbar ist. ''bit_is_set'' entspricht dabei z.B. (Registername & (1 << Bitnummer)). Das Ergebnis ist <>0 ("wahr") wenn das Bit gesetzt und 0 ("falsch") wenn es nicht gesetzt ist. Die Negierung des Ausdrucks, also '''!'''((Registername & (1 << Bitnummer)), entspricht ''bit_is_clear'' und gibt einen Wert <>0 ("wahr") zurück, falls das Bit nicht gesetzt ist,

* siehe auch [[Bitmanipulation]]

=== Schreiben eines I/O-Registers ===

Zum Schreiben kann man I/O-Register einfach wie eine Variable setzen. 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üzen den Zugriff nun direkt und outp() ist nicht mehr erforderlich.

Beispiel:

<pre class="code">
#include <avr/io.h>

...

int main(void)
{
/* Setzt das Richtungsregister des Ports A auf 0xff
(alle Pins als Ausgang): */
DDRA = 0xff;

/* Setzt PortA auf 0x03, Bit 0 und 1 "high", restliche "low": */
PORTA = 0x03;
...
}
</pre>

==== Schreiben von Bits ====

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

mit dem Ausdruck:
<pre class="code">
x |= (1 << Bitnummer); // wird ein Bit in x gesetzt
x &= ~(1 << Bitnummer); // wird ein Bit in x geloescht
</pre>

Das niederwertigste Bit (für 1) eines Bytes hat die Bitnummer 0, das "höchstwertige" (für 128) die Nummer 7.

Beispiel:
<pre class="code">
#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 */
</pre>

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

Beispiel:
<pre class="code">
#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 */
</pre>

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]]
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Special Function Registers

=== Warten auf einen bestimmten Zustand ===

Es gibt in der Bibliothek sogar Funktionen, die warten, bis ein bestimmter Zustand auf einem Bit erreicht ist. Es ist allerdings normalerweise eine eher unschöne Programmiertechnik, da in diesen Funktionen "blockierend gewartet" wird. D.h., der Programmablauf bleibt 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.

<pre class="code">
#include <avr/io.h>
...

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

#define WARTEPIN PINA
#define WARTEBIT 2

// 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)) ) ;
...
</pre>

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. Das niederwertigste Bit hat die Bitnummer 0.

<pre class="code">
#include <avr/io.h>
...

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

// 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) ) ;
...
</pre>

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

siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Special Function Registers
* [[Bitmanipulation]]

= Zugriff auf Ports =

Alle Ports der AVR-Controller werden über Register gesteuert. Dazu sind
jedem Port 3 Register zugeordnet:

{| border="1"
|-
| '''DDRx'''
| Datenrichtungsregister für Port'''x'''.
'''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 Port'''x'''.

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 Port'''x'''.
Dieses Register wird verwendet, um die Ausgänge eines Ports anzusteuern. Bei Pins, die mittels DDRx auf Eingang geschaltet wurden, koenen ueber PORTx
die internen Pull-Up Widerstände aktiviert oder deaktiviert werden (1 = aktiv).
|}



== 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.

Wollen wir also beispielsweise Pin 0 bis 4 von Port B als Ausgänge
definieren so schreiben wir folgende Zeile:

<pre class="code">
#include <avr/io.h>

...

// Setzen der Bits 0,1,2,3 und 4
// Binär 00011111 = Hexadezimal 1F

DDRB = 0x1F; /* direkte Zuweisung - unuebersichtlich */

/* mehr Tipparbeit aber uebersichtlicher: */
DDRB = (1 << DDB0) | (1 << DDB1) | (1 << DDB2) | (1 << DDB3) | (1 << DDB4);
...
</pre>

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

=== Ganze Ports ===

Um einen ganzen Port als Ausgang zu definieren, kann der folgende Befehl
verwendet werden:
<pre class="code">
DDRB = 0xff;
</pre>

Im Beispiel wird der Port B als Ganzes als Ausgang geschaltet. Dazu muss die Header-Datei avr/io.h eingebunden sein (darin wird u.a. DDRB definiert).

== 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: (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):

<pre class="code">
...
/* 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
</pre>

== 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
<pre class="code">
#inlude <avr/io.h>
...
PORTB=0x04; /* besser PORTB=(1<<PB2) */
</pre>
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:

<pre class="code">
#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" */
</pre>

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

<pre class="code">
#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" */
</pre>

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 in aktuellen Versionen der avr-libc nicht mehr enthalten und auch nicht mehr erforderlich.

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 Angangswert "high" initialisiert werden, zuerst die Bits im PORTx-Register setzen und anschliessend die Datenrichtung auf Ausgang stellen. Daraus ergibt sich die Abfolge Eingang -> setze PORTx: interner Pull-Up aktiv -> setze DDRx: Ausgang "high". Bei der Reihenfolge erst DDRx and PORTx, kann es zu einem kurzen "low-Puls" kommen, der auch exterene 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") 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.

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'''. Die Abfrage der Pinzustände über PORTx statt PINx ist ein häufiger Fehler beim AVR-"Erstkontakt". (Ansonsten liest man nicht den Zustand der Eingänge, sondern den Status der internen Pull-Up-Widerstände.)

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

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
...
uint8_t bPortD;
...
bPortD = PIND;
...
</pre>

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

<pre class="code">
#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 */
}
...
</pre>

=== Tasten und Schalter ===

Der Anschluss mechanischer Kontakte an den Mikrocontroller gestaltet sich ebenfalls ganz einfach, wobei wir zwei unterschiedliche Methoden unterscheiden müssen (''Active Low'' und ''Active High''):

{| border="1"
|-
| '''Active Low'''
| '''Active High'''
|-
| [[Image:Active Low.gif]]
| [[Image:Active High.gif]]
|-
| 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.

Der Widerstandswert des Pull-Up Widerstands ist an sich nicht kritisch. Es muss jedoch beachtet werden, dass über den Widerstand ein Strom in den Eingang fliesst, also sollte er nicht zu klein gewählt werden um den Controller nicht zu zerstören. Wird er allerdings zu hoch gewählt ist die Wirkung eventuell nicht gegeben. Als üblicher Wert haben sich 10 Kiloohm eingebürgert.

Die AVRs haben sogar an den meisten Pins softwaremässig zuschaltbare interne Pull-Up Widerstände, welche wir natürlich auch verwenden können.

| 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.
|}

==== Pull-Up Widerstände aktivieren ====

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.

<pre class="code">
#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<<DDC7); /* Pin PC7 als Eingang */
PORTC |= (1<<PC7); /* internen Pull-Up an PC7 aktivieren */
</pre>

==== (Tasten-)Entprellung ====

Nun haben alle mechanischen Kontakte, sei es von Schaltern, Tastern oder auch von Relais, die unangenehme Eigenschaft zu prellen. Dies bedeutet, dass beim Schliessen des Kontaktes derselbe nicht direkt Kontakt herstellt, sondern mehrfach ein- und ausschaltet bis zum endgültigen Herstellen des Kontaktes.

Soll nun mit einem schnellen Mikrocontroller gezählt werden, wie oft ein solcher Kontakt geschaltet wird, dann haben wir ein Problem, weil das Prellen als mehrfache Impulse gezählt wird. Diesem Phänomen muss beim Schreiben des Programms unbedingt Rechnung getragen werden.

<pre class="code">
#include <avr/io.h>
#include <inttypes.h>
#ifndef F_CPU
#define F_CPU 3686400UL /* Quarz mit 3.6864 Mhz */
#endif
#include <avr/delay.h> /* definiert _delay_ms() ab avr-libc Version 1.2.0 */

/* Einfache Funktion zum Entprellen eines Tasters */
inline uint8_t debounce(volatile uint8_t *port, uint8_t pin)
{
if ( ! (*port & (1 << pin)) )
{
/* Pin wurde auf Masse gezogen, 100ms warten */
_delay_ms(100);
if ( ! (*port & (1 << pin)) )
{
/* Anwender Zeit zum Loslassen des Tasters geben */
_delay_ms(100);
return 1;
}
}
return 0;
}

int main(void)
{
DDRB &= ~( 1 << PB0 ); /* PIN PB0 auf Eingang (Taster) */
PORTB |= ( 1 << PB0 ); /* Pullup-Widerstand aktivieren */
...
if (debounce(&PINB, PB0)) /* Falls Taster an PIN PB0 gedrueckt.. */
PORTD = PIND ^ ( 1 << PD7 ); /* ..LED an Port PD7 an-
bzw. ausschalten */
...
}
</pre>

Bei diesem Beispiel ist zu beachten, dass der AVR im Falle eines Tastendrucks 200ms wartet, also brach liegt. Zeitkritische Anwendungen sollten ein anderes Verfahren wählen.

Zum Thema Entprellen siehe auch:
* Artikel [[Entprellung]]

== Analog ==

Die Verarbeitung von analogen Eingangswerten und die Ausgabe von Analogwerten wird in Kapitel [[AVR-GCC-Tutorial#Analoge_Ein-_und_Ausgabe|Analoge Ein- und Ausgabe]] behandelt.

== 16-Bit Portregister (ADC, ICR1, OCR1, TCNT1, UBRR) ==

Einige der Portregister in den AVR-Controllern sind 16 Bit breit. Im Datenblatt sind diese Register üblicherweise mit dem Suffix "L" (LSB) und "H" (MSB) versehen. Die avr-libc definiert zusätzlich die meisten dieser Variablen die Bezeichnung ohne "L" oder "H". Auf diese kann direkt zugewiesen bzw. zugegriffen werden. Die Konvertierung von 16-bit Wort nach 2*8-bit Byte erfolgt intern.

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
...
uint16_t foo;

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

Falls benötigt, kann eine 16-Bit Variable auch recht einfach manuell in ihre zwei 8-Bit Bestandteile zerlegt werden. Folgendes Beispiel demonstriert dies anhand des pseudo- 16-Bit Registers UBRR.

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
#ifndef F_CPU
#define F_CPU 3686400
#endif
#define UART_BAUD_RATE 9600

typedef union {
uint16_t i16;
struct {
uint8_t i8l;
uint8_t i8h;
};
} convert16to8;

...
convert16to8 baud;
baud.i16 = F_CPU / (UART_BAUD_RATE * 16L) -1;
UBRRH = baud.i8h;
UBRRL = baud.i8l;
...

/*alternativ:*/
#include <inttypes.h>

uint16_t wFoo16;
uint8_t bFooLow, bFooHigh;

...

wFoo16 = 0xAA55; /* zu "zerlegende" 16Bit-Integer */
bFooHigh = (uint8_t)(wFoo16 >> 8); /* MS-Byte */
bFooLow = (uint8_t)(wFoo16); /* LS-Byte */
...
</pre>

Bei einigen AVR-Typen (z.B. ATmega8) teilen sich UBRRH und UCSRC die gleiche Memory-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''.

Bei einigen 16-bit Registern (insbesondere die der 16-bit Timer) erfolgen Schreibzugriffe über das sogenannte ''temporary Register''. Die Reihenfolge der Zugriffe bestimmt, wann der Wert tatsächlich ins Register geschrieben wird. Typisch wird erst das High-Byte beschrieben (xxxH) und intern im temporary Register zwischengespeichert. Nachdem das Low-Byte (xxxL) geschrieben wurde, setzt der Controller mit diesem und dem im temporary Register zwischengespeicherten Wert für das High-Byte das 16-bit Register. Dabei ist zu beachten, dass intern nur ein temporary Register verfügbar ist, welches in Interruptroutinen mglw. mit einem anderen Wert überschrieben wird, wenn dort ebenfalls 16-bit Register beschrieben werden. avr-gcc/avr-libc berücksichtigen die korrekte Reihenfolge automatisch, wenn die Register mit ihrem "16-bit Label" (ohne H bzw. L) angesprochen werden, dabei ist der Schutz des temporary Registers vor Überschreiben durch Interruptroutinen dennoch zu beachten (im Zweifel beim Schreibzugriff die Interrupts kurzzeitig global deaktivieren).

Im Umgang mit 16-Bit Registern siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Related Pages/Frequently Asked Questions/Nr. 8
* Datenblatt Abschnitt ''Accessing 16-bit Registers''

= Der UART =

== Allgemeines zum UART ==

Über den [[UART]] kann ein AVR leicht mit einer [[RS232]]-Schnittstelle eines PC oder sonstiger Geräte mit "serieller Schnittstelle" verbunden werden.

Mögliche Anwendungen des UART:

* Debug-Schnittstelle: z.B. zur Anzeige von Zwischenergebnissen ("printf-debugging" - hier besser "UART-debugging") auf einem PC. Auf dem Rechner reicht dazu eine Terminal-Software (MS-Windows: Hyperterm oder besser Bray-Terminal, [http://www.mikrocontroller.net/forum/read-8-155472.html#new HTerm]; Unix/Linux z.B. minicom). Ein direkter Anschluss ist aufgrund unterschiedlicher Pegel nicht möglich, jedoch sind entsprechende Schnittstellen-ICs wie z.B. ein MAX232 günstig und leicht zu integrieren. Rechner ohne serielle Schnittstelle können über fertige USB-seriell-Adapter angeschlossen werden.
* "Mensch-Maschine Schnittstelle": z.B. Konfiguration und Statusabfrage über eine "Kommandozeile" oder Menüs
* Übertragen von gespeicherten Werten: z.B. bei einem Datenlogger
* Anschluss von Geräten mit serieller Schnittstelle (z.B. (Funk-)Modems, Mobiltelefone, Drucker, Sensoren, "intelligente" LC-Displays, GPS-Empfänger).
* "Feldbusse" auf RS485/RS422-Basis mittels entsprechenden Bustreiberbausteinen (z.B. MAX485)
* DMX, Midi etc.
* LIN-Bus ('''L'''ocal '''I'''nterconnect '''N'''etwork): Preiswerte Sensoren/Aktoren in der Automobiltechnik und darüber hinaus

Einige AVR-Controller haben ein bis zwei vollduplexfähigen UART ('''U'''niversal '''A'''synchronous '''R'''eceiver and '''T'''ransmitter) schon eingebaut ("Hardware-UART").
Übrigens: Vollduplex heisst nichts anderes, als dass der Baustein gleichzeitig senden und empfangen kann.

Neuere AVRs (ATmega, ATtiny) verfügen über einen oder zwei U'''S'''ART(s), dieser unterschiedet sich vom UART hauptsächlich durch interne FIFO-Puffer für Ein- und Ausgabe und erweiterte Konfigurationsmöglichkeiten. Die Puffergröße ist allerdings nur 1 Byte.

Der UART wird über vier separate Register angesprochen. USARTs der ATMEGAs verfügen über mehrere zusätzliche Konfigurationsregsiter. Das Datenblatt gibt darüber Auskunft. Die Folgende Tabelle gibt nur die Register für die (veralteten) UARTs wieder.

{| border="1"
|-
| '''UCR   '''
| '''U'''ART '''C'''ontrol '''R'''egister. 
In diesem Register stellen wir ein, wie wir den UART verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''RXCIE'''
| align="center" | '''TXCIE'''
| align="center" | '''UDRIE'''
| align="center" | '''RXEN'''
| align="center" | '''TXEN'''
| align="center" | '''CHR9'''
| align="center" | '''RXB8'''
| align="center" | '''TXB8'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
|}

'''RXCIE''' ('''RX''' '''C'''omplete '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART RX Complete Interrupt ausgelöst, wenn ein Zeichen vom UART empfangen wurde. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''TXCIE''' ('''TX''' '''C'''omplete '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART TX Complete Interrupt ausgelöst, wenn ein Zeichen vom UART gesendet wurde. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''UDRIE''' ('''U'''ART '''D'''ata '''R'''egister '''E'''mpty '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART Datenregister Leer Interrupt ausgelöst, wenn der UART wieder bereit ist um ein neues zu sendendes Zeichen zu übernehmen. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''RXEN''' ('''R'''eceiver '''E'''nable)
:Nur wenn dieses Bit gesetzt ist, arbeitet der Empfänger des UART überhaupt. Wenn das Bit nicht gesetzt ist, kann der entsprechende Pin des AVR als normaler I/O-Pin verwendet werden.

'''TXEN''' ('''T'''ransmitter '''E'''nable)
:Nur wenn dieses Bit gesetzt ist, arbeitet der Sender des UART überhaupt. Wenn das Bit nicht gesetzt ist, kann der entsprechende Pin des AVR als normaler I/O-Pin verwendet werden.

'''CHR9''' (9 Bit Characters)
:Wenn dieses Bit gesetzt ist, können 9 Bit lange Zeichen übertragen und empfangen werden. Das 9. Bit kann bei Bedarf als zusätzliches Stopbit oder als Paritätsbit verwendet werden. Man spricht dann von einem 11-Bit Zeichenrahmen:
:1 Startbit + 8 Datenbits + 1 Stopbit + 1 Paritätsbit = 11 Bits

'''RXB8''' (Receive Data Bit 8)
:Wenn das vorher erwähnte CHR9-Bit gesetzt ist, dann enthält dieses Bit das 9. Datenbit eines empfangenen Zeichens.

'''TXB8''' (Transmit Data Bit 8)
:Wenn das vorher erwähnte CHR9-Bit gesetzt ist, dann muss in dieses Bit das 9. Bit des zu sendenden Zeichens eingeschrieben werden bevor das eigentliche Datenbyte in das Datenregister geschrieben wird.

|-
| '''USR   '''
| '''U'''ART '''S'''tatus '''R'''egister. 
Hier teilt uns der UART mit, was er gerade so macht.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''RXC'''
| align="center" | '''TXC'''
| align="center" | '''UDRE'''
| align="center" | '''FE'''
| align="center" | '''OR'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''RXC''' (UART Receive Complete)
:Dieses Bit wird vom AVR gesetzt, wenn ein empfangenes Zeichen vom Empfangs-Schieberegister in das Empfangs-Datenregister transferiert wurde.
:Das Zeichen muss nun schnellstmöglich aus dem Datenregister ausgelesen werden. Falls dies nicht erfolgt bevor ein weiteres Zeichen komplett empfangen wurde wird eine Überlauf-Fehlersituation eintreffen. Mit dem Auslesen des Datenregisters wird das Bit automatisch gelöscht.

'''TXC''' (UART Transmit Complete)
:Dieses Bit wird vom AVR gesetzt, wenn das im Sende-Schieberegister befindliche Zeichen vollständig ausgegeben wurde und kein weiteres Zeichen im Sendedatenregister ansteht. Dies bedeutet also, wenn die Kommunikation vollumfänglich abgeschlossen ist.
:Dieses Bit ist wichtig bei Halbduplex-Verbindungen, wenn das Programm nach dem Senden von Daten auf Empfang schalten muss. Im Vollduplexbetrieb brauchen wir dieses Bit nicht zu beachten.
:Das Bit wird nur dann automatisch gelöscht, wenn der entsprechende Interrupthandler aufgerufen wird, ansonsten müssen wir das Bit selber löschen.

'''UDRE''' ('''U'''ART '''D'''ata '''R'''egister '''E'''mpty)
:Dieses Bit wird vom AVR gesetzt, wenn ein Zeichen vom Sendedatenregister in das Send-Schieberegister übernommen wurde und der UART nun wieder bereit ist, ein neues Zeichen zum Senden aufzunehmen.
:Das Bit wird automatisch gelöscht, wenn ein Zeichen in das Sendedatenregister geschrieben wird.

'''FE''' ('''F'''raming '''E'''rror)
:Dieses Bit wird vom AVR gesetzt, wenn der UART einen Zeichenrahmenfehler detektiert, d.h. wenn das Stopbit eines empfangenen Zeichens 0 ist.
:Das Bit wird automatisch gelöscht, wenn das Stopbit des empfangenen Zeichens 1 ist.

'''OR''' ('''O'''ver'''R'''un) 
:Dieses Bit wird vom AVR gesetzt, wenn unser Programm das im Empfangsdatenregister bereit liegende Zeichen nicht abholt bevor das nachfolgende Zeichen komplett empfangen wurde.
:Das nachfolgende Zeichen wird verworfen.
:Das Bit wird automatisch gelöscht, wenn das empfangene Zeichen in das Empfangsdatenregister transferiert werden konnte.

|-
| '''UDR'''
| '''U'''ART '''D'''ata '''R'''egister. 
Hier werden Daten zwischen UART und CPU übertragen. Da der UART im
Vollduplexbetrieb gleichzeitig empfangen und senden kann, handelt es sich
hier physikalisch um 2 Register, die aber über die gleiche I/O-Adresse
angesprochen werden. Je nachdem, ob ein Lese- oder ein Schreibzugriff auf
den UART erfolgt wird automatisch das richtige UDR angesprochen.
|-
| '''UBRR'''
| '''U'''ART '''B'''aud '''R'''ate '''R'''egister. 
In diesem Register müssen wir dem UART mitteilen, wie schnell wir gerne
kommunizieren möchten. Der Wert, der in dieses Register geschrieben
werden muss, errechnet sich nach folgender Formel:

<math>
\begin{matrix}
\mathrm{UBRR} = \frac{\mathrm{Taktfrequenz}}{\mathrm{Baudrate} \cdot 16} - 1
\end{matrix}
</math>

Es sind Baudraten bis zu 115200 Baud und höher möglich.
|}

== Die Hardware ==

Der UART basiert auf normalem TTL-Pegel mit 0V (LOW) und 5V (HIGH). Die
Schnittstellenspezifikation für RS232 definiert jedoch -3V ... -12V (LOW) und
+3 ... +12V (HIGH). Zudem muss der Signalaustausch zwischen AVR und
Partnergerät invertiert werden. Für die Anpassung der Pegel und das
Invertieren der Signale gibt es fertige Schnittstellenbausteine. Der bekannteste
davon ist wohl der MAX232.


Streikt die Kommunikation per UART, so ist oft eine fehlerhafte Einstellung der Baudrate die Ursache. Die Konfiguration auf eine bestimmte Baudrate ist abhängig von der Taktfrequenz des Controllers. Gerade bei neu aufgebauten Schaltungen (bzw. neu gekauften Controllern) sollte man sich daher noch einmal vergewissern, dass der Controller auch tatsächlich mit der vermuteten Taktrate arbeitet und nicht z.B. den bei einigen Modellen werksseitig eingestellten internen [[Oszillator]] statt eines externen Quarzes nutzt. Die Werte der verschiedenen fuse-bits im Fehlerfall also beispielsweise mit ''[[AVRDUDE]]'' kontrollieren und falls nötig anpassen. Grundsätzlich empfiehlt sich auch immer ein Blick in die [[AVR_Checkliste]].

== Senden mit dem UART ==

Wir wollen nun Daten mit dem UART auf die serielle Schnittstelle ausgeben.

Dazu müssen wir den UART zuerst mal initialisieren. Dazu setzen wir je nach
gewünschter Funktionsweise die benötigten Bits im '''U'''ART '''C'''ontrol '''R'''egister.

Da wir vorerst nur senden möchten und (noch) keine Interrupts auswerten wollen, gestaltet sich die Initialisierung wirklich sehr einfach, da wir lediglich das '''Transmitter Enable''' Bit setzen müssen:

<pre class="code">
UCR |= (1<<TXEN);
</pre>

Neuere AVRs mit USART(s) haben mehrere Konfigurationsregister und erfordern eine etwas andere Konfiguration. Für einen ATmega16 z.B.:

<pre class="code">
UCSRB |= (1<<TXEN); // UART TX einschalten
UCSRC |= (1<<URSEL)|(3<<UCSZ0); // Asynchron 8N1
</pre>

Nun ist noch das bzw. sind noch die Baudratenregister einzustellen (UBRR bzw. UBRRL/UBRRH). Der Wert dafür ergibt sich aus der angegebenen Formel durch Einsetzen der Taktfrequenz und der gewünschten Übertragungsrate. (Das Berechnen der Formel kann man dem [[C-Präprozessor|Präprozessor]] überlassen).

<pre class="code">
/* UART-Init beim AT90S2313 */

#ifndef F_CPU
/* In neueren Version der WinAVR/Mfile Makefile-Vorlage kann
F_CPU im Makefile definiert werden, eine nochmalige Definition
hier wuerde zu einer Compilerwarnung fuehren. Daher "Schutz" durch
#ifndef/#endif */
/* Zum Beispiel 4Mhz-Quarz (falls nicht schon im Makefile definiert): */
#define F_CPU 4000000;
#endif
#define UART_BAUD_RATE 9600 // 9600 Baud

UBRR = F_CPU / (UART_BAUD_RATE * 16L) - 1;
</pre>

Wieder für den Mega16 mit einem 16bit-Register eine etwas andere Programmierung.

<pre class="code">
/* USART-Init beim ATmega16 */
#ifndef F_CPU
#define F_CPU 3686400 /* Oszillator-Frequenz in Hz */
#endif

// Hilfsmakro zur UBRR-Berechnung ("Formel" laut Datenblatt)
#define UART_UBRR_CALC(BAUD_,FREQ_) ((FREQ_)/((BAUD_)*16L)-1)

#define UART_BAUD_RATE 9600

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

/* alternativ bei der avr-libc "direkt 16bit" : */
UBRR = UART_UBRR_CALC(UART_BAUD_RATE,F_CPU);
</pre>

Teilweise kann man im Datenblatt der jeweiligen CPU auch den entsprechenden Wert nachschlagen. Ein Beispiel für einen ATmega32 bei 16MHz und für 19200 Baud: im Datenblatt des ATmega32 Tabelle "Examples of UBRR Settings" liest man für diese Vorgaben den Wert 51 ab. Dieser wird nun auf die Register UBRRH und UBRRL verteilt.

Die Initialisierung für den USART könnte dann so aussehen:

<pre class="code">
/* USART-Init 19200 Baud bei 16MHz für Mega32 */
UCSRB |= ( 1 << TXEN ); // UART TX einschalten
UCSRC |= ( 1 << URSEL )|( 3<<UCSZ0 ); // Asynchron 8N1
UBRRH = 0; // Highbyte ist 0
UBRRL = 51; // Lowbyte ist 51 ( dezimal )
</pre>

Der obige Code ist gegenüber den Versionen mit '#define ...' nicht so portabel, dafür aber etwas übersichtlicher.

=== Senden einzelner Zeichen ===

Um nun ein Zeichen auf die Schnittstelle auszugeben, müssen wir dasselbe
lediglich in das '''U'''ART '''D'''ata '''R'''egister schreiben. Vorher ist zu prüfen, ob das UART-Modul bereit ist das zu sendende Zeichen entgegenzunehmen. Die Bezeichnungen des/der Statusregisters mit dem Bit UDRE ist abhängig vom Controllertypen (vgl. Datenblatt).

<pre class="code">
// bei AVR mit einem UART ("classic AVR" z.B. AT90S8515)
while (!(USR & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = 'x'; /* schreibt das Zeichen x auf die Schnittstelle */

/** ODER **/

// bei neueren AVRs steht der Status in UCSRA/UCSR0A/UCSR1A, hier z.B. fuer ATmega16:
while (!(UCSRA & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = 'x'; /* schreibt das Zeichen x auf die Schnittstelle */
</pre>

=== Schreiben einer Zeichenkette (String) ===

Die Aufgabe "String senden" wird durch zwei Funktionen abgearbeitet. Die universelle/controllerunabhängige Funktion uart_puts übergibt jeweils ein Zeichen der Zeichenkette an eine Funktion uart_putc, die abhängig von der vorhandenen Hardware implementiert werden muss. In der Funktion zum Senden eines Zeichens ist darauf zu achten, dass vor dem Senden geprüft wird, ob der UART bereit ist den "Sendeauftrag" entgegenzunehmen.

<pre class="code">
// putc fuer AVR mit einem UART (z.B. AT90S8515)
int uart_putc(unsigned char c)
{
while(!(USR & (1 << UDRE))); /* warte, bis UDR bereit */
UDR = c; /* sende Zeichen */
return 0;
}

/** ODER **/

// bei neueren AVRs andere Bezeichnung fuer die Statusregister, hier ATmega16:
int uart_putc(unsigned char c)
{
while (!(UCSRA & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = c; /* sende Zeichen */
return 0;
}

/* puts ist unabhaengig vom Controllertyp */
void uart_puts (char *s)
{
while (*s)
{ /* so lange *s != '\0' also ungleich dem "String-Endezeichen" */
uart_putc(*s);
s++;
}
}


</pre>

Warteschleifen sind insofern etwas kritisch, da während des Sendens eines Strings nicht mehr auf andere Ereignisse reagieren werden kann. Universeller ist die Nutzung von FIFO(first-in first-out)-Puffern, in denen die zu sendenden bzw. empfangenen Zeichen/Bytes zwischengespeichert und mittels Interruptroutinen an den U(S)ART weitergegeben bzw. ausgelesen werden. Dazu existieren fertige Komponenten (Bibliotheken, Libraries), die man recht einfach in eigene Entwicklungen integrieren kann. Es empfiehlt sich, diese Komponenten zu nutzen und das Rad nicht neu zu erfinden.

== Zeichen Empfangen ==

Zum Empfang von Zeichen muss der Empfangsteil des UART bei der Initialisierung aktiviert werden, indem das RXEN-Bit im jeweiligen Konfigurationsregister (UCSRB bzw UCSR0B/UCSR1B) gesetzt wird. Im einfachsten Fall wird solange gewartet, bis ein Zeichen empfangen wurde, dieses steht dann im UART-Datenregister (UDR bzw. UDR0 und UDR1 bei AVRs mit 2 UARTS) zur Verfügung (sogen. "Polling-Betrieb"). Ein Beispiel für den ATmega16:

<pre class="code">
#include <inttypes.h>
#include <avr/io.h>

/* Zusaetzlich zur Baudrateneinstellung und der weiteren Initialisierung: */
void Usart_EnableRX()
{
UCSRB |= ( 1 << RXEN );
}

/* Zeichen empfangen */
uint8_t Usart_Rx(void)
{
while (!(UCSRA & (1<<RXC))); // warten bis Zeichen verfuegbar
return UDR; // Zeichen aus UDR an Aufrufer zurueckgeben
}
</pre>

Diese Funktion blockiert den Programmablauf. Alternativ kann das RXC-Bit in einer Programmschleife abgefragt werden und dann nur bei gesetztem RXC-Bit UDR ausgelesen werden. Eleganter und in den meisten Anwendungsfällen "stabiler" ist die Vorgehensweise, die empfangenen Zeichen in einer Interrupt-Routine einzulesen und zur späteren Verarbeitung in einem Eingangsbuffer (FIFO-Buffer) zwischenzuspeichern. Dazu existieren fertige und gut getestete [[Libraries|Bibliotheken]]  und Quellcodekomponenten (z.B. UART-Library von P. Fleury, procyon-avrlib und einige in der "Academy" von avrfreaks.net).

TODO: 9bit

== Software-UART ==

Falls die Zahl der vorhandenen Hardware-UARTs nicht ausreicht, können weitere Schnittstellen über sogennante Software-UARTs ergänzt werden. Es gibt dazu (mindestens) zwei Ansätze:
* Der bei AVRs üblichste Ansatz basiert auf dem Prinzip, dass ein externer Interrupt-Pin für den Empfang ("RX") genutzt wird. Das Startbit löst den Interrupt aus, in der Interrupt-Routine (ISR) wird der externe Interrupt deaktiviert und ein Timer aktiviert. In der Interrupt-Routine des Timers wird der Zustand des Empfangs-Pins entsprechend der Baudrate abgetastet. Nach Empfang des Stop-Bits wird der externe Interrupt wieder aktiviert. Senden kann über einen beliebigen Pin ("TX") erfolgen, der entsprechend der Baudrate und dem zu sendenden Zeichen auf 0 oder 1 gesetzt wird. Die Implementierung ist nicht ganz einfach, es existieren dazu aber fertige Bibliotheken (z.B. bei [http://www.avrfreaks.net/ avrfreaks] oder in der [http://hubbard.engr.scu.edu/embedded/avr/avrlib/ Procyon avrlib]).
* Ein weiterer Ansatz erfordert keinen Pin mit "Interrupt-Funktion" aber benötigt mehr Rechenzeit. Jeder Input-Pin kann als Empfangspin (RX) dienen. Über einen Timer wird der Zustand des RX-Pins mit einem vielfachen der Baudrate abgetastet (dreifach scheint üblich) und High- bzw. Lowbits anhand einer Mindestanzahl identifiziert. (Beispiel: "Generic Software Uart" Application-Note von IAR)

Neuere AVRs (z.B. ATtiny26 oder ATmega48,88,168,169) verfügen über ein Universal Serial Interface (USI), das teilweise UART-Funktion übernehmen kann. Atmel stellt eine Application-Note bereit, in der die Nutzung des USI als UART erläutert wird (im Prinzip "Hardware-unterstützter Software-UART").

* siehe auch: Weiterführende Informationen inkl. Beispielen für die Nutzung von stdio-Funktionen (printf etc.) im [[AVR-Tutorial - UART]].
* [http://homepage.hispeed.ch/peterfleury/ Peter Fleurys] UART-Bibiliothek fuer avr-gcc/avr-libc

= 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 analogen Signale (Spannungen) in digitale Zahlenwerte gewandelt. Bei AVRs, die über keinen internen AD-Wandler verfügen (z.B. ATmega162, ATtiny2313), kann durch externe Beschaltung (R/C-Netzwerk und "Zeitmessung") die Funktion des AD-Wandlers "emuliert" werden.

Es existieren keine AVRs mit eingebautem Digital-Analog-Konverter (DAC). Diese Funktion muss durch externe Komponenten nachgebildet werden (z.B. PWM und "Glättung").

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.

== 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 Genauigkeit, mit welcher ein analoges Signal aufgelöst werden kann, wird durch die Auflösung des ADC in Anzahl Bits angegeben, man hört bzw. liest jeweils von 8-Bit-ADC oder 10-Bit-ADC oder noch höher.

Ein ADC mit 8 Bit Auflösung kann somit das analoge Signal mit einer Genauigkeit von 1/256 des Maximalwertes darstellen. Wenn wir nun mal annehmen, wir hätten eine Spannung zwischen 0 und 5 Volt und eine Auflösung von 3 Bit, dann könnten
die Werte 0V, 0.625V, 1.25, 1.875V, 2.5V, 3.125V, 3.75, 4.375, 5V
daherkommen, siehe dazu folgende Tabelle:

<div align="center"><center>

{| border="1"
|-
| align="center" | '''Eingangsspannung am ADC'''
| align="center" | '''Entsprechender Messwert'''
|-
| align="center" | 0...<0.625V
| align="center" | 0
|-
| align="center" | 0.625...<1.25V
| align="center" | 1
|-
| align="center" | 1.25...<1.875V
| align="center" | 2
|-
| align="center" | 1.875...<2.5V
| align="center" | 3
|-
| align="center" | 2.5...<3.125V
| align="center" | 4
|-
| align="center" | 3.125...<3.75V
| align="center" | 5
|-
| align="center" | 3.75...<4.375V
| align="center" | 6
|-
| align="center" | 4.375...5V
| align="center" | 7
|}

</center>
</div>

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, um so genauer kann der Wert erfasst werden.

=== Der interne ADC im AVR ===

Wenn es einmal etwas genauer sein soll, dann müssen wir auf einen AVR mit eingebautem Analog-Digital-Wandler (ADC) zurückgreifen, die über mehrere Kanäle verfügen. Kanäle heisst in diesem Zusammenhang, dass zwar bis zu zehn analoge Eingänge am AVR verfügbar sind, aber nur ein "echter" Analog-Digital-Wandler zur Verfügung steht, vor der eigentlichen Messung ist also einzustellen, 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 Mikrohenry und 100 nF 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.
* Die '''interne''' Referenzspannung wird auf '''Vcc''' bezogen, eine externe Referenzspannung auf '''GND (Masse)'''. Davon unabhängig werden digitalisierte Spannungen '''immer''' auf GND bezogen. Beim ATMEGA8 z.B. ist der Pin AREF über 32kOhm mit GND verbunden, d.h. man muss diese doch extrem niedrige Eingangsimpedanz mit in die Berechnung für einen Spannungsteiler einbeziehen, bzw. kann diesen Widerstand als R2 gleich mit benutzen. Formel für Spannungsteiler: Udiv=U/((R1+R2)/R2)

Bei Nutzung von Vcc 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 angestossen 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 (inzwischen veralteten) AT90S8535, welcher über 8 ADC-Kanäle verfügt. Die Register unterscheiden sich jedoch nicht erheblich von denen aktueller AVRs (vgl. Datenblatt).

{| border="1"
|-
| '''ADCSR   '''
| '''ADC''' '''C'''ontrol and '''S'''tatus '''R'''egister. 
In diesem Register stellen wir ein, wie wir den '''ADC''' verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''ADEN'''
| align="center" | '''ADSC'''
| align="center" | '''ADFR'''
| align="center" | '''ADIF'''
| align="center" | '''ADIE'''
| align="center" | '''ADPS2'''
| align="center" | '''ADPS1'''
| align="center" | '''ADPS0'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
|}

'''ADEN''' ('''AD'''C '''En'''able)
: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''' ('''AD'''C '''S'''tart '''C'''onversion)
: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''' ('''AD'''C '''Fr'''ee Running Select)
:Mit diesem Bit wird die Betriebsart eingestellt.
:Eine logische 1 aktiviert den frei laufenden Modus. Der ''' ADC''' misst nun ständig den ausgewählten Kanal und schreibt den gemessenen Wert in das '''ADC Data Register'''.

'''ADIF''' ('''AD'''C '''I'''nterrupt '''F'''lag)
:Dieses Bit wird vom ''' ADC''' gesetzt, wenn eine Umwandlung erfolgt und das '''ADC Data Register''' aktualisiert ist.
: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 (So steht es in der AVR-Dokumentation).

'''ADIE''' ('''AD'''C '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist und ebenso das ''' I-Bit''' im Statusregister '''SREG''', dann wird der ''' ADC-Interrupt''' aktiviert.

'''ADPS2...ADPS0''' ('''AD'''C '''P'''rescaler '''S'''elect 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 sein.
:Der Vorteiler muss also so eingestellt werden, dass die CPU-Taktfrequenz dividiert durch den Teilungsfaktor einen Wert zwischen 50-200kHz ergibt.
:Bei einer CPU-Taktfrequenz von 4MHz beispielsweise rechnen wir

:<math>
\begin{matrix}
TF_{min}=\frac{CLK}{200kHz}=\frac{4000000}{200000}=\mathbf{20}
\\
\\
TF_{max}=\frac{CLK}{50kHz}=\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.
<dl><dd>
{| style="" border="1"
|-
| align="center" | '''ADPS2'''
| align="center" | '''ADPS1'''
| align="center" | '''ADPS0'''
| align="center" | '''Teilungsfaktor'''
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 2
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 2
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 4
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| align="center" | 8
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 16
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| align="center" | 32
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| align="center" | 64
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| align="center" | 128
|}
</dd></dl>
|-
| '''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:

<pre class="code">
x = ADCL; // mit uint16_t x
x += (ADCH<<8); // in zwei Zeilen (LSB/MSB-Reihenfolge und
C-Operatorprioritaet sichergestellt)
</pre>

oder

<pre class="code">
x = ADCW; // je nach AVR auch x = ADC (siehe avr/ioxxx.h)
</pre>

|-
| '''ADMUX  '''
| '''AD'''C '''Mu'''ltiple'''x'''er 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:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''MUX2'''
| align="center" | '''MUX1'''
| align="center" | '''MUX0'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''MUX2...MUX0'''
:Mit diesem 3 Bits wird der zu messende Kanal bestimmt. Es wird einfach die entsprechende Pinnummer des Ports eingeschrieben.
:Wenn das Register beschrieben wird, während dem 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.

:Meine Empfehlung ist deswegen klar 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.
|}

==== Aktivieren des ADC ====

Um den ''' ADC''' zu aktivieren, müssen wir das '''ADEN'''-Bit im '''ADCSR'''-Register
setzen. Im gleichen Schritt legen wir auch gleich 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 mit Spannungsteiler konditionieren. Ergebnis der Routine ist der ADC-Wert, also 0 für 0-Volt und 1024 für V_ref-Volt.

<pre class="code">

uint16_t ReadChannel(uint8_t mux)
{
uint8_t i;
uint16_t result = 0; //Initialisieren wichtig, da lokale Variablen
//nicht automatisch initialisiert werden und
//zufällige Werte haben. Sonst kann Quatsch rauskommen
ADCSRA = (1<<ADEN) | (1<<ADPS1) | (1<<ADPS0); // Frequenzvorteiler
// setzen auf 8 (1) und ADC aktivieren (1)

ADMUX = mux; // Kanal waehlen
ADMUX |= (1<<REFS1) | (1<<REFS0); // interne Referenzspannung nutzen

/* 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



/* Eigentliche Messung - Mittelwert aus 4 aufeinanderfolgenden Wandlungen */
for(i=0;i<4;i++)
{
ADCSRA |= (1<<ADSC); // eine Wandlung "single conversion"

while ( ADCSRA & (1<<ADSC) ); // auf Abschluss der Konvertierung warten
result += ADCW; // Wandlungsergebnisse aufaddieren
}
ADCSRA &= ~(1<<ADEN); // ADC deaktivieren (2)

result /= 4; // Summe durch vier teilen = arithm. Mittelwert

return result;
}

...

/* Beispielaufrufe: */

void foo(void)
{
uint16_t adcval;

adcval = ReadChannel(0); /* MUX-Bits auf 0b0000 -> Channel 0 */
...
adcval = ReadChannel(2); /* MUX-Bits auf 0b0010 -> Channel 2 */
...
}

</pre>

Im Beispiel wird bei jedem Aufruf der ADC aktiviert und nach der Wandlung wieder abgeschaltet, das spart Strom. Will man dies nicht, verschiebt man die mit (1) gekennzeichneten Zeilen in eine Funktion adc_init() o.ä. und löscht die mit (2) markierten Zeilen. Das Löschen des ADIF-Flags sollte, '''entgegen''' der [http://www.nongnu.org/avr-libc/user-manual/FAQ.html#faq_intbits FAQ], mit
<pre class="code">
...
ADCSRA |= (1<<ADIF);
...
</pre>
erfolgen. Die Methode in der FAQ eignet sich nur für Register in denen '''nur''' Interrupt-Flags stehen.

=== 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 eine 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.

[[Image:Poti.gif]]

Wird der Portpin des Controllers auf Ausgang konfiguriert (im Beispiel ''DDRD |= (1<<PD3)'') und dieser Ausgang auf Logisch 1 ("High", ''PORTD |= (1<<PD3)'') 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<<PD3); PORTD &= (1<<PD3)''), 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 Thresholdspannung 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 Ohm Widerstand dient dem Schutz des Controllers. Es würde sonst bei Maximaleinstellung des Potentionmeters (hier 0 Ohm) ein zu hoher Strom fliessen, der die Eingangsstufe 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. Ein Beispielprogramm findet sich auf [http://www.mypage.bluewin.ch/ch_schifferle/ Christian Schifferles Web-Seite] im Archiv ''ATMEL.ZIP'', welches unter den Titel ''Tutorial "Programmieren mit C für Atmel Mikrocontroller'' heruntergeladen werden kann.



==== 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.

[[Image:ADC ueber Komparator.gif]]

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:

[[Image:DAC R2R.gif]]

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:

[[Image:PWM Theorie 1.gif]]

Diese Rechteckspannung hat nun einen geometrischen Mittelwert,
der je nach Pulsbreite kleiner oder grösser ist.

[[Image:PWM Theorie 2.gif]]

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

Mit den AVR's 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:

{| border="1"
|-
| align="center" | '''PWM11'''
| align="center" | '''PWM10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| PWM-Modus des Timers ist nicht aktiv.
|-
| align="center" | 0
| align="center" | 1
| 8-Bit PWM.
|-
| align="center" | 1
| align="center" | 0
| 9-Bit PWM.
|-
| align="center" | 1
| align="center" | 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:

{| border="1"
|-
| align="center" | '''Auflösung'''
| align="center" | '''Obergrenze'''
| '''Frequenz'''
|-
| align="center" | 8
| align="center" | 255
| fTC1 / 510
|-
| align="center" | 9
| align="center" | 511
| fTC1 / 1022
|-
| align="center" | 10
| align="center" | 1023
| fTC1 / 2046
|}

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

{| border="1"
|-
| align="center" | '''COM1A1'''
| align="center" | '''COM1A0'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Keine Wirkung, Pin wird nicht geschaltet.
|-
| align="center" | 0
| align="center" | 1
| Keine Wirkung, Pin wird nicht geschaltet.
|-
| align="center" | 1
| align="center" | 0
| Nicht invertierende PWM. 
Der Ausgangspin wird gelöscht beim Hochzählen und gesetzt beim
Herunterzählen.
|-
| align="center" | 1
| align="center" | 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 heisst dann:

<pre class="code">
TCCR1A = (1<<PWM11)|(1<<PWM10)|(1<<COM1A1);
</pre>

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.

{| border="1"
|-
| align="center" | '''CS12'''
| align="center" | '''CS11'''
| align="center" | '''CS10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stop. Der Timer/Counter wird gestoppt.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CK
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CK / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CK / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CK / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CK / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin 1, negative Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin 1, positive Flanke
|}

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

<pre class="code">
TCCR1B = (1<<CS12) | (1<<CS10);
</pre>

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

<pre class="code">
OCR1A = xxx;
</pre>

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

[[Image:PWM Theorie 3.gif]]

[[Image:PWM Theorie 4.gif]]

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.

= Die Timer/Counter des AVR =

Die heutigen Mikrocontroller und insbesondere die RISC-AVRs sind für viele Steuerungsaufgaben zu schnell. Wenn wir beispielsweise eine LED oder Lampe blinken lassen wollen, können wir selbstverständlich nicht die CPU-Frequenz verwenden, da ja dann nichts mehr vom Blinken zu bemerken wäre.

Wir brauchen also eine Möglichkeit, Vorgänge in Zeitabständen durchzuführen, die geringer als die Taktfrequenz des Controllers sind. Selbstverständlich sollte die resultierende Frequenz auch noch möglichst genau und stabil sein.

Hier kommen die im AVR vorhandenen Timer/Counter zum Einsatz.

Ein anderes Anwendungsgebiet ist die Zählung von Signalen, welche über einen I/O-Pin zugeführt werden können.

Die folgenden Ausführungen beziehen sich auf den AT90S2313. Für andere Modelltypen müsst ihr euch die allenfalls notwendigen Anpassungen aus den Datenblättern der entsprechenden Controller herauslesen.

Wir unterscheiden grundsätzlich zwischen 8-Bit Timern, welche eine Auflösung von 256 aufweisen und 16-Bit Timern mit (logischerweise) einer Auflösung von 65536. Als Eingangstakt für die Timer/Counter kann entweder die CPU-Taktfrequenz, der Vorteiler-Ausgang oder ein an einen I/O-Pin angelegtes Signal verwendet werden. Wenn ein externes Signal verwendet wird, so darf dessen Frequenz nicht höher sein als die Hälfte des CPU-Taktes.

== Der Vorteiler (Prescaler) ==


Der Vorteiler dient dazu, den CPU-Takt vorerst um einen einstellbaren Faktor zu reduzieren. Die so geteilte Frequenz wird den Eingängen der Timer zugeführt.

Wenn wir mit einem CPU-Takt von 4 MHz arbeiten und den Vorteiler auf 1024 einstellen, wird also der Timer mit einer Frequenz von 4 MHz / 1024, also mit ca. 4 kHz versorgt. Wenn also der Timer läuft, so wird das Daten- bzw. Zählregister (TCNTx) mit dieser Frequenz inkrementiert.

== 8-Bit Timer/Counter ==

Alle AVR-Modelle verfügen über mindestens einen, teilweise sogar zwei, 8-Bit Timer.

Der 8-Bit Timer wird z.B bei AT90S2313 über folgende Register angesprochen (bei anderen Typen weitestgehend analog):

{| border="1"
|-
| '''TCCR0'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister
Timer '''0'''

In diesem Register stellen wir ein, wie wir den Timer/Counter verwenden möchten.

Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''CS02'''
| align="center" | '''CS01'''
| align="center" | '''CS00'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''CS02, CS01, CS00''' ('''C'''lock '''S'''elect Bits)
:Diese 3 Bits bestimmen die Quelle für den Timer/Counter:
<dl><dd>
{| border="1"
|-
| align="center" | CS02
| align="center" | CS01
| align="center" | CS00
| Resultat
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stopp, Der Timer/Counter wird angehalten.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CPU-Takt
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CPU-Takt / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CPU-Takt / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CPU-Takt / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CPU-Takt / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin '''TO''', fallende Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin '''TO''', steigende Flanke
|}
</dd>
</dl>
:Wenn als Quelle der externe Pin '''TO''' verwendet wird, so wird ein Flankenwechsel auch erkannt, wenn der Pin '''TO''' als Ausgang geschaltet ist.

|-
| '''TCNT0'''
| '''T'''imer/'''C'''ou'''nt'''er Daten Register Timer '''0''' 
Dieses ist als 8-Bit Aufwärtszähler mit Schreib- und Lesezugriff
realisiert. Wenn der Zähler den Wert 255 erreicht hat beginnt er beim
nächsten Zyklus wieder bei 0.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}
|}

Um nun also den Timer0 in Betrieb zu setzen und ihn mit einer Frequenz von 1/1024-tel des CPU-Taktes zählen zu lassen, schreiben wir die folgende Befehlszeile:

<pre class="code">
TCCR0 |= (1<<CS00)|(1<<CS02);
</pre>

Der Zähler zählt nun aufwärts bis 255, um dann wieder bei 0 zu beginnen. Der aktuelle Zählerstand steht in TCNT0. Bei jedem Überlauf von 255 auf 0 wird das Timer Overflow Flag '''TOV0''' im Timer Interrupt Flag '''TIFR'''-Register gesetzt und, falls so konfiguriert, ein entsprechender Timer-Overflow-Interrupt ausgelöst und die daran gebundene Interrupt-Routine abgearbeitet.

== 16-Bit Timer/Counter ==

Viele AVR-Modelle besitzen ausser den 8-Bit Timern auch 16-Bit Timer. Die 16-Bit Timer/Counter sind etwas komplexer aufgebaut als die 8-Bit Timer/Counter, bieten dafür aber auch viel mehr Möglichkeiten, als da sind:

* Die [[PWM]]-Betriebsart Erzeugung eines pulsweitenmodulierten Ausgangssignals.
* Vergleichswert-Überprüfung mit Erzeugung eines Ausgangssignals (Output Compare Match).
* Einfangen eines Eingangssignals mit Speicherung des aktuellen Zählerwertes (Input Capturing), mit zuschaltbarer Rauschunterdrückung (Noise Filtering).

Folgende Register sind dem Timer/Counter 1 zugeordnet:

{| border="1"
|-
| '''TCCR1A'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister '''A''' Timer '''1''' 
In diesem und dem folgenden Register stellen wir ein, wie wir den Timer/Counter verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''COM1A1'''
| align="center" | '''COM1A0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''PWM11'''
| align="center" | '''PWM10'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''COM1A1''', '''COM1A0''' ('''Co'''mpare '''M'''atch Control Bits)
:Diese 2 Bits bestimmen die Aktion, welche am Output-Pin '''OC1''' ausgeführt werden soll, wenn der Wert des Datenregisters des Timer/Counter 1 den Wert des Vergleichsregisters erreicht, also ein so genannter Compare Match auftritt.
:Der Pin '''OC1''' ('''PB3''' beim 2313) muss mit dem Datenrichtungsregister als Ausgang konfiguriert werden.

<dl><dd>
{| border="1"
|-
| align="center" | COM1A1
| align="center" | COM1A0
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 0
| align="center" | 1
| Das Signal am Pin '''OC1''' wird invertiert (Toggle).
|-
| align="center" | 1
| align="center" | 0
| Der Output Pin '''OC1''' wird auf 0 gesetzt.
|-
| align="center" | 1
| align="center" | 1
| Der Output Pin '''OC1''' wird auf 1 gesetzt.
|}
</dd></dl>
:In der PWM-Betriebsart haben diese Bits eine andere Funktion.
<dl><dd>
{| border="1"
|-
| align="center" | COM1A1
| align="center" | COM1A0
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 0
| align="center" | 1
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 1
| align="center" | 0
| Wird beim Hochzählen der Wert im Vergleichsregister erreicht, so wird der Pin '''OC1''' auf 0 gesetzt.
Wird beim Herunterzählen der Wert im Vergleichsregister erreicht, so wird der Pin auf 1 gesetzt.

Man nennt dies ''nicht invertierende PWM''.
|-
| align="center" | 1
| align="center" | 1
| Wird beim Hochzählen der Wert im Vergleichsregister erreicht, so wird der Pin '''OC1''' auf 1 gesetzt.
Wird beim Herunterzählen der Wert im Vergleichsregister erreicht, so wird der Pin auf 0 gesetzt.

Man nennt dies ''invertierende PWM''.
|}
</dd></dl>

'''PWM11''', '''PWM10''' ('''PWM''' Mode Select Bits)
:Mit diesen 2 Bits wird die PWM-Betriebsart des Timer/Counter 1 gesteuert.
<dl><dd>
{| border="1"
|-
| align="center" | PWM11
| align="center" | PWM10
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Die PWM-Betriebsart ist nicht aktiviert. Timer/Counter 1 arbeitet als normaler Timer bzw. Zähler.
|-
| align="center" | 0
| align="center" | 1
| 8-Bit PWM Betriebsart aktivieren.
|-
| align="center" | 1
| align="center" | 0
| 9-Bit PWM Betriebsart aktivieren.
|-
| align="center" | 1
| align="center" | 1
| 10-Bit PWM Betriebsart aktivieren.
|}
</dd></dl>
|-
| '''TCCR1B'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister '''B''' Timer '''1'''

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''ICNC1'''
| align="center" | '''ICES1'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''CTC1'''
| align="center" | '''CS12'''
| align="center" | '''CS11'''
| align="center" | '''CS10'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''ICNC1''' ('''I'''nput '''C'''apture '''N'''oise '''C'''anceler (4 CKs) Timer/Counter 1
:oder auf Deutsch Rauschunterdrückung des Eingangssignals.
:Wenn dieses Bit gesetzt ist und mit dem Input Capture Signal gearbeitet wird so werden nach der Triggerung des Signals mit der entsprechenden Flanke (steigend oder fallend) am Input Capture Pin '''ICP''' jeweils 4 Messungen mit der CPU-Frequenz des Eingangssignals abgefragt. Nur dann, wenn alle 4 Messungen den gleichen Zustand aufweisen gilt das Signal als erkannt.

'''ICES1''' ('''I'''nput '''C'''apture '''E'''dge '''S'''elect Timer/Counter '''1''')
:Mit diesem Bit wird bestimmt, ob die steigende ('''ICES1'''=1) oder fallende ('''ICES1'''=0) Flanke zur Auswertung des Input Capture Signals an Pin '''ICP''' heran gezogen wird.

'''CTC1''' ('''C'''lear '''T'''imer/'''C'''ounter on Compare Match Timer/Counter '''1''')
:Wenn dieses Bit gesetzt ist, so wird nach einer Übereinstimmung des Datenregisters '''TCNT1H'''/'''TCNT1L''' mit dem Vergleichswert in '''OCR1H'''/'''OCR1L''' das Datenregister '''TCNT1H'''/'''TCNT1L''' auf 0 gesetzt.
:Da die Übereinstimmung im Takt nach dem Vergleich behandelt wird, ergibt sich je nach eingestelltem Vorteiler ein etwas anderes Zählverhalten:
:Wenn der Vorteiler auf 1 gestellt ist und C der jeweilige Zählerwert ist, dann nimmt das Datenregister, im CPU-Takt betrachtet, folgende Werte an:
:... | C-2 | C-1 | C | 0 | 1 |...
:Wenn der Vorteiler z.B. auf 8 eingestellt ist, dann nimmt das Datenregister folgende Werte an:
:... | C-2, C-2, C-2, C-2, C-2, C-2, C-2, C-2 | C-1, C-1, C-1, C-1, C-1, C-1, C-1, C-1 | C, 0, 0, 0, 0, 0, 0, 0 |...
:In der PWM-Betriebsart hat dieses Bit keine Funktion.

'''CS12''', '''CS11''', '''CS10''' ('''C'''lock '''S'''elect Bits)
:Diese 3 Bits bestimmen die Quelle für den Timer/Counter:
<dl><dd>
{| border="1"
|-
| align="center" | CS12
| align="center" | CS11
| align="center" | CS10
| Resultat
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stopp, Der Timer/Counter wird angehalten.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CPU-Takt
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CPU-Takt / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CPU-Takt / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CPU-Takt / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CPU-Takt / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin TO, fallende Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin T0, steigende Flanke
|}
</dd></dl>
:Wenn als Quelle der externe Pin T0 verwendet wird, so wird ein Flankenwechsel auch erkannt, wenn der Pin T0 als Ausgang geschaltet ist.
|-
| '''TCNT1H''' '''TCNT1L'''
| '''T'''imer/'''C'''ou'''nt'''er Daten Register Timer/Counter '''1'''
Dieses ist als 16-Bit Aufwärtszähler mit Schreib- und Lesezugriff realisiert. Wenn der Zähler den Wert 65535 erreicht hat, beginnt er beim nächsten Zyklus wieder bei 0.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''TCNT1H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''TCNT1L'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

In der PWM-Betriebsart wird das Register als Auf/Ab-Zähler verwendet, d.h. der Wert steigt zuerst von 0 bis er den Überlauf von 65535 auf 0 erreicht hat. Dann zählt das Register rückwärts wiederum bis 0.

Zum Auslesen des Registers wird von der CPU ein internes TEMP-Register verwendet. Das gleiche Register wird auch verwendet, wenn auf '''OCR1''' oder '''ICR1''' zugegriffen wird.

Deshalb müssen vor dem Zugriff auf eines dieser Register alle Interrupts gesperrt werden, weil sonst die Möglichkeit des gleichzeitigen Zugriffs auf das Temporärregister gegeben ist, was natürlich zu fehlerhaftem Verhalten des Programms führt.. Zudem muss zuerst '''TCNT1L''' und erst danach '''TCNT1H''' ausgelesen werden.

Wenn in das Register geschrieben werden soll, müssen ebenfalls alle Interrrupts gesperrt werden. Dann muss zuerst das '''TCNT1H'''-Register und erst danach das '''TCNT1L'''-Register geschrieben werden, also genau die umgekehrte Reihenfolge wie beim Lesen des Registers.
|-
| '''OCR1H''' '''OCR1L'''
| Timer/Counter '''O'''utput '''C'''ompare '''R'''egister Timer/Counter '''1'''
{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''OCR1H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''OCR1L'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

Der Wert im Output Compare Register wird ständig mit dem aktuellen Wert im Datenregister TCNT1H/TCNT1L verglichen. Stimmen die beiden Werte überein, so wird ein sogenannter Output Compare Match ausgelöst. Die entsprechenden Aktionen werden über die Timer/Counter 1 Control und Status Register eingestellt.

Zum Auslesen des Registers wird von der CPU ein internes TEMP-Register verwendet. Das gleiche Register wird auch verwendet, wenn auf '''OCR1''' oder '''ICR1''' zugegriffen wird.
Deshalb müssen vor dem Zugriff auf eines dieser Register alle Interrupts gesperrt werden, weil sonst die Möglichkeit des gleichzeitigen Zugriffs auf das Temporärregister gegeben ist, was natürlich zu fehlerhaftem Verhalten des Programms führt.. Zudem muss zuerst '''OCR1L''' und erst danach '''OCR1H''' ausgelesen werden.

Wenn in das Register geschrieben werden soll, müssen ebenfalls alle Interrupts gesperrt werden. Dann muss zuerst das '''OCR1H'''-Register und erst danach das '''OCR1L'''-Register geschrieben werden, also genau die umgekehrte Reihenfolge wie beim Lesen des Registers.
|-
| '''ICR1H''' '''ICR1L'''
| Timer/Counter '''I'''nput '''C'''apture '''R'''egister Timer/Counter '''1''' 
{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''ICR1''''''H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''ICR1''''''L'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

Das Input Capture Register ist ein 16-Bit Register mit Lesezugriff. Es kann nicht beschrieben werden.

Wenn am Input Capture Pin '''ICP''' die gemäß Einstellungen im '''TCCR1B''' definierte Flanke erkannt wird, so wird der aktuelle Inhalt des Datenregisters '''TCNT1H'''/'''TCNT1L''' sofort in dieses Register kopiert und das Input Capture Flag '''ICF1''' im Timer Interrupt Flag Register '''TIFR''' gesetzt.

Wie bereits oben erwähnt, müssen vor dem Zugriff auf dieses Register alle Interrupts gesperrt werden. Zudem müssen Low- und Highbyte des Registers in der richtigen Reihenfolge bearbeitet werden:

{| border="0"
|-
| Lesen:
| '''ICR1L''' -> '''ICR1H'''
|-
| Schreiben:
| '''ICR1H''' -> '''ICR1L'''
|}
|}

=== Die PWM-Betriebsart ===

Wenn der Timer/Counter 1 in der PWM-Betriebsart betrieben wird, so bilden das Datenregister '''TCNT1H'''/'''TCNT1L''' und das Vergleichsregister '''OCR1H'''/'''OCR1L''' einen 8-, 9- oder 10-Bit, frei laufenden PWM-Modulator, welcher als PWM-Signal am '''OC1'''-Pin ('''PB3''' beim 2313) abgegriffen werden kann. Das Datenregister '''TCNT1H'''/'''TCNT1L''' wird dabei als Auf-/Ab-Zähler betrieben, welcher von 0 an aufwärts zählt bis zur Obergrenze und danach wieder zurück auf 0.
Die Obergrenze ergibt sich daraus, ob 8-, 9- oder 10-Bit PWM verwendet wird, und zwar gemäss folgender Tabelle:

{| border="1"
|-
| align="center" | '''Auflösung'''
| align="center" | '''Obergrenze'''
| '''Frequenz'''
|-
| align="center" | 8
| align="center" | 255
| fTC1 / 510
|-
| align="center" | 9
| align="center" | 511
| fTC1 / 1022
|-
| align="center" | 10
| align="center" | 1023
| fTC1 / 2046
|}

Wenn nun der Zählerwert im Datenregister den in '''OCR1H'''/'''OCR1L''' gespeicherten Wert erreicht, wird der Ausgabepin '''OC1''' gesetzt bzw. gelöscht, je nach Einstellung von '''COM1A1''' und '''COM1A0''' im '''TCCR1A'''-Register.

Ich habe versucht, die entsprechenden Signale in der folgenden Grafik zusammenzufassen

[[Image:PWM Theorie 3.gif]]

[[Image:PWM Theorie 4.gif]]

=== Vergleichswert-Überprüfung ===

Hier wird in ein spezielles Vergleichswertregister ('''OCR1H'''/'''OCR1L''') ein Wert eingeschrieben, welcher ständig mit dem aktuellen Zählerwert verglichen wird.
Erreicht der Zähler den in diesem Register eingetragenen Wert, so kann ein Signal (0 oder 1) am Pin '''OC1''' erzeugt und/oder ein Interrupt ausgelöst werden.

=== Einfangen eines Eingangssignals (Input Capturing) ===

Bei dieser Betriebsart wird an den Input Capturing Pin (ICP) des Controllers eine Signalquelle angeschlossen.
Nun kann je nach Konfiguration entweder ein Signalwechsel von 0 nach 1 (steigende Flanke) oder von 1 nach 0 (fallende Flanke) erkannt werden und der zu diesem Zeitpunkt aktuelle Zählerstand in ein spezielles Register abgelegt werden. Gleichzeitig kann auch ein entsprechender Interrupt ausgelöst werden.
Wenn die Signalquelle ein starkes Rauschen beinhaltet, kann die Rauschunterdrückung eingeschaltet werden. Dann wird beim Erkennen der konfigurierten Flanke über 4 Taktzyklen das Signal überwacht und nur dann, wenn alle 4 Messungen gleich sind, wird die entsprechende Aktion ausgelöst.

== Gemeinsame Register ==

Verschiedene Register beinhalten Zustände und Einstellungen, welche sowohl
für den 8-Bit, als auch für den 16-Bit Timer/Counter in ein und demselben
Register zu finden sind.

{| border="1"
|-
| '''TIMSK'''
| '''T'''imer/Counter '''I'''nterrupt '''M'''a'''sk'''
Register

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''TOIE1'''
| align="center" | '''OCIE1A'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''TICIE'''
| align="center" | '''-'''
| align="center" | '''TOIE0'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''TOIE1''' ('''T'''imer/Counter '''O'''verflow '''I'''nterrupt '''E'''nable Timer/Counter '''1''')
:Wenn dieses Bit gesetzt ist, wird bei einem Überlauf des Datenregisters des Timer/Counter 1 ein Timer Overflow 1 Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''OCIE1A''' ('''O'''utput '''C'''ompare Match '''I'''nterrupt '''E'''nable Timer/Counter '''1''')
:Beim Timer/Counter 1 kann zusätzlich zum Überlauf ein Vergleichswert definiert werden.

:Wenn dieses Bit gesetzt ist, wird beim Erreichen des Vergleichswertes ein Compare Match Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''TICIE''' ('''T'''imer/Counter '''I'''nput '''C'''apture '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein Capture Event Interrupt ausgelöst, wenn ein entsprechendes Signalereignis am Pin PD6(ICP) auftritt. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein, wenn auch ein entsprechender Interrupt ausgelöst werden soll.

'''TOIE0''' ('''T'''imer/Counter '''O'''verflow '''I'''nterrupt '''E'''nable Timer/Counter '''0''')
:Wenn dieses Bit gesetzt ist, wird bei einem Überlauf des Datenregisters des Timer/Counter 0 ein Timer Overflow 0 Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

|-
| '''TIFR'''
| '''T'''imer/Counter '''I'''nterrupt '''F'''lag '''R'''egister

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''TOV1'''
| align="center" | '''OCF1A'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''ICF1'''
| align="center" | '''-'''
| align="center" | '''TOV0'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''TOV1''' ('''T'''imer/Counter '''O'''verflow Flag Timer/Counter '''1''')
:Dieses Bit wird vom Controller gesetzt, wenn beim Timer 1 ein Überlauf des Datenregisters stattfindet.

:In der PWM-Betriebsart wird das Bit gesetzt, wenn die Zählrichtung von auf- zu abwärts und umgekehrt geändert wird (Zählerwert = 0).

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''OCF1A''' ('''O'''utput '''C'''ompare '''F'''lag Timer/Counter '''1''')
:Dieses Bit wird gesetzt, wenn der aktuelle Wert des Datenregisters von Timer/Counter 1 mit demjenigen im Vergleichsregister '''OCR1''' übereinstimmt.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''ICF1''' ('''I'''nput '''C'''apture '''F'''lag Timer/Counter '''1''')
:Dieses Bit wird gesetzt, wenn ein Capture-Ereignis aufgetreten ist, welches anzeigt, dass der Wert des Datenregisters des Timer/Counter 1 in das Input Capture Register ICR1 übertragen wurde.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''TOV0''' ('''T'''imer/Counter '''O'''verflow Flag Timer/Counter '''0''')
:Dieses Bit wird vom Controller gesetzt, wenn beim Timer 0 ein Überlauf des Datenregisters stattfindet.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.
|}

 

= 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 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_mode()'''
:Versetzt den Controller in den mit set_sleep_mode gewählten Schlafmodus.

<pre class="code">
#include <avr/io.h>
#include <avr/sleep.h>
...
set_sleep_mode(SLEEP_MODE_PWR_DOWN);
sleep_mode();

// Code hier wird erst nach Auftreten eines entsprechenden
// "Aufwach-Interrupts" verarbeitet
...
</pre>

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:

<pre class="code">
#include <avr/io.h>
...
// Sleep-Mode "Power-Save" beim ATmega169 "manuell" aktivieren
SMCR = (3<<SM0) | (1<<SE);
asm volatile ("sleep"::);
...
</pre>

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Power Management and Sleep-Modes

= Der Watchdog =

Und hier kommt das ultimative Mittel gegen die Unvollkommenheit von uns
Programmierern, der Watchdog.

So sehr wir uns auch anstrengen, es wird uns kaum je gelingen, das absolut
perfekte und fehlerfreie Programm zu entwickeln.

Der Watchdog kann uns zwar auch nicht zu besseren Programmen verhelfen aber er
kann dafür sorgen, dass unser Programm, wenn es sich wieder mal in's Nirwana
verabschiedet hat, neu gestartet wird, indem ein Reset des Controllers
ausgelöst wird.

Betrachten wir doch einmal folgende Codesequenz:

<pre class="code">
uint8_t x;

x = 10;

while (x >= 0) {
// tu was

x--;
}
</pre>

Wenn wir die Schleife mal genau anschauen sollte uns auffallen, dass dieselbe niemals beendet wird. Warum nicht? Ganz einfach, weil eine als '''''unsigned''''' deklarierte Variable niemals kleiner als Null werden kann (der Compiler sollte jedoch eine ensprechende Warnung ausgeben).
Das Programm würde sich also hier aufhängen und auf ewig in der Schleife drehen.
Und hier genau kommt der Watchdog zum Zug.

== Wie funktioniert nun der Watchdog ==

Der Watchdog enthält einen separaten Timer/Counter, welcher mit einem intern erzeugten Takt von 1 MHz bei 5V Vcc getaktet wird.
Nachdem der Watchdog aktiviert und der gewünschte Vorteiler eingestellt wurde beginnt der Counter von 0 an hochzuzählen.
Wenn nun die je nach Vorteiler eingestellte Anzahl Zyklen erreicht wurde, löst der Watchdog einen Reset aus. Um nun also im Normalbetrieb den Reset zu verhindern müssen wir den Watchdog regelmässig wieder neu starten bzw. Rücksetzen (Watchdog Reset).
Dies sollte innerhalb unserer Hauptschleife passieren.

Um ein unbeabsichtigtes Ausschalten des Watchdogs zu verhindern muss ein spezielles Prozedere verwendet werden, um den WD auszuschalten und zwar müssen zuerst die beiden Bits WDTOE und WDE in einer einzelnen Operation (also nicht mit sbi) auf 1 gesetzt werden.
Dann muss innerhalb der nächsten 4 Taktzyklen das Bit WDE auf 0 gesetzt werden.

Das Watchdog Control Register:

{| border="1"
|-
| '''WDTCR'''
| '''W'''atchog '''T'''imer  '''C'''ontrol '''R'''egister

In diesem Register stellen wir ein, wie wir den Watchdog verwenden möchten.

Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''WDTOE'''
| align="center" | '''WDE'''
| align="center" | '''WDP2'''
| align="center" | '''WDP1'''
| align="center" | '''WDP0'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''WDTOE''' ('''W'''atch'''d'''og '''T'''urn '''O'''ff '''E'''nable)
:Dieses Bit muss gesetzt sein, wenn das Bit '''WDE''' gelöscht wird, andernfalls wird der Watchdog nicht ausgeschaltet.
:Wenn das Bit einmal gesetzt ist wird es von der Hardware nach 4 Taktzyklen automatisch wieder gelöscht.

'''WDE''' ('''W'''atch'''d'''og '''E'''nable)
:Wenn dieses Bit gesetzt wird, so wird der Watchdog aktiviert.
:Das Bit kann nur gelöscht werden, solange das Bit '''WDTOE''' auf 1 steht.

'''WDP2''', '''WDP1''', '''WDP0''' ('''W'''atch'''d'''og Timer '''P'''rescaler Bits)
:Diese 3 Bits bestimmen die Anzahl Oszillatorzyklen für den Watchdog, also, wie lange es dauert, bis ein Reset ausgelöst wird:
<dl><dd>
{| border="1"
|-
| align="center" | WDP2
| align="center" | WDP1
| align="center" | WDP0
| align="center" | Anzahl Zyklen
| align="center" | Typ. Timeoutzeit bei Vcc = 3V
| align="center" | Typ. Timeoutzeit bei Vcc = 5V
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 16K
| align="center" | 47ms
| align="center" | 15ms
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 32K
| align="center" | 94ms
| align="center" | 30ms
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 64K
| align="center" | 0.19s
| align="center" | 60ms
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| align="center" | 128K
| align="center" | 0.38s
| align="center" | 0.12s
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 256K
| align="center" | 0.75s
| align="center" | 0.24s
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| align="center" | 512K
| align="center" | 1.5s
| align="center" | 0.49s
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| align="center" | 1024K
| align="center" | 3s
| align="center" | 0.97s
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| align="center" | 2048K
| align="center" | 6s
| align="center" | 1.9s
|}
</dd></dl>
|}

Um den Watchdog mit dem AVR-GCC Compiler zu verwenden, muss die Headerdatei ''wdt.h'' (''#include <avr/wdt.h>'') in die Quelldatei eingebunden werden.

Danach können die folgenden Funktionen verwendet werden:

* '''wdt_enable(uint8_t timeout)'''
:Aktiviert den Watchdog und stellt den Vorteiler auf den gewünschten Wert ein bzw. der in timeout übergebene Wert wird in das WDTCR-Register eingetragen. Einige Timeout-Werte sind als Konstanten vordefiniert
:Mögliche Timeoutwerte:
<div align="center">
{| border="1"
! Konstante
! Wert
! TimeOut
|-
| WDTO_15MS
| 0
| 15 ms
|-
| WDTO_30MS
| 1
| 30 ms
|-
| WDTO_60MS
| 2
| 60 ms
|-
| WDTO_120MS
| 3
| 120 ms
|-
| WDTO_250MS
| 4
| 250 ms
|-
| WDTO_500MS
| 5
| 500 ms
|-
| WDTO_1S
| 6
| 1 S
|-
| WDTO_2S
| 7
| 2s
|}
</div>
* '''wdt_disable()'''
:Mit dieser Funktion kann der Watchdog ausgeschaltet werden. Dabei wird das notwendige Prozedere, wie oben beschrieben, automatisch ausgeführt.
* '''wdt_reset()'''
:Dies ist wohl die wichtigste der Watchdog-Funktionen. Sie erzeugt einen Watchdog-Reset, welcher periodisch, und zwar vor Ablauf der Timeoutzeit, ausgeführt werden muss, damit der Watchdog nicht den AVR zurücksetzt.

Selbstverständlich kann das '''WDTCR'''-Register auch mit den uns bereits bekannten Funktionen für den Zugriff auf Register programmiert werden.

== Watchdog-Anwendungshinweise ==

Ob nun der Watchdog als Schutzfunktion überhaupt verwendet werden soll, hängt stark von der Anwendung, der genutzten Peripherie und dem Umfang und der Qualitätssicherung des Codes ab. Will man sicher gehen, dass ein Programm sich nicht in einer Endlosschleife verfängt, ist der Wachdog das geeignete Mittel dies zu verhindern. Weiterhin kann bei geschickter Programmierung der Watchdog dazu genutzt werden, bestimmte Stromsparfunktionen zu implementieren. Ausserdem bietet der WD die einzige Möglichkeit einen beabsichtigten System-Reset (ein "richtiger Reset", kein "jmp 0x0000") ohne externe Beschaltung auszulösen, was z.B. bei der Implementierung eines Bootloaders nützlich ist. Bei bestimmten Anwendungen kann die Nutzung des WD als "ultimative Deadlock-Sicherung für nicht bedachte Zustände" natürlich immer als zusätzliche Sicherung dienen.

Es besteht die Möglichkeit herauszufinden, ob ein Reset durch den Watchdog ausgelöst wurde (beim ATmega16 z.B. Bit WDRF in MCUCSR). Diese Information sollte auch genutzt werden, falls ein WD-Reset in der Anwendung nicht planmässig implementiert wurde. Zum Beispiel kann man eine LED an einen freien Pin hängen, die nur bei einem Reset durch den WD aufleuchtet oder aber das "Ereignis WD-Reset" im internen EEPROM des AVR absichern, um die Information später z.B. über UART oder ein Display auszugeben (oder einfach den EEPROM-Inhalt über die ISP/JTAG-Schnittstelle auslesen).

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Watchdog timer handling

= 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.

[[Image:Interrupt Programme.gif]]

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.

[http://www.mikrocontroller.net/forum/read-1-235092.html#new Ausführlicher Thread im Forum]

== Anforderungen an Interrupt-Routinen ==

Um unliebsamen Überraschungen vorzubeugen, sollten einige Grundregeln bei der Implementierung der Interruptroutinen beachtet werden. Interruptroutinen soll 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.

== 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 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.

{| border="1"
|-
| '''GIMSK'''
| '''G'''eneral '''I'''nterrupt '''M'''ask '''R'''egister. 

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''INT1'''
| align="center" | '''INT0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''INT1''' (External '''Int'''errupt 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 '''Int'''errupt 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'''
| '''G'''eneral '''I'''nterrupt '''F'''lag '''R'''egister.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''INTF1'''
| align="center" | '''INTF0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''INTF1''' (External '''Int'''errupt Flag '''1''')
:Dieses Bit wird gesetzt, wenn am '''INT1'''-Pin eine Interrupt-Kondition, entsprechend der Konfiguration, 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 '''Int'''errupt Flag '''0''')
:Dieses Bit wird gesetzt, wenn am '''INT0'''-Pin eine Interrupt-Kondition, entsprechend der Konfiguration, 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''' '''C'''ontrol '''R'''egister.

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

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''SE'''
| align="center" | '''SM'''
| align="center" | '''ISC11'''
| align="center" | '''ISC10'''
| align="center" | '''ISC01'''
| align="center" | '''ISC00'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''SE''' ('''S'''leep '''E'''nable)
: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''' ('''S'''leep '''M'''ode)
:Dieses Bit bestimmt der 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''' ('''I'''nterrupt '''S'''ense '''C'''ontrol '''1''' Bits)
:Diese beiden Bits bestimmen, ob die steigende oder die fallende Flanke für die Interrupterkennung am '''INT1'''-Pin ausgewertet wird.
<dl><dd>
{| border="1"
|-
| align="center" | '''ISC11'''
| align="center" | '''ISC10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Low Level an '''INT1''' erzeugt einen Interrupt.

In der Beschreibung heisst es, der Interrupt wird getriggert, solange der Pin auf 0 bleibt, also eigentlich unbrauchbar.
|-
| align="center" | 0
| align="center" | 1
| Reserviert
|-
| align="center" | 1
| align="center" | 0
| Die fallende Flanke an '''INT1''' erzeugt einen Interrupt.
|-
| align="center" | 1
| align="center" | 1
| Die steigende Flanke an '''INT1''' erzeugt einen Interrupt.
|}
</dd></dl>
'''ISC01''', '''ISC00''' ('''I'''nterrupt '''S'''ense '''C'''ontrol '''0''' Bits)
:Diese beiden Bits bestimmen, ob die steigende oder die fallende Flanke für die Interrupterkennung am '''INT0'''-Pin ausgewertet wird.

<dl><dd>
{| border="1"
|-
| align="center" | '''ISC01'''
| align="center" | '''ISC00'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Low Level an '''INT0''' erzeugt einen Interrupt.

In der Beschreibung heisst es, der Interrupt wird getriggert, solange der Pin auf 0 bleibt, also eigentlich unbrauchbar.
|-
| align="center" | 0
| align="center" | 1
| Reserviert
|-
| align="center" | 1
| align="center" | 0
| Die fallende Flanke an '''INT0''' erzeugt einen Interrupt.
|-
| align="center" | 1
| align="center" | 1
| Die steigende Flanke an '''INT0''' erzeugt einen Interrupt.
|}
</dd></dl>
|}

== 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, rate ich dringend davon ab. 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'').

<pre class="code">
// fuer sei(), cli() und ISR():
#include <avr/interrupt.h>

</pre>

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

<pre class="code">
sei();
</pre>

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

<pre class="code">
cli();
</pre>

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 Interrups aktivieren, was zu unerwünschten Seiteneffekten führen kann. Die aus dem folgenden Beispiel ersichtliche Vorgehensweise ist in solchen Fällen vorzuziehen:

<pre class="code">
#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!
...

}
</pre>



Nachdem nun die Interrupts aktiviert sind, braucht es selbstverständlich noch den auszuführenden Code, der ablaufen soll, wenn ein Interrupt eintrifft. Dazu existiert die Definition (ein Makro) '''ISR'''. SIGNAL sollte nicht mehr genutzt werden, zur Portierung von SIGNAL nach ISR siehe Abschnitt (TODO: verlinken) im Anhang.


=== ISR ===

(''ISR()'' ersetzt bei neueren Versionen der avr-libc ''SIGNAL()''. vgl. Anhang (TODO:link))



<pre class="code">
#include <avr/interrupt.h>
...
ISR(Vectorname) /* vormals: SIGNAL(siglabel) dabei Vectorname != siglabel ! */
{
/* Interrupt Code */
}
</pre>

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.

<pre class="code">
[...]
/* $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)

[...]
</pre>


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

<pre class="code">
#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...
</pre>

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 Interuptroutinen ===

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



<pre class="code">
#include <avr/interrupt.h>
...
void XXX_vect(void) __attribute__((interrupt));
void XXX_vect(void) {
...
}
</pre>

Hierbei steht XXX für den oben beschriebenen Namen des Vektors (also z.B. ''void TIMER0_OVF_vect(void)...''). Der Unterschied im Vergleich zu ISR ist, dass bei hier beim Aufrufen der Funktion das '''Global Enable Interrupt''' Bit automatisch wieder gesetzt und somit weitere Interrupts zugelassen werden. Dies kann zu nicht unerheblichen Problemen von im einfachsten Fall einem Stack overflow bis zu sonstigen unerwarteten Effekten führen und sollte wirklich '''nur dann''' angewendet werden, wenn man sich absolut sicher ist, das Ganze auch im Griff zu haben. 

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.

<pre class="code">
#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 uebrigen
// Programmteile muessen 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" */
}
}
...
}
</pre>

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 ausserhalb der ISR nicht durch einen Interrupt unterbrochen werden. (Allgemeinplatz: AVRs sind 8-bit Controller). Zur Veranschaulichung ein Codefragment:

<pre class="code">
...
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 veraendert.
tmpCnt = gMyCounter16bit;

// besser: Aenderungen "ausserhalb" verhindern -> alle "Teilbytes"
// bleiben konsistent
cli(); // Interupts 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 */
...
}
</pre>

== 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:

<pre class="code">
#include <avr/io.h>

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

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

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

<pre class="code">
...
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)
...
</pre>

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 Unterbrechnungen 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 Unterbrechnungen. 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 ausserhalb dieses Adressbereichs ("Memory-Mapped"-Register) werden auch zur Manipulation einzelner Bits abhängige Anweisungen erzeugt (lds,...,sts).

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Frequently asked Questions/Fragen Nr. 1 und 8 (Stand: avr-libc Vers. 1.0.4)

== 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 ausserdem möglicherweise Probleme durch Interruptroutinen, die zu viel Verarbeitungszeit benötigen.

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

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Interrupts and Signals

= 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 [http://lightner.net/avr/ATtinyAvrGcc.html "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 und ATtiny26 der "tiny-Reihe" gelten die Ausführungen ebenfalls.

== 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.

== 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). 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.

<pre class="code">
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <inttypes.h>

...

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

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

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

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

void foo(void)
{
static /*const*/ uint8_t pgmTestByteLocal PROGMEM = 0x55;
static /*const*/ char pgmTestStringLocal[] PROGMEM = "im Flash";
...
</pre>

=== 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.

<pre class="code">
// 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....
}
</pre>

=== Wort lesen ===

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

<pre class="code">
uint16_t myWord;

myWord = pgm_read_word(&pgmFooWord);
</pre>

Zeiger auf Werte im Flash sind ebenfalls 16 Bits "gross" (Stand avr-gcc 3.4.x). Damit ist der mögliche Speicherbereich für "Flash-Konstanten" auf 64kB begrenzt. 

<pre class="code">
uint8_t *ptrToArray;

ptrToArray = (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 muß 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 = (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)
}
</pre>

=== Floats und Structs lesen ===

Um komplexe Datentypen (structs), nicht-integer Datentypen (floats) aus dem Flash auszulesen, sind Hilfsfunktionen erforderlich. Einige Beispiele:

<pre class="code">
/* Beispiel float aus Flash */

float pgmFloatArray[3] PROGMEM = {1.1, 2.2, 3.3};
...

/* liest float von Flash-Addresse addr und gibt diese als return-value zurueck */
inline float pgm_read_float(const float *addr)
{
union
{
uint16_t i[2]; // 2 16-bit-Worte
float f;
} u;

u.i[0]=pgm_read_word((PGM_P)addr);
u.i[1]=pgm_read_word((PGM_P)addr+2);

return u.f;
}
...

void egal(void)
{
int i;
float f;

for (i=0;i<3;i++) {
f = pgm_read_float(&pgmFloatArray[i]); // entspr. "f = pgmFloatArray[i];"
// mach' was mit f
}
}
</pre>

TODO: Beispiele fuer structs und pointer aus flash auf struct im flash (menues, state-machines etc.)

=== 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.

<pre class="code">
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <string.h>

#define MAXLEN 30

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

...
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 wuerde ausgefuehrt, die ersten 5 Zeichen stimmen ueberein
}
else {
// wuerde bei nicht-Uebereinstimmung ausgefuehrt
}
...
</pre>

Aber Vorsicht: Ersetzt man zum Beispiel
<pre class="code">
const char textImFlashOK[] PROGMEM = "mit[]";
// = Daten im "Flash", textImFlashOK* zeigt auf Flashadresse
</pre>
durch
<pre class="code">
const char* textImFlashProblem PROGMEM = "mit*";
// Konflikt: Daten im BSS (lies: RAM), textImFlashFAIL* zeigt auf Flashadresse
</pre>
dann kann es zu Problemen mit AVR-GCC kommen. Zu erkennen daran, dass der Initialisierungsstring von "textImFlashProblem" zu den Konstanten ans Ende des Programmcodes gelegt wird (BSS), von dem aus er zur Benutzung eigentlich ins RAM kopiert werden sollte (und wird). Da der lesende Code (mittels pgm_read*) trotzdem an einer Stelle vorne im Flash sucht, wird Unsinn gelesen. Dies scheint ein weiters Problem des AVR-GCC (gesehen bei avr-gcc 3.4.1 und 3.4.2) bei der Anpassung an die Harvard-Architektur zu sein (konstanter Pointer auf variable Daten?!). Abhilfe ("Workaround"): Initialisierung bei Zeichenketten mit [] oder gleich im Code PSTR("...") nutzen.

Übergibt man Zeichenketten (genauer: die Adresse des ersten Zeichens), die im Flash abglegt sind an eine Funktion, muss diese entsprechend programmiert sein. Die Funktion selbst hat keine Möglichkeit zu unterscheiden, ob es sich um eine Adresse im Flash oder im RAM 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 (oder _P) versehen sind.

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:

<pre class="code">
// 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 (wieauchimmmer.c)
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <string.h>
#include "lcd.h"

char StringImFlash[] PROGMEM = "Erwin Lindemann"; // im "Flash"

...
lcd_puts_p(StringImFlash);
lcd_puts_P("Dr. Kloebner");
// daraus wird wg. #define lcd_put_P...: lcd_puts_p( PSTR("Dr. Kloebner") );
...
</pre>

=== Flash in der Anwendung schreiben ===

Bei AVRs mit "self-programming"-Option (auch bekannt als Bootloader-Support) können Teile des Flash-Speichers auch vom Anwendungsprogramm selbst beschrieben werden. Dies ist nur möglich, wenn die Schreibfunktionen in einem besonderen Speicherbereich (boot-section) des Programmspeichers/Flash abgelegt sind. Bei wenigen "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.

=== 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 (einen Pointer, z.B. 0x01fe), "weiss" die Funktion nicht, ob die Adresse auf den Flash-Speicher oder den/das RAM zeigt. Allein aus dem Pointer-Wert (der Zahl) kann nicht geschlossen werden, ob ein "einfaches" zeichen_an_uart(s[i]) oder zeichen_an_uart(pgm_read_byte(&s[i]) genutzt werden muss, um das i-te Zeichen auszugeben.

Einige AVR-Compiler "tricksen" etwas, in dem sie für einen Pointer nicht nur die Adresse anlegen, sondern zusätzlich zu jedem Pointer den Ablageort (Flash oder RAM) intern sichern. Bei Aufruf einer Funktion wird dann bei Pointer-Parametern neben der Adresse auch der Speicherbereich, auf den der Pointer zeigt, übergeben. Dies hat jedoch nicht nur Vorteile; Erläuterungen warum dies so ist, führen an dieser Stelle zu weit.

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html 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ässig 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.

Der Compiler schreibt den aus der Variablendeklaration abgeleiteten EEPROM Inhalt in die eine Datei (.eep), die zusätzlich zum Flashen des Programms in den Mikrocontroller geschrieben werden muß. Sonst wird beim Lesen zufälliger Datenmüll zurückgegeben.

Bei der Deklaration einer Variable im EEPROM, ist das Attribut für die Section ".eeprom" zu ergänzen. 

<pre class="code">
#include <avr/io.h>
#include <avr/eeprom.h>
#include <avr/interrupt.h>
#include <inttypes.h> // wird in aktuellen Versionen der avr-lib mit xx.h eingebunden

// EEMEM wird bei aktuellen Versionen der avr-lib in eerpom.h definiert
// hier: definiere falls noch nicht bekannt ("alte" avr-libc)
#ifndef EEMEM
// alle Textstellen EEMEM im Quellcode durch __attribute__ ... ersetzen
#define EEMEM __attribute__ ((section (".eeprom")))
#endif

...

/* Byte */
uint8_t eeFooByte EEMEM = 123;

/* Wort */
uint16_t eeFooWord EEMEM = 12345;

/* float */
float eeFooFloat EEMEM;

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

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

=== Bytes lesen/schreiben ===

Die avr-libc Funktion zum Lesen eines Bytes heisst 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:

<pre class="code">
...
uint8_t myByte;

myByte = eeprom_read_byte(&eeFooByte); // lesen
// myByte hat nun den Wert 123
...
myByte = 99;
eeprom_write_byte(&eeFooByte, myByte); // schreiben
...
myByte = eeprom_read_byte(&eeFooByteArray1[1]);
// myByte hat nun den Wert 3
...
</pre>

=== Wort lesen/schreiben ===

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

<pre class="code">
...
uint16_t myWord;

myWord = eeprom_read_word(&eeFooWord); // lesen
// myWord hat nun den Wert 12345
...
myWord = 2222;
eeprom_write_word(&eeFooWord, myWord); // schreiben
...
</pre>

=== 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 (size_t).

TODO: '''Vorsicht!''' die folgenden Beispiele sind noch nicht geprueft, erstmal nur als Hinweis auf "das Prinzip". Evtl. fehlen "casts" und mglw. noch mehr.

<pre class="code">
...
uint8_t myByteBuffer[3];
uint16_t myWordBuffer[4];

/* Datenblock aus EEPROM LESEN */

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

/* dito etwas anschaulicher aber "unnuetze Tipparbeit": */
eeprom_read_block(&myByteBuffer[0],&eeFooByteArray[0],3);

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

/* und nun mit "16bit" */
eeprom_read_block(myWordBuffer,eeFooWordArray1,sizeof(myWordBuffer));

/* Datenlock in EEPROM SCHREIBEN */
eeprom_write_block(myByteBuffer,eeFooByteArray1,sizeof(myByteBuffer));
eeprom_write_block(myWordBuffer,eeFooWordArray1,sizeof(myWordBuffer));
...
</pre>

"Nicht-Integer"-Datentypen wie z.B. Fliesskommazahlen lassen sich recht praktisch über eine ''union'' in "Byte-Arrays" konvertieren und wieder "zurückwandeln". Dies erweist sich hier (aber nicht nur hier) als nützlich.

<pre class="code">
...
float myFloat = 12.34;

union {
float r;
uint8_t i[sizeof(float)];
} u;

u.r = myFloat;

/* float in EEPROM */
eeprom_write_block(&(u.i),&eeFooFloat,sizeof(float));

/* float aus EEPROM */
eeprom_read_block(&(u.i),&eeFooFloat,sizeof(float));
/* u.r wieder 12.34 */
...
</pre>

Auch zusammengesetzte Typen lassen sich mit den Block-Routinen verarbeiten.

<pre class="code">
...
typedef struct {
uint8_t label[8];
uint8_t rom_code[8];
} tMyStruct;

#define MAXSENSORS 3
tMyStruct eeMyStruct[MAXSENSORS] EEMEM;

...

void egal(void)
{
tMyStruct work;

strcpy(work.label,"Flur");
GetRomCode(work.rom_code); // Dummy zur Veranschaulichung - setzt rom-code

/* Sichern von "work" im EEPROM */
eeprom_write_block(&work,&eeMyStruct[0],sizeof(tMyStruct)); // f. Index 0
strcpy(work.label,"Bad");
GetRomCode(work.rom_code);
eeprom_write_block(&work,&eeMyStruct[1],sizeof(tMyStruct)); // f. Index 1
...
/* Lesen der Daten EEPROM Index 0 in "work" */
eeprom_read_block(&work,&eeMyStruct[0],sizeof(tMyStruct));
// work.label hat nun den Inhalt "Flur"
...
}
...
</pre>

=== EEPROM-Speicherabbild in .eep-Datei ===

Eine besondere Funktion des avr-gcc ist, dass mit entsprechenden Optionen im Makefile aus den Initialisierungswerten der Variablen im Quellcode eine Datei erzeugt werden kann, die man auf den Controller programmieren kann (.eep-Datei). Damit können sehr elegant Standardwerte für den EEPROM-Inhalt im Quellcode definiert werden. Die Vorgehensweise wird aus dem WinAVR-Beispielmakefile ersichtlich. Siehe dazu die Erläuterungen im Abschnitt Exkurs: Makefiles.

=== Bekannte Probleme bei den EEPROM-Funktionen ===

Vorsicht: Bei alten Versionen der avr-libc wurden nicht alle AVR Controller untersü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: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/EEPROM handling

= Die Nutzung von printf =

Um komfortabel Ausgaben auf ein Display oder die serielle Schnittstelle zu tätigen, bietet sich printf/sprintf an.
<pre class="code">
...
#include <stdio.h>
#include <stdint.h>

uint16_t counter;
uint8_t s[20];
...
sprintf( s, "Zählerstand: %d", counter);
LCDSoftText( s, x, y);
...
</pre>

Die Funktion LCDSoftText muss natürlich dafür sorgen, dass die Zeichenkette auf das Display kommt.

Eine weitere elegante Möglichkeit, bietet sich darin, die Ausgabe stdout auf eigene Funktionen umzubiegen:
<pre class="code">
#include <stdio.h>
static int uart_putchar(char c, FILE *stream);
static FILE mystdout = FDEV_SETUP_STREAM(uart_putchar, NULL,
_FDEV_SETUP_WRITE);
static int
uart_putchar(char c, FILE *stream)
{
if (c == ?\n?)
uart_putchar(?\r?);
loop_until_bit_is_set(UCSRA, UDRE);
UDR = c;
return 0;
}

int
main(void)
{
init_uart();
stdout = &mystdout;
printf("Hello, world!\n");
return 0;
}
</pre>
(Quelle: avr-libc-user-manual-1.4.3.pdf, S.74)

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

Der Nachteil aller printf-Varianten: sie sind recht speicherintensiv.

= Assembler und Inline-Assembler =

Gelegentlich erweist es sich als nützlich, C und Assembler-Code in einer Anwendung zu nutzen. Typischerweise wird das Hauptprogramm in C verfasst und wenige, extrem zeitkritische oder hardwarenahe Operationen in Assembler.

Die "gnu-Toolchain" bietet dazu zwei Möglichkeiten:

; Inline-Assembler : Die Assembleranweisungen werden direkt in den C-Code integriert. Eine Quellcode-Datei enthält somit C- und Assembleranweisungen

; Assembler-Dateien : Der Assembler-Codecode befindet sich in eigenen Quellcodedateien. Diese werden vom gnu-Assembler (avr-as) zu Object-Dateien assembliert ("compiliert") und mit den aus dem C-Code erstellten Object-Dateien zusammengebunden (gelinkt).

== Inline-Assembler ==

Inline-Assembler bietet sich an, wenn nur wenig Assembleranweisungen benötigt werden. Typische Anwendung sind kurze Codesequenzen für zeitkritische Operationen in Interrupt-Routinen oder sehr präzise Warteschleifen (z.B. 1-Wire). Inline-Assembler wird mit '''asm volatile''' eingeleitet, die Assembler-Anweisungen werden in einer Zeichenkette zusammengefasst, die als "Parameter" übergeben wird. Durch Doppelpunkte getrennt werden die Ein- und Ausgaben sowie die "Clobber-Liste" angegeben.

Ein einfaches Beispiel für Inline-Assembler ist das Einfügen einer NOP-Anweisung (NOP steht für No Operation). Dieser Assembler-Befehl benötigt genau einen Taktzyklus, ansonsten "tut sich nichts". Sinnvolle Anwendungen für NOP sind genaue Delay(=Warte)-Funktionen.

<pre class="code">
...
/* Verzoegern der weiteren Programmausfuehrung um
genau 3 Taktzyklen */
asm volatile ("nop");
asm volatile ("nop");
asm volatile ("nop");
...
</pre>

Weiterhin kann mit einem NOP verhindert werden, dass leere Schleifen, die als Warteschleifen gedacht sind, wegoptimiert werden. Der Compiler erkennt ansonsten die vermeindlich nutzlose Schleife und erzeugt dafür keinen Code im ausführbaren Programm.

<pre class="code">
...
uint16_t i;

/* leere Schleife - wird bei eingeschalteter Compiler-Optimierung wegoptimiert */
for (i=0;i<1000;i++);

...

/* Schleife erzwingen (keine Optimierung): "NOP-Methode" */
for (i=0;i<1000;i++) asm volatile("NOP");

...

/* alternative Methode (keine Optimierung): */
volatile uint16_t j;
for (j=0;j<1000;j++);
</pre>

Ein weiterer nützlicher "Assembler-Einzeiler" ist der Aufruf von sleep (''asm volatile ("sleep");''), da hierzu keine eigene Funktion in der avr-libc existiert.

Als Beispiel für mehrzeiligen Inline-Assembler eine präzise Delay-Funktion. Die Funktion erhält ein 16-bit Wort als Parameter, prüft den Parameter auf 0 und beendet die Funktion in diesem Fall oder durchläuft die folgende Schleife sooft wie im Wert des Parameters angegeben. Inline-Assembler hat hier den Vorteil, dass die Laufzeit unabhängig von der Optimierungsstufe (Parameter -O, vgl. makefile) und der Compiler-Version ist.

<pre class="code">
static inline void delayloop16 (uint16_t count)
{
asm volatile ("cp %A0, __zero_reg__ \n\t"
"cpc %B0, __zero_reg__ \n\t"
"breq 2f \n\t"
"1: \n\t"
"sbiw %0,1 \n\t"
"brne 1b \n\t"
"2: "
: "=w" (count)
: "0" (count)
);
}
</pre>

* Jede Anweisung wird mit '''\n\t''' abgeschlossen. Der Zeilenumbruch teilt dem Assembler mit, daß ein neuer Befehl beginnt.
* Als Sprung-Marken (Labels) werden Ziffern verwendet. Diese speziellen Labels sind mehrfach im Code verwendbar. Gesprungen wird jeweils zurück (b) oder vorwärts (f) zum nächsten ausffindbaren Label.

Das Resultat zeigt ein Blick in die Assembler-Datei, die der Compiler mit der option <tt>-save-temps</tt> nicht löscht:
<pre class="code">
cp r24, __zero_reg__ ; count
cpc r25, __zero_reg__ ; count
breq 2f
1:
sbiw r24,1 ; count
brne 1b
2:
</pre>

Detaillierte Ausführungen zum Thema Inline-Assembler finden sich in der Dokumentation der avr-libc im Abschnitt [http://www.nongnu.org/avr-libc/user-manual/inline_asm.html Related Pages/Inline Asm].

Siehe auch:
*[http://www.atmel.com/dyn/resources/prod_documents/doc0856.pdf AVR Assembler-Anweisungsliste]
*[http://www.roboternetz.de/wissen/index.php/Inline-Assembler_in_avr-gcc Deutsche Einführung in Inline-Assembler]

== Assembler-Dateien ==

Assembler-Dateien erhalten die Endung .S (''grosses'' S) und werden im makefile nach WinAVR/mfile-Vorlage hinter ''ASRC='' durch Leerzeichen getrennt aufgelistet.

Im Beispiel eine Funktion ''superFunc'' die alle Pins des Ports D auf "Ausgang" schaltet, eine Funktion ''ultraFunc'', die die Ausgänge entsprechend des übergebenen Parameters schaltet, eine Funktion ''gigaFunc'', die den Status von Port A zurückgibt und eine Funktion ''addFunc'', die zwei Bytes zu einem 16-bit-Wort addiert. Die Zuweisungen im C-Code (PORTx = ) verhindern, dass der Compiler die Aufrufe wegoptimiert und dienen nur zur Veranschaulichung der Parameterübergaben.

Zuerst der Assembler-Code. Der Dateiname sei useful.S:

<pre class="code">
#include "avr/io.h"

// Arbeitsregister (ohne "r")
workreg = 16
workreg2 = 17

// Konstante:
ALLOUT = 0xff

// ** Setze alle Pins von PortD auf Ausgang **
// keine Parameter, keine Rueckgabe
.global superFunc
.func superFunc
superFunc:
push workreg
ldi workreg, ALLOUT
out _SFR_IO_ADDR(DDRD), workreg // beachte: _SFR_IO_ADDR()
pop workreg
ret
.endfunc

// ** Setze PORTD auf uebergebenen Wert **
// Parameter in r24 (LSB immer bei "graden" Nummern)
.global ultraFunc
.func ultraFunc
ultraFunc:
out _SFR_IO_ADDR(PORTD), 24
ret
.endfunc

// ** Zustand von PINA zurueckgeben **
// Rueckgabewerte in r24:r25 (LSB:MSB), hier nur LSB genutzt
.global gigaFunc
.func gigaFunc
gigaFunc:
in 24, _SFR_IO_ADDR(PINA)
ret
.endfunc

// ** Zwei Bytes addieren und 16-bit-Wort zurueckgeben **
// Parameter in r24 (Summand1) und r22 (Summand2) -
// Parameter sind Word-"aligned" d.h. LSB immer auf "graden"
// Registernummern. Bei 8-Bit und 16-Bit Paramtern somit
// beginnend bei r24 dann r22 dann r20 etc.
// Rueckgabewert in r24:r25
.global addFunc
.func addFunc
addFunc:
push workreg
push workreg2
clr workreg2
mov workreg, 22
add workreg, 24
adc workreg2, 1 // r1 - assumed to be always zero ...
movw r24, workreg
pop workreg2
pop workreg
ret
.endfunc

// oh je - sorry - Mein AVR-Assembler ist eingerostet, hoffe das stimmt so...

.end

</pre>

Im Makefile ist der Name der Assembler-Quellcodedatei einzutragen:

<pre class="code">
ASRC = useful.S
</pre>

Der Aufruf erfolgt dann im C-Code so:

<pre class="code">
extern void superFunc(void);
extern void ultraFunc(uint8_t setVal);
extern uint8_t gigaFunc(void);
extern uint16_t addFunc(uint8_t w1, uint8_t w2);

int main(void)
{
[...]
superFunc();

ultraFunc(0x55);

PORTD = gigaFunc();

PORTA = (addFunc(0xF0, 0x11) & 0xff);
PORTB = (addFunc(0xF0, 0x11) >> 8);
[...]
}
</pre>

Das Ergebnis wird wieder in der lss-Datei ersichtlich:

<pre class="code">
[...]
superFunc();
148: 0e 94 f6 00 call 0x1ec

ultraFunc(0x55);
14c: 85 e5 ldi r24, 0x55 ; 85
14e: 0e 94 fb 00 call 0x1f6

PORTD = gigaFunc();
152: 0e 94 fd 00 call 0x1fa
156: 82 bb out 0x12, r24 ; 18

PORTA = (addFunc(0xF0, 0x11) & 0xff);
158: 61 e1 ldi r22, 0x11 ; 17
15a: 80 ef ldi r24, 0xF0 ; 240
15c: 0e 94 ff 00 call 0x1fe
160: 8b bb out 0x1b, r24 ; 27
PORTB = (addFunc(0xF0, 0x11) >> 8);
162: 61 e1 ldi r22, 0x11 ; 17
164: 80 ef ldi r24, 0xF0 ; 240
166: 0e 94 fc 00 call 0x1f8
16a: 89 2f mov r24, r25
16c: 99 27 eor r25, r25
16e: 88 bb out 0x18, r24 ; 24

[...]
000001ec <superFunc>:
// setze alle Pins von PortD auf Ausgang
.global superFunc
.func superFunc
superFunc:
push workreg
1ec: 0f 93 push r16
ldi workreg, ALLOUT
1ee: 0f ef ldi r16, 0xFF ; 255
out _SFR_IO_ADDR(DDRD), workreg
1f0: 01 bb out 0x11, r16 ; 17
pop workreg
1f2: 0f 91 pop r16
ret
1f4: 08 95 ret

000001f6 <ultraFunc>:
.endfunc

// setze PORTD auf uebergebenen Wert
.global ultraFunc
.func ultraFunc
ultraFunc:
out _SFR_IO_ADDR(PORTD), 24
1f6: 82 bb out 0x12, r24 ; 18
ret
1f8: 08 95 ret

000001fa <gigaFunc>:
.endfunc

// Zustand von PINA zurueckgeben
.global gigaFunc
.func gigaFunc
gigaFunc:
in 24, _SFR_IO_ADDR(PINA)
1fa: 89 b3 in r24, 0x19 ; 25
ret
1fc: 08 95 ret

000001fe <addFunc>:
.endfunc

// zwei Bytes addieren und 16-bit-Wort zurueckgeben
.global addFunc
.func addFunc
addFunc:
push workreg
1fe: 0f 93 push r16
push workreg2
200: 1f 93 push r17
clr workreg2
202: 11 27 eor r17, r17
mov workreg, 22
204: 06 2f mov r16, r22
add workreg, 24
206: 08 0f add r16, r24
adc workreg2, 1 // r1 - assumed to be always zero ...
208: 11 1d adc r17, r1
movw r24, workreg
20a: c8 01 movw r24, r16
pop workreg2
20c: 1f 91 pop r17
pop workreg
20e: 0f 91 pop r16
ret
210: 08 95 ret

[...]
</pre>

Die Zuweisung von Registern zu Parameternummer und die Register für die Rückgabewerte sind in den "Register Usage Guidelines" der avr-libc-Dokumentation erläutert.

Siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/assembler.html avr-libc-Dokumentation: Related Pages/avr-libc and assembler programs]
* [http://www.nongnu.org/avr-libc/user-manual/FAQ.html#faq_reg_usage avr-libc-Dokumentation: Related Pages/FAQ/"What registers are used by the C compiler?"]

== Globale Variablen für Datenaustausch ==

Oftmals kommt man um globale Variablen nicht herum, z.B. um den Datenaustausch zwischen Hauptprogramm und Interrupt-Routinen zu realisieren.
Hierzu muß man im Assembler wissen, wo genau die Variable vom C-Compiler abgespeichert wird.

Hierzu muß die Variable, hier "zaehler" genannt, zuerst im C-Code als Global definiert werden, z.B. so:

<pre class = "code">

#include <avr/io.h>

volatile uint8_t zaehler;

int16_t main (void)
{
// irgendein Code, in dem zaehler benutzt werden kann

}
</pre>

Im foldenden Assembler-Beispiel wird der Externe Interrupt0 verwendet, um den Zähler hochzuzählen. Es fehlen die Initialisierungen des Interrupts und die Interrupt-Freigabe, so richtig sinnvoll ist der Code auch nicht, aber er zeigt (hoffentlich) wie es geht.
Im Umgang mit Interrupt-Vektoren gilt beim GCC-Assembler das Gleiche, wie bei C: Man muß die exakte Schreibweise beachten, ansonsten wird nicht der Interrupt-Vektor angelegt, sondern eine neue Funktion - und man wundert sich, daß nichts funktionert (vgl. das AVR-GCC Handbuch).

<pre class = "code">

#include "avr/io.h"

temp = 16

.extern zaehler

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

push temp // wichtig: Benutzte Register und das
in temp,_SFR_IO_ADDR(SREG) // Status-Register (SREG) sichern !
push temp

lds temp,zaehler // Wert aus dem Speicher lesen
inc temp // bearbeiten
sts zaehler,temp // und wieder zurückschreiben

pop temp // die benutzten Register wiederherstellen
out _SFR_IO_ADDR(SREG),temp
pop temp
reti

.end

</pre>

=== Globale Variablen im Assemblerfile anlegen ===

Alternativ können Variablen aber auch im Assemblerfile angelegt werden. Dadurch kann auf eine .c-Datei verzichtet werden. Für das obige Beispiel könnte der Quelltext dann die Dateien zaehl_asm.S und zaehl_asm.h abgelegt werden, so dass nur noch zaehl_asm.S mit kompiliert werden müsste.

Anstatt im Assemblerfile über das Schlüsselwort ''.extern '' auf eine vorhandene Variable zu verweisen, wird dazu mit dem Schlüsselwort ''.comm'' die benötigte Anzahl von Bytes für eine Variable reserviert.

'''zaehl_asm.S'''
<pre class = "code">

#include "avr/io.h"

temp = 16

// 1 Byte im RAM für den Zähler reservieren
.comm zaehler, 1

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

...

</pre>

In der Headerdatei wird dann auf die Variable nur noch verwiesen (Schlüsselwort ''extern''):

'''zaehl_asm.h'''
<pre class = "code">
#ifndef ZAEHL_ASM_H
#define ZAEHL_ASM_H

extern volatile uint8_t zaehler;

#endif
</pre>

Im Gegensatz zu globalen Variablen in C werden so angelegte Variablen nicht automatisch mit dem Wert 0 initialisiert.

=== Variablen größer als 1 Byte ===

Variablen, die größer als ein Byte sind, können in Assembler auf ähnliche Art angesprochen werden. Hierzu müssen nur genug Bytes angefordert werden, um die Variable aufzunehmen. Soll z.B. für den Zähler eine Variable vom Typ ''unsigned long'', also ''uint32_t'' verwendet werden, so müssen 4 Bytes reserviert werden:

<pre class = "code">
...
// 4 Byte im RAM für den Zähler reservieren
.comm zaehler, 4
...
</pre>

Die dazugehörige Deklaration im Headerfile wäre dann:
<pre class = "code">
...
extern volatile uint32_t zaehler;
...
</pre>

Bei Variablen, die größer als ein Byte sind, werden die Werte beginnend mit dem niederwertigsten Byte im RAM abgelegt. Das folgende Codeschnippsel zeigt, wie unter Assembler auf die einzelnen Bytes zugegriffen werden kann. Dazu wird im Interrupt nun ein 32-Bit Zähler erhöht:
<pre class = "code">
#include "avr/io.h"

temp = 16

// 4 Byte im RAM für den Zähler reservieren
.comm zaehler, 4

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

push temp // wichtig: Benutzte Register und das
in temp,_SFR_IO_ADDR(SREG) // Status-Register (SREG) sichern !
push temp

// 32-Bit-Zähler incrementieren
lds temp, (zaehler + 0) // 0. Byte (niederwertigstes Byte)
inc temp
sts (zaehler + 0), temp
brne RAUS

lds temp, (zaehler + 1) // 1. Byte
inc temp
sts (zaehler + 1), temp
brne RAUS

lds temp, (zaehler + 2) // 2. Byte
inc temp
sts (zaehler + 2), temp
brne RAUS

lds temp, (zaehler + 3) // 3. Byte (höchstwertigstes Byte)
inc temp
sts (zaehler + 3), temp
brne RAUS

RAUS:
pop temp // die benutzten Register wiederherstellen
out _SFR_IO_ADDR(SREG),temp
pop temp
reti

.end

</pre>

'''TODO:''' 16-Bit / 32-Bit Variablen, Zugriff auf Arrays (Strings)

= Anhang =

== Besonderheiten bei der Anpassung bestehenden Quellcodes ==

Einige Funktionen, die in frühren Versionen der avr-libc vorhanden waren, werden inzwischen als veraltet angesehen. Sie sind nicht mehr vorhanden oder als ''deprecated'' (abgelehnt) ausgewiesen. Es empfiehlt sich, vorhandenen Code zu portieren und die alten Funktionen nicht mehr zu nutzen, auch wenn diese noch zur Verfügung stehen.

=== Veraltete Funktionen zur Deklaration von Interrupt-Routinen ===

Die Funktionen (eigentlich Makros) ''SIGNAL'' und ''INTERRUPT'' zur Deklaration von Interruptroutinen sollten nicht mehr genutzt werden.

In aktuellen Versionen der avr-libc (z.B. avr-libc 1.4.3 aus WinAVR 20060125) werden Interruptroutinen, die '''nicht''' durch andere Interrupts '''unterbrechbar''' sind, mit ISR deklariert (siehe Abschnitt im Hauptteil). Auch die Benennung wurden vereinheitlicht und an die üblichen Bezeichnungen in den AVR Datenblättern angepasst. In der Dokumentation der avr-libc sind alte und neue Bezeichnungen in der Tabelle gegenübergestellt. Die erforderlichen Schritte zur Portierung:

* #include von avr/signal.h entfernen
* SIGNAL duch ISR ersetzen
* Name des Interrupt-Vektors anpassen (SIG_* durch entsprechendes *_vect)

Ein Beispiel für die Anpassung zuerst ein "alter" Code:

<pre class="code">
#include <avr/interrupt.h>
#include <avr/signal.h>

...

/* Timer2 Output Compare bei einem ATmega8 */
SIGNAL(SIG_OUTPUT_COMPARE2)
{
...
}
</pre>

Im Datenblatt wird der Vektor mit TIMER2 COMP bezeichnet. Die Bezeichnung in der avr-libc entspricht dem Namen im Datenblatt, Leerzeichen werden durch Unterstriche (_) ersetzt und ein _vect angehängt.

Der neue Code sieht dann so aus:

<pre class="code">
#include <avr/interrupt.h>
/* signal.h entfällt */

ISR(TIMER2_COMP_vect)
{
...
}
</pre>

Bei Unklarheiten bezüglich der neuen Vektorlabels hilft (noch) ein Blick in die Headerdatei des entspechenden Controllers. Für das vorherige Beispiel also der Blick in die Datei iom8.h für den ATmega8, dort findet man die veraltete Bezeichnung unterhalb der aktuellen.

<pre class="code">
...
/* Timer/Counter2 Compare Match */
#define TIMER2_COMP_vect _VECTOR(3)
#define SIG_OUTPUT_COMPARE2 _VECTOR(3)
...
</pre>

Konnte in alten Versionen signal.h ohne interrupt.h eingebunden werden, erhält man bei Verwendung der avr-libc Version 1.4.3 (WinAVR 2/2005) beim Compilieren eine Fehlermeldung, da mit signal.h nicht die erforderlichen Definitionen eingebunden werden. Der Lösungsvorschlag in signal.h auch interrupt.h einzubinden, wurde von den avr-libc-Enwicklern akzeptiert und das Problem ist im Quellcode (CVS) bereits behoben. Es is aber noch keine avr-libc-"Release" bzw. noch kein WinAVR mit dieser avr-libc-Korrektur verfuegbar (Stand 5.2.2006). Will oder kann man den Quellcode nicht aktualisieren, gibt es folgende Alternativen:
* in Quellcodedateien, in denen nur avr/signal.h eingebunden wird, interrupt.h einbinden (''#include <avr/interrupt.h>''). signal.h weiterhin einbinden, falls Kompatibiltät mit alten Versionen gewünscht ist.
* in der Datei signal.h (bein WinAVR in c:/WinAVR/avr/include/avr/signal.h) ein (''#include <avr/interrupt.h>'') ergänzen

Für '''unterbrechbare''' Interruptroutinen, die mittels ''INTERRUPT'' deklariert sind, gibt es keinen direkten Ersatz in Form eines Makros. Die Routinen sind lt. Dokumentation der avr-libc in folgender Form zu Deklarieren unterbrechbarer Interrupt-Handler:

<pre class="code">
void XXX_vect(void) __attribute__((interrupt));
void XXX_vect(void) {
...
}
</pre>

Beispiel:

<pre class="code">
#include <avr/interrupt.h>

// alt:
INTERRUPT(SIG_OVERFLOW0)
{
...
}

// neu:
void TIMER0_OVF_vect(void) __attribute__((interrupt));
void TIMER0_OVF_vect(void)
{
...
}
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von ''INTERRUPT'' die Header-Datei ''compat/deprecated.h'' einzubinden. Man sollte bei dieser Gelegenheit jedoch nochmals überprüfen, ob die Funktionalität von ''INTERRUPT'' tatsächlich gewollt ist. In vielen Fällen wurde ''INTTERRUPT'' dort genutzt, wo eigentlich ''SIGNAL'' (nunmehr ''ISR'') hätte genutzt werden sollen.

=== Veraltete Funktionen zum Portzugriff ===

''inp'' und ''outp'' zum Einlesen bzw. Schreiben von Registern sind nicht mehr erforderlich, der Compiler unterstützt dies ohne diesen Umweg.

<pre class="code">
unsigned char i, j;

// alt:
i = inp(PINA);
j = 0xff;
outp(PORTB, j);

// neu (nicht mehr wirklich neu...):
i = PINA
j = 0xff;
PORTB = j;
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von inp und outp die Header-Datei '''compat/deprecated.h''' einzubinden.

=== Veraltete Funktionen zum Zugriff auf Bits in Registern ===

''cbi'' und ''sbi'' zum Löschen und Setzen von Bits sind nicht mehr erforderlich, der Compiler unterstützt dies ohne diesen Umweg. Die Bezeichnung ist ohnehin irreführend da die Funktionen nur für Register mit Adressen im unteren Speicherbereich tatsächlich in die Assembleranweisungen cbi und sbi übersetzt werden.

<pre class="code">
// alt:
sbi(PORTB, PB2);
cbi(PORTC, PC1);

// neu (auch nicht mehr wirklich neu...):
PORTB |= (1<<PB2);
PORTC &= ~(1<<PC1);
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von sbi und cbi die Header-Datei '''compat/deprecated.h''' einzubinden. Wer unbedingt will, kann sich natürlich eigene Makros mit aussagekräftigeren Namen definieren. Zum Beispiel:

<pre class="code">
#define SET_BIT(PORT, BITNUM) ((PORT) |= (1<<(BITNUM)))
#define CLEAR_BIT(PORT, BITNUM) ((PORT) &= ~(1<<(BITNUM)))
#define TOOGLE_BIT(PORT, BITNUM) ((PORT) ^= (1<<(BITNUM)))
</pre>

== Externe Referenzspannung des internen Analog-Digital-Wandlers ==

Die minimale (externe) Referenzspannung des ADC darf nicht beliebig niedrig sein, vlg. dazu das (aktuellste) Datenblatt des verwendeten Controllers. z.B. beim ATMEGA8 darf sie lt. 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.)

= TODO =
* fuse-bits im make file
* Assembler-Dateien/Datenaustausch auf neue Vectornamen anpassen SIG_->_vect
* stdio.h, malloc() ???
* Code-Optimierungen ("tricks")
* "naked"-Functionen ??
* IO-Register als Parameter/"Variablen" (volatile uint8_t *mybusport; mybusport=&PORTB; void sendbus(uint8_t *parm)...)
* JTAG?
* SPI ?
* I²C Bus
* LC-Display ansteuern
* Software USB
* Bootloader

AVR-GCC-Tutorial

2006-05-29T15:12:25Z

129.247.247.238: /* Erzeugen von Maschinencode */

[[Category:AVR]]

= Vorwort =

Dieses Tutorial soll den Einstieg in die Programmierung von Atmel [[AVR]]-Mikrocontroller in der Programmiersprache [[C]] mit dem freien ("kostenlosen") C-Compiler avr-gcc erleichtern.

Die ursprüngliche Version stammt von Christian Schifferle, viele neue Abschnitte und aktuelle Anpassungen von Martin Thomas. Viele der im Original-Dokument verwendeten Funktionen sind in aktuellen Versionen des [[AVR-GCC|avr-gcc]] C-Compilers und der Laufzeitbibliothek avr-libc nicht mehr enthalten oder sollen nicht mehr genutzt werden. Dieses Tutorial wurde an die neuen Funktionen/Methoden angepasst.

Die Erläuterungen und Beispiele beziehen sich auf die Versionen 3.4.5 des avr-gcc-Compiler und 1.4.3 der avr-libc, so wie sie in WinAVR 20060125 enthalten sind. Die Unterschiede zu älternen Versionen werden im Haupttext und Anhang zwar erläutert, Anfängern sei jedoch empfohlen, die aktuellen Versionen zu nutzen.

In diesem Text wird häufig auf die Standardbibliothek für den avr-gcc-Compiler, die avr-libc, verwiesen. Die online-Version der '''avr-libc Dokumentation''' findet sich [http://www.nongnu.org/avr-libc/user-manual/index.html hier]. Bei [[WinAVR]] gehört die Dokumentation zum Lieferumfang und wird mitinstalliert.

Eine Version als PDF zum Ausdrucken ist hier erhältlich (nicht immer auf aktuellem Stand): http://www.siwawi.arubi.uni-kl.de/avr_projects/AVR-GCC-Tutorial_-_www_mikrocontroller_net.pdf

= 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:

* Testboard 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 Testplattform sind auch das [[STK500]] und der [[AVR Butterfly]] von Atmel.[[http://www.mikrocontroller.net/articles/AVR#Starterkits |mehr..]
* 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]].
* Programmiersoftware und -[[AVR In System Programmer |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 Abschnitt [[AVR-GCC-Tutorial#Exkurs: makefiles|Exkurs: makefiles]]).

= Was tun, wenn's nicht "klappt"? =

* Herausfinden, ob es tatsächlich ein avr(-gcc) spezifisches Problem ist oder die 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.
*[[AVR Checkliste]]
* Die [http://www.nongnu.org/avr-libc/user-manual/index.html 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 [http://www.mikrocontroller.net www.mikrocontroller.net] nach vergleichbaren Problemen absuchen.
* Das avr-gcc-Forum bei [http://www.avrfreaks.net avrfreaks] nach vergleichbaren Problemen absuchen.
* Das [http://lists.gnu.org/archive/html/avr-gcc-list/ Archiv der avr-gcc Mailing-Liste] nach vergleichbaren Problemen absuchen.
* Nach Beispielcode suchen. Vor allem in der Academy von [http://www.avrfreaks.net AVRFREAKS] (anmelden).
* Google oder alltheweb befragen schadet nie.
* Bei Problemen mit der Ansteuerung interner AVR-Funktionen mit C-Code: das Datenblatt des Controllers lesen (ganz und am Besten zweimal)
* 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, genaue Fehlermeldungen bzw. Beschreibung des Fehlverhaltens. Bei Ansteuerung externer Geräte die Beschaltung beschreiben oder skizzieren (z.B. mit [http://www.tech-chat.de/ Andys ASCII Circuit]). Siehe dazu auch: [http://www.lugbz.org/documents/smart-questions_de.html "Wie man Fragen stellt"].

= Erzeugen von Maschinencode =

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

* Die Verwendung einer Integrierten Enwicklungsumgebung (IDE), bei der alle Einstellungen z.B. in Dialogboxen durchgeführt werden können. Unter Anderen kann AVRStudio ab Version 4.12 (kostenlos bei atmel.com) zusammen mit WinAVR als intergrierte Entwicklungsumgebung für den Compiler avr-gcc genutzt werden (dazu muessen AVRStudio und WinAVR auf dem Rechner installiert sein). Weitere IDEs fuer den avr-gcc (ohne Anspruch auf Vollständigkeit): AtmanAvr C (relativ günstig), KamAVR (kostenlos) VMLab (ab Version 3.12 ebenfalls kostenlos).

* Die Nutzung des Programms make mit passenden Makefiles.

Integrierte Enwicklungsumgebungen 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 Nutzung des avr-gcc Compilers mit IDEs sei hier auf deren Dokumentation verwiesen.

Im folgenden Abschnitt wird die Generierung von Maschinencode ("hex-Datei") für einen AVR aus C-Quellcode ("c-Dateien") anhand der universellen und plattformunabhänigen Vorgehensweise mittels make und 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 Projectverzeichnisses). Beim Wechsel vom makefile-Ansatz nach WinAVR-Vorlage zu AVRStudio ist darauf zu achten, dass AVRStudio (Stand: AVRStudio Version 4.12SP1) bei einem neuen Projekt die Optimierungsoption (vgl. nächster Abschnitt, typisch: -Os) nicht einstellt und die mathematische Bibliothek der avr-libc (libm.a, Linker-Option -lm) nicht einbindet. 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.

= Exkurs: Makefiles =

Wenn man bisher gewohnt ist, mit integrierten Entwicklungsumgebung à la Visual-C Programme zu erstellen, wirkt das makefile-Konzept auf den ersten Blick etwas kryptisch. Nach kurzer Einarbeitung ist diese Vorgehensweise jedoch sehr praktisch. Diese Dateien (üblicher Name: 'Makefile' ohne Dateiendung) dienen der Ablaufsteuerung des Programms make, das auf allen Unix/Linux-Systemen installiert sein sollte, und in einer Fassung fuer MS-Windows auch in [[WinAVR]] (Unterverzeichnis utils/bin) enthalten ist.

Im Unterverzeichnis ''sample'' einer WinAVR-Installation findet man eine sehr brauchbare Vorlage, die sich einfach an das eigene Projekt anpassen lässt ([[Media:Makefile|lokale Kopie Stand Sept. 2004]]). Wahlweise kann man auch [http://www.sax.de/~joerg/mfile/ mfile] von Jörg Wunsch nutzen. mfile erzeugt ein makefile nach Einstellungen in einer grafischen Nutzeroberfläche, wird bei WinAVR mitinstalliert, ist aber als TCL/TK-Programm auf nahezu allen Plattformen lauffähig.

''Die folgenden Ausführungen beziehen sich auf das WinAVR Beispiel-Makefile.''

Ist im Makefile alles richtig eingestellt genügt es, sich drei Parameter zu merken, die über die shell bzw. die Windows-Kommandozeile (cmd.exe/command.com) als Parameter an "make" übergeben werden. Das Programm make sucht sich "automatisch" das Makefile im aktuellen Arbeitsverzeichnis und führt die darin definierten Operationen für den entsprechenden Aufrufparameter durch.

{| border=1
| ''make all''
| Erstellt aus den im Makefile angegebenen Quellcodes eine ''hex''-Datei (und ggf. auch ''eep''-Datei).
|-
| ''make program''
| Überträgt die hex-Datei (und wahlweise auch die eep-Datei für den EEPROM) zum AVR.
|-
| ''make clean''
| löscht alle temporären Dateien, also auch die hex-Datei
|}

Diese Aufrufe können in die allermeisten Editoren in "Tool-Menüs" eingebunden werden. Dies erspart den Kontakt mit der Kommandozeile. (Bei WinAVR sind die Aufrufe bereits im Tools-Menü des mitgelieferten Editors Programmers-Notepad eingefügt.)

Üblicherweise sind folgende Daten im Makefile anzupassen:
* Controllertyp
* Quellcode-Dateien (c-Dateien)
* Typ und Anschluss des Programmiergeräts

seltener sind folgende Einstellungen durchzuführen:
* Grad der Optimierung
* Methode zur Erzeugung der Debug-Symbole (Debug-Format)
* Assembler-Quellcode-Dateien (S-Dateien)

Die in den folgenden Unterabschnitten gezeigten Makefile-Ausschnitte sind für ein Programm, das auf einem ATmega8 ausgeführt werden soll. Der Quellcode besteht aus den c-Dateien superprog.c (darin main()), uart.c, lcd.c und 1wire.c. Im Quellcodeverzeichnis befinden sich diese Dateien: superprog.c, uart.h, uart.c, lcd.h, lcd.c, 1wire.h, 1wire.c und das makefile (die angepasste Kopie des WinAVR-Beispiels).

Der Controller wird mittels [[AVRDUDE]] über ein [[STK200]]-Programmierdongle an der Schnittstelle lpt1 (bzw. /dev/lp0) programmiert. Im Quellcode sind auch Daten für die ''section .eeprom'' definiert (siehe Abschnitt [[AVR-GCC-Tutorial#EEPROM|Speicherzugriffe]]), diese sollen beim Programmieren gleich mit ins EEPROM geschrieben werden.

== Controllertyp setzen ==

Dazu wird die "make-Variable" MCU entsprechend dem Namen des verwendeten Controllers gesetzt. Ein Liste der von avr-gcc und der avr-libc untersützten Typen findet sich in der [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc].

<pre class="code">
# Kommentare in Makefiles beginnen mit einem Doppelkreuz
...

# ATmega8 at work
MCU = atmega8
# oder MCU = atmega16
# oder MCU = at90s8535
# oder ...
...
</pre>

== Quellcode-Dateien einstellen ==

Den Namen der Quellcodedatei welche die Funktion main enthält, wird hinter TARGET eingetragen. Dies jedoch ohne die Endung ''.c''.

<pre class="code">
...
TARGET = superprog
...
</pre>

Besteht das Projekt wie im Beispiel aus mehr als einer Quellcodedatei, sind die weiteren c-Dateien (nicht die Header-Dateien, vgl. [[Include-Files (C)]]) durch Leerzeichen getrennt bei SRC einzutragen. Die bei TARGET definierte Datei ist schon in der SRC-Liste enthalten. Diesen Eintrag nicht löschen!

<pre class="code">
...
SRC = $(TARGET).c uart.c lcd.c 1wire.c
...
</pre>

Alternativ kann man die Liste der Quellcodedateien auch mit dem Operator += erweitern.

<pre class="code">
SRC = $(TARGET).c uart.c 1wire.c
# lcd-Code fuer Controller xyz123 (auskommentiert)
# SRC += lcd_xyz.c
# lcd-Code fuer "Standard-Controller" (genutzt)
SRC += lcd.c
</pre>

== Programmiergerät einstellen ==

Die Vorlagen sind auf die Programmiersoftware [[AVRDUDE]] angepasst, jedoch lässt sich auch andere Programmiersoftware einbinden, sofern diese über Kommandozeile gesteuert werden kann (z.B. stk500.exe, uisp, sp12).

<pre class="code">
...
# Einstellung fuer STK500 an com1 (auskommentiert)
# AVRDUDE_PROGRAMMER = stk500
# com1 = serial port. Use lpt1 to connect to parallel port.
# AVRDUDE_PORT = com1 # programmer connected to serial device

# Einstellung fuer STK200-Dongle an lpt1
AVRDUDE_PROGRAMMER = stk200
AVRDUDE_PORT = lpt1
...
</pre>

Sollen Flash(=.hex) und EEPROM(=.eep) zusammen auf den Controller programmiert werden, ist das Kommentarzeichen vor AVRDUDE_WRITE_EEPROM zu löschen.

<pre class="code">
...
# auskommentiert: EERPOM-Inhalt wird nicht mitgeschrieben
#AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep

# nicht auskommentiert: EERPOM-Inhalt wird mitgeschrieben
AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep
...
</pre>

todo: fuse-bits

== Anwendung ==

Die Eingabe von ''make all'' im Arbeitsverzeichnis mit dem Makefile und den Quellcodedateien erzeugt (unter anderem) die Dateien superprog.hex und superprog.eep. Abhängigkeiten zwischen den einzelnen c-Dateien werden dabei automatisch berücksichtigt. Die ''superprog.hex'' und ''superprog.eep'' werden mit ''make program'' zum Controller übertragen. Mit ''make clean'' werden alle temporären Dateien gelöscht (="aufgeräumt").

== Sonstige Einstellungen ==

=== Optimierungsgrad ===

Der gcc-Compiler kennt verschiedene Stufen der Optimierung. Nur zu Testzwecken sollte die Optimierung ganz deaktiviert werden (''OPT = 0''). Die weiteren möglichen Optionen weisen den Compiler an, möglichst kompakten oder möglichst schnellen Code zu erzeugen. In den weitaus meisten Fällen ist ''OPT = s'' die optimale (sic) Einstellung, damit wird kompakter und oft auch der "schnellste" Maschinencode erzeugt.

=== Debug-Format ===

Unterstützt werden die Formate stabs und dwarf-2. Das Format wird hinter ''DEBUG ='' eingestellt. Siehe dazu Abschnitt ''Eingabedateien zur Simulation''.

=== Assembler-Dateien ===

Die im Projekt genutzten Assembler-Dateien werden hinter ASRC durch Leerzeichen getrennt aufgelistet. Assembler-Dateien haben immer die Endung .S (großes S). Ist zum Beispiel der Assembler-Quellcode eines Software-UARTs in einer Datei softuart.S enthalten lautet die Zeile: ''ASRC = softuart.S''

=== Taktfrequenz ===

Neuere Versionen der WinAVR/Mfile Vorlage für Makefiles beinhalten die Definition einer Variablen F_CPU (WinAVR 2/2005). Darin wird die Taktfrequenz des Controllers in Hertz eingetragen. Die Definition steht dann im gesamten Projekt ebenfalls unter der Bezeichnung F_CPU zur Verfügung (z.B. um daraus UART-, SPI- oder ADC-Frequenzeinstellungen abzuleiten).

Die Angabe hat rein "informativen" Charakter, die tatsächliche Taktrate wird über den externen Takt (z.B. Quarz) bzw. die Einstellung des internen R/C-Oszillators bestimmt. Die Nutzung von F_CPU macht also nur Sinn, wenn die Angabe mit dem tatsächlichen Takt übereinstimmt.

Innerhalb der avr-libc ab Version 1.2 (in WinAVR ab 2/2005 enthalten) wird die Definition der Taktfrequenz (F_CPU) zur Berechnung der Wartefunktionen in avr/delay.h genutzt. Diese funktionieren nur dann korrekt, wenn F_CPU mit der tatsächlichen Taktfrequenz übereinstimmt.
F_CPU muss dazu jedoch nicht unbedingt im makefile definiert werden. Es reicht aus, wird aber bei mehrfacher Anwendung unübersichtlich, vor ''#include <avr/delay.h>'' ein ''#define F_CPU [hier Takt in Hz]UL'' einzufügen.
Vgl. dazu den [http://www.nongnu.org/avr-libc/user-manual/group__avr__delay.html entsprechenden Abschnitt der Dokumentation].

== Eingabedateien zur Simulation in AVR-Studio ==

Mit älteren AVR-Studio-Versionen kann man nur auf Grundlage sogenannter ''coff''-Dateien simulieren. Neuere Versionen von AVR-Studio (ab 4.10.356) unterstützen zudem das modernere aber noch experimentelle dwarf-2-Format, das ab WinAVR 20040722 (avr-gcc 3.4.1/Binutils inkl. Atmel add-ons) "direkt" vom Compiler erzeugt wird.

; Vorgehensweise bei extcoff:
* im Makefile bei DEBUG: <pre class="code">DEBUG=stabs</pre>
* ''make extcoff'' (evtl. vorher ''make clean'')
* die erzeugte ''cof''-Datei (im Beispiel oben ''superprog.cof'') in AVR-Studio laden
* AVR-Simulator und zu simulierenden Controller wählen, "Finish"
* weiteres siehe AVR-Studio Online-Hilfe

; Vorgehensweise bei dwarf-2:
* im Makefile bei DEBUG: <pre class="code">DEBUG=dwarf-2</pre>
* ''make all'' (evtl. vorher ''make clean'')
* die erzeugte ''elf''-Datei (im Beispiel oben ''superprog.elf'') in AVR-Studio laden
* AVR-Simulator und zu simulierenden Controller wählen, "Finish"
* weiteres siehe AVR-Studio Online-Hilfe

Beim Simulieren scheinen oft "Variablen zu fehlen". Ursache dafür ist, dass der Compiler die "Variablen" direkt Registern zuweist. Dies kann vermieden werden, indem die Optimierung abgeschaltet wird (im makefile). Man simuliert dann jedoch ein vom optimierten Code stark abweichendes Programm. Das Abschalten der Optimierung wird nicht empfohlen.

Statt des Software-Simulators kann das AVR-Studio auch genutzt werden, um mit dem ATMEL JTAGICE, ein Nachbau davon (BootICE, Evertool o.ä.) oder dem ATMEL JTAGICE MKII "im System" zu debuggen. Dazu sind keine speziellen Einstellungen im makefile erforderlich. Debugging bzw. "In-System-Emulation" mit dem JTAGICE und JTAGICE MKII sind in der AVR-Studio Online-Hilfe beschrieben.

= 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.

== Selbstdefinierte (nicht-standardisierte) ganzzahlige Datentypen ==

Bei den im Folgenden genannten Typdefinitionen ist zu beachten, dass die Bezeichnungen für "Worte" teilweise je nach Prozessorplattform unterschiedlich verwendet werden. Die angegebenen Definitionen beziehen sich auf die im Zusammenhang mit AVR/8-bit-Controllern üblichen "Bit-Breiten" (In Erläuterungen zum ARM7TDMI z.B. werden oft 32-bit Integer mit "Wort" ohne weitere Ergänzung bezeichnet). Es empfiehlt sich daher, die im nachfolgenden Abschnitt beschriebenen ''standardisierten ganzzahligen Datentypen'' zu nutzen und damit "Missverständnissen" vorzubeugen, die z.B. bei der Portierung von C-Code zwischen verschiedenen Plattformen auftreten können.

<pre class="code">
typedef unsigned char BYTE; // besser: uint8_t aus <inttypes.h>
typedef unsigned short WORD; // besser: uint16_t aus <inttypes.h>
typedef unsigned long DWORD; // besser: uint32_t aus <inttypes.h>
typedef unsigned long long QWORD; // besser: uint64_t aus <inttypes.h>
</pre>

; BYTE : Der Datentyp BYTE definiert eine Variable mit 8 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 255.

; WORD : Der Datentyp WORD definiert eine Variable mit 16 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 65535.

; DWORD : Der Datentyp DWORD (gesprochen: Double-Word) definiert eine Variable mit 32 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 4294967295.

; QWORD : Der Datentyp QWORD (gesprochen: Quad-Word) definiert eine Variable mit 64 Bit Breite zur Darstellung von ganzen Zahlen im Bereich zwischen 0 ... 18446744073709551615.

== Standardisierte Integer(Ganzzahl)-Typen ==

Standardisierte Datentypen werden in der Header-Datei inttypes.h definiert. In neueren Version der avr-libc (ab V1.2.0) heisst die Datei entsprechend aktuellem Standard stdint.h. inttypes.h existiert aus Kompatibiltätsgründen weiterhin und enthält ein ''#include <stdint.h>''.
Zur Nutzung der standardisierten Typen bindet man die "Definitionsdatei" wie folgt ein:

<pre class="code">
#include <inttypes.h>

// oder - ab avr-libc Version 1.2.0 möglich und empfohlen:
#include <stdint.h>
</pre>

Einige der dort definierten Typen (avr-libc Version 1.0.4):

<pre class="code">
typedef signed char int8_t;
typedef unsigned char uint8_t;

typedef short int16_t;
typedef unsigned short uint16_t;

typedef long int32_t;
typedef unsigned long uint32_t;

typedef long long int64_t;
typedef unsigned long long uint64_t;
</pre>

Ein Vierfach-Wort (64Bit) entspricht beim AVR ''uint64_t'', ein Doppel-Wort (32bit) entspricht ''uint32_t'', ein Wort (16bit) entspricht ''uint16_t'' und ein Byte (8bit) entspricht ''uint8_t''.
Die Typen ohne vorangestelltes ''u'' können auch vorzeichenbehaftete Zahlen speichern. ''int8_t'' geht also von -128 bis 127, ''uint8_t'' dagegen geht von 0 bis 255.

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/(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 Bit breit ist.

Hier bietet uns die Programmiersprache C ein mächtiges Werkzeug an, mit dessen
Hilfe wir 8 Bits in eine einzelne Bytevariable zusammen fassen 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:

<pre class="code">
struct {
unsigned char bStatus_1:1; // 1 Bit für bStatus_1
unsigned char bStatus_2:1; // 1 Bit für bStatus_2
unsigned char bNochNBit:1; // Und hier noch mal ein Bit
unsigned char b2Bits:2; // Dieses Feld ist 2 Bits breit
// All das hat in einer einzigen Byte-Variable Platz.
// die 3 verbleibenden Bits bleiben ungenutzt
} x;
</pre>

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

<pre class="code">
x.bStatus_1 = 1;
x.bStatus_2 = 0;
x.b2Bits = 3;
</pre>

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 geraten,
ein "ganzes" Byte (uint8_t) zu nutzen auch wenn nur ein Bitwert gespeichert
werden soll.

Wenn man nur eine paar wenige Variablen vom Typ bool verwenden möchte, kann man
auch die Headerdatei <stdbool.h> einbinden und sich dann wie gewohnt einen Booltyp anlegen.
Bei vielen Variablen vom Typ Bool und knappem Speicher ist die Verwendung von Bitfeldern zu empfehlen (? Wie wird der stdbool intern abgewickelt ?)

= 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:

[[Image:Sequentielle Programme.gif]]

== 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.

[[Image:Interrupt Programme.gif]]

= Allgemeiner 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.

Einige Register haben spezielle Funktionen, andere wiederum können für allgemeine Zwecke (Speichern von Datenwerten) verwendet werden.

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. Wenn im Makefile der MCU-Typ definiert ist, wird vom System automatisch die zum Typen passende Definitionsdatei genutzt, sobald man im Code die allgemeine "io.h" Header-Datei einbindet.

<pre class="code">
#include <avr/io.h>
</pre>

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

== I/O-Register ==

Die I/O-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 mal
die 8-Bit Register.

=== Lesen eines I/O-Registers ===

Zum Lesen kann man auf I/O-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üzen den Zugriff nun direkt und inp() ist nicht mehr erforderlich.

Beispiel:

<pre class="code">
#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;
...
}
</pre>

==== Lesen eines Bits ====

Die AVR-Bibliothek (avr-libc) stellt auch Funktionen zur Abfrage eines einzelnen Bits eines Registers zur Verfügung:

;bit_is_set (<Register>,<Bitnummer>) : Die Funktion ''bit_is_set'' prüft, ob ein Bit gesetzt ist. Wenn das Bit gesetzt ist, wird ein Wert ungleich 0 zurückgegeben. Genau genommen ist es die Wertigkeit des abgefragten Bits, also 1 für Bit0, 2 für Bit1, 4 für Bit2 etc.

;bit_is_clear (<Register>,<Bitnummer>) : Die Funktion ''bit_is_clear'' prüft, ob ein Bit gelöscht ist. Wenn das Bit gelöscht ist, also auf 0 ist, wird ein Wert ungleich 0 zurückgegeben.

Die Funktionen bit_is_clear bzw. bit_is_set sind ''nicht erforderlich'', man kann auch "einfache" C-Syntax verwenden, die universell verwendbar ist. ''bit_is_set'' entspricht dabei z.B. (Registername & (1 << Bitnummer)). Das Ergebnis ist <>0 ("wahr") wenn das Bit gesetzt und 0 ("falsch") wenn es nicht gesetzt ist. Die Negierung des Ausdrucks, also '''!'''((Registername & (1 << Bitnummer)), entspricht ''bit_is_clear'' und gibt einen Wert <>0 ("wahr") zurück, falls das Bit nicht gesetzt ist,

* siehe auch [[Bitmanipulation]]

=== Schreiben eines I/O-Registers ===

Zum Schreiben kann man I/O-Register einfach wie eine Variable setzen. In Quellcodes, die für ältere Versionden des avr-gcc/der avr-libc entwickelt wurden, erfolgt der Schreibzugriff über die Funktion outp(). Aktuelle Versionen des Compilers unterstüzen den Zugriff nun direkt und outp() ist nicht mehr erforderlich.

Beispiel:

<pre class="code">
#include <avr/io.h>

...

int main(void)
{
/* Setzt das Richtungsregister des Ports A auf 0xff
(alle Pins als Ausgang): */
DDRA = 0xff;

/* Setzt PortA auf 0x03, Bit 0 und 1 "high", restliche "low": */
PORTA = 0x03;
...
}
</pre>

==== Schreiben von Bits ====

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

mit dem Ausdruck:
<pre class="code">
x |= (1 << Bitnummer); // wird ein Bit in x gesetzt
x &= ~(1 << Bitnummer); // wird ein Bit in x geloescht
</pre>

Das niederwertigste Bit (für 1) eines Bytes hat die Bitnummer 0, das "höchstwertige" (für 128) die Nummer 7.

Beispiel:
<pre class="code">
#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 */
</pre>

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

Beispiel:
<pre class="code">
#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 */
</pre>

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]]
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Special Function Registers

=== Warten auf einen bestimmten Zustand ===

Es gibt in der Bibliothek sogar Funktionen, die warten, bis ein bestimmter Zustand auf einem Bit erreicht ist. Es ist allerdings normalerweise eine eher unschöne Programmiertechnik, da in diesen Funktionen "blockierend gewartet" wird. D.h., der Programmablauf bleibt 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.

<pre class="code">
#include <avr/io.h>
...

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

#define WARTEPIN PINA
#define WARTEBIT 2

// 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)) ) ;
...
</pre>

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. Das niederwertigste Bit hat die Bitnummer 0.

<pre class="code">
#include <avr/io.h>
...

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

// 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) ) ;
...
</pre>

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

siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Special Function Registers
* [[Bitmanipulation]]

= Zugriff auf Ports =

Alle Ports der AVR-Controller werden über Register gesteuert. Dazu sind
jedem Port 3 Register zugeordnet:

{| border="1"
|-
| '''DDRx'''
| Datenrichtungsregister für Port'''x'''.
'''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 Port'''x'''.

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 Port'''x'''.
Dieses Register wird verwendet, um die Ausgänge eines Ports anzusteuern. Bei Pins, die mittels DDRx auf Eingang geschaltet wurden, koenen ueber PORTx
die internen Pull-Up Widerstände aktiviert oder deaktiviert werden (1 = aktiv).
|}



== 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.

Wollen wir also beispielsweise Pin 0 bis 4 von Port B als Ausgänge
definieren so schreiben wir folgende Zeile:

<pre class="code">
#include <avr/io.h>

...

// Setzen der Bits 0,1,2,3 und 4
// Binär 00011111 = Hexadezimal 1F

DDRB = 0x1F; /* direkte Zuweisung - unuebersichtlich */

/* mehr Tipparbeit aber uebersichtlicher: */
DDRB = (1 << DDB0) | (1 << DDB1) | (1 << DDB2) | (1 << DDB3) | (1 << DDB4);
...
</pre>

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

=== Ganze Ports ===

Um einen ganzen Port als Ausgang zu definieren, kann der folgende Befehl
verwendet werden:
<pre class="code">
DDRB = 0xff;
</pre>

Im Beispiel wird der Port B als Ganzes als Ausgang geschaltet. Dazu muss die Header-Datei avr/io.h eingebunden sein (darin wird u.a. DDRB definiert).

== 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: (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):

<pre class="code">
...
/* 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
</pre>

== 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
<pre class="code">
#inlude <avr/io.h>
...
PORTB=0x04; /* besser PORTB=(1<<PB2) */
</pre>
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:

<pre class="code">
#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" */
</pre>

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

<pre class="code">
#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" */
</pre>

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 in aktuellen Versionen der avr-libc nicht mehr enthalten und auch nicht mehr erforderlich.

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 Angangswert "high" initialisiert werden, zuerst die Bits im PORTx-Register setzen und anschliessend die Datenrichtung auf Ausgang stellen. Daraus ergibt sich die Abfolge Eingang -> setze PORTx: interner Pull-Up aktiv -> setze DDRx: Ausgang "high". Bei der Reihenfolge erst DDRx and PORTx, kann es zu einem kurzen "low-Puls" kommen, der auch exterene 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") 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.

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'''. Die Abfrage der Pinzustände über PORTx statt PINx ist ein häufiger Fehler beim AVR-"Erstkontakt". (Ansonsten liest man nicht den Zustand der Eingänge, sondern den Status der internen Pull-Up-Widerstände.)

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

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
...
uint8_t bPortD;
...
bPortD = PIND;
...
</pre>

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

<pre class="code">
#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 */
}
...
</pre>

=== Tasten und Schalter ===

Der Anschluss mechanischer Kontakte an den Mikrocontroller gestaltet sich ebenfalls ganz einfach, wobei wir zwei unterschiedliche Methoden unterscheiden müssen (''Active Low'' und ''Active High''):

{| border="1"
|-
| '''Active Low'''
| '''Active High'''
|-
| [[Image:Active Low.gif]]
| [[Image:Active High.gif]]
|-
| 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.

Der Widerstandswert des Pull-Up Widerstands ist an sich nicht kritisch. Es muss jedoch beachtet werden, dass über den Widerstand ein Strom in den Eingang fliesst, also sollte er nicht zu klein gewählt werden um den Controller nicht zu zerstören. Wird er allerdings zu hoch gewählt ist die Wirkung eventuell nicht gegeben. Als üblicher Wert haben sich 10 Kiloohm eingebürgert.

Die AVRs haben sogar an den meisten Pins softwaremässig zuschaltbare interne Pull-Up Widerstände, welche wir natürlich auch verwenden können.

| 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.
|}

==== Pull-Up Widerstände aktivieren ====

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.

<pre class="code">
#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<<DDC7); /* Pin PC7 als Eingang */
PORTC |= (1<<PC7); /* internen Pull-Up an PC7 aktivieren */
</pre>

==== (Tasten-)Entprellung ====

Nun haben alle mechanischen Kontakte, sei es von Schaltern, Tastern oder auch von Relais, die unangenehme Eigenschaft zu prellen. Dies bedeutet, dass beim Schliessen des Kontaktes derselbe nicht direkt Kontakt herstellt, sondern mehrfach ein- und ausschaltet bis zum endgültigen Herstellen des Kontaktes.

Soll nun mit einem schnellen Mikrocontroller gezählt werden, wie oft ein solcher Kontakt geschaltet wird, dann haben wir ein Problem, weil das Prellen als mehrfache Impulse gezählt wird. Diesem Phänomen muss beim Schreiben des Programms unbedingt Rechnung getragen werden.

<pre class="code">
#include <avr/io.h>
#include <inttypes.h>
#ifndef F_CPU
#define F_CPU 3686400UL /* Quarz mit 3.6864 Mhz */
#endif
#include <avr/delay.h> /* definiert _delay_ms() ab avr-libc Version 1.2.0 */

/* Einfache Funktion zum Entprellen eines Tasters */
inline uint8_t debounce(volatile uint8_t *port, uint8_t pin)
{
if ( ! (*port & (1 << pin)) )
{
/* Pin wurde auf Masse gezogen, 100ms warten */
_delay_ms(100);
if ( ! (*port & (1 << pin)) )
{
/* Anwender Zeit zum Loslassen des Tasters geben */
_delay_ms(100);
return 1;
}
}
return 0;
}

int main(void)
{
DDRB &= ~( 1 << PB0 ); /* PIN PB0 auf Eingang (Taster) */
PORTB |= ( 1 << PB0 ); /* Pullup-Widerstand aktivieren */
...
if (debounce(&PINB, PB0)) /* Falls Taster an PIN PB0 gedrueckt.. */
PORTD = PIND ^ ( 1 << PD7 ); /* ..LED an Port PD7 an-
bzw. ausschalten */
...
}
</pre>

Bei diesem Beispiel ist zu beachten, dass der AVR im Falle eines Tastendrucks 200ms wartet, also brach liegt. Zeitkritische Anwendungen sollten ein anderes Verfahren wählen.

Zum Thema Entprellen siehe auch:
* Artikel [[Entprellung]]

== Analog ==

Die Verarbeitung von analogen Eingangswerten und die Ausgabe von Analogwerten wird in Kapitel [[AVR-GCC-Tutorial#Analoge_Ein-_und_Ausgabe|Analoge Ein- und Ausgabe]] behandelt.

== 16-Bit Portregister (ADC, ICR1, OCR1, TCNT1, UBRR) ==

Einige der Portregister in den AVR-Controllern sind 16 Bit breit. Im Datenblatt sind diese Register üblicherweise mit dem Suffix "L" (LSB) und "H" (MSB) versehen. Die avr-libc definiert zusätzlich die meisten dieser Variablen die Bezeichnung ohne "L" oder "H". Auf diese kann direkt zugewiesen bzw. zugegriffen werden. Die Konvertierung von 16-bit Wort nach 2*8-bit Byte erfolgt intern.

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
...
uint16_t foo;

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

Falls benötigt, kann eine 16-Bit Variable auch recht einfach manuell in ihre zwei 8-Bit Bestandteile zerlegt werden. Folgendes Beispiel demonstriert dies anhand des pseudo- 16-Bit Registers UBRR.

<pre class="code">
#include <avr/io.h>
#include <stdint.h>
#ifndef F_CPU
#define F_CPU 3686400
#endif
#define UART_BAUD_RATE 9600

typedef union {
uint16_t i16;
struct {
uint8_t i8l;
uint8_t i8h;
};
} convert16to8;

...
convert16to8 baud;
baud.i16 = F_CPU / (UART_BAUD_RATE * 16L) -1;
UBRRH = baud.i8h;
UBRRL = baud.i8l;
...

/*alternativ:*/
#include <inttypes.h>

uint16_t wFoo16;
uint8_t bFooLow, bFooHigh;

...

wFoo16 = 0xAA55; /* zu "zerlegende" 16Bit-Integer */
bFooHigh = (uint8_t)(wFoo16 >> 8); /* MS-Byte */
bFooLow = (uint8_t)(wFoo16); /* LS-Byte */
...
</pre>

Bei einigen AVR-Typen (z.B. ATmega8) teilen sich UBRRH und UCSRC die gleiche Memory-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''.

Bei einigen 16-bit Registern (insbesondere die der 16-bit Timer) erfolgen Schreibzugriffe über das sogenannte ''temporary Register''. Die Reihenfolge der Zugriffe bestimmt, wann der Wert tatsächlich ins Register geschrieben wird. Typisch wird erst das High-Byte beschrieben (xxxH) und intern im temporary Register zwischengespeichert. Nachdem das Low-Byte (xxxL) geschrieben wurde, setzt der Controller mit diesem und dem im temporary Register zwischengespeicherten Wert für das High-Byte das 16-bit Register. Dabei ist zu beachten, dass intern nur ein temporary Register verfügbar ist, welches in Interruptroutinen mglw. mit einem anderen Wert überschrieben wird, wenn dort ebenfalls 16-bit Register beschrieben werden. avr-gcc/avr-libc berücksichtigen die korrekte Reihenfolge automatisch, wenn die Register mit ihrem "16-bit Label" (ohne H bzw. L) angesprochen werden, dabei ist der Schutz des temporary Registers vor Überschreiben durch Interruptroutinen dennoch zu beachten (im Zweifel beim Schreibzugriff die Interrupts kurzzeitig global deaktivieren).

Im Umgang mit 16-Bit Registern siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Related Pages/Frequently Asked Questions/Nr. 8
* Datenblatt Abschnitt ''Accessing 16-bit Registers''

= Der UART =

== Allgemeines zum UART ==

Über den [[UART]] kann ein AVR leicht mit einer [[RS232]]-Schnittstelle eines PC oder sonstiger Geräte mit "serieller Schnittstelle" verbunden werden.

Mögliche Anwendungen des UART:

* Debug-Schnittstelle: z.B. zur Anzeige von Zwischenergebnissen ("printf-debugging" - hier besser "UART-debugging") auf einem PC. Auf dem Rechner reicht dazu eine Terminal-Software (MS-Windows: Hyperterm oder besser Bray-Terminal, [http://www.mikrocontroller.net/forum/read-8-155472.html#new HTerm]; Unix/Linux z.B. minicom). Ein direkter Anschluss ist aufgrund unterschiedlicher Pegel nicht möglich, jedoch sind entsprechende Schnittstellen-ICs wie z.B. ein MAX232 günstig und leicht zu integrieren. Rechner ohne serielle Schnittstelle können über fertige USB-seriell-Adapter angeschlossen werden.
* "Mensch-Maschine Schnittstelle": z.B. Konfiguration und Statusabfrage über eine "Kommandozeile" oder Menüs
* Übertragen von gespeicherten Werten: z.B. bei einem Datenlogger
* Anschluss von Geräten mit serieller Schnittstelle (z.B. (Funk-)Modems, Mobiltelefone, Drucker, Sensoren, "intelligente" LC-Displays, GPS-Empfänger).
* "Feldbusse" auf RS485/RS422-Basis mittels entsprechenden Bustreiberbausteinen (z.B. MAX485)
* DMX, Midi etc.
* LIN-Bus ('''L'''ocal '''I'''nterconnect '''N'''etwork): Preiswerte Sensoren/Aktoren in der Automobiltechnik und darüber hinaus

Einige AVR-Controller haben ein bis zwei vollduplexfähigen UART ('''U'''niversal '''A'''synchronous '''R'''eceiver and '''T'''ransmitter) schon eingebaut ("Hardware-UART").
Übrigens: Vollduplex heisst nichts anderes, als dass der Baustein gleichzeitig senden und empfangen kann.

Neuere AVRs (ATmega, ATtiny) verfügen über einen oder zwei U'''S'''ART(s), dieser unterschiedet sich vom UART hauptsächlich durch interne FIFO-Puffer für Ein- und Ausgabe und erweiterte Konfigurationsmöglichkeiten. Die Puffergröße ist allerdings nur 1 Byte.

Der UART wird über vier separate Register angesprochen. USARTs der ATMEGAs verfügen über mehrere zusätzliche Konfigurationsregsiter. Das Datenblatt gibt darüber Auskunft. Die Folgende Tabelle gibt nur die Register für die (veralteten) UARTs wieder.

{| border="1"
|-
| '''UCR   '''
| '''U'''ART '''C'''ontrol '''R'''egister. 
In diesem Register stellen wir ein, wie wir den UART verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''RXCIE'''
| align="center" | '''TXCIE'''
| align="center" | '''UDRIE'''
| align="center" | '''RXEN'''
| align="center" | '''TXEN'''
| align="center" | '''CHR9'''
| align="center" | '''RXB8'''
| align="center" | '''TXB8'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
|}

'''RXCIE''' ('''RX''' '''C'''omplete '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART RX Complete Interrupt ausgelöst, wenn ein Zeichen vom UART empfangen wurde. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''TXCIE''' ('''TX''' '''C'''omplete '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART TX Complete Interrupt ausgelöst, wenn ein Zeichen vom UART gesendet wurde. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''UDRIE''' ('''U'''ART '''D'''ata '''R'''egister '''E'''mpty '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein UART Datenregister Leer Interrupt ausgelöst, wenn der UART wieder bereit ist um ein neues zu sendendes Zeichen zu übernehmen. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''RXEN''' ('''R'''eceiver '''E'''nable)
:Nur wenn dieses Bit gesetzt ist, arbeitet der Empfänger des UART überhaupt. Wenn das Bit nicht gesetzt ist, kann der entsprechende Pin des AVR als normaler I/O-Pin verwendet werden.

'''TXEN''' ('''T'''ransmitter '''E'''nable)
:Nur wenn dieses Bit gesetzt ist, arbeitet der Sender des UART überhaupt. Wenn das Bit nicht gesetzt ist, kann der entsprechende Pin des AVR als normaler I/O-Pin verwendet werden.

'''CHR9''' (9 Bit Characters)
:Wenn dieses Bit gesetzt ist, können 9 Bit lange Zeichen übertragen und empfangen werden. Das 9. Bit kann bei Bedarf als zusätzliches Stopbit oder als Paritätsbit verwendet werden. Man spricht dann von einem 11-Bit Zeichenrahmen:
:1 Startbit + 8 Datenbits + 1 Stopbit + 1 Paritätsbit = 11 Bits

'''RXB8''' (Receive Data Bit 8)
:Wenn das vorher erwähnte CHR9-Bit gesetzt ist, dann enthält dieses Bit das 9. Datenbit eines empfangenen Zeichens.

'''TXB8''' (Transmit Data Bit 8)
:Wenn das vorher erwähnte CHR9-Bit gesetzt ist, dann muss in dieses Bit das 9. Bit des zu sendenden Zeichens eingeschrieben werden bevor das eigentliche Datenbyte in das Datenregister geschrieben wird.

|-
| '''USR   '''
| '''U'''ART '''S'''tatus '''R'''egister. 
Hier teilt uns der UART mit, was er gerade so macht.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''RXC'''
| align="center" | '''TXC'''
| align="center" | '''UDRE'''
| align="center" | '''FE'''
| align="center" | '''OR'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''RXC''' (UART Receive Complete)
:Dieses Bit wird vom AVR gesetzt, wenn ein empfangenes Zeichen vom Empfangs-Schieberegister in das Empfangs-Datenregister transferiert wurde.
:Das Zeichen muss nun schnellstmöglich aus dem Datenregister ausgelesen werden. Falls dies nicht erfolgt bevor ein weiteres Zeichen komplett empfangen wurde wird eine Überlauf-Fehlersituation eintreffen. Mit dem Auslesen des Datenregisters wird das Bit automatisch gelöscht.

'''TXC''' (UART Transmit Complete)
:Dieses Bit wird vom AVR gesetzt, wenn das im Sende-Schieberegister befindliche Zeichen vollständig ausgegeben wurde und kein weiteres Zeichen im Sendedatenregister ansteht. Dies bedeutet also, wenn die Kommunikation vollumfänglich abgeschlossen ist.
:Dieses Bit ist wichtig bei Halbduplex-Verbindungen, wenn das Programm nach dem Senden von Daten auf Empfang schalten muss. Im Vollduplexbetrieb brauchen wir dieses Bit nicht zu beachten.
:Das Bit wird nur dann automatisch gelöscht, wenn der entsprechende Interrupthandler aufgerufen wird, ansonsten müssen wir das Bit selber löschen.

'''UDRE''' ('''U'''ART '''D'''ata '''R'''egister '''E'''mpty)
:Dieses Bit wird vom AVR gesetzt, wenn ein Zeichen vom Sendedatenregister in das Send-Schieberegister übernommen wurde und der UART nun wieder bereit ist, ein neues Zeichen zum Senden aufzunehmen.
:Das Bit wird automatisch gelöscht, wenn ein Zeichen in das Sendedatenregister geschrieben wird.

'''FE''' ('''F'''raming '''E'''rror)
:Dieses Bit wird vom AVR gesetzt, wenn der UART einen Zeichenrahmenfehler detektiert, d.h. wenn das Stopbit eines empfangenen Zeichens 0 ist.
:Das Bit wird automatisch gelöscht, wenn das Stopbit des empfangenen Zeichens 1 ist.

'''OR''' ('''O'''ver'''R'''un) 
:Dieses Bit wird vom AVR gesetzt, wenn unser Programm das im Empfangsdatenregister bereit liegende Zeichen nicht abholt bevor das nachfolgende Zeichen komplett empfangen wurde.
:Das nachfolgende Zeichen wird verworfen.
:Das Bit wird automatisch gelöscht, wenn das empfangene Zeichen in das Empfangsdatenregister transferiert werden konnte.

|-
| '''UDR'''
| '''U'''ART '''D'''ata '''R'''egister. 
Hier werden Daten zwischen UART und CPU übertragen. Da der UART im
Vollduplexbetrieb gleichzeitig empfangen und senden kann, handelt es sich
hier physikalisch um 2 Register, die aber über die gleiche I/O-Adresse
angesprochen werden. Je nachdem, ob ein Lese- oder ein Schreibzugriff auf
den UART erfolgt wird automatisch das richtige UDR angesprochen.
|-
| '''UBRR'''
| '''U'''ART '''B'''aud '''R'''ate '''R'''egister. 
In diesem Register müssen wir dem UART mitteilen, wie schnell wir gerne
kommunizieren möchten. Der Wert, der in dieses Register geschrieben
werden muss, errechnet sich nach folgender Formel:

<math>
\begin{matrix}
\mathrm{UBRR} = \frac{\mathrm{Taktfrequenz}}{\mathrm{Baudrate} \cdot 16} - 1
\end{matrix}
</math>

Es sind Baudraten bis zu 115200 Baud und höher möglich.
|}

== Die Hardware ==

Der UART basiert auf normalem TTL-Pegel mit 0V (LOW) und 5V (HIGH). Die
Schnittstellenspezifikation für RS232 definiert jedoch -3V ... -12V (LOW) und
+3 ... +12V (HIGH). Zudem muss der Signalaustausch zwischen AVR und
Partnergerät invertiert werden. Für die Anpassung der Pegel und das
Invertieren der Signale gibt es fertige Schnittstellenbausteine. Der bekannteste
davon ist wohl der MAX232.


Streikt die Kommunikation per UART, so ist oft eine fehlerhafte Einstellung der Baudrate die Ursache. Die Konfiguration auf eine bestimmte Baudrate ist abhängig von der Taktfrequenz des Controllers. Gerade bei neu aufgebauten Schaltungen (bzw. neu gekauften Controllern) sollte man sich daher noch einmal vergewissern, dass der Controller auch tatsächlich mit der vermuteten Taktrate arbeitet und nicht z.B. den bei einigen Modellen werksseitig eingestellten internen [[Oszillator]] statt eines externen Quarzes nutzt. Die Werte der verschiedenen fuse-bits im Fehlerfall also beispielsweise mit ''[[AVRDUDE]]'' kontrollieren und falls nötig anpassen. Grundsätzlich empfiehlt sich auch immer ein Blick in die [[AVR_Checkliste]].

== Senden mit dem UART ==

Wir wollen nun Daten mit dem UART auf die serielle Schnittstelle ausgeben.

Dazu müssen wir den UART zuerst mal initialisieren. Dazu setzen wir je nach
gewünschter Funktionsweise die benötigten Bits im '''U'''ART '''C'''ontrol '''R'''egister.

Da wir vorerst nur senden möchten und (noch) keine Interrupts auswerten wollen, gestaltet sich die Initialisierung wirklich sehr einfach, da wir lediglich das '''Transmitter Enable''' Bit setzen müssen:

<pre class="code">
UCR |= (1<<TXEN);
</pre>

Neuere AVRs mit USART(s) haben mehrere Konfigurationsregister und erfordern eine etwas andere Konfiguration. Für einen ATmega16 z.B.:

<pre class="code">
UCSRB |= (1<<TXEN); // UART TX einschalten
UCSRC |= (1<<URSEL)|(3<<UCSZ0); // Asynchron 8N1
</pre>

Nun ist noch das bzw. sind noch die Baudratenregister einzustellen (UBRR bzw. UBRRL/UBRRH). Der Wert dafür ergibt sich aus der angegebenen Formel durch Einsetzen der Taktfrequenz und der gewünschten Übertragungsrate. (Das Berechnen der Formel kann man dem [[C-Präprozessor|Präprozessor]] überlassen).

<pre class="code">
/* UART-Init beim AT90S2313 */

#ifndef F_CPU
/* In neueren Version der WinAVR/Mfile Makefile-Vorlage kann
F_CPU im Makefile definiert werden, eine nochmalige Definition
hier wuerde zu einer Compilerwarnung fuehren. Daher "Schutz" durch
#ifndef/#endif */
/* Zum Beispiel 4Mhz-Quarz (falls nicht schon im Makefile definiert): */
#define F_CPU 4000000;
#endif
#define UART_BAUD_RATE 9600 // 9600 Baud

UBRR = F_CPU / (UART_BAUD_RATE * 16L) - 1;
</pre>

Wieder für den Mega16 mit einem 16bit-Register eine etwas andere Programmierung.

<pre class="code">
/* USART-Init beim ATmega16 */
#ifndef F_CPU
#define F_CPU 3686400 /* Oszillator-Frequenz in Hz */
#endif

// Hilfsmakro zur UBRR-Berechnung ("Formel" laut Datenblatt)
#define UART_UBRR_CALC(BAUD_,FREQ_) ((FREQ_)/((BAUD_)*16L)-1)

#define UART_BAUD_RATE 9600

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

/* alternativ bei der avr-libc "direkt 16bit" : */
UBRR = UART_UBRR_CALC(UART_BAUD_RATE,F_CPU);
</pre>

Teilweise kann man im Datenblatt der jeweiligen CPU auch den entsprechenden Wert nachschlagen. Ein Beispiel für einen ATmega32 bei 16MHz und für 19200 Baud: im Datenblatt des ATmega32 Tabelle "Examples of UBRR Settings" liest man für diese Vorgaben den Wert 51 ab. Dieser wird nun auf die Register UBRRH und UBRRL verteilt.

Die Initialisierung für den USART könnte dann so aussehen:

<pre class="code">
/* USART-Init 19200 Baud bei 16MHz für Mega32 */
UCSRB |= ( 1 << TXEN ); // UART TX einschalten
UCSRC |= ( 1 << URSEL )|( 3<<UCSZ0 ); // Asynchron 8N1
UBRRH = 0; // Highbyte ist 0
UBRRL = 51; // Lowbyte ist 51 ( dezimal )
</pre>

Der obige Code ist gegenüber den Versionen mit '#define ...' nicht so portabel, dafür aber etwas übersichtlicher.

=== Senden einzelner Zeichen ===

Um nun ein Zeichen auf die Schnittstelle auszugeben, müssen wir dasselbe
lediglich in das '''U'''ART '''D'''ata '''R'''egister schreiben. Vorher ist zu prüfen, ob das UART-Modul bereit ist das zu sendende Zeichen entgegenzunehmen. Die Bezeichnungen des/der Statusregisters mit dem Bit UDRE ist abhängig vom Controllertypen (vgl. Datenblatt).

<pre class="code">
// bei AVR mit einem UART ("classic AVR" z.B. AT90S8515)
while (!(USR & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = 'x'; /* schreibt das Zeichen x auf die Schnittstelle */

/** ODER **/

// bei neueren AVRs steht der Status in UCSRA/UCSR0A/UCSR1A, hier z.B. fuer ATmega16:
while (!(UCSRA & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = 'x'; /* schreibt das Zeichen x auf die Schnittstelle */
</pre>

=== Schreiben einer Zeichenkette (String) ===

Die Aufgabe "String senden" wird durch zwei Funktionen abgearbeitet. Die universelle/controllerunabhängige Funktion uart_puts übergibt jeweils ein Zeichen der Zeichenkette an eine Funktion uart_putc, die abhängig von der vorhandenen Hardware implementiert werden muss. In der Funktion zum Senden eines Zeichens ist darauf zu achten, dass vor dem Senden geprüft wird, ob der UART bereit ist den "Sendeauftrag" entgegenzunehmen.

<pre class="code">
// putc fuer AVR mit einem UART (z.B. AT90S8515)
int uart_putc(unsigned char c)
{
while(!(USR & (1 << UDRE))); /* warte, bis UDR bereit */
UDR = c; /* sende Zeichen */
return 0;
}

/** ODER **/

// bei neueren AVRs andere Bezeichnung fuer die Statusregister, hier ATmega16:
int uart_putc(unsigned char c)
{
while (!(UCSRA & (1<<UDRE))); /* warten bis Senden moeglich */
UDR = c; /* sende Zeichen */
return 0;
}

/* puts ist unabhaengig vom Controllertyp */
void uart_puts (char *s)
{
while (*s)
{ /* so lange *s != '\0' also ungleich dem "String-Endezeichen" */
uart_putc(*s);
s++;
}
}


</pre>

Warteschleifen sind insofern etwas kritisch, da während des Sendens eines Strings nicht mehr auf andere Ereignisse reagieren werden kann. Universeller ist die Nutzung von FIFO(first-in first-out)-Puffern, in denen die zu sendenden bzw. empfangenen Zeichen/Bytes zwischengespeichert und mittels Interruptroutinen an den U(S)ART weitergegeben bzw. ausgelesen werden. Dazu existieren fertige Komponenten (Bibliotheken, Libraries), die man recht einfach in eigene Entwicklungen integrieren kann. Es empfiehlt sich, diese Komponenten zu nutzen und das Rad nicht neu zu erfinden.

== Zeichen Empfangen ==

Zum Empfang von Zeichen muss der Empfangsteil des UART bei der Initialisierung aktiviert werden, indem das RXEN-Bit im jeweiligen Konfigurationsregister (UCSRB bzw UCSR0B/UCSR1B) gesetzt wird. Im einfachsten Fall wird solange gewartet, bis ein Zeichen empfangen wurde, dieses steht dann im UART-Datenregister (UDR bzw. UDR0 und UDR1 bei AVRs mit 2 UARTS) zur Verfügung (sogen. "Polling-Betrieb"). Ein Beispiel für den ATmega16:

<pre class="code">
#include <inttypes.h>
#include <avr/io.h>

/* Zusaetzlich zur Baudrateneinstellung und der weiteren Initialisierung: */
void Usart_EnableRX()
{
UCSRB |= ( 1 << RXEN );
}

/* Zeichen empfangen */
uint8_t Usart_Rx(void)
{
while (!(UCSRA & (1<<RXC))); // warten bis Zeichen verfuegbar
return UDR; // Zeichen aus UDR an Aufrufer zurueckgeben
}
</pre>

Diese Funktion blockiert den Programmablauf. Alternativ kann das RXC-Bit in einer Programmschleife abgefragt werden und dann nur bei gesetztem RXC-Bit UDR ausgelesen werden. Eleganter und in den meisten Anwendungsfällen "stabiler" ist die Vorgehensweise, die empfangenen Zeichen in einer Interrupt-Routine einzulesen und zur späteren Verarbeitung in einem Eingangsbuffer (FIFO-Buffer) zwischenzuspeichern. Dazu existieren fertige und gut getestete [[Libraries|Bibliotheken]]  und Quellcodekomponenten (z.B. UART-Library von P. Fleury, procyon-avrlib und einige in der "Academy" von avrfreaks.net).

TODO: 9bit

== Software-UART ==

Falls die Zahl der vorhandenen Hardware-UARTs nicht ausreicht, können weitere Schnittstellen über sogennante Software-UARTs ergänzt werden. Es gibt dazu (mindestens) zwei Ansätze:
* Der bei AVRs üblichste Ansatz basiert auf dem Prinzip, dass ein externer Interrupt-Pin für den Empfang ("RX") genutzt wird. Das Startbit löst den Interrupt aus, in der Interrupt-Routine (ISR) wird der externe Interrupt deaktiviert und ein Timer aktiviert. In der Interrupt-Routine des Timers wird der Zustand des Empfangs-Pins entsprechend der Baudrate abgetastet. Nach Empfang des Stop-Bits wird der externe Interrupt wieder aktiviert. Senden kann über einen beliebigen Pin ("TX") erfolgen, der entsprechend der Baudrate und dem zu sendenden Zeichen auf 0 oder 1 gesetzt wird. Die Implementierung ist nicht ganz einfach, es existieren dazu aber fertige Bibliotheken (z.B. bei [http://www.avrfreaks.net/ avrfreaks] oder in der [http://hubbard.engr.scu.edu/embedded/avr/avrlib/ Procyon avrlib]).
* Ein weiterer Ansatz erfordert keinen Pin mit "Interrupt-Funktion" aber benötigt mehr Rechenzeit. Jeder Input-Pin kann als Empfangspin (RX) dienen. Über einen Timer wird der Zustand des RX-Pins mit einem vielfachen der Baudrate abgetastet (dreifach scheint üblich) und High- bzw. Lowbits anhand einer Mindestanzahl identifiziert. (Beispiel: "Generic Software Uart" Application-Note von IAR)

Neuere AVRs (z.B. ATtiny26 oder ATmega48,88,168,169) verfügen über ein Universal Serial Interface (USI), das teilweise UART-Funktion übernehmen kann. Atmel stellt eine Application-Note bereit, in der die Nutzung des USI als UART erläutert wird (im Prinzip "Hardware-unterstützter Software-UART").

* siehe auch: Weiterführende Informationen inkl. Beispielen für die Nutzung von stdio-Funktionen (printf etc.) im [[AVR-Tutorial - UART]].
* [http://homepage.hispeed.ch/peterfleury/ Peter Fleurys] UART-Bibiliothek fuer avr-gcc/avr-libc

= 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 analogen Signale (Spannungen) in digitale Zahlenwerte gewandelt. Bei AVRs, die über keinen internen AD-Wandler verfügen (z.B. ATmega162, ATtiny2313), kann durch externe Beschaltung (R/C-Netzwerk und "Zeitmessung") die Funktion des AD-Wandlers "emuliert" werden.

Es existieren keine AVRs mit eingebautem Digital-Analog-Konverter (DAC). Diese Funktion muss durch externe Komponenten nachgebildet werden (z.B. PWM und "Glättung").

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.

== 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 Genauigkeit, mit welcher ein analoges Signal aufgelöst werden kann, wird durch die Auflösung des ADC in Anzahl Bits angegeben, man hört bzw. liest jeweils von 8-Bit-ADC oder 10-Bit-ADC oder noch höher.

Ein ADC mit 8 Bit Auflösung kann somit das analoge Signal mit einer Genauigkeit von 1/256 des Maximalwertes darstellen. Wenn wir nun mal annehmen, wir hätten eine Spannung zwischen 0 und 5 Volt und eine Auflösung von 3 Bit, dann könnten
die Werte 0V, 0.625V, 1.25, 1.875V, 2.5V, 3.125V, 3.75, 4.375, 5V
daherkommen, siehe dazu folgende Tabelle:

<div align="center"><center>

{| border="1"
|-
| align="center" | '''Eingangsspannung am ADC'''
| align="center" | '''Entsprechender Messwert'''
|-
| align="center" | 0...<0.625V
| align="center" | 0
|-
| align="center" | 0.625...<1.25V
| align="center" | 1
|-
| align="center" | 1.25...<1.875V
| align="center" | 2
|-
| align="center" | 1.875...<2.5V
| align="center" | 3
|-
| align="center" | 2.5...<3.125V
| align="center" | 4
|-
| align="center" | 3.125...<3.75V
| align="center" | 5
|-
| align="center" | 3.75...<4.375V
| align="center" | 6
|-
| align="center" | 4.375...5V
| align="center" | 7
|}

</center>
</div>

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, um so genauer kann der Wert erfasst werden.

=== Der interne ADC im AVR ===

Wenn es einmal etwas genauer sein soll, dann müssen wir auf einen AVR mit eingebautem Analog-Digital-Wandler (ADC) zurückgreifen, die über mehrere Kanäle verfügen. Kanäle heisst in diesem Zusammenhang, dass zwar bis zu zehn analoge Eingänge am AVR verfügbar sind, aber nur ein "echter" Analog-Digital-Wandler zur Verfügung steht, vor der eigentlichen Messung ist also einzustellen, 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 Mikrohenry und 100 nF 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.
* Die '''interne''' Referenzspannung wird auf '''Vcc''' bezogen, eine externe Referenzspannung auf '''GND (Masse)'''. Davon unabhängig werden digitalisierte Spannungen '''immer''' auf GND bezogen. Beim ATMEGA8 z.B. ist der Pin AREF über 32kOhm mit GND verbunden, d.h. man muss diese doch extrem niedrige Eingangsimpedanz mit in die Berechnung für einen Spannungsteiler einbeziehen, bzw. kann diesen Widerstand als R2 gleich mit benutzen. Formel für Spannungsteiler: Udiv=U/((R1+R2)/R2)

Bei Nutzung von Vcc 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 angestossen 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 (inzwischen veralteten) AT90S8535, welcher über 8 ADC-Kanäle verfügt. Die Register unterscheiden sich jedoch nicht erheblich von denen aktueller AVRs (vgl. Datenblatt).

{| border="1"
|-
| '''ADCSR   '''
| '''ADC''' '''C'''ontrol and '''S'''tatus '''R'''egister. 
In diesem Register stellen wir ein, wie wir den '''ADC''' verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''ADEN'''
| align="center" | '''ADSC'''
| align="center" | '''ADFR'''
| align="center" | '''ADIF'''
| align="center" | '''ADIE'''
| align="center" | '''ADPS2'''
| align="center" | '''ADPS1'''
| align="center" | '''ADPS0'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 0
|}

'''ADEN''' ('''AD'''C '''En'''able)
: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''' ('''AD'''C '''S'''tart '''C'''onversion)
: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''' ('''AD'''C '''Fr'''ee Running Select)
:Mit diesem Bit wird die Betriebsart eingestellt.
:Eine logische 1 aktiviert den frei laufenden Modus. Der ''' ADC''' misst nun ständig den ausgewählten Kanal und schreibt den gemessenen Wert in das '''ADC Data Register'''.

'''ADIF''' ('''AD'''C '''I'''nterrupt '''F'''lag)
:Dieses Bit wird vom ''' ADC''' gesetzt, wenn eine Umwandlung erfolgt und das '''ADC Data Register''' aktualisiert ist.
: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 (So steht es in der AVR-Dokumentation).

'''ADIE''' ('''AD'''C '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist und ebenso das ''' I-Bit''' im Statusregister '''SREG''', dann wird der ''' ADC-Interrupt''' aktiviert.

'''ADPS2...ADPS0''' ('''AD'''C '''P'''rescaler '''S'''elect 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 sein.
:Der Vorteiler muss also so eingestellt werden, dass die CPU-Taktfrequenz dividiert durch den Teilungsfaktor einen Wert zwischen 50-200kHz ergibt.
:Bei einer CPU-Taktfrequenz von 4MHz beispielsweise rechnen wir

:<math>
\begin{matrix}
TF_{min}=\frac{CLK}{200kHz}=\frac{4000000}{200000}=\mathbf{20}
\\
\\
TF_{max}=\frac{CLK}{50kHz}=\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.
<dl><dd>
{| style="" border="1"
|-
| align="center" | '''ADPS2'''
| align="center" | '''ADPS1'''
| align="center" | '''ADPS0'''
| align="center" | '''Teilungsfaktor'''
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 2
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 2
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 4
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| align="center" | 8
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 16
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| align="center" | 32
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| align="center" | 64
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| align="center" | 128
|}
</dd></dl>
|-
| '''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:

<pre class="code">
x = ADCL; // mit uint16_t x
x += (ADCH<<8); // in zwei Zeilen (LSB/MSB-Reihenfolge und
C-Operatorprioritaet sichergestellt)
</pre>

oder

<pre class="code">
x = ADCW; // je nach AVR auch x = ADC (siehe avr/ioxxx.h)
</pre>

|-
| '''ADMUX  '''
| '''AD'''C '''Mu'''ltiple'''x'''er 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:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''MUX2'''
| align="center" | '''MUX1'''
| align="center" | '''MUX0'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''MUX2...MUX0'''
:Mit diesem 3 Bits wird der zu messende Kanal bestimmt. Es wird einfach die entsprechende Pinnummer des Ports eingeschrieben.
:Wenn das Register beschrieben wird, während dem 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.

:Meine Empfehlung ist deswegen klar 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.
|}

==== Aktivieren des ADC ====

Um den ''' ADC''' zu aktivieren, müssen wir das '''ADEN'''-Bit im '''ADCSR'''-Register
setzen. Im gleichen Schritt legen wir auch gleich 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 mit Spannungsteiler konditionieren. Ergebnis der Routine ist der ADC-Wert, also 0 für 0-Volt und 1024 für V_ref-Volt.

<pre class="code">

uint16_t ReadChannel(uint8_t mux)
{
uint8_t i;
uint16_t result = 0; //Initialisieren wichtig, da lokale Variablen
//nicht automatisch initialisiert werden und
//zufällige Werte haben. Sonst kann Quatsch rauskommen
ADCSRA = (1<<ADEN) | (1<<ADPS1) | (1<<ADPS0); // Frequenzvorteiler
// setzen auf 8 (1) und ADC aktivieren (1)

ADMUX = mux; // Kanal waehlen
ADMUX |= (1<<REFS1) | (1<<REFS0); // interne Referenzspannung nutzen

/* 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



/* Eigentliche Messung - Mittelwert aus 4 aufeinanderfolgenden Wandlungen */
for(i=0;i<4;i++)
{
ADCSRA |= (1<<ADSC); // eine Wandlung "single conversion"

while ( ADCSRA & (1<<ADSC) ); // auf Abschluss der Konvertierung warten
result += ADCW; // Wandlungsergebnisse aufaddieren
}
ADCSRA &= ~(1<<ADEN); // ADC deaktivieren (2)

result /= 4; // Summe durch vier teilen = arithm. Mittelwert

return result;
}

...

/* Beispielaufrufe: */

void foo(void)
{
uint16_t adcval;

adcval = ReadChannel(0); /* MUX-Bits auf 0b0000 -> Channel 0 */
...
adcval = ReadChannel(2); /* MUX-Bits auf 0b0010 -> Channel 2 */
...
}

</pre>

Im Beispiel wird bei jedem Aufruf der ADC aktiviert und nach der Wandlung wieder abgeschaltet, das spart Strom. Will man dies nicht, verschiebt man die mit (1) gekennzeichneten Zeilen in eine Funktion adc_init() o.ä. und löscht die mit (2) markierten Zeilen. Das Löschen des ADIF-Flags sollte, '''entgegen''' der [http://www.nongnu.org/avr-libc/user-manual/FAQ.html#faq_intbits FAQ], mit
<pre class="code">
...
ADCSRA |= (1<<ADIF);
...
</pre>
erfolgen. Die Methode in der FAQ eignet sich nur für Register in denen '''nur''' Interrupt-Flags stehen.

=== 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 eine 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.

[[Image:Poti.gif]]

Wird der Portpin des Controllers auf Ausgang konfiguriert (im Beispiel ''DDRD |= (1<<PD3)'') und dieser Ausgang auf Logisch 1 ("High", ''PORTD |= (1<<PD3)'') 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<<PD3); PORTD &= (1<<PD3)''), 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 Thresholdspannung 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 Ohm Widerstand dient dem Schutz des Controllers. Es würde sonst bei Maximaleinstellung des Potentionmeters (hier 0 Ohm) ein zu hoher Strom fliessen, der die Eingangsstufe 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. Ein Beispielprogramm findet sich auf [http://www.mypage.bluewin.ch/ch_schifferle/ Christian Schifferles Web-Seite] im Archiv ''ATMEL.ZIP'', welches unter den Titel ''Tutorial "Programmieren mit C für Atmel Mikrocontroller'' heruntergeladen werden kann.



==== 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.

[[Image:ADC ueber Komparator.gif]]

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:

[[Image:DAC R2R.gif]]

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:

[[Image:PWM Theorie 1.gif]]

Diese Rechteckspannung hat nun einen geometrischen Mittelwert,
der je nach Pulsbreite kleiner oder grösser ist.

[[Image:PWM Theorie 2.gif]]

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

Mit den AVR's 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:

{| border="1"
|-
| align="center" | '''PWM11'''
| align="center" | '''PWM10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| PWM-Modus des Timers ist nicht aktiv.
|-
| align="center" | 0
| align="center" | 1
| 8-Bit PWM.
|-
| align="center" | 1
| align="center" | 0
| 9-Bit PWM.
|-
| align="center" | 1
| align="center" | 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:

{| border="1"
|-
| align="center" | '''Auflösung'''
| align="center" | '''Obergrenze'''
| '''Frequenz'''
|-
| align="center" | 8
| align="center" | 255
| fTC1 / 510
|-
| align="center" | 9
| align="center" | 511
| fTC1 / 1022
|-
| align="center" | 10
| align="center" | 1023
| fTC1 / 2046
|}

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

{| border="1"
|-
| align="center" | '''COM1A1'''
| align="center" | '''COM1A0'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Keine Wirkung, Pin wird nicht geschaltet.
|-
| align="center" | 0
| align="center" | 1
| Keine Wirkung, Pin wird nicht geschaltet.
|-
| align="center" | 1
| align="center" | 0
| Nicht invertierende PWM. 
Der Ausgangspin wird gelöscht beim Hochzählen und gesetzt beim
Herunterzählen.
|-
| align="center" | 1
| align="center" | 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 heisst dann:

<pre class="code">
TCCR1A = (1<<PWM11)|(1<<PWM10)|(1<<COM1A1);
</pre>

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.

{| border="1"
|-
| align="center" | '''CS12'''
| align="center" | '''CS11'''
| align="center" | '''CS10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stop. Der Timer/Counter wird gestoppt.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CK
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CK / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CK / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CK / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CK / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin 1, negative Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin 1, positive Flanke
|}

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

<pre class="code">
TCCR1B = (1<<CS12) | (1<<CS10);
</pre>

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

<pre class="code">
OCR1A = xxx;
</pre>

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

[[Image:PWM Theorie 3.gif]]

[[Image:PWM Theorie 4.gif]]

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.

= Die Timer/Counter des AVR =

Die heutigen Mikrocontroller und insbesondere die RISC-AVRs sind für viele Steuerungsaufgaben zu schnell. Wenn wir beispielsweise eine LED oder Lampe blinken lassen wollen, können wir selbstverständlich nicht die CPU-Frequenz verwenden, da ja dann nichts mehr vom Blinken zu bemerken wäre.

Wir brauchen also eine Möglichkeit, Vorgänge in Zeitabständen durchzuführen, die geringer als die Taktfrequenz des Controllers sind. Selbstverständlich sollte die resultierende Frequenz auch noch möglichst genau und stabil sein.

Hier kommen die im AVR vorhandenen Timer/Counter zum Einsatz.

Ein anderes Anwendungsgebiet ist die Zählung von Signalen, welche über einen I/O-Pin zugeführt werden können.

Die folgenden Ausführungen beziehen sich auf den AT90S2313. Für andere Modelltypen müsst ihr euch die allenfalls notwendigen Anpassungen aus den Datenblättern der entsprechenden Controller herauslesen.

Wir unterscheiden grundsätzlich zwischen 8-Bit Timern, welche eine Auflösung von 256 aufweisen und 16-Bit Timern mit (logischerweise) einer Auflösung von 65536. Als Eingangstakt für die Timer/Counter kann entweder die CPU-Taktfrequenz, der Vorteiler-Ausgang oder ein an einen I/O-Pin angelegtes Signal verwendet werden. Wenn ein externes Signal verwendet wird, so darf dessen Frequenz nicht höher sein als die Hälfte des CPU-Taktes.

== Der Vorteiler (Prescaler) ==


Der Vorteiler dient dazu, den CPU-Takt vorerst um einen einstellbaren Faktor zu reduzieren. Die so geteilte Frequenz wird den Eingängen der Timer zugeführt.

Wenn wir mit einem CPU-Takt von 4 MHz arbeiten und den Vorteiler auf 1024 einstellen, wird also der Timer mit einer Frequenz von 4 MHz / 1024, also mit ca. 4 kHz versorgt. Wenn also der Timer läuft, so wird das Daten- bzw. Zählregister (TCNTx) mit dieser Frequenz inkrementiert.

== 8-Bit Timer/Counter ==

Alle AVR-Modelle verfügen über mindestens einen, teilweise sogar zwei, 8-Bit Timer.

Der 8-Bit Timer wird z.B bei AT90S2313 über folgende Register angesprochen (bei anderen Typen weitestgehend analog):

{| border="1"
|-
| '''TCCR0'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister
Timer '''0'''

In diesem Register stellen wir ein, wie wir den Timer/Counter verwenden möchten.

Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''CS02'''
| align="center" | '''CS01'''
| align="center" | '''CS00'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''CS02, CS01, CS00''' ('''C'''lock '''S'''elect Bits)
:Diese 3 Bits bestimmen die Quelle für den Timer/Counter:
<dl><dd>
{| border="1"
|-
| align="center" | CS02
| align="center" | CS01
| align="center" | CS00
| Resultat
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stopp, Der Timer/Counter wird angehalten.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CPU-Takt
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CPU-Takt / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CPU-Takt / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CPU-Takt / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CPU-Takt / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin '''TO''', fallende Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin '''TO''', steigende Flanke
|}
</dd>
</dl>
:Wenn als Quelle der externe Pin '''TO''' verwendet wird, so wird ein Flankenwechsel auch erkannt, wenn der Pin '''TO''' als Ausgang geschaltet ist.

|-
| '''TCNT0'''
| '''T'''imer/'''C'''ou'''nt'''er Daten Register Timer '''0''' 
Dieses ist als 8-Bit Aufwärtszähler mit Schreib- und Lesezugriff
realisiert. Wenn der Zähler den Wert 255 erreicht hat beginnt er beim
nächsten Zyklus wieder bei 0.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}
|}

Um nun also den Timer0 in Betrieb zu setzen und ihn mit einer Frequenz von 1/1024-tel des CPU-Taktes zählen zu lassen, schreiben wir die folgende Befehlszeile:

<pre class="code">
TCCR0 |= (1<<CS00)|(1<<CS02);
</pre>

Der Zähler zählt nun aufwärts bis 255, um dann wieder bei 0 zu beginnen. Der aktuelle Zählerstand steht in TCNT0. Bei jedem Überlauf von 255 auf 0 wird das Timer Overflow Flag '''TOV0''' im Timer Interrupt Flag '''TIFR'''-Register gesetzt und, falls so konfiguriert, ein entsprechender Timer-Overflow-Interrupt ausgelöst und die daran gebundene Interrupt-Routine abgearbeitet.

== 16-Bit Timer/Counter ==

Viele AVR-Modelle besitzen ausser den 8-Bit Timern auch 16-Bit Timer. Die 16-Bit Timer/Counter sind etwas komplexer aufgebaut als die 8-Bit Timer/Counter, bieten dafür aber auch viel mehr Möglichkeiten, als da sind:

* Die [[PWM]]-Betriebsart Erzeugung eines pulsweitenmodulierten Ausgangssignals.
* Vergleichswert-Überprüfung mit Erzeugung eines Ausgangssignals (Output Compare Match).
* Einfangen eines Eingangssignals mit Speicherung des aktuellen Zählerwertes (Input Capturing), mit zuschaltbarer Rauschunterdrückung (Noise Filtering).

Folgende Register sind dem Timer/Counter 1 zugeordnet:

{| border="1"
|-
| '''TCCR1A'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister '''A''' Timer '''1''' 
In diesem und dem folgenden Register stellen wir ein, wie wir den Timer/Counter verwenden möchten. 
Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''COM1A1'''
| align="center" | '''COM1A0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''PWM11'''
| align="center" | '''PWM10'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''COM1A1''', '''COM1A0''' ('''Co'''mpare '''M'''atch Control Bits)
:Diese 2 Bits bestimmen die Aktion, welche am Output-Pin '''OC1''' ausgeführt werden soll, wenn der Wert des Datenregisters des Timer/Counter 1 den Wert des Vergleichsregisters erreicht, also ein so genannter Compare Match auftritt.
:Der Pin '''OC1''' ('''PB3''' beim 2313) muss mit dem Datenrichtungsregister als Ausgang konfiguriert werden.

<dl><dd>
{| border="1"
|-
| align="center" | COM1A1
| align="center" | COM1A0
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 0
| align="center" | 1
| Das Signal am Pin '''OC1''' wird invertiert (Toggle).
|-
| align="center" | 1
| align="center" | 0
| Der Output Pin '''OC1''' wird auf 0 gesetzt.
|-
| align="center" | 1
| align="center" | 1
| Der Output Pin '''OC1''' wird auf 1 gesetzt.
|}
</dd></dl>
:In der PWM-Betriebsart haben diese Bits eine andere Funktion.
<dl><dd>
{| border="1"
|-
| align="center" | COM1A1
| align="center" | COM1A0
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 0
| align="center" | 1
| Output-Pin '''OC1''' wird nicht angesteuert.
|-
| align="center" | 1
| align="center" | 0
| Wird beim Hochzählen der Wert im Vergleichsregister erreicht, so wird der Pin '''OC1''' auf 0 gesetzt.
Wird beim Herunterzählen der Wert im Vergleichsregister erreicht, so wird der Pin auf 1 gesetzt.

Man nennt dies ''nicht invertierende PWM''.
|-
| align="center" | 1
| align="center" | 1
| Wird beim Hochzählen der Wert im Vergleichsregister erreicht, so wird der Pin '''OC1''' auf 1 gesetzt.
Wird beim Herunterzählen der Wert im Vergleichsregister erreicht, so wird der Pin auf 0 gesetzt.

Man nennt dies ''invertierende PWM''.
|}
</dd></dl>

'''PWM11''', '''PWM10''' ('''PWM''' Mode Select Bits)
:Mit diesen 2 Bits wird die PWM-Betriebsart des Timer/Counter 1 gesteuert.
<dl><dd>
{| border="1"
|-
| align="center" | PWM11
| align="center" | PWM10
| Resultat
|-
| align="center" | 0
| align="center" | 0
| Die PWM-Betriebsart ist nicht aktiviert. Timer/Counter 1 arbeitet als normaler Timer bzw. Zähler.
|-
| align="center" | 0
| align="center" | 1
| 8-Bit PWM Betriebsart aktivieren.
|-
| align="center" | 1
| align="center" | 0
| 9-Bit PWM Betriebsart aktivieren.
|-
| align="center" | 1
| align="center" | 1
| 10-Bit PWM Betriebsart aktivieren.
|}
</dd></dl>
|-
| '''TCCR1B'''
| '''T'''imer/'''C'''ounter '''C'''ontrol '''R'''egister '''B''' Timer '''1'''

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''ICNC1'''
| align="center" | '''ICES1'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''CTC1'''
| align="center" | '''CS12'''
| align="center" | '''CS11'''
| align="center" | '''CS10'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''ICNC1''' ('''I'''nput '''C'''apture '''N'''oise '''C'''anceler (4 CKs) Timer/Counter 1
:oder auf Deutsch Rauschunterdrückung des Eingangssignals.
:Wenn dieses Bit gesetzt ist und mit dem Input Capture Signal gearbeitet wird so werden nach der Triggerung des Signals mit der entsprechenden Flanke (steigend oder fallend) am Input Capture Pin '''ICP''' jeweils 4 Messungen mit der CPU-Frequenz des Eingangssignals abgefragt. Nur dann, wenn alle 4 Messungen den gleichen Zustand aufweisen gilt das Signal als erkannt.

'''ICES1''' ('''I'''nput '''C'''apture '''E'''dge '''S'''elect Timer/Counter '''1''')
:Mit diesem Bit wird bestimmt, ob die steigende ('''ICES1'''=1) oder fallende ('''ICES1'''=0) Flanke zur Auswertung des Input Capture Signals an Pin '''ICP''' heran gezogen wird.

'''CTC1''' ('''C'''lear '''T'''imer/'''C'''ounter on Compare Match Timer/Counter '''1''')
:Wenn dieses Bit gesetzt ist, so wird nach einer Übereinstimmung des Datenregisters '''TCNT1H'''/'''TCNT1L''' mit dem Vergleichswert in '''OCR1H'''/'''OCR1L''' das Datenregister '''TCNT1H'''/'''TCNT1L''' auf 0 gesetzt.
:Da die Übereinstimmung im Takt nach dem Vergleich behandelt wird, ergibt sich je nach eingestelltem Vorteiler ein etwas anderes Zählverhalten:
:Wenn der Vorteiler auf 1 gestellt ist und C der jeweilige Zählerwert ist, dann nimmt das Datenregister, im CPU-Takt betrachtet, folgende Werte an:
:... | C-2 | C-1 | C | 0 | 1 |...
:Wenn der Vorteiler z.B. auf 8 eingestellt ist, dann nimmt das Datenregister folgende Werte an:
:... | C-2, C-2, C-2, C-2, C-2, C-2, C-2, C-2 | C-1, C-1, C-1, C-1, C-1, C-1, C-1, C-1 | C, 0, 0, 0, 0, 0, 0, 0 |...
:In der PWM-Betriebsart hat dieses Bit keine Funktion.

'''CS12''', '''CS11''', '''CS10''' ('''C'''lock '''S'''elect Bits)
:Diese 3 Bits bestimmen die Quelle für den Timer/Counter:
<dl><dd>
{| border="1"
|-
| align="center" | CS12
| align="center" | CS11
| align="center" | CS10
| Resultat
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| Stopp, Der Timer/Counter wird angehalten.
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| CPU-Takt
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| CPU-Takt / 8
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| CPU-Takt / 64
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| CPU-Takt / 256
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| CPU-Takt / 1024
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| Externer Pin TO, fallende Flanke
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| Externer Pin T0, steigende Flanke
|}
</dd></dl>
:Wenn als Quelle der externe Pin T0 verwendet wird, so wird ein Flankenwechsel auch erkannt, wenn der Pin T0 als Ausgang geschaltet ist.
|-
| '''TCNT1H''' '''TCNT1L'''
| '''T'''imer/'''C'''ou'''nt'''er Daten Register Timer/Counter '''1'''
Dieses ist als 16-Bit Aufwärtszähler mit Schreib- und Lesezugriff realisiert. Wenn der Zähler den Wert 65535 erreicht hat, beginnt er beim nächsten Zyklus wieder bei 0.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''TCNT1H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''TCNT1L'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

In der PWM-Betriebsart wird das Register als Auf/Ab-Zähler verwendet, d.h. der Wert steigt zuerst von 0 bis er den Überlauf von 65535 auf 0 erreicht hat. Dann zählt das Register rückwärts wiederum bis 0.

Zum Auslesen des Registers wird von der CPU ein internes TEMP-Register verwendet. Das gleiche Register wird auch verwendet, wenn auf '''OCR1''' oder '''ICR1''' zugegriffen wird.

Deshalb müssen vor dem Zugriff auf eines dieser Register alle Interrupts gesperrt werden, weil sonst die Möglichkeit des gleichzeitigen Zugriffs auf das Temporärregister gegeben ist, was natürlich zu fehlerhaftem Verhalten des Programms führt.. Zudem muss zuerst '''TCNT1L''' und erst danach '''TCNT1H''' ausgelesen werden.

Wenn in das Register geschrieben werden soll, müssen ebenfalls alle Interrrupts gesperrt werden. Dann muss zuerst das '''TCNT1H'''-Register und erst danach das '''TCNT1L'''-Register geschrieben werden, also genau die umgekehrte Reihenfolge wie beim Lesen des Registers.
|-
| '''OCR1H''' '''OCR1L'''
| Timer/Counter '''O'''utput '''C'''ompare '''R'''egister Timer/Counter '''1'''
{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''OCR1H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''OCR1L'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

Der Wert im Output Compare Register wird ständig mit dem aktuellen Wert im Datenregister TCNT1H/TCNT1L verglichen. Stimmen die beiden Werte überein, so wird ein sogenannter Output Compare Match ausgelöst. Die entsprechenden Aktionen werden über die Timer/Counter 1 Control und Status Register eingestellt.

Zum Auslesen des Registers wird von der CPU ein internes TEMP-Register verwendet. Das gleiche Register wird auch verwendet, wenn auf '''OCR1''' oder '''ICR1''' zugegriffen wird.
Deshalb müssen vor dem Zugriff auf eines dieser Register alle Interrupts gesperrt werden, weil sonst die Möglichkeit des gleichzeitigen Zugriffs auf das Temporärregister gegeben ist, was natürlich zu fehlerhaftem Verhalten des Programms führt.. Zudem muss zuerst '''OCR1L''' und erst danach '''OCR1H''' ausgelesen werden.

Wenn in das Register geschrieben werden soll, müssen ebenfalls alle Interrupts gesperrt werden. Dann muss zuerst das '''OCR1H'''-Register und erst danach das '''OCR1L'''-Register geschrieben werden, also genau die umgekehrte Reihenfolge wie beim Lesen des Registers.
|-
| '''ICR1H''' '''ICR1L'''
| Timer/Counter '''I'''nput '''C'''apture '''R'''egister Timer/Counter '''1''' 
{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
| align="center" |  
|-
| '''Name'''
| align="center" | '''MSB'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''ICR1''''''H'''
|-
| '''Name'''
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" | '''LSB'''
| align="center" | '''ICR1''''''L'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" |  
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" |  
|}

Das Input Capture Register ist ein 16-Bit Register mit Lesezugriff. Es kann nicht beschrieben werden.

Wenn am Input Capture Pin '''ICP''' die gemäß Einstellungen im '''TCCR1B''' definierte Flanke erkannt wird, so wird der aktuelle Inhalt des Datenregisters '''TCNT1H'''/'''TCNT1L''' sofort in dieses Register kopiert und das Input Capture Flag '''ICF1''' im Timer Interrupt Flag Register '''TIFR''' gesetzt.

Wie bereits oben erwähnt, müssen vor dem Zugriff auf dieses Register alle Interrupts gesperrt werden. Zudem müssen Low- und Highbyte des Registers in der richtigen Reihenfolge bearbeitet werden:

{| border="0"
|-
| Lesen:
| '''ICR1L''' -> '''ICR1H'''
|-
| Schreiben:
| '''ICR1H''' -> '''ICR1L'''
|}
|}

=== Die PWM-Betriebsart ===

Wenn der Timer/Counter 1 in der PWM-Betriebsart betrieben wird, so bilden das Datenregister '''TCNT1H'''/'''TCNT1L''' und das Vergleichsregister '''OCR1H'''/'''OCR1L''' einen 8-, 9- oder 10-Bit, frei laufenden PWM-Modulator, welcher als PWM-Signal am '''OC1'''-Pin ('''PB3''' beim 2313) abgegriffen werden kann. Das Datenregister '''TCNT1H'''/'''TCNT1L''' wird dabei als Auf-/Ab-Zähler betrieben, welcher von 0 an aufwärts zählt bis zur Obergrenze und danach wieder zurück auf 0.
Die Obergrenze ergibt sich daraus, ob 8-, 9- oder 10-Bit PWM verwendet wird, und zwar gemäss folgender Tabelle:

{| border="1"
|-
| align="center" | '''Auflösung'''
| align="center" | '''Obergrenze'''
| '''Frequenz'''
|-
| align="center" | 8
| align="center" | 255
| fTC1 / 510
|-
| align="center" | 9
| align="center" | 511
| fTC1 / 1022
|-
| align="center" | 10
| align="center" | 1023
| fTC1 / 2046
|}

Wenn nun der Zählerwert im Datenregister den in '''OCR1H'''/'''OCR1L''' gespeicherten Wert erreicht, wird der Ausgabepin '''OC1''' gesetzt bzw. gelöscht, je nach Einstellung von '''COM1A1''' und '''COM1A0''' im '''TCCR1A'''-Register.

Ich habe versucht, die entsprechenden Signale in der folgenden Grafik zusammenzufassen

[[Image:PWM Theorie 3.gif]]

[[Image:PWM Theorie 4.gif]]

=== Vergleichswert-Überprüfung ===

Hier wird in ein spezielles Vergleichswertregister ('''OCR1H'''/'''OCR1L''') ein Wert eingeschrieben, welcher ständig mit dem aktuellen Zählerwert verglichen wird.
Erreicht der Zähler den in diesem Register eingetragenen Wert, so kann ein Signal (0 oder 1) am Pin '''OC1''' erzeugt und/oder ein Interrupt ausgelöst werden.

=== Einfangen eines Eingangssignals (Input Capturing) ===

Bei dieser Betriebsart wird an den Input Capturing Pin (ICP) des Controllers eine Signalquelle angeschlossen.
Nun kann je nach Konfiguration entweder ein Signalwechsel von 0 nach 1 (steigende Flanke) oder von 1 nach 0 (fallende Flanke) erkannt werden und der zu diesem Zeitpunkt aktuelle Zählerstand in ein spezielles Register abgelegt werden. Gleichzeitig kann auch ein entsprechender Interrupt ausgelöst werden.
Wenn die Signalquelle ein starkes Rauschen beinhaltet, kann die Rauschunterdrückung eingeschaltet werden. Dann wird beim Erkennen der konfigurierten Flanke über 4 Taktzyklen das Signal überwacht und nur dann, wenn alle 4 Messungen gleich sind, wird die entsprechende Aktion ausgelöst.

== Gemeinsame Register ==

Verschiedene Register beinhalten Zustände und Einstellungen, welche sowohl
für den 8-Bit, als auch für den 16-Bit Timer/Counter in ein und demselben
Register zu finden sind.

{| border="1"
|-
| '''TIMSK'''
| '''T'''imer/Counter '''I'''nterrupt '''M'''a'''sk'''
Register

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''TOIE1'''
| align="center" | '''OCIE1A'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''TICIE'''
| align="center" | '''-'''
| align="center" | '''TOIE0'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''TOIE1''' ('''T'''imer/Counter '''O'''verflow '''I'''nterrupt '''E'''nable Timer/Counter '''1''')
:Wenn dieses Bit gesetzt ist, wird bei einem Überlauf des Datenregisters des Timer/Counter 1 ein Timer Overflow 1 Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''OCIE1A''' ('''O'''utput '''C'''ompare Match '''I'''nterrupt '''E'''nable Timer/Counter '''1''')
:Beim Timer/Counter 1 kann zusätzlich zum Überlauf ein Vergleichswert definiert werden.

:Wenn dieses Bit gesetzt ist, wird beim Erreichen des Vergleichswertes ein Compare Match Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

'''TICIE''' ('''T'''imer/Counter '''I'''nput '''C'''apture '''I'''nterrupt '''E'''nable)
:Wenn dieses Bit gesetzt ist, wird ein Capture Event Interrupt ausgelöst, wenn ein entsprechendes Signalereignis am Pin PD6(ICP) auftritt. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein, wenn auch ein entsprechender Interrupt ausgelöst werden soll.

'''TOIE0''' ('''T'''imer/Counter '''O'''verflow '''I'''nterrupt '''E'''nable Timer/Counter '''0''')
:Wenn dieses Bit gesetzt ist, wird bei einem Überlauf des Datenregisters des Timer/Counter 0 ein Timer Overflow 0 Interrupt ausgelöst. Das Global Enable Interrupt Flag muss selbstverständlich auch gesetzt sein.

|-
| '''TIFR'''
| '''T'''imer/Counter '''I'''nterrupt '''F'''lag '''R'''egister

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''TOV1'''
| align="center" | '''OCF1A'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''ICF1'''
| align="center" | '''-'''
| align="center" | '''TOV0'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''TOV1''' ('''T'''imer/Counter '''O'''verflow Flag Timer/Counter '''1''')
:Dieses Bit wird vom Controller gesetzt, wenn beim Timer 1 ein Überlauf des Datenregisters stattfindet.

:In der PWM-Betriebsart wird das Bit gesetzt, wenn die Zählrichtung von auf- zu abwärts und umgekehrt geändert wird (Zählerwert = 0).

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''OCF1A''' ('''O'''utput '''C'''ompare '''F'''lag Timer/Counter '''1''')
:Dieses Bit wird gesetzt, wenn der aktuelle Wert des Datenregisters von Timer/Counter 1 mit demjenigen im Vergleichsregister '''OCR1''' übereinstimmt.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''ICF1''' ('''I'''nput '''C'''apture '''F'''lag Timer/Counter '''1''')
:Dieses Bit wird gesetzt, wenn ein Capture-Ereignis aufgetreten ist, welches anzeigt, dass der Wert des Datenregisters des Timer/Counter 1 in das Input Capture Register ICR1 übertragen wurde.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.

'''TOV0''' ('''T'''imer/Counter '''O'''verflow Flag Timer/Counter '''0''')
:Dieses Bit wird vom Controller gesetzt, wenn beim Timer 0 ein Überlauf des Datenregisters stattfindet.

:Das Flag wird automatisch gelöscht, wenn der zugehörige Interrupt-Vektor aufgerufen wird. Es kann jedoch auch gelöscht werden, indem eine logische 1 (!) in das entsprechende Bit geschrieben wird.
|}

 

= 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 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_mode()'''
:Versetzt den Controller in den mit set_sleep_mode gewählten Schlafmodus.

<pre class="code">
#include <avr/io.h>
#include <avr/sleep.h>
...
set_sleep_mode(SLEEP_MODE_PWR_DOWN);
sleep_mode();

// Code hier wird erst nach Auftreten eines entsprechenden
// "Aufwach-Interrupts" verarbeitet
...
</pre>

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:

<pre class="code">
#include <avr/io.h>
...
// Sleep-Mode "Power-Save" beim ATmega169 "manuell" aktivieren
SMCR = (3<<SM0) | (1<<SE);
asm volatile ("sleep"::);
...
</pre>

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Power Management and Sleep-Modes

= Der Watchdog =

Und hier kommt das ultimative Mittel gegen die Unvollkommenheit von uns
Programmierern, der Watchdog.

So sehr wir uns auch anstrengen, es wird uns kaum je gelingen, das absolut
perfekte und fehlerfreie Programm zu entwickeln.

Der Watchdog kann uns zwar auch nicht zu besseren Programmen verhelfen aber er
kann dafür sorgen, dass unser Programm, wenn es sich wieder mal in's Nirwana
verabschiedet hat, neu gestartet wird, indem ein Reset des Controllers
ausgelöst wird.

Betrachten wir doch einmal folgende Codesequenz:

<pre class="code">
uint8_t x;

x = 10;

while (x >= 0) {
// tu was

x--;
}
</pre>

Wenn wir die Schleife mal genau anschauen sollte uns auffallen, dass dieselbe niemals beendet wird. Warum nicht? Ganz einfach, weil eine als '''''unsigned''''' deklarierte Variable niemals kleiner als Null werden kann (der Compiler sollte jedoch eine ensprechende Warnung ausgeben).
Das Programm würde sich also hier aufhängen und auf ewig in der Schleife drehen.
Und hier genau kommt der Watchdog zum Zug.

== Wie funktioniert nun der Watchdog ==

Der Watchdog enthält einen separaten Timer/Counter, welcher mit einem intern erzeugten Takt von 1 MHz bei 5V Vcc getaktet wird.
Nachdem der Watchdog aktiviert und der gewünschte Vorteiler eingestellt wurde beginnt der Counter von 0 an hochzuzählen.
Wenn nun die je nach Vorteiler eingestellte Anzahl Zyklen erreicht wurde, löst der Watchdog einen Reset aus. Um nun also im Normalbetrieb den Reset zu verhindern müssen wir den Watchdog regelmässig wieder neu starten bzw. Rücksetzen (Watchdog Reset).
Dies sollte innerhalb unserer Hauptschleife passieren.

Um ein unbeabsichtigtes Ausschalten des Watchdogs zu verhindern muss ein spezielles Prozedere verwendet werden, um den WD auszuschalten und zwar müssen zuerst die beiden Bits WDTOE und WDE in einer einzelnen Operation (also nicht mit sbi) auf 1 gesetzt werden.
Dann muss innerhalb der nächsten 4 Taktzyklen das Bit WDE auf 0 gesetzt werden.

Das Watchdog Control Register:

{| border="1"
|-
| '''WDTCR'''
| '''W'''atchog '''T'''imer  '''C'''ontrol '''R'''egister

In diesem Register stellen wir ein, wie wir den Watchdog verwenden möchten.

Das Register ist wie folgt aufgebaut:

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''WDTOE'''
| align="center" | '''WDE'''
| align="center" | '''WDP2'''
| align="center" | '''WDP1'''
| align="center" | '''WDP0'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''WDTOE''' ('''W'''atch'''d'''og '''T'''urn '''O'''ff '''E'''nable)
:Dieses Bit muss gesetzt sein, wenn das Bit '''WDE''' gelöscht wird, andernfalls wird der Watchdog nicht ausgeschaltet.
:Wenn das Bit einmal gesetzt ist wird es von der Hardware nach 4 Taktzyklen automatisch wieder gelöscht.

'''WDE''' ('''W'''atch'''d'''og '''E'''nable)
:Wenn dieses Bit gesetzt wird, so wird der Watchdog aktiviert.
:Das Bit kann nur gelöscht werden, solange das Bit '''WDTOE''' auf 1 steht.

'''WDP2''', '''WDP1''', '''WDP0''' ('''W'''atch'''d'''og Timer '''P'''rescaler Bits)
:Diese 3 Bits bestimmen die Anzahl Oszillatorzyklen für den Watchdog, also, wie lange es dauert, bis ein Reset ausgelöst wird:
<dl><dd>
{| border="1"
|-
| align="center" | WDP2
| align="center" | WDP1
| align="center" | WDP0
| align="center" | Anzahl Zyklen
| align="center" | Typ. Timeoutzeit bei Vcc = 3V
| align="center" | Typ. Timeoutzeit bei Vcc = 5V
|-
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 16K
| align="center" | 47ms
| align="center" | 15ms
|-
| align="center" | 0
| align="center" | 0
| align="center" | 1
| align="center" | 32K
| align="center" | 94ms
| align="center" | 30ms
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 64K
| align="center" | 0.19s
| align="center" | 60ms
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| align="center" | 128K
| align="center" | 0.38s
| align="center" | 0.12s
|-
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | 256K
| align="center" | 0.75s
| align="center" | 0.24s
|-
| align="center" | 1
| align="center" | 0
| align="center" | 1
| align="center" | 512K
| align="center" | 1.5s
| align="center" | 0.49s
|-
| align="center" | 1
| align="center" | 1
| align="center" | 0
| align="center" | 1024K
| align="center" | 3s
| align="center" | 0.97s
|-
| align="center" | 1
| align="center" | 1
| align="center" | 1
| align="center" | 2048K
| align="center" | 6s
| align="center" | 1.9s
|}
</dd></dl>
|}

Um den Watchdog mit dem AVR-GCC Compiler zu verwenden, muss die Headerdatei ''wdt.h'' (''#include <avr/wdt.h>'') in die Quelldatei eingebunden werden.

Danach können die folgenden Funktionen verwendet werden:

* '''wdt_enable(uint8_t timeout)'''
:Aktiviert den Watchdog und stellt den Vorteiler auf den gewünschten Wert ein bzw. der in timeout übergebene Wert wird in das WDTCR-Register eingetragen. Einige Timeout-Werte sind als Konstanten vordefiniert
:Mögliche Timeoutwerte:
<div align="center">
{| border="1"
! Konstante
! Wert
! TimeOut
|-
| WDTO_15MS
| 0
| 15 ms
|-
| WDTO_30MS
| 1
| 30 ms
|-
| WDTO_60MS
| 2
| 60 ms
|-
| WDTO_120MS
| 3
| 120 ms
|-
| WDTO_250MS
| 4
| 250 ms
|-
| WDTO_500MS
| 5
| 500 ms
|-
| WDTO_1S
| 6
| 1 S
|-
| WDTO_2S
| 7
| 2s
|}
</div>
* '''wdt_disable()'''
:Mit dieser Funktion kann der Watchdog ausgeschaltet werden. Dabei wird das notwendige Prozedere, wie oben beschrieben, automatisch ausgeführt.
* '''wdt_reset()'''
:Dies ist wohl die wichtigste der Watchdog-Funktionen. Sie erzeugt einen Watchdog-Reset, welcher periodisch, und zwar vor Ablauf der Timeoutzeit, ausgeführt werden muss, damit der Watchdog nicht den AVR zurücksetzt.

Selbstverständlich kann das '''WDTCR'''-Register auch mit den uns bereits bekannten Funktionen für den Zugriff auf Register programmiert werden.

== Watchdog-Anwendungshinweise ==

Ob nun der Watchdog als Schutzfunktion überhaupt verwendet werden soll, hängt stark von der Anwendung, der genutzten Peripherie und dem Umfang und der Qualitätssicherung des Codes ab. Will man sicher gehen, dass ein Programm sich nicht in einer Endlosschleife verfängt, ist der Wachdog das geeignete Mittel dies zu verhindern. Weiterhin kann bei geschickter Programmierung der Watchdog dazu genutzt werden, bestimmte Stromsparfunktionen zu implementieren. Ausserdem bietet der WD die einzige Möglichkeit einen beabsichtigten System-Reset (ein "richtiger Reset", kein "jmp 0x0000") ohne externe Beschaltung auszulösen, was z.B. bei der Implementierung eines Bootloaders nützlich ist. Bei bestimmten Anwendungen kann die Nutzung des WD als "ultimative Deadlock-Sicherung für nicht bedachte Zustände" natürlich immer als zusätzliche Sicherung dienen.

Es besteht die Möglichkeit herauszufinden, ob ein Reset durch den Watchdog ausgelöst wurde (beim ATmega16 z.B. Bit WDRF in MCUCSR). Diese Information sollte auch genutzt werden, falls ein WD-Reset in der Anwendung nicht planmässig implementiert wurde. Zum Beispiel kann man eine LED an einen freien Pin hängen, die nur bei einem Reset durch den WD aufleuchtet oder aber das "Ereignis WD-Reset" im internen EEPROM des AVR absichern, um die Information später z.B. über UART oder ein Display auszugeben (oder einfach den EEPROM-Inhalt über die ISP/JTAG-Schnittstelle auslesen).

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Watchdog timer handling

= 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.

[[Image:Interrupt Programme.gif]]

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.

[http://www.mikrocontroller.net/forum/read-1-235092.html#new Ausführlicher Thread im Forum]

== Anforderungen an Interrupt-Routinen ==

Um unliebsamen Überraschungen vorzubeugen, sollten einige Grundregeln bei der Implementierung der Interruptroutinen beachtet werden. Interruptroutinen soll 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.

== 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 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.

{| border="1"
|-
| '''GIMSK'''
| '''G'''eneral '''I'''nterrupt '''M'''ask '''R'''egister. 

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''INT1'''
| align="center" | '''INT0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''INT1''' (External '''Int'''errupt 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 '''Int'''errupt 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'''
| '''G'''eneral '''I'''nterrupt '''F'''lag '''R'''egister.

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''INTF1'''
| align="center" | '''INTF0'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''-'''
|-
| '''R/W'''
| align="center" | R/W
| align="center" | R/W
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''INTF1''' (External '''Int'''errupt Flag '''1''')
:Dieses Bit wird gesetzt, wenn am '''INT1'''-Pin eine Interrupt-Kondition, entsprechend der Konfiguration, 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 '''Int'''errupt Flag '''0''')
:Dieses Bit wird gesetzt, wenn am '''INT0'''-Pin eine Interrupt-Kondition, entsprechend der Konfiguration, 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''' '''C'''ontrol '''R'''egister.

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

{| border="1"
|-
| '''Bit'''
| align="center" | 7
| align="center" | 6
| align="center" | 5
| align="center" | 4
| align="center" | 3
| align="center" | 2
| align="center" | 1
| align="center" | 0
|-
| '''Name'''
| align="center" | '''-'''
| align="center" | '''-'''
| align="center" | '''SE'''
| align="center" | '''SM'''
| align="center" | '''ISC11'''
| align="center" | '''ISC10'''
| align="center" | '''ISC01'''
| align="center" | '''ISC00'''
|-
| '''R/W'''
| align="center" | R
| align="center" | R
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R/W
| align="center" | R
|-
| '''Initialwert'''
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
| align="center" | 0
|}

'''SE''' ('''S'''leep '''E'''nable)
: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''' ('''S'''leep '''M'''ode)
:Dieses Bit bestimmt der 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''' ('''I'''nterrupt '''S'''ense '''C'''ontrol '''1''' Bits)
:Diese beiden Bits bestimmen, ob die steigende oder die fallende Flanke für die Interrupterkennung am '''INT1'''-Pin ausgewertet wird.
<dl><dd>
{| border="1"
|-
| align="center" | '''ISC11'''
| align="center" | '''ISC10'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Low Level an '''INT1''' erzeugt einen Interrupt.

In der Beschreibung heisst es, der Interrupt wird getriggert, solange der Pin auf 0 bleibt, also eigentlich unbrauchbar.
|-
| align="center" | 0
| align="center" | 1
| Reserviert
|-
| align="center" | 1
| align="center" | 0
| Die fallende Flanke an '''INT1''' erzeugt einen Interrupt.
|-
| align="center" | 1
| align="center" | 1
| Die steigende Flanke an '''INT1''' erzeugt einen Interrupt.
|}
</dd></dl>
'''ISC01''', '''ISC00''' ('''I'''nterrupt '''S'''ense '''C'''ontrol '''0''' Bits)
:Diese beiden Bits bestimmen, ob die steigende oder die fallende Flanke für die Interrupterkennung am '''INT0'''-Pin ausgewertet wird.

<dl><dd>
{| border="1"
|-
| align="center" | '''ISC01'''
| align="center" | '''ISC00'''
| '''Bedeutung'''
|-
| align="center" | 0
| align="center" | 0
| Low Level an '''INT0''' erzeugt einen Interrupt.

In der Beschreibung heisst es, der Interrupt wird getriggert, solange der Pin auf 0 bleibt, also eigentlich unbrauchbar.
|-
| align="center" | 0
| align="center" | 1
| Reserviert
|-
| align="center" | 1
| align="center" | 0
| Die fallende Flanke an '''INT0''' erzeugt einen Interrupt.
|-
| align="center" | 1
| align="center" | 1
| Die steigende Flanke an '''INT0''' erzeugt einen Interrupt.
|}
</dd></dl>
|}

== 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, rate ich dringend davon ab. 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'').

<pre class="code">
// fuer sei(), cli() und ISR():
#include <avr/interrupt.h>

</pre>

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

<pre class="code">
sei();
</pre>

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

<pre class="code">
cli();
</pre>

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 Interrups aktivieren, was zu unerwünschten Seiteneffekten führen kann. Die aus dem folgenden Beispiel ersichtliche Vorgehensweise ist in solchen Fällen vorzuziehen:

<pre class="code">
#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!
...

}
</pre>



Nachdem nun die Interrupts aktiviert sind, braucht es selbstverständlich noch den auszuführenden Code, der ablaufen soll, wenn ein Interrupt eintrifft. Dazu existiert die Definition (ein Makro) '''ISR'''. SIGNAL sollte nicht mehr genutzt werden, zur Portierung von SIGNAL nach ISR siehe Abschnitt (TODO: verlinken) im Anhang.


=== ISR ===

(''ISR()'' ersetzt bei neueren Versionen der avr-libc ''SIGNAL()''. vgl. Anhang (TODO:link))



<pre class="code">
#include <avr/interrupt.h>
...
ISR(Vectorname) /* vormals: SIGNAL(siglabel) dabei Vectorname != siglabel ! */
{
/* Interrupt Code */
}
</pre>

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.

<pre class="code">
[...]
/* $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)

[...]
</pre>


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

<pre class="code">
#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...
</pre>

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 Interuptroutinen ===

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



<pre class="code">
#include <avr/interrupt.h>
...
void XXX_vect(void) __attribute__((interrupt));
void XXX_vect(void) {
...
}
</pre>

Hierbei steht XXX für den oben beschriebenen Namen des Vektors (also z.B. ''void TIMER0_OVF_vect(void)...''). Der Unterschied im Vergleich zu ISR ist, dass bei hier beim Aufrufen der Funktion das '''Global Enable Interrupt''' Bit automatisch wieder gesetzt und somit weitere Interrupts zugelassen werden. Dies kann zu nicht unerheblichen Problemen von im einfachsten Fall einem Stack overflow bis zu sonstigen unerwarteten Effekten führen und sollte wirklich '''nur dann''' angewendet werden, wenn man sich absolut sicher ist, das Ganze auch im Griff zu haben. 

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.

<pre class="code">
#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 uebrigen
// Programmteile muessen 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" */
}
}
...
}
</pre>

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 ausserhalb der ISR nicht durch einen Interrupt unterbrochen werden. (Allgemeinplatz: AVRs sind 8-bit Controller). Zur Veranschaulichung ein Codefragment:

<pre class="code">
...
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 veraendert.
tmpCnt = gMyCounter16bit;

// besser: Aenderungen "ausserhalb" verhindern -> alle "Teilbytes"
// bleiben konsistent
cli(); // Interupts 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 */
...
}
</pre>

== 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:

<pre class="code">
#include <avr/io.h>

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

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

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

<pre class="code">
...
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)
...
</pre>

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 Unterbrechnungen 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 Unterbrechnungen. 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 ausserhalb dieses Adressbereichs ("Memory-Mapped"-Register) werden auch zur Manipulation einzelner Bits abhängige Anweisungen erzeugt (lds,...,sts).

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Frequently asked Questions/Fragen Nr. 1 und 8 (Stand: avr-libc Vers. 1.0.4)

== 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 ausserdem möglicherweise Probleme durch Interruptroutinen, die zu viel Verarbeitungszeit benötigen.

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

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/Interrupts and Signals

= 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 [http://lightner.net/avr/ATtinyAvrGcc.html "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 und ATtiny26 der "tiny-Reihe" gelten die Ausführungen ebenfalls.

== 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.

== 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). 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.

<pre class="code">
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <inttypes.h>

...

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

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

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

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

void foo(void)
{
static /*const*/ uint8_t pgmTestByteLocal PROGMEM = 0x55;
static /*const*/ char pgmTestStringLocal[] PROGMEM = "im Flash";
...
</pre>

=== 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.

<pre class="code">
// 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....
}
</pre>

=== Wort lesen ===

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

<pre class="code">
uint16_t myWord;

myWord = pgm_read_word(&pgmFooWord);
</pre>

Zeiger auf Werte im Flash sind ebenfalls 16 Bits "gross" (Stand avr-gcc 3.4.x). Damit ist der mögliche Speicherbereich für "Flash-Konstanten" auf 64kB begrenzt. 

<pre class="code">
uint8_t *ptrToArray;

ptrToArray = (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 muß 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 = (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)
}
</pre>

=== Floats und Structs lesen ===

Um komplexe Datentypen (structs), nicht-integer Datentypen (floats) aus dem Flash auszulesen, sind Hilfsfunktionen erforderlich. Einige Beispiele:

<pre class="code">
/* Beispiel float aus Flash */

float pgmFloatArray[3] PROGMEM = {1.1, 2.2, 3.3};
...

/* liest float von Flash-Addresse addr und gibt diese als return-value zurueck */
inline float pgm_read_float(const float *addr)
{
union
{
uint16_t i[2]; // 2 16-bit-Worte
float f;
} u;

u.i[0]=pgm_read_word((PGM_P)addr);
u.i[1]=pgm_read_word((PGM_P)addr+2);

return u.f;
}
...

void egal(void)
{
int i;
float f;

for (i=0;i<3;i++) {
f = pgm_read_float(&pgmFloatArray[i]); // entspr. "f = pgmFloatArray[i];"
// mach' was mit f
}
}
</pre>

TODO: Beispiele fuer structs und pointer aus flash auf struct im flash (menues, state-machines etc.)

=== 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.

<pre class="code">
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <string.h>

#define MAXLEN 30

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

...
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 wuerde ausgefuehrt, die ersten 5 Zeichen stimmen ueberein
}
else {
// wuerde bei nicht-Uebereinstimmung ausgefuehrt
}
...
</pre>

Aber Vorsicht: Ersetzt man zum Beispiel
<pre class="code">
const char textImFlashOK[] PROGMEM = "mit[]";
// = Daten im "Flash", textImFlashOK* zeigt auf Flashadresse
</pre>
durch
<pre class="code">
const char* textImFlashProblem PROGMEM = "mit*";
// Konflikt: Daten im BSS (lies: RAM), textImFlashFAIL* zeigt auf Flashadresse
</pre>
dann kann es zu Problemen mit AVR-GCC kommen. Zu erkennen daran, dass der Initialisierungsstring von "textImFlashProblem" zu den Konstanten ans Ende des Programmcodes gelegt wird (BSS), von dem aus er zur Benutzung eigentlich ins RAM kopiert werden sollte (und wird). Da der lesende Code (mittels pgm_read*) trotzdem an einer Stelle vorne im Flash sucht, wird Unsinn gelesen. Dies scheint ein weiters Problem des AVR-GCC (gesehen bei avr-gcc 3.4.1 und 3.4.2) bei der Anpassung an die Harvard-Architektur zu sein (konstanter Pointer auf variable Daten?!). Abhilfe ("Workaround"): Initialisierung bei Zeichenketten mit [] oder gleich im Code PSTR("...") nutzen.

Übergibt man Zeichenketten (genauer: die Adresse des ersten Zeichens), die im Flash abglegt sind an eine Funktion, muss diese entsprechend programmiert sein. Die Funktion selbst hat keine Möglichkeit zu unterscheiden, ob es sich um eine Adresse im Flash oder im RAM 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 (oder _P) versehen sind.

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:

<pre class="code">
// 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 (wieauchimmmer.c)
#include <avr/io.h>
#include <avr/pgmspace.h>
#include <string.h>
#include "lcd.h"

char StringImFlash[] PROGMEM = "Erwin Lindemann"; // im "Flash"

...
lcd_puts_p(StringImFlash);
lcd_puts_P("Dr. Kloebner");
// daraus wird wg. #define lcd_put_P...: lcd_puts_p( PSTR("Dr. Kloebner") );
...
</pre>

=== Flash in der Anwendung schreiben ===

Bei AVRs mit "self-programming"-Option (auch bekannt als Bootloader-Support) können Teile des Flash-Speichers auch vom Anwendungsprogramm selbst beschrieben werden. Dies ist nur möglich, wenn die Schreibfunktionen in einem besonderen Speicherbereich (boot-section) des Programmspeichers/Flash abgelegt sind. Bei wenigen "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.

=== 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 (einen Pointer, z.B. 0x01fe), "weiss" die Funktion nicht, ob die Adresse auf den Flash-Speicher oder den/das RAM zeigt. Allein aus dem Pointer-Wert (der Zahl) kann nicht geschlossen werden, ob ein "einfaches" zeichen_an_uart(s[i]) oder zeichen_an_uart(pgm_read_byte(&s[i]) genutzt werden muss, um das i-te Zeichen auszugeben.

Einige AVR-Compiler "tricksen" etwas, in dem sie für einen Pointer nicht nur die Adresse anlegen, sondern zusätzlich zu jedem Pointer den Ablageort (Flash oder RAM) intern sichern. Bei Aufruf einer Funktion wird dann bei Pointer-Parametern neben der Adresse auch der Speicherbereich, auf den der Pointer zeigt, übergeben. Dies hat jedoch nicht nur Vorteile; Erläuterungen warum dies so ist, führen an dieser Stelle zu weit.

* siehe auch: [http://www.nongnu.org/avr-libc/user-manual/index.html 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ässig 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.

Der Compiler schreibt den aus der Variablendeklaration abgeleiteten EEPROM Inhalt in die eine Datei (.eep), die zusätzlich zum Flashen des Programms in den Mikrocontroller geschrieben werden muß. Sonst wird beim Lesen zufälliger Datenmüll zurückgegeben.

Bei der Deklaration einer Variable im EEPROM, ist das Attribut für die Section ".eeprom" zu ergänzen. 

<pre class="code">
#include <avr/io.h>
#include <avr/eeprom.h>
#include <avr/interrupt.h>
#include <inttypes.h> // wird in aktuellen Versionen der avr-lib mit xx.h eingebunden

// EEMEM wird bei aktuellen Versionen der avr-lib in eerpom.h definiert
// hier: definiere falls noch nicht bekannt ("alte" avr-libc)
#ifndef EEMEM
// alle Textstellen EEMEM im Quellcode durch __attribute__ ... ersetzen
#define EEMEM __attribute__ ((section (".eeprom")))
#endif

...

/* Byte */
uint8_t eeFooByte EEMEM = 123;

/* Wort */
uint16_t eeFooWord EEMEM = 12345;

/* float */
float eeFooFloat EEMEM;

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

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

=== Bytes lesen/schreiben ===

Die avr-libc Funktion zum Lesen eines Bytes heisst 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:

<pre class="code">
...
uint8_t myByte;

myByte = eeprom_read_byte(&eeFooByte); // lesen
// myByte hat nun den Wert 123
...
myByte = 99;
eeprom_write_byte(&eeFooByte, myByte); // schreiben
...
myByte = eeprom_read_byte(&eeFooByteArray1[1]);
// myByte hat nun den Wert 3
...
</pre>

=== Wort lesen/schreiben ===

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

<pre class="code">
...
uint16_t myWord;

myWord = eeprom_read_word(&eeFooWord); // lesen
// myWord hat nun den Wert 12345
...
myWord = 2222;
eeprom_write_word(&eeFooWord, myWord); // schreiben
...
</pre>

=== 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 (size_t).

TODO: '''Vorsicht!''' die folgenden Beispiele sind noch nicht geprueft, erstmal nur als Hinweis auf "das Prinzip". Evtl. fehlen "casts" und mglw. noch mehr.

<pre class="code">
...
uint8_t myByteBuffer[3];
uint16_t myWordBuffer[4];

/* Datenblock aus EEPROM LESEN */

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

/* dito etwas anschaulicher aber "unnuetze Tipparbeit": */
eeprom_read_block(&myByteBuffer[0],&eeFooByteArray[0],3);

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

/* und nun mit "16bit" */
eeprom_read_block(myWordBuffer,eeFooWordArray1,sizeof(myWordBuffer));

/* Datenlock in EEPROM SCHREIBEN */
eeprom_write_block(myByteBuffer,eeFooByteArray1,sizeof(myByteBuffer));
eeprom_write_block(myWordBuffer,eeFooWordArray1,sizeof(myWordBuffer));
...
</pre>

"Nicht-Integer"-Datentypen wie z.B. Fliesskommazahlen lassen sich recht praktisch über eine ''union'' in "Byte-Arrays" konvertieren und wieder "zurückwandeln". Dies erweist sich hier (aber nicht nur hier) als nützlich.

<pre class="code">
...
float myFloat = 12.34;

union {
float r;
uint8_t i[sizeof(float)];
} u;

u.r = myFloat;

/* float in EEPROM */
eeprom_write_block(&(u.i),&eeFooFloat,sizeof(float));

/* float aus EEPROM */
eeprom_read_block(&(u.i),&eeFooFloat,sizeof(float));
/* u.r wieder 12.34 */
...
</pre>

Auch zusammengesetzte Typen lassen sich mit den Block-Routinen verarbeiten.

<pre class="code">
...
typedef struct {
uint8_t label[8];
uint8_t rom_code[8];
} tMyStruct;

#define MAXSENSORS 3
tMyStruct eeMyStruct[MAXSENSORS] EEMEM;

...

void egal(void)
{
tMyStruct work;

strcpy(work.label,"Flur");
GetRomCode(work.rom_code); // Dummy zur Veranschaulichung - setzt rom-code

/* Sichern von "work" im EEPROM */
eeprom_write_block(&work,&eeMyStruct[0],sizeof(tMyStruct)); // f. Index 0
strcpy(work.label,"Bad");
GetRomCode(work.rom_code);
eeprom_write_block(&work,&eeMyStruct[1],sizeof(tMyStruct)); // f. Index 1
...
/* Lesen der Daten EEPROM Index 0 in "work" */
eeprom_read_block(&work,&eeMyStruct[0],sizeof(tMyStruct));
// work.label hat nun den Inhalt "Flur"
...
}
...
</pre>

=== EEPROM-Speicherabbild in .eep-Datei ===

Eine besondere Funktion des avr-gcc ist, dass mit entsprechenden Optionen im Makefile aus den Initialisierungswerten der Variablen im Quellcode eine Datei erzeugt werden kann, die man auf den Controller programmieren kann (.eep-Datei). Damit können sehr elegant Standardwerte für den EEPROM-Inhalt im Quellcode definiert werden. Die Vorgehensweise wird aus dem WinAVR-Beispielmakefile ersichtlich. Siehe dazu die Erläuterungen im Abschnitt Exkurs: Makefiles.

=== Bekannte Probleme bei den EEPROM-Funktionen ===

Vorsicht: Bei alten Versionen der avr-libc wurden nicht alle AVR Controller untersü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: [http://www.nongnu.org/avr-libc/user-manual/index.html Dokumentation der avr-libc] Abschnitt Modules/EEPROM handling

= Die Nutzung von printf =

Um komfortabel Ausgaben auf ein Display oder die serielle Schnittstelle zu tätigen, bietet sich printf/sprintf an.
<pre class="code">
...
#include <stdio.h>
#include <stdint.h>

uint16_t counter;
uint8_t s[20];
...
sprintf( s, "Zählerstand: %d", counter);
LCDSoftText( s, x, y);
...
</pre>

Die Funktion LCDSoftText muss natürlich dafür sorgen, dass die Zeichenkette auf das Display kommt.

Eine weitere elegante Möglichkeit, bietet sich darin, die Ausgabe stdout auf eigene Funktionen umzubiegen:
<pre class="code">
#include <stdio.h>
static int uart_putchar(char c, FILE *stream);
static FILE mystdout = FDEV_SETUP_STREAM(uart_putchar, NULL,
_FDEV_SETUP_WRITE);
static int
uart_putchar(char c, FILE *stream)
{
if (c == ?\n?)
uart_putchar(?\r?);
loop_until_bit_is_set(UCSRA, UDRE);
UDR = c;
return 0;
}

int
main(void)
{
init_uart();
stdout = &mystdout;
printf("Hello, world!\n");
return 0;
}
</pre>
(Quelle: avr-libc-user-manual-1.4.3.pdf, S.74)

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

Der Nachteil aller printf-Varianten: sie sind recht speicherintensiv.

= Assembler und Inline-Assembler =

Gelegentlich erweist es sich als nützlich, C und Assembler-Code in einer Anwendung zu nutzen. Typischerweise wird das Hauptprogramm in C verfasst und wenige, extrem zeitkritische oder hardwarenahe Operationen in Assembler.

Die "gnu-Toolchain" bietet dazu zwei Möglichkeiten:

; Inline-Assembler : Die Assembleranweisungen werden direkt in den C-Code integriert. Eine Quellcode-Datei enthält somit C- und Assembleranweisungen

; Assembler-Dateien : Der Assembler-Codecode befindet sich in eigenen Quellcodedateien. Diese werden vom gnu-Assembler (avr-as) zu Object-Dateien assembliert ("compiliert") und mit den aus dem C-Code erstellten Object-Dateien zusammengebunden (gelinkt).

== Inline-Assembler ==

Inline-Assembler bietet sich an, wenn nur wenig Assembleranweisungen benötigt werden. Typische Anwendung sind kurze Codesequenzen für zeitkritische Operationen in Interrupt-Routinen oder sehr präzise Warteschleifen (z.B. 1-Wire). Inline-Assembler wird mit '''asm volatile''' eingeleitet, die Assembler-Anweisungen werden in einer Zeichenkette zusammengefasst, die als "Parameter" übergeben wird. Durch Doppelpunkte getrennt werden die Ein- und Ausgaben sowie die "Clobber-Liste" angegeben.

Ein einfaches Beispiel für Inline-Assembler ist das Einfügen einer NOP-Anweisung (NOP steht für No Operation). Dieser Assembler-Befehl benötigt genau einen Taktzyklus, ansonsten "tut sich nichts". Sinnvolle Anwendungen für NOP sind genaue Delay(=Warte)-Funktionen.

<pre class="code">
...
/* Verzoegern der weiteren Programmausfuehrung um
genau 3 Taktzyklen */
asm volatile ("nop");
asm volatile ("nop");
asm volatile ("nop");
...
</pre>

Weiterhin kann mit einem NOP verhindert werden, dass leere Schleifen, die als Warteschleifen gedacht sind, wegoptimiert werden. Der Compiler erkennt ansonsten die vermeindlich nutzlose Schleife und erzeugt dafür keinen Code im ausführbaren Programm.

<pre class="code">
...
uint16_t i;

/* leere Schleife - wird bei eingeschalteter Compiler-Optimierung wegoptimiert */
for (i=0;i<1000;i++);

...

/* Schleife erzwingen (keine Optimierung): "NOP-Methode" */
for (i=0;i<1000;i++) asm volatile("NOP");

...

/* alternative Methode (keine Optimierung): */
volatile uint16_t j;
for (j=0;j<1000;j++);
</pre>

Ein weiterer nützlicher "Assembler-Einzeiler" ist der Aufruf von sleep (''asm volatile ("sleep");''), da hierzu keine eigene Funktion in der avr-libc existiert.

Als Beispiel für mehrzeiligen Inline-Assembler eine präzise Delay-Funktion. Die Funktion erhält ein 16-bit Wort als Parameter, prüft den Parameter auf 0 und beendet die Funktion in diesem Fall oder durchläuft die folgende Schleife sooft wie im Wert des Parameters angegeben. Inline-Assembler hat hier den Vorteil, dass die Laufzeit unabhängig von der Optimierungsstufe (Parameter -O, vgl. makefile) und der Compiler-Version ist.

<pre class="code">
static inline void delayloop16 (uint16_t count)
{
asm volatile ("cp %A0, __zero_reg__ \n\t"
"cpc %B0, __zero_reg__ \n\t"
"breq 2f \n\t"
"1: \n\t"
"sbiw %0,1 \n\t"
"brne 1b \n\t"
"2: "
: "=w" (count)
: "0" (count)
);
}
</pre>

* Jede Anweisung wird mit '''\n\t''' abgeschlossen. Der Zeilenumbruch teilt dem Assembler mit, daß ein neuer Befehl beginnt.
* Als Sprung-Marken (Labels) werden Ziffern verwendet. Diese speziellen Labels sind mehrfach im Code verwendbar. Gesprungen wird jeweils zurück (b) oder vorwärts (f) zum nächsten ausffindbaren Label.

Das Resultat zeigt ein Blick in die Assembler-Datei, die der Compiler mit der option <tt>-save-temps</tt> nicht löscht:
<pre class="code">
cp r24, __zero_reg__ ; count
cpc r25, __zero_reg__ ; count
breq 2f
1:
sbiw r24,1 ; count
brne 1b
2:
</pre>

Detaillierte Ausführungen zum Thema Inline-Assembler finden sich in der Dokumentation der avr-libc im Abschnitt [http://www.nongnu.org/avr-libc/user-manual/inline_asm.html Related Pages/Inline Asm].

Siehe auch:
*[http://www.atmel.com/dyn/resources/prod_documents/doc0856.pdf AVR Assembler-Anweisungsliste]
*[http://www.roboternetz.de/wissen/index.php/Inline-Assembler_in_avr-gcc Deutsche Einführung in Inline-Assembler]

== Assembler-Dateien ==

Assembler-Dateien erhalten die Endung .S (''grosses'' S) und werden im makefile nach WinAVR/mfile-Vorlage hinter ''ASRC='' durch Leerzeichen getrennt aufgelistet.

Im Beispiel eine Funktion ''superFunc'' die alle Pins des Ports D auf "Ausgang" schaltet, eine Funktion ''ultraFunc'', die die Ausgänge entsprechend des übergebenen Parameters schaltet, eine Funktion ''gigaFunc'', die den Status von Port A zurückgibt und eine Funktion ''addFunc'', die zwei Bytes zu einem 16-bit-Wort addiert. Die Zuweisungen im C-Code (PORTx = ) verhindern, dass der Compiler die Aufrufe wegoptimiert und dienen nur zur Veranschaulichung der Parameterübergaben.

Zuerst der Assembler-Code. Der Dateiname sei useful.S:

<pre class="code">
#include "avr/io.h"

// Arbeitsregister (ohne "r")
workreg = 16
workreg2 = 17

// Konstante:
ALLOUT = 0xff

// ** Setze alle Pins von PortD auf Ausgang **
// keine Parameter, keine Rueckgabe
.global superFunc
.func superFunc
superFunc:
push workreg
ldi workreg, ALLOUT
out _SFR_IO_ADDR(DDRD), workreg // beachte: _SFR_IO_ADDR()
pop workreg
ret
.endfunc

// ** Setze PORTD auf uebergebenen Wert **
// Parameter in r24 (LSB immer bei "graden" Nummern)
.global ultraFunc
.func ultraFunc
ultraFunc:
out _SFR_IO_ADDR(PORTD), 24
ret
.endfunc

// ** Zustand von PINA zurueckgeben **
// Rueckgabewerte in r24:r25 (LSB:MSB), hier nur LSB genutzt
.global gigaFunc
.func gigaFunc
gigaFunc:
in 24, _SFR_IO_ADDR(PINA)
ret
.endfunc

// ** Zwei Bytes addieren und 16-bit-Wort zurueckgeben **
// Parameter in r24 (Summand1) und r22 (Summand2) -
// Parameter sind Word-"aligned" d.h. LSB immer auf "graden"
// Registernummern. Bei 8-Bit und 16-Bit Paramtern somit
// beginnend bei r24 dann r22 dann r20 etc.
// Rueckgabewert in r24:r25
.global addFunc
.func addFunc
addFunc:
push workreg
push workreg2
clr workreg2
mov workreg, 22
add workreg, 24
adc workreg2, 1 // r1 - assumed to be always zero ...
movw r24, workreg
pop workreg2
pop workreg
ret
.endfunc

// oh je - sorry - Mein AVR-Assembler ist eingerostet, hoffe das stimmt so...

.end

</pre>

Im Makefile ist der Name der Assembler-Quellcodedatei einzutragen:

<pre class="code">
ASRC = useful.S
</pre>

Der Aufruf erfolgt dann im C-Code so:

<pre class="code">
extern void superFunc(void);
extern void ultraFunc(uint8_t setVal);
extern uint8_t gigaFunc(void);
extern uint16_t addFunc(uint8_t w1, uint8_t w2);

int main(void)
{
[...]
superFunc();

ultraFunc(0x55);

PORTD = gigaFunc();

PORTA = (addFunc(0xF0, 0x11) & 0xff);
PORTB = (addFunc(0xF0, 0x11) >> 8);
[...]
}
</pre>

Das Ergebnis wird wieder in der lss-Datei ersichtlich:

<pre class="code">
[...]
superFunc();
148: 0e 94 f6 00 call 0x1ec

ultraFunc(0x55);
14c: 85 e5 ldi r24, 0x55 ; 85
14e: 0e 94 fb 00 call 0x1f6

PORTD = gigaFunc();
152: 0e 94 fd 00 call 0x1fa
156: 82 bb out 0x12, r24 ; 18

PORTA = (addFunc(0xF0, 0x11) & 0xff);
158: 61 e1 ldi r22, 0x11 ; 17
15a: 80 ef ldi r24, 0xF0 ; 240
15c: 0e 94 ff 00 call 0x1fe
160: 8b bb out 0x1b, r24 ; 27
PORTB = (addFunc(0xF0, 0x11) >> 8);
162: 61 e1 ldi r22, 0x11 ; 17
164: 80 ef ldi r24, 0xF0 ; 240
166: 0e 94 fc 00 call 0x1f8
16a: 89 2f mov r24, r25
16c: 99 27 eor r25, r25
16e: 88 bb out 0x18, r24 ; 24

[...]
000001ec <superFunc>:
// setze alle Pins von PortD auf Ausgang
.global superFunc
.func superFunc
superFunc:
push workreg
1ec: 0f 93 push r16
ldi workreg, ALLOUT
1ee: 0f ef ldi r16, 0xFF ; 255
out _SFR_IO_ADDR(DDRD), workreg
1f0: 01 bb out 0x11, r16 ; 17
pop workreg
1f2: 0f 91 pop r16
ret
1f4: 08 95 ret

000001f6 <ultraFunc>:
.endfunc

// setze PORTD auf uebergebenen Wert
.global ultraFunc
.func ultraFunc
ultraFunc:
out _SFR_IO_ADDR(PORTD), 24
1f6: 82 bb out 0x12, r24 ; 18
ret
1f8: 08 95 ret

000001fa <gigaFunc>:
.endfunc

// Zustand von PINA zurueckgeben
.global gigaFunc
.func gigaFunc
gigaFunc:
in 24, _SFR_IO_ADDR(PINA)
1fa: 89 b3 in r24, 0x19 ; 25
ret
1fc: 08 95 ret

000001fe <addFunc>:
.endfunc

// zwei Bytes addieren und 16-bit-Wort zurueckgeben
.global addFunc
.func addFunc
addFunc:
push workreg
1fe: 0f 93 push r16
push workreg2
200: 1f 93 push r17
clr workreg2
202: 11 27 eor r17, r17
mov workreg, 22
204: 06 2f mov r16, r22
add workreg, 24
206: 08 0f add r16, r24
adc workreg2, 1 // r1 - assumed to be always zero ...
208: 11 1d adc r17, r1
movw r24, workreg
20a: c8 01 movw r24, r16
pop workreg2
20c: 1f 91 pop r17
pop workreg
20e: 0f 91 pop r16
ret
210: 08 95 ret

[...]
</pre>

Die Zuweisung von Registern zu Parameternummer und die Register für die Rückgabewerte sind in den "Register Usage Guidelines" der avr-libc-Dokumentation erläutert.

Siehe auch:
* [http://www.nongnu.org/avr-libc/user-manual/assembler.html avr-libc-Dokumentation: Related Pages/avr-libc and assembler programs]
* [http://www.nongnu.org/avr-libc/user-manual/FAQ.html#faq_reg_usage avr-libc-Dokumentation: Related Pages/FAQ/"What registers are used by the C compiler?"]

== Globale Variablen für Datenaustausch ==

Oftmals kommt man um globale Variablen nicht herum, z.B. um den Datenaustausch zwischen Hauptprogramm und Interrupt-Routinen zu realisieren.
Hierzu muß man im Assembler wissen, wo genau die Variable vom C-Compiler abgespeichert wird.

Hierzu muß die Variable, hier "zaehler" genannt, zuerst im C-Code als Global definiert werden, z.B. so:

<pre class = "code">

#include <avr/io.h>

volatile uint8_t zaehler;

int16_t main (void)
{
// irgendein Code, in dem zaehler benutzt werden kann

}
</pre>

Im foldenden Assembler-Beispiel wird der Externe Interrupt0 verwendet, um den Zähler hochzuzählen. Es fehlen die Initialisierungen des Interrupts und die Interrupt-Freigabe, so richtig sinnvoll ist der Code auch nicht, aber er zeigt (hoffentlich) wie es geht.
Im Umgang mit Interrupt-Vektoren gilt beim GCC-Assembler das Gleiche, wie bei C: Man muß die exakte Schreibweise beachten, ansonsten wird nicht der Interrupt-Vektor angelegt, sondern eine neue Funktion - und man wundert sich, daß nichts funktionert (vgl. das AVR-GCC Handbuch).

<pre class = "code">

#include "avr/io.h"

temp = 16

.extern zaehler

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

push temp // wichtig: Benutzte Register und das
in temp,_SFR_IO_ADDR(SREG) // Status-Register (SREG) sichern !
push temp

lds temp,zaehler // Wert aus dem Speicher lesen
inc temp // bearbeiten
sts zaehler,temp // und wieder zurückschreiben

pop temp // die benutzten Register wiederherstellen
out _SFR_IO_ADDR(SREG),temp
pop temp
reti

.end

</pre>

=== Globale Variablen im Assemblerfile anlegen ===

Alternativ können Variablen aber auch im Assemblerfile angelegt werden. Dadurch kann auf eine .c-Datei verzichtet werden. Für das obige Beispiel könnte der Quelltext dann die Dateien zaehl_asm.S und zaehl_asm.h abgelegt werden, so dass nur noch zaehl_asm.S mit kompiliert werden müsste.

Anstatt im Assemblerfile über das Schlüsselwort ''.extern '' auf eine vorhandene Variable zu verweisen, wird dazu mit dem Schlüsselwort ''.comm'' die benötigte Anzahl von Bytes für eine Variable reserviert.

'''zaehl_asm.S'''
<pre class = "code">

#include "avr/io.h"

temp = 16

// 1 Byte im RAM für den Zähler reservieren
.comm zaehler, 1

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

...

</pre>

In der Headerdatei wird dann auf die Variable nur noch verwiesen (Schlüsselwort ''extern''):

'''zaehl_asm.h'''
<pre class = "code">
#ifndef ZAEHL_ASM_H
#define ZAEHL_ASM_H

extern volatile uint8_t zaehler;

#endif
</pre>

Im Gegensatz zu globalen Variablen in C werden so angelegte Variablen nicht automatisch mit dem Wert 0 initialisiert.

=== Variablen größer als 1 Byte ===

Variablen, die größer als ein Byte sind, können in Assembler auf ähnliche Art angesprochen werden. Hierzu müssen nur genug Bytes angefordert werden, um die Variable aufzunehmen. Soll z.B. für den Zähler eine Variable vom Typ ''unsigned long'', also ''uint32_t'' verwendet werden, so müssen 4 Bytes reserviert werden:

<pre class = "code">
...
// 4 Byte im RAM für den Zähler reservieren
.comm zaehler, 4
...
</pre>

Die dazugehörige Deklaration im Headerfile wäre dann:
<pre class = "code">
...
extern volatile uint32_t zaehler;
...
</pre>

Bei Variablen, die größer als ein Byte sind, werden die Werte beginnend mit dem niederwertigsten Byte im RAM abgelegt. Das folgende Codeschnippsel zeigt, wie unter Assembler auf die einzelnen Bytes zugegriffen werden kann. Dazu wird im Interrupt nun ein 32-Bit Zähler erhöht:
<pre class = "code">
#include "avr/io.h"

temp = 16

// 4 Byte im RAM für den Zähler reservieren
.comm zaehler, 4

.global SIG_INTERRUPT0
SIG_INTERRUPT0:

push temp // wichtig: Benutzte Register und das
in temp,_SFR_IO_ADDR(SREG) // Status-Register (SREG) sichern !
push temp

// 32-Bit-Zähler incrementieren
lds temp, (zaehler + 0) // 0. Byte (niederwertigstes Byte)
inc temp
sts (zaehler + 0), temp
brne RAUS

lds temp, (zaehler + 1) // 1. Byte
inc temp
sts (zaehler + 1), temp
brne RAUS

lds temp, (zaehler + 2) // 2. Byte
inc temp
sts (zaehler + 2), temp
brne RAUS

lds temp, (zaehler + 3) // 3. Byte (höchstwertigstes Byte)
inc temp
sts (zaehler + 3), temp
brne RAUS

RAUS:
pop temp // die benutzten Register wiederherstellen
out _SFR_IO_ADDR(SREG),temp
pop temp
reti

.end

</pre>

'''TODO:''' 16-Bit / 32-Bit Variablen, Zugriff auf Arrays (Strings)

= Anhang =

== Besonderheiten bei der Anpassung bestehenden Quellcodes ==

Einige Funktionen, die in frühren Versionen der avr-libc vorhanden waren, werden inzwischen als veraltet angesehen. Sie sind nicht mehr vorhanden oder als ''deprecated'' (abgelehnt) ausgewiesen. Es empfiehlt sich, vorhandenen Code zu portieren und die alten Funktionen nicht mehr zu nutzen, auch wenn diese noch zur Verfügung stehen.

=== Veraltete Funktionen zur Deklaration von Interrupt-Routinen ===

Die Funktionen (eigentlich Makros) ''SIGNAL'' und ''INTERRUPT'' zur Deklaration von Interruptroutinen sollten nicht mehr genutzt werden.

In aktuellen Versionen der avr-libc (z.B. avr-libc 1.4.3 aus WinAVR 20060125) werden Interruptroutinen, die '''nicht''' durch andere Interrupts '''unterbrechbar''' sind, mit ISR deklariert (siehe Abschnitt im Hauptteil). Auch die Benennung wurden vereinheitlicht und an die üblichen Bezeichnungen in den AVR Datenblättern angepasst. In der Dokumentation der avr-libc sind alte und neue Bezeichnungen in der Tabelle gegenübergestellt. Die erforderlichen Schritte zur Portierung:

* #include von avr/signal.h entfernen
* SIGNAL duch ISR ersetzen
* Name des Interrupt-Vektors anpassen (SIG_* durch entsprechendes *_vect)

Ein Beispiel für die Anpassung zuerst ein "alter" Code:

<pre class="code">
#include <avr/interrupt.h>
#include <avr/signal.h>

...

/* Timer2 Output Compare bei einem ATmega8 */
SIGNAL(SIG_OUTPUT_COMPARE2)
{
...
}
</pre>

Im Datenblatt wird der Vektor mit TIMER2 COMP bezeichnet. Die Bezeichnung in der avr-libc entspricht dem Namen im Datenblatt, Leerzeichen werden durch Unterstriche (_) ersetzt und ein _vect angehängt.

Der neue Code sieht dann so aus:

<pre class="code">
#include <avr/interrupt.h>
/* signal.h entfällt */

ISR(TIMER2_COMP_vect)
{
...
}
</pre>

Bei Unklarheiten bezüglich der neuen Vektorlabels hilft (noch) ein Blick in die Headerdatei des entspechenden Controllers. Für das vorherige Beispiel also der Blick in die Datei iom8.h für den ATmega8, dort findet man die veraltete Bezeichnung unterhalb der aktuellen.

<pre class="code">
...
/* Timer/Counter2 Compare Match */
#define TIMER2_COMP_vect _VECTOR(3)
#define SIG_OUTPUT_COMPARE2 _VECTOR(3)
...
</pre>

Konnte in alten Versionen signal.h ohne interrupt.h eingebunden werden, erhält man bei Verwendung der avr-libc Version 1.4.3 (WinAVR 2/2005) beim Compilieren eine Fehlermeldung, da mit signal.h nicht die erforderlichen Definitionen eingebunden werden. Der Lösungsvorschlag in signal.h auch interrupt.h einzubinden, wurde von den avr-libc-Enwicklern akzeptiert und das Problem ist im Quellcode (CVS) bereits behoben. Es is aber noch keine avr-libc-"Release" bzw. noch kein WinAVR mit dieser avr-libc-Korrektur verfuegbar (Stand 5.2.2006). Will oder kann man den Quellcode nicht aktualisieren, gibt es folgende Alternativen:
* in Quellcodedateien, in denen nur avr/signal.h eingebunden wird, interrupt.h einbinden (''#include <avr/interrupt.h>''). signal.h weiterhin einbinden, falls Kompatibiltät mit alten Versionen gewünscht ist.
* in der Datei signal.h (bein WinAVR in c:/WinAVR/avr/include/avr/signal.h) ein (''#include <avr/interrupt.h>'') ergänzen

Für '''unterbrechbare''' Interruptroutinen, die mittels ''INTERRUPT'' deklariert sind, gibt es keinen direkten Ersatz in Form eines Makros. Die Routinen sind lt. Dokumentation der avr-libc in folgender Form zu Deklarieren unterbrechbarer Interrupt-Handler:

<pre class="code">
void XXX_vect(void) __attribute__((interrupt));
void XXX_vect(void) {
...
}
</pre>

Beispiel:

<pre class="code">
#include <avr/interrupt.h>

// alt:
INTERRUPT(SIG_OVERFLOW0)
{
...
}

// neu:
void TIMER0_OVF_vect(void) __attribute__((interrupt));
void TIMER0_OVF_vect(void)
{
...
}
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von ''INTERRUPT'' die Header-Datei ''compat/deprecated.h'' einzubinden. Man sollte bei dieser Gelegenheit jedoch nochmals überprüfen, ob die Funktionalität von ''INTERRUPT'' tatsächlich gewollt ist. In vielen Fällen wurde ''INTTERRUPT'' dort genutzt, wo eigentlich ''SIGNAL'' (nunmehr ''ISR'') hätte genutzt werden sollen.

=== Veraltete Funktionen zum Portzugriff ===

''inp'' und ''outp'' zum Einlesen bzw. Schreiben von Registern sind nicht mehr erforderlich, der Compiler unterstützt dies ohne diesen Umweg.

<pre class="code">
unsigned char i, j;

// alt:
i = inp(PINA);
j = 0xff;
outp(PORTB, j);

// neu (nicht mehr wirklich neu...):
i = PINA
j = 0xff;
PORTB = j;
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von inp und outp die Header-Datei '''compat/deprecated.h''' einzubinden.

=== Veraltete Funktionen zum Zugriff auf Bits in Registern ===

''cbi'' und ''sbi'' zum Löschen und Setzen von Bits sind nicht mehr erforderlich, der Compiler unterstützt dies ohne diesen Umweg. Die Bezeichnung ist ohnehin irreführend da die Funktionen nur für Register mit Adressen im unteren Speicherbereich tatsächlich in die Assembleranweisungen cbi und sbi übersetzt werden.

<pre class="code">
// alt:
sbi(PORTB, PB2);
cbi(PORTC, PC1);

// neu (auch nicht mehr wirklich neu...):
PORTB |= (1<<PB2);
PORTC &= ~(1<<PC1);
</pre>

Will oder kann man den Code nicht portieren, ist zur weiteren Verwendung von sbi und cbi die Header-Datei '''compat/deprecated.h''' einzubinden. Wer unbedingt will, kann sich natürlich eigene Makros mit aussagekräftigeren Namen definieren. Zum Beispiel:

<pre class="code">
#define SET_BIT(PORT, BITNUM) ((PORT) |= (1<<(BITNUM)))
#define CLEAR_BIT(PORT, BITNUM) ((PORT) &= ~(1<<(BITNUM)))
#define TOOGLE_BIT(PORT, BITNUM) ((PORT) ^= (1<<(BITNUM)))
</pre>

== Externe Referenzspannung des internen Analog-Digital-Wandlers ==

Die minimale (externe) Referenzspannung des ADC darf nicht beliebig niedrig sein, vlg. dazu das (aktuellste) Datenblatt des verwendeten Controllers. z.B. beim ATMEGA8 darf sie lt. 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.)

= TODO =
* fuse-bits im make file
* Assembler-Dateien/Datenaustausch auf neue Vectornamen anpassen SIG_->_vect
* stdio.h, malloc() ???
* Code-Optimierungen ("tricks")
* "naked"-Functionen ??
* IO-Register als Parameter/"Variablen" (volatile uint8_t *mybusport; mybusport=&PORTB; void sendbus(uint8_t *parm)...)
* JTAG?
* SPI ?
* I²C Bus
* LC-Display ansteuern
* Software USB
* Bootloader