Lembra do ESPDocs? Ele evoluiu e agora tem seletor interativo, guia de diagnóstico de falhas e muito mais!

E aí, pessoal!

Há cerca de 10 meses, fiz uma publicação aqui no TabNews apresentando a primeira versão do ESPDocs, um projeto open source que criei para resolver uma dor diária: acabar com a necessidade de abrir 20 abas de datasheets de 800 páginas e fóruns soltos para conseguir informações confiáveis sobre o ESP32 em português. A recepção da comunidade, em especial a daqui do TabNews, foi incrível e os feedbacks que recebi me motivaram a continuar construindo!

Nas últimas semanas e meses, o ESPDocs passou por uma grande evolução. Deixou de ser apenas um visualizador de pinagem e catálogo de placas para se tornar uma suíte completa de apoio ao desenvolvimento de firmware e hardware. Se você desenvolve com ESP32 (seja no ESP-IDF, Arduino, Rust ou MicroPython), aqui estão as principais novidades que acabaram de chegar:

1. 🧠 Seletor Inteligente de ESP32 (Quiz Interativo)

Escolher o microcontrolador certo hoje em dia é um desafio: a Espressif já conta com mais de uma dezena de variantes (ESP32 clássico, S2, S3, C2, C3, C5, C6, C61, H2, H4, P4...).
Para resolver isso, criei o Seletor Inteligente (/seletor):

Você responde um quiz rápido sobre os requisitos do seu projeto (Wi-Fi 6, Bluetooth Mesh, Thread/Zigbee, display MIPI/RGB, câmeras, aceleração de IA/Edge Computing, ultra-baixo consumo ou foco em custo).
O algoritmo analisa as restrições e entrega uma recomendação técnica detalhada do SoC ideal, com justificativa dos pontos fortes e alternativas.

2. 🛠️ Central Interativa de Diagnóstico de Falhas

Quem nunca tomou um Guru Meditation Error, um Brownout detector was triggered ou caiu num Watchdog Reset loop sem entender o motivo?
Criamos uma área dedicada ao Diagnóstico de Falhas (/diagnostico) com mais de 30 guias passo a passo:

Brownouts e Alimentação: Causas reais na subida do Wi-Fi e cálculos de desacoplamento.
Erros de Memória & Stack: Heap fragmentation, LoadStoreAlignment e Stack Overflow.
Bootloops & Flash: Erros de strapping pins, cabeçalho de partições corrompido e modo de SPI Flash.
Comandos diretos de depuração tanto para ESP-IDF quanto para Arduino Core.

3. 📦 ESP Component Registry & Gerador de `idf_component.yml`

No ecossistema moderno do ESP-IDF (v5+), o gerenciamento modular de dependências é o padrão através do IDF Component Manager.
Na aba Componentes (/componentes), reunimos uma curadoria dos pacotes e drivers mais utilizados (LVGL, ESP-RainMaker, ESP-SR para voz offline, drivers de display ST7789/ILI9341, codecs de áudio ES8388, sensores etc.):

Você pode copiar os comandos de instalação direta (idf.py add-dependency).
A ferramenta gera automaticamente o snippet do arquivo de manifesto idf_component.yml pronto para colar no seu projeto.

4. ⚖️ Comparador de Séries Lado a Lado

Precisa saber se compensa migrar do ESP32-S3 para o novo ESP32-P4, ou entender a diferença entre o ESP32-C3 e o ESP32-C6?
No Comparador de Séries (/comparacao), você seleciona até 4 chips e compara frente a frente:

Arquitetura (Xtensa LX6/LX7 vs RISC-V de 32 bits).
Frequência de clock, SRAM interna e limites de PSRAM externa.
Suporte a protocolos de rádio (Wi-Fi 4 / Wi-Fi 6 dual-band, BLE 5.4, 802.15.4).
Aceleradores criptográficos de hardware, Secure Boot e Flash Encryption.

5. ⚠️ Alertas de Restrições de Pinos nos Diagramas Interativos

Os diagramas de pinagem agora contam com avisos contextuais para evitar os erros clássicos de hardware que queimam horas de bancada:

🔴 Strapping Pins: Destaque para pinos que definem o modo de boot ou tensão de flash (ex: GPIO0, GPIO2, GPIO12) e que não devem receber pull-down/pull-up indevido.
🟡 Pinos Input-Only: Alerta claro para GPIOs 34 a 39 (que não têm resistores internos de pull-up/down e não funcionam como saída).
🔵 Conflito ADC2 + Wi-Fi: Indicação dos pinos analógicos que deixam de funcionar quando o rádio Wi-Fi é ligado.
🟣 Pinos SPI Flash/PSRAM Integrada: Marcação dos pinos internos que não devem ser conectados na placa externa.

6. 🚀 Cobertura dos Novos Chips e 14 Frameworks

A documentação agora cobre 12 séries, incluindo os anúncios mais recentes da Espressif como ESP32-H4, ESP32-C61 e o poderoso ESP32-P4 (com núcleos duplos RISC-V a 400 MHz, interfaces MIPI-CSI/DSI e encoder de hardware).
Além disso, a seção de Frameworks & SDKs expandiu para 14 tecnologias, incluindo guias para:

ESP-Matter e ESP-RainMaker (nuvem IoT pronta da Espressif).
Rust on ESP (esp-rs para bare-metal e std).
ESP-SR (reconhecimento de voz offline sem necessidade de nuvem).

7. 🌙 Dark Mode, Glossário Técnico e Acessibilidade

Modo Escuro nativo: Para quem passa horas programando à noite (como é o meu caso, hahaha).
Glossário com 60+ conceitos: Entenda termos como eFuses, Partições NVS, OTA Rollback, ULP Coprocessor e TWAI/CAN.

🌐 Onde Acessar

O projeto continua 100% gratuito, open source e independente:

👉 Acesse: espdocs.cienciaembarcada.com.br
👉 Código Fonte / GitHub: https://github.com/lucasrguerra/ESPDocs

Gostaria muito de ouvir o feedback de vocês: o que mais vocês sentem falta no dia a dia com ESP32 que facilitaria a vida de vocês?

Um abraço e boas compilações!