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

Un guide étape par étape : de l'installation de Home Assistant, en passant par HACS et xtend_tuya, jusqu'aux données complètes du chargeur, au tableau de bord Énergie et aux automatisations utiles. Rédigé pour que même quelqu'un qui n'a jamais utilisé Home Assistant puisse le suivre.

Modèles : Q11, Q22, Q37, Q74  ·  mis à jour : juillet 2026

Les chargeurs Ampere Point Q Series sont des chargeurs Wi-Fi basés sur la plateforme Tuya. Cela signifie qu'ils peuvent être connectés à Home Assistant, le système domotique gratuit le plus populaire, et utilisés pour bien plus que le contrôle basique via une application mobile :

• Surveillance en temps réel : puissance, courant et tension pour chaque phase, énergie de la session, énergie totale et état de la charge,
• Contrôle : démarrer et arrêter la charge, changer la limite de courant,
• Automatisations : charger uniquement pendant les heures creuses, à partir de la production solaire excédentaire ou selon les tarifs d'électricité dynamiques,
• Historique et statistiques de consommation dans le tableau de bord Énergie, utiles pour les rapports et le suivi des coûts.

L'intégration fonctionne via le cloud Tuya, donc le chargeur et Home Assistant doivent avoir accès à Internet.

Table des matières

1. Ce dont vous avez besoin
2. Installation de Home Assistant si vous ne l'avez pas encore
3. Installation de HACS
4. Intégration officielle Tuya
5. Add-on xtend_tuya pour plus de données sur le chargeur
6. Ensemble complet de données avec les clés cloud développeur Tuya
7. Ce que vous obtenez après l'intégration et le tableau de bord Énergie
8. Exemples d'automatisations
9. Problèmes courants et solutions
10. Alternative : contrôle local avec tuya-local
11. Tous les liens en un seul endroit

1. Ce dont vous avez besoin

• Un chargeur Ampere Point Q Series ajouté à l'application Smart Life pour Android ou à l'application Smart Life pour iPhone et fonctionnant correctement.
• Un réseau Wi-Fi 2,4 GHz. Les modules Tuya ne se connectent pas aux réseaux 5 GHz. Si votre routeur diffuse les réseaux 2,4 GHz et 5 GHz sous un même nom, il vaut la peine de séparer temporairement le réseau 2,4 GHz pendant l'appairage.
• Un ordinateur ou un petit serveur pour Home Assistant. Il doit fonctionner en continu si vous voulez que les automatisations fonctionnent tout le temps. Les choix courants sont Raspberry Pi, un mini PC ou un ordinateur Windows classique.
• Un compte GitHub gratuit, nécessaire une fois pour l'autorisation HACS.
• Votre téléphone avec l'application Smart Life à proximité, car vous devrez scanner des codes QR pendant l'installation.
• Environ 1 à 2 heures. La plupart des étapes sont des clics simples guidés.

2. Installer Home Assistant si vous ne l'avez pas encore

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. Installation de HACS

HACS, le Home Assistant Community Store, est une boutique d’extensions communautaire. Nous l’utiliserons pour installer xtend_tuya. Les instructions officielles sont ici : hacs.xyz/docs/use/download/download. Choisissez l’onglet correspondant à votre installation.

• Home Assistant OS : ajoutez le dépôt d'add-ons https://github.com/hacs/addons selon les instructions officielles, installez et lancez l'add-on Get HACS, puis redémarrez Home Assistant.
• Option Docker : exécutez ceci dans le Terminal :

  docker exec homeassistant bash -c "wget -O - https://get.hacs.xyz | bash -"
  docker restart homeassistant

Après le redémarrage, ajoutez l'intégration : Paramètres → Appareils & services → Ajouter une intégration, recherchez HACS et acceptez les conditions. Home Assistant affichera un code que vous devrez saisir sur github.com/login/device après vous être connecté à GitHub. Confirmez avec Autoriser. Après un instant, HACS apparaîtra dans la barre latérale.

4. Intégration officielle Tuya

Cette étape connecte Home Assistant à votre compte Smart Life.

1. Allez dans Paramètres → Appareils & services → Ajouter une intégration et recherchez Tuya.
2. L'assistant vous demandera votre code utilisateur. Dans l'application Smart Life, trouvez-le sous Moi → Roue des paramètres → Compte et sécurité → Code utilisateur. Saisissez-le exactement. La casse des lettres est importante.
3. Un code QR apparaîtra à l'écran. Dans Smart Life, utilisez le scanner en haut à droite de l'onglet Moi, scannez le code et confirmez la connexion sur votre téléphone.
4. Après un instant, votre chargeur devrait apparaître dans la liste des appareils.

À quoi s'attendre : l'intégration officielle Tuya expose généralement une seule entité pour le chargeur, souvent un interrupteur de charge. Les données complètes telles que la puissance, les courants, les tensions, l'énergie et le statut détaillé apparaissent après l'ajout de xtend_tuya dans les étapes suivantes. L'absence de capteurs à ce stade n'est pas une erreur.

5. add-on xtend_tuya pour plus de données sur le chargeur

xtend_tuya fonctionne en parallèle avec l'intégration officielle Tuya et ajoute les entités manquantes aux mêmes appareils. Page du projet : github.com/azerty9971/xtend_tuya.

5.1. Téléchargement dans HACS

1. Ouvrez HACS depuis la barre latérale et recherchez Xtend Tuya. Vous pouvez aussi utiliser ce lien direct : ouvrir Xtend Tuya dans mon Home Assistant.
2. Sur la page de l'add-on, cliquez sur Télécharger et confirmez.
3. Redémarrez Home Assistant.

Le téléchargement dans HACS n'est que la première moitié du processus. Il copie les fichiers sur le disque, mais n'ajoute pas encore l'intégration. Les entités n'apparaissent qu'après avoir ajouté l'intégration dans la section 5.2. C'est la méprise la plus courante dans toute la configuration : après le téléchargement, le bouton Télécharger disparaît, la page de l'add-on affiche seulement une description, et le nombre d'entités ne augmente pas même après des redémarrages. Si c'est ce que vous voyez, tout va bien. Continuez avec l'étape suivante.

5.2. Ajouter l'intégration

1. Allez dans Paramètres → Appareils & services → Ajouter une intégration et recherchez Xtend Tuya.
2. Entrez le même code utilisateur que dans la section 4 et scannez à nouveau le code QR avec l'application Smart Life.
3. Après avoir confirmé le code QR, une nouvelle fenêtre appelée Ajouter les identifiants Tuya OpenAPI apparaîtra. Lisez la note ci-dessous avant de cliquer sur quoi que ce soit.

Le conseil le plus important de ce guide. Ne fermez pas la fenêtre Ajouter les identifiants Tuya OpenAPI avec le bouton X. La fermer annule tout l'assistant sans message clair. L'intégration ne sera pas ajoutée, même si cela peut sembler que vous avez terminé la configuration. Si vous n'avez pas encore les clés cloud développeur Tuya, que nous obtiendrons à la section 6 :

1. cochez Ne pas demander les identifiants OpenAPI,
2. choisissez aussi le pays Pologne et le point de terminaison Europe. Le formulaire exige toujours ces champs, et sans eux il peut afficher une erreur de validation peu claire,
3. confirmez, puis cliquez sur Terminer dans l'écran suivant avec les noms et zones.

Fenêtre des identifiants OpenAPI, montrée à titre de référence. Cochez la case, choisissez le pays et le point de terminaison, puis confirmez. Ne fermez pas la fenêtre avec le bouton X.

Après la fin de l'assistant, la liste des intégrations affichera Xtend Tuya. Votre chargeur devrait gagner plusieurs à plus de vingt nouvelles entités, y compris des capteurs de tension, courant, puissance, énergie et statut. Si l'entrée Xtend Tuya est manquante, l'assistant a été interrompu. Répétez la section 5.2.

6. Ensemble complet de données avec les clés cloud développeur Tuya

Cette étape est optionnelle, mais recommandée. Sans elle, certaines entités peuvent être indisponibles ou se mettre à jour plus lentement. Nous allons créer un projet gratuit sur la plateforme développeur Tuya et ajouter ses clés à xtend_tuya. La documentation de l'add-on décrit également la procédure ici : guide des identifiants cloud.

6.1. Créer un projet plateforme Tuya

1. Allez à platform.tuya.com et créez un compte gratuit. Vous pouvez utiliser la même adresse e-mail que dans Smart Life.
2. Allez dans Cloud → Développement → Créer un projet Cloud. Entrez un nom de projet quelconque. Pour Industrie et Méthode de développement, choisissez Smart Home. Pour Centre de données, choisissez Centre de données Europe centrale. Le centre de données doit correspondre à la région de votre compte Smart Life. Pour la Pologne, c'est l'Europe centrale. Le plan gratuit permet un seul centre de données.
3. Dans la fenêtre Autoriser les services API, acceptez les services suggérés.
4. Liez le compte de l’application : Appareils → Lier un compte d’application → Ajouter un compte d’application, scannez le QR code avec Smart Life et confirmez. Choisissez Liaison automatique, pour que les nouveaux appareils puissent se connecter automatiquement. Après un instant, votre chargeur devrait apparaître dans la liste des appareils.
5. Trouvez vos clés de projet dans l’onglet Aperçu dans la section Clé d’autorisation : ID d’accès / ID client et Secret d’accès / Client Secret. Utilisez l’icône œil pour révéler le secret.

Le Client Secret fonctionne comme un mot de passe pour votre projet. Ne le partagez pas et ne le collez pas dans des endroits publics. Si nécessaire, vous pouvez le réinitialiser dans l’onglet Aperçu. Après réinitialisation, mettez à jour la clé dans Home Assistant.

6.2. Activer tous les points de données avec DP Instruction

Par défaut, le cloud Tuya peut exposer les appareils en mode simplifié qui masque certains points de données. Pour exposer l’ensemble complet, passez le produit en mode DP Instruction : Appareils → Tous les appareils → bouton à trois points à côté de Voir les appareils par produit → survolez la carte du produit → icône crayon → cochez DP Instruction → Enregistrer la configuration. L’avertissement affiché par la plateforme s’applique uniquement à ce projet API. L’application Smart Life et le chargeur continuent de fonctionner comme avant. Des instructions illustrées sont disponibles dans la documentation xtend_tuya.

6.3. Saisir les clés dans Home Assistant

1. Allez dans Paramètres → Appareils & services → Xtend Tuya → Configurer. La même fenêtre d’identifiants OpenAPI s’ouvrira.
2. Cette fois, décochez Ne pas demander les identifiants OpenAPI. Choisissez le pays Pologne et le point de terminaison Europe, puis collez l’ID d’accès et le secret d’accès depuis l’onglet Aperçu du projet Tuya. Confirmez.
3. Redémarrez Home Assistant et attendez une à deux minutes. Le nombre d’entités du chargeur devrait augmenter à nouveau. Si ce n’est pas le cas, utilisez Recharger dans le menu à trois points à côté de l’intégration Xtend Tuya.

7. Ce que vous obtenez après l’intégration et le tableau de bord Énergie

La liste exacte des entités dépend du modèle de chargeur, mais inclut généralement :

Relevés	Contrôle
état de charge, puissance instantanée, courant et tension pour les phases L1 à L3, énergie de la session en cours, énergie totale et codes d’erreur	démarrer et arrêter la charge, limite de courant de charge, par exemple réduire de 16 A à 10 A, et modes d’appareil disponibles

Il est utile de donner des noms clairs aux entités dans Paramètres → Appareils & services → Entités. Si un élément, comme un interrupteur, apparaît deux fois, une fois depuis Tuya et une fois depuis xtend_tuya, c’est normal. Vous pouvez simplement désactiver l’entité en double que vous ne souhaitez pas utiliser.

Tableau de bord énergie : allez dans Paramètres → Tableaux de bord → Énergie. Dans la section Appareils individuels, ajoutez l'entité d'énergie totale du chargeur. Après une à deux heures, Home Assistant devrait commencer à afficher des graphiques de consommation journalière et mensuelle. Plus d'informations sur le tableau de bord Énergie : home-assistant.io/docs/energy.

8. Exemples d'automatisations

Les automatisations sont créées sous Paramètres → Automatisations & scènes → Créer une automatisation. Les exemples ci-dessous peuvent être collés en mode édition YAML. Remplacez les ID d'entités, tels que sensor.… et switch.…, par vos propres ID depuis l'onglet Entités. Les notifications téléphoniques nécessitent l'application gratuite Home Assistant Companion.

Charge uniquement pendant une plage tarifaire heures creuses, de 22:00 à 06:00 :

alias: Charge pendant les heures creuses
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 }

Notification lorsque la charge se termine :

alias: Charge terminée
trigger:
  - platform: state
    entity_id: sensor.charger_status
    from: "charging"
    to: "charger_free"
action:
  - service: notify.mobile_app_your_phone
    data:
      title: "Chargeur"
      message: "La charge est terminée."

Charge à partir de la production solaire excédentaire, si Home Assistant dispose d'un capteur pour la puissance exportée vers le réseau :

alias: Charge à partir de l'excès solaire
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. Problèmes courants et solutions

Symptôme	Que faire
Après avoir téléchargé xtend_tuya dans HACS, le nombre d'entités n'augmente pas et les redémarrages ne résolvent rien.	Télécharger les fichiers n'est pas la même chose qu'ajouter l'intégration. Vérifiez si Xtend Tuya apparaît sous Paramètres → Appareils & services. Sinon, complétez l'assistant de la section 5.2.
La fenêtre des identifiants OpenAPI a été fermée avec le bouton X et l'intégration a disparu.	L'assistant a été annulé. Relancez-le et gérez la fenêtre comme décrit dans la section 5.2 : case à cocher, pays, point de terminaison, puis confirmez.
Le formulaire OpenAPI affiche une erreur telle que la valeur doit être l'une des [...].	Même lorsque Ne pas demander... est coché, vous devez toujours choisir le pays et le point de terminaison. Sélectionnez Pologne et Europe, puis confirmez.
Les journaux affichent sign invalid.	L'ID d'accès ou le Secret a été collé avec une faute de frappe ou un espace en trop, ou le mauvais point de terminaison a été sélectionné. Copiez à nouveau les clés depuis l'onglet Aperçu du projet. Pour la Pologne, le point de terminaison est Europe.
Les journaux affichent permission deny ou le code 1106.	Dans votre projet sur la plateforme Tuya, vérifiez l’onglet Service API. Les services IoT Core et Autorisation doivent être actifs. Utilisez Autoriser ou Renouveler si nécessaire.
L’intégration fonctionnait, mais après quelques mois les données ont cessé de se mettre à jour.	L’essai gratuit d’IoT Core a peut-être expiré. Sur la plateforme Tuya, allez dans Cloud → projet → IoT Core → Prolonger l’essai. La prolongation est gratuite. Il est conseillé de mettre un rappel dans votre calendrier.
Le code QR de la plateforme Tuya ne fonctionne pas, ou la liaison du compte dans l’application échoue.	Le compte Smart Life et le projet sont probablement dans des centres de données différents. Créez le projet dans le centre de données Europe Centrale pour les comptes utilisés en Pologne.
Toutes les entités du chargeur sont indisponibles.	L’intégration fonctionne via le cloud. Vérifiez l’accès à Internet et confirmez que le chargeur est en ligne dans Smart Life. Lorsque la connectivité revient, les entités devraient se rétablir automatiquement.
Le chargeur ne se connecte pas au Wi-Fi après un changement de routeur ou de mot de passe.	Assurez-vous que le réseau Wi-Fi 2,4 GHz est activé et appairez de nouveau le chargeur dans Smart Life. Il devrait alors apparaître automatiquement dans Home Assistant.
Après une mise à jour de Home Assistant, Xtend Tuya ne démarre pas.	Vérifiez HACS pour une version plus récente de l’add-on et mettez-le à jour. Les intégrations personnalisées peuvent être sensibles aux versions majeures de Home Assistant. Avant de mettre à jour Home Assistant, il vaut souvent la peine d’attendre quelques jours et de consulter la page des problèmes du projet.
Le même interrupteur apparaît deux fois.	C’est normal lorsque xtend_tuya fonctionne en parallèle avec l’intégration officielle Tuya. Désactivez l’entité dupliquée dont vous n’avez pas besoin. Ne supprimez pas l’intégration.
Même après toutes les étapes, l’appareil n’a toujours qu’une seule entité.	Parfois, la définition du produit Tuya expose seulement un ensemble limité de données. Contactez-nous à hello@amperepoint.com avec votre modèle et une brève description du problème. Nous vérifierons la configuration du produit côté cloud.

10. Alternative : contrôle local avec tuya-local

Si vous souhaitez une indépendance vis-à-vis du cloud, afin que le contrôle puisse fonctionner même sans accès à Internet, vous pouvez utiliser tuya-local à la place. Il s’installe également via HACS. La configuration nécessite la clé locale de l’appareil et une cartographie manuelle des points de données, ce qui est plus technique et convient mieux aux utilisateurs déjà à l’aise avec Home Assistant. Un outil utile pour lire les données des appareils est TinyTuya.

11. Tous les liens en un seul endroit

Résumé

Après avoir suivi ce guide, votre chargeur Ampere Point Q Series devient une partie intégrante de votre maison intelligente. Vous pouvez voir chaque session de charge, suivre les coûts dans le tableau de bord Énergie et charger votre voiture lorsque l'électricité est la moins chère ou lorsque votre installation solaire produit un surplus d'énergie.

Les écrans de Home Assistant et de la plateforme Tuya changent de temps en temps, donc certains boutons peuvent se déplacer ou être renommés. L'ordre général des étapes reste le même.

Bloqué à une étape ? Envoyez-nous un e-mail à hello@amperepoint.com ou appelez le +48 666 612 044, du lundi au vendredi, de 10h00 à 17h00. Nous serons ravis de vous aider.

Vous cherchez un chargeur prêt à fonctionner avec Home Assistant ? Découvrez nos chargeurs Q Series avec compteurs d'énergie.