Home

midea2mqtt

A standalone bridge between Midea air conditioners and a local MQTT broker. It publishes the state of your units to MQTT and turns MQTT messages into commands. Everything runs on your LAN, with no cloud at runtime.

Built on midea-ac, so it supports the same units: Midea and the many brands that use Midea indoor units and Wi-Fi modules (Comfee, Inventor, Carrier, Toshiba, Electrolux, Pro Klima and others), protocol V2 and V3. If your unit is set up through the MSmartHome, NetHome Plus or Midea Air app, it is probably supported.

                        state (JSON) ──►
Midea AC  ◄── LAN ──►  midea2mqtt  ◄──►  MQTT broker  ◄──►  Home Assistant / Node-RED / STEM
                        ◄── commands (JSON)

# switch the unit "livingroom" to cooling at 22.5 °C
mosquitto_pub -t midea2mqtt/livingroom/set -m '{"mode":"cool","targetTemperature":22.5}'

Where to start

New here? Go through these in order:

1. Installation: build and run the bridge
2. Finding your units: write your units into the config, fetch V3 credentials
3. Configuration: broker and device settings
4. MQTT topics: what is published where

Reference

• Reading state: every key in the state and capabilities JSON
• Sending commands: every writable key and its values
• Home Assistant: ready-to-use MQTT climate configuration
• How it behaves: polling, timing, availability, retained messages
• Troubleshooting

Links

• Source: github.com/LinzN/midea2mqtt
• API: github.com/LinzN/midea-ac and its wiki
• License: LGPLv3