easee_hass -Download - easee_hass -Quellcode-Download

easee_hass

Anderer Quellcode

Switches, buttons and actions

Herunterladen

WICHTIG!

Bitte aktualisieren Sie so schnell wie möglich auf v0.9.64 oder eine neuere Version, wenn Sie eine Version zwischen v0.9.58 und v0.9.62 verwenden! Bei allen Versionen dieser Integration zwischen v0.9.58 und v0.9.62 gab es ein Problem mit der Fehlerbehandlung bei der Signalr-Wiederverbindung, das zu vielen fehlgeschlagenen Zugriffen auf Easee-Signalr-Server führte. Die Installation einer neueren Version trägt dazu bei, die Stabilität der Easee-Server zu verbessern und Ressourcen für eine schnellere Reaktion freizugeben. Möglicherweise hatten Sie bei Ihrer Installation keine Probleme, aber unter der Haube gab es viele Probleme. Weitere Details finden Sie in den Versionshinweisen zu v0.9.64.

Easee EV-Ladekomponente für Home Assistant

Benutzerdefinierte Komponente zur Unterstützung von Easee EV-Ladegeräten und Equalizern.

Der Statussensor ist der Standardsensor und hat die folgenden Werte

 disconnected
awaiting_start
charging
ready_to_charge
completed
error

Einige der anderen nicht üblichen Sensoren wie Strom und Spannung sind standardmäßig deaktiviert (werden als „nicht verfügbar“ angezeigt). Sie können in der HA-GUI über Integrationen->[Easee-Name]->Geräte->[Easee Equilizer-Name] aktiviert werden. Klicken Sie unter Diagnose auf Strom/Spannung->Getriebesymbol und dann auf „Aktivieren“. Jeder dieser Sensoren verfügt außerdem über Attribute, die Werte wie Strom und Spannung pro Phase enthalten. Informationen zur Verwendung dieser Attribute finden Sie in Nr. 271.

Installation

Es gibt zwei verschiedene Methoden zur Installation der benutzerdefinierten Komponente

HACS-Installation

Fügen Sie dieses Repository über HACS->Integrationen hinzu.
Starten Sie Home Assistant neu.
Installieren Sie die Komponente über Einstellungen->Integrationen. Möglicherweise müssen Sie den Browser-Cache leeren, damit die Easee-Integration in der Liste angezeigt wird.

Git-Installation

Stellen Sie sicher, dass Git auf Ihrem Computer installiert ist.
Navigieren Sie zu Ihrem Home Assistant-Konfigurationsordner.
Erstellen Sie einen Ordner custom_components , der nicht vorhanden ist. Navigieren Sie nach der Erstellung dorthin.
Führen Sie den folgenden Befehl aus: git clone https://github.com/nordicopen/easee_hass.git easee
Führen Sie bash links.sh aus

Überwachte Ladegeräte/Equalizer

Seit Version 0.9.47 umfasst die Integration nur die Ladegeräte und Equalizer, die zur offiziellen Easee-App hinzugefügt wurden, anstatt alle anzuzeigen, die dem angemeldeten Benutzer zur Verfügung stehen. Diese Änderung wurde vorgenommen, da bei größeren Installationen möglicherweise 10 oder 100 Ladegeräte aufgelistet sind, was in den meisten Fällen wenig Sinn macht. Wenn Sie also nicht alle Ihre Produkte in der Integration sehen, öffnen Sie die offizielle App und stellen Sie sicher, dass sie zuerst dort aufgeführt sind. Beachten Sie außerdem, dass bei der Installation die Fehlermeldung „Keine Websites in diesem Konto gefunden“ angezeigt wird, wenn der App überhaupt keine Ladegeräte hinzugefügt werden.

Konfiguration

Die Konfiguration erfolgt über Konfiguration > Integrationen, wo Sie sie zunächst konfigurieren und dann die Optionen für das festlegen, was Sie überwachen möchten.

Verwenden

Die grundsätzliche Nutzung der Integrationen aus der Benutzeroberfläche sollte selbsterklärend sein. Die Integration definiert eine Reihe von Diensten, die aus Automatisierungen und Skripten zur Steuerung des Ladegeräts und des Ladevorgangs genutzt werden können. Die verfügbaren Dienste finden Sie im Home Assistant unter Entwicklertools->Dienste.

Der einfachste Weg, Dienste und ihre Parameter einzurichten, ist die Verwendung des Automatisierungseditors oder der Entwicklertools. Sie können den Code jedoch auch in einfachem Yaml schreiben. Die Benutzeroberfläche verwendet „device_id“ als Ziel für die Dienste. Dies ist eine zufällige Zeichenfolge, die intern von HA generiert wird und nicht sehr benutzerfreundlich ist. Zur Vereinfachung für Hardcore-Programmierer und zur Gewährleistung der Abwärtskompatibilität mit früheren Versionen dieser Integration können Sie auch „charger_id“ oder „Circuit_id“ als Ziele verwenden. Drei Beispiele, die dasselbe bewirken:

 service : easee.set_circuit_dynamic_limit
data :
  device_id : b40f1f45d28b0891
  current_p1 : 10

 service : easee.set_circuit_dynamic_limit
data :
  charger_id : EVK1234
  current_p1 : 10

 service : easee.set_circuit_dynamic_limit
data :
  circuit_id : 30456
  current_p1 : 10

Einzelheiten zur Easee-API finden Sie unter https://developer.easee.cloud/reference

Debug-Protokollierung

Ein vollständiges Debug-Protokoll kann aktiviert werden, indem Sie Folgendes in configuration.yaml eingeben und Home Assistant neu starten

 logger :
  default : info
  logs :
    pyeasee : debug
    custom_components.easee : debug

Entwicklungscontainer

Eine Option für die Entwicklung ist die Verwendung des VS Code Dev Containers. Sie müssen Docker installiert haben.

Öffnen Sie einen neuen leeren vscode
Wählen Sie Befehlspalette->Dev-Container: Repository im benannten Container-Volume klonen
Befolgen Sie die Anweisungen
Warten Sie, bis der Container erstellt wurde.
Drücken Sie Ctrl + Shift + P und wählen Sie Tasks: Run Task > Run Home Assistant on port 9125 .
Warten Sie, bis Home Assistant gestartet ist, und gehen Sie zu http://localhost:9125/.
Gehen Sie durch die Erststart-Benutzeroberfläche von Home Assistant.
Gehen Sie zu http://localhost:9125/config/integrations, klicken Sie auf Add Integration und fügen Sie die Easee Integration hinzu.
Drücken Sie zum Debuggen F5 , um eine Verbindung zum Home Assistant herzustellen, der im Container ausgeführt wird.

Laufen Sie immer

$ make lint

bevor Sie Ihre Änderungen übernehmen.

Übersetzung

Für die Einreichung von Übersetzungen nutzen wir Lokalise. Sie bieten uns eine erstaunliche Plattform, die einfach zu bedienen und zu warten ist.

Um bei der Übersetzung der Easee-Integration zu helfen, klicken Sie hier. Wenn Sie aufgefordert werden, sich anzumelden, ist es normalerweise am einfachsten, „Mit GitHub anmelden“ zu verwenden.

Wenn Sie eine neue Sprache hinzufügen möchten, öffnen Sie bitte hier in diesem Repo ein Problem.

Die Übersetzungen werden abgerufen, wenn eine neue Version der Integration vorbereitet wird. Sie müssen also warten, bis es eine neue Version gibt, bis Sie nach Updates suchen.

Wenn Sie neue Elemente hinzufügen möchten, die übersetzt werden müssen, sollten Sie diese in /translations/en.json eingeben und eine PR einreichen. Die neuen Schlüssel werden in Lokalise angezeigt, wenn der PR zusammengeführt wird.