Enelix-EMS/docs/public/faq.md

# Häufige Fragen

## Brauche ich für die Dokumentation ein Konto?

Nein. Anleitungen, Modulreferenzen, FAQ und Preisliste sind öffentlich. Ein Konto wird für die persönlichen Funktionen des Lizenzportals benötigt.

## Welche IP-Symcon-Version wird benötigt?

Enelix EMS und Enelix Utils setzen IP-Symcon ab Version 8.0 voraus. Maßgeblich ist der Kernel der Installation, nicht nur die Version der Verwaltungskonsole.

## Muss ich EMS und Utils gemeinsam installieren?

Nein. Utils ist eine eigenständige Bibliothek. Installiere sie zusätzlich, wenn du ihre Module oder entsprechende Manager-Visualisierungen benötigst. Die Funktions- und Lizenzvoraussetzungen des gewählten Moduls gelten weiterhin.

## Welchen Updatekanal soll ich wählen?

Verwende den für deine Anlage freigegebenen Kanal: `main` entspricht Stable, `beta` Beta und `develop` Testing. Vergleiche den installierten Stand mit dem oben angegebenen Dokumentationskanal. Testsoftware benötigt eine kontrollierte Inbetriebnahme.

## Warum bleibt der Manager inaktiv?

Prüfe `Aktiv`, Lizenzstatus und Netzleistungsmessung. Fehlende, veraltete oder falsch normierte Messwerte verhindern korrekte Regelung. Kontrolliere anschließend Verbraucherzuordnung und Störtext. Die [Manager-Anleitung](manager.md) beschreibt die Reihenfolge.

## Wo ordne ich einen Verbraucher zu?

Im Manager. Verbraucher haben keine eigene Manager-ID-Property. Die automatische Suche zeigt Kandidaten; ausgewählt und aktiviert werden sie gezielt.

## Warum wird ein Verbraucher trotz Überschuss nicht eingeschaltet?

Mögliche Ursachen sind lokale Deaktivierung, fehlende Zuordnung, fehlende Lizenzmenge, Gerätefehler, ein zu kleines Budget, Temperaturbedingungen oder Mindestzeiten. Prüfe auch das angebotene Leistungsraster und den aktuellen Betriebszustand. Bei einer Ladestation gehören Fahrzeugstatus, Ladefreigabe und Solarladen dazu.

## Was bedeuten positive und negative Leistungen?

Am Netzanschlusspunkt bedeutet positiv Netzbezug und negativ Einspeisung. Bei Batterien bedeutet positiv Laden und negativ Entladen. Die Messfaktoren müssen die Gerätewerte auf diese Konvention und Watt normieren.

## Wie funktionieren Prioritäten?

Kleinere Zahlen haben Vorrang. PV- und Peak-Priorität werden pro Verbraucher eingestellt. Mindestleistungen und technische Sperren bleiben verbindlich. Der aktuelle schrittweise Verteilalgorithmus ist in der [Manager-Referenz](../module/Manager/README.md) beschrieben.

## Schaltet der Manager-Aus-Schalter die gesamte Anlage sicher ab?

Nein. Er ersetzt keine elektrische Freischaltung oder unabhängige Schutztechnik. Verbraucher können lokale Betriebs- und Schutzfunktionen besitzen. Für Arbeiten an der Anlage gilt das dafür vorgesehene Sicherheitsverfahren.

## Kann ich einen Lizenzcode für mehrere Installationen verwenden?

Die Aktivierung bindet den Code an eine Installations-ID. Eine andere Installation wird abgewiesen. Sichere bei einer Migration die vollständige Manager-Instanz einschließlich ihrer Attribute; kläre einen erforderlichen Gerätewechsel über das Portal beziehungsweise den Betreiber.

## Was passiert ohne Internetverbindung?

Eine bereits bestätigte Manager-Freigabe kann im dokumentierten Entwicklungsstand bis `offlineUntil` genutzt werden, ungefähr 14 Tage nach Ausstellung. Danach wird die Regelung bis zu einer gültigen Serverantwort gesperrt. Verlasse dich auf den tatsächlich angezeigten Lizenzstatus; Cloud-Geräte und Prognosen haben zusätzliche Netzwerkabhängigkeiten.

## Was unterscheidet Lizenz und Ersteinrichtung?

Die direkte Lizenzbestellung enthält die gewählten Lizenzen. Beim Systemkonfigurator kommen die noch nicht bezahlten Einrichtungskosten hinzu. Die [Preisliste](preise.md) zeigt beide Positionen getrennt. Prüfe vor Abschluss die vollständige Bestellung.

## Sind Prognoselizenzen automatisch verlängerte Abonnements?

Der aktuelle Portalstand verwendet datierte Jahresberechtigungen und manuelle Verlängerung, keine automatische Stripe-Abonnementverlängerung. Die Preisseite zeigt die im Katalog hinterlegte Laufzeit. Der intelligente Netzfahrplan benötigt den Manager mit Peak Shaving.

## Sind die Preise aktuell und inklusive MwSt.?

Die [Preisliste](preise.md) liest den aktuellen Backend-Katalog. Sie zeigt Netto- und berechnete Bruttopreise einschließlich des aktuell gültigen, im Backend konfigurierten MwSt.-Satzes. Bei einem Abruffehler werden keine Ersatzpreise angezeigt.

## Aktualisiert ein Git-Update auch meine Anlage?

Nein. Dokumentationsabgleich und Modulupdate sind getrennt. IP-Symcon-Module werden über die Modulverwaltung aktualisiert, mit Sicherung und Nachkontrolle.

## Warum zeigt das Energiediagramm keine Werte?

Prüfe die drei Pflichtzähler, deren Archivierung, die Einheit beziehungsweise den Faktor und den gewählten Zeitraum. Das Modul benötigt Energiezähler, nicht nur momentane Leistungsmessungen.

## Wo stehen Neuerungen und bekannte Fehler?

In der [Kanal- und Fehlerübersicht](versionen.md), den Changelogs und den
Modulreferenzen. Dort werden behobene Codefehler, noch offene Betriebsfehler
und fehlende Abnahmen getrennt. Ein dokumentierter Fix ist kein Beleg dafür,
dass die eigene Anlage bereits aktualisiert wurde.

## Warum fehlen in Stable die beschriebenen Module?

Beim Abgleich vom 8. Oktober 2026 enthält `main` in beiden Repositories noch
die Bibliotheksgrundlage. Die implementierten Module liegen in `beta` und
`develop`. Kanalwechsel nur nach der Freigabe für deine Anlage durchführen;
die Website nennt ihren tatsächlichen Quellkanal.

## Bedeutet unbekannte Autarkie einen Messwert von null?

Nein. Bei einer nicht eindeutig bestimmbaren Energieaufteilung, etwa mit einem
separaten SDL-Zweig, ist eine Prozentzahl nicht belastbar. Das Energiediagramm
zeigt dann die vorhandenen Zähler weiter, aber keine erfundenen Energieanteile.

## Warum zeigt ein aktiver Modulstatus trotzdem keine frischen V4-Werte?

Status `102` bestätigt nicht, dass alle Timer laufen. Am 6. Oktober wurde nach
Modul-Reload ein Batterietimerproblem dokumentiert; am 7. Oktober liefen die
periodischen Timer bei der späteren Nachkontrolle wieder. Die Ursache und
Wiederholbarkeit nach Reload bleiben offen. Vor jedem separat freigegebenen
V4-Test müssen automatischer Timerlauf, Rückmeldung und Stopp nachgewiesen
sein. Keine Schutzgates oder Timer durch zusätzliche Aufrufskripte umgehen.

## Warum startet die Phasenprobe trotz Solarüberschuss nicht?

Bei unbekannten Phasen bietet eine zugeordnete Stand-Alone-Station zunächst
`[0,4104] W` an. Die Probe benötigt eine entsprechende Managerzuteilung sowie
gültige Freigaben und frische Gerätedaten. 3000 W Restbudget reichen nicht.
Im Peakbetrieb mit Solarladen bleibt `[0]` maßgeblich. Eine 0-W-Messung beweist
keine Einphasigkeit. [Details und Beispiele](../module/Ladestation-Stand-Alone/README.md#beispiele-zur-diagnose).

## Bedeutet 0 W, dass ein Fahrzeug vollständig geladen ist?

Nein. Solarpausen, fehlendes Budget oder Autorisierungswartezeit können ebenfalls
0 W ergeben. Seit `5885681` genügt ein niedriger Strom nicht mehr für
`FahrzeugGeladen`. go-e benötigt ein aktuelles explizites Ladeende ohne relevante
Last; Pico besitzt kein eindeutiges Voll-Signal. Historische Pico-Ereignisse
erscheinen getrennt als `Geraetehinweis`.

## Warum hat das Energiediagramm nach dem Speichern andere Farben?

Ältere Symcon-8-Farbfelder waren an Stringwerte gebunden und konnten diese
überschreiben. Seit `2ce95e7` verwendet das Formular native Integer-Farbfelder
und synchronisiert vorhandene Stringwerte. Bereits falsch gespeicherte Farben
müssen gezielt neu gewählt werden. Gleiche Grund- und Akzentfarben ergeben
einen einfarbigen Hintergrund; die Zähler bleiben unverändert.

## Welche Daten sollte ich bei einem Fehler bereithalten?

Notiere Modulname, Version beziehungsweise Kanal, Instanzstatus, genaue Fehlermeldung, Zeitpunkt und die letzten Änderungen. Ergänze relevante Messwerte mit Einheiten. Entferne Lizenzcodes, Kontodaten, Passwörter und Tokens aus Screenshots und Protokollen.