Configuración de Aeotec Z-Stick y Home Assistant

🏡 ¿Zigbee? No—¡Este es Z-Wave!

La línea Aeotec Z-Stick (Gen 5, Gen 7 y 7 Plus) convierte tu instancia de Home Assistant en un superhub Z-Wave—sin el drama de la nube propietaria. A continuación, una guía completa, con comentarios sarcásticos incluidos para que no te duermas durante el emparejamiento.

🔧 Lo que necesitarás

🥧 Raspberry Pi, NUC o equipo x86 que ejecute Home Assistant OS / Supervised / Docker.
🔌 Aeotec Z-Stick (Gen 5, Gen 7 o 7 Plus).

🔋 Dispositivos Z-Wave ansiosos por chismear entre sí.

🆚 Modelos de Stick—Diferencias clave

Característica	Gen 5	Gen 7	7 Plus
Chipset	500	700	700
SmartStart	❌	✅	✅
Seguridad S2	❌	✅	✅
Mejora de alcance	🔶	✅	✅ (+13 dBm)
Actualización de FW por OTA	❌	✅	✅

Verificar iconos: ✅ Sí 🔶 Parcial / Limitado ❌ No

🚀 Pasos de instalación

Conectar e identificar 🔌 - Inserta el stick en un puerto USB 2 (evita el ruido del USB 3). - En HA: Configuración → Sistema → Hardware → Todo el hardware → anota la ruta /dev/serial/by-id/… .
Agregar Z-Wave JS 🧩 - Configuración → Complementos → Tienda de complementos → Z-Wave JS UI → Instalar. - Activa Iniciar al arrancar y Watchdog. - Abre Configuración → establece Puerto serie en la ruta anterior, elige 500 000 baudios para Gen 7/Plus (115 200 para Gen 5).
Iniciar la red 🌐 - Haz clic en Iniciar controlador. - El panel debería mostrar “Controlador listo” y ver Controlador → “Aeotec Ltd.”.
Incluir dispositivos ➕ - Presiona el Botón de acción del stick una vez 🟢 (Gen 5) o triple toque (Gen 7/Plus) para entrar en modo de inclusión. - Acerca el dispositivo a ≤ 1 m, sigue su baile de emparejamiento. - En la interfaz de HA, los nodos aparecen bajo la integración Z-Wave JS.
Renombrar y amar 🏷 - Asigna nombres amigables como “Atenuador de cocina” en lugar de Nodo 0x2B—tu yo futuro te lo agradecerá.

🛠 Problemas comunes y soluciones

Síntoma	Causa probable	Solución	Nivel de usuario
Stick inalcanzable	Interferencia USB 3	Mover a un hub USB 2	✅
Nodo atascado “Entrevistando”	Dispositivo fuera de alcance	Agregar repetidor alimentado	✅
Fallo S2	PIN incorrecto (DSK)	Ingresa los primeros 5 dígitos impresos en el dispositivo	✅
Retraso en la red después de 30+ nodos	Necesita curación	Controlador → “Curar red” automatización nocturna	🔶

⚙️ Ejemplo de automatización (YAML)

alias: Encender luz del porche al atardecer
desencadenante:
  - plataforma: sol
    evento: atardecer
acción:
  - servicio: light.turn_on
    objetivo: { entity_id: light.porch_dimmer }
modo: reiniciar

🌟 Mejores prácticas

🔌 Cable de extensión USB = menos problemas de radio.
🗺 Reglas de malla: ¿cada 4-5 nodos a batería? Agrega uno alimentado.
🔄 Firmware: Z-Wave JS UI → pestaña OTA—actualiza sensores de bajo consumo.
🛡 Solo seguro cuando sea necesario: Cerraduras y sirenas sí, bombillas no (¡velocidad!).

🏁 Toque final

Desde la nostalgia del Gen 5 hasta la preparación para el futuro del 7 Plus, la línea Aeotec Z-Stick se integra perfectamente con Home Assistant. Sigue esta guía y tendrás una red Z-Wave sólida funcionando mientras bebes café y finges que planeaste esa demostración perfecta de hogar inteligente.

🔧 ¡Feliz automatización—y que tus nodos nunca se caigan!