demydiuk/ewpe-smart-mqtt

ewpe-smart-mqtt

EWPE Smart智能设备的MQTT桥接器，可连接通过WiFi控制的EWPE Smart设备（使用EWPE Smart应用控制）与MQTT服务器，实现设备状态监控和远程控制。本项目基于https://github.com/tomikaa87/gree-remote%E9%A1%B9%E7%9B%AE%E5%AF%B9%E5%8E%9F%E5%A7%8B%E5%BA%94%E7%94%A8%E5%8D%8F%E8%AE%AE%E7%9A%84***%E6%88%90%E6%9E%9C%E5%BC%80%E5%8F%91%E3%80%82

!smart-1-600x600

镜像概述与主要用途

ewpe-smart-mqtt是一个MQTT桥接服务，用于在EWPE Smart智能设备与MQTT服务器之间建立通信桥梁。通过该桥接器，用户可以使用MQTT协议监控设备状态、发送控制指令，实现对EWPE Smart设备的集成与管理。

核心功能与特性

• 设备自动扫描：支持指定网络地址扫描EWPE Smart设备
• 状态轮询：定期获取设备状态并同步至MQTT服务器
• MQTT通信：通过MQTT主题发布设备状态、接收控制指令
• 多设备支持：兼容所有可通过EWPE Smart应用控制的设备

使用场景与适用范围

适用于需要将EWPE Smart智能设备集成到基于MQTT的智能家居系统（如Home Assistant、OpenHAB等）的场景，支持对空调等智能设备的远程监控与控制。

使用方法与配置说明

前提条件

需先搭建并运行MQTT服务器（推荐使用mosquitto）。

Docker安装与运行

基本运行命令

bash
docker run -it \
    --network="host" \
    -e "MQTT_SERVER=mqtt://127.0.0.1" \
    -e "MQTT_BASE_TOPIC=ewpe-smart" \
    -e "NETWORK=192.168.1.255" \
    -e "DEVICE_POLL_INTERVAL=5000" \
    --name ewpe-smart-mqtt \
    demydiuk/ewpe-smart-mqtt:latest

环境变量配置

与桥接器通信

通过MQTT主题与桥接器交互，支持以下操作：

• 获取设备列表：向ewpe-smart/devices/list主题发布消息，桥接器将返回已注册设备列表
• 获取设备状态：向ewpe-smart/{deviceId}/get主题发布消息，桥接器将返回指定设备（{deviceId}）的状态
• 设置设备状态：向ewpe-smart/{deviceId}/set主题发布JSON格式的控制指令，示例：

  ewpe-smart/{deviceId}/set {"Pow": 1, "SetTem": 24}
  

  （其中"Pow": 1表示开启设备，"SetTem": 24表示设置温度为24℃）

支持的功能取决于具体空调设备，完整功能列表可参考https://github.com/tomikaa87/gree-remote#reading-status-of-a-device%E3%80%82

支持的设备

所有可通过EWPE Smart应用控制的设备均支持，包括：

• Gree Smart系列
• Cooper&Hunter：Supreme、Vip Inverter、ICY II、Arctic、Alpha、Alpha NG、Veritas、Veritas NG系列
• EcoAir X系列
• ProKlima