ha duke energy gateway

Wichtig - veraltet

Duke Energy hat das Gateway -Pilotprogramm Ende Juni 2023 geschlossen. Diese Integration hat die Funktionsweise eingestellt und ist veraltet.

Duke Energy Gateway

Dies ist eine benutzerdefinierte Integration für den Home Assistant. Es zieht über das Duke Energy Gateway-Pilotprogramm den Energieverbrauch in Echtzeit von Duke Energy.

Diese Integration nutzt die von mir geschriebene pyduke-energy Bibliothek, um Daten zu ziehen. Diese API ist sehr inoffiziell und kann jederzeit aufhören zu arbeiten (siehe Haftungsausschluss).

Voraussetzungen! (Bitte lesen)

Sie müssen ein Duke Energy Gateway mit Ihrem SmartMeter angeschlossen haben, damit dies funktioniert. Dies ist ein separates Gerät als Ihr intelligentes Messgerät und wird momentan durch ein Einladungsprogramm bereitgestellt. Wenn Sie nicht wissen, was das ist, haben Sie es wahrscheinlich nicht. Diese Integration unterstützt keine andere Methode zum Abrufen von Daten (siehe Gateway -Anforderung).

Sensoren

Diese Komponente richtet die folgenden Einheiten ein:

sensor.duke_energy_current_usage_w

• Repräsentiert den Echtzeit- Stromverbrauch in Watts.
• Diese Daten werden alle 1-3 Sekunden vom Gateway-Gerät gedrückt. Hinweis: Dies erzeugt viele Daten. Wenn dieses Update -Intervall für Sie zu häufig ist, können Sie ein Drosselintervall in Sekunden konfigurieren (siehe Konfiguration unten).
• Beachten Sie, dass es für den Home Assistant Energy Dashboard nicht wie IS verwendet werden kann, da dies der Stromverbrauch ist. Stattdessen können Sie den sensor.duke_energy_usage_today_kwh verwenden.
• Zusätzliche Attribute sind verfügbar, die die ID und die Gateway -ID für die Messdaten enthalten.

sensor.duke_energy_usage_today_kwh

• Repräsentiert den heutigen Energieverbrauch in Kilowattstunden (von 0:00 Ortszeit bis 23:59 Uhr Ortszeit und dann zurückzusetzen).
• Diese Daten werden alle 60 Sekunden befragt, aber die Daten können aufgrund von Verzögerungen bei der Berichterstattung von Duke Energy bis zu 15 Minuten verzögert werden (siehe Einschränkungen in der pyduke-energy -Repo).
• Dies kann als IS für das Home Assistant Energy Consumption Dashboard verwendet werden.
• Zusätzliche Attribute sind verfügbar, die die Messgerät -ID, die Gateway -ID und den Zeitstempel der letzten Messung enthalten.

Installation

HACS -Installation

1. Fügen Sie als benutzerdefiniertes Repository unter Einstellungen in HACS hinzu: mjmeli/ha-duke-energy-gateway und wählen Sie Integration als Kategorie.
2. Suchen Sie nach "Duke Energy Gateway" in HACs, und die Integration sollte nun als Suchergebnis zurückgegeben werden. Klicken Sie darauf, klicken Sie auf die Schaltfläche "Download" und gehen Sie durch die zum Herunterhaltungsanweisungen angegebenen Eingabeaufforderungen.
3. Start Home Assistant
4. Gehen Sie in der HA UI zu "Einstellungen" -> "Geräte und Dienste", stellen Sie sicher, dass Sie auf der Registerkarte Integrationen sind, dann klicken Sie auf "+" und suchen Sie nach "Duke Energy Gateway". Dadurch können Sie es einrichten.

Manuelle Installation

1. Verwenden des Tools der Wahl das Verzeichnis (Ordner) für Ihre HA -Konfiguration (wo Sie configuration.yaml finden.yaml).
2. Wenn Sie dort kein custom_components -Verzeichnis (Ordner) haben, müssen Sie es erstellen.
3. Erstellen Sie im Verzeichnis custom_components (Ordner) einen neuen Ordner namens duke_energy_gateway .
4. Laden Sie in diesem Repository alle Dateien aus dem custom_components/duke_energy_gateway/ Verzeichnis (Ordner) herunter.
5. Platzieren Sie die Dateien, die Sie im neuen Verzeichnis (Ordner), den Sie erstellt haben, heruntergeladen.
6. Start Home Assistant
7. Gehen Sie in der HA UI zu "Einstellungen" -> "Geräte und Dienste", stellen Sie sicher, dass Sie auf der Registerkarte Integrationen sind, dann klicken Sie auf "+" und suchen Sie nach "Duke Energy Gateway". Dadurch können Sie es einrichten.

Konfiguration

Die Konfiguration erfolgt in der Benutzeroberfläche. Zunächst müssen Sie die folgenden Daten bereitstellen:

Daten	Beschreibung
email	Ihre Login -E -Mail an Duke Energy.
password	Ihr Anmeldepasswort für Duke Energy.

Nach der Einrichtung der Integration können Sie auf der Integrationsseite weitere Konfiguration durchführen, indem Sie auf "Konfigurieren" klicken. Auf diese Weise können Sie die folgenden Optionen ändern:

Daten

Beschreibung

Real-time Usage Update Interval (sec)

Standardmäßig wird der Echtzeit-Verwendungssensor jederzeit aktualisiert, wenn ein Lesen hereinkommt. Wenn diese Daten zu häufig sind, können Sie diesen Wert so konfigurieren, dass Sie die Daten drosseln. Wenn der Sensor auf eine positive Ganzzahl X eingestellt ist, wird er nur einmal alle X Sekunden aktualisiert. Mit anderen Worten, wenn Sie auf 30 gesetzt sind, erhalten Sie alle ~ 30 Sekunden eine neue Echtzeit-Nutzung.

Meterauswahl

Der Konfigurationsfluss versucht automatisch, Ihr Gateway und Ihr SmartMeter zu identifizieren. Im Moment wird nur einer pro Konto unterstützt. Der erste identifizierte identifizierte wird verwendet. Wenn man nicht gefunden werden kann, sollte der Konfigurationsprozess fehlschlagen.

Wenn Ihre Messgerätauswahl fehlschlägt, sollte ein erster Schritt bestehen, um die Protokollierung für die Komponente zu aktivieren (siehe Protokollierung). Wenn dies keinen Einblick in das Problem gibt, öffnen Sie bitte ein Github -Problem.

Protokollierung

Wenn Sie auf Probleme stoßen und sich mit den Protokollen befassen möchten, bietet diese Integration eine ausführliche Protokollierung auf Debug -Ebene. Dies kann aktiviert werden, indem Sie Folgendes zu Ihrer configuration.yaml hinzufügen.YAML -Datei.

 logger :
  default : info
  logs :
    custom_components.duke_energy_gateway : debug
    pyduke_energy.client : debug
    pyduke_energy.realtime : debug 

Entwicklung

Ich schlage vor, den Dev -Container für die Entwicklung durch Öffnen in Visual Studio -Code mit code . und klicken Sie auf die Option zum Wiedereröffnung mit dem Entwicklungscontainer. In VS Code können Sie die Aufgabe "Home Assistant auf dem Port 9123 ausführen" ausführen und dann über http: // localhost: 9123 darauf zugreifen.

Wenn Sie manuell installieren möchten, können Sie Dev -Abhängigkeiten mit pip install -r requirements_dev.txt installieren.

Führen Sie vor dem Verfassen pre-commit run --all-files .

Arbeiten mit in der Entwicklung pyduke-energy Versionen

Wenn Sie an der Implementierung neuer Änderungen aus pyduke-energy arbeiten, aber nicht die Version dieser Bibliothek veröffentlichen möchten, können Sie Ihre Entwicklungsumgebung für die Installation von einer Remote-Arbeitsabteilung einrichten.

1. Aktualisieren Sie requirements_dev.txt , um das main in git+https://github.com/mjmeli/pyduke-energy@main mit Ihrer Arbeitsabteilung zu ersetzen, und aktualisieren Sie die Benutzername, wenn Sie eine Gabel haben (z. B. git+https://github.com/notmjmeli/pyduke-energy@new-feature-dev-branch )
2. Deinstallieren Sie lokal zwischengespeicherte Version von pyduke-energy : pip uninstall -y pyduke-energy
3. Anforderungen erneut ausführen Installation: pip install -r requirements_dev.txt

Beiträge sind willkommen!

Wenn Sie dazu beitragen möchten, lesen Sie bitte die Beitragsrichtlinien

Credits

Dieses Projekt wurde aus der kundenspezifischen Kochvorlage von @OncleBen31 generiert.

Die Codevorlage wurde hauptsächlich aus der Integration_Blueprint -Vorlage von @ludeeus entnommen

---