Home Assistant Raspberry Pi GPIO集成指南

Home Assistant Raspberry Pi GPIO集成指南

ha-rpi_gpioHome Assistant Raspberry Pi GPIO Integration项目地址:https://gitcode.com/gh_mirrors/ha/ha-rpi_gpio

1. 目录结构及介绍

此开源项目位于GitHub上，致力于为Home Assistant提供Raspberry Pi GPIO的自定义集成。以下是其主要的目录结构和关键文件介绍：

• custom_components

  • rpi_gpio
    • 包含了核心功能实现的Python代码。
    • __init__.py: 初始化文件，引入组件。
    • binary_sensor.py, cover.py, switch.py: 分别对应二进制传感器、覆盖（如车库门控制）和开关功能的实现。
    • manifest.json: 描述组件信息，如名称、版本、依赖等。

• hacs.json: 用于HACS（Home Assistant Community Store）的配置文件，便于通过HACS安装。

• info.md, readme.md: 提供项目简介、安装步骤、使用说明等重要信息。

• pre-commit-config.yaml: 自动代码检查配置，确保提交的代码质量。

• requirements_lint.txt: 列出了项目运行所需的第三方库。

2. 项目启动文件介绍

在本项目中，并没有一个传统意义上的“启动文件”，因为它的集成方式是作为Home Assistant的自定义组件添加到现有系统中。激活功能的关键在于修改HA的配置文件（通常位于configuration.yaml），而非直接执行某个脚本或文件。比如，要启用GPIO作为二进制传感器，需在configuration.yaml中加入对应的平台配置。

3. 项目的配置文件介绍

配置文件的基本用法

二进制传感器配置示例

在configuration.yaml中加入以下部分以设置一个名为“PIR Office”的传感器，监测GPIO 11的状态：

binary_sensor:
  - platform: rpi_gpio
    sensors:
      - port: 11
        name: "PIR Office"

开关配置示例

对于开关，例如控制一个连接到GPIO 17的继电器：

switch:
  - platform: rpi_gpio
    switches:
      - port: 17
        name: "Speaker Relay"

请注意，配置时提及的端口号（如“port: 11”）指的是逻辑GPIO编号，而非物理针脚号，这非常重要，以避免混淆。

通过上述配置，您可以在Home Assistant中利用Raspberry Pi的GPIO接口进行多种设备控制和状态监控，无需直接涉及本项目内部的具体启动文件操作。每次对配置文件所做的更改都需要Home Assistant重启来生效。

ha-rpi_gpioHome Assistant Raspberry Pi GPIO Integration项目地址:https://gitcode.com/gh_mirrors/ha/ha-rpi_gpio