LCD.C2 V1.2 - Hilfe


Beschreibung

Einfügen als System-Modul

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