Miele CloudService

mielecloudservice-Adapter für ioBroker

Verbinden Sie Ihre Miele-Geräte (XGW3000 & WiFiConn@ct).

Wenn Ihnen dieser Adapter gefällt und Sie mich unterstützen möchten:

Beschreibung

Dieser Adapter dient zum Abrufen von Informationen über alle Ihre Miele@Home-Geräte von der offiziellen Miele Drittanbieter-API. Dies gilt unabhängig davon, ob die Geräte direkt über WLAN oder das Gateway XGW3000 verbunden sind. Er implementiert die Miele Drittanbieter-API V1.0.5.

sentry.io

Dieser Adapter nutzt sentry.io, um Details zu Abstürzen zu erfassen und diese automatisch an den Autor zu melden. Hierfür wird das Plugin ioBroker.sentry verwendet. Auf der Homepage des Plugins finden Sie detaillierte Informationen zu dessen Funktionsweise, den erfassten Daten und wie Sie die Erfassung deaktivieren können, falls Sie den Autor nicht mit Ihren Absturzinformationen unterstützen möchten.

Voraussetzungen

• Miele@Home-Nutzer (Smartphone-App)
• Miele@Home Passwort (Smartphone-App)
• Miele Client_id (von https://www.miele.com/developer/ )
• Miele Client_secret (von https://www.miele.com/developer/ )

Installation

Zur Installation gehen Sie wie folgt vor:

1. Installation über Administrator mithilfe der
2. Installation über Administrator mithilfe der

• Stable-Repository – um die aktuelle stabile Version zu erhalten
• neuestes Repository – um die aktuellste Testversion zu erhalten (möglicherweise nicht stabil).
• via: https://github.com/Grizzelbee/ioBroker.mielecloudservice.git - um die neueste Entwicklungsversion zu erhalten

2. Erstellen Sie ein App-Konto für Miele@Home in der Miele Smartphone-App.
3. Erstellen Sie ein Entwicklerkonto unter https://www.miele.com/f/com/en/register_api.aspx
4. Fügen Sie Ihre Miele-Geräte zur App hinzu (falls sie nicht automatisch hinzugefügt wurden).
5. Geben Sie den vom Miele-Entwicklerteam erhaltenen Client-Schlüssel und die Client-ID sowie die Konto-ID und das Passwort aus der App ein.

Merkmale

Dieser Adapter implementiert derzeit nahezu alle Funktionen der Miele API V1.0.5 und Teile der API V1.0.6. Der Funktionsumfang der API kann (und tut dies aktuell) von dem der iOS- und Android-Apps abweichen. Beispielsweise sind keine Informationen zu TwinDos verfügbar – selbst die Apps geben diese nicht an. Dies umfasst:

• Alle bekannten und dokumentierten Gerätetypen werden unterstützt (API V1.0.6).
• Grundlegende Informationen für alle Gerätetypen.
• Ausführliche Informationen für alle Gerätetypen.
• EcoFeedback (Wasser- und/oder Stromverbrauch) für Geräte, die dies melden.Note: Not all devices report this information - event not if they do so in the iOS or Android apps. Search for the ecoFeedback folder in the device tree.
• Unterstützte Aktionen, die Sie auf diesem Gerät ausführen können – die Fähigkeiten des Geräts werden größtenteils von der API selbst gemeldet.

Bekannte Probleme

• Die Programme werden grundsätzlich ab Version 6.0.0 des Adapters unterstützt. Ausgenommen sind Programme, die zusätzliche Parameter benötigen, wie beispielsweise für Backöfen.

Konfiguration

Grundkonfiguration

Um diesen Adapter in Betrieb zu nehmen, benötigen Sie mindestens Folgendes:

• Miele@Home-Nutzer (über die Smartphone-App)
• Miele@Home Passwort (aus der Smartphone-App)
• Miele Client_id (von https://www.miele.com/developer/ )
• Miele Client_secret (von https://www.miele.com/developer/ )

Daten von Miele-Servern anfordern

Seit Version 6.2.0 haben Sie die Möglichkeit, zwischen folgenden Optionen zu wählen:

• Server-Sent Events (Das Kontrollkästchen „Server-Sent Events“ ist aktiviert – Standardeinstellung und dringend empfohlen )
• Zeitbasierte Datenabfrage (Kontrollkästchen „Server-Sent Events“ ist deaktiviert)
• Verzögerte Verarbeitung

Server-Sent Events (dringend empfohlen)

Server-Sent Events sind eine sehr praktische Methode, um Daten von den Miele-Servern zu erhalten, da diese bei jeder Änderung Daten senden. So entfällt das unnötige Abfragen alle paar Sekunden, unabhängig davon, ob Änderungen vorliegen oder nicht. Leider gibt es bei dieser Verbindungsart Probleme – sie schlägt recht häufig fehl, und nur ein Neustart des Adapters behebt das Problem.

Zeitbasierte Datenabfrage

Um die Stabilität des Adapters zu verbessern, habe ich die Datenabfrage als Konfigurationsoption wieder eingeführt, die Sie verwenden können, wenn SSE fehlschlägt. SSE ist jedoch die Standardeinstellung, und ich empfehle dringend, diese zu testen und zu verwenden, da sie viele Ressourcen sowohl auf Ihrer als auch auf der Mieles-Seite spart. Darüber hinaus konzentriere ich mich seit Version 5.xx auf SSE. Die zeitbasierte Datenabfrage basiert auf den beiden folgenden Konfigurationsoptionen:

• Umfrageintervall
• Einheit des Abfrageintervalls (Sekunden/Minuten)

Verzögerte Verarbeitung

Falls Sie mehrere Miele-Geräte besitzen und diese gleichzeitig nutzen, kann es vorkommen, dass die API innerhalb kurzer Zeit viele Nachrichten sendet. Abhängig von Ihrer ioBroker-Hardware kann dies Ihren Server überlasten und zu einer nicht reagierenden Visualisierung oder einem komplett nicht reagierenden Broker führen. Um dies zu vermeiden, reduziert diese Konfigurationsoption die Anzahl der verarbeiteten Nachrichten auf eine Nachricht alle xxx Millisekunden. Verwandte Konfigurationsoptionen:

• verzögerte Verarbeitung
• Nachrichtenverzögerung

Steuerung Ihrer Geräte

Aktionen

Alle aktuell unterstützten und dokumentierten Aktionen für alle Geräte sind implementiert (API V1.0.5).

Bitte beachten Sie, dass Aktionen nur funktionieren, wenn sich Ihr Gerät im entsprechenden Zustand befindet (z. B. Mobile Steuerung, Einschalten usw.). Weitere Informationen zu Aktionen finden Sie in der Miele-Dokumentation .

Programme (Eingeführt in API V1.0.5)

Mit API V1.0.5 hat Miele einen neuen Endpunkt namens „/programs“ eingeführt. Die Unterstützung für diesen Endpunkt beginnt mit Adapterversion 4.5.0. Es wird ein neuer Datenpunkt [device.Actions.Program] erstellt, der alle von Miele unterstützten Programme auflistet. Durch Auswahl eines Wertes wird das Programm sofort ausgeführt! Aktuell werden nur einfache Programme unterstützt. Beispielsweise benötigen Backöfen zusätzliche Informationen – dies wird in einer zukünftigen Version implementiert.

Bei der Veröffentlichung des Adapters dokumentierte Miele einige Gerätekategorien, die diesen Endpunkt unterstützen sollen. Allerdings funktioniert (zumindest bei mir) nur ein Teil davon. Bei meiner Kaffeemaschine, Waschmaschine und meinem Wäschetrockner funktioniert es nur mit der Kaffeemaschine. Miele arbeitet jedoch daran und erweitert die Unterstützung regelmäßig. Weitere Informationen finden Sie in der allgemeinen Miele-API-Dokumentation (siehe unten).

Dokumentation

Für ein tieferes Verständnis oder eine Rohwertübersetzung konsultieren Sie bitte diese Dokumentation.

Copyright

Copyright © 2025 grizzelbee open.source@hingsen.de

Changelog

6.5.12 (2025-09-01)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Upd: some Dev-Dependencies got removed as told by MCM1957

6.5.11 (2025-08-06)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Fix: Fixed some minor issues found by adapter-checker
• (grizzelbee) Fix: 515 made sentry information more visible
• (grizzelbee) Fix: 514 Removed Node 18 from Tests and added Node24

6.5.10 (2025-04-03)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Fix: 494 Fixed some minor issues found by adapter-checker

6.5.9 (2025-02-26)

• (grizzelbee) Fix: 482 Fixed broken SSE connection

6.5.8 (2025-02-13)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Fix: Fixed some minor issues found by adapter-checker
• (grizzelbee) Fix: Added screen size settings in Admin-UI for responsive design
• (grizzelbee) Fix: Fixed sentry MIELECLOUDSERVICE-5V

6.5.7 (2024-10-01)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Fix: Fixed some minor issues found by adapter-checker
• (grizzelbee) Upd: Added tests for node 22

6.5.6 (2024-05-10) (Dying for an Angel)

• (grizzelbee) New: 402 Added signalDoor to Washing machines, Tumble dryer and Washer dryer
• (grizzelbee) Upd: Dependencies got updated

6.5.5 (2024-01-03) (Dying for an Angel)

• (grizzelbee) Upd: Added year 2024 to licence
• (grizzelbee) Upd: Dependencies got updated

6.5.4 (2023-05-03) (Dying for an Angel)

• (grizzelbee) New: Added file .ncurc.json to prevent axios-oauth-client from being automatically updated by npx npm-check-updates

6.5.3 (2023-04-26) (Dying for an Angel)

• (grizzelbee) Fix: two minor bug fixes - including a fix that prevents objects from being updated constantly.

6.5.2 (2023-04-21) (Dying for an Angel)

• (grizzelbee) Fix: 367 Fixed "oauth is not a function" error during startup by downgrading axios-oauth-client to v1.5.0

6.5.1 (2023-04-21) (Dying for an Angel)

• (grizzelbee) Fix: Some minor fixes for ioBroker adapter checker

6.5.0 (2023-04-18) (Dying for an Angel)

• (grizzelbee) New: added device type 74 = Hob with vapour extraction (part of Miele API v1.0.6)
• (grizzelbee) Upd: Updated ReadMe file
• (grizzelbee) Chg: Dependencies got Updated
• (grizzelbee) Chg: Important: Requires at least Node.js 14
• (grizzelbee) Chg: Changed SpinningSpeed from number to string
• (grizzelbee) New: Added RAW-Value to SpinningSpeed
• (grizzelbee) Chg: Changed PlateStep-xxx from number to string (related to issue 356)
• (grizzelbee) New: Added RAW-Value to Platesteps (related to issue 356)
• (grizzelbee) Fix: 343 GENERIC_BUSINESS_ERROR occurred when switching ventilationStep
• (grizzelbee) Fix: 356 In some cases the value 0 (zero) is ignored (e.g. at PlateStep)
• (grizzelbee) Fix: 359 Fixed "oauth is not a function" error during startup by downgrading axios-oauth-client to v1.5.0

6.4.0 (2022-09-07) (Dying for an Angel)

• (grizzelbee) Fix: program names get localized now
• (grizzelbee) New: moved Admin-UI to jsonConfig
• (grizzelbee) Chg: BREAKING CHANGE: removed duplicate en-/decryption of passwords due to jsonConfig
• (grizzelbee) Chg: Moved some documentation from the readme file to machine_states.md

0.9.1 (2019-07-26)

• (grizzelbee) Fix: Fixed small bug introduced in V0.9.0 throwing an exception in debugging code

0.9.0 (2019-07-26)

• (grizzelbee) Upd: New versioning due to completeness and stability of the adapter (about 90%)
• (grizzelbee) New: make poll interval configurable (currently 1,2,3,4,5,7,10,15 Minutes)
• (grizzelbee) Fix: fixed ESLint config
• (grizzelbee) Upd: Changed order of config fields in UI
• (grizzelbee) New: Set 5 Minutes poll interval and english response language as default to get initial values
• (grizzelbee) New: Parent-Datapoint of time values will be used to get a pretty readable time in the format h:mm. The deeper datapoints 0 and 1 will still be updated, but his will be removed in a future version to reduce workload.

0.0.5 (2019-07-25)

• (grizzelbee) Upd: some code maintenance
• (grizzelbee) New: added reply-language to config
  • Miele API is currently able to reply in German or English, now you can choose.
• (grizzelbee) New: created new Icon
• (grizzelbee) Fix: fixed translation issues and translated adapter UI using gulp
• (grizzelbee) Upd: Made changes to travis requested by apollon77

0.0.4

• (hash99) add devices configuration

0.0.3

• (hash99) adapter conform

0.0.1

• (hash99) initial release

License

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.