Gree HVAC MQTT Bridge 使用教程

Gree HVAC MQTT Bridge 使用教程

gree-hvac-mqtt-bridgeMQTT Bridge for controlling Gree smart air conditioners, e.g. with Home Assistant or OpenHAB项目地址:https://gitcode.com/gh_mirrors/gr/gree-hvac-mqtt-bridge

项目介绍

Gree HVAC MQTT Bridge 是一个开源工具，专为实现gree智能空调与智能家居系统的无缝对接设计。它通过MQTT协议广播与Gree空调进行通讯，特别适合集成到Home Assistant或OpenHAB等智能家居平台中。此项目由Arthur Krupa维护，支持多种架构，确保了广泛的兼容性。借助该桥接服务，用户可以轻松地远程控制Gree空调，享受智能化的居家环境。

项目快速启动

环境准备

首先，确保你的系统满足以下条件：

• Node.js: 版本需在11.0.0及以上。
• MQTT Broker: 如Mosquitto，需要在其上运行以转发消息。
• Gree HVAC设备: 必须位于同一网络下。

安装与配置步骤

1. 克隆项目：

   git clone https://github.com/arthurkrupa/gree-hvac-mqtt-bridge.git
   

2. 安装依赖： 进入项目目录并安装Node.js依赖：

   cd gree-hvac-mqtt-bridge
   npm install
   

3. 配置Bridge： 编辑config.json文件，设置Gree空调的IP地址和MQTT broker的相关参数。例如：

   {
     "mqtt": {
       "broker_url": "mqtt://localhost",
       "topic_prefix": "home/greehvac"
     },
     "devices": [
       {
         "hvac_host": "192.168.1.255"
       }
     ]
   }
   

4. 运行Bridge： 根据你的具体设置执行以下命令来启动服务：

   node index.js --hvac-host=192.168.1.255 --mqtt-broker-url=mqtt://localhost --mqtt-topic-prefix=home/greehvac
   

应用案例与最佳实践

在Home Assistant环境下，你可以创建一个MQTT气候实体，关联Gree HVAC MQTT Bridge，这样就可以通过界面或自动化规则来控制空调。最佳实践包括定义自动化场景，如温度超过设定值自动开启制冷模式，或者夜间自动调整为节能模式。

climate:
  - platform: mqtt
    name: "Living Room AC"
    unique_id: living_room_ac
    state_topic: "home/greehvac/state"
    command_topic: "home/greehvac/operation/set"
    temperature_state_topic: "home/greehvac/temperature"
    temperature_command_topic: "home/greehvac/temperature/set"
    # Add other necessary MQTT topics based on project documentation.

典型生态项目

Gree HVAC MQTT Bridge成功融入了许多智能家居生态系统，尤其是Home Assistant社区。它不仅简化了智能空调的集成过程，也为那些寻求更高级控制和自动化解决方案的发烧友提供了强大工具。结合其他智能家居组件，如环境传感器，可以实现更加智能化的温控策略，提高了居住舒适度和能源效率。

通过上述步骤，您现在应该能够顺利部署和使用Gree HVAC MQTT Bridge，享受现代化家居控制带来的便利。持续关注项目的更新和社区分享的最佳实践，将进一步提升您的智能家居体验。

gree-hvac-mqtt-bridgeMQTT Bridge for controlling Gree smart air conditioners, e.g. with Home Assistant or OpenHAB项目地址:https://gitcode.com/gh_mirrors/gr/gree-hvac-mqtt-bridge