1. Resumen del Complemento
El Complemento de Control de Hardware iHost es un complemento de control de hardware desarrollado exclusivamente para la pasarela iHost. Este complemento se comunica con Home Assistant a través del protocolo MQTT, mapeando completamente las capacidades de hardware de iHost, como botones físicos, indicadores de estado y tiras de luz RGB, a Home Assistant. Los usuarios pueden configurar y vincular libremente estos recursos de hardware utilizando las funciones de automatización de Home Assistant, creando una experiencia de interacción más personalizada e inteligente basada en sus hábitos y escenarios del hogar.
2. Requisitos previos
Es necesario arrancar y ejecutar Home Assistant en iHost mediante una tarjeta microSD pregrabada para usar el Control de hardware iHost complemento, ya que habilita las funciones de botón e indicador de iHost. Ver el Guía de Operación para más detalles.
3. Instalar el complemento Control de hardware iHost
Agregar Hassio-iHost-Repositorios de complementos
- Ve a la Tienda de complementos → Haz clic en el botón Más (⋮) en la esquina superior derecha → Selecciona Repositorios
- Pega la siguiente URL:
https://github.com/iHost-Open-Source-Project/hassio-ihost-addon - O simplemente haz clic aquí para agregarlo automáticamente
Instalar Control de hardware iHost Complemento
- Buscar por Control de hardware iHost en la Tienda de complementos;
- Haz clic Instalar;
- Espera a que la instalación se complete.
Comenzar Control de hardware iHost Complemento
Haz clic en el botón “iniciar” después de que la instalación esté completa y espera a que termine de iniciarse.
Dado que el complemento Control de hardware iHost depende de MQTT, el complemento del broker Mosquitto se instala y se inicia automáticamente cuando inicias el complemento Control de hardware iHost, debes esperar unos minutos para ver el plugin Mosquitto broker en la lista de complementos.
Instalar integraciones MQTT
Por favor, ve a Configuración -> Dispositivos y servicios -> haz clic en el botón Agregar para la integración MQTT y espera a que se complete la adición.
Verifica los botones e indicadores de iHost en las integraciones MQTT
4. Entidades proporcionadas por el complemento
-
Botones iHost
El dispositivo iHost tiene 4 botones físicos en la parte superior: Botón de encendido, Botón de emparejamiento, Botón de silencio y Botón de seguridad, así como un pequeño orificio en el lateral para un Botón de reinicio. Estos 5 botones están representados como un dispositivo llamado “Botones iHost” y tienen 5 entidades asociadas. Por favor, consulte la tabla a continuación para detalles específicos.
- Nota: Una presión larga (10 segundos) en el botón de encendido apagará el hardware del iHost.
|
Dispositivo |
Entidades |
Capacidades |
|
Botones iHost |
Potencia |
Clic único |
|
Botones iHost |
Emparejamiento |
Clic único |
|
Botones iHost |
Silenciar |
Clic único |
|
Botones iHost |
Seguridad |
Clic único |
|
Botones iHost |
Restablecer |
Doble clic Presión larga (Mantener el botón presionado por más de 10s) |
-
Indicador iHost
Cada uno de los 4 botones físicos en el iHost tiene una luz indicadora azul, y también hay una tira de luz larga en el lateral. Estas 5 luces indicadoras se representan como un dispositivo llamado “Indicadores iHost”, cada uno con un Seleccionar entidad. Por favor, consulte la tabla a continuación para detalles específicos.
|
Dispositivo |
Entidades |
Capacidades |
|
Indicadores iHost |
Potencia |
Encendido, Apagado, Parpadeo rápido, Parpadeo doble |
|
Indicadores iHost |
Emparejamiento |
Encendido, Apagado, Parpadeo rápido, Parpadeo doble |
|
Indicadores iHost |
Silenciar |
Encendido, Apagado, Parpadeo rápido, Parpadeo doble |
|
Indicadores iHost |
Seguridad |
Encendido, Apagado, Parpadeo rápido, Parpadeo doble |
|
Indicadores iHost |
Tira lateral |
1. Apagado |
5. Configuraciones recomendadas de automatización
Hemos diseñado las siguientes configuraciones recomendadas de automatización para ayudarte a experimentar rápidamente el valor central del complemento. Todas las siguientes se pueden implementar fácilmente usando la función “Automatización” de Home Assistant:
5.1. Configuración del efecto de luz de inicio
Descripción del escenario:
Quieres un efecto de luz notable cuando Home Assistant termina de iniciarse.
Implementación：
- Crear nueva automatización.
- Cuando -> Agregar disparador -> Dispositivo -> Automatizaciones de hardware iHost -> “Home Assistant” se inicia.
- Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción de tira lateral de Indicadores iHost -> Verde sólido. Este escenario ayuda a indicar si el sistema está listo.
5.2. Apagar automáticamente las luces después del apagado
Descripción del escenario:
Apagar automáticamente todas las luces cuando iHost se apaga para ahorrar energía y evitar confusiones.
Implementación:
No se requiere configuración por parte del usuario. El complemento apagará automáticamente todas las luces cuando el sistema se apague, sin necesidad de intervención manual.
5.3. Efecto de luz de retroalimentación del botón
Descripción del escenario:
Cuando presiona el botón de emparejamiento en iHost, el indicador del botón tiene un efecto de luz de retroalimentación: enciende el indicador y luego lo apaga después de 200 ms.
Implementación:
- Crear nueva automatización.
- Cuando -> Agregar disparador -> Dispositivo -> Botones iHost -> Emparejamiento “Clic único”.
- Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción de emparejamiento de Indicadores iHost -> Activado.
- Acción -> Agregar acción -> Retrasar por 200 milisegundos.
- Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción Emparejamiento Indicadores iHost -> Apagado.
5.4. Uso del botón de emparejamiento para controlar los efectos de luz de unión a la red Zigbee2MQTT
Descripción del escenario 1:
Presione el botón de emparejamiento para mostrar el efecto de luz del botón (encender el indicador, luego apagarlo después de 200 ms) y permitir que los dispositivos ZigBee se unan a la red.
[Automation 1] No Pairing State, Pairing Button to Trigger Network Join:
- Crear nueva automatización.
- Cuando -> Agregar disparador -> Dispositivo -> Botones iHost -> Emparejamiento “Clic único”.
- Y si -> Agregar condición -> Dispositivo -> Puente Zigbee2MQTT -> Permitir unión del Puente Zigbee2MQTT está desactivado.
- Acción -> Agregar acción -> Dispositivo -> Puente Zigbee2MQTT -> Activar Permitir unión del Puente Zigbee2MQTT.
Descripción del escenario 2:
Durante el proceso de unión a la red, presione el botón de emparejamiento para mostrar el efecto de luz del botón (encender el indicador, luego apagarlo después de 200 ms) y detener la unión a la red ZigBee.
[Automation 2] Durante el emparejamiento, botón de emparejamiento para detener la unión a la red:
- Crear nueva automatización.
- Cuando -> Agregar disparador -> Dispositivo -> Botones iHost -> Emparejamiento “Clic único”.
- Y si -> Agregar condición -> Dispositivo -> Puente Zigbee2MQTT -> Permitir unión del Puente Zigbee2MQTT está activado.
- Acción -> Agregar acción -> Dispositivo -> Puente Zigbee2MQTT -> Apagar Permitir unión del Puente Zigbee2MQTT.
Descripción del escenario 3:
Durante el proceso de unión a la red, la tira de luz muestra un efecto de luz naranja respirando.
[Automation 3] Detectando modo de emparejamiento:
- Crear nueva automatización.
- Cuando -> Agregar disparador -> Dispositivo -> Puente Zigbee2MQTT -> Permitir unión del Puente Zigbee2MQTT activado.
- Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción de tira lateral de indicadores iHost -> Naranja respirando.
Descripción del escenario 4:
Después de que la unión a la red se detiene, la tira de luz muestra un efecto de luz verde sólida.
[Automation 4] Detectando salida de emparejamiento:
- Crear nueva automatización.
- Cuando -> Agregar disparador -> Dispositivo -> Puente Zigbee2MQTT -> Permitir unión del Puente Zigbee2MQTT desactivado.
- Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción Tira Lateral Indicadores iHost -> Verde Fijo.
5.5. Efecto de luz de alarma de red fuera de línea
Descripción del escenario:
Cuando el dispositivo no puede acceder a internet, la tira de luz muestra una advertencia roja. La integración Ping (ICMP) debe estar instalada con la dirección ping configurada en 8.8.8.8.
Implementación:
- Crear nueva automatización.
- Cuando -> Agregar Disparador -> Disparar en el segundo 3 de cada minuto de cada hora.
-
Y si -> Agregar condición -> Dispositivo -> 8.8.8.8 (dispositivo de integración Ping) -> 8.8.8.8 está desconectado.
-
Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción de tira lateral de indicadores iHost -> Rojo sólido.
5.6. Efecto de luz de recuperación de red
Descripción del escenario:
Cuando la red se recupera, la tira de luz vuelve automáticamente a verde fijo, señalando que el sistema ha vuelto a la normalidad.
Implementación:
- Crear nueva automatización.
- Cuando -> Agregar Disparador -> Disparar en el segundo 3 de cada minuto de cada hora.
- Y si -> Agregar condición -> Dispositivo -> 8.8.8.8 (dispositivo de integración Ping) -> 8.8.8.8 está conectado.
- Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción Tira Lateral Indicadores iHost -> Verde Fijo.
5.7. Apagar Todas las Luces por la Noche
Descripción del escenario:
Apagar automáticamente todos los indicadores y tiras de luz por la noche para evitar contaminación lumínica o interrupciones durante el sueño.
Implementación:
- Crear nueva automatización.
- Cuando -> Agregar Disparador -> Cuando la hora sea igual a 11:30 PM.
- Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción Tira Lateral Indicadores iHost -> Apagado.
- Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción Energía Indicadores iHost -> Apagado.
- Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción Emparejamiento Indicadores iHost -> Apagado.
- Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción Seguridad Indicadores iHost -> Apagado.
- Acción -> Agregar acción -> Dispositivo -> Indicadores iHost -> Cambiar opción Silenciar Indicadores iHost -> Apagado.
5.8. Usar el Botón de Encendido para Apagado Físico
Descripción del escenario:
El apagado se puede realizar directamente mediante el botón físico en el dispositivo iHost, sin usar la interfaz web.
Implementación:
- Presiona y mantén presionado el Botón de Encendido durante aproximadamente 10 segundos para iniciar el apagado.
- Para encender el sistema nuevamente, simplemente presiona el Botón de Encendido una vez. Esta función no requiere configuración y es manejada automáticamente por el complemento.
Nota: Es ideal para escenarios de protección contra cortes de energía o mantenimiento.
Estás invitado a explorar nuestro proyecto GitHub y unirte a las discusiones del foro eWeLink . Nuestro proyecto de código abierto iHost seguirá trayendo nuevas funciones emocionantes—¡mantente atento!
Dejar un comentario
Todos los comentarios se revisan antes de su publicación.
Este sitio está protegido por hCaptcha y se aplican la Política de privacidad de hCaptcha y los Términos del servicio.