AMPERE POINT Q Series and Home Assistant step-by-step guide banner with a dashboard of live charger data

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

Jan Prószyński

Diese Anleitung verbindet Ihr Ampere Point Ladegerät der Q Series mit Home Assistant und führt Sie zum fertigen Bedienpanel. Wir verwenden die offizielle Tuya-Integration und die AmperePoint-Integration aus HACS oder dem Marketplace. Die Standardeinrichtung erfolgt über die Oberfläche, ohne YAML zu bearbeiten oder ein Tuya-Developer-Konto anzulegen.

Aktualisiert: 4. November 2026 · Q11, Q22, Q37, Q74 · Referenzversion der Integration: 0.6.1. Verfügbare Messwerte und Befehle hängen von Gerätegeneration und Firmware ab.

1. Voraussetzungen

  • Ein Ladegerät der Q Series, das in Tuya Smart oder Smart Life eingerichtet ist und dort funktioniert; verwenden Sie zum Koppeln ein 2,4-GHz-WLAN.
  • Home Assistant ab Version 2025.2.0 auf einem dauerhaft eingeschalteten Gerät.
  • Internetzugang für HA und das Ladegerät: Die hier beschriebene Verbindung der Q Series nutzt die Tuya-Cloud.
  • HACS oder den Marketplace sowie ein GitHub-Konto zur Autorisierung eines benutzerdefinierten Repositorys.
  • Ein Smartphone mit der Tuya-App und einen zweiten Bildschirm für den QR-Code.

2. Home Assistant installieren, falls noch nicht vorhanden

Home Assistant installieren, falls noch nicht vorhanden

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. HACS oder Marketplace

Öffnen Sie unter HA 2026.11 oder neuer Einstellungen → Marketplace. Laut HA-Dokumentation ist der Marketplace integriert und übernimmt die Funktion von HACS.

Unter HA 2026.10 oder älter öffnen Sie HACS in der Seitenleiste. Fehlt HACS, folgen Sie der offiziellen Download-Anleitung für Ihren Installationstyp, starten HA neu, fügen die HACS-Integration hinzu und autorisieren sie mit GitHub.

Öffnen Sie anschließend HACS oder den Marketplace. Dort fügen Sie das AmperePoint-Repository hinzu. Repositorys für HA-Apps/Add-ons befinden sich an anderer Stelle. Marketplace-Dokumentation.

4. Offizielle Tuya-Integration verbinden

  1. Öffnen Sie in HA Einstellungen → Geräte & Dienste → Integration hinzufügen → Tuya.
  2. Den Benutzercode / User Code finden Sie in Tuya Smart oder Smart Life unter Profil → Einstellungen → Konto und Sicherheit. Geben Sie ihn im HA-Assistenten ein.
  3. Scannen Sie den QR-Code mit derselben App und demselben Konto, dem das Ladegerät zugeordnet ist, und bestätigen Sie die Anmeldung.
  4. Prüfen Sie vor dem nächsten Schritt, ob das Ladegerät unter den Geräten der Tuya-Integration erscheint. Offizielle Tuya-Anleitung.

5. AmperePoint herunterladen

  1. Öffnen Sie HACS → ⋮ → Benutzerdefinierte Repositorys. Im Marketplace verwenden Sie die Funktion für ein benutzerdefiniertes Repository; die Schaltfläche unten bietet einen direkten Zugang.
  2. Fügen Sie die vollständige Adresse unten ein, wählen Sie den Typ Integration und klicken Sie auf Hinzufügen.
  3. Suchen Sie nach TuyaExtend AmperePoint, öffnen Sie die Seite und laden Sie die aktuelle veröffentlichte Version herunter.
  4. Starten Sie Home Assistant neu und aktualisieren Sie anschließend den Browser. Bei einer Container-Installation können Sie den Container neu starten.
  5. Das Herunterladen der Dateien und das Hinzufügen eines Geräts sind getrennte Schritte. Fahren Sie nach dem Neustart mit dem nächsten Abschnitt fort.

Repository-Typ: Integration

Repository in meinem Home Assistant öffnen

Fügen Sie die Adresse in das Repository-Feld von HACS/Marketplace ein, ohne Datei- oder Ordnerpfad anzuhängen. Der Name im Store lautet TuyaExtend AmperePoint; in den HA-Einstellungen suchen Sie nach AmperePoint.

6. Ladegerät hinzufügen und Panel öffnen

  1. Öffnen Sie Einstellungen → Geräte & Dienste → Integration hinzufügen und suchen Sie AmperePoint. Hat HA bereits automatisch einen Eintrag angelegt, öffnen Sie diesen.
  2. Wählen Sie die Einrichtung eines erkannten Ladegeräts, dann das richtige Gerät, und vergeben Sie einen Namen. Für diesen Q-Series-Verbindungsweg verwenden Sie die Tuya-Quelle.
  3. Stellen Sie Strompreis und Währung ein, prüfen Sie die weiteren Einstellungen und schließen Sie den Assistenten ab.
  4. Öffnen Sie Ampere Point - Tuya dashboard in der Seitenleiste. Das gemeinsame Panel wird automatisch erstellt; bei mehreren Ladegeräten wählen Sie das Gerät in der Kopfzeile.

7. Messwerte und Steuerung

Prüfen Sie, ob das Panel das richtige Ladegerät und aktuelle Werte zeigt. Zu den verfügbaren Funktionen gehören Status, Leistung, Sitzungsenergie, Strombegrenzung, Start/Stopp und Diagnose.

Der Umfang hängt vom Gerät und den von Tuya gelieferten Daten ab. Phasenmessungen, Gesamtzähler und Energieziel erscheinen nur, wenn die Datenquelle sie unterstützt.

Beim Ändern der Strombegrenzung zeigt das Panel den gewählten Wert an. Warten Sie nach einem Befehl auf die Bestätigung des Ladegeräts. Die Grenze in HA muss innerhalb des für Gerät und Elektroinstallation zulässigen Bereichs bleiben.

Beispiel des Ampere Point Ladepanels in Home Assistant
Beispielansicht des Panels. Messwerte, Darstellung und Funktionen können je nach Version und Ladegerät abweichen.

8. Ladegerät zum Energie-Dashboard hinzufügen

  1. Wählen Sie das Ladegerät im AmperePoint-Panel und öffnen Sie Energie in Home Assistant / Energy in Home Assistant oberhalb der Fußzeile. Dort steht die genaue Entitäts-ID für Ladeenergie / Charging energy.
  2. Fügen Sie diese Entität in den Energie-Einstellungen als einzelnes Gerät hinzu. Erfassen Sie jedes physische Ladegerät einmal. Sitzungsenergie, letzte Sitzungsenergie und der diagnostische Sensor für aus Leistung berechnete Energie sind keine weiteren Quellen für denselben Verbrauch.
  3. Recorder muss die Entität aufzeichnen. Der neue Zähler beginnt bei null; bisherige Statistiken werden nicht automatisch zusammengeführt. Diagramme benötigen Zeit für die Datensammlung. Die Sitzungskosten im Panel sind eine Schätzung aus Energie und Tarif, keine Abrechnung historischer Preise. Details zu Messung und Migration.

9. Ladeplan und Photovoltaik

Der integrierte Ladeplan speichert Wochentage, mehrere Zeitfenster und eine Strombegrenzung je Fenster. Manuelle Ausnahmen erlauben unter anderem Laden für eine bestimmte Dauer oder bis zu einem Energieziel.

Die Befehle werden von HA ausgeführt. Home Assistant und die Verbindung zum Ladegerät müssen auch beim vorgesehenen Stopp verfügbar sein. Stimmen Sie den Plan mit der Tuya-App und anderen Automationen ab, damit keine widersprüchlichen Befehle gesendet werden.

Ab 0.6.1 kann der PV-Modus den Ladestrom an den Solarüberschuss anpassen, wenn Tuya oder zugeordnete Entitäten die Quelle sind. Wählen Sie in den Integrationsoptionen die PV-Erzeugung und die vorzeichenbehaftete Netzleistung oder getrennte Import-/Exportwerte; prüfen Sie Einheiten und Vorzeichen.

Einträge vom Typ AmperePoint Local (LAN) haben noch keine PV-Einstellungen. Der Modus ist standardmäßig aus. Der Regler dieser Version wurde mit synthetischen Daten getestet, ohne PV-Laden an einem physischen Ladegerät zu prüfen. PV-Konfiguration und Grenzen.

10. Probleme bei der Installation

HACS findet das Repository nicht oder meldet einen fehlenden Ordner

Vergleichen Sie die eingegebene Adresse mit dem Feld oben und wählen Sie Integration. Öffnen Sie das Repository im Browser. Bleibt der Fehler bestehen, notieren Sie den vollständigen Text, die Adresse und die HA- sowie HACS/Marketplace-Version. Die Meldung allein klärt die Ursache nicht.

AmperePoint fehlt nach dem Download

Starten Sie HA neu und aktualisieren Sie den Browser. Suchen Sie anschließend unter Geräte & Dienste → Integration hinzufügen nach AmperePoint.

Der Assistent erkennt das Ladegerät nicht

Prüfen Sie, ob es in der App online und in der offiziellen Tuya-Integration von HA sichtbar ist. Laden Sie Tuya bei Bedarf neu.

Das Panel meldet eine ungültige Konfiguration oder zeigt eine alte Version

Laden Sie die Browserseite vollständig neu und prüfen Sie die Version in der Fußzeile. Bleibt das Problem, senden Sie die Fehlermeldung und die Lovelace-Ressourcenliste samt Typen. Das Entfernen des ?v=-Zusatzes an der Karten-URL ist keine dauerhafte Lösung.

Phasenmessungen oder andere Werte fehlen

Der Umfang hängt von Modell, Firmware und Tuya-Quelle ab. Ein fehlender Messwert bedeutet nicht automatisch einen Installationsfehler.

Im Energie-Dashboard erscheint noch kein Diagramm

Prüfen Sie die Entität Charging energy und ihre Aufzeichnung durch Recorder. Warten Sie anschließend auf die Statistikdaten.

11. Updates und weitere Verbindungswege

Sichern Sie HA vor einem Update. Laden Sie die neue Version über HACS oder den Marketplace, starten Sie HA neu und aktualisieren Sie das Panel. Prüfen Sie die Version in der Fußzeile. Behalten Sie bei einer Migration funktionierende Einträge und prüfen Sie abhängige Automationen vor dem Entfernen.

Tuya Local und Xtend Tuya können zusätzliche Quellen für bestehende oder fortgeschrittene Konfigurationen sein. Für die Q-Series-Einrichtung oben genügen die offizielle Tuya-Integration und AmperePoint. Lokale Steuerung erklärt die separate Tuya-Local-Anleitung. Wallbox PRIME nutzt einen anderen LAN-Verbindungsweg; siehe Verbindungsanleitung.

Bei Problemen schreiben Sie an hello@amperepoint.com. Nennen Sie Modell, Firmware, HA-, Integrations- und HACS/Marketplace-Version sowie den Schritt und fügen Sie einen Screenshot der vollständigen Meldung hinzu. Senden Sie keine Passwörter, Local Keys oder Tokens.

Zurück zum Blog

Ladegeräte mit einem Energiezähler

Alle ansehen