Domoticz-MitsubishiHpMQTT-Plugin

Mitsubishi Air Conditionner Domoticz plugin interfacing Swicago MQTT ESP

Key Features

• Creates devices for managing for AC in Domoticz :
  • On/Off switch for the unit
  • Mode selector switch
  • Fan speed selector switch
  • Vertical vane selector switch
  • Wide vane selector switch
  • Temperature sensor giving the internal temperature
  • Temperature setpoint to set the desired temperature
• Devices have state pictures

Prerequisites

• MQTT broker running
• Hardware interface with the AC setup to use your MQTT broker
  • /!\ beware, Gysmo38's Mitsubishi2MQTT implementation won't work because it's specific to HomeAssistant.
  • Refer to Swicago's Heatpump readme to setup the hardware
  • Configure, compile and upload his Swicago Heatpump MQTT program
    • Edit mitsubishi_heatpump_mqtt_esp8266_esp32.h to setup wifi, mqtt connection
    • Edit mitsubishi_heatpump_mqtt_esp8266_esp32.ino to add

      // connect to the heatpump. Callbacks first so that the hpPacketDebug callback is available for connect()
      hp.setSettingsChangedCallback(hpSettingsChanged);
      hp.setStatusChangedCallback(hpStatusChanged);
      hp.setPacketCallback(hpPacketDebug);
      // vvv theses lines should be added to prevent unsync if you use remote
      hp.enableAutoUpdate();
      hp.enableExternalUpdate();

    • Compile and upload the program

Plugin Installation

Tested on Python version 3.7 & Domoticz version 4.10717

To install:

• Go in your Domoticz directory, open the plugins directory.
• Navigate to the directory using a command line
• Run: git clone https://github.com/Masurov/Domoticz-MitsubishiHpMQTT-Plugin.git
• Restart Domoticz.

In the web UI, navigate to the Hardware page. In the hardware dropdown there will be an entry called "Mitsubishi Heatpump MQTT interface Plugin".

Updating

To update:

• Go in your Domoticz directory using a command line and open the plugins directory then the Domoticz-MitsubishiHpMQTT-Plugin directory.
• Run: git pull
• Restart Domoticz.

Configuration

Field	Information
MQTT Server address	IP of your MQTT broker
Port	Port of your MQTT broker
Login	MQTT broker login (if needed)
Password	MQTT broker password (if needed)
Remote temperature device ID	Set this with the temperature sensor device Idx if you want to use one of your domoticz temperature device instead of the heatpump internal sensor
Domoticz base url	Required for "Remote temperature device ID" usage. Used to get the temperature value from the web API. Should be something like http://127.0.0.1:8080. Requires to setup the authentication bypass for local networks in domoticz Settings > System.
Don't send remote temp after being unseen for X minutes	If the temperature device value exceeds this delay, the heatpump will be set to use its internal sensor
Heatpump MQTT topic	MQTT topic the ESP has been programmed with (heatpump by default)
Debug	When true the logging level will be much higher to aid with troubleshooting

Change log

Version	Information
1.3	Added remote temperature sending to the heatpump
1.2	Added login and password parameters for MQTT broker connection
1.1	Fixes wrong selector levels with python version under 3.7
1.0	Initial upload version