Full Home Assistant Integration for Ampere Point Q Series Chargers — Step-by-Step Guide

Vollständige Home Assistant Integration für Ampere Point Q Series Ladegeräte — Schritt-für-Schritt-Anleitung

Eine Schritt-für-Schritt-Anleitung: von der Installation von Home Assistant über HACS und xtend_tuya bis hin zu vollständigen Ladegerätedaten, dem Energie-Dashboard und nützlichen Automatisierungen. So geschrieben, dass auch jemand, der Home Assistant noch nie benutzt hat, folgen kann.

Modelle: Q11, Q22, Q37, Q74  ·  aktualisiert: Juli 2026

Ampere Point Q Series-Ladegeräte sind WLAN-Ladegeräte, die auf der Tuya-Plattform basieren. Das bedeutet, sie können mit Home Assistant, dem beliebtesten kostenlosen Smart-Home-System, verbunden und für viel mehr als nur die Grundsteuerung in einer mobilen App genutzt werden:

  • Live-Überwachung: Leistung, Strom und Spannung für jede Phase, Sitzungsenergie, Gesamtenergie und Ladezustand,
  • Steuerung: Laden starten und stoppen, Strombegrenzung ändern,
  • Automatisierungen: Laden nur während Niedertarifzeiten, aus überschüssiger Solarproduktion oder nach dynamischen Strompreisen,
  • Verlauf und Verbrauchsstatistiken im Energie-Dashboard, nützlich für Berichte und Kostenverfolgung.

Die Integration funktioniert über die Tuya-Cloud, daher benötigen sowohl das Ladegerät als auch Home Assistant Internetzugang.

Inhaltsverzeichnis

  1. Was Sie benötigen
  2. Installation von Home Assistant, falls Sie es noch nicht haben
  3. Installation von HACS
  4. Offizielle Tuya-Integration
  5. xtend_tuya Add-on für mehr Ladegerätedaten
  6. Vollständiger Datensatz mit Tuya-Entwickler-Cloud-Schlüsseln
  7. Was Sie nach der Integration und dem Energie-Dashboard erhalten
  8. Beispielautomatisierungen
  9. Häufige Probleme und Lösungen
  10. Alternative: lokale Steuerung mit tuya-local
  11. Alle Links an einem Ort

1. Was Sie benötigen

2. Installation von Home Assistant, falls Sie es noch nicht haben

Wenn Home Assistant bereits für Sie läuft, gehen Sie direkt zu Abschnitt 3.

Option A: dediziertes Gerät, langfristig empfohlen

Auf einem Raspberry Pi, Mini-PC oder älteren Laptop ist der einfachste Weg Home Assistant OS. Es ist ein komplettes System, das Home Assistant, Updates und Backups verwaltet. Offizielle Anweisungen für jede Plattform finden Sie hier: home-assistant.io/installation. Nach der Installation ist das Dashboard normalerweise im Browser unter http://homeassistant.local:8123 erreichbar.

Option B: Windows-Computer mit Docker

Dies ist ein guter Ausgangspunkt zum Testen. Home Assistant läuft in einem Container auf Ihrem normalen Computer. Denken Sie daran, dass Automatisierungen nur funktionieren, wenn der Computer eingeschaltet ist und Docker läuft.

  1. Installieren Sie WSL2, das Docker unter Windows benötigt. Klicken Sie mit der rechten Maustaste auf das Startmenü, öffnen Sie Terminal (Administrator), geben Sie wsl --install ein, bestätigen Sie und starten Sie den Computer neu, wenn die Installation abgeschlossen ist. Microsoft-Anweisungen: learn.microsoft.com/pl-pl/windows/wsl/install.
  2. Installieren Sie Docker Desktop: docker.com/products/docker-desktop. Aktivieren Sie während der Installation die WSL 2-Option. Nach dem Start von Docker Desktop warten Sie, bis der Status anzeigt, dass es läuft. Die Erstellung eines Docker-Kontos kann übersprungen werden.
  3. Starten Sie Home Assistant. Öffnen Sie das Terminal ohne Administratorrechte und fügen Sie Folgendes ein: 
    mkdir C:\HomeAssistant\config
docker run -d --name homeassistant --restart=unless-stopped -e TZ=Europe/Warsaw -v "C:\HomeAssistant\config:/config" -p 8123:8123 ghcr.io/home-assistant/home-assistant:stable
    Der erste Start lädt etwa 1,5 GB herunter und dauert normalerweise einige Minuten.
  4. Öffnen http://localhost:8123 in Ihrem Browser. Wenn es nicht sofort lädt, warten Sie ein oder zwei Minuten und aktualisieren Sie die Seite.

Bei der Docker-Option starten Sie Home Assistant in Docker Desktop neu: Container → homeassistant → Neustart-Symbol. Sie können auch docker restart homeassistant verwenden. Die Neustart-Schaltfläche erscheint in diesem Setup möglicherweise nicht im Home Assistant-Menü, was normal ist. Sie müssen in den nächsten Schritten mehrmals neu starten.

Erster Start für beide Optionen

Der Willkommensassistent wird Sie bitten, ein lokales Konto zu erstellen, den Standort auszuwählen und Einheiten festzulegen. Speichern Sie den Benutzernamen und das Passwort an einem sicheren Ort. Die Liste der automatisch erkannten Geräte können Sie in diesem Schritt überspringen.

3. Installation von HACS

HACS, der Home Assistant Community Store, ist ein Community-Add-on-Store. Wir werden ihn verwenden, um xtend_tuya zu installieren. Offizielle Anweisungen finden Sie hier: hacs.xyz/docs/use/download/download. Wählen Sie den Tab, der zu Ihrer Installation passt.

  • Home Assistant OS: Fügen Sie das Add-on-Repository https://github.com/hacs/addons gemäß den offiziellen Anweisungen hinzu, installieren und starten Sie das Add-on Get HACS und starten Sie dann Home Assistant neu.
  • Docker-Option: Führen Sie dies im Terminal aus: 
    docker exec homeassistant bash -c "wget -O - https://get.hacs.xyz | bash -"
docker restart homeassistant

Nach dem Neustart fügen Sie die Integration hinzu: Einstellungen → Geräte & Dienste → Integration hinzufügen, suchen Sie nach HACS und akzeptieren Sie die Bedingungen. Home Assistant zeigt einen Code an, den Sie nach dem Einloggen bei GitHub unter github.com/login/device eingeben müssen. Bestätigen Sie mit Autorisieren. Nach kurzer Zeit erscheint HACS in der Seitenleiste.

4. Offizielle Tuya-Integration

Dieser Schritt verbindet Home Assistant mit Ihrem Smart Life-Konto.

  1. Gehen Sie zu Einstellungen → Geräte & Dienste → Integration hinzufügen und suchen Sie nach Tuya.
  2. Der Assistent fragt nach Ihrem Benutzer-Code. In der Smart Life App finden Sie ihn unter Ich → Einstellungen-Zahnrad → Konto und Sicherheit → Benutzer-Code. Geben Sie ihn genau ein. Groß- und Kleinschreibung ist wichtig.
  3. Ein QR-Code wird auf dem Bildschirm angezeigt. Verwenden Sie in Smart Life den Scanner in der oberen rechten Ecke des Ich-Tabs, scannen Sie den Code und bestätigen Sie die Anmeldung auf Ihrem Telefon.
  4. Nach kurzer Zeit sollte Ihr Ladegerät in der Geräteliste erscheinen.

Was Sie erwarten können: Die offizielle Tuya-Integration zeigt normalerweise nur eine Entität für das Ladegerät an, oft einen Ladeschalter. Vollständige Daten wie Leistung, Ströme, Spannungen, Energie und detaillierter Status erscheinen nach dem Hinzufügen von xtend_tuya in den nächsten Schritten. Fehlende Sensoren in diesem Stadium sind kein Fehler.

5. xtend_tuya Add-on für mehr Ladegerätedaten

xtend_tuya arbeitet neben der offiziellen Tuya-Integration und fügt den gleichen Geräten fehlende Entitäten hinzu. Projektseite: github.com/azerty9971/xtend_tuya.

5.1. Download in HACS

  1. Öffnen Sie HACS in der Seitenleiste und suchen Sie nach Xtend Tuya. Sie können auch diesen direkten Link verwenden: Xtend Tuya in meinem Home Assistant öffnen.
  2. Klicken Sie auf der Add-on-Seite auf Download und bestätigen Sie.
  3. Starten Sie Home Assistant neu.

Der Download in HACS ist nur die erste Hälfte des Prozesses. Er kopiert Dateien auf die Festplatte, fügt die Integration aber noch nicht hinzu. Entitäten erscheinen erst, nachdem Sie die Integration im Abschnitt 5.2 hinzugefügt haben. Dies ist das häufigste Missverständnis bei der gesamten Einrichtung: Nach dem Download verschwindet die Schaltfläche „Download“, die Add-on-Seite zeigt nur eine Beschreibung an, und die Anzahl der Entitäten wächst auch nach Neustarts nicht. Wenn Sie dies sehen, ist alles in Ordnung. Fahren Sie mit dem nächsten Schritt fort.

5.2. Integration hinzufügen

  1. Gehen Sie zu Einstellungen → Geräte & Dienste → Integration hinzufügen und suchen Sie nach Xtend Tuya.
  2. Geben Sie denselben Benutzer-Code wie in Abschnitt 4 ein und scannen Sie den QR-Code erneut mit der Smart Life-App.
  3. Nach Bestätigung des QR-Codes erscheint ein neues Fenster namens Tuya OpenAPI-Credentials hinzufügen. Lesen Sie die untenstehende Anmerkung, bevor Sie etwas anklicken.

Der wichtigste Tipp in dieser Anleitung. Schließen Sie das Fenster Tuya OpenAPI-Credentials hinzufügen nicht mit der X-Schaltfläche. Das Schließen bricht den gesamten Assistenten ohne klare Meldung ab. Die Integration wird nicht hinzugefügt, auch wenn es so aussieht, als hätten Sie die Einrichtung abgeschlossen. Falls Sie noch keine Tuya-Entwickler-Cloud-Schlüssel haben, die wir in Abschnitt 6 erhalten:

  1. aktivieren Sie Nicht nach OpenAPI-Credentials fragen,
  2. wählen Sie auch das Land Polen und den Endpunkt Europa. Das Formular verlangt diese Felder weiterhin, und ohne sie kann eine unklare Validierungsfehlermeldung angezeigt werden,
  3. bestätigen Sie und klicken Sie im nächsten Bildschirm mit Namen und Bereichen auf Fertigstellen.

OpenAPI-Credentials-Fenster, als Referenz gezeigt. Aktivieren Sie das Kontrollkästchen, wählen Sie Land und Endpunkt aus und bestätigen Sie. Schließen Sie das Fenster nicht mit der X-Schaltfläche.

Nach Abschluss des Assistenten wird in der Integrationsliste Xtend Tuya angezeigt. Ihr Ladegerät sollte mehrere bis über zwanzig neue Entitäten erhalten, darunter Spannungs-, Strom-, Leistungs-, Energie- und Statussensoren. Wenn der Eintrag Xtend Tuya fehlt, wurde der Assistent unterbrochen. Wiederholen Sie Abschnitt 5.2.

6. Vollständiger Datensatz mit Tuya-Entwickler-Cloud-Schlüsseln

Dieser Schritt ist optional, aber empfohlen. Ohne ihn sind einige Entitäten möglicherweise nicht verfügbar oder aktualisieren sich langsamer. Wir erstellen ein kostenloses Projekt auf der Tuya-Entwicklerplattform und fügen dessen Schlüssel zu xtend_tuya hinzu. Die Add-on-Dokumentation beschreibt das Verfahren ebenfalls hier: Cloud-Credentials-Anleitung.

6.1. Erstellen eines Tuya-Plattformprojekts

  1. Gehen Sie zu platform.tuya.com und erstellen Sie ein kostenloses Konto. Sie können dieselbe E-Mail-Adresse wie bei Smart Life verwenden.
  2. Gehen Sie zu Cloud → Entwicklung → Cloud-Projekt erstellen. Geben Sie einen beliebigen Projektnamen ein. Wählen Sie für Branche und Entwicklungsmethode Smart Home. Für das Rechenzentrum wählen Sie Zentrales Europa Rechenzentrum. Das Rechenzentrum muss mit der Region Ihres Smart Life-Kontos übereinstimmen. Für Polen ist dies Zentrales Europa. Der kostenlose Plan erlaubt ein Rechenzentrum.
  3. Im Fenster Authorize API Services akzeptieren Sie die vorgeschlagenen Dienste.
  4. Verknüpfen Sie das App-Konto: Geräte → App-Konto verknüpfen → App-Konto hinzufügen, scannen Sie den QR-Code mit Smart Life und bestätigen Sie. Wählen Sie Automatische Verknüpfung, damit neue Geräte automatisch hinzugefügt werden können. Nach kurzer Zeit sollte Ihr Ladegerät in der Geräteliste erscheinen.
  5. Finden Sie Ihre Projektschlüssel im Übersichts-Tab im Bereich Autorisierungsschlüssel: Access ID / Client ID und Access Secret / Client Secret. Verwenden Sie das Augensymbol, um das Secret anzuzeigen.

Das Client Secret funktioniert wie ein Passwort für Ihr Projekt. Teilen Sie es nicht und fügen Sie es nicht an öffentlichen Stellen ein. Falls nötig, können Sie es im Übersichts-Tab zurücksetzen. Nach dem Zurücksetzen aktualisieren Sie den Schlüssel in Home Assistant.

6.2. Vollständige Datenpunkte mit DP Instruction aktivieren

Standardmäßig zeigt die Tuya-Cloud Geräte im vereinfachten Modus an, der einige Datenpunkte verbirgt. Um den vollständigen Satz freizugeben, schalten Sie das Produkt in den DP Instruction-Modus: Geräte → Alle Geräte → Drei-Punkte-Button neben Geräte nach Produkt anzeigen → über die Produktkarte fahren → Stiftsymbol → DP Instruction aktivieren → Konfiguration speichern. Die Warnung der Plattform gilt nur für dieses API-Projekt. Die Smart Life-App und das Ladegerät funktionieren weiterhin wie gewohnt. Illustrierte Anleitungen finden Sie in der xtend_tuya-Dokumentation.

6.3. Geben Sie die Schlüssel in Home Assistant ein

  1. Gehen Sie zu Einstellungen → Geräte & Dienste → Xtend Tuya → Konfigurieren. Dasselbe OpenAPI-Zugangsdatenfenster öffnet sich.
  2. Deaktivieren Sie diesmal Nicht nach OpenAPI-Zugangsdaten fragen. Wählen Sie das Land Polen und den Endpunkt Europa, dann fügen Sie die Access ID und Access Secret aus dem Tuya-Projekt-Übersichts-Tab ein. Bestätigen Sie.
  3. Starten Sie Home Assistant neu und warten Sie ein oder zwei Minuten. Die Anzahl der Ladegerät-Entitäten sollte wieder steigen. Falls nicht, verwenden Sie Neu laden im Drei-Punkte-Menü neben der Xtend Tuya-Integration.

7. Was Sie nach der Integration und dem Energiedashboard erhalten

Die genaue Entitätenliste hängt vom Ladegerätmodell ab, umfasst aber typischerweise:

Messwerte Steuerung
Ladestatus, Momentanleistung, Strom und Spannung für die Phasen L1 bis L3, Energie der aktuellen Sitzung, Gesamtenergie und Fehlercodes Starten und Stoppen des Ladevorgangs, Begrenzung des Ladestroms, zum Beispiel von 16 A auf 10 A reduzieren, und verfügbare Gerätemodi

Es lohnt sich, den Entitäten unter Einstellungen → Geräte & Dienste → Entitäten klare Namen zu geben. Wenn ein Element, wie ein Schalter, zweimal erscheint, einmal von Tuya und einmal von xtend_tuya, ist das normal. Sie können einfach die doppelte Entität deaktivieren, die Sie nicht verwenden möchten.

Energie-Dashboard: Gehen Sie zu Einstellungen → Dashboards → Energie. Fügen Sie im Abschnitt Einzelne Geräte die Gesamtenergie-Entität des Ladegeräts hinzu. Nach ein bis zwei Stunden sollte Home Assistant tägliche und monatliche Verbrauchsdiagramme erstellen. Mehr zum Energie-Dashboard: home-assistant.io/docs/energy.

8. Beispielautomatisierungen

Automatisierungen werden unter Einstellungen → Automatisierungen & Szenen → Automatisierung erstellen erstellt. Die folgenden Beispiele können im YAML-Bearbeitungsmodus eingefügt werden. Ersetzen Sie die Entitäten-IDs, wie sensor.… und switch.…, durch Ihre eigenen IDs aus dem Tab Entitäten. Telefonbenachrichtigungen erfordern die kostenlose Home Assistant Companion-App.

Laden nur während eines Niedertarif-Zeitraums, 22:00 bis 06:00:

alias: Laden während Niedertarif
trigger:
  - platform: time
    at: "22:00:00"
    id: start
  - platform: time
    at: "06:00:00"
    id: stop
action:
  - choose:
      - conditions: [{ condition: trigger, id: start }]
        sequence:
          - service: switch.turn_on
            target: { entity_id: switch.charger_switch }
      - conditions: [{ condition: trigger, id: stop }]
        sequence:
          - service: switch.turn_off
            target: { entity_id: switch.charger_switch }

Benachrichtigung, wenn das Laden endet:

alias: Laden beendet
trigger:
  - platform: state
    entity_id: sensor.charger_status
    from: "charging"
    to: "charger_free"
action:
  - service: notify.mobile_app_your_phone
    data:
      title: "Ladegerät"
      message: "Das Laden ist abgeschlossen."

Laden mit überschüssiger Solarproduktion, falls Home Assistant einen Sensor für ins Netz eingespeiste Leistung hat:

alias: Laden mit überschüssigem Solarstrom
trigger:
  - platform: numeric_state
    entity_id: sensor.grid_export_power
    above: 3000
    for: "00:05:00"
    id: start
  - platform: numeric_state
    entity_id: sensor.grid_export_power
    below: 500
    for: "00:05:00"
    id: stop
action:
  - choose:
      - conditions: [{ condition: trigger, id: start }]
        sequence:
          - service: switch.turn_on
            target: { entity_id: switch.charger_switch }
      - conditions: [{ condition: trigger, id: stop }]
        sequence:
          - service: switch.turn_off
            target: { entity_id: switch.charger_switch }

9. Häufige Probleme und Lösungen

Symptom Was zu tun ist
Nach dem Herunterladen von xtend_tuya in HACS erhöht sich die Anzahl der Entitäten nicht und Neustarts helfen nicht. Das Herunterladen von Dateien ist nicht dasselbe wie das Hinzufügen der Integration. Prüfen Sie, ob Xtend Tuya unter Einstellungen → Geräte & Dienste erscheint. Falls nicht, schließen Sie den Assistenten aus Abschnitt 5.2 ab.
Das OpenAPI-Anmeldefenster wurde mit der X-Schaltfläche geschlossen und die Integration verschwand. Der Assistent wurde abgebrochen. Starten Sie ihn erneut und verfahren Sie mit dem Fenster wie in Abschnitt 5.2 beschrieben: Kontrollkästchen, Land, Endpunkt, dann bestätigen.
Das OpenAPI-Formular zeigt einen Fehler wie value must be one of [...]. Auch wenn Don't ask... aktiviert ist, müssen Sie trotzdem Land und Endpunkt auswählen. Wählen Sie Polen und Europa und bestätigen Sie dann.
Die Protokolle zeigen sign invalid. Die Access ID oder das Secret wurde mit einem Tippfehler oder zusätzlichem Leerzeichen eingefügt, oder der falsche Endpunkt wurde ausgewählt. Kopieren Sie die Schlüssel erneut aus dem Projekt-Übersichts-Tab. Für Polen ist der Endpunkt Europa.
Die Protokolle zeigen permission deny oder Code 1106. Überprüfen Sie in Ihrem Tuya-Plattform-Projekt den Reiter Service API. IoT Core und Autorisierungsdienste müssen aktiv sein. Verwenden Sie bei Bedarf Autorisieren oder Erneuern.
Die Integration funktionierte, aber nach einigen Monaten wurden keine Daten mehr aktualisiert. Die kostenlose IoT Core-Testphase ist möglicherweise abgelaufen. Gehen Sie auf der Tuya-Plattform zu Cloud → Projekt → IoT Core → Trial verlängern. Die Verlängerung ist kostenlos. Es lohnt sich, eine Kalendereintragung zu setzen.
Der QR-Code von der Tuya-Plattform funktioniert nicht oder die Verknüpfung des App-Kontos schlägt fehl. Das Smart Life-Konto und das Projekt befinden sich wahrscheinlich in unterschiedlichen Rechenzentren. Erstellen Sie das Projekt im Rechenzentrum Zentraleuropa für Konten, die in Polen verwendet werden.
Alle Ladegerät-Entitäten sind nicht verfügbar. Die Integration funktioniert über die Cloud. Prüfen Sie den Internetzugang und bestätigen Sie, dass das Ladegerät in Smart Life online ist. Wenn die Verbindung wiederhergestellt ist, sollten die Entitäten automatisch zurückkehren.
Das Ladegerät verbindet sich nach Router- oder Passwortwechsel nicht mit dem WLAN. Stellen Sie sicher, dass das 2,4-GHz-WLAN aktiviert ist, und koppeln Sie das Ladegerät erneut in Smart Life. Es sollte dann automatisch in Home Assistant erscheinen.
Nach einem Home Assistant-Update startet Xtend Tuya nicht. Überprüfen Sie HACS auf eine neuere Version des Add-ons und aktualisieren Sie es. Benutzerdefinierte Integrationen können empfindlich auf größere Home Assistant-Versionen reagieren. Vor einem Home Assistant-Update lohnt es sich oft, ein paar Tage zu warten und die Issue-Seite des Projekts zu prüfen.
Der gleiche Schalter erscheint zweimal. Das ist normal, wenn xtend_tuya zusammen mit der offiziellen Tuya-Integration verwendet wird. Deaktivieren Sie die doppelte Entität, die Sie nicht benötigen. Entfernen Sie die Integration nicht.
Auch nach allen Schritten hat das Gerät nur eine Entität. Manchmal stellt die Tuya-Produktdefinition nur einen begrenzten Datensatz bereit. Kontaktieren Sie uns unter hello@amperepoint.com mit Ihrem Modell und einer kurzen Beschreibung des Problems. Wir prüfen die Produktkonfiguration auf der Cloud-Seite.

10. Alternative: lokale Steuerung mit tuya-local

Wenn Sie unabhängig von der Cloud sein möchten, sodass die Steuerung auch ohne Internetzugang funktioniert, können Sie stattdessen tuya-local verwenden. Es wird ebenfalls über HACS installiert. Die Konfiguration erfordert den lokalen Schlüssel des Geräts und eine manuelle Datenpunktzuordnung, daher ist es technischer und am besten für Nutzer geeignet, die sich bereits mit Home Assistant auskennen. Ein hilfreiches Tool zum Auslesen der Gerätedaten ist TinyTuya.

11. Alle Links an einem Ort

Downloads und Installation

Integrationen und Dokumentation

Zusammenfassung

Nach Abschluss dieser Anleitung wird Ihr Ampere Point Q Series Ladegerät ein vollwertiger Teil Ihres Smart Homes. Sie können jede Ladesitzung sehen, Kosten im Energie-Dashboard verfolgen und Ihr Auto laden, wenn der Strom am günstigsten ist oder wenn Ihre Solaranlage überschüssige Energie produziert.

Die Bildschirme von Home Assistant und der Tuya-Plattform ändern sich von Zeit zu Zeit, daher können einige Schaltflächen verschoben oder umbenannt werden. Die Gesamtfolge der Schritte bleibt jedoch gleich.

Hängen Sie bei einem der Schritte fest? Schreiben Sie uns eine E-Mail an hello@amperepoint.com oder rufen Sie +48 666 612 044 an, Montag bis Freitag, 10:00-17:00 Uhr. Wir helfen Ihnen gerne weiter.

Suchen Sie ein Ladegerät, das bereit ist, mit Home Assistant zu arbeiten? Sehen Sie sich unsere Q Series Ladegeräte mit Energiemessern an.

Zurück zum Blog

Ladegeräte mit einem Energiemesser

Alle ansehen