Funktionen der Library MyHT16K33_7Seg
MyHT16K33_7Seg MyHT16K33_7Seg(byte i2cAdd)
Funktion: Erzeugt eine neue Instanz
Parameter: i2cAdd: I2C-Adresse des Bauteils
bool isReady(void)
Funktion: Überprüft, ob die 7-Segmentanzeige über I2C-Schnittstelle ansprechbar ist
Parameter: keine
Rückgabe: TRUE, wenn Sensor ansprechbar ist, sonst FALSE
Bemerkung: Die Funktion prüft nur, ob in einem I2C-Bus der Bauteil ansprechbar bzw. vorhanden ist. Es wird vorausgesetzt, dass der I2C-Bus technisch prinzipiell funktioniert (keine offenen Busleitungen, Pullup-Widerstände richtig, kein Kurzschluss oder Masseschluss, etc.).
void init(void)
Funktion: Initialisierung des HT16K33 LED-Treibers
Parameter: keine
Rückgabe: keine
void setBrightness(byte wert)
Funktion: Einstellen der Helligkeit der Anzeige
Parameter: wert: Helligkeitswert (0 <= wert <= 16), 0..dunkelst, 16..hellst
Rückgabe: keine
void setOperationMode(byte mode)
Funktion: Einstellen des Betriebsmodus
Parameter: mode: Betriebsmodus der Anzeige
HT16K33_DISPLAY_NORMAL: Display im Normalbetrieb-Modus
HT16K33_DISPLAY_STANDBY: Display im Standby-Modus
Rückgabe: keine
Bemerkung: Der Stromverbrauch beträgt im Standby-Modus laut Datenblatt nur mehr 1 µA (max. 10 µA). Meine eigene Messung ergab ca. 1,2 µA. Nach dem Wiedereinschaltent der Anzeige mit setOperationMode(HT16K33_DISPLAY_NORMAL) wird der ursprüngliche Anzeigeinhalt wieder sichtbar.
void setDisplayMode(byte mode)
Funktion: Einstellen des Anzeigezeigemodus
Parameter: mode: Anzeigemodus
HT16K33_DISPLAY_OFF: Display ausgeschaltet
HT16K33_DISPLAY_ON: Display eingeschaltet
HT16K33_DISPLAY_BLINK_1: Display blinken mit 1 Hz
HT16K33_DISPLAY_BLINK_2: Display blinken mit 2 Hz
HT16K33_DISPLAY_BLINK_0p5: Display blinken mit 0,5 Hz
Rückgabe: keine
Bemerkung: Im Gegensatz zur Funktion sendBlank() wird mit der Funktion setDisplayMode(HT16K33_DISPLAY_OFF) die Anzeige nur ausgeschaltet, der Anzeigeinhalt aber nicht gelöscht. Nach dem Wiedereinschaltent der Anzeige mit setDisplayMode(HT16K33_DISPLAY_ON) wird der ursprüngliche Anzeigeinhalt wieder sichtbar.
void sendBlank(void)
Funktion: Dunkelsetzen der gesamten Anzeige
Parameter: keine
Rückgabe: keine
Bemerkung: Im Gegensatz zur Funktion setDisplayMode(HT16K33_DISPLAY_OFF) wird mit der Funktion sendBlank() der Anzeigeinhalt gelöscht!
bool statusBlank(void)
Funktion: Abfrage ob Anzeige dunkel gesetzt ist
Parameter: keine
Rückgabe: TRUE, wenn dunkel, sonst FALSE
Bemerkung: Rückgabe ist nur dann TRUE, wenn das Display mit der Funktion sendBlank() dunkelgesetzt wurde!
void test7Seg(void)
Funktion: Segmenttest, alle Segmente leuchten 1 Sekunde
Parameter: keine
Rückgabe: keine
void sendFloatVal(float zahl)
Funktion: Anzeigen eines gerundeten Fließkommawertes (angezeigt werden immer 4 Digits)
Parameter: zahl: Zahl die angezeigt werden soll (-999 <= zahl <= 9999)
Rückgabe: keine
void sendFixedVal(int zahl, byte nkomma, bool vorNull)
Funktion: Anzeigen eine Festkommawertes, Rundung muss im aufrufenden Programm erfolgen!!
Parameter: zahl: Zahl die angezeigt werden soll (-999 <= Zahl <= 9999)
nkomma: Anzahl der Nachkommastellen (0 <= nkomma <= 3),
vorNull: TRUE, wenn Vornullen unterdrückt werden sollen, sonst FALSE
Rückgabe: keine
void sendDigit(byte tau, byte hun, byte zeh, byte ein, byte kommaSt)
Funktion: Beliebige Anzeige von Ziffern und Komma
Parameter: tau: Tausenderstelle (0 <= tau <= 9) für Ziffer, ' ' für Dunkel
hun: Hunderterstelle (0 <= hun <= 9) für Ziffer, ' ' für Dunkel
zeh: Zehnerstelle (0 <= zeh <= 9) für Ziffer, ' ' für Dunkel
ein: Einerstelle (0 <= ein <= 9) für Ziffer, ' ' für Dunkel
kommaSt: Gibt an, welche Kommastelle angezeigt werden soll (0 <= kommaSt <= 4)
(0..Keine Kommastelle, 1..Komma am 1er-Digit, ... 4..Komma am 1000er Digit)
Rückgabe: keine
void sendTime(byte zahl1, byte zahl2)
Funktion: Anzeigen von 2 Zahlen im Uhrzeitformat, entweder "Stunde:Minute" oder "Minute:Sekunde"
Parameter: zahl1: Zahl für Stunde oder Minute
zahl2: Zahl für Minute oder Sekunde
Rückgabe: keine
Bemerkung: Die Funktion ermittelt nicht die aktuelle Uhrzeit, sondern stellt die z.B. mit einem Uhrzeitmodul ermittelte Uhrzeit auf der Anzeige dar.
void sendChar(char tauZ, char hunZ, char zehZ, char einZ)
Funktion: Anzeigen von vier einzelnen Zeichen (Zahlen und/oder Buchstaben)
Parameter: tauZ: Tausenderstelle Zeichen (Zahl oder Buchstabe)
hunZ: Hunderterstelle Zeichen (Zahl oder Buchstabe)
zehZ: Zehnerstelle Zeichen (Zahl oder Buchstabe)
einZ: Einerstelle Zeichen (Zahl oder Buchstabe)
Rückgabe: keine
Bemerkung: Anzeige von Zeichen soweit mit 7-Segmentanzeige darstellbar
void sendString(char* chArr)
Funktion: Anzeigen von vier einzelnen Zeichen (Zahlen und/oder Buchstaben)
Parameter: chArr: Char-Array mit 4 Zeichen(Zahlen oder Buchstaben)
Rückgabe: keine
Bemerkung: Anzeige von Zeichen soweit mit 7-Segmentanzeige darstellbar