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

# GPIO Binding

This binding adds GPIO support via the pigpio daemon to openhab. It requires the pigpio (http://abyz.me.uk/rpi/pigpio/ (opens new window)) to be running on the pi that should be controlled.

# Supported Things

# pigpio-remote

This thing represents a remote pigpio instance running as daemon on a raspberry pi.

# Thing Configuration

# Pigpio Remote (pigpio-remote)

On a raspberry (or a compatible device) you have to install pigpio:

sudo apt-get install pigpiod
sudo raspi-config 

-> Interfacing Options --> Remote GPIO --> YES --> OK --> Finish

Note: if you are setting this up on a Raspberry Pi without raspi-config you can create the service config file manually:

sudo mkdir -p /etc/systemd/system/pigpiod.service.d/
sudo nano /etc/systemd/system/pigpiod.service.d/public.conf
[Service]
ExecStart=
ExecStart=/usr/bin/pigpiod
sudo systemctl daemon-reload

Now that Remote GPIO is enabled, get the daemon going (even if installed with apt-get):

sudo systemctl enable pigpiod 
sudo systemctl start pigpiod

In openHAB, set host to the address of the pi and the port to the port of pigpio (default: 8888).

Note: If you are running Pigpio on same host as openHAB, then set host to ::1.

# Channels

# Pigpio Remote

channel type description
pigpio-digital-input Switch Read-only value of the gpio pin
pigpio-digital-output Switch Controls the gpio pin

# GPIO digital input channel

Set the number of the pin in gpioId. If you want to invert the value, set invert to true. To prevent incorrect change events, you can adjust the debouncingTime. Using pullupdown you can enable pull up or pull down resistor (OFF = Off, DOWN = Pull Down, UP = Pull Up).

# GPIO digital output channel

Set the number of the pin in gpioId. If you want to invert the value, set invert to true.

# Full Example

demo.things:

Thing gpio:pigpio-remote:sample-pi-1 "Sample-Pi 1" [host="192.168.2.36", port=8888] {
    Channels:
        Type pigpio-digital-input : sample-input-1 [ gpioId=10]
        Type pigpio-digital-input : sample-input-2 [ gpioId=14, invert=true]
        Type pigpio-digital-output : sample-output-1 [ gpioId=3]
}

Thing gpio:pigpio-remote:sample-pi-2 "Sample-Pi 2" [host="192.168.2.37", port=8888] {
    Channels:
        Type pigpio-digital-input : sample-input-3 [ gpioId=16, debouncingTime=20]
        Type pigpio-digital-input : sample-input-4 [ gpioId=17, invert=true, debouncingTime=5, pullupdown="UP"]
        Type pigpio-digital-output : sample-output-2 [ gpioId=4, invert=true]
}

demo.items:

Switch SampleInput1 {channel="gpio:pigpio-remote:sample-pi-1:sample-input-1"}
Switch SampleOutput1 {channel="gpio:pigpio-remote:sample-pi-1:sample-output-1"}

demo.sitemap:

sitemap demo label="Main Menu"
{
    Switch item=SampleInput1
    Switch item=SampleOutput1
}