Modbus - Tilt Bricklet

This is the description of the Modbus protocol for the Tilt Bricklet. General information and technical specifications for the Tilt Bricklet are summarized in its hardware description.

API

A general description of the Modbus protocol structure can be found here.

Basic Functions

BrickletTilt.get_tilt_state
Function ID:
  • 1
Request:
  • empty payload
Response:
  • state – Type: uint8, Range: See meanings

Returns the current tilt state. The state can either be

  • 0 = Closed: The ball in the tilt switch closes the circuit.
  • 1 = Open: The ball in the tilt switch does not close the circuit.
  • 2 = Closed Vibrating: The tilt switch is in motion (rapid change between open and close).
Tilt states

The following meanings are defined for the elements of this function:

For state:

  • 0 = Closed
  • 1 = Open
  • 2 = Closed Vibrating

Advanced Functions

BrickletTilt.get_identity
Function ID:
  • 255
Request:
  • empty payload
Response:
  • uid – Type: char[8]
  • connected_uid – Type: char[8]
  • position – Type: char, Range: ['a' to 'h', 'z']
  • hardware_version – Type: uint8[3]
    • 0: major – Type: uint8, Range: [0 to 255]
    • 1: minor – Type: uint8, Range: [0 to 255]
    • 2: revision – Type: uint8, Range: [0 to 255]
  • firmware_version – Type: uint8[3]
    • 0: major – Type: uint8, Range: [0 to 255]
    • 1: minor – Type: uint8, Range: [0 to 255]
    • 2: revision – Type: uint8, Range: [0 to 255]
  • device_identifier – Type: uint16, Range: [0 to 216 - 1]

Returns the UID, the UID where the Bricklet is connected to, the position, the hardware and firmware version as well as the device identifier.

The position can be 'a', 'b', 'c', 'd', 'e', 'f', 'g' or 'h' (Bricklet Port). A Bricklet connected to an Isolator Bricklet is always at position 'z'.

The device identifier numbers can be found here

Callback Configuration Functions

BrickletTilt.enable_tilt_state_callback
Function ID:
  • 2
Request:
  • empty payload
Response:
  • no response

Enables the CALLBACK_TILT_STATE callback.

BrickletTilt.disable_tilt_state_callback
Function ID:
  • 3
Request:
  • empty payload
Response:
  • no response

Disables the CALLBACK_TILT_STATE callback.

BrickletTilt.is_tilt_state_callback_enabled
Function ID:
  • 4
Request:
  • empty payload
Response:
  • enabled – Type: bool, Default: false

Returns true if the CALLBACK_TILT_STATE callback is enabled.

Callbacks

BrickletTilt.CALLBACK_TILT_STATE
Function ID:
  • 5
Response:
  • state – Type: uint8, Range: See meanings

This callback provides the current tilt state. It is called every time the state changes.

See get_tilt_state for a description of the states.

The following meanings are defined for the elements of this function:

For state:

  • 0 = Closed
  • 1 = Open
  • 2 = Closed Vibrating