Serielles Interface

Diese Bibliothek bietet die Funktionen für das AVR asynchrone serielle Interface

• usart
  Datentyp für USART Interfacekontroll-, Status- und Datenregisteradressen. usart Variablen sollten zu Beginn des Programms initialisiert werden. Für die Initialisierung gibt es eine Macrofunktion USART dessen einziger Parameter für den Index des Interface ist. (0 oder 1).

• usart_databits
  Zählen der Datenbits, Aufzählungsdatentyp. Möglichkeiten:
  • USART_DATABITS_5 - 5 Datenbits.
  • USART_DATABITS_6 - 6 Datenbits.
  • USART_DATABITS_7 - 7 Datenbits.
  • USART_DATABITS_8 - 8 Datenbits.
  • USART_DATABITS_9 - 9 Datenbits.

• usart_stopbits
  Zählen der Stop-Bits, Aufzählungsdatentyp. Möglichkeiten:
  • USART_STOPBITS_ONE - Ein Stop-Bit.
  • USART_STOPBITS_TWO - Zwei Stop-Bit.

• usart_parity
  Paritätsmodus, Aufzählungsdatentyp. Möglichkeiten:
  • USART_PARITY_NONE - Ausgeschaltet.
  • USART_PARITY_EVEN - Gerade Parität.
  • USART_PARITY_ODD - Ungerade Parität.

• USART_BAUDRATE_ASYNC(baud)
  

Makrofunktion um den USART Baudratenregisterwert im asynchronen Modus zu berechnen. Parameter:

• baud - Gewünschte Baudrate
• Gibt Baudratenregisterwert wieder.

• void usart_init_async(usart port, usart_databits data_bits, usart_stopbits stop_bits, usart_parity parity, usart_baudrate baudrate)
  

Initialisiert asynchrones USART. Parameter:

• port - USART Schnittstellenvariable.
• data_bits - Datenbits.
• stop_bits - Stop-Bits.
• parity - Paritätsmodus.
• baudrate - Baudratenregisterwert (kann mit der Makrofunktion USART_BAUDRATE_ASYNC errechnet werden).

• void usart_send_char(usart port, char symbol)
  

Blockiert die Übertragung von Zeichen. Die Funktionen warten solange bis der Ausgabespeicher leer ist, bevor ein Zeichen in den Speicher geschrieben wird. Parameter:

• port - USART Schnittstellenvariable.
• symbol - zu sendendes Zeichen.

• void usart_send_string(usart port, char *text)
  

Blockierende String-Übertragung. Parameter:

• port - USART Schnittstellenvariable.
• text - Zeiger auf einen String(char array). Der String muss mit einer Null enden.

• bool usart_has_data(usart port)
  

Überprüft Empfangsspeicher auf Daten. Parameter:

• port - USART Schnittstellenvariable.
• Gibt true zurück wenn Zeichen im Empfangsspeicher und false wenn nicht.

• char usart_read_char(usart port)
  

Liest ein Zeichen aus dem Empfangsspeicher. Zuvor muss der Nuter überprüfen ob tatsächlich ein Zeichen empfangen wurde. Parameter:

• port - USART Schnittstellenvariable.
• Gibt Zeichen aus.

• bool usart_try_read_char(usart port, char *symbol)
  

Liest ein Zeichen aus dem Empfangsspeicher, falls eins vorhanden ist. Parameter:

• port - USART Interfacevariable.
• symbol - Verweis auf die Variable des Zeichens. Wenn ein Zeichen im Empfangsspeicher vorhanden ist, wird es der betreffenden Variable zugeschrieben.
• Gibt true aus, wenn ein Zeichen im Empfangsspeicher vorhanden ist und false wenn nicht.

Die USART Schnittstelle ist konfiguriert um 8 Datenbits, ein Stop-Bit, 9600 bps Baudrate und keinen Paritätsmodus zu nutzen. Das Programm sendet einen String, wartet bis die Zeichen empfangen wurden und ließt sie dann aus.

#include <homelab/usart.h>
 
// Nutze USART Schnittstelle 0.
usart port = USART(0);
 
int main(void)
{	
	char c;
 
	// Initialisierung der Schnittstelle.
	usart_init_async(port,
		USART_DATABITS_8,
		USART_STOPBITS_ONE,
		USART_PARITY_NONE,
		USART_BAUDRATE_ASYNC(9600));
 
	// Senden des String.
	usart_send_string(port, "Hello\n");
 
	// Auf ankommende Daten warten.
	while (!usart_has_data(port)) {}
 
	// Empfangenes Zeichen auslesen.
	c = usart_read_char(port);
}