ewpe-smart-mqtt

MQTT bridge for EWPE Smart powered devices which can be controled via WiFi using EWPE Smart app

This project became possible thanks to great work of reverse engineering the original app protocol in gree-remote project

smart-1-600x600

Prerequisites

Setup and run MQTT server (mosquitto is the easiest one)

Installation

Clone or download this repository

git clone https://github.com/stas-demydiuk/ewpe-smart-mqtt

Install dependencies
```
npm install
```
Make initial configuration by setting enviromental variables

Variable	Description	Default value
MQTT_SERVER	MQTT server URI	mqtt://127.0.0.1
MQTT_PORT	MQTT Server Port	1883
MQTT_USERNAME	MQTT Server Username
MQTT_PASSWORD	MQTT Server Password
MQTT_BASE_TOPIC	Base MQTT topic for bridge messages	ewpe-smart
NETWORK	Network adress (or addresses separated by semicolon) to scan devices	192.168.1.255
DEVICE_POLL_INTERVAL	Interval (ms) to poll device status	5000
LOG_LEVEL	App Log level	info

Run the bridge
```
npm start
```

Installation (Docker)

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

Installation (systemd service)

Clone or download the repository

cd /opt/
git clone https://github.com/stas-demydiuk/ewpe-smart-mqtt

Create service file sudo nano /etc/systemd/system/ewpe-smart-mqtt.service

[Unit]
Description=ewpe-smart-mqtt
After=mosquitto.target

[Service]
ExecStart=/usr/bin/node /opt/ewpe-smart-mqtt/index.js --NETWORK="192.168.1.255" --MQTT_SERVER="mqtt://127.0.0.1" --MQTT_PORT="1883" --MQTT_USERNAME="" --MQTT_PASSWORD="" --MQTT_BASE_TOPIC="ewpe-smart" --DEVICE_POLL_INTERVAL="5000" 
# Required on some systems
WorkingDirectory=/opt/ewpe-smart-mqtt
StandardOutput=inherit
StandardError=inherit
Restart=always
RestartSec=10
User=pi
Group=pi

[Install]
WantedBy=multi-user.target

Run the servive

Enable service with sudo systemctl enable ewpe-smart-mqtt.service
Start/stop service with sudo systemctl start|stop ewpe-smart-mqtt.service

Communicating with the bridge

Publish to ewpe-smart/devices/list to receive list of registered devices
Publish to ewpe-smart/{deviceId}/get to receive status of {deviceId}
Publish to ewpe-smart/{deviceId}/set to set status of {deviceId}, payload should be json object with key/values pairs to set, i.e:
```
ewpe-smart/{deviceId}/set {"Pow": 1, "SetTem": 24}
```

Supported features depend on your AC unit, full list can be found here

Supported devices

All devices which can be controlled via EWPE Smart app should be supported, including:

Gree Smart series
Cooper&Hunter: Supreme, Vip Inverter, ICY II, Arctic, Alpha, Alpha NG, Veritas, Veritas NG series
EcoAir X series
ProKlima

stas-demydiuk / ewpe-smart-mqtt

readme