Guide de l'utilisateur de l'ESP8266 pour la connexion physique à votre appareil

Communication réseau locale ne nécessitant aucun service cloud
Mises à jour en temps réel de toutes les entités prises en charge exposées par le
appareil

Prend en charge les connexions cryptées à l'aide du cryptage de l'appareil
clé
Prise en charge de la programmation variable

Compatibilité:

Appareils vérifiés :

Ce pilote fonctionnera de manière générique avec n’importe quel périphérique ESPHome, mais
nous avons effectué des tests approfondis avec les appareils suivants :

ratgdo – Guide de configuration

Instructions d'utilisation du produit

Configuration de l'installateur

Une seule instance de pilote est requise par périphérique ESPHome.
Plusieurs instances de ce pilote connectées au même périphérique
ont un comportement inattendu. Cependant, vous pouvez avoir plusieurs instances
de ce pilote connecté à différents appareils ESPHome.

Configuration du cloud DriverCentral

Si vous avez déjà installé le pilote DriverCentral Cloud dans
votre projet, vous pouvez procéder à l'installation du pilote.

Ce pilote s'appuie sur le pilote DriverCentral Cloud pour gérer
licences et mises à jour automatiques. Si vous débutez avec
DriverCentral, vous pouvez vous référer à leur documentation Cloud Driver
pour le mettre en place.

Installation du pilote

Téléchargez la dernière version de control4-esphome.zip depuis
ConducteurCentral.

Extrayez et installez esphome.c4z, esphome_light.c4z et
Pilotes esphome_lock.c4z.
Utilisez l'onglet Rechercher pour trouver le pilote ESPHome et l'ajouter à
votre projet.

Sélectionnez le pilote nouvellement ajouté dans l'onglet Conception du système. Vérifiez
le statut du Cloud pour les informations de licence.
Actualisez l'état de la licence en sélectionnant DriverCentral Cloud
pilote et exécuter l'action Vérifier les pilotes.

Configurer les paramètres de l'appareil avec la connexion
information.
Attendez que l’état du pilote affiche Connecté.

Configuration du pilote

Propriétés du pilote :

FAQ

Q : Quels appareils sont compatibles avec ce pilote ?

R : Ce pilote est compatible avec tout appareil ESPHome, avec
Des tests approfondis ont été effectués sur des appareils ratgdo. Si vous l'essayez sur n'importe quel
autre appareil et cela fonctionne, veuillez nous en informer pour vérification.

Q : Comment puis-je surveiller et contrôler les appareils ESPHome ?

R : Vous pouvez surveiller et contrôler les appareils ESPHome via un web
navigateur, Home Assistant ou autres plateformes compatibles après
les intégrer dans Control4 à l'aide de ce pilote.

« `

View Fullscreen

Surview
Intégrez des appareils ESPHome à Control4. ESPHome est un système open source qui transforme des microcontrôleurs courants, comme l'ESP8266 et l'ESP32, en appareils domestiques intelligents grâce à une simple configuration YAML. Les appareils ESPHome peuvent être configurés, surveillés et contrôlés via un web Navigateur, Home Assistant ou autres plateformes compatibles. Ce pilote permet une surveillance et un contrôle fluides des appareils ESPHome directement depuis votre système Control4.
Indice
Configuration requise Fonctionnalités Compatibilité
Appareils vérifiés pris en charge ESPHome Entités Installateur Configuration DriverCentral Cloud Configuration Installation du pilote Configuration du pilote
Propriétés du pilote Paramètres du cloud Paramètres du pilote Paramètres de l'appareil Informations sur l'appareil
Guides de configuration des actions du pilote
Guide de configuration de ratgdo Informations pour les développeurs Assistance Journal des modifications

Configuration requise
Control4 OS 3.3+
Caractéristiques
Communication réseau locale ne nécessitant aucun service cloud Mises à jour en temps réel de toutes les entités prises en charge exposées par l'appareil Prend en charge les connexions cryptées à l'aide de la clé de cryptage de l'appareil Prise en charge de la programmation variable
Compatibilité
Appareils vérifiés
Ce pilote fonctionnera de manière générique avec n’importe quel périphérique ESPHome, mais nous avons effectué des tests approfondis avec les périphériques suivants :
ratgdo – Guide de configuration Si vous essayez ce pilote sur un produit répertorié ci-dessus et qu'il fonctionne, faites-le nous savoir !

Entités ESPHome prises en charge

Type d'entité Panneau de contrôle d'alarme API Bruit Capteur binaire Bluetooth Proxy Bouton Climatisation Couverture Date/Heure Date/Heure Caméra Événement Ventilateur Lumière Verrouillage Lecteur multimédia Numéro Sélectionner Capteur Sirène Interrupteur Texte Mise à jour du capteur de texte Valve Assistant vocal

Soutenu

Configuration de l'installateur
Une seule instance de pilote est requise par appareil ESPHome. Plusieurs instances de ce pilote
Un pilote connecté au même périphérique aura un comportement inattendu. Cependant, plusieurs instances de ce pilote peuvent être connectées à différents périphériques ESPHome.
Configuration du cloud DriverCentral
Si vous avez déjà installé le pilote DriverCentral Cloud dans votre projet, vous pouvez continuer vers l'installation du pilote.
Ce pilote s'appuie sur le pilote cloud DriverCentral pour gérer les licences et les mises à jour automatiques. Si vous débutez avec DriverCentral, vous pouvez consulter la documentation du pilote cloud pour le configurer.
Installation du pilote
L'installation et la configuration des pilotes sont similaires à celles de la plupart des autres pilotes IP. Vous trouverez ci-dessous un aperçu des étapes de base pour vous faciliter la tâche.
1. Téléchargez la dernière version de control4-esphome.zip depuis DriverCentral.
2. Extrayez et installez les pilotes esphome.c4z , esphome_light.c4z et esphome_lock.c4z.
3. Utilisez l’onglet « Rechercher » pour trouver le pilote « ESPHome » et ajoutez-le à votre projet.
Ü Une seule instance de pilote est requise par périphérique ESPHome.

4. Sélectionnez le pilote nouvellement ajouté dans l'onglet « Conception du système ». Vous remarquerez que l'état du cloud reflète l'état de la licence. Si vous avez acheté une licence, l'état « Licence activée » s'affichera, sinon « Essai en cours » et la durée restante de l'essai.
5. Vous pouvez actualiser l'état de la licence en sélectionnant le pilote « DriverCentral Cloud » dans l'onglet « Conception du système » et en effectuant l'action « Vérifier les pilotes ».
6. Configurez les paramètres de l'appareil avec les informations de connexion. 7. Après quelques instants, l'état du pilote affichera « Connecté ». Si le pilote ne parvient pas à
Connectez-vous, définissez le mode de journalisation sur Imprimer et redéfinissez le champ Adresse IP pour vous reconnecter. Consultez ensuite la fenêtre de sortie Lua pour plus d'informations. 8. Une fois connecté, le pilote crée automatiquement des variables et des connexions pour chaque type d'entité pris en charge. 9. Pour contrôler les lumières et/ou les serrures, utilisez l'onglet « Rechercher » pour trouver le pilote « ESPHome Light » et/ou « ESPHome Lock ». Ajoutez une instance de pilote pour chaque entité lumière ou serrure exposée dans votre projet. Dans l'onglet « Connexions », sélectionnez le pilote « ESPHome » et liez les entités lumière ou serrure aux nouveaux pilotes ajoutés.
Configuration du pilote
Propriétés du pilote
Paramètres du cloud
État du cloud : affiche l’état de la licence cloud DriverCentral. Mises à jour automatiques : active/désactive les mises à jour automatiques du cloud DriverCentral.
Paramètres du pilote
Statut du pilote (lecture seule)

Affiche l'état actuel du pilote.
Version du pilote (lecture seule) Affiche la version actuelle du pilote.
Niveau de journalisation [Fatal | Erreur | Avertissement | Info | Débogage | Trace | Ultra] Définit le niveau de journalisation. La valeur par défaut est Info.
Mode journal [Désactivé | Imprimer | Journal | Imprimer et journaliser] Définit le mode de journalisation. La valeur par défaut est Désactivé.
Paramètres de l'appareil
Adresse IP : définit l'adresse IP de l'appareil (par exemple, 192.168.1.30). Les noms de domaine sont autorisés à condition qu'ils puissent être résolus en une adresse IP accessible par le contrôleur. HTTPS n'est pas pris en charge.
Si vous utilisez une adresse IP, vous devez vous assurer qu'elle ne changera pas en attribuant une adresse statique.
IP ou création d'une réservation DHCP. Port Définit le port de l'appareil. Le port par défaut pour les appareils ESPHome est 6053. Mode d'authentification [Aucun | Mot de passe | Clé de chiffrement] Sélectionne la méthode d'authentification pour la connexion à l'appareil ESPHome.
Aucun : aucune authentification requise. Mot de passe : utilisez un mot de passe pour l’authentification (voir ci-dessous). Clé de chiffrement : utilisez une clé de chiffrement pour une communication sécurisée (voir ci-dessous).
Mot de passe affiché uniquement si le mode d'authentification est défini sur Mot de passe. Définit le mot de passe de l'appareil. Il doit correspondre à celui configuré sur l'appareil ESPHome.
Clé de chiffrement : affichée uniquement si le mode d'authentification est défini sur « Clé de chiffrement ». Définit la clé de chiffrement de l'appareil pour une communication sécurisée. Elle doit correspondre à la clé de chiffrement configurée sur l'appareil ESPHome.
Informations sur l'appareil

Nom (lecture seule) Affiche le nom de l'appareil ESPHome connecté. Modèle (lecture seule) Affiche le modèle de l'appareil ESPHome connecté. Fabricant (lecture seule) Affiche le fabricant de l'appareil ESPHome connecté. Adresse MAC (lecture seule) Affiche l'adresse MAC de l'appareil ESPHome connecté. Version du micrologiciel (lecture seule) Affiche la version du micrologiciel de l'appareil ESPHome connecté.
Actions du conducteur
Réinitialiser les connexions et les variables
Cela réinitialisera toutes les liaisons de connexion et supprimera toute programmation associée à la
variables.
Réinitialiser les connexions et les variables du pilote. Ceci est utile si vous changez le périphérique ESPHome connecté ou si des connexions ou des variables sont obsolètes.

Guide de configuration de ratgdo
Ce guide fournit des instructions pour configurer le pilote ESPHome pour qu'il fonctionne avec les périphériques ratgdo pour le contrôle des portes de garage via des relais dans Control4 Composer Pro.
Ajouter un pilote de contrôleur de relais
Ajoutez le pilote de contrôleur de relais souhaité à votre projet Control4 dans Composer Pro.
Propriétés du contrôleur de relais
Le périphérique ratgdo expose une entité « Cover » dans ESPHome, qui correspond à la fonctionnalité du contrôleur de relais dans Control4.
Nombre de relais
Le dispositif ratgdo utilise une configuration multi-relais pour contrôler la porte de garage. Dans Composer Pro, configurez les paramètres du relais comme suit :

Régler sur 2 relais (Ouverture/Fermeture) ou 3 relais (Ouverture/Fermeture/Arrêt). Le dispositif ratgdo utilise des commandes distinctes pour ouvrir et fermer la porte de garage. Si votre micrologiciel ratgdo prend en charge la commande « Stop », configurez-le pour 3 relais afin d'activer la fonctionnalité d'arrêt. En cas de doute, vous pouvez vérifier les connexions du ratgdo dans Composer Pro pour vérifier si le relais « Stop Door » est disponible.
Configuration du relais
Réglé sur Pulse ratgdo utilise des impulsions momentanées pour déclencher l'ouvre-porte de garage, de manière similaire à une pression sur un bouton mural
Temps d'impulsion
Réglez toutes les durées d'impulsion du relais sur 500 (par défaut). Il s'agit de la durée pendant laquelle le relais sera activé.
Relais inversé
Définir toutes les propriétés du relais d'inversion sur Non (par défaut)
Contacter Debounce
Définissez tous les temps de rebond des contacts sur 250 (par défaut). Cela permet d'éviter les faux battements des capteurs d'état de la porte de garage.
Inverser le contact
Définir toutes les propriétés de contact inversé sur Non (par défaut)
Example Propriétés
Pour référence, voici un exempleample des propriétés du contrôleur de relais dans Composer Pro :

Connexions du contrôleur de relais
Relais
Ouvrir : Se connecter au relais « Ouvrir la porte » du ratgdo Fermer : Se connecter au relais « Fermer la porte » du ratgdo Arrêter : Se connecter au relais « Arrêter la porte » du ratgdo, si disponible
Capteurs de contact
Contact fermé : connectez-vous au contact « Porte fermée » du ratgdo Contact ouvert : connectez-vous au contact « Porte ouverte » du ratgdo
Examples connexions

Pour référence, voici un exempleampVoici à quoi devraient ressembler les connexions dans Composer Pro :
Programmation
Vous pouvez créer une programmation dans Control4 pour : Ouvrir/fermer la porte de garage en fonction des événements Surveiller l'état de la porte de garage Configurer des notifications pour les changements d'état de la porte de garage Créer des boutons personnalisés sur les écrans tactiles et les télécommandes
Example : Créer une alerte « Toujours ouvert »
Utilisation de la propriété « Durée d'ouverture restante » du pilote du contrôleur de relais : 1. Définissez la « Durée d'ouverture restante » sur la durée souhaitée (par exemple, 10 minutes) 2. Créez une règle de programmation qui se déclenche lorsque l'événement « Durée d'ouverture restante » se déclenche 3. Ajoutez des actions pour envoyer des notifications ou effectuer d'autres tâches
Entités supplémentaires
Selon votre périphérique ratgdo, son firmware et ses capacités, le pilote ESPHome peut exposer des entités supplémentaires. Il peut s'agir de connexions supplémentaires ou de variables de pilote. Pour plus d'informations sur les entités spécifiques, veuillez consulter la documentation de ratgdo : https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Information développeur
Copyright © 2025 Finite Labs LLC. Toutes les informations contenues dans ce document sont et restent la propriété de Finite Labs LLC et de ses fournisseurs, le cas échéant. Les concepts intellectuels et techniques contenus dans ce document sont la propriété de Finite Labs LLC et de ses fournisseurs et peuvent être couverts par des brevets américains et étrangers, des brevets en cours de traitement, et sont protégés par le secret commercial ou le droit d'auteur. La diffusion ou la reproduction de ces informations est strictement interdite sans l'autorisation écrite préalable de Finite Labs LLC. Pour les informations les plus récentes, veuillez consulter https://drivercentral.io/platforms/control4-drivers/utility/esphome
Soutien
Si vous avez des questions ou des problèmes lors de l'intégration de ce pilote avec Control4 ou ESPHome, vous pouvez nous contacter à driver-support@finitelabs.com ou nous appeler/envoyer un SMS au +1 949-371-5805.

Journal des modifications
v20250715 – 2025-07-14
Fixé
Correction d'un bug empêchant la découverte des entités lors de la connexion
v20250714 – 2025-07-14
Ajouté
Ajout de la prise en charge des connexions chiffrées à l'aide de la clé de chiffrement de l'appareil
v20250619 – 2025-06-19
Ajouté
Ajout de la documentation spécifique à ratgdo
v20250606 – 2025-06-06
Ajouté
Version initiale

Documents / Ressources

ESPHome ESP8266 Connexion physique à votre appareil [pdf] Guide de l'utilisateur
ESP8266, ESP32, ESP8266 Connexion physique à votre appareil, ESP8266, Connexion physique à votre appareil, Connexion à votre appareil, à votre appareil, votre appareil

Références

Manuel d'utilisation