mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-26 15:21:41 +01:00
2b353efdc2
Signed-off-by: Ciprian Pascu <contact@ciprianpascu.ro> |
||
---|---|---|
.. | ||
src/main | ||
DEVELOPERS.md | ||
NOTICE | ||
pom.xml | ||
README.md |
OpenHAB SBUS Binding
This binding integrates SBUS devices with OpenHAB, allowing control and monitoring of SBUS-compatible devices over UDP.
Supported Things
- SBUS Bridge (Thing Type:
bridge-udp
) - RGB/RGBW Controllers
- Temperature Sensors
- Switch Controllers
Installation
Install this binding through the OpenHAB console:
bundle:install org.openhab.binding.sbus
Configuration
Bridge Configuration
The SBUS Bridge requires the following configuration parameters:
host
- IP address of the SBUS deviceport
- UDP port number (default: 5000)
Example:
Bridge sbus:udp:mybridge [ host="192.168.1.255", port=5000 ]
Please note the broadcast address. This is how Sbus devices communicate with each other.
Thing Configuration
RGBW Controller
Thing rgbw colorctrl [ id=72, refresh=30 ] {
Channels:
Type color-channel : color [ channelNumber=1 ] // HSB color picker, RGBW values stored at channel 1
Type switch-channel : power [ channelNumber=1 ] // On/Off control for the RGBW output.
}
Supported channels:
color
- HSB color picker that controls:- Red component (0-100%)
- Green component (0-100%)
- Blue component (0-100%)
- White component (0-100%)
power
- On/Off control for the RGBW output with optional timer
Temperature Sensor
Thing temperature temp1 [ id=62, refresh=30 ] {
Channels:
Type temperature-channel : temperature [ channelNumber=1 ]
}
Supported channels:
temperature
- Current temperature reading
Switch Controller
Thing switch switch1 [ id=75, refresh=30 ] {
Channels:
Type switch-channel : first_switch [ channelNumber=1 ]
Type dimmer-channel : second_switch [ channelNumber=2 ]
Type paired-channel : third_switch [ channelNumber=3 ]
}
Supported channels:
switch
- ON/OFF statedimmer
- ON/OFF state with timer transitionpaired
- ON/OFF state for two paired channels. This feature is used for curtains and other devices that require two actuator channels.
Example Usage
items/sbus.items:
Number:Temperature Temp_Sensor "Temperature [%.1f °C]" { channel="sbus:temperature:mybridge:temp1:temperature" }
Switch Light_Switch "Switch" { channel="sbus:switch:mybridge:switch1:switch" }
Example: RGBW Controller with Power Control
// Light Group
Group gLight "RGBW Light" <light> ["Lighting"]
// Color Control
Color rgbwColor "Color" <colorwheel> (gLight) ["Control", "Light"] { channel="sbus:rgbw:mybridge:colorctrl:color" }
// Power Control
Switch rgbwPower "Power" <switch> (gLight) ["Switch", "Light"] { channel="sbus:rgbw:mybridge:colorctrl:power" }
sitemap/sbus.sitemap:
sitemap sbus label="SBUS Demo"
{
Frame label="SBUS Controls" {
Colorpicker item=Light_RGB
Text item=Temp_Sensor
Switch item=Light_Switch
}
}