Configurar un módulo Shelly con eedomus
De eedomus - Documentación
Esta página trata de los módulos Shelly Wifi o LAN (no de los módulos Z-Wave o BLE).
Esta página describe los principios de la configuración. Consulta la página detallada de cada módulo o tipo.
Los módulos Wifi son interesantes porque se basan en una red fácil de extender en grandes edificios, varias plantas, utilizando el mismo SSID (como en los hoteles). También tienen la ventaja de ofrecer una configuración que puede ser independiente de la nube y de cualquier app (a diferencia de Tuya). La configuración Wifi es, sin embargo, un poco más compleja que añadir un módulo Z-Wave o Zigbee.
Hay 3 pasos principales para la configuración:
- conectar el módulo Shelly a tu red WiFi
- crear los módulos actuadores o sensores en eedomus que interactuarán con el módulo Shelly
- configurar el módulo Shelly para que envíe información a los sensores (esta fase no es necesariamente necesaria para los actuadores).
Para que el módulo Shelly se comunique con eedomus (sensores), es necesario configurar una Acción en el módulo Shelly. En esta acción, se introduce una dirección web (URL), que llama a la api en la nube de eedomus, a la api local de eedomus o a un script php de la tienda eedomus en el box eedomus.
Cuando eedomus se comunica con el módulo Shelly (actuador), eedomus one utiliza un actuador HTTP que llama al módulo Shelly por su dirección IP.
Para los módulos que lo soportan, el objeto ciego "Shelly" de eedomus (gracias KikiFUNstyle) se encarga de los pasos 2 y 3.
Principio para un sensor (ejemplo con la api eedomus cloud)
1. Conecte el módulo Shelly a su red Wifi
- Una vez hecho esto, debe encontrar la dirección IP del Shelly en su red local: utilice el escáner eedomus si es necesario.
2. Cree un sensor HTTP (que no hará ninguna petición HTTP, poniendo la frecuencia a 0)
- A continuación, vaya a secure.eedomus.com / Config / Mi cuenta - API: para recuperar la API Cloud Set del sensor en cuestión
3. Establezca una acción en el sitio web del módulo Shelly (se llama Actions o webhook dependiendo la versión)
- Copiando la URL de la API Cloud (y añadiendo $temperatura para un sensor de temperatura).
Principio para un actuador (ejemplo con un actuador eedomus http)
1. Conecte el módulo Shelly a su red Wifi
- Dele una dirección IP fija, preferiblemente a través del DHCP de su router (o, como alternativa, utilizar el nombre mDNS)
2. Cree un actuador HTTP en eedomus
- Añada una acción ON y una acción OFF para un enchufe
- Ver sintaxis más abajo según versión
- Añada una acción ON y una acción OFF para un enchufe
Tiene entonces dos métodos para comprobar el estado del actuador, si ha sido accionado por algo distinto de eedomus (un interruptor físico o la pantalla del Shelly Pro 4 PM):
- el primero es sondear el actuador eedomus
- el segundo es añadir una Acción (un webhook) en la Shelly para llamar a la API local o en la nube de eedomus (ver más abajo el sensor)
Información adicional: URL según la versión del módulo Shelly
Existen 2 versiones de módulos Shelly: Gen1 y Gen2. Las 2 versiones no responden a los mismos comandos. E incluso dentro de la misma generación, las funciones soportadas son diferentes (de ahí la documentación de cada módulo.
Para activar un relé Gen2, la URL es (Elija una. ¡todas funcionan!):
- v2 http://ADRESSE_IP_SHELLY/relay/0?turn=on (GET)
- v2 http://ADRESSE_IP_SHELLY/rpc/Switch.Set (POST) Datos : {"id":0, "on":true}
- v2 http://ADRESSE_IP_SHELLY/rpc/Switch.Set?id=0&on=true (GET)
Puede sustituir ADRESSE_IP_SHELLY por su dirección en su red local, como 192.168.1.xx o su dirección mDNS ShellyXXXXXX.local. Si utilizas la dirección IP, te aconsejamos que la fijes (preferiblemente en tu router de Internet, o en el módulo Shelly directamente), ya que de lo contrario seguramente cambiará en el futuro.
Para reconocer la versión, la lista de dispositivos es https://shelly-api-docs.shelly.cloud/gen2/ para la generación 2, y por supuesto https://shelly-api-docs.shelly.cloud/gen1/ para la generación 1.
Información complementaria: Encontrar la dirección IP del módulo Shelly en la red local
Una vez que el módulo se añade a la red Wifi doméstica (tras conectarse a Wifi Shelly, 192.168.33.1, y luego seleccionar su Wifi), toma una dirección IP.
Para controlar un actuador, necesita esta IP, que puede encontrar de 4 maneras diferentes:
- utilizando el escáner integrado en la caja eedomus
- comprobando su router de Internet, que ha asignado esta IP mediante DHCP
- anotando primero el nombre de la shelly durante la configuración inicial, y añadiendo ".local" desde el servicio mDNS http://shellyxxxx.local
- utilizando un escáner de IP en tu PC
El módulo Shelly no es visible en la página Red de su PC Windows, a diferencia del eedomus box y las cámaras, porque no utiliza UPnP.
Información adicional: Seguridad
No recomendamos necesariamente añadir una contraseña al módulo Shelly. Proporciona seguridad, pero a costa de una mayor complejidad. Es un poco como cerrar todas las puertas interiores de su casa. Le hará la vida más difícil a un intruso, pero también se la hará más difícil a usted. Sólo lo recomendamos para los módulos que controlan aperturas (persianas, puerta de garaje, etc.).
También le recomendamos que utilice HTTP en lugar de HTTPS. Esto es importante para los módulos que funcionan con batería, ya que HTTPS implica el doble de intercambios y reduce la duración de la batería. Las comunicaciones ya están cifradas por la red WiFi (que debe ser segura), al menos para las comunicaciones locales.
Leer en Ingles : https://doc.eedomus.com/en/index.php/Configuring_a_Shelly_module_with_eedomus
