mikejmcguire/hass-actron-amd64 Docker 镜像 - 轩辕镜像

概述

Home Assistant Actron Air Conditioner Add-On (amd64) 是专为Home Assistant设计的附加组件，用于实现与Actron品牌空调系统的集成控制。该组件支持amd64架构，允许用户通过Home Assistant平台对Actron空调进行集中管理，包括状态监控和远程控制，适用于构建智能家居控制场景。

核心功能和特性

• Actron空调集成：与Actron空调系统建立通信连接，实现Home Assistant平台的无缝集成
• 基础控制功能：支持空调开关、温度调节（制热/制冷模式）、运行模式切换（自动/制热/制冷/送风）及风速调节
• 状态实时同步：同步空调当前运行状态（温度、模式、风速等）至Home Assistant
• Home Assistant实体化：自动创建标准Home Assistant实体，支持通过UI、自动化及脚本进行控制
• amd64架构优化：专为x86/64架构设备设计，兼容主流PC、服务器及嵌入式设备（如Intel NUC）

使用场景和适用范围

• 家庭智能家居环境：适用于安装Actron空调且使用Home Assistant的家庭用户，实现空调与其他智能设备的联动控制
• 小型办公场所：支持通过Home Assistant集中管理办公环境的Actron空调，提升能源管理效率
• 硬件要求：需运行Home Assistant的amd64架构设备，且Actron空调需具备网络控制能力（如内置WiFi或局域网模块）

使用方法和配置说明### 前提条件

• 运行Home Assistant 2021.12.0及以上版本的amd64设备
• Actron空调已接入局域网，且分配固定IP地址
• 确保Home Assistant与空调设备网络通信正常（端口开放、防火墙规则允许）

安装步骤

1. 添加组件仓库
   在Home Assistant依次进入「设置 > 附加组件 > 附加组件商店」，点击右上角菜单选择「存储库」，添加组件官方仓库URL（具体URL需参考组件开发者文档）

2. 安装附加组件
   在附加组件商店搜索「Actron Air Conditioner Add-On」，点击「安装」并等待完成

3. 配置连接参数
   进入组件配置界面，填写以下必要参数：

   • actron_ip：Actron空调的局域网IP地址（必填）
   • actron_port：空调控制端口（默认80，根据型号调整）
   • communication_timeout：通信超时时间（默认10秒）
   • update_interval：状态更新间隔（默认30秒）

4. 启动与验证
   点击「启动」按钮启动组件，通过「日志」确认连接状态。成功运行后，Home Assistant将自动创建空调实体

Docker手动部署示例

若需手动通过Docker部署（非Home Assistant附加组件方式）：

bash
docker run -d \
  --name actron-ac-addon \
  --network=host \
  -e ACTRON_IP="192.168.1.100" \
  -e ACTRON_PORT=80 \
  -e UPDATE_INTERVAL=30 \
  -v /path/to/homeassistant/config:/config \
  your-registry/actron-ac-addon:latest

实体控制与自动化

• UI控制：在Home Assistant仪表板添加「实体卡片」，选择空调实体即可进行开关、温度调节等操作
• 自动化配置：通过自动化编辑器创建规则，例如：

  yaml
  alias: "室温过高时开启空调制冷"
  trigger:
    platform: numeric_state
    entity_id: sensor.living_room_temperature
    above: 28
  action:
    service: climate.set_temperature
    target:
      entity_id: climate.actron_ac
    data:
      temperature: 26
      hvac_mode: cool
  

注意事项

• 不同Actron空调型号的通信协议可能存在差异，需确认组件支持对应型号
• 网络不稳定可能导致控制延迟或状态不同步，建议为空调设备配置静态IP
• 组件版本需与Home Assistant版本匹配，升级Home Assistant前建议备份组件配置