Auf dem KeplerOpenBOT Controller befindet sich ein Display, auf dem in sechs Zeilen jeweils 14 Zeichen ausgegeben werden können.
Der gewünschte Text wird mit der Funktion WRITE_LCD_TEXT() auf das Display geschrieben und muss in der Form eines Strings, der aus maximal 14 Zeichen besteht, übergeben werden.
Weiter wird von der Bibliothek auch eine Funktion bereitgestellt mit der es sehr einfach ist, die Werte von ganzzahligen Variablen anzeigen zu lassen.
Programmbeispiel - Anzeige von Text
In diesem Beispiel wird nach dem Start des Programms in der zweiten Zeile der Text "KeplerOpen-BOT" und in der vierten Zeile der Text "*Hello World*" angezeigt. Da sich dieser Text nicht laufend ändert, sondern nur einmal ausgegeben werden soll, kann die Ausgabe in der Funktion setup() erfolgen.
#include "KeplerOpenBOT.h"void setup(){KeplerOpenBOT_INIT();WRITE_LCD_CONTRAST(180);WRITE_LCD_TEXT(1,2,"KeplerOpenBOT");WRITE_LCD_TEXT(1,4,"*Hello World*");}void loop(){}
Erklärungen zu diesem Programmbeispiel
Zeile 6: WRITE_LCD_CONTRAST(180);
Die Funktion WRITE_LCD_CONTRAST(value) wird zur Einstellung des Kontrasts des Display verwendet. Die Verwendung dieser Funktion kann entfallen, wenn Zeichen am Display gut lesbar dargestellt werden. Als Standard-Wert wird bei der Initialisierung des Controllers der Kontrast auf den Wert 176 gestellt.
Aufgrund produktionstechnischer Unterschiede kann es jedoch sein, dass die Zeichen entweder zu schwach bis gar nicht angezeigt werden, oder die ganze Fläche des Displays dunkel erscheint und so die angezeigten Zeichen nicht erkennbar sind. In diesen Fällen muss der Kontrast an das jeweilige Display angepasst werden.
Der Parameter value kann Werte zwischen 160 und 180 annehmen. Der optimale Wert für das jeweilige Display ist durch Ausprobieren zu ermitteln.
Zeile 7: WRITE_LCD_TEXT(1, 1, "KeplerOpenBOT");
Die Funktion WRITE_LCD_TEXT(x, y, text) dient zur Ausgabe von Text am Display.
Der Parameter x gibt die gewünschte Spalte an und kann Werte zwischen 1 und 14 annehmen.
Mit dem Parameter y wird die gewünschte Zeile ausgewählt, die Werte können zwischen 1 und 6 liegen.
Der auszugebende Text wird als dritter Parameter text übergeben und muss mit zweifachen Anführungszeichen maskiert werden, z. B. "KeplerOpenBOT".