home-assistant.io/source/_components/remote_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	Remote Raspberry Pi GPIO	Instructions on how to integrate the GPIO capability of a Remote Raspberry Pi into Home Assistant.	2019-02-20 19:00	true	false	true	true	raspberry-pi.png	DIY Binary Sensor Switch	0.94	Local Push

The rpi_gpio component is the base for all related GPIO platforms in Home Assistant. There is no setup needed for the component itself, for the platforms please check their corresponding pages.

{% linkable_title Binary Sensor %}

The remote_rpi_gpio binary sensor platform allows you to read sensor values of the GPIOs of a Remote Raspberry Pi.

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

# Example configuration.yaml entry
binary_sensor:
  - platform: remote_rpi_gpio
    address: <address of remote pi>
    ports:
      11: PIR Office
      12: PIR Bedroom
      
switch:
  - platform: remote_rpi_gpio
    address: <address of remote pi>
    ports:
      4: Garage Relay

{% configuration %} address: description: IP Address of remote Raspberry Pi required: true type: string ports: description: List of used ports. required: true type: map keys: "port: name": description: The port numbers (BCM mode pin numbers) and corresponding names. required: true type: string invert_logic: description: If true, inverts the output logic required: false type: boolean default: "false (ACTIVE HIGH)" pull_mode: description: > Type of internal pull resistor to use. Options are UP - pull-up resistor and DOWN - pull-down resistor. Pull-Up defaults to active LOW and Pull-down defaults to active HIGH. This can be adjusted with invert_logic required: false type: string default: "UP" {% endconfiguration %}

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

{% linkable_title Switch %}

The remote_rpi_gpio switch platform allows you to control the GPIOs of a Remote Raspberry Pi.

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

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

{% configuration %} address: description: IP Address of remote Raspberry Pi required: true type: string ports: description: Array of used ports. required: true type: list keys: port: description: Port numbers and corresponding names (GPIO #). required: true type: [integer, string] invert_logic: description: If true, inverts the output logic to ACTIVE LOW. required: false default: false type: boolean {% endconfiguration %}

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

Note that a pin managed by HASS is expected to be exclusive to HASS.

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: remote_rpi_gpio
    address: 192.168.0.123
    ports:
      17: Speaker Relay