Le profil officiel du dispositif AmperePoint Q Series a été accepté dans le dépôt principal tuya-local. Cela offre à Home Assistant une connexion directe sur le réseau local aux chargeurs pris en charge, de sorte que les relevés et commandes courants n'ont pas à transiter par le cloud Tuya.
Disponibilité : le profil AmperePoint a été fusionné dans le dépôt principal tuya-local, mais il n'est pas inclus dans la version stable 2026.7.2. Avant l'installation, vérifiez sur HACS une version plus récente dont les notes incluent la PR #5595.
Qu'est-ce que l'intégration locale change ?
Une fois configuré, Home Assistant communique avec le chargeur via votre réseau local. tuya-local reconnaît les variantes Q Series prises en charge en utilisant leurs identifiants produits Tuya et les points de données effectivement exposés par l'appareil. Selon le firmware du chargeur et les points de données disponibles, le profil peut fournir :
- statut de charge et de connexion du véhicule,
- contrôle de démarrage et d'arrêt, limite de courant et mode de charge,
- puissance en temps réel, énergie de session et énergie totale,
- température, défauts et diagnostics,
- données d'énergie cible et de planning lorsque fournies par le chargeur,
- mesures de phase en tant qu'entités de diagnostic optionnelles.
Le profil contient les identifiants produits du compte fabricant Tuya d'AmperePoint, y compris les anciens produits que nous continuons à prendre en charge. Il s'agit intentionnellement d'un seul profil AmperePoint Q Series plutôt que d'un ensemble de profils basés sur les suffixes commerciaux des modèles. Les points de données réels déterminent quelles entités optionnelles apparaissent.
Avant de commencer
- Home Assistant avec HACS installé,
- une version de tuya-local plus récente que 2026.7.2 incluant la PR #5595,
- un chargeur AmperePoint Q Series déjà ajouté à l'application officielle Smart Life ou Tuya Smart,
- Home Assistant et le chargeur sur le même réseau local, ou sur des réseaux routés permettant la communication entre eux,
- accès à votre routeur si la découverte automatique de l'IP ne trouve pas le chargeur.
Recommandé : créez une réservation DHCP pour le chargeur. La découverte automatique est prise en charge, mais un bail fixe évite les problèmes après un redémarrage du routeur.
Avez-vous besoin d'un compte développeur Tuya ?
Non recommandé pour cette configuration. Le flux de configuration actuel de tuya-local peut autoriser l'accès avec un code utilisateur et un code QR depuis l'application Smart Life ou Tuya Smart. Il récupère l'ID de l'appareil et la clé locale, puis tente de découvrir le chargeur sur le réseau local. La documentation de tuya-local précise explicitement que cette méthode ne nécessite pas votre propre compte sur la plateforme Tuya IoT Developer.
La configuration assistée par le cloud utilise Tuya uniquement lors de l'intégration pour récupérer les identifiants de l'appareil. Après configuration, les lectures et commandes habituelles s'échangent localement. Le chargeur peut toujours maintenir sa propre connexion à Tuya ; installer tuya-local ne bloque pas automatiquement l'accès Internet.
1. Installer ou mettre à jour tuya-local
- Ouvrez HACS → Intégrations dans Home Assistant.
- Recherchez Tuya Local depuis
make-all/tuya-local. - S'il n'est pas listé, ajoutez
https://github.com/make-all/tuya-localcomme dépôt personnalisé HACS dans la catégorie Intégration. - Installez tuya-local, ou mettez-le à jour vers une version contenant le profil AmperePoint.
- Redémarrez Home Assistant. Le téléchargement des fichiers d'intégration Python dans HACS ne les charge pas avant le redémarrage de Home Assistant.
2. Ajouter le chargeur sans compte développeur
- Allez dans Paramètres → Appareils & services → Intégrations.
- Sélectionnez Ajouter une intégration, recherchez Tuya Local et lancez la configuration.
- Choisissez la configuration de l'appareil SmartLife assistée par le cloud. Le flux récupérera l'ID d'appareil et la clé locale et tentera de trouver l'adresse IP de l'appareil.
- Dans Smart Life ou Tuya Smart, ouvrez Moi → Paramètres → Compte et sécurité → Code utilisateur. Les libellés peuvent légèrement varier selon les versions de l'application et les langues.
- Saisissez le code utilisateur dans tuya-local. Home Assistant affichera un code QR.
- Scannez le code QR avec le scanner dans le même compte Smart Life ou Tuya Smart qui contient le chargeur, puis approuvez la connexion.
- Retournez à Home Assistant et sélectionnez le chargeur dans la liste des appareils de votre compte.
- Vérifiez l'ID d'appareil et la clé locale remplis automatiquement. Si aucune adresse IP n'est trouvée, saisissez l'adresse indiquée dans la liste des clients DHCP de votre routeur.
- Commencez avec la version du protocole réglée sur auto.
- Sélectionnez le profil d'appareil chargeur EV. Une correspondance réussie doit afficher le fabricant AmperePoint et le modèle Q Series.
Si vous ajoutez plusieurs chargeurs depuis le même compte Tuya, le jeton d'autorisation à courte durée de vie peut normalement être réutilisé jusqu'au redémarrage de Home Assistant. Chaque chargeur reçoit néanmoins sa propre entrée de configuration et ses entités.
Sécurité : ne publiez jamais votre ID d'appareil, clé locale, code utilisateur ou code QR. Jumeler à nouveau le chargeur dans l'application du fournisseur modifie sa clé locale, donc l'entrée tuya-local doit être reconfigurée.
Alternative avancée : Plateforme développeur Tuya et TinyTuya
Cette route n'est pas nécessaire pour une installation tuya-local normale. Elle peut être utile pour la récupération manuelle des identifiants, le diagnostic des points de données ou TinyTuya.
- Créez un compte sur la plateforme développeur Tuya et ouvrez Cloud → Développement.
- Créez un projet cloud en utilisant la méthode de développement Smart Home.
- Sélectionnez le centre de données qui dessert la région configurée dans votre compte Smart Life ou Tuya Smart. Une région non correspondante est une cause fréquente d’une liste d’appareils vide.
- Si demandé, autorisez les services API Smart Home de base requis par l’assistant de projet.
- Ouvrez Appareils → Lier compte application Tuya → Ajouter un compte application, scannez le code QR avec l’application contenant le chargeur et approuvez la liaison.
- Trouvez le chargeur dans la liste des appareils et enregistrez son ID d’appareil.
- Utilisez Cloud → Explorateur API → Gestion des appareils → Requête de détails des appareils en masse pour récupérer la
local_key. - Lisez l’adresse IP depuis votre routeur et saisissez l’hôte, l’ID de l’appareil et la clé locale dans la configuration manuelle de tuya-local. Commencez avec le protocole auto.
Les droits gratuits des projets cloud de Tuya et leur durée peuvent changer. Si l’API ne retourne pas de clé locale, utilisez le flux QR recommandé. TinyTuya peut aussi utiliser l’ID d’accès du projet, le secret d’accès, un ID d’appareil et la région correcte pour récupérer les appareils et scanner le LAN. Traitez toutes ces valeurs comme des identifiants.
3. Vérifiez les entités et testez la connexion
Ouvrez la page de l’appareil dans Home Assistant. L’ensemble exact d’entités dépend du firmware du chargeur et des points de données. Les mesures optionnelles ne sont créées que lorsque le chargeur les fournit réellement.
- Confirmez que l’appareil est disponible et que les relevés de base se mettent à jour.
- Sans véhicule connecté, testez la limite de courant et le contrôle démarrer/arrêter. L’entité correspondante doit confirmer la nouvelle valeur après quelques secondes.
- Redémarrez Home Assistant et vérifiez que le chargeur revient en ligne sans être reconfiguré.
- En cas de problème, vérifiez Paramètres → Système → Journaux et recherchez
tuya_localavant de supprimer l’entrée d’intégration.
4. Utilisez les entités locales avec le tableau de bord AmperePoint
tuya-local et TuyaExtend AmperePoint ont des rôles différents. tuya-local communique avec le chargeur via le LAN et crée des entités Home Assistant. Notre intégration AmperePoint organise ces valeurs dans une interface centrée sur le VE avec un tableau de bord, un planificateur hebdomadaire, des commandes manuelles, un aperçu des actions à venir et une confirmation des commandes.
Ajoutez ou modifiez une entrée d’intégration AmperePoint et sélectionnez les entités tuya-local comme source. Le tableau de bord est décrit dans notre guide compagnon : Tableau de bord et planificateur de charge AmperePoint Q Series dans Home Assistant.
Dépannage
Le profil AmperePoint est manquant
Vérifiez la version installée de tuya-local. La version stable 2026.7.2 ne contient pas encore le profil ; vous avez besoin d’une version plus récente incluant la PR #5595. Un profil présent sur GitHub main la branche n’est pas automatiquement présente dans la version téléchargée par HACS.
Le chargeur n’est pas listé après l’autorisation QR
Scannez le code QR avec le même compte officiel Smart Life ou Tuya Smart qui possède le chargeur. Une application OEM peut ne pas fonctionner avec ce processus. Pour la méthode Developer Platform, vérifiez la région de l’application, le centre de données du projet et le lien du compte d’application.
La découverte automatique ne trouve pas l’adresse IP
Saisissez l’adresse depuis la liste DHCP de votre routeur. La découverte peut être affectée par des VLAN, des réseaux invités, l’isolation des clients Wi-Fi, plusieurs sous-réseaux, une application Tuya ouverte ou une autre intégration locale connectée au chargeur. Créez une réservation DHCP au lieu de laisser une adresse changeante.
Le chargeur est indisponible
Vérifiez le routage entre Home Assistant et le chargeur, confirmez que l’adresse IP n’a pas changé, et assurez-vous qu’aucune autre intégration locale ne maintient une connexion parallèle. Fermez l’application Tuya, rechargez l’entrée de l’intégration et vérifiez les règles du pare-feu LAN.
Les relevés fonctionnent mais les commandes échouent
Vérifiez la clé locale et la version du protocole. Une clé incorrecte peut parfois permettre une découverte limitée tout en empêchant le contrôle. Si auto est instable, testez la version du protocole identifiée par tuya-local et consultez la documentation du projet.
Cela a cessé de fonctionner après le nouvel appairage du chargeur
C’est normal : Tuya génère une nouvelle clé locale lorsqu’un appareil est appairé à nouveau. Reconfigurez l’entrée tuya-local avec la clé actuelle.
Mises à jour et support
Le profil AmperePoint fait partie du projet tuya-local en amont, ainsi les futures corrections peuvent atteindre les utilisateurs via les mises à jour normales de HACS. Nous maintiendrons la compatibilité avec les variantes Q Series prises en charge. Si un chargeur n’est pas reconnu ou si une entité disponible dans l’application Tuya manque, signalez-le dans le suivi des problèmes AmperePoint. Incluez la version de tuya-local et le firmware du chargeur, mais ne communiquez jamais d’ID d’appareil, de clé locale ou de données de connexion.
Références techniques
- Profil AmperePoint — PR tuya-local #5595
- Installation et configuration de tuya-local
- Récupération manuelle de l'ID de l'appareil et de la clé locale
- Documentation du projet cloud Tuya Smart Home
- Lier un compte d'application à un projet Tuya
- TuyaExtend AmperePoint sur GitHub
tuya-local et Home Assistant sont des projets communautaires et ne sont pas la propriété d'AmperePoint. Les travaux sur une installation électrique doivent être réalisés par une personne qualifiée. Une limite de courant logicielle ne remplace pas un câblage correctement conçu, une protection adéquate ou les consignes de sécurité du fabricant.
