Home Assistant 示例配置项目教程
1. 项目目录结构及介绍
Homeassistant-Example-Config/
├── alarm.yaml
├── announcements.yaml
├── automations.yaml
├── camera.yaml
├── configuration.yaml
├── cover.yaml
├── customize.yaml
├── device_tracker.yaml
├── google.yaml
├── groups.yaml
├── ip_bans.yaml
├── light.yaml
├── media_player.yaml
├── mqtt.yaml
├── notify.yaml
├── panel_custom.yaml
├── scripts.yaml
├── sensor.yaml
├── switch.yaml
├── ui-lovelace.yaml
├── .gitignore
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── PULL_REQUEST_TEMPLATE.md
├── README.md
└── screenshots/
└── ...
目录结构介绍
- alarm.yaml: 报警配置文件。
- announcements.yaml: 公告配置文件。
- automations.yaml: 自动化配置文件。
- camera.yaml: 摄像头配置文件。
- configuration.yaml: 主配置文件。
- cover.yaml: 窗帘配置文件。
- customize.yaml: 自定义配置文件。
- device_tracker.yaml: 设备追踪配置文件。
- google.yaml: Google 相关配置文件。
- groups.yaml: 分组配置文件。
- ip_bans.yaml: IP 封禁配置文件。
- light.yaml: 灯光配置文件。
- media_player.yaml: 媒体播放器配置文件。
- mqtt.yaml: MQTT 配置文件。
- notify.yaml: 通知配置文件。
- panel_custom.yaml: 自定义面板配置文件。
- scripts.yaml: 脚本配置文件。
- sensor.yaml: 传感器配置文件。
- switch.yaml: 开关配置文件。
- ui-lovelace.yaml: Lovelace UI 配置文件。
- .gitignore: Git 忽略文件。
- CODE_OF_CONDUCT.md: 行为准则文件。
- CONTRIBUTING.md: 贡献指南文件。
- LICENSE: 许可证文件。
- PULL_REQUEST_TEMPLATE.md: 拉取请求模板文件。
- README.md: 项目说明文件。
- screenshots/: 截图文件夹。
2. 项目启动文件介绍
Home Assistant 的启动文件通常是 configuration.yaml
,它包含了项目的核心配置。启动时,Home Assistant 会读取这个文件并根据其中的配置启动相应的服务和组件。
3. 项目配置文件介绍
configuration.yaml
configuration.yaml
是 Home Assistant 的主配置文件,包含了项目的核心配置。以下是该文件的部分内容示例:
## Default Config ##
######################################################
# https://www.home-assistant.io/integrations/default_config/#
# Configure a default setup of Home Assistant (frontend, api, etc)
#
default_config:
person:
updater:
zone:
zeroconf:
system_health:
sun:
ssdp:
map:
logbook:
config:
history:
logger:
default: info
######################################################
## CUSTOMIZING ##
######################################################
# https://www.home-assistant.io/docs/configuration/customizing-devices/#
#
homeassistant:
auth_providers:
- type: homeassistant
#- type: legacy_api_password
- type: trusted_networks
trusted_networks:
- 127.0.0.1
- ::1
- fd00::/8
name: 'secret name'
temperature_unit: C
time_zone: 'secret timezone'
latitude:
主要配置项
- default_config: 默认配置,包含了 Home Assistant 的基本设置。
- homeassistant: 自定义配置,包括认证提供者、信任网络、名称、温度单位、时区等。
通过这些配置文件,用户可以自定义 Home Assistant 的行为和功能,实现智能家居的自动化和控制。