Zum Hauptinhalt springen

MELCloud Smart-Home-Integration, kostenlos und Open Source

MELCloud-Integration für Gladys Assistant

Control your Mitsubishi Electric air conditioners through the MELCloud cloud service.

Auf GitHub ansehenAlle externen Integrationen
Info

Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.

Overview​

This integration connects Gladys Assistant to MELCloud, the cloud service of Mitsubishi Electric, to control your air conditioners from Gladys.

Once configured, every device of your MELCloud account appears in the Gladys Discovery screen. Air-to-air units expose three controllable features:

  • Power — turn the unit on or off;
  • Mode — heating, drying, cooling, fan or auto;
  • Temperature — the target temperature, within the min/max bounds of the unit.

Device states are refreshed every 10 seconds, so changes made from the Mitsubishi remote control or the MELCloud app show up in Gladys shortly after. Air-to-water and ventilation (Lossnay) units are listed but do not expose any feature yet.

Prerequisites​

  • A MELCloud account (app.melcloud.com) with your air conditioners already registered in it: each unit needs a Mitsubishi Wi-Fi interface (e.g. MAC-567IF-E) paired with the MELCloud app.
  • The units must be reachable from MELCloud: this integration talks to the Mitsubishi cloud, so your Gladys instance needs Internet access.

Configuration​

  1. Install the integration from the Gladys store.
  2. Open its Configuration screen and fill in:
    • MELCloud email — the email address of your MELCloud account;
    • MELCloud password — the password of that account (stored as a secret, never displayed back).
  3. Save. The integration logs in to MELCloud and loads your devices.
  4. Open the Discovery screen: your units are listed there. Add the ones you want, then place them in your rooms and dashboards like any Gladys device.

To use another MELCloud account later, just update the email and password in the Configuration screen: the integration reconnects and refreshes the device list automatically.

Troubleshooting​

  • "MELCloud is not configured" during discovery — the email or password is missing: fill in both fields in the Configuration screen and save.
  • Login fails — double-check your credentials by signing in at app.melcloud.com. If MELCloud asks you to accept new terms of use, accept them in the app and try again.
  • A unit is missing from Discovery — make sure it is visible in the MELCloud app with the same account, then run the discovery again.
  • Commands seem ignored — MELCloud can take a few seconds to push a command to the unit; the state in Gladys reflects the cloud state and catches up at the next 10-second poll. Also check that the unit is online in the MELCloud app (Wi-Fi adapter connected).
  • States stop updating — the MELCloud session may have expired; the integration logs in again automatically. If the problem persists, check the integration logs from its configuration page in Gladys.

Konfigurationseinstellungen​

Diese Einstellungen fragt MELCloud in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
MELCloud emailstringJaThe email address of your MELCloud account.
MELCloud passwordsecretJaThe password of your MELCloud account.

So installierst du MELCloud in Gladys​

  1. Öffne in Gladys Integrationen: MELCloud erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/gladysassistant/gladys-melcloud:1.0.2) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/GladysAssistant/gladys-melcloud.

MELCloud benötigt Gladys >=4.62.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

MELCloud ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von GladysAssistant veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am