Capítulo 4 — Controle de LED pelo Celular
Controle de Fita LED Endereçável pelo Celular: Painel Wi-Fi com ESP32 e Presets de Cena Eyebrow: Capítulo 4 — A fita funciona. Agora ela vai obedecer ao seu dedo.
O que muda quando você adiciona Wi-Fi
Até aqui, cada mudança de efeito exigia recompilar o código e plugar o cabo USB. Isso funciona em bancada. Não funciona em casa — e definitivamente não funciona num produto.
O ESP32 resolve isso por R$ 35 a R$ 70. Ele é um microcontrolador com Wi-Fi e Bluetooth embutidos, roda o mesmo código que o Arduino, e tem capacidade de sobra para controlar centenas de LEDs enquanto serve uma página web ao mesmo tempo.
A arquitetura é simples: o ESP32 roda dois trabalhos em paralelo. Um cuida dos LEDs (o efeito, a animação, o brilho). O outro cuida da rede (receber comandos, servir a página de controle). Eles conversam por variáveis compartilhadas.
👉 A diferença prática: com ESP32 você muda cor, brilho e efeito pelo celular, sem tocar no código. E pode ter presets salvos — "Cinema", "Festa", "Leitura" — que mudam tudo com um toque.
O problema de sincronização (que aparece no segundo dia)
Antes do código, o erro que trava quase todo mundo.
Quando o ESP32 serve uma página web, ele bloqueia durante a resposta. Se você estiver rodando a animação no mesmo loop() que atende a rede, a animação congela a cada requisição — e o efeito "trava" na tela do celular.
Existem três soluções, em ordem de simplicidade:
Rodar a animação em outra tarefa (FreeRTOS). O ESP32 tem dois núcleos. Você fixa a animação no núcleo 0 e a rede no núcleo 1. É a solução profissional.
Usar millis() sem bloqueio. A animação roda normal, e o servidor web é verificado entre quadros. Funciona bem até efeitos muito pesados.
Separar por frequência. A animação roda a 30fps; a rede é verificada 5x por segundo. O olho não percebe a diferença.
Para este capítulo, vamos usar a segunda abordagem — é a mais simples e funciona em 95% dos projetos residenciais.
O código completo: ESP32 + painel web
Você vai precisar das bibliotecas FastLED e WebServer (já vem no pacote do ESP32 na Arduino IDE).
<code>
#include <WiFi.h>
#include <WebServer.h>
#include <FastLED.h>
#define PINO_DADOS 5
#define QTD_LEDS 60
const char* SSID = "SUA_REDE";
const char* SENHA = "SUA_SENHA";
CRGB leds[QTD_LEDS];
WebServer servidor(80);
// Estado global controlado pelo celular
uint8_t brilhoAtual = 80;
uint8_t matizAtual = 0;
uint8_t efeitoAtual = 0; // 0=sólido, 1=arco-íris, 2=fogo
unsigned long ultimoQuadro = 0;
void setup() {
Serial.begin(115200);
FastLED.addLeds<WS2812B, PINO_DADOS, GRB>(leds, QTD_LEDS);
FastLED.setBrightness(brilhoAtual);
WiFi.begin(SSID, SENHA);
while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(".");
}
Serial.println(WiFi.localIP()); // anote este IP
// Rota raiz: serve o painel de controle
servidor.on("/", []() {
String html = "<h1>Haztech LED</h1>";
html += "<p>Brilho: <input type='range' min='0' max='255' value='";
html += String(brilhoAtual);
html += "' oninput=\"fetch('/brilho?v='+this.value)\"></p>";
html += "<p><a href='/efeito?v=0'>Sólido</a> | ";
html += "<a href='/efeito?v=1'>Arco-íris</a> | ";
html += "<a href='/efeito?v=2'>Fogo</a></p>";
servidor.send(200, "text/html", html);
});
// Rota de brilho
servidor.on("/brilho", []() {
if (servidor.hasArg("v")) {
brilhoAtual = servidor.arg("v").toInt();
FastLED.setBrightness(brilhoAtual);
}
servidor.send(200, "text/plain", "ok");
});
// Rota de troca de efeito
servidor.on("/efeito", []() {
if (servidor.hasArg("v")) {
efeitoAtual = servidor.arg("v").toInt();
}
servidor.send(200, "text/plain", "ok");
});
servidor.begin();
}
void loop() {
servidor.handleClient(); // atende o celular sem bloquear
// Animação roda a 30fps, independente da rede
if (millis() - ultimoQuadro >= 33) {
ultimoQuadro = millis();
switch (efeitoAtual) {
case 0: // cor sólida
fill_solid(leds, QTD_LEDS, CHSV(matizAtual, 255, 255));
break;
case 1: // arco-íris animado
for (int i = 0; i < QTD_LEDS; i++) {
leds[i] = CHSV((i * 4 + millis() / 20) % 256, 255, 255);
}
break;
case 2: // fogo
for (int i = 0; i < QTD_LEDS; i++) {
leds[i] = HeatColor(inoise8(i * 40, millis() / 8));
}
break;
}
FastLED.show();
}
}
</code>
O que você deve ver: no Serial Monitor aparece o IP do ESP32 (algo como 192.168.1.47). Você digita esse IP no navegador do celular — na mesma rede Wi-Fi — e abre o painel. Deslizar o controle muda o brilho em tempo real. Clicar nos links troca o efeito.
⚠️ O detalhe que quebra o projeto: o ESP32 e o celular precisam estar na mesma rede. Se o celular estiver no 4G, não funciona. E se sua rede tiver "isolamento de clientes" ativado (comum em Wi-Fi de hotel), também não funciona.
Presets de cena: o que transforma projeto em produto
Um painel com slider é útil. Um painel com presets é o que as pessoas mostram para os amigos.
A lógica é simples: em vez de controlar brilho e cor separadamente, você define cenas nomeadas com valores fixos.
<code>
// Definição das cenas
struct Cena {
const char* nome;
uint8_t brilho;
uint8_t matiz;
uint8_t efeito;
};
Cena cenas[] = {
{"Cinema", 20, 200, 0}, // azul escuro, baixo brilho
{"Festa", 200, 0, 1}, // arco-íris forte
{"Leitura", 180, 40, 0}, // branco quente
{"Lareira", 120, 10, 2}, // fogo
{"Off", 0, 0, 0}
};
const int TOTAL_CENAS = 5;
void aplicarCena(int indice) {
if (indice < 0 || indice >= TOTAL_CENAS) return;
brilhoAtual = cenas[indice].brilho;
matizAtual = cenas[indice].matiz;
efeitoAtual = cenas[indice].efeito;
FastLED.setBrightness(brilhoAtual);
}
</code>
E a rota correspondente:
<code>
servidor.on("/cena", []() {
if (servidor.hasArg("v")) {
aplicarCena(servidor.arg("v").toInt());
}
servidor.send(200, "text/plain", "ok");
});
</code>
👉 Por que isso importa: você não está mais vendendo uma fita de LED. Está vendendo "modo cinema", "modo leitura", "modo lareira". A percepção de valor muda completamente — e a curva de aprendizado do usuário vai a zero.
Integrando com Alexa (sem escrever skill)
A integração mais simples não é programar para Alexa — é usar o WLED, um firmware pronto que já faz tudo isso.
O WLED roda em ESP32, controla fitas endereçáveis, tem app próprio, integração nativa com Alexa e Google Home, presets, sincronização entre múltiplos dispositivos e API HTTP. É open source e gratuito.
Você instala o WLED em vez do seu código, configura o Wi-Fi pelo celular em 2 minutos, e ganha tudo que este capítulo ensinou — mais integração com assistentes.
Quando usar cada caminho:
- Código próprio (este capítulo): você precisa de um efeito específico que não existe no WLED, ou quer controle total da lógica.
- WLED: você quer tudo pronto, com app, Alexa, presets e atualizações. É o caminho de 90% dos projetos.
- Híbrido: WLED como base, com efeitos customizados adicionados por código.
Os 3 erros do Capítulo 4
1. Colocar servidor.handleClient() depois do FastLED.show() em loop apertado. Se você chamar show() várias vezes por segundo sem dar tempo ao servidor, o celular não consegue conectar. Sempre intercale: atenda a rede, depois desenhe o quadro.
2. Usar delay() no loop() do ESP32. Isso derruba a conexão Wi-Fi. O ESP32 precisa de tempo de processamento contínuo para manter a rede. Use millis() sempre.
3. Esquecer que o ESP32 é 3,3V. Os pinos de dados do ESP32 operam em 3,3V, mas o WS2812B espera 5V no sinal. Na maioria das fitas funciona, mas em fitas longas ou com muito ruído pode falhar. A solução é um level shifter (74HCT245 ou similar) entre o ESP32 e a fita — assunto do Capítulo 5.
O que vem no Capítulo 5
Agora você tem controle, presets e integração. O próximo passo é o que separa um projeto de bancada de uma instalação real: fitas longas, matrizes e múltiplos controladores. No Capítulo 5 você vai montar uma matriz 8x8, controlar 4 fitas independentes em um único ESP32, e entender o level shifter de 3,3V para 5V — o problema que aparece exatamente quando você acha que já sabe tudo.
Resumindo
- ESP32 (R$ 35 a R$ 70) adiciona Wi-Fi e controle por celular sem abandonar o código Arduino.
- O erro central é bloquear a animação durante requisições web — use millis() e atenda a rede entre quadros.
- Presets de cena ("Cinema", "Leitura", "Lareira") aumentam a percepção de valor muito mais que sliders soltos.
- WLED é o atalho para quem quer app, Alexa e presets prontos; código próprio é para efeitos que não existem no WLED.
- ESP32 é 3,3V e o WS2812B espera 5V no sinal — em fitas longas, level shifter é obrigatório.