Guide d’Installation : ESPHome & Home Assistant (Windows)

Ce guide couvre l’installation des outils nécessaires, la préparation de votre carte Freenove ESP32-S3 et l’intégration dans Home Assistant.

Installation Automatisée (Windows)

Pour simplifier l’installation, nous avons préparé un script qui installe tous les outils nécessaires (Python, VSCode, ESPHome).

  1. Téléchargez le fichier setup_esp32.ps1 (ou créez un fichier texte avec ce nom et copiez le code ci-dessus dedans).

  2. Faites un Clic-Droit sur le fichier > Exécuter avec PowerShell.

  3. Acceptez les demandes d’autorisation (Droits Administrateur).

  4. Une fois terminé, redémarrez votre ordinateur.

Partie 1 : Installation des prérequis (Chocolatey & Python)

Nous utiliserons Chocolatey, un gestionnaire de paquets pour Windows, afin de simplifier l’installation des logiciels.

1. Installer Chocolatey

  1. Ouvrez PowerShell en tant qu’administrateur (Clic droit sur le menu Démarrer > Terminal (Admin) ou Windows PowerShell (Admin)).

  2. Copiez et collez la commande suivante pour installer Chocolatey :

     Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

  3. Une fois terminé, fermez et rouvrez PowerShell (toujours en administrateur).

2. Installer Python

Dans votre fenêtre PowerShell, exécutez la commande suivante pour installer Python 3 :

choco install python -y

Vérifiez l’installation en tapant python --version.

3. Installer ESPHome (CLI)

ESPHome est l’outil qui permettra de créer le firmware pour votre ESP32-S3. Installez-le via Python :

pip install esphome

Partie 2 : Environnement de Développement (VSCode)

Visual Studio Code sera utilisé pour éditer les configurations et téléverser le code sur la carte.

1. Installer VSCode

Si vous ne l’avez pas encore, installez-le via Chocolatey :

choco install vscode -y

2. Installer l’extension ESPHome

  1. Ouvrez Visual Studio Code.

  2. Allez dans l’onglet Extensions (le carré à gauche ou Ctrl+Shift+X).

  3. Recherchez “ESPHome” et installez l’extension officielle.

Partie 3 : Configuration de la Freenove ESP32-S3

1. Création du projet avec le Wizard

  1. Dans VSCode, cliquez sur le logo ESPHome (le “E” dans la barre latérale).

  2. Cliquez sur “New Device” (ou le +).

  3. Suivez le guide (Wizard) :

    • Name : Donnez un nom (ex: salon-sensor).

    • Device Type : Choisissez ESP32-S3.

    • Configuration : Laissez les réglages par défaut pour l’instant.

  4. Une clé de chiffrement (Encryption Key) va être générée. Sauvegardez-la, elle sera requise par Home Assistant.

2. Connexion Matérielle

Pour le premier flashage, il est impératif de connecter la carte correctement :

  • Utilisez le Port de Droite (USB/UART) de la devboard Freenove. Comme indiqué dans le manuel, ce port est dédié au “Monitoring Série” et permet le téléversement classique via USB.

  • Le port de gauche est réservé au débogage JTAG et pourrait ne pas fonctionner simplement pour ce premier flash.

3. Installation sur l’ESP32-S3

  1. Dans le menu ESPHome de VSCode, sous votre nouveau projet, cliquez sur les trois petits points à côté de “Install”.

  2. Choisissez “Plug into this computer”.

  3. Sélectionnez le port COM correspondant à votre ESP32-S3 (souvent détecté comme “Silicon Labs CP210x” ou similaire).

  4. L’installation va compiler le firmware et l’envoyer sur la carte. Cela peut prendre quelques minutes.

Partie 4 : Home Assistant et Configuration WiFi

Une fois l’installation terminée, l’ESP32-S3 va redémarrer. S’il n’a pas vos identifiants WiFi (ce qui est le cas lors d’une première installation), il va créer son propre réseau (Hotspot).

1. Connexion au Hotspot de l’ESP

  1. Sur votre ordinateur ou téléphone, recherchez les réseaux WiFi.

  2. Connectez-vous au réseau nommé salon-sensor (ou le nom que vous avez choisi).

  3. Une page “Captive Portal” devrait s’ouvrir automatiquement. Si ce n’est pas le cas, allez sur http://192.168.4.1.

  4. Sélectionnez votre réseau WiFi domestique dans la liste et entrez le mot de passe. L’ESP va redémarrer et se connecter à votre réseau.

2. Installation de Home Assistant Core (via Python)

Nous allons installer une version légère de Home Assistant directement sur votre PC Windows pour tester l’intégration.

Dans PowerShell :

pip install homeassistant

3. Lancement et Configuration

  1. Lancez Home Assistant avec la commande :

     hass --open-ui

  2. Votre navigateur s’ouvrira sur http://127.0.0.1:8123. Créez votre compte administrateur.

  3. Allez dans Paramètres > Appareils et services.

  4. Home Assistant devrait découvrir automatiquement votre ESP32-S3. Cliquez sur Configurer.

  5. Entrez le mot de passe de l’API (la clé de chiffrement générée lors de l’étape du Wizard dans VSCode).

Votre Freenove ESP32-S3 est maintenant connectée et pilotable via Home Assistant !