ControllerX 使用教程
1. 项目介绍
ControllerX 是一个开源项目,旨在通过简单的配置实现基于控制器的自动化,以便在 Home Assistant (HA) 中控制家庭设备和场景。该项目支持多种控制器,如 IKEA、Xiaomi 等,并提供了丰富的功能,包括开关设备、调节亮度、颜色温度、音量等。ControllerX 使用 AppDaemon 作为其运行环境,通过异步循环调用 Home Assistant 的服务请求,实现平滑的控制效果。
2. 项目快速启动
安装
首先,确保你已经安装了 Home Assistant 和 AppDaemon。然后,你可以通过以下步骤安装 ControllerX:
-
克隆项目仓库:
git clone https://github.com/xaviml/controllerx.git
-
进入项目目录:
cd controllerx
-
安装依赖:
pip install -r requirements.txt
配置
在 Home Assistant 的 appdaemon/apps/apps.yaml
文件中添加以下配置,以实现一个简单的控制器自动化:
livingroom_controller:
module: controllerx
class: E1810Controller
controller: sensor.livingroom_controller_action
integration: z2m
light: light.bedroom
启动
启动 AppDaemon,ControllerX 将自动加载并开始运行。
3. 应用案例和最佳实践
案例1:使用 IKEA E1810 控制卧室灯光
通过以下配置,你可以使用 IKEA E1810 控制器来控制卧室灯光的亮度、颜色温度和颜色:
bedroom_controller:
module: controllerx
class: E1810Controller
controller: sensor.bedroom_controller_action
integration: z2m
light: light.bedroom
案例2:使用 Symfonisk 控制 Chromecast 音量
通过以下配置,你可以使用 Symfonisk 控制器来控制 Chromecast 的音量:
chromecast_controller:
module: controllerx
class: SymfoniskController
controller: sensor.chromecast_controller_action
integration: z2m
media_player: media_player.chromecast
最佳实践
- 模块化配置:将不同的控制器和设备配置分开,便于管理和维护。
- 使用预定义动作:利用 ControllerX 提供的预定义动作,简化配置过程。
- 自定义映射:根据需要自定义控制器的按键映射,以满足特定需求。
4. 典型生态项目
Home Assistant
ControllerX 是基于 Home Assistant 的自动化工具,Home Assistant 是一个开源的家庭自动化平台,支持多种设备和协议。
AppDaemon
AppDaemon 是一个基于 Python 的 Home Assistant 自动化框架,ControllerX 运行在其之上,提供了更高级的自动化功能。
Zigbee2MQTT
Zigbee2MQTT 是一个开源的 Zigbee 网关,支持多种 Zigbee 设备,ControllerX 可以与其集成,实现对 Zigbee 设备的控制。
通过这些生态项目的结合,ControllerX 能够实现更复杂和灵活的家庭自动化控制。