08Home Assistant 中如何添加格力的设备小白教程

admin · 发表于 2025-12-15 16:43:29

Home Assistant 2025.12.2 版本的 格力 (Gree) 空调设备接入详细教程。

本教程优先使用 Home Assistant 官方内置的集成（Integration），这是最稳定、最适合新手（小白）的方案，无需安装第三方插件。

✅ 核心前提（必读）

在开始之前，请务必确保完成以下准备工作，否则无法接入：

设备已配网：你的格力空调必须已经通过 "Gree+" (格力+) 手机 App 成功连接到家里的 WiFi，并且能在手机上正常控制。
网络环境一致：Home Assistant 主机（如树莓派、软路由等）和格力空调必须连接在 同一个局域网（同一个路由器） 下。
- 注意：官方集成依赖自动发现功能，如果设备在不同网段（VLAN），可能无法搜索到。
WiFi 频段：空调通常只支持 2.4GHz WiFi。

🚀 第一步：在 Home Assistant 中添加集成

打开 Home Assistant
在浏览器或 App 中登录你的 Home Assistant 后台。
进入“设备与服务”
- 点击左侧菜单栏的 配置 (Settings)。
- 选择 设备与服务 (Devices & Services)。
添加集成
- 点击右下角的 + 添加集成 (+ ADD INTEGRATION) 按钮。
- 在搜索框中输入 Gree。
- 点击搜索结果中的 Gree Climate 图标。
自动搜索设备
- 点击后，系统会自动扫描局域网内的格力设备。
- 情况 A：自动发现成功（推荐）
  - 界面会显示发现的设备（通常显示为 MAC 地址或默认名称）。
  - 点击 提交 (Submit)。
  - 你可以为设备选择一个 区域 (Area)（例如：客厅、主卧），然后点击 完成 (Finish)。
- 情况 B：未发现设备
  - 如果转圈很久提示“未发现设备”，请检查空调是否通电、WiFi 是否正常，以及是否与 HA 主机在同一网络。
  - 小白提示：尝试在路由器后台给空调分配一个固定 IP，然后重启空调和 Home Assistant 再试。

🎮 第二步：控制与使用

添加成功后，你的空调就已经接入 Home Assistant 了。

查找实体
- 回到 配置 -> 设备与服务。
- 点击 Gree Climate 卡片上的 1 个设备（或多个）。
- 点击进入设备详情页。
控制面板
你会看到一个标准的温控器卡片，功能包括：
- 模式切换：制冷 (Cool)、制热 (Heat)、自动 (Auto)、送风 (Fan only)、除湿 (Dry)、关机 (Off)。[1]
- 温度调节：拖动圆环或点击箭头调整目标温度。
- 辅助开关：系统通常会自动生成一些额外的开关实体（Entities），例如：
  - Panel Light：控制空调机身上的LED显示屏开关。
  - Quiet：静音模式。
  - XFan：干燥/辅热功能。
添加到仪表盘
- 在设备详情页，点击“添加到仪表盘”按钮，即可将空调卡片放置在你的首页，方便日常控制。

❓ 常见问题与故障排查（FAQ）

Q1: 为什么搜索不到设备？

原因 1：网络隔离。如果你的路由器开启了“AP隔离”或者 HA 和空调在不同网段，广播包发不过去，官方集成无法自动发现。
- 解决：确保两者连接同一 WiFi 信号（2.4G）。
原因 2：设备型号过老或过新。
- 解决：绝大多数支持 Gree+ App 的设备都支持。如果实在不行，可能需要重启一次空调（断电重连）。

Q2: 添加后显示“不可用 (Unavailable)”？

Q3: 官方集成不好用怎么办？

如果你是进阶用户，且官方集成无法满足需求（例如需要跨网段控制），可以尝试通过 HACS 安装第三方的 Gree Climate Component，它支持手动输入 IP 地址接入，但对于小白用户，强烈建议优先使用上述官方集成。

💡 验证环境说明

发帖者介绍-莱特智能成立于2010年，专注智能家居整体解决方案，Now ALL IN HA，欢迎淘宝搜索！

		自动登录	找回密码
密码			立即注册