TCP/IP - Motion Detector Bricklet

This is the description of the TCP/IP protocol for the Motion Detector Bricklet. General information and technical specifications for the Motion Detector Bricklet are summarized in its hardware description.

API

A general description of the TCP/IP protocol structure can be found here.

Basic Functions

BrickletMotionDetector.get_motion_detected
Function ID:
  • 1
Request:
  • empty payload
Response:
  • motion – Type: uint8, Range: See meanings

Returns 1 if a motion was detected. How long this returns 1 after a motion was detected can be adjusted with one of the small potentiometers on the Motion Detector Bricklet, see here.

There is also a blue LED on the Bricklet that is on as long as the Bricklet is in the "motion detected" state.

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

For motion:

  • 0 = Not Detected
  • 1 = Detected

Advanced Functions

BrickletMotionDetector.set_status_led_config
Function ID:
  • 4
Request:
  • config – Type: uint8, Range: See meanings, Default: 2
Response:
  • no response

Sets the status led configuration.

By default the status LED turns on if a motion is detected and off is no motion is detected.

You can also turn the LED permanently on/off.

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

For config:

  • 0 = Off
  • 1 = On
  • 2 = Show Status

New in version 2.0.1 (Plugin).

BrickletMotionDetector.get_status_led_config
Function ID:
  • 5
Request:
  • empty payload
Response:
  • config – Type: uint8, Range: See meanings, Default: 2

Returns the configuration as set by set_status_led_config.

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

For config:

  • 0 = Off
  • 1 = On
  • 2 = Show Status

New in version 2.0.1 (Plugin).

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

Callbacks

BrickletMotionDetector.CALLBACK_MOTION_DETECTED
Function ID:
  • 2
Response:
  • empty payload

This callback is called after a motion was detected.

BrickletMotionDetector.CALLBACK_DETECTION_CYCLE_ENDED
Function ID:
  • 3
Response:
  • empty payload

This callback is called when the detection cycle ended. When this callback is called, a new motion can be detected again after approximately 2 seconds.