DG16080 GLCD

2010-12-21T20:24:23Z

Flash2over: /* Links */

== Beschreibung ==
Das DG16080 GLCD ist ein 160x80 Punkte Schwarz-Weiß Grafik Display von Datavision für ca. 7 Euro. (Bei [http://www.pollin.de/shop/dt/MzU2OTc4OTk-/Bauelemente/Aktive_Bauelemente/Displays/Grafik_Display_DataVision_DG_16080_11.html Pollin Electronics] zur Zeit ausverkauft)
Das Display besitzt einen LC7981 Controller, der recht einfach mit einem AVR Mikrocontroller angesteuert werden kann.

== Hardware ==
=== Anforderungen ===
'''IO-Pins:''' 11 (Davon 8 an einem Port)
'''ADC:''' 4 (optional für Touchscreen)
'''Taktung:''' Frei
'''Spannung:''' 5V

=== Anschluss des LCDs an den AVR ===
Die Betriebsspannung des LCDs ist 5V - entspricht somit der des AVR und kann einfach mit einem 7805 Spannungsregler hergestellt werden.
Beim Anschluss des LCDs an den AVR gibt es grundsätzlich nicht viel zu beachten. Folgende Dinge sind jedoch notwendig:
* Pin 7-14 müssen an einen Port und in der richtigen Reihenfolge (Pin 7 --> PX0, Pin 8 --> PX1, ...) verbudnen werden.
* Pin 4-6 müssen ebenfalls an einen Port verbunden werden, jedoch ist die Reihenfolge und Position egal.
* Pin 15: Low
* Pin 16: High

Optional:
* Pin 15,16 und 18 auf AVR-Pins anstatt auf feste Pegel legen, um das Display später neu starten bzw. Ausschalten zu können.
[[Bild:DG16080_ATMEGA8.png]]

''Warnung: Der Schaltplan weich von der Standardeinstellung des Treibers ab!''

=== Hintergrundbeleuchtung & Touchscreen ===
Vom LCD gibt es 3 Ausführungen:
* Eine mit LED-Hintergrundbeleuchtung. Diese kann einfach mit einen Widerstand an die Stromversorgung des Displays angeschlossen werden oder man dimmt die Helligkeit über einen PWM-Pin am AVR. Bei dieser Ausführung ist das Touchscreen-Kabel nicht lötbar.
* Zwei mit EL-Hintergrundbeleuchtung. Um diese zu betreiben wird ein EL-Inverter (z.B. INV-TH-202) benötigt. Hier gibt es nun eine Version mit lötbarem und eine mit nicht lötbarem Verbinder am Touchscreen.
Um die nicht-lötbaren Touchscreens anzuschließen kann man eine Pin-Leiste auf die Platine runter biegen und somit den Verbinder einklemmen.

== Software ==
=== Der LCD-Treiber ===
Die hier verwendete Treiber ist der Treiber von [http://sebastians-site.de/homepage/elektronik/avr-library-for-lc7981.html Sebastian Schumb] und enthält folgende Features:
* Textmodus mit Scrolling (Fester Zeichensatz)
* Grafikmodus
* Bitmaps plotten (Alle Größen)
* Text mit beliebiger Schriftart (und Größe) plotten
* Setzen und löschen beliebiger Pixel
* Direktes schreiben der Bytes in den RAM des LCDs (lcd_write_byte)
* Direktes senden eines Befehls

==== Verwendung des Treibers ====
Der Treiber kann unter folgender Adresse heruntergeladen werden: [http://www.sebastians-site.de/hg_repos/glcd/ http://www.sebastians-site.de/hg_repos/glcd/]
Entweder man bindet nun den Treiber per include (lc7981.h, adc.h, touch.h; optional noch die fonts für schriftarten) ein und fügt die .c-dateien dem Makefile hinzu oder man verwendet den Beispielcode mit dem mitgelieferten Makefile und passt diesen an.

==== Anpassen der lc7981.h (LCD) ====
Damit der Treiber mit der verwendeten Hardware funktioniert, muss man diesen konfigurieren. Dies geschieht durch bearbeiten der lc7981.h um include-Verzeichnis.
Hier deshalb der Konfigurationsabschnitt für die oben verwendete Schaltung:

''
#define LCD_CTRL PORTB //!< Port used for control signals
#define LCD_CRTL_DDR DDRB //!< Data-Direction-Register for the control signals
#define LCD_RS PD0 //!< Register-Select Pin of the Display
#define LCD_RW PD1 //!< Read-Write-select Pin
#define LCD_EN PD2 //!< Strobe Pin
#define LCD_DATA PORTD //!< Port used for data
#define LCD_DATA_PIN PIND //!< Port used for reading the data
#define LCD_DATA_DDR DDRD //!< Data-Direction-Register for data''

==== Anpassen der touch.h (Touch) ====
Sollte der Touchscreen eine invertierte Achse haben oder x und y vertauscht sein, so kann dies in der Datei touch.h korrigiert werden. Dazu müssen nur die folgenden Zeilen angepasst werden:
''
#define TOUCH_X1 PA0
#define TOUCH_X2 PA1
#define TOUCH_Y1 PA2
#define TOUCH_Y2 PA3''

=== Eine UI-Bibliothek ===
C_Classic hat eine Bibliothek aufbauend auf dem Treiber von Sebastian geschrieben, um ein einfaches User-Interface zu erstellen.
'''Momentan umfasst es folgende Elemente:'''
Zeichenfunktionen (DrawFunctions)
* Gefülltes Rechteck
* Rechteck
* Horiz. Linie
* Vertik. Linie
* freie Linie (langsamer)
* Kreis

User-Interface(ui)
* Buttons
* Bild-Buttons
* Check-Boxen
* Labels
* Horiz. Slider
* Vertik. Slider
* Fortschrittsanzeige (Balken)
* Textbox
* Tastatur (QWERTZ)

Die UI-Lib ist in C++ geschrieben und verwendet Objekte für die Elemente. Dies ermöglicht einfachen Zugriff auf diese mit Funktionen wie "obj.GetValue" oder "obj.GetPressed".
==== Verwendung/Download ====
Den Treiber könnt ihr euch bei [https://sourceforge.net/projects/avrdg16080drv/ SourceForge] runterladen.

Die Bibliothek enthält eine C++-Version des Treibers von Sebastian Schumb, somit wird dieser nicht mehr benötigt. Für die Bibliothek werden folgende Includes benötigt:
''
#include "include/lcd.h"
#include "include/graphic.h"
#include "include/touch.h"
#include "include/fonts.h"
''

Die lcd.h enthält den portierten LCD-Treiber. Alle LCD-Funktionen sind nun in der Klasse LCD enthalten. Somit ruft man die Befehle mit LCD::befehl() auf.
Die graphic.h enthält 2 Klassen. Einmal DrawFunctions. in dieser sind die oben genannten Zeichenfunktionen enthalten. Die zweite Klasse ist ui in welcher die Benutzerelemente enthalten sind.
Touch.h hat weiterhin die gleiche Funktion, nur dass die Funktionen nun im namespace "touchscreen" stehen.
fonts.h enthält beide Schriftarten, welche nun über fonts::Schriftart zu erreichen sind.

=== Erstellen und verwenden der Elemente ===
==== Init ====
LCD::lcd_init(LCD_GRAPHIC); //LCD in Grafikmodus umschalten
LCD::lcd_clear(); //LCD löschen
==== Buttons ====
Erstellen des Elements:
ui::Button Btn(5,5,140,10,"Hallo Welt!"); //Button mit x0=5, y0=5, Breite=170, Höhe=10 und Text="Hallo Welt"
Abfragen, ob der Button gedrückt wurde:
if (Btn.pressed()) {
Foo();
}
==== Image-Buttons ====
Erstellen des Elements:
ui::PictureButton PicBtn(0,0,20,20,bitmap); //x,y,width,height, bitmap
Abfragen, ob der Button gedrückt wurde:
if (PicBtn.pressed()) {
Foo();
}
==== Checkboxen ====
Erstellen des Elements:
ui::CheckBox chk(0,0,"Label",0); //x,y,Text,CheckState
Aktualisieren der CheckBox:
chk.refresh();
Abfragen des Status:
if (autosave.checked) {
Foo();
}
==== Labels ====
Erstellen des Elements:
ui::Label lbl(0,0,"Hallo Welt!"); //x,y,Text
Aktualisieren des Textes:
lbl.setText("Neuer Text"); //Auf den Text ändern.
lbl.setNum(1337); //Den Text auf die angegebene Zahl ändern.
==== Slider ====
Erstellen des Elements:
hslider ui::HorizontalSlider(0,0,100);x,y,width
vslider ui::VerticalSlider(0,0,70);x,y,height
Aktualisieren der Slider:
hslider.refresh();
vslider.refresh();
Abfragen des Werts:
hslider.getValue(); //0->100
vslider.getValue(); //0->100
==== Fortschrittsanzeige ====
Erstellen des Elements:
ui::Progressbar prg(5,5,140,20); //x,y,width,height
Setzen des Werts:
prg.setValue(50); //0->100
Lesen des Werts:
prg.getValue(); //0->100
==== Textbox ====
Erstellen des Elements:
ui::Textbox txt(0,0,4,"",1); //x,y,Maximale Zeichen (Breite), Default-Text, ausgewählt
Setzen des Texts:
txt.setText("Hallo",1); //Neuer Text, ausgewählt (Unterstrich am Ende)
Ein Zeichen am Ende entfernen (Backspace)
txt.backspace(); //Löscht das letzte Zeichen
Lesen des Texts:
if(strcmp("Hallo",txt.text) == 0) {
Foo();
else {
Bar();
}
Prüfen ob darauf geklickt wurde (Fokus):
if (txt.pressed()) { //Prüfen ob darauf geklickt wurde
focus=0; //Variable setzen dass diese Textbox ausgewählt wurde.
txt.refresh(true); //Den Unterstrich am Ende der Textbox aktivieren
txt2.refresh(false); //Der zweiten Box den Fokus (Unterstrich) nehmen.
}
if (txt2.pressed()) { //Prüfen ob auf die zweite Box geklickt wurde
focus=1; //Variable setzen dass die zweite Textbox ausgewählt wurde.
txt2.refresh(true); //Den Unterstrich am Ende der zweiten Textbox aktivieren
txt.refresh(false); //Der Ersten den Fokus nehmen
}

==== Tastatur ====
Erstellen des Elements (+Aktualisieren):
ui::Keyboard kbd(); //Optional noch das x-Offset (Standart=30)
Empfangen eines Zeichens:
if (kbd.getKey() >= 32) { //Größer 32 sind gültige Zeichen
strcat(CharArray,kbd.getKey()); //Zeichen zu einem CharArray hinzufügen
}
else if (kbd.getKey() == 8) { //Backspace
kbd[strlen(kbd)-1] = 0; //leztes Zeichen entfernen
}
==== Allgemeine Funktionen ====
obj.Draw(); //Zeichnet das Element neu.
=== Beispiele zur Lib ===
Die Lib enthält Beispielcode für alle Elemente in der Datei main.c.
Um die Lib zu testen muss man lediglich die lcd.h wie oben beschrieben anpassen. ([[#Anpassen_der_lc7981.h_.28LCD.29]])
Danach kann man den Code kompilieren und mit "make program" übertragen. Der Programmer und Port können im Makefile angepasst werden.
(Die Lib ist standardmäßig für Linux eingerichtet.)

== Links ==
[http://www.roboternetz.de/phpBB2/zeigebeitrag.php?t=43741&postdays=0&postorder=asc&start=220 der Forumsbeitrag mit dem Alles begann] (Deutsch)

[http://www.frozeneskimo.com/electronics/2007/03/30/lc7981hd61830-driver-for-el-backlit-samsung-lcd/ Frozeneskimos Seite zum GLCD] (Englisch)

[http://www.mikrocontroller.net/topic/138095 Ein Beitrag auf Mikrocontroller.net] (Deutsch)

[http://sebastians-site.de/homepage/elektronik/avr-library-for-lc7981.html LCD-Lib] (Englisch)

[http://www.roboternetz.de/phpBB2/download.php?id=17948 Alternativer Schaltplan] von RN-User Flash2over

RN-Wissen.de - Benutzerbeiträge [de]

DG16080 GLCD