home-assistant.io/source/components/sensor.rpi_gpio.markdown

layout	title	description	date	sidebar	comments	sharing	footer
page	Raspberry PI GPIO sensor support	Instructions how to integrate the GPIO sensor capability of a Raspberry PI into Home Assistant.	2015-08-30 19:00	false	false	true	true

The rpi_gpio sensor platform allows you to read sensor values of the GPIOs of your [Raspberry Pi](https://www.raspberrypi.org/).

To use your Raspberry Pi's GPIO in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  platform: rpi_gpio
  ports:
    11: PIR Office
    12: PIR Bedroom
  pull_mode: "UP"
  value_high: "Active"
  value_low: "Inactive"

Configuration variables:

• ports array (Required): Array of used ports.
  • port: name (Required): Your username for the Edimax switch.
• pull_mode (Optional): The internal pull to use (UP or DOWN). Default is UP.
• value_high (Optional): The value of the sensor when the port is HIGH. Default is "HIGH".
• value_low (Optional): The value of the sensor when the port is LOW. Default is "LOW".
• bouncetime (Optional): The time in milliseconds for port debouncing. Default is 50ms.

For more details about the GPIO layout, visit the Wikipedia article about the Raspberry Pi.

If you are not running Raspbian Jessie, you will need to run Home Assistant as root.

To avoid having to run Home Assistant as root when using this component, run a Raspbian version released at or after September 29, 2015.