====== LCD Alfanumérico ======

//Relacionado com: [HW] [[pt:hardware:homelab:digi]]//

Esta biblioteca contém funções para usar com o LCD alfanumérico do HomeLab.

===== Tipos =====

  * **//lcd_alpha_mode//** \\ Enumeração de tipos de configuração do LCD. Opções:
    * //LCD_ALPHA_DISP_OFF// - Display desligado.
    * //LCD_ALPHA_DISP_ON// - Display ligado com cursor invisível.
    * //LCD_ALPHA_DISP_ON_CURSOR// - Display ligado com cursor.
    * //LCD_ALPHA_DISP_ON_CURSOR_BLINK// - Display ligado com cursor intermitente.

===== Funções =====

  * **//void lcd_alpha_init(lcd_alpha_mode disp_attr)//** \\
    Inicializa o LCD. Parâmetros:
    * //disp_attr// - Configuração do display.

  * **//void lcd_alpha_clear(void)//** \\
    Limpa o display todo. O cursor é colocado no início da primeira linha.

  * **//void lcd_alpha_clear_line(unsigned char line)//** \\
    Limpa uma linha do display. O cursor é colocado no início da linha limpa. Parâmetros:
    * //line// - Número de linha. 0 ou 1.

  * **//void lcd_alpha_home(void)//** \\
    Coloca o cursor no início da primeira linha.

  * **//void lcd_alpha_goto_xy(unsigned char x, unsigned char y)//** \\
    Coloca o cursor numa posição desejada. Parâmetros:
    * //x// - coordenada X (número de coluna). 0 a 15.
    * //y// - coordenada Y (número de linha). 0 a 1.

  * **//void lcd_alpha_write_char(char c)//** \\
    Escreve um caractere na posição do cursor. Parâmetros:
    * //c// - caractere ASCII.

  * **//void lcd_alpha_write_string(const char *s)//** \\
    Escreve uma string no display a começar na posição do cursor. Parâmetros:
    * //s// - Apontador para uma string (array de char).

  * **//void lcd_alpha_write_string_p(const char *progmem_s)//** \\
    Escreve uma string da memória do programa para o display a começar na posição do cursor. Parâmetros:
    * //progmem_s// - Apontador para uma string na memória do programa.

===== Exemplo =====

Demonstração de como se usa o LCD alfanumérico para mostrar texto.

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

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

	// Display clearing.
	lcd_alpha_clear();

	// Cursor to the beginning of second line.
	lcd_alpha_goto_xy(0, 1);	

	// Text displaying.
	lcd_alpha_write_string("Hello");
}
</code>