====== Alphanumerisches LCD ======

//Bezug nehmend auf: [HW] [[en:hardware:homelab:lcd]]//

Diese Bibliothek enthält die Funktionen, um das alphanumerische LCD des HomeLab zu nutzen.

===== Datentypen =====

  * **//lcd_alpha_mode//** \\ LCD Konfiguration, Aufzählungsdatentyp. Möglichkeiten:
    * //LCD_ALPHA_DISP_OFF// - Display aus.
    * //LCD_ALPHA_DISP_ON// - Display an mit unsichbarem Cursor.
    * //LCD_ALPHA_DISP_ON_CURSOR// - Display an mit Cursor.
    * //LCD_ALPHA_DISP_ON_CURSOR_BLINK// - Display an mit blinkendem Cursor.

===== Funktionen =====

  * **//void lcd_alpha_init(lcd_alpha_mode disp_attr)//** \\
    Initialisiert LCD. Parameter:
    * //disp_attr// - Display Konfiguration.

  * **//void lcd_alpha_clear(void)//** \\
    Löscht die Anzeige. Cursor wird zum Anfang der ersten Zeile bewegt.

  * **//void lcd_alpha_clear_line(unsigned char line)//** \\
    Löscht eine Zeile am Display. Cursor wird zum Anfang der ersten Zeile bewegt. Parameter:
    * //line// - Zeilennummer: 0 oder 1.

  * **//void lcd_alpha_home(void)//** \\
    Cursor wird zum Anfang der ersten Zeile bewegt.

  * **//void lcd_alpha_goto_xy(unsigned char x, unsigned char y)//** \\
    Bewegt den Cursor zur gewünschten Position. Parameter:
    * //x// - X Koordinate (Spaltennumner). 0 bis 15.
    * //y// - Y Koordinate (Zeilennumner). 0 bis 1.

  * **//void lcd_alpha_write_char(char c)//** \\
    Schreibt ein Zeichen auf die Position des Cursors. Parameter:
    * //c// - ASCII Zeichen.

  * **//void lcd_alpha_write_string(const char *s)//** \\
    Schreibt einen String aufs Display, beginnend bei der Cursorposition. Parameter:
    * //s// - Zeiger auf einen String(char array).

  * **//void lcd_alpha_write_string_p(const char *progmem_s)//** \\
    Schreibt einen String vom Programmspeicher aufs Displays, beginnt an der Cursorposition.
    Parameter:
    * //progmem_s// - Zeiger auf String im Programmspeicher.

===== Beispiel =====

Nutzung des alphanumerischen LCD zur Darstellung von Text:

<code c>
#include <homelab/module/lcd_alpha.h>

int main(void)
{
	// Initialisierung des LCD.
	lcd_alpha_init(LCD_ALPHA_DISP_ON);

	// Löschen des Displays.
	lcd_alpha_clear();

	// Cursor an den Beginn der zweiten Zeile setzen.
	lcd_alpha_goto_xy(0, 1);	

	// Anzeige des Texts.
	lcd_alpha_write_string("Hello");
}
</code>