Executando verificação de segurança...
37
lucasrguerra
3 min de leitura ·

ESPDocs: Criei a documentação para ESP32 que eu sempre quis ter (e talvez você também)

E aí, pessoal!

Se você, assim como eu, já passou horas pulando entre dezenas de abas, datasheets em inglês e fóruns obscuros para encontrar informações sobre o ESP32, este post é para você. Meu nome é Lucas, sou desenvolvedor e, cansado dessa bagunça, decidi criar a solução para uma dor que eu sentia quase todos os dias: a falta de uma documentação centralizada, interativa e, principalmente, em português para o ecossistema ESP32.

É com muito orgulho que eu apresento a vocês o ESPDocs: espdocs.cienciaembarcada.com.br

A Motivação: De Onde Veio a Ideia?

Da frustração que era começar um projeto novo e ter que garimpar informações básicas. Qual pino faz o quê? Qual a diferença real entre o ESP32-S2 e o S3? Qual placa tem os recursos que eu preciso e onde comprar de uma fonte confiável? As respostas estavam espalhadas, muitas vezes em PDFs de 800 páginas ou em documentações de frameworks que não conversavam entre si.

Decidi que, em vez de reclamar, eu iria construir. O objetivo era criar um lugar que servisse como "fonte da verdade" para quem desenvolve com ESP32 no Brasil.

O Que o ESPDocs Oferece Hoje?

O projeto é open source e está em constante evolução, mas já conta com recursos que, na minha opinião, mudam o jogo:

  1. Diagramas de Pinagem 100% Interativos

Este é o recurso que eu mais queria ter. Em vez de olhar para uma imagem estática, no ESPDocs você pode:

  • Filtrar por função: Quer ver todos os pinos ADC? Ou os pinos I2C? É só clicar e o diagrama mostra exatamente o que você precisa.

  • Buscar por nome ou pino: Digite "G23" ou "SPI" e veja o pino destacado na hora.

  • Ver detalhes ao passar o mouse: Informações rápidas sobre as funções de cada pino sem precisar sair da página.

Isso funciona para todas as principais séries do ESP32.

  1. Documentação Centralizada e em Português

Reuni e organizei as especificações técnicas das séries mais importantes:

  • ESP32 (o clássico)
  • ESP32-S2 e S3 (com foco em segurança e IA)
  • ESP32-C3, C5 e C6 (RISC-V, Wi-Fi 6, Matter)
  • E até os mais recentes como o ESP32-P4 e H2.

Tudo em português claro e direto, sem a necessidade de tradutores.

  1. Catálogo de Placas com Filtros Inteligentes

Cansado de cair em links duvidosos no AliExpress? Eu também. Por isso, criei um catálogo com placas de desenvolvimento e links verificados (muitos deles de lojas oficiais dos fabricantes).

O melhor são os filtros: você pode buscar placas por série (ex: só ESP32-S3), por conectividade (LoRa, GPS) ou por recursos (Display, Câmera, Bateria Interna). Isso economiza um tempo absurdo na hora de escolher o hardware.

  1. Guias de Frameworks

Seja você um iniciante no Arduino ou MicroPython, ou um usuário avançado do ESP-IDF, há uma área dedicada a explicar os principais frameworks. Também incluí os especializados, como:

  • ESP-ADF para projetos de áudio.
  • ESP-WHO para visão computacional.
  • ESP-NN para machine learning.
  • ESP-Matter para automação residencial.

Um Convite à Comunidade

O ESPDocs é um projeto feito de coração, de um desenvolvedor para a comunidade. Ele não tem afiliação com a Espressif, é totalmente independente e open source.

A minha ideia é que ele se torne uma ferramenta viva, que evolua com o feedback de vocês. Por isso, peço que acessem, usem à vontade e, se possível, me deem um retorno. O que está faltando? O que pode ser melhorado? Todo feedback é bem-vindo!

Obrigado por lerem até aqui e espero que o ESPDocs seja tão útil para vocês quanto está sendo para mim.

Abraços!

Carregando publicação patrocinada...
1
1
1
mbdd

Parabéns pelo trabalho!

Muito bom ver embedded devs fomentando e contribuindo com a comunidade, principalmente trazendo informação para o nosso BraSil! Com certeza vou usar bastante como fonte e consulta! :)

Obs: adiciona um "buy me a coffee" no rodapé do site! (;

1
1
1
elizandrob

Que trabalho incrível!

Hoje estou trabalhando mais com STM32, mas quando trabalhei com ESP foi um loucura. Você definitivamente tem um baita projeto ai. Chuta uma pedra e sai 50 features novas.

Isso se ficar só nos ESP (que provavelmente é o maior marketshare), mas tem diversos outros ambientes que podem ser atacados. ST, NXP, Microchip e outros, também tem essa carência.

Acho importante encontrar um meio de monetizar isso para ser sustentável. Até porque, espero um dia aposentar o site da Espressif e usar somente o seu.

Novamente, parabéns!

1
lucasrguerra
  • Autor
    Autor

Fico muito feliz com o feedback!

Teve uma equipe de robótica que também disse que gostaria dessa mesma plataforma para STM32. Infelizmente eu não tenho tanto domínio de STM qunaot eu tenho de ESP, mas eu adoraria também, pq é um microcontrolador muito utilizado no mercado e que eu também faço trabalhos pontuais com ele.

Sobre a monetização, eu admito que ainda estou pensando de forma mais fria e calculista pq eu não quero vender cursos e nem nada do tipo, quero deixar tudo de forma livre e open-source, mas realmente fica difícil equilibrar a balança às vezes, e quando eu começar a publicar os guias entao, aí é que vai complicar mesmo.

1
oprimodati

Fala chará, Guerra aqui tbm haha.

To entrando no mundo de embarcados e achei o projeto incrível!
Não cheguei a passar por essas dores ainda, mas só te ter um lugar pra consultar já é uma maravilha.

Como o colega falou, coloca um buy me a coffe no rodape e também coloca os link com afiliação, dessa forma você consegue monetizar seu projeto pra ajudar a manter.
Nada mais justo pelo trampo que você teve.

Sobre a UI, ta top, só achei essa cor purple com gradiente um pouco destoante kkkk

1
lucasrguerra
  • Autor
    Autor

Os links eu já consegui trocar para ter a parte de afiliação, mas o "buy me a coffe" eu ainda estou devendo, hahaha.

E eu realmente preciso melhorar essas cores da UI, mas é algo que eu vou ajustar nos próximos dias.

1
VictorReisDavid

Ano passado, fiz um trabalho do colégio (me formei no ensino médio técnico em ADS, no ano passado), e o trabalho que fiz com meu grupo foi um carrinho de controle remoto com Arduino, e eu sofri também para achar material sobre muita coisa, mesmo com Arduino. Já pensei em brincar com ESP32 mas realmente nunca achei quase nada sobre, essa doc poderia literalmente me salvar horas ano passado e vai salvar horas esse ano quando eu comprar um ESP32 pra brincar com IA kkkk

1
1
1
lucasrguerra
  • Autor
    Autor

Sim! Estou adicionando aos poucos, mas também vou criar uma seção de módulos, pq aí aumenta bastante o leque de possibilidades.

Mas sinceramente, o que eu mais quero criar agora é um guia realmente detalhado sobre como utilizar o ESP-IDF. Estou tentando conseguir o apoio técnico da própria Espressif pra essa missão.

1
guilhermegalanti

Vim correndo ler o post. Trabalho com ESP32 e uma das minha maiores dores é a documentação da fabricante.
Inclusive gostaria de sugerir uma organização das APIs deles de forma mais palatável. Poderíamos trazer exemplos de uso e explicações aprofundadas para ajudar novos usuários.

1
lucasrguerra
  • Autor
    Autor

Siiiim!!! Estou estruturando os guias de instalação e utilização do ESP-IDF, Arduino e MicroPython, pq aí eu vou poder detalhar bem direitinho não apenas como começar a programar, mas como utilizar cada um dos recursos das APIs deles.

0
1
1
lucasrguerra
  • Autor
    Autor

E tem, basta você selecionar a opção "Placa de Desenvolvimento", ao lado de "Diagrama de Conexões". Mas eu estou trabalhando em melhorias no Diagrama para ficar similar a esse tipo de imagem.

0