WS2812B avec ESP32 et WLED : câblage, alimentation et réglages

Ce qu’il vous faut

Valeurs de résistance et de condensateur comme dans le guide NeoPixel d’Adafruit et dans notre calculateur ; le seuil du signal de données d’après la datasheet Worldsemi du WS2812B.

WS2812B en 5 V ou WS2815 en 12 V ?

Le WS2815 met ses trois LED en série sous 12 V : à nombre de pixels égal, il tire beaucoup moins de courant. Pour 5 m à 60 LED par mètre, notre calculateur donne :

Notre calculateur d’alimentation pour ruban LED pour les deux rubans (version WS2815).

Dimensionner l’alimentation

Un pixel WS2812B tire jusqu’à environ 60 mA en plein blanc. Cinq mètres à 60 LED par mètre, cela fait 300 LED : 18 A en plein blanc, d’où une alimentation 5 V d’au moins 21,6 A avec 20 % de marge selon le calculateur. Pour les effets courants, qui tirent environ un tiers de ce courant, une alimentation de 7,2 A suffirait, mais le limiteur de luminosité de WLED doit alors maintenir le ruban sous cette valeur.

Votre ruban, sa longueur et sa densité : le calculateur donne l’alimentation, les points d’injection, le fusible et le câble de chacun, et la limite pour WLED.Ouvrir le calculateur de ruban LED

En 5 V, c’est la chute de tension le long du ruban qui fixe l’intervalle entre deux injections. Pour ce ruban, le calculateur prévoit 4 points d’injection espacés de 1,67 m, extrémités comprises, chacun fournissant jusqu’à 6 A. Chaque point a sa propre paire de fils depuis l’alimentation et son propre fusible de 7,5 A ; pour 2 m de câble avec 5 % de chute, le calculateur de section de câble donne 2,5 mm².

Le câblage

• Masse. Tout partage une seule masse : alimentation, ruban et contrôleur. Si le contrôleur a sa propre alimentation, reliez les deux masses. Sans masse commune, le signal de données n’a pas de référence et le ruban scintille.
• Données. GPIO → adaptateur de niveau (VCC en 5 V) → résistance → DIN de la première LED. Gardez court le fil entre le contrôleur et la première LED, et placez la résistance côté ruban. Suivez les flèches imprimées sur le ruban : les données ne circulent que dans un sens.
• Alimentation. Une paire de fils par point, tirée directement depuis l’alimentation et protégée par son propre fusible, plutôt qu’un seul câble qui court le long du ruban.
• Condensateur. Entre + et − là où l’alimentation entre d’abord dans le ruban, en respectant la polarité.
• Ordre. Branchez d’abord la masse, puis l’alimentation, puis les données, et mettez les LED sous tension avant le contrôleur.

Le WS2815 se câble de la même façon, en 12 V. Avec un WS2815B-V1, le signal de données en 3,3 V de l’ESP32 fonctionne en général directement : on peut souvent se passer de l’adaptateur de niveau ; ajoutez-le si les premières LED scintillent ou affichent de mauvaises couleurs. Le contrôleur a alors besoin de son propre 5 V, fourni par un petit convertisseur 12 V vers 5 V, car la broche 5 V d’une carte de développement n’accepte que du 5 V.

Sécurité

• Les alimentations secteur dans un boîtier. Les alimentations ouvertes pour LED ont les bornes du secteur à nu. Montez-les dans un boîtier fermé, avec un serre-câble sur chaque câble et la terre raccordée, et confiez le raccordement au secteur à une personne qualifiée lorsque la réglementation l’exige.
• Un fusible par branche. Choisissez chaque fusible d’après son câble, comme le fait le calculateur, pour qu’un court-circuit au bout du ruban le fasse aussi fondre.
• Une seule alimentation à la fois pour la carte. Sur le schéma, l’ESP32 prend son 5 V sur l’alimentation du ruban par sa broche 5 V. Le guide d’Espressif pour la DevKitC indique que la carte doit être alimentée par une seule source, sinon la carte ou la source peuvent être endommagées. Flashez WLED et faites la première configuration par USB avant de brancher ce fil 5 V, puis débranchez-le chaque fois que vous rebranchez l’USB ; le fil de masse peut rester branché.
• Ne jamais alimenter le ruban à travers la carte. La broche 5 V d’une carte de développement fait passer le courant de l’USB par des pistes fines ; la documentation de WLED elle-même conseille de garder la limite sous 1 A si les LED s’alimentent par là. Alimentez le ruban directement depuis l’alimentation.
• Chaleur. En plein blanc, les rubans chauffent : sur de grandes longueurs, posez-les sur un profilé en aluminium et vérifiez que l’alimentation est ventilée.

Installer WLED

Ouvrez l’installeur web sur install.wled.me dans un navigateur compatible Web Serial : Chrome, Edge, Opera sur ordinateur, ou Firefox à partir de la version 151. Safari et les navigateurs mobiles ne fonctionnent pas. Branchez la carte avec un câble USB de données, choisissez la version (la 16.0.1, sortie en juillet 2026, est la dernière stable), cliquez sur Install et sélectionnez le port série de la carte. Faites-le sans le fil 5 V qui relie la carte à l’alimentation du ruban : une seule alimentation à la fois.

• Aucun port dans la liste ? Essayez un autre câble, puis installez le pilote de la puce USB de la carte : CH34x (WCH) ou CP210x.
• Toujours rien ? Maintenez le bouton BOOT de la carte enfoncé pendant que vous la branchez.
• Après le flashage, l’installeur peut proposer de configurer le Wi-Fi tout de suite. Sinon, passez par le point d’accès décrit ci-dessous.

Les mises à jour suivantes se passent de câble : Config → Security & Updates accepte un nouveau firmware par Wi-Fi. Sauvegardez d’abord la configuration et les préréglages depuis la même page.

Première configuration

1. Sans Wi-Fi configuré, WLED ouvre un point d’accès nommé WLED-AP. Connectez-vous avec le mot de passe wled1234.
2. Ouvrez 4.3.2.1 dans le navigateur si la page de configuration ne s’affiche pas d’elle-même.
3. Cliquez sur WiFi settings, lancez la recherche ou tapez le nom de votre réseau, puis saisissez son mot de passe. Le réseau doit être en 2,4 GHz.
4. Donnez-lui un nom mDNS, par exemple bureau, pour le retrouver ensuite sur bureau.local, et changez le mot de passe du point d’accès, wled1234 par défaut.
5. Cliquez sur Save & Connect. WLED rejoint votre réseau ; vous le retrouvez par son nom mDNS ou dans l’interface de votre box.

Les réglages des LED

Ouvrez Config → LED & Hardware avant toute chose : WLED ne connaît pas votre ruban tant que vous ne le lui décrivez pas.

• Type : WS281x, pour un WS2812B comme pour un WS2815.
• GPIO : la broche de données, voir le tableau ci-dessous ; Config → Pin Info liste toutes les broches et ce qui les utilise.
• Length : le nombre de LED, 300 dans notre exemple.
• Color Order : GRB, la valeur par défaut, pour la plupart des rubans WS2812B. Si le rouge s’affiche en vert, essayez les autres.
• Limiteur automatique de luminosité : laissez-le actif. Dans Maximum PSU Current, mettez la valeur que donne notre calculateur d’alimentation pour ruban LED : 18 000 mA pour l’alimentation dimensionnée pour le plein blanc de notre exemple, ou 6 000 mA pour une alimentation dimensionnée pour les effets courants ; WLED accepte de 250 à 65 000 mA. Réglez aussi mA/LED comme l’indique le calculateur : Custom à 60 mA pour un WS2812B, ou l’option « 12mA (WS2815) ».
• Les segments découpent le ruban en parties avec leur propre effet et leur propre couleur ; les préréglages (presets) enregistrent une ambiance, et Apply preset at boot choisit celui à appliquer au démarrage.

Broches de strapping et broches réservées d’après nos pages de brochage de l’ESP32, de l’ESP32-C3 SuperMini, de l’ESP32-S3 et de la D1 mini ; broches de l’ESP8266 d’après la documentation de WLED.

Home Assistant

Home Assistant découvre généralement WLED sur le réseau : il apparaît dans Paramètres → Appareils et services, parmi les Découverts. Sinon, cliquez sur Ajouter une intégration, choisissez WLED et saisissez le nom d’hôte ou l’adresse IP. L’intégration nécessite WLED 0.14 ou une version plus récente.

Vous obtenez une entité lumière pour le ruban ; avec deux segments ou plus, une par segment plus une lumière principale pour l’allumage et la luminosité globale. S’y ajoutent des entités de sélection pour les préréglages, les playlists et les palettes, des entités numériques pour la vitesse et l’intensité des effets, et une entité de mise à jour du firmware qui propose les versions stables de WLED.

Dépannage

La teinte rose ou orange au bout du ruban est le signe classique d’un manque de points d’injection.