@impact0815/node-red-contrib-home-connect 0.0.0-stage → 0.2.1

package/examples/01-first-steps-device-list.json

@@ -0,0 +1,148 @@
+[
+  {
+    "id": "hc-list-flow",
+    "type": "tab",
+    "label": "Home Connect 01 – Geräteliste",
+    "disabled": false,
+    "info": "Einfachster Start: lokale Testgeräte automatisch erkennen. Keine Zugangsdaten erforderlich."
+  },
+  {
+    "id": "hc-list-note",
+    "type": "comment",
+    "z": "hc-list-flow",
+    "name": "1. Deployen  2. Knopf links klicken  3. Debug-Fenster öffnen",
+    "info": "Der integrierte Simulator führt keine externen Zugriffe aus. Für Production später eine eigene deployte und autorisierte Verbindung auswählen. Outputs include health/warnings (home-connect-health/v1). No firmware data or undocumented endpoint is used.",
+    "x": 310,
+    "y": 40,
+    "wires": []
+  },
+  {
+    "id": "hc-list-config",
+    "type": "home-connect-config",
+    "name": "Home Connect – integrierter Simulator",
+    "environment": "builtin-simulator",
+    "redirectUri": "http://localhost:1880/home-connect/oauth/callback",
+    "scope": "IdentifyAppliance",
+    "language": "de-DE",
+    "allowWrite": false,
+    "requestTimeout": 15000,
+    "maxRequestsPerDay": 900,
+    "minimumRequestInterval": 250
+  },
+  {
+    "id": "hc-list-inject",
+    "type": "inject",
+    "z": "hc-list-flow",
+    "name": "Geräteliste laden",
+    "props": [
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": true,
+    "onceDelay": 1,
+    "topic": "",
+    "payload": "",
+    "payloadType": "date",
+    "x": 140,
+    "y": 100,
+    "wires": [
+      [
+        "hc-list-discover"
+      ]
+    ]
+  },
+  {
+    "id": "hc-list-discover",
+    "type": "home-connect-discover",
+    "z": "hc-list-flow",
+    "name": "Alle Geräte erkennen",
+    "connection": "hc-list-config",
+    "mode": "all",
+    "haId": "",
+    "x": 370,
+    "y": 100,
+    "wires": [
+      [
+        "hc-list-summary",
+        "hc-list-debug-raw"
+      ],
+      [
+        "hc-list-debug-error"
+      ]
+    ]
+  },
+  {
+    "id": "hc-list-summary",
+    "type": "function",
+    "z": "hc-list-flow",
+    "name": "Einfache Geräteliste",
+    "func": "msg.payload=(msg.payload||[]).map(entry=>({name:entry.appliance?.name,brand:entry.appliance?.brand,type:entry.appliance?.type,vib:entry.appliance?.vib,connected:entry.appliance?.connected,health:entry.health,warnings:entry.warnings,haId:entry.appliance?.haId}));\nreturn msg;",
+    "outputs": 1,
+    "timeout": 0,
+    "noerr": 0,
+    "initialize": "",
+    "finalize": "",
+    "libs": [],
+    "x": 610,
+    "y": 80,
+    "wires": [
+      [
+        "hc-list-debug-simple"
+      ]
+    ]
+  },
+  {
+    "id": "hc-list-debug-simple",
+    "type": "debug",
+    "z": "hc-list-flow",
+    "name": "Geräteliste (einfach)",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 870,
+    "y": 80,
+    "wires": []
+  },
+  {
+    "id": "hc-list-debug-raw",
+    "type": "debug",
+    "z": "hc-list-flow",
+    "name": "Vollständige Capabilities",
+    "active": false,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 630,
+    "y": 130,
+    "wires": []
+  },
+  {
+    "id": "hc-list-debug-error",
+    "type": "debug",
+    "z": "hc-list-flow",
+    "name": "Fehler",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 610,
+    "y": 180,
+    "wires": []
+  }
+]

package/examples/02-events.json

@@ -0,0 +1,165 @@
+[
+  {
+    "id": "hc-events-flow",
+    "type": "tab",
+    "label": "Home Connect 02 – Events",
+    "disabled": false,
+    "info": "Ein gemeinsamer Event-Stream für alle Geräte. Output 2 zeigt die eigentliche Ursache eines Reconnects."
+  },
+  {
+    "id": "hc-events-note",
+    "type": "comment",
+    "z": "hc-events-flow",
+    "name": "Ein Stream für alle Geräte • Fehlerausgang immer mit Debug verbinden",
+    "info": "Production: zuerst Test/Geräteliste reparieren. Fehlen Auth oder Monitor-Scopes, zeigt der Node reconnecting. Outputs include health/warnings (home-connect-health/v1). No firmware data or undocumented endpoint is used.",
+    "x": 330,
+    "y": 40,
+    "wires": []
+  },
+  {
+    "id": "hc-events-config",
+    "type": "home-connect-config",
+    "name": "Home Connect – integrierter Simulator",
+    "environment": "builtin-simulator",
+    "redirectUri": "http://localhost:1880/home-connect/oauth/callback",
+    "scope": "IdentifyAppliance",
+    "language": "de-DE",
+    "allowWrite": false,
+    "requestTimeout": 15000,
+    "maxRequestsPerDay": 900,
+    "minimumRequestInterval": 250
+  },
+  {
+    "id": "hc-events-node",
+    "type": "home-connect-events",
+    "z": "hc-events-flow",
+    "name": "Events aller Geräte",
+    "connection": "hc-events-config",
+    "haId": "*",
+    "x": 170,
+    "y": 110,
+    "wires": [
+      [
+        "hc-events-type",
+        "hc-events-debug-all"
+      ],
+      [
+        "hc-events-debug-error"
+      ]
+    ]
+  },
+  {
+    "id": "hc-events-type",
+    "type": "switch",
+    "z": "hc-events-flow",
+    "name": "Eventtyp",
+    "property": "topic",
+    "propertyType": "msg",
+    "rules": [
+      {
+        "t": "eq",
+        "v": "STATUS",
+        "vt": "str"
+      },
+      {
+        "t": "eq",
+        "v": "EVENT",
+        "vt": "str"
+      },
+      {
+        "t": "else"
+      }
+    ],
+    "checkall": "true",
+    "repair": false,
+    "outputs": 3,
+    "x": 390,
+    "y": 100,
+    "wires": [
+      [
+        "hc-events-debug-status"
+      ],
+      [
+        "hc-events-debug-event"
+      ],
+      [
+        "hc-events-debug-other"
+      ]
+    ]
+  },
+  {
+    "id": "hc-events-debug-status",
+    "type": "debug",
+    "z": "hc-events-flow",
+    "name": "STATUS",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "x": 620,
+    "y": 70,
+    "wires": []
+  },
+  {
+    "id": "hc-events-debug-event",
+    "type": "debug",
+    "z": "hc-events-flow",
+    "name": "EVENT",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "x": 620,
+    "y": 110,
+    "wires": []
+  },
+  {
+    "id": "hc-events-debug-other",
+    "type": "debug",
+    "z": "hc-events-flow",
+    "name": "Weitere Events",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "x": 640,
+    "y": 150,
+    "wires": []
+  },
+  {
+    "id": "hc-events-debug-all",
+    "type": "debug",
+    "z": "hc-events-flow",
+    "name": "Alle Events (optional)",
+    "active": false,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 410,
+    "y": 180,
+    "wires": []
+  },
+  {
+    "id": "hc-events-debug-error",
+    "type": "debug",
+    "z": "hc-events-flow",
+    "name": "Reconnect-Ursache / Fehler",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "x": 430,
+    "y": 230,
+    "wires": []
+  }
+]

package/examples/03-safe-read-write.json

@@ -0,0 +1,155 @@
+[
+  {
+    "id": "hc-safe-flow",
+    "type": "tab",
+    "label": "Home Connect 03 – Sicher lesen/schreiben",
+    "disabled": false,
+    "info": "Snapshot lesen und einen Start ausschließlich als Dry-Run validieren."
+  },
+  {
+    "id": "hc-safe-note",
+    "type": "comment",
+    "z": "hc-safe-flow",
+    "name": "Dry-Run sendet nichts • Simulator-ID ist kein echtes Gerät",
+    "info": "Für Production zuerst eigene Geräte entdecken und die erkannte haId auswählen. Dry-Run erst nach Prüfung bewusst deaktivieren. Outputs include health/warnings (home-connect-health/v1). No firmware data or undocumented endpoint is used.",
+    "x": 320,
+    "y": 40,
+    "wires": []
+  },
+  {
+    "id": "hc-safe-config",
+    "type": "home-connect-config",
+    "name": "Home Connect – integrierter Simulator",
+    "environment": "builtin-simulator",
+    "redirectUri": "http://localhost:1880/home-connect/oauth/callback",
+    "scope": "IdentifyAppliance",
+    "language": "de-DE",
+    "allowWrite": true,
+    "requestTimeout": 15000,
+    "maxRequestsPerDay": 900,
+    "minimumRequestInterval": 250
+  },
+  {
+    "id": "hc-safe-read-inject",
+    "type": "inject",
+    "z": "hc-safe-flow",
+    "name": "Backofen-Snapshot lesen",
+    "props": [
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "payload": "",
+    "payloadType": "date",
+    "x": 160,
+    "y": 100,
+    "wires": [
+      [
+        "hc-safe-read"
+      ]
+    ]
+  },
+  {
+    "id": "hc-safe-read",
+    "type": "home-connect-read",
+    "z": "hc-safe-flow",
+    "name": "Snapshot",
+    "connection": "hc-safe-config",
+    "operation": "snapshot",
+    "haId": "oven-001",
+    "key": "",
+    "subKey": "",
+    "x": 390,
+    "y": 100,
+    "wires": [
+      [
+        "hc-safe-debug-data"
+      ],
+      [
+        "hc-safe-debug-error"
+      ]
+    ]
+  },
+  {
+    "id": "hc-safe-write-inject",
+    "type": "inject",
+    "z": "hc-safe-flow",
+    "name": "Start nur validieren",
+    "props": [
+      {
+        "p": "payload",
+        "v": "{\"action\":\"start-program\",\"program\":\"Cooking.Oven.Program.HeatingMode.HotAir\",\"options\":[{\"key\":\"Cooking.Oven.Option.SetpointTemperature\",\"value\":180}],\"confirm\":\"CONFIRM\"}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 150,
+    "y": 170,
+    "wires": [
+      [
+        "hc-safe-write"
+      ]
+    ]
+  },
+  {
+    "id": "hc-safe-write",
+    "type": "home-connect-write",
+    "z": "hc-safe-flow",
+    "name": "Sicherer Dry-Run",
+    "connection": "hc-safe-config",
+    "action": "from-message",
+    "haId": "oven-001",
+    "dryRun": true,
+    "confirmationMode": "token",
+    "allowedApplianceTypes": "Oven",
+    "x": 390,
+    "y": 170,
+    "wires": [
+      [
+        "hc-safe-debug-data"
+      ],
+      [
+        "hc-safe-debug-error"
+      ]
+    ]
+  },
+  {
+    "id": "hc-safe-debug-data",
+    "type": "debug",
+    "z": "hc-safe-flow",
+    "name": "Ergebnis",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 620,
+    "y": 110,
+    "wires": []
+  },
+  {
+    "id": "hc-safe-debug-error",
+    "type": "debug",
+    "z": "hc-safe-flow",
+    "name": "Fehler",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "x": 620,
+    "y": 180,
+    "wires": []
+  }
+]

package/examples/04-local-read-only.json

@@ -0,0 +1,214 @@
+[
+  {
+    "id": "hc-local-tab",
+    "type": "tab",
+    "label": "04 Local LAN read-only",
+    "disabled": false,
+    "info": "Anonymized example. BEFORE DEPLOYING: open the Local Home Connect configuration, mount/select the protected Profile Downloader folder, click Scan profiles / Detect devices, enter one private Host/IP per card, leave Auto selected, and click Test connection on every card. The test immediately uses the visible Host/IP and transport; Done serializes them again for Deploy. Read selects the descriptive device label but stores the full technical ID; Events selects one or all configured devices. No local write node is included."
+  },
+  {
+    "id": "hc-local-config",
+    "type": "home-connect-config",
+    "name": "Home Connect Local – read-only",
+    "environment": "local",
+    "redirectUri": "http://localhost:1880/home-connect/oauth/callback",
+    "scope": "IdentifyAppliance",
+    "language": "de-DE",
+    "requestTimeout": 15000,
+    "maxRequestsPerDay": 900,
+    "minimumRequestInterval": 250,
+    "localProfilePath": "/data/homeconnect-profiles",
+    "allowWrite": false,
+    "localDeviceMappings": "[]"
+  },
+  {
+    "id": "hc-local-note",
+    "type": "comment",
+    "z": "hc-local-tab",
+    "name": "ZUERST ÖFFNEN: Ordner → Suchen → IP → Test → Deploy",
+    "info": "DE (einfacher Ablauf): 1. Profilordner in den Node-RED-Container nur lesend mounten. 2. Diese Config öffnen und Local LAN (read-only) wählen. 3. Ordnerpfad eintragen. 4. Profile suchen / Geräte erkennen anklicken. 5. In jeder Gerätekarte eine private IP/Host eintragen. 6. Auto (empfohlen) lassen. 7. Je Karte Verbindung testen; der Test verwendet sofort die sichtbaren Werte. 8. Fertig und Deployen; dabei wird die Zuordnung nochmals gespeichert. Danach im Read-Node die verständliche Gerätebezeichnung/Ressource und im Events-Node ein Gerät oder alle wählen. Intern bleibt die vollständige ID erhalten. Profile enthalten PSK/IV und dürfen nicht veröffentlicht werden.\n\nEN: 1. Mount the profile folder read-only inside the Node-RED container. 2. Open this config and select Local LAN (read-only). 3. Enter the folder. 4. Click Scan profiles / Detect devices. 5. Enter a private Host/IP in every card. 6. Leave Auto (recommended). 7. Test every card; the visible values are used immediately. 8. Done and Deploy serializes the mappings again. Read selects the descriptive device label/resource; Events selects one/all while the full ID stays internal. Never publish profile keys.",
+    "x": 300,
+    "y": 80,
+    "wires": []
+  },
+  {
+    "id": "hc-local-inject",
+    "type": "inject",
+    "z": "hc-local-tab",
+    "name": "Lokale Geräte lesen / Read local appliances",
+    "props": [
+      {
+        "p": "payload"
+      },
+      {
+        "p": "topic",
+        "vt": "str"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "home-connect/local/discover",
+    "payload": "",
+    "payloadType": "date",
+    "x": 250,
+    "y": 150,
+    "wires": [
+      [
+        "hc-local-discover"
+      ]
+    ]
+  },
+  {
+    "id": "hc-local-discover",
+    "type": "home-connect-discover",
+    "z": "hc-local-tab",
+    "name": "Local discover (read-only)",
+    "connection": "hc-local-config",
+    "mode": "all",
+    "haId": "",
+    "x": 540,
+    "y": 150,
+    "wires": [
+      [
+        "hc-local-debug"
+      ],
+      [
+        "hc-local-error"
+      ]
+    ]
+  },
+  {
+    "id": "hc-local-events",
+    "type": "home-connect-events",
+    "z": "hc-local-tab",
+    "name": "Local events (all profiles)",
+    "connection": "hc-local-config",
+    "haId": "*",
+    "x": 250,
+    "y": 230,
+    "wires": [
+      [
+        "hc-local-event-debug"
+      ],
+      [
+        "hc-local-error"
+      ]
+    ]
+  },
+  {
+    "id": "hc-local-debug",
+    "type": "debug",
+    "z": "hc-local-tab",
+    "name": "Local appliance snapshots",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 800,
+    "y": 150,
+    "wires": []
+  },
+  {
+    "id": "hc-local-event-debug",
+    "type": "debug",
+    "z": "hc-local-tab",
+    "name": "Local status events",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 550,
+    "y": 230,
+    "wires": []
+  },
+  {
+    "id": "hc-local-error",
+    "type": "debug",
+    "z": "hc-local-tab",
+    "name": "Structured local error",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 810,
+    "y": 250,
+    "wires": []
+  },
+  {
+    "id": "hc-local-read-inject",
+    "type": "inject",
+    "z": "hc-local-tab",
+    "name": "Read selected local snapshot",
+    "props": [
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "payload": "",
+    "payloadType": "date",
+    "x": 230,
+    "y": 310,
+    "wires": [
+      [
+        "hc-local-read"
+      ]
+    ]
+  },
+  {
+    "id": "hc-local-read",
+    "type": "home-connect-read",
+    "z": "hc-local-tab",
+    "name": "Select detected device + Snapshot",
+    "connection": "hc-local-config",
+    "operation": "snapshot",
+    "haId": "",
+    "key": "",
+    "subKey": "",
+    "x": 530,
+    "y": 310,
+    "wires": [
+      [
+        "hc-local-read-debug"
+      ],
+      [
+        "hc-local-error"
+      ]
+    ]
+  },
+  {
+    "id": "hc-local-read-debug",
+    "type": "debug",
+    "z": "hc-local-tab",
+    "name": "Selected local read",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 810,
+    "y": 310,
+    "wires": []
+  }
+]