Home Assistant 配置项目教程

Home Assistant 配置项目教程

Home-AssistantConfig项目地址:https://gitcode.com/gh_mirrors/home/Home-AssistantConfig

1. 项目的目录结构及介绍

Home-AssistantConfig/
├── automations/
│   ├── example_automation.yaml
│   └── ...
├── scripts/
│   ├── example_script.yaml
│   └── ...
├── scenes/
│   ├── example_scene.yaml
│   └── ...
├── packages/
│   ├── example_package.yaml
│   └── ...
├── www/
│   ├── custom_ui/
│   └── ...
├── configuration.yaml
├── secrets.yaml
├── customize.yaml
├── groups.yaml
├── home-assistant_v2.db
└── ...

目录结构介绍

• automations/: 存放自动化脚本的目录，每个自动化脚本通常是一个独立的 YAML 文件。
• scripts/: 存放自定义脚本的目录，每个脚本通常是一个独立的 YAML 文件。
• scenes/: 存放场景配置的目录，每个场景通常是一个独立的 YAML 文件。
• packages/: 存放打包配置的目录，可以将多个配置文件打包成一个文件。
• www/: 存放自定义 UI 文件的目录，通常用于存放自定义的网页或 UI 组件。
• configuration.yaml: 主配置文件，包含了 Home Assistant 的核心配置。
• secrets.yaml: 存放敏感信息的文件，如密码、API 密钥等。
• customize.yaml: 用于自定义实体属性的文件。
• groups.yaml: 用于定义组和用户的文件。
• home-assistant_v2.db: Home Assistant 的数据库文件，用于存储历史数据等。

2. 项目的启动文件介绍

Home Assistant 的启动文件主要是 configuration.yaml 文件。这个文件是 Home Assistant 的核心配置文件，包含了系统的基本配置、集成、自动化、脚本等。

configuration.yaml 文件示例

homeassistant:
  name: Home
  latitude: 37.8136
  longitude: -122.2615
  elevation: 10
  unit_system: metric
  time_zone: America/Los_Angeles

# 集成配置
light:
  - platform: yeelight
    devices:
      - host: 192.168.1.2
        name: Living Room Light

# 自动化配置
automation: !include automations/example_automation.yaml

# 脚本配置
script: !include scripts/example_script.yaml

# 场景配置
scene: !include scenes/example_scene.yaml

启动文件介绍

• homeassistant: 配置 Home Assistant 的基本信息，如名称、地理位置、单位系统等。
• light: 配置灯光设备，如 Yeelight 灯泡。
• automation: 引用自动化脚本文件。
• script: 引用自定义脚本文件。
• scene: 引用场景配置文件。

3. 项目的配置文件介绍

configuration.yaml

configuration.yaml 是 Home Assistant 的主配置文件，包含了系统的基本配置、集成、自动化、脚本等。

secrets.yaml

secrets.yaml 文件用于存放敏感信息，如密码、API 密钥等。这些信息不会直接暴露在 configuration.yaml 中，而是通过引用 secrets.yaml 中的变量来使用。

customize.yaml

customize.yaml 文件用于自定义实体属性，如设备名称、图标等。

groups.yaml

groups.yaml 文件用于定义组和用户，可以将多个设备或用户分组管理。

automations/、scripts/、scenes/、packages/

这些目录下的文件分别用于存放自动化脚本、自定义脚本、场景配置和打包配置。每个文件通常是一个独立的 YAML 文件，通过 !include 指令在 configuration.yaml 中引用。

www/

www/ 目录用于存放自定义 UI 文件，通常用于存放自定义的网页或 UI 组件。

---

以上是 Home Assistant 配置项目的目录结构、启动文件和配置文件的介绍。希望这份教程能帮助你更好地理解和使用 Home Assistant。

Home-AssistantConfig项目地址:https://gitcode.com/gh_mirrors/home/Home-AssistantConfig