Funktionen:
init
ready()
showcursor()
clear()
clreol()
goto()
home()
scroll()
put()
print()
Beschreibung Nach oben
Das Modul lcd.c2 erlaubt den einfachen Zugriff auf das interne
LCD der C-Control II Unit.
Ab Version 1.2 ist das I²C-Capture implementiert.
Einfügen als System-Modul Nach oben
Die Datei lcd.c2 in das Verzeichnis .\CControl2\Lib
über die alte Version
des Moduls kopieren.
Funktionen:
Initialisierung Nach oben
function init()
Die Funktion Init initialisiert das Dispaly. Bis einschließlich
osopt_V2 wird
dies bereits automatisch beim System-Reset durchgeführt und muß
in der Regel nicht im Anwenderprogramm vorgenommen werden.
ready() Nach oben
function ready() returns int
Mit der Funktion ready() prüft nicht, wie im Handbuch zur CC2
angegeben,
ausgabebereitschaft des LC-Displays, sondern lediglich, ob der I²C-Bus
beweit ist und gibt somit den Zustand des I²C-Captures zurück.
Daher wird diese Funktion nicht benötigt.
showcursor() Nach oben
function showcursor(int yesno)
Mit dieser Funktion kann der Zustand des Cursors bestimmt werden.
yesno | =0 (False): Cursor unsichtbar !=0 (True) : Cursor sichtbar |
clear() Nach oben
function clear()
Mit clear() wird der Inhalt des Displays gelöscht.
clreol() Nach oben
function clreol()
Mit clreol() wird der Inhalt des Displays von der aktuellen
Cursorposition bis zum Zeilenende gelöscht.
goto() Nach oben
function goto(int line, int pos)
Die Funktion goto() setzt den Cursor auf die angegebene Position.
Die Numerierung von line und pos beginnt bei 0. Die Position
links oben ist also (0,0).
line | Zeile: 0=Zeile 1, 1= Zeile 2 |
pos | Spalte 0 bis 7 |
home() Nach oben
function home()
Die Funktion home() setzt den Cursor auf die anfangsposition links
oben.
Mögliche Verschiebungen durch Scollen werden zurückgesetzt
scroll() Nach oben
function scroll(int pos)
Die Funktion scroll() stellt den Displayinhalt um pos Stellen verschoben dar.
pos | Anzahl zu scrollender Zeichen |
put() Nach oben
function put(byte c)
Die Funktion put() schreibt ein einzelnes Zeichen (ASCII-Code)
an
die aktuelle Cursorposition. Der Cursorposition wird dabei um eins inkrementiert.
c | ASCII-Zeichencode (0-255) |
print() Nach oben
function print(byte buf[], int length)
Mit der Funktion send() werden Zeichen aus einer Bytepuffervariabel
(& Strings) ab
der aktuellen Cursorposition ausgegeben. Zeichen, die nicht mehr in die aktuelle
Zeile
passenm, werden abgeschnitten.
Die Ausgabe erfolgt im Hintergrund. D.h. die Funktion übergibt lediglich die
Adresse
und die zu schreibende Länge des Ausgabepuffers und startet die Ausgabe.
Daher sollte die auzugebende Variable statisch sein.
buf[] | Byte-Array oder String mit den zu sendenden Daten |
length | Anzahl der zu sendenden Bytes |
Autor: André Helbig Mail: andre.h@cc2net.de
Erstellt: 28.07.2003