ESP32: guía completa, pinout y ESPHome (2026)

Este artículo puede contener enlaces de afiliado. Si compras desde estos enlaces, el precio para ti es el mismo y la tienda me paga una pequeña comisión que ayuda a mantener Tecnoyfoto.

Albert BarnosellEditor y responsable de Tecnoyfoto

Actualizado el 3 de agosto de 2026. He revisado las especificaciones, los GPIO delicados y todos los ejemplos YAML conforme a la documentación actual de Espressif y ESPHome.

El ESP32 sigue siendo una de las mejores plataformas para construir sensores, controles y dispositivos locales para ESPHome y Home Assistant. Ofrece WiFi de 2,4 GHz, Bluetooth, numerosos periféricos y potencia suficiente para proyectos bastante más ambiciosos que los habituales con ESP8266.

Sin embargo, «ESP32» ya no identifica una única placa. Puede referirse al chip original, a un módulo como ESP32-WROOM-32, a una placa de desarrollo o a una familia que incluye variantes C3, S2, S3 y C6. En esta guía aprenderás a distinguirlas, elegir una placa, evitar los pines problemáticos y preparar una configuración ESPHome moderna y segura.

Qué es un ESP32: chip, módulo y placa no son lo mismo

• Chip o SoC: es el circuito de Espressif que contiene procesador, radios, memoria interna y periféricos.
• Módulo: integra el chip, memoria flash, cristal, antena y otros componentes en una pieza certificable; ESP32-WROOM-32 es un ejemplo muy conocido.
• Placa de desarrollo: añade regulador, USB a serie, botones BOOT/EN y conectores para poder programar y alimentar el módulo cómodamente.

Esta diferencia importa porque dos placas que anuncian «ESP32» pueden tener distinto número de pines, conversor USB, memoria, disposición física o incluso una variante de chip incompatible con el mismo identificador de placa.

Características del ESP32 clásico

El ESP32 original continúa siendo una opción muy madura. Según la ficha técnica oficial de Espressif, sus características principales incluyen:

Las cifras del chip no equivalen automáticamente a las de la placa. El fabricante puede reservar pines para flash, PSRAM, cámara, pantalla o Ethernet. Consulta siempre el esquema y el pinout exactos de tu modelo.

ESP32, C3, S3 o C6: cuál elegir

Para un primer proyecto doméstico con ESPHome, una placa ESP32 clásica o ESP32-C3 bien documentada suele ser la compra más sencilla. El asistente de ESPHome permite seleccionar primero la familia genérica y cambiar después al modelo exacto. La guía oficial sobre placas explica por qué el identificador correcto es esencial.

Cómo elegir una placa de desarrollo ESP32

• Variante y memoria: confirma el chip, la cantidad de flash y si incorpora PSRAM.
• Conector USB: USB-C es cómodo, pero el tipo de conector no garantiza USB nativo.
• Conversor USB a serie: CP2102, CH340 y equivalentes suelen funcionar bien; quizá necesites su controlador.
• Regulador: es decisivo para sensores exigentes y para el consumo durante el sueño profundo.
• Anchura: algunas placas ocupan casi toda una protoboard y dejan poco espacio para cables.
• Pinout y esquema: no compraría una placa sin documentación clara del fabricante o vendedor.
• Alimentación: comprueba si necesitas batería, cargador LiPo, Ethernet, cámara o antena externa.

Pinout del ESP32: los GPIO que debes vigilar

No existe un pinout universal para todas las placas ESP32. El siguiente diagrama pertenece a una placa de desarrollo concreta y solo debe usarse si las etiquetas coinciden con la tuya.

• GPIO6 a GPIO11: suelen estar conectados a la memoria flash. No los uses.
• GPIO34 a GPIO39: son exclusivamente entradas y no tienen resistencias pull-up/pull-down internas.
• GPIO0, 2, 5, 12 y 15: son pines de arranque o strapping. Un nivel incorrecto durante el encendido puede impedir que la placa arranque.
• GPIO1 y GPIO3: normalmente se emplean para la consola serie y la programación.
• ADC2: en el ESP32 clásico comparte recursos con WiFi. Para sensores analógicos con WiFi activo, prioriza canales ADC1, normalmente GPIO32 a GPIO39.

Estas restricciones están documentadas en la referencia GPIO oficial de Espressif. En otras variantes de ESP32 cambian, por lo que no debes trasladar esta lista sin comprobarla.

Cuánto consume realmente un ESP32

La ficha del chip ESP32 clásico indica alrededor de 10 µA en sueño profundo bajo sus condiciones de prueba. Una placa de desarrollo completa consumirá más por el regulador, el conversor USB a serie, el LED de alimentación y los sensores conectados. Por eso no es correcto prometer el consumo de una placa usando únicamente la cifra del chip.

Para un dispositivo alimentado permanentemente por USB, este detalle rara vez será crítico. En batería sí lo es: elige una placa diseñada para bajo consumo, elimina cargas innecesarias y mide el montaje completo con un instrumento adecuado. WiFi activo puede producir picos de corriente, de modo que una alimentación inestable causa reinicios y errores difíciles de diagnosticar.

Configuración ESPHome actual y segura para ESP32

El antiguo formato que colocaba platform: ESP32 dentro de esphome: ya no debe utilizarse. La plataforma tiene su propio bloque esp32:. Este ejemplo es para una placa genérica basada en el ESP32 clásico; cambia board: por el identificador de tu placa.

esphome:
  name: esp32-salon
  friendly_name: ESP32 salón

esp32:
  board: esp32dev
  framework:
    type: esp-idf

logger:
  level: INFO

api:
  encryption:
    key: !secret esp32_salon_api_key

ota:
  - platform: esphome
    password: !secret esp32_salon_ota_password

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

sensor:
  - platform: wifi_signal
    name: "Señal WiFi"
    update_interval: 60s

ESPHome actual recomienda ESP-IDF para ESP32 siempre que el proyecto sea compatible. Al declararlo explícitamente, el ejemplo también resulta más claro ante futuros cambios. Si una integración concreta exige Arduino, cambia únicamente el tipo de framework después de comprobar su documentación.

El archivo secrets.yaml

wifi_ssid: "Nombre de tu WiFi"
wifi_password: "Contraseña WiFi"
esp32_salon_api_key: "CLAVE_BASE64_GENERADA_POR_ESPHOME"
esp32_salon_ota_password: "una-contraseña-única-y-larga"
esp32_salon_web_username: "admin-esp32-salon"
esp32_salon_web_password: "otra-contraseña-única-y-larga"

No copies literalmente la clave de ejemplo. El asistente de ESPHome genera una clave API válida de 32 bytes codificada en Base64. Usa claves API, contraseñas OTA y credenciales web diferentes para cada dispositivo. Puedes aprender a reutilizar configuraciones sin exponer secretos en nuestra guía de sustituciones y packages de ESPHome.

web_server con autenticación: úsalo solo si lo necesitas

web_server permite consultar y controlar el nodo desde un navegador, pero abre una superficie adicional en la red local. La guía de seguridad de ESPHome recomienda desactivarlo si no hace falta y habilitar siempre autenticación cuando se utiliza.

web_server:
  port: 80
  version: 3
  auth:
    username: !secret esp32_salon_web_username
    password: !secret esp32_salon_web_password
    type: digest
  ota: false

En este ejemplo, las actualizaciones continúan disponibles mediante la plataforma OTA nativa y protegida, pero no desde la interfaz web. No expongas nunca el servidor web del ESP32 directamente a Internet. Incluso con autenticación, ESPHome está diseñado para redes de confianza y se beneficia de una red IoT o VLAN separada.

Desde ESPHome 2024.6, OTA es un componente de plataformas. Por eso el bloque correcto contiene - platform: esphome. Si realmente deseas subir firmware desde el navegador, existe - platform: web_server, pero requiere valorar su superficie de ataque y proteger el servidor web. Consulta la documentación OTA actual y nuestra guía específica de Web Server en ESPHome.

Cómo instalar tu primer ESP32 en ESPHome

1. Conecta la placa por un cable USB que transmita datos, no solo alimentación.
2. En ESPHome Device Builder, selecciona New device y elige la familia de placa correcta.
3. Realiza la primera instalación por USB. En algunas placas tendrás que mantener BOOT pulsado al iniciar la carga.
4. Cuando el nodo se conecte a WiFi, Home Assistant debería descubrirlo. Añádelo mediante la integración ESPHome.
5. Comprueba entidades, registros y señal WiFi antes de conectar relés, motores o sensores externos.
6. Las siguientes actualizaciones podrán realizarse por OTA con la contraseña configurada.

Problemas frecuentes y cómo resolverlos

La placa no aparece por USB

Prueba otro cable de datos, otro puerto y comprueba el controlador del conversor CP210x o CH34x. Cierra programas que estén utilizando el puerto serie.

ESPHome muestra un error de placa o framework

Revisa la variante real impresa en el módulo y el identificador board. esp32dev no es un valor universal para C3, S2, S3 o C6.

El ESP32 se reinicia al activar WiFi o un relé

Suele apuntar a alimentación insuficiente, caída de tensión, masa deficiente o ruido eléctrico. No alimentes motores o bobinas directamente desde un GPIO y utiliza protección adecuada. Nuestra guía de relés con ESP32 y ESPHome explica el cableado seguro.

Un sensor analógico deja de funcionar al conectar WiFi

En el ESP32 clásico, cambia a un canal ADC1 y verifica el rango de tensión. Esta limitación aparece a menudo en sensores analógicos como el MQ-2 con ESPHome.

Proyectos recomendados para empezar

• BMP280 con ESP32 y ESPHome: presión y temperatura mediante I²C.
• BME280 con ESPHome y Home Assistant: añade humedad al proyecto.
• Bluetooth Proxy de Home Assistant con ESPHome: amplía la cobertura BLE.
• ESP32 frente a ESP8266: diferencias prácticas antes de elegir plataforma.

Conclusión de esta review del ESP32

El ESP32 clásico continúa siendo muy recomendable en 2026 por su madurez, precio y enorme ecosistema. Para un nodo ESPHome corriente ofrece más margen que un ESP8266 y permite añadir Bluetooth, más GPIO y periféricos avanzados. Las variantes modernas C3, S3 y C6 amplían las opciones, pero obligan a verificar compatibilidad y pinout con más cuidado.

La mejor placa no es la que acumula más especificaciones, sino la que documenta bien sus pines, ofrece una alimentación estable y encaja con el componente que vas a utilizar. Empieza con el YAML mínimo, protege API, OTA y servidor web, y añade el hardware poco a poco.

Preguntas frecuentes sobre ESP32

¿ESP32 funciona directamente con Home Assistant?

Sí. Instalando ESPHome en la placa, Home Assistant puede descubrir el dispositivo y comunicarse mediante la API nativa cifrada.

¿Puedo alimentar un ESP32 con 5 V?

Muchas placas de desarrollo aceptan 5 V por USB o por el pin VIN/5V gracias a su regulador. El chip y sus GPIO trabajan a 3,3 V y no son tolerantes a 5 V. Comprueba siempre el esquema de tu placa.

¿Necesito web_server para usar Home Assistant?

No. Home Assistant utiliza la API nativa de ESPHome. Activa web_server únicamente si necesitas acceder al nodo desde un navegador y protégelo con autenticación.

¿ESP32dev sirve para cualquier placa ESP32?

No. Es un perfil genérico habitual para placas basadas en el ESP32 clásico. Los modelos C3, S2, S3, C6 y muchas placas especiales necesitan su propio identificador o variante.

Fuentes técnicas consultadas: documentación oficial de ESP32 en ESPHome, Web Server, OTA y documentación de hardware de Espressif. Consulta siempre la documentación correspondiente a tu variante y placa concretas.

Continúa leyendo

Siguiente guía relacionada · 10 min de lectura

OTA en ESPHome: guía segura y solución de errores (2026)

Actualizado el 3 de agosto de 2026. He revisado toda la guía conforme a los cambios introducidos por ESPHome 2024.6, 2025.7 y 2026.1, además…

Continuar con este artículo↓