esp32pin.com es una referencia interactiva gratuita de pinout para la familia ESP32. Cada pin conlleva sus restricciones del mundo real; los datos se generan a partir de las librerías oficiales de KiCad de Espressif y se validan de forma cruzada con el conjunto de datos de esp-gpio-tool. Además, es posible proponer nuevas placas de desarrollo directamente desde el navegador.
¿Por qué falló el Wi-Fi en mis lecturas analógicas?
El diseño de PCBs alrededor de módulos ESP32 conlleva desafíos complejos. En un proyecto, un sensor conectado a un pin ADC ofreció lecturas limpias durante toda la fase de prototipado. Sin embargo, al fabricar la PCB real y cargar el firmware completo, las lecturas se volvieron erróneas. Inicialmente, la culpa se atribuyó al diseño, a las soldaduras o al sensor mismo. La causa real: esa versión fue la primera en activar el Wi-Fi, y en el ESP32 clásico, el controlador de Wi-Fi toma el control del ADC2, donde residía precisamente el sensor. La idea de que el Wi-Fi y las entradas analógicas pudieran estar interconectadas era totalmente ajena al diseño original.
Y el ADC2 no es la trampa más costosa. Enrutar un periférico hacia un pin de strapping puede provocar que la placa inicie en un modo de arranque incorrecto, un error que generalmente surge una vez que las PCBs ya han sido fabricadas. La información necesaria para prevenir estos problemas existe, pero está dispersa entre hojas de datos, manuales de referencia técnica, documentación de modos de arranque e hilos de foros técnicos acumulados durante años. Un diagrama de pinout tradicional responde a la parte sencilla: dónde están los pines. La parte difícil, que cuesta dinero cuando se comete un error, es determinar qué pines se pueden utilizar realmente y bajo qué condiciones de funcionamiento.
Se creó esp32pin.com para responder a ambas partes simultáneamente. Es una referencia de pinout interactiva, gratuita y de código abierto para la familia ESP32, donde cada pin integra sus restricciones específicas.
¿Qué información ofrece cada pin sobre sí mismo?
Al hacer clic en cualquier pin del diagrama o de la tabla, se obtiene una visión completa:
- Pines de strapping: indican qué se muestrea en el reinicio y qué niveles no deben alterarse. GPIO0, GPIO12 y otros están marcados en el diagrama, permitiendo visualizar la advertencia antes de realizar el cableado, no después.
- Pines ADC2: en el ESP32 clásico, advierten que dejan de funcionar en cuanto el Wi-Fi se activa, sugiriendo alternativas en el ADC1.
- Pines de Flash: (GPIO6-11 en módulos ESP32) se marcan como no utilizables, explicando la razón técnica.
- Pines de solo entrada: (GPIO34-39 en el ESP32, GPIO46 en el ESP32-S2) no pueden controlar LEDs, y el sitio lo especifica claramente.
- Pines USB y JTAG: advierten antes de ser reutilizados para evitar la pérdida de la conexión de depuración.
La imagen superior muestra la vista detallada del módulo ESP32-S3-WROOM-1, donde se observan las restricciones específicas por pin, permitiendo a los ingenieros identificar posibles conflictos antes de la etapa de diseño de la PCB.
Los filtros permiten responder preguntas prácticas directamente: mostrar pines seguros para salida, seguros para ADC mientras el Wi-Fi está en funcionamiento o completamente libres de restricciones. También existe una vista esquemática construida a partir de los símbolos oficiales de KiCad de Espressif, junto con una opción de exportación para tablas de mapeo de pines.
La vista esquemática, ilustrada en la figura anterior, permite visualizar los símbolos oficiales de Espressif renderizados como una hoja de estilo EDA, manteniendo las mismas advertencias críticas inline para facilitar el flujo de trabajo del hardware.
¿De dónde provienen los datos?
Los datos de los pines solo son útiles si son confiables, por lo que el sitio no contiene ninguna tabla escrita manualmente. Todo el conjunto de datos se genera mediante scripts a partir de dos fuentes de Espressif:
- Las librerías oficiales de KiCad: los nombres de los pines, las posiciones físicas de los pads y los símbolos esquemáticos provienen directamente de los mismos archivos que Espressif publica para diseñadores de hardware.
- El conjunto de datos de esp-gpio-tool: las funciones alternativas por GPIO, flags del dominio RTC y roles de strapping se fusionan a partir de los datos YAML de la propia herramienta de validación GPIO de Espressif.
Ambas fuentes se verifican mutuamente. El conjunto de pruebas valida todo el catálogo contra los datos de esp-gpio-tool en cada compilación, por lo que el sitio no puede desviarse silenciosamente de lo que publica Espressif. Esta verificación cruzada incluso permitió detectar que los datos de esp-gpio-tool omitían el flag de "solo entrada" en el GPIO46 del ESP32-S2, el cual, según la hoja de datos, no posee controlador de salida. Esa corrección ya es un pull request aceptado.
Placas de desarrollo sin escribir código
Los chips son solo la mitad de la historia. La mayoría de los usuarios utilizan una placa de desarrollo y estas reasignan todo: la serigrafía indica D7, el código requiere GPIO10 y el mapeo cambia en cada placa.
Para las placas, el sitio muestra primero la etiqueta de la serigrafía, oculta los pines que no están disponibles y hereda automáticamente todos los hechos eléctricos del chip base. Añadir una placa no requiere KiCad ni código: existe un constructor de placas que se ejecuta en el navegador. Se selecciona el chip base, se hace clic en los GPIOs en el orden del header y se añaden las particularidades de la placa, generando un pequeño archivo JSON que se convierte en un pull request. Cada placa enviada se verifica contra el esquema del fabricante antes de fusionarse, garantizando que la referencia sea confiable.
El catálogo cubre actualmente las familias ESP32, ESP32-S, ESP32-C y ESP32-H, los DevKits comunes de Espressif y un conjunto creciente de placas comunitarias de Seeed, Waveshare y otros.
Construido para contribuir
El sitio tiene licencia MIT, toda la canalización de datos es pública y cualquier usuario puede mejorarla sin una gran inversión de tiempo:
- ¿Detectaste un error? Cada página tiene un botón "Reportar error" que abre un issue de GitHub prellenado con el chip y el pin consultado. Al añadir una sección de hoja de datos o un enlace esquemático, la corrección suele fusionarse en un día.
- ¿Falta tu placa? El constructor de placas toma unos diez minutos y no requiere herramientas adicionales. Si puedes leer la serigrafía, puedes añadir tu placa.
- ¿Aprendiste una lección por las malas? Las advertencias más valiosas del sitio comenzaron como problemas en hardware real: un pin de arranque mal configurado, un LED que bloqueaba el modo de descarga o un sensor en ADC2 que fallaba con Wi-Fi. Abre un issue y describe lo sucedido; convertirlo en una advertencia por pin es el objetivo.
- ¿Fabricas placas? Si tu placa se envía con archivos KiCad o un PDF esquemático, ese es el material bruto que consume la canalización. Enlázalos en un issue y la placa se añadirá con calidad de fabricante.
- ¿Prefieres el software? El sitio tiene espacio para crecer: mejoras en la interfaz, accesibilidad, mejores exportaciones y nuevas vistas. Si algo molesta o existe una mejor forma de hacerlo, es bienvenido.
Pruébalo
Todo está disponible en esp32pin.com, y el código junto con la canalización de datos se encuentran en GitHub.
Si estás construyendo algo donde la planificación de pines ocurre en archivos de configuración en lugar de un navegador, mantén vigilada la herramienta esp-gpio-tool de Espressif: valida las asignaciones de pines YAML contra el mismo tipo de datos de restricción, directamente en tu flujo de trabajo. Ambas herramientas resuelven problemas vecinos y ahora comparten datos.
Vía Espressif Developer Blog.
