This page is part of archived documentation for openHAB 3.1. Go to the current stable version

# Leap Motion Binding

The Leap Motion (opens new window) controller is a gesture sensoring device that uses stereoscopic cameras and is connected through USB. As all processing is done in software, it requires quite some powerful computer, such that it unfortunately does not work on single-board computers such as the Raspberry Pi. In fact, the binding is currently only working on macOS computers with Intel x86 processors.

# Supported Things

There is a single thing of type controller defined and only one can be connected to the computer at a time.

# Discovery

The controller is automatically discovered if plugged into a USB port.

# Thing Configuration

The controller does not have any kind of configuration parameters.

# Channels

The controller has a single trigger channel gesture. It generates the following events with a frequency of at most 200ms:

Event Description
nohand No hand can be seen
tap A tap with a single finger
clockwise Rotating a finger clockwise
anticlockwise Rotating a finger anticlockwise
fingersX_YYY Hand showing X fingers in a height of YYY mm (where YYY can be 1-3 digits)

# Profiles

This binding specifies 3 profiles for the gesture channel to make it easy to link to existing items:

Profile Description
leapmotion:switch Simulates a toggle switch using the "tap" gesture
leapmotion:dimmer Sends percentage values and supports two modes (configuration parameter mode=fingers|height): - fingers: 20% for every shown finger, i.e. 0=0%, 1=20%, 2=40%, 3=60%, 4=80%, 5=100% - height: If hand shows all 5 fingers, its height above the controller determines the value. Higher is brighter.
leapmotion:color Controls a color item by - using taps for switching on and off - height of hand (with 5 fingers shown) to dim - rotating a finger to loop through the colors

# Full Example

demo.things:

Thing leapmotion:controller:1 MyLeapMotion

demo.items:

Switch DemoSwitch  "Switch"         { channel="leapmotion:controller:1:gesture" }
Color  RGBLight    "RGB Light"      { channel="leapmotion:controller:1:gesture" }
Dimmer DimmedLight "Dimmer [%d %%]" { channel="leapmotion:controller:1:gesture"[profile="leapmotion:dimmer", mode="fingers"] }