Mikrocontroller.net - Benutzerbeiträge [de]

DTMF

2009-10-06T16:06:47Z

Frajo:

Abkürzung für '''D'''ual '''T'''one '''M'''ulti-'''F'''requency

Wird z.B. beim Telefon verwendet. Jeder Zahl ist ein Doppelton (zwei miteinander vermischte Frequenzen) zugeordnet (8 Frequenzen in einer 4 * 4 Matrix, also 16 mögliche Kodierungen). Die Frequenzen sind so gewählt, dass sie im normalen Sprachspektrum möglichst nicht auftauchen können, da im Telefoniebereich eine ''in-band'' Signalisierung damit vorgenommen werden soll (d.h. diese Signale sollen sich eindeutig vom Nutzsignal unterscheiden können).

Es gibt spezielle Schaltkreise für Erzeugung und Erkennung (M8870) von DTMF, die sich einfach an Mikrocontroller ankoppeln lassen. Die Erkennung benötigt irgendeine Form von Filter, entweder analog (ziemlich aufwendig) oder digital ([[FFT]] o.ä.), so dass eine direkte Erkennung mit einem Controller selten benutzt wird. Die Erzeugung von DTMF ist geringfügig einfacher und könnte z.B. über Sinustabellen erfolgen.

DTMF wird gern als Lehrbeispiel für die Verwendung des [[Goertzel-Algorithmus]] benutzt, ein kleines IIR-Filter zur Tondecodierung.

[[Kategorie:Datenübertragung]]

Port-Expander PCF8574

2008-04-30T13:33:29Z

Frajo: /* I2C Kommunikation */

''Autor: Alexander Starke''

=Einleitung=

Einen weiteren nützlichen Baustein am [[I2C]]-Bus stellen Port-Expander dar. Wer schon einmal unter "chronischem Pinmangel" in einer seiner Applikationen gelitten hat, weiss was ich meine.

Meine Wahl ist hier auf den PCF8574 gefallen, einen 8-Bit I/O Expander. Auch in diesem Abschnitt gilt analog zu den anderen über I2C-Bausteine: Falls ihr noch nie etwas mit dem I2C gemacht habt, dann lest euch bitte zuerst die entsprechende Rubrik durch. Danach wird das Verstehen wesentlich einfacher fallen.

=Funktion=

Die Funktionsweise ist schnell beschrieben: Ein seriell an den Baustein gesendeter Wert wird auf dessen Pins parallel ausgegeben. Es gibt drei Adresspins (A0:2), an welchen man die Adresse in Hardware einstellen kann (Pins jeweils auf Masse bzw. Vcc legen). Es können also maximal 2^3 = 8 Bausteine direkt am Bus betrieben werden. Will man mehr ICs anschliessen ist ein I2C-Multiplexer notwendig (z.B. PCA9544A).

http://www.mikrocontroller.net/mc-project/Pages/Projekte/ICs/Port%20Expander/expander-pins.gif

An den Pins P0:7 kann ein 8 Bit Wert ausgegeben bzw. eingelesen werden. SDA und SCL dienen der Kommunikation über den I²C-Bus. /INT dient dazu, eingehende Daten an den Pins des Bausteins zu signalisieren. Man kann diesen Pin direkt an einen der Pins (externe Interrupts: INT0, INT1) des Mikrocontrollers legen. Da der Expander mit einem Open-Drain Ausgang daher kommt, muss ein Pull-Up gegen Betriebsspannung geschaltet werden. So kann der PCF8574 dem Mikrocontrollers ohne den Umweg über den I2C übermitteln, dass sich die Eingangssignale geändert haben. Man kann ihn natürlich auch einfach offen lassen. Die Pins P0:7 können bis zu 25mA aufnehmen, aber nur gegen GND! Denn es handelt sich um [[Ausgangsstufen Logik-ICs|Open Collektor Ausgänge]]. Ausgeben können die IOs nur ca. 100µA über den interen Pull-Up Widerstand (welcher genaugenommen eine [[Konstantstromquelle]] ist). Kurzzeitig kann dieser Pull-Up 1mA liefern, wenn ein Ausgang von LOW auf HIGH schaltet, das verkürzt die Umschaltzeit wesentlich. Der gesamt aufgenommene Strom sollte 200mA nicht überschreiten.

=I2C Kommunikation=

Gestartet wird die Kommunikation durch das Senden der Start-Bedingung gefolgt vom Adressbyte.

Das Adressbyte für den PCF8574:

{| border="1"
! Bit 7 || Bit 6 || Bit 5 || Bit 4 || Bit 3 || Bit 2 || Bit 1 || Bit 0 || Hexadezimal
|-
| align="center" | 0
| align="center" | 1
| align="center" | 0
| align="center" | 0
| align="center" | A2
| align="center" | A1
| align="center" | A0
| align="center" | R/W
|| 0x40 + A[2:0]*2 + R/W
|}

Das Adressbyte für den PCF8574'''A''':

{| border="1"
! Bit 7 || Bit 6 || Bit 5 || Bit 4 || Bit 3 || Bit 2 || Bit 1 || Bit 0 || Hexadezimal
|-
| align="center" | 0
| align="center" | 1
| align="center" | 1
| align="center" | 1
| align="center" | A2
| align="center" | A1
| align="center" | A0
| align="center" | R/W
|| 0x70 + A[2:0]*2 + R/W
|}
Der Adresse (4Bit für die eindeutige Kennung + 3 frei wählbare Bits) folgt das obligatorische R/W-Bit, welches festlegt, ob ein Lese- oder Schreibzugriff ausgeführt werden soll (R/W=0 Schreiben, R/W=1 Lesen).

Wurde ein ACK empfangen, d.h. hat sich ein Slave angesprochen gefühlt, so kann man nun ein Datenbyte senden (R/W=0) oder den Status der Eingänge einlesen (R/W=1), also ein Datenbyte empfangen. Wurde ein Byte gesendet, so bestätigt der Baustein dieses mit ACK. Der Anwender kann nun festlegen, ob er das nächste Byte senden möchte oder ein STOP senden. Wurde ein Byte gelesen, so hat der Master dieses per ACK zu bestätigen, so er denn gleich das nächste empfangen möchte. Ansonsten kann hier das ACK entfallen und ein STOP gesendet werden.

Stellt sich nur noch die Frage: Wie regelt man nun, ob ein Pin als Ein- oder Ausgang arbeiten soll? Soviel gleich vorweg: So etwas wie die Datenrichtungsregister des [[AVR]]s gibt es hier nicht, man muss ohne sie auskommen. Den Ausgangspegel der Pins definiert man über einen Schreibzugriff. Sendet man beispielsweise nach der Adresse gefolgt vom ACK des Bausteins 0xF0, so bedeutet das, dass P0:3 nun L-Pegel haben und P4:7 H-Pegel. Will man einige IOs als Eingänge verwenden, muss man die entsprechenden Ausgänge zunächst auf H-Pegel setzen, da es sich um [[Ausgangsstufen Logik-ICs|Open Collektor Ausgänge]] handelt sind die Ausgänge somit inaktiv. Führt man nun einen Lesezugriff durch, so stehen im gelesenen Byte die Pegel der Pins.

=Anwendung=

Im nachfolgenden Bild sind verschiedene Anwendungen der IOs dargestellt.

[[Bild:PCF8574.png|640px]]

* P0..P3 - Ausgänge für LEDs: Die LEDS sind mit ihrer Anode über einen Vorwiderstand gegen VCC verdrahtet. Eine LED wird eingeschaltet, indem der jeweilige Ausgang auf LOW gesetzt wird (LOW aktive). Es ist NICHT möglich, die LEDs mit ihrer Kathode gegen GND zu verdrahten, da die Ausgänge vom Typ [[Ausgangsstufen_Logik-ICs#Open_Collector| Open Collector]] sind und nur bei LOW große Ströme schalten können.
* P4 - Ausgänge für ULN2003 & Co: Hier wird bei HIGH doch schon richtig Strom gebraucht (ca. 1mA). Das kann der IC nicht selber liefern (typisch ca. 100µA). Deshalb wird hier ein relativ niederohmiger Pull-Up Widerstand benötigt.
* P5 - Ausgänge für Logikbausteine: Nichts besonderes.
* P6 - Eingänge für Logikbausteine: Der Logikbaustein muss bei LOW bis zu 300µA Strom liefern können, da die internen Pull-Up Widerstände darauf dimensioniert sind und man sie nicht abschalten kann.
* P7 - Eingänge für Taster: Die internen Pull-up Widerstände sind hier nützlich.

=Software=

Routinen zum Ansteuern des Baustein können hier herunter geladen werden:
* [http://www.mikrocontroller.net/mc-project/Pages/Projekte/ICs/Port%20Expander/Portexpander%20Beispiel.zip Portexpander Beispiel.zip]

[[Category:Mc-project.de]]

FAQ

2008-04-30T13:08:04Z

Frajo: /* Beispiele */

Ein Verzeichnis von im Forum oft gestellten und immer wieder beantworteten Fragen und den zugehörigen Antworten:

=Wie kann ich Zahlen auf [[LCD]]/[[UART]] ausgeben?=

Aber die Bibliothek, die Sie benutzen, stellt nur eine Funktion zur Verfügung, mit der man einen String ausgeben kann... Was tun?

In den folgenden Beispielen wird eine selbstgeschriebene Funktion zur Stringausgabe auf LCD - die Funktion lcd_string() - aus dem [[AVR-GCC-Tutorial#Programmierung|LCD-Teil des AVR-GCC-Tutorials]] verwendet:

<c>
lcd_string( "Hallo Welt" ); // ggf. auch lcd_out() o.ä. in anderen Libraries
</c>

Um also eine Zahl (numerische Konstante oder Variableninhalt) auszugeben, muss von dieser Zahl zunächst ihre String-Repräsentierung ermittelt werden. Dazu gibt es mehrere Möglichkeiten:

===itoa()===

itoa() ist keine C-Standardfunktion (wohl aber ihre Umkehrung atoi() ). Auf manchen Compilern heisst diese Funktion dann folgerichtig _itoa(), wobei der führende _ eben anzeigt, dass es sich um eine Erweiterung des C-Standards handelt. Bei [[WinAVR]] ist itoa() Bestandteil der mitgelieferten Library avr-libc.

<c>
int i = 25;

char Buffer[20];
itoa( i, Buffer, 10 );
lcd_string( Buffer ); // ggf. auch lcd_out() o.ä. in anderen Libraries
</c>

itoa( i, Buffer, 10 ); - Die Zahl i wird nach ASCII gewandelt und die String Repräsentierung davon wird in Buffer abgelegt. Die Basis, in der diese Wandlung erfolgt, ist das 10-er System.

Wichtig ist, darauf zu achten, dass das Array Buffer groß genug dimensioniert wird, um alle Zeichen der Textrepräsentierung der Zahl aufzunehmen.

===sprintf()===

<c>
int i = 25;

char Buffer[20];
sprintf( Buffer, "%d", i );
lcd_string( Buffer ); // ggf. auch lcd_out() o.ä. in anderen Libraries
</c>

Diese Methode funktioniert auch bei long oder float Werten. Unbedingt beachtet werden muss allerdings, dass die Typkennzeichnungen im sog. Format-String (hier "%d") mit den tatsächlichen Typen der auszugebenden Werten übereinstimmt. Und dass der Buffer, der den Text aufnimmt, auch groß genug dimensioniert wird.

Mit sprintf() hat man dieselben Möglichkeiten zur Formatierung wie bei printf() (siehe unten). Insbesondere gibt es natürlich die Möglichkeit die Zahl gleich in einen umgebenden Text einzubetten bzw. Formatierungen anzugeben:

<c>
int i = 25;

char Buffer[20];
sprintf( Buffer, "Anzahl: %d Stueck", i );
lcd_out( Buffer );
</c>

Der "Haken" an der mächtigen Funktion sprintf() ist, daß sie auch bei minimalisierter Konfiguration verhältnismäßig viel Programmspeicher (Flash-ROM) belegt und relativ viel Prozesszeit benötigt. Daher sollte man sprintf() nur verwenden, wenn kein Speicher- und Prozesszeitmangel besteht. Sonst sollte itoa() oder eine eigene, auf die Bedürfnisse optimierte Implementierung auf jeden Fall vorgezogen werden.

====Formatierungen mit printf====

Für jedes auszugebende Argument muss es im Formatstring einen entsprechenden Formatbezeichner geben. Der Aufbau eines Formatbezeichners ist immer

%[Modifizierer][Feldbreite][.Präzision]Typ

Typ ist dabei eine Kennung, der mit dem Datentyp des jeweiligen auszugebenden Argumentes übereinstimmen muss. Einige oft benutzte Kennungen, ohne Anspruch auf Vollständigkeit, sind:
c char
d int
f float, double
ld long
u unsigned int
lu unsigned long
p pointer
s string

Die Feldbreite gibt die Breite des Ausgabefeldes an, in die die Ausgabe durchgeführt werden soll. Reicht die angegebene Feldbreite nicht aus, so vergrößert printf diese Breite eigenmächtig. Die Feldbreite muß nicht angegeben werden. In diesem Fall bestimmt printf selbst die Feldbreite, so dass die Ausgabe darin Platz findet.

Der Modifizierer bestimmt, wie und womit nicht benutzte Felder des Ausgabefeldes gefüllt werden sollen, wie die Ausrichtung innerhalb des Feldes erfolgen soll und ob ein Vorzeichen auch dann ausgegeben werden soll wenn die auszugebende Zahl positiv ist. Wird kein Modifizierer angegeben, so werden nicht benutzte Felder mit einem Leerzeichen gefüllt, positive Vorzeichen unterdrückt und die Ausgabe im Feld rechts ausgerichtet.

+ Vorzeichen wird immer ausgegeben
- Die Ausgabe wird im Ausgabefeld linksbündig ausgerichtet
0 anstelle von Leerzeichen werden führende 0-en ausgegeben

Die Präzision kommt nur bei float oder double Zahlen zum Einsatz. Sie legt fest, wieviele Positionen der kompletten Feldbreite für die Ausgabe von Nachkommastellen reserviert werden sollen. Auch sie muss wiederrum nicht angegeben werden und printf benutzt in so einem Fall Standardvorgaben.

===== Beispiele =====
* "%d" Ausgabe eines Integer
* "%5d" Ausgabe eines Integer in einem Feld mit 5 Zeichen Breite
* "%05d" Ausgabe eines Integer in einem Feld mit 5 Zeichen Breite, wobei das Feld links mit führenden Nullen auf 5 Zeichen aufgefüllt wird
* "%-5d" Ausgabe eines Integer in einem Feld mit 5 Zeichen Breite. Die Zahl wird linksbündig in das Feld gestellt.

===Eigene Umwandlungsfunktionen===

Möchte man itoa() nicht benutzen oder hat es gar auf seinem System nicht zur Verfügung, dann ist es auch nicht schwer, sich selbst eine Funktion dafür zu schreiben:

<c>
void ItoA( int z, char* Buffer )
{
int i = 0;
int j;
char tmp;

unsigned u; // In u bearbeiten wir den Absolutbetrag von z.

// ist die Zahl negativ?
// gleich mal ein - hinterlassen und die Zahl positiv machen
if( z < 0 ) {
Buffer[0] = '-';
Buffer++;
// -INT_MIN ist idR. größer als INT_MAX und nicht mehr
// als int darstellbar! Man muss daher bei der Bildung
// des Absolutbetrages aufpassen.
u=((unsigned)-(z+1))+1;
}
else {
u=(unsigned)z;
}
// die einzelnen Stellen der Zahl berechnen
do {
Buffer[i++] = '0' + u % 10;
u /= 10;
} while(u>0);
// den String in sich spiegeln
for( j = 0; j 

Das Grundprinzip ist einfach: 
Die Ermittlung der einzelnen Stellen erfolgt in der zentralen Schleife

<c>
do {
Buffer[i++] = '0' + u % 10;
u /= 10;
} while(u>0);
</c>

durch fortgesetzte Division durch 10. Nur leider erhält man dadurch die einzelnen Ziffern der Zahl in umgekehrter Reihenfolge im String. Dies ist aber kein Problem, die nachfolgende Schleife

<c>
for( j = 0; j 

spiegelt den String in sich, sodass danach der String eine korrekte Repräsentierung der ursprünglichen Zahl darstellt. Der Funktionsteil vor der 'Zerlegeschleife' behandelt den Sonderfall daß die Zahl 0 ist bzw. negative Zahlen. Negative Zahlen werden behandelt indem im Endergebnis ein '-' vermerkt wird und danach die Zahl positiv gemacht wird.

Siehe auch:
* Forenbeitrag [http://www.mikrocontroller.net/topic/67405#541885 Integer-Zahl in String mit bestimmter Zeichenlänge]
* Forenbeitrag [http://www.mikrocontroller.net/topic/84005#704736 (Resourcenschonend) Wert einer Variable am LCD ausgeben] von Niels Hüsken
* [[Festkommaarithmetik]]

=Aktivieren der Floating Point Version von sprintf beim WinAVR mit AVR-Studio=
Beim WinAVR/AVR-Studio wird standardmässig eine Version der printf-Bibliothek verwendet, die keine Floating Point Verarbeitung unterstützt. Die meisten Programme benötigen keine Floating Point Unterstützung, sodass hier wertvoller Programmspeicherplatz gespart werden kann.

Benutzt man dann allerdings eine printf Variante für die Ausgabe von Floating Point Zahlen, so erscheint an Stelle der korrekt formatierten Zahl lediglich ein '?'. Dies ist ein Indiz, dass die Floating Point Verarbeitung im Projekt aktiviert werden muss.

Um die Floating Point Verarbeitung zu aktivieren, geht man im AVR-Studio wie folgt vor:
Menüpunkt: "Project"/"Configuration Options"

Im sich öffnenden Dialog wird in der linken Navigationsleiste der Eintrag "Libraries" ausgewählt.
Unter 'Available Link Objects' werden alle möglichen Bibliotheken angeboten. Für die Aktivierung der Floating Point Unterstützung sind 2 interessant:
* libprintf_flt.a
* libm.a
Beide Bibliotheken werden durch aktivieren und einen Druck auf "Add Library -->" in die rechte Spalte übernommen.

[[Bild:AVR_Studio_float1.gif]]

Danach wählt man in der Navigationsleiste den Eintrag "Custom Options". Unter 'Custom Compilation Options' wird '[Linker Options]' ausgewählt und in das Textfeld rechts/unten wird der Text
-Wl,-u,vfprintf
eingegeben. Ein Druck auf "Add" befördert die Zeile in das Listenfeld darüber, welches die Kommandos an den Linker enthält.

[[Bild:AVR_Studio_float2.gif]]

Damit ist die Konfiguration abgeschlossen, "OK"

=Wie funktioniert String-Verarbeitung in C?=

In C gibt es, anders als in anderen Programmiersprachen, keinen eigenen String-Datentyp. Als Ersatz dafür werden Character-Arrays benutzt, in denen die einzelnen Character (=Zeichen) gespeichert werden. Allerdings gibt es noch einen Zusatz: Das letzte Zeichen eines Strings ist immer ein '\0'-Zeichen, dass das Ende des Strings markiert. Schlieslich kann ja das Array wesentlich größer sein, als der in ihm gespeicherte String und irgendwie müssen ja diverse Funktionen das tatsächliche Ende eines Strings erkennen können.

Möchte mal also die Zeichenkette "Hello World" in einem String speichern, so wird dafür ein Array mit mindestens der Länge 12 benötigt. 11 für die Zeichen die "Hello World" bilden, plus eine zusätzliche Position für das abschliesende '\0'-Zeichen.

Da Strings in char-Arrays gespeichert werden, können selbstverständlich normale Array Operationen dafür benutzt werden:

<c>
char Test[12];

Test[0] = 'H';
Test[1] = 'a';
Test[2] = 'l';
Test[3] = 'l';
Test[4] = 'o';
Test[5] = ' ';
Test[6] = 'W';
Test[7] = 'o';
Test[8] = 'r';
Test[9] = 'l';
Test[10] = 'd';
Test[11] = '\0'; // das abschliessende \0 nicht vergessen! Sonst ist
// das kein String!
</c>

== Einige Stringfunktionen ==
Arrays sind in C keine vollwertigen Datentypen, z.B. ist es nicht möglich einem Array in einem Rutsch ein anderes Array zuzuweisen oder 2 Arrays miteinander zu vergleichen. Genau das möchte man aber in der Stringverarbeitung häufig, sodass es dafür Standardfunktionen gibt, die allesamt im Headerfile "string.h" zusammengefasst sind und deren Namen alle mit str... beginnen. Allen diesen Funktionen gemeinsam ist, dass sie sich nicht um die korrekte Bereitstellung von Arrays kümmern, sondern davon ausgehen, dass dies vom Programmierer korrekt erledigt wird.

=== strcpy( char* dest, const char* src ) ===
Kopieren eines Strings von der Speicherfläche auf die src zeigt, zur Speicherfläche, auf die dest zeigt.
<c>
char Ziel1[20];
char Ziel2[20];

strcpy( Ziel1, "Hallo Welt" );
strcpy( Ziel2, Ziel1 );
</c>

=== strcat( char* dest, const char* src ) ===
Anhängen eines Strings an einen bestehenden String.
<c>
char Ziel[20];
char Temp[20];

strcpy( Ziel, "Hallo " ); // Ziel enthält jetzt den String "Hallo "
strcat( Ziel, "Welt" ); // Ziel enthält jetzt den String "Hallo Welt"

strcpy( Temp, " !" );
strcat( Ziel, Temp ); // Ziel enthält jetzt den String "Hallo Welt !"
</c>

=== strcmp( const char* str1, const char* str2 ) ===
Vergleichen 2-er Strings. Das Ergebnis ist 0, wenn die beiden Strings identisch sind.

=== strlen( const char* str ) ===
Die Länge eines Strings feststellen. Die Länge beinhaltet nicht das abschliessende '\0' Zeichen.

Unter 'Länge' wird hier die tatsächliche Länge des Strings (also die Anzahl der im String gespeicherten Zeichen) verstanden und nicht die 'Länge' des Arrays in dem der String gespeichert ist. Wird der Text "test" in einem char-Array der Größe 20 gespeichert, so lautet das Ergebnis von strlen() 4 und nicht etwa 20

<C>
char string[20];
strcpy( string, "test" );
i = strlen( string ); // i bekommt hier den Wert 4
</C>

== Beispiele ==

<c>
#include "string.h"

int main()
{
char Meldung[14];
strcpy( Meldung, "Hello World" );
}
</c>
Mittels der Definition
<c>
char Meldung[14];
</c>
wird ein Array bereitgestellt, welches maximal 14 Zeichen aufnehmen kann. Hello World verbraucht für die lesbaren Zeichen 11 Array-Positionen, dazu noch das obligatorische abschliessende '\0' Zeichen, macht in Summe 12 Positionen. Eine Definition von 14 Zeichen ist also mehr als minimal notwendig
wäre. Das macht aber nichts, da durch das abschliessende '\0' Zeichen immer feststellbar ist, an welcher Stelle der tatsächliche String zu Ende ist. Die restlichen 2 Array-Positionen sind zur Zeit halt einfach unbenutzt.
strcpy() kopiert den 2.ten angegebenen String an die Position auf die sein erstes Argument zeigt. Im obigen Beispiel zeigt das 1.te Argument auf den Beginn von Meldung, also auf das Array. Folgerichtig wird der String "Hello World" in das Array Meldung umkopiert. Nach Ausführung der strcpy() Funktion enthält also Meldung den Inhalt:

+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
| H | e | l | l | o | | W | o | r | l | d | \0| | |
+---+---+---+---+---+---+---+---+---+---+---+---+---+---+

Möchte man an diesen Text jetzt noch etwas anfügen, z.B. ein "?", so würde das so aussehen:

<c>
#include "string.h"

int main()
{
char Meldung[14];
strcpy( Meldung, "Hello World" );
strcat( Meldung, "?" );
}
</c>


Man beachte: auch wenn hier scheinbar nur ein einzelnes Zeichen angehängt wird, so handelt es sich doch um einen String. Strings werden in C immer mit einem " eingeleitet und abgeschlossen. Im Gegensatz zu einzelnen Zeichen, die in einfache ' eingefasst werden. "?" ist also nicht dasselbe wie '?'! Das
erste ist ein String (der mit dem obligatorischen '\0' Zeichen insgesamt aus 2 Zeichen besteht), während letzteres ein einzelnes Zeichen darstellt! Die meisten str... Funktionen arbeiten nur mit Strings!


Da Meldung maximal 14 Zeichen umfassen kann, der Text "Hello World?" aber nur aus 13 Zeichen besteht, funktioniert Obiges auch ohne Probleme. Der Array-Inhalt sieht dann wie folgt aus:

+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
| H | e | l | l | o | | W | o | r | l | d | ? | \0| |
+---+---+---+---+---+---+---+---+---+---+---+---+---+---+

Ein schwerwiegender Fehler wäre es, wenn der komplette String nach dem strcat() aus mehr als 14 Zeichen (das '\0'-Zeichen nicht vergessen!) bestehen würde.

<c>
#include "string.h"

int main()
{
char Meldung[14];
strcpy( Meldung, "Hello World" );
strcat( Meldung, " von mir" );
}
</c>

würde also das Array überlaufen lassen.

+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
| H | e | l | l | o | | W | o | r | l | d | | v | o | n m i r \0
+---+---+---+---+---+---+---+---+---+---+---+---+---+---+

Man sieht sehr schön, daß in diesem Fall die weiteren Zeichen einfach an die Folgepositionen im Speicher geschrieben werden und dadurch ungewollt Speicher verändern, der nicht zu Meldung gehört. Abhängig von den Details des Programmes können aber an dieser Stelle im Speicher z.B. ganz andere Variablen liegen, die dann verändert werden. strcpy(), strcat() oder alle anderen String-Funktionen können den Programmierer gegen diesen Fall nicht schützen! Dazu müssten sie die Größe des Speicherbereichs kennen, was sie nicht tun. Es obliegt einzig und alleine der Sorgfalt des Programmierers, das Programm gegen solche Fälle abzusichern!
Seit einiger Zeit wurde das Sammelsurium der str... Funktionen durch Varianten ergänzt, die dieses Manko beheben. Diesen Funktionen muß die Größe des Zielbereiches mitgegeben werden. Dadurch werden die Funktionen in die Lage versetzt, zu überprüfen ob sie den Zielbereich überlaufen würden und entsprechend zu reagieren. Diese Funktionen heißen grundsätzlich gleich wie die str... Funktionen, nur befindet sich ein kleines 'n' im Funktionsnamen. Aus strcpy wird so strncpy, aus strcat wird strncat usw. Für Details dazu sei auf Literatur oder Web-Recherche verwiesen. Auch wenn einen diese Funktionen gegen die gefürchteten Array-Overflows schützen können, so muß man sich trotzem klarmachen, daß dieser Schutz nur die halbe Miete ist. Denn was soll strncpy denn tun, wenn der zu kopierende String nicht in das Zielarray passt? strncpy kopiert soviel wie es kann und gibt dann auf. Aber: Dadurch ist der String aber nicht zur Gänze in den Zielbereich kopiert worden. Programmteile die darauf angewiesen sind, daß der String vollständig kopiert wurde, werden dann nicht mehr oder nicht richtig funktionieren usw. Auch wenn die strn... Funktionen eine gewisse Abhilfe bringen und zumindest den Absturz eines Programmes verhindern können, stellen sie dennoch keine Allheilmittel dar. Um die korrekte Abschätzung der benötigten Arraygrößen kommt man nicht umhin.

strlen() liefert die Länge eines Strings. Die Längenangabe beinhaltet dabei nicht das abschliessende '\0' Zeichen:

<c>
#include "string.h"

int main()
{
char Meldung[14];
int Len;

strcpy( Meldung, "Hello World" );
Len = strlen( Meldung );

/* Hier enthaelt Len den Wert 11 */

Len = strlen( "Hallo Welt" );

/* Hier enthält Len den Wert 10 */
}
</c>

strcmp() schlussendlich vergleicht 2 Strings auf Gleichheit. Der Rückgabewert spiegelt dabei die Position des ersten Unterschiedes in den beiden Strings wieder. Folgerichtig sagt ein Wert von 0 daher aus, dass die beiden Strings identisch sind:

<c>

#include "string.h"

int main()
{
char Meldung1[14];
char Meldung2[14];

strcpy( Meldung1, "Hello World" );
strcpy( Meldung2, "Hallo Welt" );

if( strcmp( Meldung1, Meldung2 ) == 0 ) {
/* die Strings sind identisch */
}
else {
/* die Strings sind nicht identisch */
}

if( strcmp( Meldung2, "Hallo Welt" ) == 0 ) {
/* Meldung2 war "Hallo Welt" */
}
}

</c>

Es gibt noch weitere String-Funktionen, dafür sei aber auf die Verwendung der zum Compiler gehörenden Dokumentation bzw. auf einführende Literatur zum Thema 'Programmieren in C' verwiesen.

=Funktionszeiger=
Um Menüs oder ähnliche Dinge aufzubauen ist es oft praktisch ein Array von Funktionszeigern zu definieren. Der Aufruf einer Funktion kann dann indirekt über eine Variable erfolgen, wobei die Variable die Adresse der aufzurufenden Funktion enthält.

Um mit Funktionszeigern zu arbeiten ist es in der Praxis sinnvoll sich einen typedef für den Typ des Funktionszeigers zu definieren. Ein typedef definiert einen neuen (kürzeren) Namen für einen Datentyp. Und wie wir sehen werden, ist der Datentyp eines Funktionszeigers in der Schreibweise ganz schön umfangreich.

==typedef==
Einen typedef zu definieren ist eigentlich ganz einfach: Man schreibt die Deklaration so, als ob man eine Variable definieren würde. Vor das ganze Konstrukt kommt das Schlüsselwort typedef. Es bewirkt, dass der Name an der Position des Variablennamens zum Namen für den neuen Datentyp wird, der dann in weiterer Folge wie jeder andere Datentyp benutzt werden kann.

Wir wollen einen Funktionszeiger auf eine Funktion definieren, die keine Argumente entgegen nimmt und auch nichts liefert. Also Funktionen nach
dem Muster:

<c>
void foo( void )
{
}
</c>

Ein entsprechender typedef würde zB so aussehen:

<c>
typedef void (*VoidFnct)( void );
</c>

Das vereinbart einen neuen Datentyp VoidFnct. Dieser ist ein Funktionszeiger auf Funktionen, die keine Argumente nehmen und auch nichts zurückliefern.

<c>
typedef int (*IntFnct)( void );
typedef int (*IntFnct2)( int );
</c>

IntFnct ist ein Zeiger auf eine Funktion, die keine Argumente nimmt aber einen int zurückliefert. IntFnct2 hingegen ist ein Zeiger auf eine Funktion, die einen int als Argument nimmt und einen int zurückliefert. Andere Argumenttypen bzw. Rückgabetypen folgen dem gleichen Muster. Wichtig ist, dass sowohl Argumenttypen als auch Rückgabetypen Teil der Signatur eines Funktionszeigers ist. Es ist also nicht möglich einen Funktionszeigertyp zu vereinbaren, der auf beliebige Funktionen mit beliebigen Argumenttypen bzw. Rückgabetypen verweist. Hier muss man ev. auf einen cast ausweichen. Generell ist das aber meist keine gute Idee.

==Funktionszeigertabellen==
Mit einem typedef ist es nun ein leichtes ein Array von Funktionszeigern zu vereinbaren:

<c>
typedef void (*VoidFnct)( void );

VoidFnct MeineFunktionen[5];
</c>

Dies vereinbart MeineFunktionen als ein Array von Funktionszeigern, wobei jeder Funktionszeiger auf eine Funktion vom Typ void-void zeigt.

<c>
typedef void (*VoidFnct)( void );

void Funct1()
{
printf( "Dies ist Funktion 1\n" );
}

void Funct2()
{
printf( "Dies ist Funktion 2\n" );
}

VoidFnct MeineFunktionen[] = { Funct1, Funct2 };

int main()
{
//
// ruft die Funktion auf, deren Adresse in MeineFunktionen[0]
// steht. In diesem Fall wäre das Funct1()
//
MeineFunktionen[0]();

//
// und jetzt die MeineFunktionen[1]
//
MeineFunktionen[1]();

//
// jetzt wird MeineFunktionen[0] umgeleitet auf Funct2()
// Achtung: Auf der rechten Seite wird kein () angegeben.
// Ansonsten würde ja die Funktione Funct2 aufgerufen. Wir
// wollen aber nur ihre Speicheradresse haben! Daher unterbleibt
// das ()
//
MeineFunktionen[0] = Funct2;

//
// welche Funktion wird jetzt aufgerufen?
//
MeineFunktionen[0]();
// Richtig: Die Funktion, deren Adresse in MeineFunktionen[0]
// steht. Und das ist jetzt Funct2.
}
</c>

==Menüs mit Funktionszeigern==
Besonders bei Menüs ist es oft hilfreich, sich eine Struktur bestehend
aus dem Menütext und der aufzurufenden Funktion zu definieren

<c>
typedef void (*VoidFnct)( void );

struct MenuEntry {
char Text[20];
VoidFnct Function;
};
</c>

Ein Menü ist dann einfach ein Array aus derartigen Strukturelementen

<c>

void HandleEdit()
{
}

void HandleCopy()
{
}

void HandlePaste()
{
}

struct MenuEntry MainMenu[] = {
{ "Edit", HandleEdit },
{ "Copy", HandleCopy },
{ "Paste", HandlePaste }
};

#define ARRAY_SIZE(X) ( sizeof(X) / sizeof(*(X)) )

void DoMenu( int NrEntries, struct MenuEntry[] Menu )
{
int i;
int Auswahl;

do {
//
// Das Menue anzeigen. Für jeden Menuepunkt noch eine Zahl
// davor stellen, damit der Benutzer auch was zum Eingeben hat
//
for( i = 0; i < NrEntries; ++i )
printf( "%d) %s\n", i + 1, Menu[i].Text );

printf( "9) Exit\n\n" );

//
// Jetzt die Benutzereingabe abwarten ...
//
printf( "Ihre Eingabe: " );
scanf( "%d", &Auswahl );

//
// ... und auswerten
//
if( Auswahl == 9 )
return;

Auswahl = Auswahl - 1;
if( Auswahl < 0 || Auswahl > NrEntries )
printf( "Ungültige Eingabe\n" );

else
// Die Eingabe war gültig. Zugehörige Funktion aufrufen
Menu[Auswahl].Function();
}
}

int main()
{
// Das Menü arbeiten lassen.
// Die Funktion DoMenu ruft selbsttätig die zu den jeweiligen
// Menüpunkten gehörenden Funktionen auf. DoMenu kommt erst
// dann wieder zurück, wenn der Benutzer den Menüpunkt
// 9) Exit
// ausgewählt hat.

DoMenu( ARRAY_SIZE( MainMenu ), MainMenu );

while( 1 )
;
}
</c>

Auf einem Mikrocontroller wird man natürlich die Ein/Ausgabe nicht über printf/scanf abwickeln. Hier geht es aber um das Prinzip der Funktionszeiger und wie man mit ihnen arbeitet, daher wurde die allereinfachste Art der Benutzerinteraktion gewählt. Gegebenenfalls muss printf und scanf durch die Möglichkeiten auf dem konkreten System ersetzt werden. Auch ist die Art und Weise wie das Menü präsentiert bzw. die Benutzereingabe ausgewertet wird, nicht der Weisheit letzter Schluss. Anstatt den Benutzer Zahlen eingeben zu lassen, könnte man auch einen Auswahl-Balken vom Benutzer mit 2 Tasten über die Menüeinträge bewegen lassen. Oder einen Drehencoder nehmen, ...

=Ich hab da mehrere *.c und *.h Dateien. Was mache ich damit?=
Zunächst ist es wichtig, sich zu vergegenwärtigen wie denn der C Compiler/Linker überhaupt arbeitet. Ein komplettes Programmier-Projekt kann und wird im Normalfall aus mehreren Source Code Dateien bestehen die alle zusammengenommen das komplette Programm bilden.

Der Prozess des Erstellens des Programmes geschieht in mehrerern Schritten:
* zunächst werden alle Einzelteile (jede *.c Datei) für sich compiliert. Dabei ensteht für jede *.c Datei eine sog. Object-Datei in der bereits der Maschinencode für die im *.c programmierten Funktionen enthalten ist
* danach werden die einzelnen Object-Dateien zusammen mit zusätzlichen Bibliotheken zum fertigen Programm gelinkt.

Angenommen das komplette Projekt besteht aus 2 Dateien

Datei: main.c
<c>
int twice(int i);

int main()
{
foo( 5 );
}
</c>

Datei: func.c
<c>
int twice( int number )
{
return 2 * number;
}
</c>

dann werden main.c und func.c unabhängig voneinander compiliert. Als Ergebnis erhält man die Dateien main.o und func.o die den besagten Object-Code enthalten. Erst diese beiden Zwischenergebnisse werden dann zusammen mit eventuellen Bibliotheken zum fertigen Programm gebunden (gelinkt), das dann ausgeführt werden kann.

+---------+ +----------+
| main.c | | func.c |
+---------+ +----------+
| |
| |
v v
Compiler Compiler
| |
| |
v v
+---------+ +----------+
| main.o | | func.o |
+---------+ +----------+
| |
+-----------+ +-------------------+
| |
v v
Linker <------ zus. Bibliotheken
|
v
+----------+
| fertiges |
| Programm |
+----------+

Bekommt man also von irgendwo bereits fertige *.c (und zugehörige *.h) Dateien, so genügt es, die *.c Dateien ganz einfach in das Projekt mit aufzunehmen. Daduch wird das entsprechende *.c File compiliert und das Ergebnis davon, das Object-file, wird dann in das fertige Programm mit eingelinkt.

Wie eine *.c Datei in das Projekt mit aufgenommen wird, hängt im wesentlichen von der benutzten Entwicklungsumgebung ab.

==Makefile==
Die zusätzliche *.c Datei wird in die SRC Zeile im makefile eingetragen.
==AVR-Studio==
Hier ist es besonders einfach eine Datei in das Projekt mit aufzunehmen. Dazu wird im Projektbaum einfach der Knoten "Source Files" aktiviert und mit der rechten Maustaste das Kontextmenü geöffnet. Im Menü wird der Punkt "Add existing Source File(s)" ausgewählt und anschliessend zeigt man AVR-Studio das zusätzliche *.c File. AVR-Studio berücksicht dann dieses File bei der Projekterzeugung, compiliert es und sorgt dafür, daß es zum fertigen Programm dazugelinkt wird.