WLED v16 : nouveautés et guide de migration 2026

WLED v16 est sortie le 3 mai 2026 et marque une rupture dans l'histoire du projet. Après 16 mois de développement depuis v0.14, l'équipe a choisi d'abandonner le préfixe "0." et de sauter directement à v16 — un signal fort sur l'ampleur des changements embarqués. Si vous pilotez déjà WLED sur ESP32 dans Home Assistant, cette migration mérite attention : elle apporte des améliorations majeures de stabilité, mais quelques breaking changes peuvent surprendre si vous n'avez pas préparé la transition.

Pourquoi WLED v16 est une release exceptionnelle

Depuis la création du projet par Aircoookie en 2019, les releases WLED ont toujours suivi un versionnage 0.x. WLED 0.14 est sorti fin 2023, puis 0.15 en décembre 2024. Pour v16, l'équipe a décidé d'abandonner définitivement ce format pour signaler que le logiciel est désormais mature — et que cette version représente un tournant architectural.

Les chiffres parlent d'eux-mêmes : environ 17 mois de développement depuis v0.15, plusieurs centaines de commits, une refonte complète du système de bus LED, et des améliorations qui touchent tous les aspects du firmware — de la gestion matérielle à l'interface web. Aucune version précédente n'a apporté autant de changements en profondeur.

En pratique pour vous : WLED v16 est plus stable, se connecte plus vite au Wi-Fi, et gère mieux les scénarios de coupure ou de mauvaise configuration. La contrepartie — quelques points à vérifier avant de migrer, détaillés en section 5.

Les nouveautés WLED v16 en détail

Nouveau bus manager

Le bus manager est le composant qui gère la relation entre le firmware et les GPIO physiques pilotant vos LED. Dans v16, il a été entièrement réécrit. Les gains concrets :

• Meilleure persistance de la configuration entre mises à jour OTA — vos assignations de bus ne sont plus réinitialisées à chaque flash
• Support multi-bus amélioré — les installations avec plusieurs types de LED (RGBW + WS2812B par exemple) sont mieux gérées
• Initialisation plus robuste au démarrage, ce qui contribue directement à la réduction des boot-loops

Si vous venez de v0.14 avec une configuration multi-segment complexe, vérifiez vos assignations de bus après migration — voir la section "Breaking changes" plus bas.

Boot-loop recovery automatique

C'est l'une des nouveautés les plus attendues de la communauté. Avant v16, une mauvaise configuration ou un flash raté pouvait mettre un ESP dans une boucle de redémarrage infinie, nécessitant un reflash USB. Désormais, le firmware détecte les cycles de boot répétés et revient automatiquement à une configuration "safe" — point d'accès Wi-Fi avec les paramètres d'usine.

En pratique : après 3 redémarrages rapides consécutifs, WLED v16 active le mode safe et vous permet d'accéder à l'interface pour corriger le problème. Plus besoin de sortir le câble USB pour une configuration corrompue.

WiFi fast connect

Le temps de connexion Wi-Fi au démarrage est significativement réduit sur les configurations ESP32. Cette amélioration vient d'une meilleure gestion du cache des credentials Wi-Fi et d'une optimisation de la séquence d'initialisation — les retours communautaires (Discord WLED, Reddit r/WLED) font état d'une reconnexion nettement plus réactive après coupure.

Pour les installations sur onduleur ou sujettes aux micro-coupures, c'est un gain tangible : vos LEDs reviennent en ligne plus vite après une interruption secteur, ce qui réduit les alertes "entity unavailable" dans Home Assistant.

Nouveau framework usermod

Les usermods sont les extensions tierces qui ajoutent des fonctionnalités à WLED : capteurs de température, boutons physiques, afficheurs OLED, intégration I2C. Dans v16, l'API usermod a été unifiée et documentée. Les usermods officiels (DS18B20, SHT3x, OLED display, audioreactive) ont tous été mis à jour vers le nouveau framework.

Attention si vous compilez vos propres usermods : les usermods écrits pour v0.14 ne compilent plus sans adaptation. C'est un breaking change pour les utilisateurs avancés — les détails sont dans la section suivante.

Audioreactive et AsyncWebServer

Le usermod audioreactive (effets synchronisés sur le son) a reçu des corrections importantes sur la synchronisation I2S, particulièrement pour les microphones I2S de type INMP441. Les artéfacts de gel d'effets signalés depuis plusieurs mois sur le Discord WLED sont corrigés dans v16.

Le serveur web embarqué (AsyncWebServer) a également été mis à jour vers une version plus récente, ce qui améliore la stabilité de l'interface et la compatibilité avec les navigateurs modernes.

Compatibilité matérielle : ESP8266, ESP32, ESP32-S3 et ESP32-C3

WLED v16 maintient le support de la majorité des cartes ESP, mais avec des niveaux de fonctionnalités différents selon le matériel.

ESP8266 (NodeMCU, Wemos D1 Mini) : toujours supporté, mais les nouvelles fonctionnalités du bus manager sont partiellement limitées. L'ESP8266 reste viable pour les installations simples — un segment, pas d'audioreactive. Pour tout projet nouveau, préférez un ESP32.

ESP32 (original) : support complet de toutes les nouveautés v16. La plateforme de référence pour WLED. Les modules ESP32-WROOM restent une valeur sûre pour toute installation existante.

ESP32-S3 : support amélioré dans v16, avec de meilleures performances sur les effets visuels complexes et l'audioreactive. Recommandé pour les nouvelles installations à forte charge.

ESP32-C3 : alternative compacte et économique, maintenant bien supportée dans v16. Le format Super Mini fait environ 22 × 18 mm — il rentre dans la plupart des profilés aluminium standard utilisés en installation LED encastrée. C'est notre recommandation pour les projets où l'encombrement compte.

Pour les utilisateurs sur ESP8266 avec une installation stable, la migration vers v16 est moins urgente. Le support ESP8266 sera progressivement réduit dans les versions futures — prévoyez la transition vers ESP32 dans votre prochain projet.

Procédure de mise à jour OTA pas-à-pas

La mise à jour via OTA (Over-The-Air) est la méthode recommandée si votre ESP est accessible sur le réseau. Comptez environ 5 minutes pour une installation déjà sous v0.14 ou v0.15.

1. Sauvegarder votre configuration actuelle. Dans l'interface WLED : Settings → Security & Updates → bouton "Download backup". Enregistrez le fichier JSON — c'est votre filet de sécurité en cas de problème.
2. Vérifier votre version actuelle. Settings → About → Build Info. Notez la version et le type de build (esp32, esp32s3, esp8266). Vous en aurez besoin pour télécharger le bon binaire.
3. Télécharger le bon binaire. Rendez-vous sur github.com/Aircoookie/WLED/releases et téléchargez le .bin correspondant à votre matériel. Par exemple : WLED_0.16.0_ESP32.bin pour un ESP32 standard. Ne mélangez pas les builds entre familles de puces.
4. Lancer la mise à jour OTA. Dans WLED : Settings → Security & Updates → Manual OTA Update. Sélectionnez le fichier .bin téléchargé, puis cliquez sur "Update".
5. Attendre le redémarrage complet. L'ESP s'éteint, flashe, puis redémarre. L'opération dure 30 à 90 secondes selon la taille de la flash. Ne coupez pas l'alimentation pendant cette phase.
6. Vérifier le résultat. Reconnectez-vous à l'interface WLED. Vérifiez Settings → About pour confirmer la nouvelle version. Testez que vos segments, effets et presets fonctionnent correctement.
7. En cas de boot-loop. v16 détecte automatiquement les boucles après 3 cycles et passe en mode safe. Suivez les instructions de la section "Récupération d'un ESP en boot-loop" ci-dessous.

Si l'OTA est désactivée sur votre installation (Settings → Security → OTA locked) ou si l'ESP n'est pas accessible sur le réseau, utilisez le WLED Web Installer disponible sur install.wled.me — il gère le flash USB depuis un navigateur Chrome sans installation d'outil supplémentaire.

Breaking changes : ce qui peut casser dans votre configuration

La grande majorité des installations migrent sans accroc vers v16. Mais trois points méritent une vérification systématique.

Configuration des bus LED

Le nouveau bus manager utilise un format de configuration légèrement différent. Dans la plupart des cas, la migration est transparente. Mais si vous avez une configuration multi-bus complexe — plusieurs GPIO, types LED mixtes, segments indépendants — vérifiez vos assignations dans Config → LED Preferences après la mise à jour. Les sorties doivent correspondre à vos câblages physiques.

Format des presets JSON

Le format interne des presets a évolué entre v0.14 et v16. Les presets standard sont compatibles, mais si vous avez utilisé des fonctionnalités expérimentales ou des champs non documentés, certains presets peuvent ne pas se charger. Exportez vos presets avant migration (Settings → Presets → Export) et vérifiez après.

Usermods compilés

Si vous compilez WLED depuis les sources avec des usermods custom ou tiers, l'API a changé et les usermods v0.14 nécessitent une adaptation. Consultez la migration guide dans le wiki WLED GitHub (section "Usermod development") avant de recompiler. Pour les utilisateurs des builds officiels sans modification du code source, ce point ne s'applique pas.

WLED v16 et Home Assistant : ce qui change

L'intégration officielle WLED dans Home Assistant fonctionne après la migration, mais un point mérite attention : le changement de format de version (v16.0.0 au lieu de v0.16.0 attendu) a provoqué une erreur dans les versions de HA antérieures à la correction du bug. Si votre intégration WLED affiche une erreur après migration, vérifiez que votre Home Assistant est à jour — la correction est incluse dans les versions récentes. La découverte automatique via mDNS reste opérationnelle, et les entités exposées (light, select pour les effets et palettes) sont identiques à celles de v0.14.

Les apports indirects de v16 pour votre installation HA :

• Reconnexion plus rapide après coupure. Le WiFi fast connect réduit le temps pendant lequel WLED est indisponible dans HA après un redémarrage ou une micro-coupure secteur. Moins d'"entity unavailable" dans vos automations critiques.
• Moins de boot-loops, moins d'alertes. La boot-loop recovery automatique résout les incidents de configuration qui rendaient auparavant un ESP définitivement hors ligne jusqu'à intervention manuelle.
• Compatibilité MQTT inchangée. Si vous pilotez WLED via MQTT dans HA plutôt que par l'intégration native, le format des topics et des messages reste identique à v0.14.

Si vous utilisez une synchronisation WLED via Hyperion ou un bridge ambilight, vérifiez la compatibilité avec votre outil spécifique après migration — les APIs de synchronisation n'ont pas changé, mais les timings internes peuvent varier légèrement.

Récupération d'un ESP en boot-loop après mise à jour

Malgré la boot-loop recovery intégrée, certains scénarios — flash corrompu, coupure d'alimentation pendant l'OTA — peuvent nécessiter une intervention manuelle. Voici les trois méthodes par ordre de simplicité.

Méthode 1 : laisser faire la boot-loop recovery

Si l'ESP démarre et plante dans les 5 premières secondes, attendez 3 cycles complets. Après le 3e redémarrage rapide consécutif, v16 active le mode safe : l'ESP ouvre un point d'accès Wi-Fi nommé "WLED-AP" avec le mot de passe "wled1234". Connectez-vous, accédez à l'adresse 4.3.2.1, et corrigez la configuration depuis l'interface web.

Méthode 2 : WLED Web Installer

La méthode la plus accessible pour un reflash complet sans outil à installer. Rendez-vous sur install.wled.me depuis Chrome, connectez l'ESP en USB, sélectionnez votre modèle et lancez l'installation. L'outil gère automatiquement la détection du port série et le téléchargement du bon firmware.

Méthode 3 : esptool en ligne de commande

Pour les utilisateurs à l'aise avec le terminal. Téléchargez le .bin depuis les releases GitHub WLED, puis :

esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash 0x0 WLED_0.16.0_ESP32_merged.bin

Utilisez le binaire merged (suffixe _merged.bin) disponible dans les releases GitHub — il inclut le bootloader et se flashe à l'adresse 0x0. Adaptez le port (/dev/ttyUSB0 sur Linux, COM3 sur Windows). Cette méthode est la plus fiable en cas de flash très corrompu.

Faut-il migrer vers WLED v16 maintenant ?

La réponse directe : oui, si vous êtes sur une installation ESP32 avec une configuration standard.

Migrez maintenant si :

• Vous avez des instabilités récurrentes (déconnexions, freeze d'effets) sous v0.14 — v16 corrige plusieurs causes racines connues
• Vous utilisez un ESP32-S3 ou ESP32-C3 — le support est significativement amélioré dans v16
• Vous utilisez audioreactive — les corrections I2S de v16 sont substantielles
• Vous avez des micro-coupures secteur fréquentes — le WiFi fast connect réduit le temps de reprise

Prenez le temps de préparer si :

• Vous avez des usermods custom compilés — adaptez-les au nouveau framework avant de migrer
• Vous avez une configuration multi-bus complexe — testez sur un ESP de développement avant de toucher la production
• Votre installation pilote un événement dans les prochains jours — planifiez la migration en dehors des périodes critiques

Pour les installations ESP8266 stables, la migration est moins urgente. Si tout fonctionne, vous pouvez rester sur v0.14 encore quelques mois — mais le support ESP8266 sera progressivement réduit dans les versions futures. Planifiez la transition vers ESP32 dans votre prochain projet.

WLED v16 pose une base technique solide pour les années à venir. C'est le bon moment pour migrer et consolider vos installations avant que les prochaines évolutions de Home Assistant et des protocoles Matter ne viennent modifier les intégrations lumière.