Conectar IoT Button V2 a Home Assistant vía Seeed HA Discovery
El Seeed Studio IoT Button V2 es un interruptor inteligente versátil alimentado por ESP32-C6, que ofrece indicadores LED RGB personalizables, activadores de eventos programables y capacidades de carga USB-C. En este proyecto, te guiaremos a través de la conexión de tu IoT Button V2 a Home Assistant usando la integración Seeed HA Discovery - una solución que facilita la conexión de dispositivos ESP32 a Home Assistant con descubrimiento automático y comunicación en tiempo real vía WebSocket.
Comparado con usar ESPHome, esta solución está diseñada específicamente para casos de uso de botones compatibles con sueño profundo. ESPHome actualmente solo soporta sueño ligero para el IoT Button V2, lo que lleva a un mayor consumo de energía con el tiempo y requiere que despiertes el dispositivo con una pulsación dedicada antes de que la pulsación real del botón pueda activar entidades de manera confiable. Con este firmware y la integración Seeed HA Discovery, el botón puede entrar correctamente en sueño profundo y despertar directamente con la interacción del botón, evitando estas limitaciones y proporcionando una experiencia más receptiva y eficiente en energía.
Introducción
Este proyecto te guiará a través de tres fases principales: flashear el firmware a tu IoT Button V2 usando un flasheador basado en web, instalar la integración Seeed HA Discovery vía HACS (Home Assistant Community Store), y descubrir tu botón en Home Assistant para automatización del hogar inteligente.
Materiales Requeridos
| Seeed Studio IoT Button V2 | Home Assistant Green |
|---|---|
 |  |
Home Assistant Green es la forma más fácil y centrada en la privacidad de automatizar tu hogar. Ofrece una configuración sin esfuerzo y te permite controlar todos los dispositivos inteligentes con un solo sistema, donde todos los datos se almacenan localmente por defecto. Esta placa se beneficia del próspero ecosistema de Home Assistant y será mejorada cada mes por código abierto.
Recomendamos usar Home Assistant Green como el host de Home Assistant para este tutorial, o puedes usar cualquier host de Home Assistant con un Supervisor.
También hemos escrito cómo instalar Home Assistant para algunos productos de Seeed Studio, por favor consúltalos.
- Introducción a Home Assistant en ODYSSEY-X86
- Introducción a Home Assistant en reTerminal
- Introducción a Home Assistant en LinkStar H68K/reRouter CM4
Si no estás usando un producto de Seeed Studio, también puedes verificar y aprender cómo instalar Home Assistant para otros productos en el sitio web oficial de Home Assistant.
Preparación Preliminar
Antes de comenzar este proyecto, asegúrate de tener lo siguiente:
- Una instancia de Home Assistant en funcionamiento (Home Assistant OS, Container, o Core)
- HACS (Home Assistant Community Store) instalado en tu Home Assistant
- Una computadora con navegador Google Chrome o Microsoft Edge (requerido para flasheo de firmware basado en web)
- El nombre de tu red WiFi (SSID) y contraseña
- Tu IoT Button V2 y un cable USB-C para conexión
Si aún no has instalado HACS, por favor sigue la guía oficial de instalación de HACS para configurarlo primero. HACS es requerido para instalar la integración Seeed HA Discovery.
Flashear Firmware al IoT Button V2
Seeed HA Discovery es una solución completa para conectar fácilmente dispositivos ESP32/nRF52840 a Home Assistant, y el primer paso es flashear el firmware apropiado a tu IoT Button V2.
El flasheador de firmware basado en web es solo compatible con IoT Button V2. Actualmente no es compatible para uso con IoT Button V1.
Paso 1. Acceder al Flasheador Web
Abre el navegador Google Chrome o Microsoft Edge y navega al Flasheador Web de Seeed HA Discovery:
Web Serial está disponible en navegadores Google Chrome y Microsoft Edge (pero no en tu dispositivo iOS). Asegúrate de estar usando un navegador compatible en una computadora de escritorio o portátil.
Paso 2. Conectar tu IoT Button V2
Si estás usando firmware Zigbee/ESPHome, por favor nota si el dispositivo entra automáticamente en modo de sueño. Si el dispositivo entra en modo de sueño, podrías no poder localizar su puerto serie. Asegúrate de que el LED azul del dispositivo esté encendido y permanezca despierto antes de flashear el firmware.
Paso 2.1. Conecta tu IoT Button V2 a tu computadora usando un cable USB-C.
Paso 2.2. En la página del flasheador web, localiza la opción de firmware IoT Button V2 y haz clic en el botón "Connect".
Paso 2.3. Aparecerá una ventana emergente del navegador mostrando los puertos serie disponibles. Selecciona el puerto correspondiente a tu IoT Button V2 (usualmente etiquetado como USB JTAG o serial) y haz clic en "Connect".
Paso 3. Flashear el Firmware
Paso 3.1. Una vez conectado, haz clic en el botón "Install IoT Button V2" para comenzar el proceso de carga del firmware.
Paso 3.2. Luego necesitas elegir si borrar el dispositivo. Si solo quieres actualizar el firmware del dispositivo sin perder las credenciales de red, puedes dejar esta opción sin marcar y hacer clic en Next. Si estás cambiando desde otro firmware, recomiendo encarecidamente marcar este botón durante tu primer flasheo de firmware.
El flasheador borrará el firmware existente y cargará el nuevo firmware Seeed HA Discovery. Este proceso típicamente toma 1-2 minutos. No desconectes tu dispositivo durante este proceso.
Paso 3.3. Cuando veas el mensaje "Installation complete!", tu firmware ha sido flasheado exitosamente.
Entendiendo las Características del Firmware
El firmware del IoT Button V2 con funcionalidad de sueño profundo ofrece varias características clave:
Gestión de Energía:
- El componente deep_sleep puede usarse para entrar automáticamente en un modo de sueño profundo en el ESP32 después de cierta cantidad de tiempo. Esto es especialmente útil con nodos que operan con baterías y por lo tanto necesitan conservar tanta energía como sea posible[1].
- El botón entra en modo de sueño ligero después de 3 minutos de inactividad para conservar energía de la batería
- El despertar del sueño se activa presionando el botón
Eventos del Botón:
- Pulsación Simple: Activa evento de clic simple en Home Assistant
- Pulsación Doble: Activa evento de doble clic en Home Assistant
- Pulsación Larga: Activa evento de pulsación larga (típicamente 1+ segundos)
- Pulsación Triple: Entra en modo desarrollador, donde el dispositivo permanece despierto por 3 minutos, permitiéndote flashear firmware sin perder la conexión del puerto serie
- Pulsación Larga (6+ segundos): Después de que el LED parpadee, suelta el botón para iniciar el modo de reconfiguración de red, permitiéndote configurar una nueva red Wi-Fi
Retroalimentación LED:
- El LED RGB proporciona retroalimentación visual para pulsaciones de botón y estado de conexión
- Colores LED personalizables para diferentes estados
Monitoreo de Batería:
- Lectura de voltaje basada en ADC para estimación del nivel de batería
- Reporte de estado de batería en tiempo real a Home Assistant
IoT Button V2: Ciclo de Vida y Eventos
Instalar la Integración Seeed HA Discovery
Ahora que tu IoT Button V2 tiene el firmware apropiado, el siguiente paso es instalar la integración Seeed HA Discovery en Home Assistant a través de HACS.
Paso 4. Instalar HACS (Si No Está Ya Instalado)
Si aún no has instalado HACS:
Paso 4.1. Instala la Tienda de la Comunidad de Home Assistant (HACS) para habilitar la instalación de plugins de Seeed HA Discovery dentro de Home Assistant.
Paso 4.2. Sigue la guía oficial de instalación de HACS en https://www.hacs.xyz/docs/use/download/download/#to-download-hacs
Paso 4.3. Es posible que necesites reiniciar Home Assistant para que HACS se integre completamente en tu sistema.
Paso 5. Agregar el Repositorio Seeed HA Discovery
Paso 5.1. Navega al repositorio de GitHub de Seeed HA Discovery:
Paso 5.2. En la sección README, localiza el área ⚡ Instalación con Un Clic y haz clic en el botón ABRIR REPOSITORIO HACS EN MI HA.
Este botón te redirigirá automáticamente a tu instancia de Home Assistant y abrirá la página de adición de repositorio HACS.
Paso 5.3. Aparecerá una página de redirección mostrando tu URL de Home Assistant. Verifica que la dirección de Home Assistant detectada sea correcta (debe coincidir con la dirección IP o nombre de dominio de tu Home Assistant).
-
Si la dirección es correcta, haz clic en Abrir enlace para continuar
-
Si la dirección es incorrecta, ingresa manualmente tu URL correcta de Home Assistant en el formato:
http://TU_IP_HA:8123ohttps://TU_DOMINIO_HA
Paso 5.4. Home Assistant se abrirá y mostrará el diálogo de adición de repositorio HACS con la URL del repositorio Seeed HA Discovery ya completada.
Paso 5.5. Haz clic en Descargar en la esquina inferior derecha para agregar el repositorio a HACS. Asegúrate de estar usando la versión más reciente del plugin. Después de que el script de instalación haya terminado, necesitas reiniciar Home Assistant para aplicar los cambios. Puedes reiniciar Home Assistant a través de la interfaz yendo a Settings > System > Restart
Si el botón de un clic no funciona, puedes agregar manualmente el repositorio:
-
Abriendo HACS en la barra lateral de tu Home Assistant
-
Haciendo clic en el botón de menú (tres puntos) en la esquina inferior derecha
-
Seleccionando "Custom repositories"
-
Ingresando
https://github.com/limengdu/Seeed-Homeassistant-Discoveryy seleccionando la categoría "Integration"
Configurar WiFi y Descubrir el IoT Button
Con la integración instalada, ahora puedes configurar tu IoT Button V2 para conectarse a tu red WiFi y descubrirlo en Home Assistant.
Paso 6. Configurar WiFi en el IoT Button V2
Paso 6.1. Después de flashear el firmware, tu IoT Button V2 creará un punto de acceso WiFi (AP) para la configuración inicial. El nombre del AP será típicamente Seeed_IoT_Button_V2_AP.
Paso 6.2. Usando tu smartphone o computadora, conéctate a este punto de acceso WiFi.
Paso 6.3. Un portal cautivo debería abrirse automáticamente. Si no, abre un navegador web y navega a http://192.168.4.1.
Paso 6.4. En el portal de configuración, ingresa las credenciales de tu red WiFi doméstica:
Ten en cuenta que el IoT Button actualmente no es compatible con redes que operan en bandas de frecuencia 5G.
- SELECTED NETWORK: El nombre de tu red WiFi
- PASSWORD: Tu contraseña WiFi
Paso 6.5. Haz clic en "Connect" para guardar la configuración.
Paso 6.6. El IoT Button V2 se reiniciará y se conectará a tu red WiFi. El LED RGB mostrará color azul.
Paso 7. Agregar IoT Button en Home Assistant
Paso 7.1. Después del reinicio, haz clic en Settings en la barra lateral para abrir el menú de configuración. Dentro del menú de configuración, navega a Devices & Services.
Paso 7.2. Si tu IoT Button V2 está conectado exitosamente a tu red WiFi, el dispositivo será descubierto automáticamente por Home Assistant después de conectarse al WiFi. Si el dispositivo no es detectado automáticamente, también puedes agregarlo manualmente haciendo clic en "Add Integration" en la esquina inferior derecha, buscando "Seeed HA Discovery" e ingresando la dirección IP del dispositivo.
La dirección IP del dispositivo se puede obtener desde el registro del puerto serie o desde el backend del router.
Paso 7.3. Sigue las indicaciones en pantalla para completar la configuración de la integración. Es posible que necesites asignar el botón a un área en tu hogar.
Paso 7.4. Una vez configurado, tu IoT Button V2 aparecerá en tu panel de Home Assistant con entidades disponibles para eventos de botón, estado de batería y control de LED.
Paso 8. Crear Automatizaciones
Ahora que tu IoT Button está conectado, puedes crear automatizaciones en Home Assistant:
Paso 8.1. Navega a Settings > Automations & Scenes.
Paso 8.2. Haz clic en "Create Automation" y selecciona "Start with an empty automation".
Paso 8.3. Para el Trigger, selecciona tu dispositivo IoT Button y elige el tipo de evento (presión simple, doble presión o presión larga).
Paso 8.4. Para la Action, elige qué quieres que suceda (por ejemplo, encender luces, activar escenas, enviar notificaciones).
Paso 8.5. Guarda tu automatización y pruébala presionando tu IoT Button!
Soporte Técnico y Discusión de Productos
¡Gracias por elegir nuestros productos! Estamos aquí para brindarte diferentes tipos de soporte para asegurar que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para satisfacer diferentes preferencias y necesidades.