SmartIR 项目使用教程

SmartIR 项目使用教程

SmartIR Integration for Home Assistant to control climate, TV and fan devices via IR/RF controllers (Broadlink, Xiaomi, MQTT, LOOKin, ESPHome) 项目地址: https://gitcode.com/gh_mirrors/smar/SmartIR

1. 项目介绍

SmartIR 是一个用于 Home Assistant 的自定义集成项目，旨在通过红外控制器（如 Broadlink、Xiaomi、MQTT、LOOKin、ESPHome 等）控制气候设备、媒体播放器和风扇。该项目支持超过 120 种气候设备，主要针对 Broadlink 控制器，得益于社区的贡献。

2. 项目快速启动

2.1 安装

手动安装

1. 将 custom_components 文件夹放置在 Home Assistant 的配置目录中，目录结构应如下所示：

   <config directory>/
   ├── custom_components/
   │   ├── smartir/
   │   │   ├── __init__.py
   │   │   ├── climate.py
   │   │   ├── fan.py
   │   │   ├── media_player.py
   │   │   └── etc.
   

2. 在 configuration.yaml 文件中添加以下配置：

   smartir:
   

3. 配置平台（例如气候平台、媒体播放器平台、风扇平台）。

通过 HACS 安装

1. 在 HACS 中添加 SmartIR 作为自定义仓库。
2. 安装 SmartIR。
3. 在 configuration.yaml 文件中添加以下配置：

   smartir:
   

2.2 配置示例

以下是一个简单的配置示例，展示如何在 Home Assistant 中配置 SmartIR 控制气候设备：

smartir:

climate:
  - platform: smartir
    name: Living Room AC
    unique_id: living_room_ac
    device_code: 1000
    controller_data: remote.broadlink_remote
    temperature_sensor: sensor.temperature
    humidity_sensor: sensor.humidity
    power_sensor: binary_sensor.ac_power

3. 应用案例和最佳实践

3.1 应用案例

• 智能家居控制：通过 SmartIR 集成，用户可以轻松控制家中的空调、电视和风扇，实现智能家居的自动化。
• 远程控制：结合 Home Assistant 的远程访问功能，用户可以在外出时通过手机应用控制家中的设备。

3.2 最佳实践

• 定期更新：确保 SmartIR 和 Home Assistant 保持最新版本，以获得最佳性能和安全性。
• 社区支持：参与 Home Assistant 和 SmartIR 的社区讨论，获取更多使用技巧和解决方案。

4. 典型生态项目

• Home Assistant：SmartIR 是 Home Assistant 的一个自定义集成，依赖于 Home Assistant 的核心功能。
• Broadlink：SmartIR 支持 Broadlink 控制器，广泛用于智能家居设备的红外控制。
• ESPHome：通过 ESPHome 集成，用户可以自定义红外控制器，扩展 SmartIR 的功能。

通过以上步骤，您可以快速上手并充分利用 SmartIR 项目，实现智能家居设备的自动化控制。

SmartIR Integration for Home Assistant to control climate, TV and fan devices via IR/RF controllers (Broadlink, Xiaomi, MQTT, LOOKin, ESPHome) 项目地址: https://gitcode.com/gh_mirrors/smar/SmartIR