WLED Réglages Préférences LED Alimentation WLED Max Guide pratique

Les réglages WLED expliqués : courant maximal, sorties LED, synchronisation et sécurité depuis votre téléphone

Ce que font les réglages WLED importants, avec de vrais chiffres : courant maximal par LED, sorties LED et GPIO, interfaces de synchronisation et verrou OTA.

Par Publié le Mis à jour le

Un ruban neuf de 300 LED qui paraît étrangement faible n’est en général pas défectueux. Le limiteur de luminosité de WLED démarre à 850 mA, à peu près ce que fournit un chargeur de téléphone, donc il baisse tout pour rester en dessous. Beaucoup de « bugs » WLED sont de ce genre : un réglage qui fait son travail avec un chiffre que personne n’a changé.

Tous les réglages ci-dessous se trouvent dans l’interface web WLED, et le tableau indique où se trouve la même chose dans WLED Max.

D’abord le symptôme

Ce que vous voyezCause habituelle
Ruban faible, ou blanc maximal peu lumineuxCourant maximal trop bas pour votre alimentation
Seules les premières LED s’allumentNombre de LED trop bas, ou mauvais GPIO de données
Rouge et vert inversésOrdre des couleurs
Le blanc maximal vire à l’orange au bout du rubanchute de tension (injectez du courant ; un courant maximal plus bas la masque)
La lumière redémarre en blanc maximalalimentation surchargée, baissez le courant maximal
Scintillement aléatoire plus loin sur le rubansignal de données ou masse, pas un réglage

Ce dernier point piège beaucoup de monde. Ajoutez une masse commune, raccourcissez le premier fil de données ou utilisez un convertisseur de niveau. Aucune case à cocher ne règle cela.

Où se trouve chaque réglage

Interface web WLED (Config)Réglages de l’appareil dans WLED MaxContenu
WiFi & Network (WiFi Setup sous 0.14 et 0.15)Configuration Wi-Firéseau, IP fixe, point d’accès
LED & Hardware (LED Preferences sous 0.14 et 0.15)Préférences LEDsorties, type de LED, nombre, GPIO, limite de courant, ordre des couleurs, valeurs au démarrage, valeurs de la veilleuse
2D ConfigurationConfiguration 2Dpanneaux de matrice, disposition
User InterfaceInterface utilisateurdescription du serveur (Device Name sous WLED 16). Dans WLED Max, cette section contient aussi le nom Alexa, les boutons, la télécommande IR et le relais, que l’interface web range sous Sync Interfaces et LED & Hardware
Sync InterfacesInterfaces de synchronisationsynchronisation UDP, Alexa, MQTT, E1.31/DMX/Art-Net, Philips Hue, Serial/Adalight
Time & MacrosHeure et macros, ProgrammationsNTP, fuseau horaire, position, minuteurs
UsermodsModules utilisateurextensions comme AudioReactive
Security & UpdatesSécurité et mises à jourverrou OTA, phrase secrète, redémarrage (les sauvegardes sont sur cette page web ; dans l’app, elles sont sous Sauvegarde et restauration)

Dans WLED Max, ouvrez une lumière, touchez le menu et choisissez Réglages de l’appareil. Le haut de l’écran affiche les informations de l’appareil : IP, firmware, adresse MAC, nombre de LED et nom mDNS, ainsi que Ouvrir l’interface web. Quelques fonctions ne sont disponibles que sur le web, dont la réinitialisation d’usine et certaines options avancées, et l’app vous le signale quand vous tombez sur l’une d’elles.

Interface web WLED
Menu des réglages de WLED 16 avec les boutons Back, WiFi and Network, LED and Hardware, Pin Info, 2D Configuration, User Interface, Sync Interfaces, Time and Macros, Usermods
Le menu Config sous WLED 16.0.1. Sous 0.14 et 0.15, les deux premiers boutons s'appellent WiFi Setup et LED Preferences.
iOS
Liste Réglages de l'appareil de WLED Max : Configuration Wi-Fi, Préférences LED, Configuration 2D, Interface utilisateur, Interfaces de synchronisation, Programmations, Heure et macros, Modules utilisateur, Sécurité et mises à jour, puis Infos sur l'appareil avec l'adresse IP
Réglages de l'appareil dans WLED Max, avec les mêmes sections.

Courant maximal et courant par LED

Le limiteur automatique de luminosité (ABL) estime le courant consommé par les LED et baisse la luminosité pour que le total reste sous votre limite. Il a besoin de deux chiffres.

Courant maximal (mA) correspond à ce que votre alimentation peut fournir, moins une marge. Une alimentation 5 V 10 A fait 10 000 mA, réglez donc environ 8 500 pour laisser de la place au contrôleur et aux pertes.

Courant par LED (mA) correspond à ce que consomme une LED en blanc maximal. WLED propose des valeurs toutes faites : 55 mA (WS281x 5 V typique), 35 mA (WS2812 éco), 30 mA (12 V typique), 12 mA (WS2815) et 15 mA (pixels type guirlande fée ou « seed »). Vous pouvez aussi saisir votre propre valeur.

Exemple chiffré. 300 LED WS2812B à 55 mA pourraient tirer 16,5 A en blanc maximal. Avec une alimentation de 10 A et Courant maximal à 8 500 mA, WLED limite le blanc maximal à environ la moitié de la luminosité. Les couleurs consomment moins, elles peuvent donc être plus lumineuses. C’est le limiteur qui fonctionne, pas une panne. Ne réglez pas le courant maximal au-dessus de ce que l’alimentation et le câblage supportent. Sur les rubans 5 V, injectez du courant toutes les 100 à 150 LED et mettez un fusible sur chaque tronçon. Vous prévoyez tout un bord de toit ? Le guide de l’alimentation en extérieur et des bords de toit calcule l’alimentation, les points d’injection et la section de câble.

Dans WLED Max, les deux champs sont sous Préférences LED > Alimentation et performances. FPS cible s’y trouve aussi. 42 convient à la plupart des rubans, et monter plus haut n’a d’intérêt que sur de courts tronçons.

Interface web WLED
Page de configuration LED de WLED : Enable automatic brightness limiter coché, Maximum PSU Current 850 mA, et une note recommandant une alimentation de 16 A pour 283 LED en blanc maximal
Le limiteur dans l'interface web. 850 mA est la valeur par défaut.
iOS
Préférences LED de WLED Max, faites défiler jusqu'à Alimentation et performances : Courant maximal 850 mA, Courant par LED 55 mA, FPS cible, puis les réglages de transition et de gamma
Courant maximal et Courant par LED dans WLED Max.

Sorties LED et GPIO

Une sortie est une ligne de données entre le contrôleur et un ruban. Pour chacune, vous réglez :

  • Type de LED (WS281x, SK6812 RGBW, APA102, etc.)
  • GPIO de données, plus GPIO d’horloge pour les rubans à 4 fils
  • Début et Longueur (le nombre de LED sur cette sortie)
  • Ordre des couleurs (GRB est l’ordre habituel pour le WS2812B)
  • Inversé et Ignorer les premières LED (pour un premier pixel sacrifié qui sert de convertisseur de niveau)
Interface web WLED
Bloc des sorties LED de WLED : sortie 1 de type SK6812/WS2814 RGBW, 55 mA par LED, ordre des couleurs GRB, start 0, length 283, data GPIO 16, Reversed, Skip first LEDs 0, Auto-calculate W channel réglé sur Brighter
Une sortie dans l'interface web.
iOS
Préférences LED de WLED Max : Type de LED SK6812/WS2814 RGBW, Ordre des couleurs GRB, Inverser Aucun, Nombre de LED 283, Broche GPIO 16, Inversé, Ignorer les premières LED 0, Rafraîchir à l'arrêt, Blanc automatique Plus lumineux, et un bouton Ajouter une sortie
La même sortie dans WLED Max, avec Ajouter une sortie en dessous.

Un deuxième ruban sur une autre broche demande une deuxième sortie. L’interface web a un bouton « + » sous LED & Hardware. WLED Max y propose Ajouter une sortie et Supprimer la sortie, et vérifie d’abord les limites annoncées par votre firmware : nombre de sorties, GPIO libres, mémoire LED restante. S’il ne peut pas en ajouter, il vous dit pourquoi. C’est surtout important sur ESP8266, qui gère bien moins de LED et de sorties qu’un ESP32.

Dans l’interface web, WLED applique les nouveaux réglages de sortie dès l’enregistrement. WLED Max vous demande de toucher Enregistrer et redémarrer, et la lumière redémarre avec les nouveaux réglages matériels.

Sync Interfaces

La synchronisation UDP (WLED Sync) garde plusieurs lumières WLED sur le même effet. Send sur l’une, Receive sur les autres. Contrôler plusieurs appareils WLED va plus loin.

Receive UDP realtime permet à des outils de piloter directement les pixels pendant un moment : Hyperion, xLights, un script Home Assistant, ou les alertes lumineuses de WLED Max. Laissez-le activé, sauf si quelque chose détourne sans cesse la lumière. Dans ce cas, WLED Max le signale dans l’onglet Contrôle avec un bouton Prendre le contrôle, et WLED bloqué en mode temps réel explique la suite.

iOS
Interfaces de synchronisation de WLED Max : Synchro UDP : envoi avec Activer l'envoi désactivé, Synchro UDP : réception avec la luminosité, la couleur, les effets et les données des segments activés, ports UDP, Alexa et MQTT
Envoi et réception de la synchronisation UDP.
iOS
Interfaces de synchronisation de WLED Max, faites défiler jusqu'à E1.31, DMX et Art-Net : activé, Mode DMX Multi RGB, port 5568, univers de départ 1, délai 25, Forcer la luminosité max. activé
E1.31, DMX et Art-Net plus bas.

E1.31, Art-Net, DDP servent aux logiciels d’éclairage et aux spectacles. L’univers et l’adresse de départ se règlent ici. MQTT et Alexa couvrent la domotique en dehors de l’intégration propre à Home Assistant.

Security & Updates

Le verrou OTA (interface web : « Lock wireless (OTA) software update » ; app : Verrouiller les mises à jour OTA) bloque l’envoi de firmware, et seule votre phrase secrète permet de le désactiver. Verrouiller les réglages Wi-Fi protège les réglages réseau de la même manière. Utile dans une colocation ou un commerce. ArduinoOTA, la restriction des mises à jour au même sous-réseau et Redémarrer se trouvent aussi ici, ainsi que Déverrouiller et redémarrer dans l’app. La mise à jour elle-même est expliquée dans mise à jour OTA de WLED sur ESP8266 et ESP02.

iOS
Sécurité et mises à jour de WLED Max : Verrouiller les mises à jour OTA et Verrouiller les réglages Wi-Fi désactivés, Activer ArduinoOTA et Limiter l'OTA au même sous-réseau activés, phrase secrète OTA définie, Enregistrer les réglages de sécurité, Actions sur l'appareil
Sécurité et mises à jour dans WLED Max.

Les lumières dont l’app ne modifie pas les réglages

Depuis la version 1.1.4, WLED Max ne modifie pas les réglages d’une lumière ESP32 qui a des broches I2C configurées, ou dont il ne peut pas lire ces broches. Ce sont en général des builds avec des capteurs, des écrans ou des cartes audio, et un changement de réglage depuis l’app pourrait perturber cette installation. Vous verrez « Cette lumière utilise du matériel supplémentaire, modifiez donc ce réglage sur la page de réglages de la lumière. » avec l’adresse de la lumière à ouvrir dans un navigateur. Si les réglages de la lumière sont verrouillés par un code PIN, l’app le signale, vous demande de les déverrouiller d’abord dans l’interface web WLED, et ne change rien.

Attention

Un changement dans la section Configuration Wi-Fi peut faire passer la lumière à une nouvelle adresse, ou la sortir de votre réseau. Faites d'abord une sauvegarde.

Un dernier point qui surprend souvent : un changement dans la section Configuration Wi-Fi (IP fixe, autre réseau) peut déplacer la lumière. Si elle disparaît après l’enregistrement, vérifiez la liste des clients du routeur, ou attendez que le point d’accès WLED-AP apparaisse. Et sauvegardez la configuration avant les gros changements.