Guía de la interfaz web del asistente Shelly Blu

Descripción general

Los dispositivos Shelly ofrecen una interfaz web local que le permite controlar y configurar sus dispositivos mediante un navegador web estándar, ya sea en su ordenador o dispositivo móvil. Con ella, puede encender o apagar los aparatos conectados a su dispositivo, establecer horarios y configurar acciones que se ejecuten cuando se cumplan determinadas condiciones.

Tenga en cuenta que no necesita una conexión a Internet ni Shelly Cloud para utilizar la interfaz web local; el único requisito es que su navegador esté en la misma red Wi-Fi que su dispositivo Shelly.

Acceder a la interfaz web

Para acceder a la interfaz web:

1. Conecte su dispositivo a una red Wi-Fi cuyo nombre (SSID) siga este formato: "DeviceName-XXXXXXXXXX", donde «DeviceName» es el nombre del dispositivo al que desea conectarse y «XXXXXXXXXX» representa una combinación única de letras y números que constituye el ID del dispositivo.

2. Después de establecer una conexión con el Punto de acceso / AP del dispositivo (la red Wi-Fi mencionada en el paso 1), acceda a la interfaz web introduciendo en el navegador la dirección IP universal de todos los dispositivos Shelly: 192.168.33.1.

Ahora se encuentra en la interfaz web de su dispositivo.

Conectar el dispositivo a una red Wi-Fi

Algunos de los ajustes que verá en la interfaz web solo están disponibles si el dispositivo está conectado a Internet. Para hacerlo, siga estos pasos:

1. En la interfaz web, vaya a Configuración>Wi-Fi.

2. Introduzca o seleccione su red Wi-Fi preferida y, a continuación, introduzca su contraseña. Como alternativa, también puede conectarse a una red abierta seleccionando la casilla para conectarse a redes Wi-Fi abiertas. Además, se recomienda establecer una dirección IP estática.

3. Espere unos segundos para que su dispositivo intente conectarse a la red Wi-Fi que proporcionó. Si la contraseña introducida es incorrecta o la red Wi-Fi no tiene suficiente potencia o estabilidad, aparecerá un mensaje en la interfaz web para informarle de que no se ha podido establecer la conexión. Una vez que se haya conectado correctamente a la red Wi-Fi, aparecerá un enlace con la nueva dirección IP como texto encima de la configuración de Wi-Fi. Simplemente copie y pegue este enlace en su navegador.

Ahora se encuentra en la interfaz web de su dispositivo conectado a Internet. La próxima vez que necesite acceder a la interfaz web, simplemente conecte su dispositivo a la misma red Wi-Fi que su dispositivo y escriba la nueva dirección IP obtenida en el paso 3. Se recomienda establecer una dirección IP estática, ya que garantiza un acceso constante a esa dirección específica.

Descripción de la estructura

La interfaz web se puede dividir en cuatro secciones principales: el encabezado, el pie de página, el menu principal y el contenido principal.

Encabezado

El encabezado consta de dos componentes: el nombre de tu dispositivo a la izquierda y algunos iconos a la derecha que muestran las principales funciones de red y conectividad de tu dispositivo. Estos iconos pueden incluir funciones como Wi-Fi, Bluetooth, MQTT y otras, además de un icono que indica si hay nuevas actualizaciones de firmware para tu dispositivo. Al pasar el ratón sobre un icono, obtendrás más información. Encontrarás una leyenda con el significado de cada icono en la guía de la interfaz web de cada dispositivo. Ten en cuenta que las guías individuales solo explican las funciones de conectividad disponibles para ese dispositivo específico.

Pie de página

En la parte inferior de la pantalla, de izquierda a derecha, aparecen el nombre del modelo del dispositivo, su ID, la versión de la interfaz web, la versión del firmware del dispositivo y, por último, la hora actual. Si la hora no está sincronizada, recibirás una notification en la parte superior de la pantalla, y es posible que algunos programas y acciones no funcionen como se espera. Algunas versiones anteriores de la interfaz web no incluyen todos estos componentes.

menu principal

El menu principal de la versión de escritorio de la interfaz web se encuentra a la izquierda, mientras que en dispositivos móviles aparece como un menu de hamburguesa con un icono de tres líneas horizontales apiladas. El menu contiene distintos elementos según el dispositivo, pero al hacer clic en uno de ellos accederás a una página diferente. También puedes utilizarlo para volver a la página de inicio haciendo clic en Inicio.

Contenido principal

Al hacer clic en un elemento del menu principal, podrás navegar por la interfaz web. Todo lo que ves en la pantalla, excepto el encabezado, el pie de página y el menu principal, se considera contenido principal.

menu principal

A continuación se explican todos los ajustes del menu principal, incluido lo que se muestra como contenido principal al hacer clic en los distintos ajustes. En la explicación de la página de inicio también se incluye una breve introducción a los iconos del encabezado específicos de este dispositivo. Ten en cuenta que el encabezado está presente en todas las pantallas, no solo en la página de inicio.

Página de inicio

Cada icono mostrado en el encabezado tiene colores de estado que cambian. Esto es lo que significan:

Icono de AP :Gray: El modo AP está desactivado.Blue: El modo AP está activado.Icono de Wi-Fi :Gray: La conexión Wi-Fi está desactivada.White: La conexión Wi-Fi está activada, pero no establecida.Blue: El dispositivo está conectado a Wi-Fi.Icono de Bluetooth :Gray: La conexión está desactivada.Blue: La conexión está activada.Icono de Cloud :Gray: La conexión a Shelly Cloud está desactivada.White: La conexión a Shelly Cloud está activada, pero no establecida.Blue: El dispositivo está conectado a Shelly Cloud.Icono de MQTT:Gris: MQTT está desactivado.Azul: MQTT está activado. Icono de actualización del firmware:Azul: Hay una nueva versión estable del firmware para tu dispositivo.No aparece: El firmware del dispositivo está actualizado. Icono de conexión WebSocket:Azul: WebSocket conectado.Gris: WebSocket no conectado.

La página de inicio de la interfaz web está dividida en cuatro paneles que se pueden contraer:

Favoritos

Este panel está vacío inicialmente. Haz clic en ★ en un dispositivo detectado en el panel Results para añadirlo a favoritos y mostrarlo aquí.

Puedes fijar hasta 6 dispositivos en este panel.

Cada dispositivo tiene:

• un alias personalizado (guardado en KVS, pero no enviado al dispositivo mediante un comando de cambio de nombre).

• hasta 4 botones para llamadas RPC arbitrarias con etiquetas personalizadas.

Buscar dispositivos Shelly

Busca y ordena dispositivos Shelly específicos en este panel. Los dispositivos encontrados aparecen en el panel Results.

Así se utiliza cada control de esta sección:

Enviar RPC

Envía una RPC a hasta 5 dispositivos al mismo tiempo:

1. Selecciona uno o varios dispositivos en el panel Results (marca la casilla situada a la derecha del nombre del dispositivo).

2. Empieza a escribir una RPC. El autocompletado muestra únicamente los comandos válidos para el modelo de dispositivo específico que hayas seleccionado.

3. Opcional: Añade parámetros en formato JSON.

4. Haz clic en Send para ejecutar el comando en hasta 5 dispositivos simultáneamente.

Consulta cuántas llamadas RPC se ejecutaron correctamente bajo el título del panel.

Resultados

Consulta todos los dispositivos encontrados que coinciden con los criterios seleccionados en el panel Find Shelly dispositivos.

En la parte superior del panel se muestra un resumen:

• Número de dispositivos detectados

• Número de dispositivos filtrados

• Número de dispositivos seleccionados (marcados al hacer clic en la casilla de verificación o en Select All para marcar rápidamente todos los dispositivos)

• Número de dispositivos añadidos a favoritos

Cada tarjeta de dispositivo muestra el modelo, el nombre, la MAC y el RSSI. Durante las operaciones, aparece una barra de progreso.

Consulta los detalles ampliados de éxito o error debajo de la tarjeta del dispositivo.

Configuración

Configuración de red

• Punto de acceso y extensor de alcance : configura el punto de acceso (AP) del dispositivo seleccionando la casilla Activar punto de acceso y estableciendo una contraseña para proteger la red frente a accesos no autorizados. De forma predeterminada, el punto de acceso del dispositivo es una red abierta. El SSID es único y no se puede cambiar. Activa la función Extensor de alcance seleccionando la casilla. El extensor de alcance crea un punto de acceso al que puedes conectar dispositivos Wi-Fi. Si un dispositivo Shelly con el extensor de alcance activado está conectado a un enrutador Wi-Fi y a Internet, todos los dispositivos conectados a él también estarán conectados al enrutador y a Internet.
  Aunque el dispositivo Shelly no esté conectado a un enrutador Wi-Fi, todos los dispositivos conectados a él pueden seguir comunicándose con él y entre sí. Debajo se muestra información sobre los clientes del AP conectados: cuántos hay, así como su configuración IP, dirección MAC y direcciones IP internas y externas.

• Wi-Fi: registra el dispositivo Shelly para conectarlo a un máximo de 2 redes Wi-Fi diferentes.

  Introduce la red Wi-Fi escribiendo en el campo de texto o selecciónala haciendo clic en el icono de chevrón (flecha) para explorar todas las redes disponibles. Puedes seleccionar una red abierta y también establecer una dirección IP estática.

  Activa Wi-Fi 1, Wi-Fi 2 o ambas al mismo tiempo (mediante el interruptor situado junto a cada una). Si Wi-Fi 1 y Wi-Fi 2 están activados y el dispositivo Shelly se desconecta de una de las redes, se conectará a la otra. Solo es posible activar Wi-Fi una vez establecido el nombre de la red (SSID). Si el dispositivo no tiene otras conexiones disponibles (AP, Bluetooth, Ethernet (si corresponde) u otra red Wi-Fi), al intentar desactivar Wi-Fi aparecerá una ventana emergente que te preguntará si deseas continuar.

• Bluetooth: desactiva o activa Bluetooth alternando el interruptor. La configuración predeterminada de Bluetooth del dispositivo es activado.

Conectividad

Nota sobre la comunicación RPC: cuando no se puede ejecutar una llamada RPC, aparece un mensaje en forma de banner que te informa de que el dispositivo no responde a tiempo y ha perdido la conexión. Cuando se restablece la conexión, la solicitud se vuelve a enviar.

• MQTT: configura el dispositivo Shelly para ejecutar acciones mediante MQTT. De forma predeterminada, MQTT está desactivado, pero puedes activarlo seleccionando la casilla vacía. Cambiar estos ajustes hará que el dispositivo se reinicie. Hay otros ajustes, como notificaciones de estado de RPC mediante MQTT (que te permite comunicarte con el dispositivo mediante notificaciones de RPC) y actualización de estado genérico mediante MQTT (para obtener una actualización general del estado), que puedes activar o desactivar. También puedes activar SSL e introducir el servidor, el nombre de usuario y la contraseña, pero ten en cuenta que activar SSL reducirá la duración de la batería y probablemente la acortará a la mitad.

• WebSocket saliente: especifica si el canal HTTP crea una excepción de E/S cuando se cierra una conexión entrante mientras el servlet todavía la está utilizando. De forma predeterminada, este ajuste está deshabilitado. Para habilitarlo, haga clic en el interruptor situado junto a Habilitar. Introduzca la dirección de su servicio en el cuadro de texto y, en el menu desplegable situado debajo de Conectividad SSL, seleccione *, ca.pem o user_ca.pem.

• RPC sobre UDP: comuníquese con su dispositivo y envíe solicitudes mediante una llamada a procedimiento remoto (RPC) a través de un servidor de protocolo de datagramas de usuario (UDP). Esto puede resultar útil para controlar y supervisar el dispositivo de forma remota, sin necesidad de un servidor o una conexión específicos.

  Para utilizar este ajuste, deberá introducir el puerto de escucha y la dirección de destino del servidor UDP. El puerto de escucha es el número de puerto en el que el dispositivo escuchará las solicitudes entrantes, mientras que la dirección de destino es la dirección IP del servidor al que se enviarán las solicitudes.

  Una vez que haya introducido la información necesaria, puede utilizar el protocolo RPC sobre UDP para enviar solicitudes a su dispositivo y recibir respuestas.

Ajustes del dispositivo

• Nombre del dispositivo (info) : consulte el ID de su dispositivo, la red Wi-Fi a la que está conectado y el RSSI de Wi-Fi.

• Reiniciar: después de hacer clic en el botón Reiniciar, se le preguntará si está seguro de que desea reiniciar el dispositivo. Haga clic en Aceptar para reiniciar el dispositivo y en Cancelar si no desea reiniciarlo.

• Restablecimiento de fábrica : al hacer clic en el botón Restablecer, todos los ajustes del dispositivo se restablecerán a sus valores predeterminados. Se revertirán todos los cambios que haya realizado. Puede confirmar que desea restablecer el dispositivo a los valores de fábrica haciendo clic en Aceptar en la ventana emergente, o en Cancelar para cancelar el restablecimiento de fábrica.

• Ubicación y zona horaria : su zona horaria y ubicación se detectarán automáticamente, pero puede cambiarlas manualmente desde este ajuste seleccionando una zona horaria en el menu desplegable e introduciendo su latitud y longitud. También hay un botón Detectar ubicación automáticamente, que hará que el dispositivo vuelva a detectar automáticamente la ubicación si no pudo hacerlo la vez anterior.

Si la hora del dispositivo no está sincronizada con la hora actual, es posible que los horarios y las acciones no funcionen como se espera. Aparecerá un mensaje para informarle si la hora no está sincronizada.

• Autenticación : si habilita la autenticación, se le pedirá que introduzca una contraseña, que utilizará para acceder a la interfaz web del dispositivo. Una vez habilitada, para desactivarla, haga clic en el interruptor e introduzca su contraseña de autenticación cuando se le solicite.

• Firmware : en esta configuración, puedes ver el ID de tu dispositivo, la versión del firmware, el ID de compilación y el ID de compilación web. Usa el botón Copiar situado encima del ID del firmware o del ID de compilación web para copiar el contenido al portapapeles. También puedes ver las nuevas versiones disponibles, check si hay actualizaciones y actualizar fácilmente tu dispositivo. También existe la opción de cargar tu propio firmware; sin embargo, instalar firmware personalizado anula de forma irreversible la garantía del dispositivo.

• Certificado de usuario (configuración de TLS) : carga una autoridad certificadora personalizada, un certificado de cliente y una clave de cliente arrastrando y soltando los archivos o explorando tus archivos, lo que puedes hacer haciendo clic en el botón correspondiente. Haz clic en Cargar para cargar los archivos y en Limpiar para eliminar los archivos que no quieras cargar.

• Depuración : esta configuración incluye la depuración de Mqtt, Websocket y Udp. Para activar cualquiera de estas opciones, haz clic en el interruptor situado junto a la configuración correspondiente. Para la depuración de Udp, también se te pedirá que escribas una dirección Udp.

Scripts

Este dispositivo ofrece funciones de scripting. Puedes utilizarlas para personalizar y mejorar la funcionalidad del dispositivo según tus necesidades específicas. Estos scripts pueden tener en cuenta el estado del dispositivo, comunicarse con otros dispositivos o extraer datos de servicios externos, como las previsiones meteorológicas. Un script es un programa escrito en un subconjunto de JavaScript.

En la interfaz web, cuando vayas al menu Scripts, verás los scripts existentes o, si no tienes ninguno, podrás crear uno o abrir la biblioteca para explorar lo que ya está disponible. Junto a cada script que tengas, podrás ver su estado (si está ejecutándose o detenido) y un interruptor que te permite ejecutar el script al iniciar. Si tu script tiene errores, el último error guardado aparecerá debajo del nombre del script.

Cuando estés en la vista de edición del script, verás la consola debajo, así como cualquier error que aparezca. Encima del campo de código hay opciones para Guardar, Iniciar/Detener o Eliminar tu script. También puedes acceder a Fragmentos y Documentación haciendo clic en las etiquetas correspondientes.

Components

Creación de un componente

La configuración de Components permite al usuario crear Components dinámicos, que no existen inicialmente en el dispositivo. Los componentes virtuales, un tipo de componente dinámico, se utilizan para almacenar o transferir datos entre scripts o ejecuciones y mostrar la funcionalidad del script en la página de inicio. Los componentes se pueden agrupar; solo los grupos y los componentes que contienen se mostrarán en la página de inicio. Los componentes que no pertenezcan a un grupo no se visualizarán allí. El número de componentes y grupos de componentes por dispositivo es limitado.

Para crear un componente:

• Haz clic en el botón Create new junto a User-defined components.

• Selecciona el tipo de componente que quieres crear: Boolean, Number, Text, Enum o Botón. Al crearlo, cada tipo de componente tiene los campos Name, View y Custom Icon URL, que debes completar. El campo Custom Icon URL no es obligatorio, pero puede utilizarse para personalizar el aspecto de tus componentes en la página de inicio. Puedes cambiar el nombre o eliminar un componente, así como crear acciones para él, mediante los botones situados junto a cada componente.

Los distintos tipos de componentes pueden tener campos adicionales específicos de cada tipo. Se explican a continuación.

El tipo de componente Boolean almacena un valor verdadero/falso y tiene dos títulos diferentes que el usuario puede introducir según si su valor es verdadero o falso, además de dos iconos independientes. El menú desplegable del valor predeterminado incluirá los distintos estados de tu dispositivo. Las opciones de vista son Hidden, Toggle y Label. La vista Toggle muestra un botón de alternancia, por lo que el valor del componente cambia con cada pulsación. La vista Label muestra el título correspondiente al valor del componente.

El tipo de componente Number almacena valores entre -999999999999999 y 999999999999999. El valor predeterminado debe ser un número dentro de este rango. También puedes cambiar la unidad y el paso. Las opciones de vista son Hidden, Field, Slider, Progress bar y Label. La vista Field muestra un campo de entrada, la vista Label muestra el valor, la vista Progress bar representa visualmente el progreso y la vista Slider muestra una interfaz de control deslizante para interactuar con ella.

El tipo de componente Text almacena una cadena de hasta 255 caracteres. Las opciones de vista son Hidden, Field, Label e Image. La vista Field muestra un campo de entrada, la vista Label muestra el título y la vista Image requiere un valor de URL, que utiliza para mostrar una imagen.

El tipo de componente Enum almacena un grupo de constantes con nombre. Las opciones de vista son Hidden, Dropdown, y Label. Si seleccionas la vista Label, el componente mostrará el título de forma predeterminada, pero si se especifica una imagen, esta tendrá prioridad y se mostrará en su lugar.

El tipo de componente Botón proporciona una entrada virtual simulada que permite a los usuarios interactuar con la interfaz de usuario registrando e informando de los clics. Después envía notificaciones a través de los canales conectados y puede utilizarse para activar automatizaciones y webhooks. Cuenta con dos opciones de vista: Botón, que muestra el componente de botón en la página de inicio, y Hidden.

Si un componente está configurado como Oculto, no se mostrará en la página de inicio de hogar. De lo contrario, tus grupos de componentes aparecerán debajo de las entradas y/o salidas de tu dispositivo y mostrarán los componentes que forman parte de esos grupos.

Crear un grupo de componentes

Para crear un grupo:

• Haz clic en + junto a Grupos definidos por el usuario y accederás al menú de creación de grupos.

• Introduce el nombre del grupo.

• Selecciona los componentes que quieras incluir en ese grupo.

La edición del menú de tus grupos se realiza mediante el icono del lápiz situado junto a +, lo que permite cambiar el orden de los grupos haciendo clic en las flechas hacia arriba y hacia abajo para mover un grupo.

Acciones de componentes

El menú Acciones ahora está estructurado según el tipo de componente. Así, puedes crear acciones para tus componentes y se separarán en las cinco categorías mencionadas anteriormente.

Scripting

Los componentes se pueden incluir en scripts y programarse para cambiar sus valores en función de una condición. Para especificar un componente en un script, deberás utilizar su ID. Los ID de los componentes empiezan en 200 y están limitados a 299. Podrás ver el ID de tu componente en el menú Componentes.

Para este dispositivo en concreto, puedes tener hasta 20 componentes virtuales.

Componentes BTHome

Los componentes BTHome permiten crear componentes virtuales/dinámicos vinculados a dispositivos reales que emiten paquetes BTHome, como los dispositivos Shelly BLU. Para utilizar los componentes BTHome, primero debe establecerse correctamente una conexión Bluetooth. Aparecerá un mensaje para informarte si el observador de Bluetooth está desactivado, junto con un botón para activarlo y reiniciar tu dispositivo.

Una vez establecida la conexión, para añadir un dispositivo BTHome (Bluetooth), haz clic en el signo + junto a componentes BTHome. El dispositivo buscará dispositivos Bluetooth disponibles, pero puedes hacer clic en el botón Escanear para volver a buscar. Los dispositivos encontrados aparecerán debajo de ese botón. Para que un dispositivo se encuentre durante el escaneo, debe estar en modo de emparejamiento, lo que se consigue manteniendo pulsado el botón del dispositivo. Otra opción para añadir un dispositivo es utilizar una dirección MAC. Para ello, haz clic en Añadir dispositivo mediante dirección MAC e introduce la dirección MAC del dispositivo que quieras añadir.

Para añadir sensores, haz clic en Configurar junto al dispositivo Bluetooth que prefieras. En esta pantalla, puedes asignar un nombre a tu dispositivo BTHome (Bluetooth), añadir una clave de cifrado e introducir una URL de icono personalizada para personalizar el aspecto del componente BTHome en la página de inicio de hogar. La clave de cifrado se utiliza para descifrar los paquetes y se puede obtener mediante la aplicación Shelly BLU Debug .

Debajo del campo de la clave de cifrado aparecen los sensores compatibles, que puedes añadir haciendo clic en el signo + situado junto a los que quieras añadir. Una vez añadido un sensor, aparece un icono de lápiz junto a él; al hacer clic en él, puedes editar su nombre, añadir una URL de icono personalizada o utilizar el icono de la papelera para eliminarlo por completo.

Para guardar tu componente BTHome, haz clic en Guardar ajustes. Para eliminar un componente, haz clic en el icono de la papelera situado sobre los campos de text.

Para editar un componente BTHome, haz clic en el icono de la rueda dentada. Accederás a sus ajustes, que se encuentran en la misma pantalla que ves al añadir el componente.

Ajustes avanzados

Al hacer clic en la flecha situada junto a este ajuste, se mostrarán los ajustes avanzados. Se explican a continuación.

KVS

KVS significa almacenamiento de clave-valor y es un tipo de base de datos no relacional que utiliza un método sencillo de clave-valor para almacenar datos. En un dispositivo, puedes almacenar hasta 50 pares de clave-valor. Al hacer clic en el botón Añadir valor, accederás a la pantalla de creación de valores, donde se te pedirá introducir una clave (de hasta 42 caracteres) y un valor (de hasta 253 caracteres). Debajo del cuadro de text del valor, verás el tipo de valor actual. De forma predeterminada, el tipo de valor es número, pero al introducir text, el tipo cambiará a cadena. Para guardar la clave, solo tienes que hacer clic en el botón Guardar. Para editar un valor existente, solo tienes que hacer clic en él. Para eliminar un par de clave-valor, haz clic en el botón Eliminar que aparece debajo cuando accedes a la edición de la clave. Al hacer clic en el signo de interrogación situado junto al nombre del ajuste, accederás a la documentación de la API, que te proporcionará más información sobre el funcionamiento de KVS en los dispositivos Shelly.

Diagnóstico

Desde este ajuste, puedes descargar los registros de depuración. No se recomienda activar el log de depuración sin motivo, ya que ralentizará tu dispositivo y este ajuste provocará el desgaste de la memoria flash. Si decides activarlo, también podrás descargar los registros anteriores y actuales. Ten en cuenta que al salir de esta página se restablecerá el registrador y se borrarán los datos del log.

Ping HTTP

Introduce una URL en el campo de text designado para enviarle una solicitud HTTP desde tu dispositivo. La interfaz web te informará si la solicitud se realizó correctamente o falló.

Clientes del dispositivo

Consulta los dispositivos conectados a tu dispositivo, organizados en la categoría correspondiente. Hay dos opciones para la mayoría de los dispositivos:

• Clientes Bluetooth: dispositivos conectados a tu dispositivo mediante Bluetooth.

• Clientes AP: dispositivos conectados al punto de acceso de tu dispositivo.

En este menu, podrás ver información sobre los clientes.