> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# WLED

> Controle faixas de LED WLED (RGB e RGBW) direto do Portal

# WLED

A integração WLED conecta **controladores WLED** — o firmware open-source popular para faixas de LED endereçáveis (RGB, RGBW) — ao Portal via **API JSON HTTP** na rede local.

## Pre-requisitos

* Dispositivo com firmware **WLED** instalado (ESP8266/ESP32)
* Endereço IP local do controlador
* Porta HTTP (padrão `80`)

## Configurar

<Steps>
  <Step title="Coloque o WLED na rede">
    Use o processo padrão do firmware para conectar o dispositivo ao seu WiFi.
  </Step>

  <Step title="Adicione a integração">
    Va em **Configurações → Integrações → Adicionar → WLED**.
  </Step>

  <Step title="Informe host e porta">
    O probe retorna estado atual, versão do firmware, `mac` e nome do produto.
  </Step>
</Steps>

## Recursos

* **`light`** — uma entidade por dispositivo, com controle de **liga/desliga**, **brilho** e **cor**
* Atributos expostos: `brightness`, `version`, `mac`

## Como Funciona

A reconfiguração é guardada pelo **MAC address** do dispositivo (com fallback para `host:port`). Trocar o IP mantém a mesma entrada e as automações continuam funcionando.

<Info>
  Reserve o IP no roteador — o firmware WLED nem sempre lida bem com trocas de DHCP.
</Info>