AmperePoint Q Serie in tuya-local: lokale Steuerung mit Home Assistant

Das offizielle AmperePoint Q Series Geräteprofil wurde in das Haupt-Repository tuya-local aufgenommen. Dadurch erhält Home Assistant eine direkte Verbindung im lokalen Netzwerk zu unterstützten Ladegeräten, sodass Routineabfragen und Befehle nicht über die Tuya-Cloud laufen müssen.

Verfügbarkeit: Das AmperePoint-Profil wurde in das Haupt-Repository von tuya-local übernommen, ist aber nicht in der stabilen Version 2026.7.2 enthalten. Prüfen Sie vor der Installation in HACS, ob eine neuere Version mit PR #5595 verfügbar ist.

Was ändert die lokale Integration?

Nach der Konfiguration kommuniziert Home Assistant über Ihr LAN mit dem Ladegerät. tuya-local erkennt unterstützte Q Series Varianten anhand ihrer Tuya-Produktkennungen und der tatsächlich vom Gerät bereitgestellten Datenpunkte. Je nach Ladegerät-Firmware und verfügbaren Datenpunkten kann das Profil Folgendes bereitstellen:

• Lade- und Fahrzeugverbindungsstatus,
• Start- und Stoppsteuerung, Strombegrenzung und Lademodus,
• Live-Leistung, Sitzungsenergie und Gesamtenergie,
• Temperatur, Fehler und Diagnosen,
• Zielenergie- und Zeitplandaten, wenn sie vom Ladegerät bereitgestellt werden,
• Phasenmessungen als optionale Diagnose-Entitäten.

Das Profil enthält die Produktkennungen aus dem Tuya-Herstellerkonto von AmperePoint, einschließlich älterer Produkte, die weiterhin unterstützt werden. Es ist bewusst ein AmperePoint Q Series-Profil und keine Sammlung von Profilen basierend auf kommerziellen Modellzusätzen. Die tatsächlichen Datenpunkte bestimmen, welche optionalen Entitäten angezeigt werden.

Bevor Sie beginnen

• Home Assistant mit installiertem HACS,
• eine tuya-local Version neuer als 2026.7.2, die PR #5595 enthält,
• ein AmperePoint Q Series Ladegerät, das bereits in der offiziellen Smart Life oder Tuya Smart App hinzugefügt wurde,
• Home Assistant und das Ladegerät im selben LAN oder in gerouteten Netzwerken, die Kommunikation zwischen ihnen erlauben,
• Zugriff auf Ihren Router, falls die automatische IP-Erkennung das Ladegerät nicht findet.

Empfohlen: Erstellen Sie eine DHCP-Reservierung für das Ladegerät. Automatische Erkennung wird unterstützt, aber eine feste Zuweisung vermeidet Probleme nach einem Router-Neustart.

Benötigen Sie ein Tuya Developer-Konto?

Nicht für die empfohlene Einrichtung. Der aktuelle tuya-local Konfigurationsablauf kann den Zugriff mit einem Benutzer-Code und einem QR-Code aus der Smart Life oder Tuya Smart App autorisieren. Er ruft die Geräte-ID und den Local Key ab und versucht, das Ladegerät im LAN zu finden. Die tuya-local Dokumentation stellt ausdrücklich klar, dass für diese Methode kein eigener Tuya IoT Developer Platform Account erforderlich ist.

Die cloud-unterstützte Einrichtung verwendet Tuya nur während der Einrichtung, um Geräteanmeldeinformationen abzurufen. Nach der Konfiguration werden routinemäßige Abfragen und Befehle lokal ausgetauscht. Das Ladegerät kann weiterhin eine eigene Verbindung zu Tuya aufrechterhalten; die Installation von tuya-local blockiert den Internetzugang nicht automatisch.

1. Installieren oder aktualisieren Sie tuya-local

1. Öffnen Sie HACS → Integrationen in Home Assistant.
2. Suchen Sie nach Tuya Local von make-all/tuya-local.
3. Wenn es nicht aufgeführt ist, fügen Sie https://github.com/make-all/tuya-local als benutzerdefiniertes HACS-Repository in der Kategorie Integration hinzu.
4. Installieren Sie tuya-local oder aktualisieren Sie es auf eine Version, die das AmperePoint-Profil enthält.
5. Starten Sie Home Assistant neu. Das Herunterladen von Python-Integrationsdateien in HACS lädt diese erst nach einem Neustart von Home Assistant.

2. Fügen Sie das Ladegerät ohne Entwicklerkonto hinzu

1. Gehen Sie zu Einstellungen → Geräte & Dienste → Integrationen.
2. Wählen Sie Integration hinzufügen, suchen Sie nach Tuya Local und starten Sie die Konfiguration.
3. Wählen Sie die cloud-unterstützte SmartLife-Geräteeinrichtung. Der Ablauf ruft die Geräte-ID und den Local Key ab und versucht, die Geräte-IP-Adresse zu finden.
4. Öffnen Sie in Smart Life oder Tuya Smart Ich → Einstellungen → Konto und Sicherheit → Benutzer-Code. Die Bezeichnungen können je nach App-Version und Sprache leicht variieren.
5. Geben Sie den Benutzer-Code in tuya-local ein. Home Assistant zeigt einen QR-Code an.
6. Scannen Sie den QR-Code mit dem Scanner im selben Smart Life- oder Tuya Smart-Konto, das das Ladegerät enthält, und bestätigen Sie die Anmeldung.
7. Kehren Sie zu Home Assistant zurück und wählen Sie das Ladegerät aus der Geräteliste Ihres Kontos aus.
8. Überprüfen Sie die automatisch ausgefüllte Geräte-ID und den Local Key. Wenn keine IP-Adresse gefunden wird, geben Sie die Adresse ein, die in der DHCP-Clientliste Ihres Routers angezeigt wird.
9. Beginnen Sie mit der Protokollversion auf auto eingestellt.
10. Wählen Sie das Geräteprofil EV-Ladegerät. Eine erfolgreiche Übereinstimmung zeigt den Hersteller AmperePoint und das Modell Q Series an.

Wenn Sie mehrere Ladegeräte aus demselben Tuya-Konto hinzufügen, kann das kurzlebige Autorisierungstoken normalerweise wiederverwendet werden, bis Home Assistant neu gestartet wird. Jedes Ladegerät erhält dennoch seinen eigenen Konfigurationseintrag und eigene Entitäten.

Sicherheit: Veröffentlichen Sie niemals Ihre Geräte-ID, den Local Key, den Benutzer-Code oder den QR-Code. Das erneute Koppeln des Ladegeräts in der Hersteller-App ändert den Local Key, daher muss der tuya-local-Eintrag anschließend neu konfiguriert werden.

Fortgeschrittene Alternative: Tuya Developer Platform und TinyTuya

Diese Route ist für eine normale tuya-local-Installation nicht erforderlich. Sie kann nützlich sein für die manuelle Anmeldeinformationen-Abfrage, Datenpunkt-Diagnosen oder TinyTuya.

1. Erstellen Sie ein Konto auf der Tuya Developer Platform und öffnen Sie Cloud → Entwicklung.
2. Erstellen Sie ein Cloud-Projekt mit der Entwicklungsmethode Smart Home.
3. Wählen Sie das Rechenzentrum aus, das die Region bedient, die in Ihrem Smart Life- oder Tuya Smart-Konto konfiguriert ist. Eine nicht übereinstimmende Region ist ein häufiger Grund für eine leere Geräteliste.
4. Falls angefordert, autorisieren Sie die grundlegenden Smart Home API-Dienste, die vom Projektassistenten benötigt werden.
5. Öffnen Sie Geräte → Tuya App-Konto verknüpfen → App-Konto hinzufügen, scannen Sie den QR-Code mit der App, die das Ladegerät enthält, und bestätigen Sie die Verknüpfung.
6. Finden Sie das Ladegerät in der Geräteliste und speichern Sie dessen Geräte-ID.
7. Verwenden Sie Cloud → API Explorer → Geräteverwaltung → Geräteinformationen in großen Mengen abfragen, um den local_key abzurufen.
8. Lesen Sie die IP-Adresse von Ihrem Router aus und geben Sie Host, Geräte-ID und Local Key in die manuelle Einrichtung von tuya-local ein. Beginnen Sie mit dem Protokoll auto.

Die kostenlosen Cloud-Projekt-Berechtigungen von Tuya und deren Dauer können sich ändern. Wenn die API keinen Local Key zurückgibt, verwenden Sie den empfohlenen QR-Flow. TinyTuya kann auch die Access ID, Access Secret, eine Geräte-ID und die korrekte Region des Projekts nutzen, um Geräte abzurufen und das LAN zu scannen. Behandeln Sie all diese Werte als Zugangsdaten.

3. Überprüfen Sie die Entitäten und testen Sie die Verbindung

Öffnen Sie die Geräte-Seite in Home Assistant. Der genaue Entitätensatz hängt von der Firmware des Ladegeräts und den Datenpunkten ab. Optionale Messwerte werden nur erstellt, wenn das Ladegerät diese tatsächlich liefert.

1. Bestätigen Sie, dass das Gerät verfügbar ist und grundlegende Messwerte aktualisiert werden.
2. Testen Sie bei keinem angeschlossenen Fahrzeug die Strombegrenzung sowie Start-/Stopp-Steuerung. Die entsprechende Entität sollte den neuen Wert nach einigen Sekunden bestätigen.
3. Starten Sie Home Assistant neu und überprüfen Sie, ob das Ladegerät ohne erneute Konfiguration wieder online ist.
4. Wenn etwas fehlschlägt, prüfen Sie Einstellungen → System → Protokolle und suchen Sie nach tuya_local, bevor Sie den Integrations-Eintrag löschen.

4. Verwenden Sie die lokalen Entitäten mit dem AmperePoint-Dashboard

tuya-local und TuyaExtend AmperePoint haben unterschiedliche Rollen. tuya-local kommuniziert über das LAN mit dem Ladegerät und erstellt Home Assistant-Entitäten. Unsere AmperePoint-Integration organisiert diese Werte in einer auf Elektrofahrzeuge fokussierten Oberfläche mit Dashboard, Wochenplaner, manuellen Überschreibungen, Vorschau der nächsten Aktion und Befehlsbestätigung.

Fügen Sie einen AmperePoint-Integrations-Eintrag hinzu oder bearbeiten Sie ihn und wählen Sie die tuya-local-Entitäten als Quelle aus. Das Dashboard wird in unserem Begleitleitfaden beschrieben: AmperePoint Q Series Dashboard und Ladeplaner in Home Assistant.

Fehlerbehebung

Das AmperePoint-Profil fehlt

Überprüfen Sie die installierte tuya-local Version. Die stabile Version 2026.7.2 enthält das Profil noch nicht; Sie benötigen eine spätere Version, die PR #5595 enthält. Ein Profil ist auf GitHub vorhanden. main Der Branch ist im von HACS heruntergeladenen Release nicht automatisch enthalten.

Das Ladegerät wird nach der QR-Autorisierung nicht angezeigt

Scannen Sie den QR-Code mit demselben offiziellen Smart Life- oder Tuya Smart-Konto, das das Ladegerät besitzt. Eine OEM-gebrandete App funktioniert möglicherweise nicht mit diesem Ablauf. Für den Developer Platform-Weg prüfen Sie die App-Region, das Projekt-Rechenzentrum und die Verknüpfung des App-Kontos.

Automatische Erkennung kann die IP-Adresse nicht finden

Geben Sie die Adresse aus der DHCP-Liste Ihres Routers ein. Die Erkennung kann durch VLANs, Gastnetzwerke, Wi-Fi-Client-Isolation, mehrere Subnetze, eine offene Tuya-App oder eine andere lokale Integration, die mit dem Ladegerät verbunden ist, beeinträchtigt werden. Erstellen Sie eine DHCP-Reservierung, anstatt eine wechselnde Adresse zu verwenden.

Das Ladegerät ist nicht erreichbar

Überprüfen Sie die Verbindung zwischen Home Assistant und dem Ladegerät, bestätigen Sie, dass sich die IP-Adresse nicht geändert hat, und stellen Sie sicher, dass keine andere lokale Integration eine parallele Verbindung hält. Schließen Sie die Tuya-App, laden Sie den Integrationseintrag neu und prüfen Sie die LAN-Firewall-Regeln.

Messwerte funktionieren, Befehle schlagen fehl

Überprüfen Sie den Local Key und die Protokollversion. Ein falscher Schlüssel kann manchmal eine eingeschränkte Erkennung erlauben, aber die Steuerung verhindern. Wenn auto instabil ist, testen Sie die von tuya-local erkannte Protokollversion und konsultieren Sie die Projektdokumentation.

Es funktionierte nicht mehr, nachdem das Ladegerät erneut gekoppelt wurde

Das ist normal: Tuya generiert einen neuen Local Key, wenn ein Gerät erneut gekoppelt wird. Konfigurieren Sie den tuya-local Eintrag mit dem aktuellen Schlüssel neu.

Updates und Support

Das AmperePoint-Profil ist Teil des upstream tuya-local Projekts, sodass zukünftige Fehlerbehebungen Nutzer über normale HACS-Updates erreichen können. Wir werden die Kompatibilität mit unterstützten Q Series Varianten aufrechterhalten. Wenn ein Ladegerät nicht erkannt wird oder eine im Tuya-App verfügbares Gerät fehlt, melden Sie dies im AmperePoint Issue Tracker. Geben Sie die tuya-local Version und die Firmware des Ladegeräts an, aber niemals eine Geräte-ID, Local Key oder Login-Daten.

Technische Referenzen

• AmperePoint-Profil — tuya-local PR #5595
• Installation und Konfiguration von tuya-local
• Manuelle Geräte-ID- und Local-Key-Abfrage
• Dokumentation zum Tuya Smart Home Cloud-Projekt
• Verknüpfung eines App-Kontos mit einem Tuya-Projekt
• TuyaExtend AmperePoint auf GitHub

tuya-local und Home Assistant sind Community-Projekte und gehören nicht AmperePoint. Arbeiten an einer Elektroinstallation müssen von einer entsprechend qualifizierten Person durchgeführt werden. Eine softwareseitige Strombegrenzung ersetzt keine korrekt ausgelegte Verkabelung, Schutzmaßnahmen oder die Sicherheitshinweise des Herstellers.