home-assistant.io/source/_components/switch.rpi_gpio.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release	ha_iot_class
page	Raspberry PI GPIO Switch	Instructions how to integrate the GPIO of a Raspberry PI into Home Assistant as a switch.	2015-08-07 14:00	true	false	true	true	raspberry-pi.png	Switch	pre 0.7	Local Push

The rpi_gpio switch platform allows you to control the GPIOs of your Raspberry Pi.

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

# Example configuration.yaml entry
switch:
  - platform: rpi_gpio
    ports:
      11: Fan Office
      12: Light Desk

Configuration variables:

• ports array (Required): Array of used ports.
  • port: name (Required): Port numbers and corresponding names (GPIO #).
• invert_logic (Optional): If true, inverts the output logic to ACTIVE LOW. Default is false (ACTIVE HIGH).
• shared_gpio (Optional): If true, forces a GPIO.setup() before each write. Default is false.

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

A common question is what does Port refer to, this number is the actual GPIO # not the pin #. For example, if you have a relay connected to pin 11 its GPIO # is 17.

# Example configuration.yaml entry
switch:
  - platform: rpi_gpio
    ports:
      17: Speaker Relay

In case you have any other python scripts running that use RPi.GPIO no values will be written after the initial HASS-start. Setting shared_gpio to true will reinit the pin before each write, working around this issue.

# Example configuration.yaml entry
switch:
  - platform: rpi_gpio
    shared_gpio: true
    ports:
      19: LED-Red