TiltSensor.md

Tilt Sensor

There are several modes to subscribe to sensor, providing 2-axis, 3-axis and bump detect data.

An example:

from pylgbst.hub import MoveHub, TiltSensor
import time

def callback(roll, pitch, yaw):
    print("Roll: %s / Pitch: %s / Yaw: %s" % (roll, pitch, yaw))

hub = MoveHub()

hub.tilt_sensor.subscribe(callback, mode=TiltSensor.MODE_3AXIS_ACCEL)
time.sleep(60) # turn MoveHub block in different ways
hub.tilt_sensor.unsubscribe(callback)

TiltSensor sensor mode constants:

• MODE_2AXIS_SIMPLE - use callback(state) for 2-axis simple state detect
• MODE_2AXIS_ANGLE - use callback(roll, pitch) for 2-axis roll&pitch degree values
• MODE_3AXIS_SIMPLE - use callback(state) for 3-axis simple state detect
• MODE_3AXIS_ACCEL - use callback(roll, pitch, yaw) for 3-axis roll&pitch&yaw degree values
• MODE_IMPACT_COUNT - use callback(count) to detect bumps

There are tilt sensor constants for "simple" states, for 2-axis mode their names are also available through TiltSensor.DUO_STATES:

• DUO_HORIZ - "HORIZONTAL"
• DUO_DOWN - "DOWN"
• DUO_LEFT - "LEFT"
• DUO_RIGHT - "RIGHT"
• DUO_UP - "UP"

For 3-axis simple mode map name is TiltSensor.TRI_STATES with values:

• TRI_BACK - "BACK"
• TRI_UP - "UP"
• TRI_DOWN - "DOWN"
• TRI_LEFT - "LEFT"
• TRI_RIGHT - "RIGHT"
• TRI_FRONT - "FRONT"