Qué es un ESP32
ESP32 es una familia de microcontroladores de Espressif pensada para proyectos con conectividad inalámbrica. Según el modelo, incorpora WiFi, Bluetooth o Bluetooth Low Energy, además de entradas y salidas digitales, entradas analógicas, temporizadores y buses como I2C, SPI y UART.
Una placa de desarrollo ESP32 añade al chip lo necesario para trabajar con él: conector USB, regulador de tensión, botones de reinicio y programación, y una hilera de pines accesibles. Esa placa es la que normalmente se compra para un prototipo; el chip desnudo se reserva para diseños de producto o placas propias.
El ESP32 no es un ordenador completo. No sustituye a un servidor como Home Assistant, pero sí puede leer sensores, controlar actuadores y enviar datos a un panel o a otra plataforma.
Qué placa ESP32 elegir
No existe una única placa mejor. Elige según el proyecto y comprueba siempre el modelo exacto impreso en la placa y la documentación del fabricante.
| Familia | Cuándo tiene sentido | Precaución |
|---|---|---|
| ESP32 clásico | Primeros sensores, relés y proyectos generales | Hay muchas revisiones y placas compatibles con pinouts distintos |
| ESP32-C3 | Sensores pequeños y proyectos con un consumo contenido | Comprueba qué periféricos y pines necesita tu firmware |
| ESP32-S3 | Proyectos que necesitan más memoria, USB o procesamiento | No todos los módulos tienen la misma memoria ni el mismo conector |
| ESP32-C6 | Proyectos que requieran sus funciones de conectividad compatibles | Revisa el soporte de la versión de ESPHome y del framework elegido |
Para aprender, una placa de desarrollo bien documentada y con USB suele ser más importante que comprar el modelo más nuevo. Evita elegir únicamente por el número de GPIO: algunos pines tienen funciones de arranque, están conectados a la memoria flash o no deben usarse como una entrada normal.
Qué necesitas además de la placa
Para hacer una primera prueba necesitarás:
- Un cable USB que transmita datos. Muchos cables incluidos con cargadores solo sirven para cargar.
- Una protoboard y cables Dupont si vas a conectar un sensor sin soldar.
- Una fuente USB estable para la instalación definitiva. El USB del ordenador sirve para las primeras pruebas, pero no es una solución permanente para todos los montajes.
- El sensor o actuador que quieras probar y su ficha técnica.
El ESP32 trabaja normalmente con lógica de 3,3 V. No conectes una señal de 5 V a un GPIO sin comprobar antes que la placa y el circuito incorporan la adaptación necesaria. La entrada de alimentación de una placa de desarrollo y el nivel lógico de sus pines no son lo mismo.
Primeros pasos con ESPHome
ESPHome permite describir el dispositivo con YAML y generar el firmware sin empezar escribiendo C++. El flujo básico es el siguiente:
- Identifica la placa. Anota la familia, el módulo y el nombre del modelo que aparece en la documentación del fabricante.
- Instala ESPHome. Puedes usar su panel de configuración junto a Home Assistant o la herramienta de línea de comandos. Usa una versión compatible con tu placa y revisa la documentación antes de copiar un ejemplo antiguo.
- Crea una configuración mínima. Incluye el bloque de la placa, la red y los componentes que realmente vayas a utilizar. Las credenciales deben vivir en secretos locales, nunca en un repositorio público.
- Conecta la placa por USB. La primera carga suele hacerse por cable. Si el dispositivo no aparece, prueba otro cable y revisa el controlador USB-serie.
- Comprueba el log. Antes de conectar sensores, confirma que arranca, se conecta a la red y expone la API o el componente que necesitas.
- Añade hardware de uno en uno. Así sabrás qué cambio ha introducido un error y podrás revertirlo sin rehacer todo el montaje.
Un esquema mínimo de configuración puede tener esta forma, pero debes adaptar el nombre de la placa y los componentes a tu modelo:
esphome:
name: sensor-prueba
esp32:
board: esp32dev
logger:
api:
encryption:
key: !secret api_encryption_key
ota:
- platform: esphome
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
Este fragmento es una base de orientación, no una configuración universal.
Algunas placas o versiones requieren seleccionar otro board, framework o
componente OTA. Comprueba siempre el resultado de la compilación antes de
instalarlo.
Errores frecuentes con el ESP32
- El puerto no aparece: suele deberse a un cable solo de carga, un controlador USB-serie ausente o un puerto ocupado por otro programa.
- La carga falla al empezar: mantén pulsado el botón BOOT si la placa lo requiere, prueba otra velocidad y confirma que has seleccionado el puerto correcto.
- Reinicios en bucle: revisa la fuente, el regulador y el consumo del actuador. Un relé o una tira de LED no debería alimentarse alegremente desde un GPIO.
- No conecta al WiFi: confirma que la red es compatible, que las credenciales son correctas y que la antena no está bloqueada por metal. Si sigue fallando, consulta ESP32 no conecta al WiFi.
- El sensor devuelve cero o
NaN: revisa alimentación, tierra, pin, pull-up, dirección I2C y la frecuencia de lectura del componente. - Funciona por USB pero no instalado: comprueba la fuente independiente, la cobertura en su ubicación final y si el dispositivo necesita arrancar con un estado concreto de los pines.
Fuentes y documentación
Siguiente paso
Con la placa funcionando, vuelve a la guía de domótica para principiantes para elegir un primer sensor y planificar la automatización. La elección del protocolo de comunicación merece una comparativa separada dentro de Fundamentos.
También puedes comparar la familia con otras plataformas en ESP32 vs ESP8266 vs Arduino o continuar con ESPHome en español.