Guide d'installation

Cette page couvre la première installation d'ESPSomfy-RTS : écrire l'ESP32 en entier par USB, depuis un navigateur, sans rien installer sur votre ordinateur. C'est la voie à prendre dans deux cas — un ESP32 qui n'a jamais reçu ce firmware, et un appareil qui tourne aujourd'hui sous le firmware d'origine de rstrouse.

Une fois l'appareil en service, vous n'y revenez plus : les versions suivantes s'installent depuis l'interface, en deux clics — voir Mettre à jour.

---

1. Pourquoi par USB, et pas depuis l'interface

L'appareil tient en deux partitions, le firmware et l'interface web, et une table de partition qui dit où chacune commence. Les mises à jour par l'interface réécrivent les partitions, jamais la table : elles supposent un ESP32 déjà découpé à la bonne mesure.

L'image dite onboard est la seule à contenir l'ensemble — chargeur d'amorçage, table de partition, firmware et interface. Elle écrase l'ESP32 du premier au dernier octet, et c'est précisément ce qu'il faut pour une première installation.

Votre situation	La voie à prendre
ESP32 neuf, ou firmware d'un autre projet	Cette page — USB, image onboard
Firmware d'origine de rstrouse	Cette page — USB, image onboard
Déjà sous ce firmware	Mettre à jour, depuis l'interface

Warning

Ne passez pas du firmware de rstrouse à celui-ci par sa page Firmware. Cette route n'est pas prise en charge : elle ne remplace qu'une moitié du système, et laisse une interface et un firmware qui ne se comprennent pas. L'installation complète par USB est la seule voie.

2. Prérequis

• Un ordinateur avec Google Chrome, Microsoft Edge ou Firefox 151 au minimum. Tout repose sur Web Serial, la technologie qui laisse une page web parler au port USB.
• Un câble USB de données. Beaucoup de câbles fournis avec des chargeurs ne transportent que l'alimentation : avec ceux-là, aucun port n'apparaîtra.
• L'image onboard correspondant à votre modèle d'ESP32, décompressée.

Note

Firefox sait le faire depuis peu. Mozilla a longtemps refusé Web Serial, et ne l'a ajouté qu'avec Firefox 151, paru en mai 2026. Une version antérieure ne verra pas votre ESP32 — et cela vaut pour l'ordinateur seulement : Firefox pour Android ne l'expose pas. Safari ne le prend toujours pas en charge, à aucune version.

3. Télécharger la bonne image

Ouvrez la page de la dernière version publiée : github.com/xkain/ESPSomfy-RTS/releases/latest — la liste complète des versions est sur la page Releases.

Dépliez sa section Assets : elle publie treize fichiers, et pour une installation par USB un seul vous concerne, celui dont le nom contient onboard.

Votre ESP32	Le fichier à prendre
ESP32 classique, sans PSRAM	SomfyController.onboard.esp32.bin.zip
ESP32 avec PSRAM (WROVER)	SomfyController.onboard.esp32wrover.bin.zip
ESP32-S2	SomfyController.onboard.esp32s2.bin.zip
ESP32-S3, flash de 4 Mo	SomfyController.onboard.esp32s3_4mb.bin.zip
ESP32-S3, flash de 8 Mo	SomfyController.onboard.esp32s3_8mb.bin.zip
ESP32-C3	SomfyController.onboard.esp32c3.bin.zip

Décompressez l'archive pour obtenir le .bin qu'elle contient : c'est ce fichier que vous donnerez au navigateur, pas le .zip.

Note

Les deux éditions préassemblées reposent toutes les deux sur un ESP32 sans PSRAM : prenez SomfyController.onboard.esp32.bin.zip, pour le modèle Wi-Fi comme pour le modèle Ethernet. Voir Boîtiers préassemblés.

Tip

Les douze autres fichiers ne servent qu'aux mises à jour d'un appareil déjà installé, et leur rôle est détaillé dans Les fichiers d'une release.

4. Avant d'écraser : la sauvegarde

Si un appareil est déjà en service — sous ce firmware ou sous celui de rstrouse — prenez une sauvegarde avant de flasher. L'image onboard efface tout l'ESP32, configuration comprise : équipements, groupes, pièces, réseau, tout disparaît.

Depuis l'interface actuelle, onglet Système > sous-onglet Firmware, le bouton Sauvegarde de la configuration télécharge un fichier .backup dans votre navigateur. Mettez-le de côté : vous le rechargerez après l'installation.

5. Flasher par USB

Nous passons par web.esphome.io, l'outil de flashage du projet ESPHome. Il n'installe pas ESPHome : avec l'option « choisir un fichier », il écrit sur l'ESP32 l'image que vous lui donnez, telle quelle, à partir du premier octet. C'est l'utilitaire esptool porté dans le navigateur, qui parle au chargeur d'amorçage de l'ESP32 par Web Serial — exactement ce que ferait une ligne de commande, sans ligne de commande.

Deux raisons de le préférer : rien à installer sur votre ordinateur — ni Python, ni esptool, ni PlatformIO — et la même procédure sous Windows, macOS et Linux. C'est aussi pourquoi l'image onboard est publiée en un seul fichier : le chargeur d'amorçage, la table de partition, le firmware et l'interface y sont déjà fusionnés à leurs adresses respectives, si bien que l'outil n'a rien à savoir du projet pour l'installer correctement.

Note

Le site suit la langue de votre navigateur. Les libellés et les captures ci-dessous sont ceux de la version française. Avec un navigateur en anglais, lisez Connect, Prepare for first use et Install.

1. Branchez l'appareil à votre ordinateur avec le câble USB.

2. Ouvrez https://web.esphome.io/ dans l'un des trois navigateurs ci-dessus.

3. Cliquez sur Connection.

   

4. Une fenêtre liste les ports série. Choisissez le vôtre — souvent nommé USB Single Serial, CP210x ou CH340 — puis Connexion.

   • Si aucun port n'apparaît : changez de câble, ou installez le pilote CH340 / CP210x correspondant à votre carte.
   

5. Cliquez sur INSTALLER, à droite du bouton bleu Préparation pour la première utilisation — ce dernier installerait ESPHome, ce n'est pas ce que nous voulons.

   

6. Cliquez sur Choisir un fichier et désignez le .bin décompressé à l'étape 3.

   

7. Le fichier choisi, cliquez de nouveau sur INSTALLER pour lancer l'écriture.

8. L'installation se déroule en trois temps : connexion à l'appareil, effacement complet de l'ESP32, puis écriture — c'est seulement à ce moment qu'une barre de progression apparaît. Ne fermez pas l'onglet et ne débranchez pas le câble.

   

9. Un message annonce la fin de l'installation, et l'appareil redémarre de lui-même.

   

Note

Certaines cartes demandent un geste pour accepter l'écriture. Le D1 Mini se flashe tel quel, au simple branchement ; le WT32-ETH01 a besoin qu'on le mette en mode flash — sur l'édition Ethernet préassemblée, un bouton-poussoir en face inférieure s'en charge. Voir Boîtiers préassemblés et Composants.

6. Premier démarrage

L'appareil sort d'usine sans réseau : il ouvre donc son propre point d'accès Wi-Fi.

1. Depuis un téléphone ou un ordinateur, connectez-vous au réseau ESPSomfyRTS, sans mot de passe.
2. Ouvrez http://192.168.4.1.
3. Si l'interface paraît incomplète, forcez le rafraîchissement du navigateur : Ctrl + F5 sous Windows et Linux, Cmd + Maj + R sur Mac.
4. Renseignez votre réseau — la procédure complète, Wi-Fi comme Ethernet, est dans Connexion.

Important

Une installation complète efface aussi la préconfiguration des boîtiers préassemblés : fuseau horaire, langue, assignation des GPIO et activation de la radio reviennent aux réglages universels. L'interface embarque un assistant qui remet les quatre d'un coup — voir Boîtiers préassemblés. Sans lui, la radio reste muette : rien ne sera émis.

7. Si vous veniez du firmware de rstrouse

Rechargez votre .backup depuis l'onglet Système > sous-onglet Firmware. Vos équipements, groupes et adresses de télécommande sont repris : vos moteurs n'ont pas à être réappairés.

• Un avertissement de compatibilité s'affiche pendant la restauration. Il est attendu, et ne signale pas un échec.
• L'assignation des GPIO n'est pas restaurée. Le sélecteur de carte introduit par ce fork ne peut pas la deviner depuis un fichier plus ancien : il faut la refaire à la main dans l'onglet Radio — voir Configurer la Radio.

Important

Si votre sauvegarde refuse de se charger, ouvrez une issue. Le fichier peut être analysé et corrigé à la main pour redevenir lisible.

---

Étape suivante

• Connexion — rejoindre votre réseau, en Wi-Fi ou en Ethernet.
• Tableau de bord — la visite de l'interface, écran par écran.
• Mettre à jour — les versions suivantes, depuis l'interface.