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

Intégration complète de Home Assistant pour les chargeurs Ampere Point série Q — Guide étape par étape

Jan Prószyński

Ce guide vous accompagne pour connecter votre chargeur Ampere Point Q Series à Home Assistant et ouvrir son panneau de commande prêt à l’emploi. Nous utilisons l’intégration officielle Tuya et l’intégration AmperePoint installée via HACS ou le Marketplace. La configuration standard se fait dans l’interface, sans modifier de YAML ni créer de compte Tuya Developer.

Mise à jour : 4 novembre 2026 · Q11, Q22, Q37, Q74 · version de référence de l’intégration : 0.6.1. Les mesures et commandes disponibles dépendent de la génération et du firmware du chargeur.

1. Prérequis

  • Un chargeur Q Series associé à Tuya Smart ou Smart Life et fonctionnel dans l’application ; utilisez le Wi-Fi 2,4 GHz pour l’association.
  • Home Assistant 2025.2.0 ou ultérieur sur un appareil qui reste allumé.
  • Un accès à Internet pour HA et le chargeur : cette configuration Q Series utilise le cloud Tuya.
  • HACS ou le Marketplace et un compte GitHub pour autoriser l’ajout d’un dépôt personnalisé.
  • Un téléphone avec l’application Tuya et un second écran pour afficher le code QR.

2. Installer Home Assistant si nécessaire

Installer Home Assistant si nécessaire

Si Home Assistant fonctionne déjà pour vous, allez directement à la section 3.

Option A : appareil dédié, recommandé à long terme

Sur un Raspberry Pi, un mini PC ou un ancien ordinateur portable, la solution la plus simple est Home Assistant OS. C’est un système complet qui gère Home Assistant, les mises à jour et les sauvegardes. Les instructions officielles pour chaque plateforme sont disponibles ici : home-assistant.io/installation. Après l’installation, le tableau de bord est généralement accessible dans un navigateur à l’adresse http://homeassistant.local:8123.

Option B : ordinateur Windows utilisant Docker

C’est un bon point de départ pour les tests. Home Assistant fonctionne dans un conteneur sur votre ordinateur habituel. N’oubliez pas que les automatisations ne fonctionnent que lorsque l’ordinateur est allumé et que Docker est en marche.

  1. Installez WSL2, nécessaire à Docker sous Windows. Faites un clic droit sur le menu Démarrer, ouvrez Terminal (administrateur), entrez wsl --install, confirmez et redémarrez l’ordinateur à la fin. Instructions Microsoft : learn.microsoft.com/pl-pl/windows/wsl/install.
  2. Installez Docker Desktop : docker.com/products/docker-desktop. Pendant l’installation, gardez l’option WSL 2 activée. Après le lancement de Docker Desktop, attendez que le statut indique qu’il fonctionne. La création d’un compte Docker peut être ignorée.
  3. Démarrez Home Assistant. Ouvrez le Terminal sans privilèges administrateur et collez : 
    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
    Le premier lancement télécharge environ 1,5 Go et prend généralement quelques minutes.
  4. Ouvrir http://localhost:8123 dans votre navigateur. Si cela ne se charge pas immédiatement, attendez une ou deux minutes et actualisez.

Avec l’option Docker, redémarrez Home Assistant dans Docker Desktop : Containers → homeassistant → icône de redémarrage. Vous pouvez aussi utiliser docker restart homeassistant. Le bouton de redémarrage peut ne pas apparaître dans le menu Home Assistant dans cette configuration, ce qui est normal. Vous devrez redémarrer plusieurs fois dans les étapes suivantes.

Premier lancement pour les deux options

L’assistant de bienvenue vous demandera de créer un compte local, de choisir la localisation et de définir les unités. Enregistrez le nom d’utilisateur et le mot de passe dans un endroit sûr. Vous pouvez passer la liste des appareils découverts automatiquement à cette étape.

3. HACS ou Marketplace

Sur HA 2026.11 et ultérieur, ouvrez Paramètres → Marketplace. Selon la documentation HA, le Marketplace est intégré et reprend le rôle de HACS.

Sur HA 2026.10 et antérieur, ouvrez HACS dans la barre latérale. S’il n’est pas installé, suivez les instructions officielles adaptées à votre installation, redémarrez HA, ajoutez l’intégration HACS et autorisez-la avec GitHub.

Ouvrez ensuite HACS ou le Marketplace pour ajouter le dépôt AmperePoint. Les dépôts d’applications/modules complémentaires HA se trouvent ailleurs. Documentation du Marketplace.

4. Connecter l’intégration officielle Tuya

  1. Dans HA, ouvrez Paramètres → Appareils et services → Ajouter une intégration → Tuya.
  2. Dans Tuya Smart ou Smart Life, trouvez Profil → Paramètres → Compte et sécurité → Code utilisateur / User Code. Saisissez ce code dans HA.
  3. Scannez le code QR avec la même application et le même compte que ceux du chargeur, puis confirmez la connexion.
  4. Avant de poursuivre, vérifiez que le chargeur figure parmi les appareils de l’intégration Tuya. Instructions officielles Tuya.

5. Télécharger AmperePoint

  1. Ouvrez HACS → ⋮ → Dépôts personnalisés. Dans le Marketplace, utilisez l’option d’ajout d’un dépôt personnalisé ; le bouton ci-dessous offre un raccourci.
  2. Collez l’adresse complète ci-dessous, choisissez le type Intégration / Integration et cliquez sur Ajouter.
  3. Recherchez TuyaExtend AmperePoint, ouvrez sa page et téléchargez la version publiée actuelle.
  4. Redémarrez Home Assistant, puis actualisez le navigateur. Avec une installation Container, vous pouvez redémarrer le conteneur.
  5. Le téléchargement des fichiers et l’ajout d’un appareil sont deux étapes distinctes. Après le redémarrage, poursuivez avec la section suivante.

Type de dépôt: Integration

Ouvrir le dépôt dans mon Home Assistant

Collez cette adresse dans le champ dépôt de HACS/Marketplace, sans ajouter de chemin vers un fichier ou dossier. Le nom dans la boutique est TuyaExtend AmperePoint ; dans les paramètres HA, recherchez AmperePoint.

6. Ajouter le chargeur et ouvrir le panneau

  1. Ouvrez Paramètres → Appareils et services → Ajouter une intégration et recherchez AmperePoint. Si HA a déjà ajouté automatiquement le chargeur, ouvrez cette entrée.
  2. Choisissez la configuration d’un chargeur détecté, sélectionnez le bon appareil et donnez-lui un nom. Cette configuration Q Series utilise la source Tuya.
  3. Définissez le tarif de l’énergie et la devise, vérifiez les autres paramètres et terminez l’assistant.
  4. Ouvrez Ampere Point - Tuya dashboard dans la barre latérale. Le panneau commun est créé automatiquement ; si vous avez plusieurs chargeurs, sélectionnez l’appareil dans son en-tête.

7. Mesures et commandes

Vérifiez que le panneau présente le bon chargeur et des valeurs à jour. Les fonctions disponibles comprennent l’état, la puissance, l’énergie de session, la limite de courant, le démarrage/l’arrêt et le diagnostic.

Les fonctions dépendent de l’appareil et des données transmises par Tuya. Les mesures par phase, le compteur total et la cible d’énergie n’apparaissent que si la source les prend en charge.

Lors du réglage de la limite de courant, le panneau affiche la valeur sélectionnée. Après une commande, attendez la confirmation du chargeur. La limite HA doit respecter la plage autorisée par le chargeur et l’installation électrique.

Exemple du panneau Ampere Point dans Home Assistant
Exemple de panneau. Les valeurs, la présentation et les fonctions peuvent varier selon la version et le chargeur.

8. Ajouter le chargeur au tableau Énergie

  1. Sélectionnez le chargeur dans le panneau AmperePoint et développez Énergie dans Home Assistant / Energy in Home Assistant au-dessus du pied de page. Vous y trouverez l’identifiant exact de l’entité Énergie de charge / Charging energy.
  2. Ajoutez cette entité comme appareil individuel dans les paramètres Énergie. Ajoutez chaque chargeur physique une seule fois. L’énergie de session, de dernière session et le capteur de diagnostic calculé à partir de la puissance ne sont pas des sources supplémentaires pour cette même consommation.
  3. Recorder doit enregistrer l’entité. Le nouveau compteur démarre à zéro ; les anciennes statistiques ne sont pas fusionnées automatiquement. Les graphiques demandent du temps pour collecter les données. Le coût de session affiché est une estimation énergie × tarif, pas un calcul aux prix historiques. Mesure et migration.

9. Planificateur et photovoltaïque

Le planificateur intégré enregistre les jours, plusieurs créneaux horaires et une limite de courant par créneau. Les dérogations manuelles permettent notamment de charger pendant une durée donnée ou jusqu’à une cible d’énergie.

Les commandes du planificateur sont exécutées par HA. Home Assistant et la connexion au chargeur doivent rester disponibles à l’heure de l’arrêt également. Coordonnez le planning avec l’application Tuya et les autres automatisations pour éviter des commandes contradictoires.

Depuis la version 0.6.1, le mode PV peut ajuster le courant au surplus solaire avec une source Tuya ou des entités associées. Dans les options de l’intégration, sélectionnez la production PV et la puissance réseau signée ou des mesures séparées d’import/export ; vérifiez les unités et le signe de l’import.

Les entrées AmperePoint Local (LAN) n’ont pas encore de réglages PV. Le mode est désactivé par défaut ; le régulateur de cette version a été testé avec des données synthétiques, sans essai de charge PV sur un chargeur physique. Configuration et limites PV.

10. Résoudre les problèmes d’installation

HACS ne trouve pas le dépôt ou signale un dossier manquant

Comparez l’adresse saisie avec le champ ci-dessus et choisissez Integration. Ouvrez le dépôt dans un navigateur. Si l’erreur persiste, notez son texte complet, l’adresse et vos versions de HA et HACS/Marketplace. Ce message seul ne permet pas d’en connaître la cause.

AmperePoint est absent après le téléchargement

Redémarrez HA et actualisez le navigateur. Recherchez ensuite AmperePoint sous Appareils et services → Ajouter une intégration.

L’assistant ne détecte pas le chargeur

Vérifiez qu’il est en ligne dans l’application et visible dans l’intégration officielle Tuya de HA. Rechargez Tuya si nécessaire.

Le panneau signale une configuration incorrecte ou affiche une ancienne version

Forcez l’actualisation du navigateur et vérifiez la version en pied de page. Si le problème persiste, transmettez l’erreur et la liste des ressources Lovelace avec leurs types. Supprimer le suffixe ?v= de l’URL de la carte n’est pas une correction permanente.

Des mesures par phase ou d’autres valeurs manquent

Cela dépend du modèle, du firmware et de la source Tuya. Une mesure absente ne signifie pas nécessairement que l’installation a échoué.

Énergie n’affiche pas encore de graphique

Vérifiez l’entité Charging energy et son enregistrement par Recorder, puis attendez la constitution des statistiques.

11. Mises à jour et autres connexions

Sauvegardez HA avant une mise à jour. Téléchargez la nouvelle version via HACS ou le Marketplace, redémarrez HA et actualisez le panneau. Vérifiez la version en pied de page. Lors d’une migration, conservez les entrées fonctionnelles et vérifiez les automatisations liées avant de les supprimer.

Tuya Local et Xtend Tuya peuvent servir de sources supplémentaires pour les configurations existantes ou avancées. La configuration Q Series ci-dessus demande seulement l’intégration officielle Tuya et AmperePoint. Le contrôle local est décrit dans un guide Tuya Local séparé. Wallbox PRIME utilise une autre connexion LAN : consultez le guide des connexions.

En cas de difficulté, écrivez à hello@amperepoint.com. Indiquez le modèle, le firmware, les versions de HA, de l’intégration et de HACS/Marketplace, l’étape et une capture du message complet. N’envoyez ni mot de passe, ni clé locale, ni jeton.

Retour au blog

Chargeurs avec compteur d’énergie

Tout afficher