/mitsubishi2MQTT

Mitsubishi to MQTT with ESP8266 module

Primary LanguageCGNU Lesser General Public License v2.1LGPL-2.1

mitsubishi2MQTT

Use MQTT and ESP8266/ESP32 module to control Mitsubishi HVAC unit. It use SwiCago libraries: https://github.com/SwiCago/HeatPump


Features:

  • Initial config: WIFI AP mode and web portal
  • Web interface for configuration, status and control, firmware upgrade
  • Homeassistant autodiscovery and control with MQTT
  • Control with MQTT
  • Multilanguages

Screenshots:

Main page


How to use:

  • Step 1: flash the sketch with flash size include SPIFFS option.
  • Step 2: connect to device AP with name HVAC_XXXX (XXXX last 4 character MAC address)
  • Step 3: You should be automatically redirected to the web portal or go to 192.168.1.1
  • Step 4: set Wifi information, save & reboot. Fall back to AP mode if WiFi connection fails (AP password sets to default SSID name from step 2).
  • Step 5: find the device IP with last 4 character MAC address in your router
  • Step 6: (optional): Set MQTT information for use with Home Assistant
  • Step 7: (optional): Set Login password to prevent unwanted access in SETUP->ADVANCE->Login Password

Nightly builds are available for select platforms via GitHub Actions. Go to the platformio workflow, select the latest build, then check the Artifacts section.


For nodered fans MQTT topic use cases

  • topic/power/set OFF
  • topic/mode/set AUTO HEAT COOL DRY FAN_ONLY OFF ON
  • topic/temp/set 16-31
  • topic/remote_temp/set also called "room_temp", the implementation defined in "HeatPump" seems not work in some models
  • topic/fan/set 1-4 AUTO QUIET
  • topic/vane/set 1-5 SWING AUTO
  • topic/wideVane/set << < | > >>
  • topic/settings
  • topic/state
  • topic/debug/packets
  • topic/debug/packets/set on off
  • topic/debug/logs
  • topic/debug/logs/set on off
  • topic/custom/send as example "fc 42 01 30 10 02 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 7b " see https://github.com/SwiCago/HeatPump/blob/master/src/HeatPump.h
  • topic/system/set reboot

Grafana dashboard

To use Grafana you need to have Prometheus and Grafana (v10 or newer) installed. Config for Prometheus:

    static_configs:
        - targets:
            - IP-TO-Mitsubishi2mqtt

Then add Prometheus as a datasource in Grafana Grafana -> Connections -> Add new connection -> Prometheus -> Prometheus server URL: PROMETHEUS-IP:PORT

Then you can import the dashboard in Grafana -> Dashboards -> New -> Import and upload the file https://github.com/gysmo38/mitsubishi2MQTT/blob/master/Mitsubishi2mqtt.json

If you like my work and use it ;)

Buy Me a Coffee at ko-fi.com