2025.3.4
首页 ▸ Integrations ▸

Raspberry Pi 远程 GPIO

remote_rpi_gpio integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 是 Home Assistant 中所有相关 GPIO 平台的基础。有关平台配置，请查看相应的章节。

远程 Raspberry Pi 和运行 Home Assistant 的控制计算机必须配置为能够运行 remote_rpi_gpio，有关详细信息，请参见 配置远程 GPIO。不幸的是，目前不支持使用远程 Raspberry Pi 5 主机，由于在 pigiod 中缺乏支持。

请注意，对于虚拟环境，在启动环境时可能需要设置环境变量以设置引脚工厂，例如：

环境 = GPIOZERO_PIN_FACTORY=pigpio PIGPIO_ADDR=YOUR_RPi_IP_ADDRESS

二进制传感器

remote_rpi_gpio 二进制传感器 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许您读取远程 Raspberry Pi 的 GPIO 的传感器值。

要在您的安装中使用远程 Raspberry Pi 的 GPIO，请将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 示例 configuration.yaml 条目
binary_sensor:
  - platform: remote_rpi_gpio
    host: 远程_PI的_IP_ADDRESS
    ports:
      11: 办公室 PIR
      12: 卧室 PIR

Configuration Variables

Looking for your configuration file?
host string Required

远程 Raspberry Pi 的 IP 地址。

ports map Required

使用的端口列表。

port: name string Required

端口号（BCM 模式引脚号）及其对应名称。

invert_logic boolean (Optional)

如果为 true，则反转输出逻辑

Default:

false (活动高)

pull_mode string (Optional, default: UP)

使用的内部拉升电阻类型。 选项为 UP - 拉升电阻和 DOWN - 下拉电阻。 拉升默认活动低，下拉默认活动高。可以通过 invert_logic 调整

有关 GPIO 布局的更多详细信息，请访问维基百科关于 Raspberry Pi 的 文章。

开关

remote_rpi_gpio 开关平台允许您控制远程 Raspberry Pi 的 GPIO。

要在您的安装中使用远程 Raspberry Pi 的 GPIO，请将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件：

# 示例 configuration.yaml 条目
switch:
  - platform: remote_rpi_gpio
    host: 远程_PI的_IP_ADDRESS
    ports:
      11: 办公室风扇
      12: 桌子灯

Configuration Variables

Looking for your configuration file?
host string Required

远程 Raspberry Pi 的 IP 地址。

ports list Required

使用端口的数组。

port integer | string Required

端口号及其对应名称（GPIO

invert_logic boolean (Optional, default: false)

如果为 true，则将输出逻辑反转为活动低。

有关 GPIO 布局的更多详细信息，请访问维基百科关于 Raspberry Pi 的 文章。

Note

请注意，由 Home Assistant 管理的引脚预计将专属于 Home Assistant。

一个常见问题是端口指的是什么？这个数字是实际的 GPIO #，而不是引脚 #。 例如，如果您将继电器连接到引脚 11，其 GPIO # 是 17。

# 示例 configuration.yaml 条目
switch:
  - platform: remote_rpi_gpio
    host: 192.168.0.123
    ports:
      17: 扬声器继电器

故障排除

如果您收到错误信息，例如 gpiozero.exc.BadPinFactory: Unable to load any default pin factory!，请尝试将 GPIOZERO_PIN_FACTORY 环境变量从 pigpio 更改为 mock，因为这解决了一个 已知问题。

相关主题