Entity Controller 项目教程

1. 项目介绍

Entity Controller (EC) 是一个用于 Home Assistant 的实体和照明控制器，旨在通过定时器、脚本和基于太阳的时间限制来管理设备。EC 实现了一个有限状态机，确保基本的自动化不会干扰您的家庭自动化设置。该项目将常见的自动化场景封装成一个易于配置和在整个家庭中重复使用的整洁包。

EC 的主要特点包括：

• 使用有限状态机确保自动化不会相互干扰。
• 支持任何实体作为输入和输出，不限于运动传感器和灯光。
• 通过 HACS（Home Assistant Community Store）进行自动更新。

2. 项目快速启动

安装

1. 通过 HACS 安装：

   • 打开 Home Assistant 的 HACS 商店。
   • 搜索并安装 Entity Controller。

2. 配置：

   • 在您的 Home Assistant 配置文件中添加以下内容：

motion_light:
  sensor: binary_sensor.living_room_motion
  entity: light.tv_led
  delay: 5

3. 重启 Home Assistant：
   • 重启 Home Assistant 服务器以应用配置。

示例代码

以下是一个简单的示例，展示如何配置一个基于运动传感器的灯光控制：

motion_light:
  sensor: binary_sensor.living_room_motion
  entity: light.tv_led
  delay: 5

3. 应用案例和最佳实践

应用案例

• 基于运动传感器的灯光控制： 当检测到运动时，灯光自动打开，并在指定时间后自动关闭。

• 定时器控制： 使用定时器来控制设备的开关，例如在特定时间自动关闭电视。

最佳实践

• 调试日志： 启用调试日志以帮助诊断问题。在 configuration.yaml 中添加以下内容：

logger:
  default: critical
  logs:
    custom_components.entity_controller: debug

• 时间约束： 使用时间约束来限制自动化的时间范围，例如仅在夜间启用某些自动化。

4. 典型生态项目

• Home Assistant： Entity Controller 是 Home Assistant 的一个组件，与 Home Assistant 的其他组件无缝集成。

• HACS (Home Assistant Community Store)： 通过 HACS 安装和管理 Entity Controller，享受自动更新和快速发布采用的好处。

• Python Transitions Library： Entity Controller 使用 Python Transitions 库来实现有限状态机，确保代码逻辑清晰。

通过以上步骤，您可以快速上手并充分利用 Entity Controller 的功能，实现高效的家庭自动化管理。