开源项目 Adaptive Lighting 指南

开源项目 Adaptive Lighting 指南

adaptive-lightingAdaptive Lighting custom component for Home Assistant项目地址:https://gitcode.com/gh_mirrors/ad/adaptive-lighting

一、项目目录结构及介绍

Adaptive Lighting 是一个专为 Home Assistant 设计的定制组件，由 basnijholt 维护。其目录结构体现了开源软件的标准组织方式，便于开发者和使用者理解和扩展。

主要目录及文件说明：

• custom_components/adaptive_lighting/: 核心组件存放目录。

  • __init__.py: 初始化文件，定义了组件的基本信息和入口点。
  • sensor.py: 包含自适应照明相关的传感器逻辑。
  • switch.py: 实现开关功能，用于控制照明适应性逻辑的启用或禁用。
  • 其它.py文件: 可能包括辅助函数、特定功能模块等。

• config_flow.py: 配置向导文件，使得用户可以通过Home Assistant的UI进行配置。

• manifest.json: 组件的元数据文件，声明了组件的名称、作者、所需权限等信息。

• requirements.txt: 列出项目运行所需的外部Python库。

• tests/: 单元测试目录，确保代码质量。

二、项目启动文件介绍

在 Adaptive Lighting 这个上下文中，没有一个单独的“启动文件”如传统应用程序那样。然而，它的激活与Home Assistant的启动流程紧密相关。当你将此组件添加到你的Home Assistant的custom_components目录下并重启Home Assistant时，系统自动加载这个组件。关键是正确地配置configuration.yaml文件来启用和配置该组件。

三、项目的配置文件介绍

configuration.yaml

配置 Adaptive Lighting 组件的关键在于你的 configuration.yaml 文件中添加正确的配置块。下面是一个基础配置示例：

switch:
  platform: adaptive_lighting
  name: Adaptive_Lighting_Switch
  lights:
    - light.bedroom_light
    - light.living_room_light
  sensors:
    brightness_sensor: sensor.sun_brightness
    dark_sensor: binary_sensor.night_mode
    presence_sensor: binary_sensor.bedroom_presence
  after_sunrise:
    min_kelvin: 2700
    max_kelvin: 4000
  before_sunset:
    min_kelvin: 4000
    max_kelvin: 6500

关键参数解释:

• lights: 要控制的灯光列表。
• sensors: 亮度、暗度和存在感应器的指定。
• after_sunrise, before_sunset: 设置日出后和日落前的色温范围，以适应自然光照变化。

请注意，具体配置可能根据项目最新版本有所调整，请参考项目的 GitHub 仓库中的README或最新的文档来获取详细配置指南。

adaptive-lightingAdaptive Lighting custom component for Home Assistant项目地址:https://gitcode.com/gh_mirrors/ad/adaptive-lighting