iobroker.miele-local 0.3.39 → 0.3.40

package/README.md

@@ -47,6 +47,14 @@ so the page stops at a spinning wheel and you read the address out of the browse
 GroupID and GroupKey are then stored in the instance configuration, the key encrypted. You never
 need this procedure again.
 
+**Login fails with `invalid_request … unknown contextId`?** Miele's login service switches between
+two domains during sign-in and loses its session when an ad blocker or strict third-party cookie
+protection interferes. Open the login page in a private window without extensions.
+
+**Moving to another system.** GroupID and GroupKey never change. A backup of the ioBroker
+configuration (e.g. BackItUp) carries them over; on a fresh system repeating the login takes two
+minutes. The admin page shows the key only as a placeholder.
+
 ## What you get
 
 Every appliance becomes one device with its serial number as the ID. Below it:
@@ -123,7 +131,9 @@ Every field carries its explanation underneath it in the admin; this page does n
 | outbound | TCP 443 → miele-iot.com | fetch the GroupKey | login only |
 
 Without push **no inbound port** is needed. For mDNS, ioBroker and the appliances must sit in the
-same broadcast segment.
+same broadcast segment. Separate IoT WLANs or VLANs, firewalls (including the Windows firewall on
+a test machine) and routers that filter multicast stop discovery just as well. In all these cases
+the manual IP list is the reliable way.
 
 **Docker.** In a container with bridge networking multicast is not forwarded, so discovery finds
 nothing — enter the IP addresses by hand, polling then works normally. Push does not work there at
@@ -227,6 +237,10 @@ engineering work of the projects `MieleRESTServer` (akappner),
 	### **WORK IN PROGRESS**
 -->
 
+### 0.3.40
+
+- (SmarthomeElektroniker) README: hints for a failing login (ad blocker), moving to another system and why mDNS may find nothing; clearer log message when no appliance is found (#12, thanks @meistermopper)
+
 ### 0.3.39
 
 - (SmarthomeElektroniker) Unknown program or phase IDs are now shown as "Programm 201" / "Phase 1234" instead of keeping the text of the previous program (#13)

package/README_de.md

@@ -49,6 +49,15 @@ selbst aus dem Browser heraus.
 GroupID und GroupKey stehen danach in der Instanzkonfiguration, der Schlüssel verschlüsselt.
 Diese Prozedur braucht man nie wieder.
 
+**Anmeldung scheitert mit `invalid_request … unknown contextId`?** Mieles Anmeldedienst wechselt
+beim Login zwischen zwei Domains und verliert die Sitzung, wenn ein Werbeblocker oder ein strenger
+Schutz vor Drittanbieter-Cookies dazwischenfunkt. Die Login-Seite dann in einem privaten Fenster
+ohne Erweiterungen öffnen.
+
+**Umzug auf ein anderes System.** GroupID und GroupKey ändern sich nie. Eine Sicherung der
+ioBroker-Konfiguration (etwa mit BackItUp) nimmt sie mit; auf einem frischen System dauert der
+Login erneut zwei Minuten. Die Admin-Seite zeigt den Schlüssel nur als Platzhalter.
+
 ## Was dabei herauskommt
 
 Jedes Gerät wird ein Objekt mit seiner Seriennummer als Kennung. Darunter:
@@ -125,7 +134,9 @@ Jedes Feld trägt seine Erklärung im Admin direkt unter sich; diese Seite wiede
 | ausgehend | TCP 443 → miele-iot.com | GroupKey abrufen | nur bei der Anmeldung |
 
 Ohne Push ist **kein eingehender Port** nötig. Für mDNS müssen ioBroker und die Geräte im selben
-Broadcast-Segment liegen.
+Broadcast-Segment liegen. Getrennte IoT-WLANs oder VLANs, Firewalls (auch die Windows-Firewall auf
+einem Testrechner) und Router, die Multicast filtern, verhindern die Suche genauso. In all diesen
+Fällen ist die manuelle IP-Liste der verlässliche Weg.
 
 **Docker.** In einem Container mit Bridge-Netz wird Multicast nicht weitergereicht, die Suche
 findet also nichts – die IP-Adressen von Hand eintragen, das Abfragen läuft dann normal. Push

package/io-package.json

@@ -1,7 +1,7 @@
 {
   "common": {
     "name": "miele-local",
-    "version": "0.3.39",
+    "version": "0.3.40",
     "titleLang": {
       "en": "Miele@local",
       "de": "Miele@local",
@@ -52,6 +52,19 @@
     "readme": "https://github.com/SmarthomeElektroniker/ioBroker.miele-local/blob/main/README.md",
     "loglevel": "info",
     "news": {
+      "0.3.40": {
+        "en": "README: hints for a failing login (ad blocker), moving to another system and why mDNS may find nothing; clearer log message when no appliance is found (#12).",
+        "de": "README: Hinweise bei scheiterndem Login (Werbeblocker), zum Umzug auf ein anderes System und warum mDNS nichts findet; deutlichere Logmeldung, wenn kein Gerät gefunden wird (#12).",
+        "ru": "README: подсказки при неудачном входе (блокировщик рекламы), при переносе на другую систему и о том, почему mDNS ничего не находит; более понятное сообщение в журнале, если устройство не найдено (#12).",
+        "pt": "README: dicas para um login falhado (bloqueador de anúncios), para mudar para outro sistema e porque o mDNS pode não encontrar nada; mensagem de registo mais clara quando nenhum aparelho é encontrado (#12).",
+        "nl": "README: tips bij een mislukte login (adblocker), bij verhuizing naar een ander systeem en waarom mDNS niets vindt; duidelijkere logmelding als er geen apparaat wordt gevonden (#12).",
+        "fr": "README : conseils en cas d'échec de connexion (bloqueur de publicités), pour migrer vers un autre système et pourquoi mDNS ne trouve rien ; message de journal plus clair lorsqu'aucun appareil n'est trouvé (#12).",
+        "it": "README: suggerimenti per un login non riuscito (blocco pubblicità), per il trasferimento su un altro sistema e perché mDNS non trova nulla; messaggio di log più chiaro quando non viene trovato alcun apparecchio (#12).",
+        "es": "README: consejos para un inicio de sesión fallido (bloqueador de anuncios), para migrar a otro sistema y por qué mDNS no encuentra nada; mensaje de registro más claro cuando no se encuentra ningún aparato (#12).",
+        "pl": "README: wskazówki przy nieudanym logowaniu (bloker reklam), przy przenoszeniu na inny system i dlaczego mDNS nic nie znajduje; czytelniejszy komunikat w dzienniku, gdy nie znaleziono urządzenia (#12).",
+        "uk": "README: підказки при невдалому вході (блокувальник реклами), при перенесенні на іншу систему та чому mDNS нічого не знаходить; зрозуміліше повідомлення в журналі, якщо пристрій не знайдено (#12).",
+        "zh-cn": "README：登录失败（广告拦截器）、迁移到其他系统以及 mDNS 找不到设备原因的提示；未找到设备时日志信息更清晰 (#12)。"
+      },
       "0.3.39": {
         "en": "Unknown program or phase IDs are shown as \"Programm 201\" instead of keeping the text of the previous program. Dishwasher program IDs of the G7771 added (#13).",
         "de": "Unbekannte Programm- oder Phasennummern erscheinen als „Programm 201“, statt den Text des vorigen Programms stehen zu lassen. Programmnummern des Geschirrspülers G7771 ergänzt (#13).",

package/main.js

@@ -312,7 +312,11 @@ class MieleLocal extends utils.Adapter {
         await this.discoverDevices();
 
         if (!Object.keys(this.devices).length) {
-            this.log.warn('No Miele devices found (neither via mDNS nor manually configured).');
+            this.log.warn(
+                'No Miele devices found (neither via mDNS nor manually configured). If the appliances are in ' +
+                    'another subnet/VLAN, behind a firewall or multicast is blocked (e.g. Docker bridge network), ' +
+                    "enter their IP addresses on the 'Appliances' tab.",
+            );
         } else {
             await this.setStateAsync('info.connection', { val: true, ack: true });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.miele-local",
-  "version": "0.3.39",
+  "version": "0.3.40",
   "description": "Connect modern Miele@Home appliances locally without the internet (MieleH256/DOP2).",
   "author": "Immanuel <github@freitag.online>",
   "license": "MIT",