Zhonghong MQTT
An integration for Zhonghong thermostat gateway and MQTT brokers, in order to control thermostats with Home Assistant, running with Docker.
Overview
The gateway supports many interfaces and protocols, such as Zigbee, TCP, HTTP and RS485.
For efficiency, we use the HTTP API temporarily.
Installing
Download Docker image
docker pull halozheng/zhonghong-mqtt
Create the container
- Create the config file with a name
config.yml
Gateway:
Host: 'Your gateway IP address'
Port: 80
Username: 'admin'
Password: ''
MQTT:
Host: 'Your MQTT Broker IP address'
Port: 1883
Username: 'Your MQTT username'
Password: 'Your MQTT password'
- Create the container with volume mapping
/your-path/config.yml => /config.yml
- Run the container
Getting Started
x: Outside machine sequence number, in most cases it is 1
y: Inside machine sequence number, from 1 to N
State Topics
zhonghong/x/y/mode/state
Mode state of the thermostat, available values: heat|dry|cool|fan_only|off.
zhonghong/x/y/temperature/state
Set temperature of the thermostat, available values: number with celsius.
zhonghong/x/y/fan/state
Fan speed of the thermostat, available values: low|medium|high.
zhonghong/x/y/current_temperature/state
Current temperature with celsius of the thermostat.
Command Topics
zhonghong/x/y/mode/set
zhonghong/x/y/temperature/set
zhonghong/x/y/fan/set
Integration with Home Assistant
climate:
- platform: mqtt
name: 'My Thermostat'
modes:
- 'heat'
- 'dry'
- 'cool'
- 'fan_only'
- 'off'
fan_modes:
- 'low'
- 'medium'
- 'high'
max_temp: 30
min_temp: 18
mode_command_topic: 'zhonghong/1/1/mode/set'
mode_state_topic: 'zhonghong/1/1/mode/state'
temperature_command_topic: 'zhonghong/1/1/temperature/set'
temperature_state_topic: 'zhonghong/1/1/temperature/state'
fan_mode_command_topic: 'zhonghong/1/1/fan/set'
fan_mode_state_topic: 'zhonghong/1/1/fan/state'
current_temperature_topic: 'zhonghong/1/1/current_temperature/state'
FAQ
My gateway does not support Wi-Fi
We can use a normal wireless router, run with client mode, to convert the Wi-Fi to RJ45 interface.
Such as TP-LINK TL-WR800N.