Modbus - Tilt Bricklet

Dies ist die Beschreibung des Modbus Protokolls für das Tilt Bricklet. Allgemeine Informationen über die Funktionen und technischen Spezifikationen des Tilt Bricklet sind in dessen Hardware Beschreibung zusammengefasst.

API

Eine allgemeine Beschreibung der Modbus Protokollstruktur findet sich hier.

Grundfunktionen

BrickletTilt.get_tilt_state
Funktions ID:

1

Anfrage:

keine Nutzdaten

Antwort:
  • state -- uint8

Gibt den aktuellen Tilt-Zustand zurück. Der Zustand kann folgende Werte annehmen:

  • 0 = Closed: Der Ball im Neigungsschalter schließt den Stromkreis.
  • 1 = Open: Der Ball im Neigungsschalter schließt den Stromkreis nicht.
  • 2 = Closed Vibrating: Der Neigungsschalter ist in Bewegung (schnelle Änderungen zwischen open und close).
Tilt-Zustände

Die folgenden Bedeutungen sind für die Parameter dieser Funktion definiert:

  • 0: closed, für state
  • 1: open, für state
  • 2: closed vibrating, für state

Fortgeschrittene Funktionen

BrickletTilt.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. 

Konfigurationsfunktionen für Callbacks

BrickletTilt.enable_tilt_state_callback
Funktions ID:2
Anfrage:keine Nutzdaten
Antwort:keine Antwort

Aktiviert den CALLBACK_TILT_STATE Callback.

BrickletTilt.disable_tilt_state_callback
Funktions ID:3
Anfrage:keine Nutzdaten
Antwort:keine Antwort

Deaktiviert den CALLBACK_TILT_STATE Callback.

BrickletTilt.is_tilt_state_callback_enabled
Funktions ID:

4

Anfrage:

keine Nutzdaten

Antwort:
  • enabled -- bool

Gibt true zurück wenn der CALLBACK_TILT_STATE Callback aktiviert ist.

Callbacks

BrickletTilt.CALLBACK_TILT_STATE
Funktions ID:

5

Antwort:
  • state -- uint8

Dieser Callback übergibt den aktuellen Tilt-Status. Der Callback wird aufgerufen wenn sich der Status ändert.

Siehe get_tilt_state für eine Beschreibung der Zustände.

Die folgenden Bedeutungen sind für die Parameter dieser Funktion definiert:

  • 0: closed, für state
  • 1: open, für state
  • 2: closed vibrating, für state