smartloadmanager

🔧 Beschreibung

Der Adapter smartloadmanager dient der dynamischen Steuerung von Verbrauchern anhand eines PV-Einspeisewertes. Ziel ist es, Überschuss-Strom lokal zu verbrauchen und so die Einspeisung ins öffentliche Netz zu minimieren oder vollständig zu vermeiden. Er unterstützt sowohl Ein/Aus-Verbraucher als auch prozentual regelbare Geräte und Batteriespeicher.

🚀 Funktionen

• ✅ Überwachung eines konfigurierbaren Einspeisungs-Datenpunkts
• ✅ Dynamische Zuschaltung von Verbrauchern bei Überschuss
• ✅ Dynamische Abschaltung bei Defizit oder Netzbezug
• ✅ Unterstützt binary, percent, Heating und battery-Verbraucher
• ✅ Prozentregelung mit Verzögerung (sanftes Rückregeln), optional pro Verbraucher konfigurierbar
• ✅ Dynamische Ladeleistung für Batteriespeicher mit Ziel-SOC
• ✅ Zeitfenster für Ein-/Ausschaltlogik je Verbraucher (inkl. "nur zu Abschaltzeit")
• ✅ Automatische Objekt-Erstellung mit erweiterten Informationen je Verbraucher
• ✅ Steuerungsmodus: Off / Manual On / Auto für jeden Verbraucher separat
• ✅ Hysterese-Steuerung durch separate Ein-/Abschaltgrenzen
• ✅ Verbraucherspezifische Schaltverzögerung (Override der globalen)
• ✅ Reihenfolgenlogik bei Zuschaltung (nach Leistung) und Abschaltung (umgekehrt)
• ✅ Globale Batterie-Schaltverzögerung (batteryDelaySeconds)
• ✅ Schreibprüfung für Batterie-Kontrollmodus (Debug-Ausgabe im Log)
• ✅ Verzögerte Schaltung über Timer für Ein- und Ausschaltung
• ✅ Anzeige laufender Timer im Debug-Log mit verbleibender Zeit
• ✅ Optionale Benachrichtigungen für Ein/Aus, Prozentregelung und Batterie (Telegram / Gotify)
• ✅ Optimierung für 0/1-Datenpunkte für Geräte mit boolean oder numerischer 0/1-Steuerung
• ✅ Detailliertes Logging aller Timer, Überschüsse und Schaltvorgänge
• ✅ Benachrichtigungen pro Verbrauchertyp (Binary, Percent, Battery, Heating), optional aktivierbar
• ✅ Heizungs-/Heizstab-Steuerung mit Temperatur-, Freigabe- und Heartbeat-Prüfung

⚙️ Konfiguration

🔹 Haupteinstellungen

🔹 Verbraucher

🔋 Batteriespeicher-Unterstützung

• Verbraucher mit "ruletype": "battery" regeln den Lade-Setpoint abhängig vom aktuellen Überschuss.
• Falls batterySOC und batteryTargetSOC gesetzt sind, wird ab Zielwert nicht mehr geladen.
• Optional kann ein batteryControlModeDatapoint gesetzt werden:
  • 0 = Aus, 1 = Manuell, 2 = Automatik
• Die Steuerung erfolgt nur innerhalb der konfigurierten Zeitfenster.
• Die Steuerung wird bei jedem FeedIn-Update nach konfigurierter Verzögerung (batteryDelaySeconds) erneut ausgeführt.
• Verzögerungen für alle Schaltungen (binary, percent, battery) können pro Verbraucher oder global angepasst werden.
• Detailliertes Logging und optionale Benachrichtigungen für Batterie-Schaltungen.

🌡️ Heating-Unterstützung

• Verbraucher mit "ruletype": "heating" sind für Heizstäbe oder vergleichbare Verbraucher vorgesehen.
• Steuerung erfolgt nur, wenn: - Aktuelle Temperatur unter maxTemperature liegt - Optional: über minTemperature abgesichert - Optional: enableDatapoint aktiv ist - Optional: heartbeatDatapoint gültig ist
• Bei Nichterfüllung wird Schaltung sofort abgebrochen und Timer gestoppt.
• Unterstützt Ein-/Ausschalt-Timer (onTimerRemaining / offTimerRemaining) mit Restzeitanzeige.
• Detailliertes Logging und optionale Benachrichtigungen für Heating-Verbraucher.

🧠 Steuerlogik

1. Datenpunkt-Messwert wird basierend auf Konfiguration interpretiert (positiv = Netzbezug oder Einspeisung)
2. Überschuss > Grundlast + Einschaltgrenze:
   → Verbraucher werden (binär) nach steigender Leistung zugeschaltet
3. Unterschuss < Grundlast - Abschaltgrenze:
   → Verbraucher werden in umgekehrter Reihenfolge abgeschaltet
4. Regelung für Prozent-Verbraucher:
   → % = Überschuss / Maximalleistung
   → Geregelt nach Verzögerung (global oder pro Verbraucher)
   → Optionale pro-Verbraucher Overrides möglich
5. Regelung für Batterie-Verbraucher:
   → Ladeleistung = min(Überschuss, Maximalleistung), sofern Ziel-SOC nicht erreicht
   → Verzögerung über batteryDelaySeconds oder pro Verbraucher
6. Zeitfensterprüfung für alle Verbraucher
   → Nur aktiv, wenn aktuelle Uhrzeit innerhalb switchOnTime bis switchOffTime
7. Steuerung erfolgt nur bei Steuerungsmodus „Auto (2)“
   → Manuelle Eingriffe (Modus 1 oder 0) bleiben unangetastet
8. Verzögerte Schaltung über Timer
   → Timer wird vor erneuter Schaltung abgebrochen, Restzeit kann im Log angezeigt werden
9. Benachrichtigungen optional für Ein/Aus, Prozent und Batterie
10. Optimierung für 0/1-Datenpunkte
    → Unterstützt boolean oder numerische 0/1-Steuerung automatisch
11. Detailliertes Logging aller Schaltvorgänge, Überschüsse und Timer
12. Regelung für Heating-Verbraucher: → Schaltung nur innerhalb min/max Temperatur und bei gültigen enable-/heartbeat-States → Timer werden abgebrochen, sobald Bedingungen nicht mehr erfüllt sind

💡 Beispiel: Wallbox

Berechnung:

• Überschuss: 1000 - 100 = 900 W
• Prozent: 900 / 11000 ≈ 8,2 % → Wallbox wird auf 8 % geregelt

📋 Objektstruktur

Für jeden Verbraucher wird ein eigener Channel mit folgenden States erzeugt:

• .controlMode → 0 = Aus, 1 = Manuell, 2 = Automatik
• .switchOnTime / .switchOffTime
• .alwaysOffAtTime → true/false
• .performance, .switchOnPoint, .switchOffPoint
• .batterySetpoint (nur für "battery")
• .temperatureDatapoint (nur für "heating")
• .onTimerRemaining / .offTimerRemaining → Restlaufzeit für Ein-/Ausschalt-Timer
• .timer → interner Timer für verzögerte Schaltungen
• .timerEnd → Zeitstempel, wann Timer abläuft (für Log)

🚫 Einschränkungen

• Keine SOC-Historie, keine Langzeitlogik
• Keine Mehrfachverwendung identischer Datenpunkte
• Batterie-Steuerung basiert rein auf FeedIn, keine Rücksicht auf Entladeleistung
• Keine prozentuale Mindestgrenze definierbar (z. B. 10 % min für Wallbox)
• Heating ohne direkte Leistungsmessung – nur Grenzwerte und Freigabe-Checks

🛣️ Zukünftige Features

• PV-Prognosebasierte Steuerung (Beta)
• Unterstützung kombinierter Verbraucher
• Priorisierungs-Profile
• Überhitzungs- oder Fehler-Handling je Gerät
• Minimal- und Maximal-Prozentlimits für Regelung
• Konfigurierbare Gruppen- oder Raumlogik

Changelog

WORK IN PROGRESS

• (copilot) Adapter requires node.js >= 22 now

0.1.2 (2026-04-15)

• (quorle) Update dependencies

0.1.0 (2025-11-07)

• (quorle) Added a checkbox for activating consumers from the settings to the object tree

0.0.8 (2025-10-03)

• (quorle) Fix for binary consumers that do not turn off
• (quorle) Fix for heating elements that are not switched off at max temperature

0.0.7 (2025-09-09)

• (quorle) modified Readme
• (quorle) German and English description created
• (quorle) chore: cleanup devDependencies
• (quorle) Add "label" to jsonConfig.json everywhere
• (quorle) Fixed bugs in timeouts in functions
• (quorle) setTimeout/setInterval allowed maximum values ​​implemented
• (quorle) adapter-core 3.2.3 to 3.3.2 updated
• (quorle) eslint-config 2.0.2 to 2.1.0 updated
• (quorle) testing 5.0.4 to 5.1.0 updated

0.0.6 (2025-09-03)

• (quorle) Adjustments package.json
• (quorle) Code changed

License

MIT License

Copyright (c) 2025-2026 quorle quorle12@gmail.com

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.