TCP/IP - Segment Display 4x7 Bricklet

Dies ist die Beschreibung des TCP/IP Protokolls für das Segment Display 4x7 Bricklet. Allgemeine Informationen über die Funktionen und technischen Spezifikationen des Segment Display 4x7 Bricklet sind in dessen Hardware Beschreibung zusammengefasst.

API

Eine allgemeine Beschreibung der TCP/IP Protokollstruktur findet sich hier.

Grundfunktionen

BrickletSegmentDisplay4x7.set_segments
Funktions ID:

1

Anfrage:
  • segments -- uint8[4]
  • brightness -- uint8
  • colon -- bool
Antwort:

keine Antwort

Die 7-Segment-Anzeige kann mit Bitmaps gesetzt werden. Jedes Bit kontrolliert ein Segment:

Bitreihenfolge eines Segments

Beispiel: Um eine "5" auf der Anzeige darzustellen müssen die Segment 0, 2, 3, 5 und 6 aktiviert werden. Dies kann mit der Zahl 0b01101101 = 0x6d = 109 repräsentiert werden.

Die Helligkeit kann zwischen 0 (dunkel) und 7 (hell) gesetzt werden. Der dritte Parameter aktiviert/deaktiviert den Doppelpunkt auf der Anzeige.

BrickletSegmentDisplay4x7.get_segments
Funktions ID:

2

Anfrage:

keine Nutzdaten

Antwort:
  • segments -- uint8[4]
  • brightness -- uint8
  • colon -- bool

Gibt die Segment-, Helligkeit- und Doppelpunktdaten zurück, wie von set_segments gesetzt.

Fortgeschrittene Funktionen

BrickletSegmentDisplay4x7.start_counter
Funktions ID:

3

Anfrage:
  • value_from -- int16
  • value_to -- int16
  • increment -- int16
  • length -- uint32
Antwort:

keine Antwort

Starter einen Zähler mit dem from Wert der bis zum to Wert Zählt mit einer Schrittweite von increment. Das Argument length gibt die Pause zwischen den Erhöhungen in ms an.

Beispiel: Wenn from auf 0, to auf 100, increment auf 1 und length auf 1000 gesetzt wird, wird ein Zähler gestartet der von 0 bis 100 zählt mit Rate von einer Sekunde zwischen jeder Erhöhung.

Der Maximalwert für from, to und increment ist 9999, der Minimalwert ist -999.

Wenn das increment negativ ist läuft der Zähler rückwärts.

Der Zähler kann jederzeit durch einen Aufruf von set_segments gestoppt werden.

BrickletSegmentDisplay4x7.get_counter_value
Funktions ID:

4

Anfrage:

keine Nutzdaten

Antwort:
  • value -- uint16

Gibt den aktuellen Zählerstand zurück der auf der Anzeige angezeigt wird.

Wenn kein Zähler am laufen ist wird eine 0 zurückgegeben.

BrickletSegmentDisplay4x7.get_identity
Funktions ID:

255

Anfrage:

keine Nutzdaten

Antwort:
  • uid -- char[8]
  • connected_uid -- char[8]
  • position -- char
  • hardware_version -- uint8[3]
  • firmware_version -- uint8[3]
  • device_identifier -- uint16

Gibt die UID, die UID zu der das Bricklet verbunden ist, die Position, die Hard- und Firmware Version sowie den Device Identifier zurück.

Die Position kann 'a', 'b', 'c' oder 'd' sein.

Eine Liste der Device Identifier Werte ist hier zu finden. 

Callbacks

BrickletSegmentDisplay4x7.CALLBACK_COUNTER_FINISHED
Funktions ID:5
Antwort:keine Nutzdaten

Diese Callback wird ausgelöst, wenn der Zähler (siehe start_counter) fertig ist.