Guía de la interfaz web de Shelly 1 Mini Gen3

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 en su ordenador o dispositivo móvil. Con ella, puede encender o apagar aparatos conectados al dispositivo, establecer programaciones y configurar acciones que se ejecuten cuando se cumplan determinadas condiciones.

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

Acceso a la interfaz web

Para acceder a la interfaz web:

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

  2. Después de establecer la 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.

Connectar el dispositivo a una red Wi-Fi

Algunos 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 connect a una red abierta seleccionando la casilla para connect a redes Wi-Fi abiertas. Además, se recomienda establecer una dirección IP estática.

  3. Espere unos segundos para que el dispositivo intente connect a la red Wi-Fi que proporcionó. Si la contraseña introducida es incorrecta o la red Wi-Fi no tiene suficiente intensidad o estabilidad, aparecerá un mensaje en la interfaz web informándole de que no se pudo establecer la conexión. Cuando la conexión a la red Wi-Fi se realice correctamente, aparecerá un enlace que contiene la nueva dirección IP como text encima de la configuración de Wi-Fi. Simplemente copie y pegue este enlace en el 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 connect a la misma red Wi-Fi que su dispositivo e introduzca 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 en esa dirección específica.

Comprender el diseño

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

Encabezado

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

En la parte inferior de la pantalla aparecen, de izquierda a derecha, 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 horarios y acciones no funcionen como se espera. Algunas versiones anteriores de la interfaz web no incluyen todos estos componentes.

Menú principal

El menú 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 menú de tipo hamburguesa, con un icono formado por tres líneas horizontales apiladas. El menú contiene diferentes 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 menú 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 menú principal, se considera contenido principal.

Como la interfaz de usuario puede cambiar con el tiempo, algunas capturas de pantalla pueden diferir ligeramente de lo que ves en la interfaz web del producto.

mini1g3-20241001-123315.png


Menú principalA continuación se explica cada ajuste del menú principal, incluido lo que se muestra como contenido principal al hacer clic en los diferentes ajustes. La explicación de la página de inicio también 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

En la interfaz web, verás cinco iconos en el encabezado, incluidos los de las conexiones AP, Wi-Fi, Bluetooth, Cloud y MQTT. Esto es lo que significan los diferentes colores de estado:

Icono de AP: Gris: el modo AP está desactivado. Azul: el modo AP está activado.Icono de Wi-Fi: Gris: La conexión Wi-Fi está desactivada. Blanco: La conexión Wi-Fi está activada, pero no establecida. Azul: El dispositivo está conectado a Wi-Fi.Icono de Bluetooth: Gris: La conexión está desactivada. Azul: La conexión está activada.Icono de la nube: Gris: La conexión a Shelly Cloud está desactivada. Blanco: La conexión a Shelly Cloud está activada, pero no establecida. Azul: 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.

Ajustes de salida

NombreNombra o cambia el nombre de la salida. Configuración de entrada/salidaSeleccionar modo de entrada:Botón: cada pulsación del botón alterna el estado de la salida del dispositivo.Interruptor: la posición del interruptor corresponde al estado de la salida del dispositivo.Analog (no disponible como opción en todos los dispositivos): mediante la entrada analógica, el dispositivo determina el porcentaje de brillo basándose en el porcentaje de la entrada.Establecer tipo de salida:Interruptor basculante (solo interruptor): el dispositivo funcionará como un interruptor con una posición para ENCENDIDO y otra para APAGADO. Si la entrada está en modo analógico, el dispositivo seguirá el estado de la entrada analógica.Interruptor momentáneo (solo botón): cada pulsación del botón alterna el estado de la salida del dispositivo. Si el interruptor está ENCENDIDO, se APAGARÁ, y viceversa. Interruptor de flanco (solo interruptor): cada cambio de posición del interruptor alterna el estado de la salida del dispositivo.Interruptor desconectado: la entrada se desconecta de la salida y no tiene ningún efecto sobre ella. En esencia, no podrás controlar la luz mediante la entrada.Acción al encender:Esta opción se utiliza normalmente cuando se produce un corte de suministro eléctrico; «encendido» se refiere al momento en que se restablece la electricidad y el dispositivo vuelve a recibir alimentación.Encender: cuando reciba alimentación, el dispositivo se encenderá.Apagar: cuando reciba alimentación, el dispositivo estará apagado.Restaurar el último estado conocido de la salida/relé: cuando reciba alimentación, la salida tendrá el mismo estado que la última vez que el dispositivo estuvo ENCENDIDO (antes de la interrupción del suministro eléctrico).Estado actual del interruptor (solo interruptor basculante): sigue el estado del interruptor; si se cambia a ENCENDIDO, el dispositivo se encenderá, y lo mismo se aplica cuando el interruptor se cambia a APAGADO.

Tipo de consumoEste ajuste es relevante al integrar el dispositivo con sistemas de automatización del hogar de terceros. Su finalidad es especificar la información o configuración necesaria para que el sistema externo interactúe con el dispositivo.Cuando utilices sistemas de automatización del hogar de terceros para controlar el dispositivo, se recomienda consultar su documentación o guía del usuario para determinar qué debes introducir en este campo. La documentación del sistema de terceros normalmente especificará los parámetros, las credenciales o cualquier otro detalle necesario que deba proporcionarse para establecer la comunicación entre dicho sistema y el dispositivo Shelly.Sin embargo, si utilizas el dispositivo exclusivamente con la aplicación Shelly, puedes ignorar el campo Tipo de consumo externo. La aplicación no requiere ninguna configuración adicional al respecto, ya que cuenta con sus propios mecanismos integrados para comunicarse con el dispositivo y controlarlo.Si, por cualquier motivo, deseas quitar o eliminar el tipo de consumo externo de los ajustes del dispositivo, puedes hacerlo simplemente dejando vacío el campo Tipo de consumo externo y haciendo clic en el botón Guardar ajustes. De este modo, desactivas el tipo de consumo externo y restauras el comportamiento predeterminado del dispositivo o dependes exclusivamente de la aplicación Shelly para el control y la automatización.

Acciones

Configura las acciones del dispositivo: crea acciones nuevas, edita las existentes o elimínalas. Al crear acciones para el dispositivo, deberás especificar la condición en la que se ejecuta la acción. También puedes establecer una duración para las acciones, así como una URL a la que se enviará una solicitud cuando se cumpla la condición de la acción.

Programaciones

Esta función requiere una conexión a Internet activa para que el dispositivo pueda sincronizar la hora. Permite crear, ver, editar y eliminar programaciones.

Hay dos tipos de programaciones: Básica y Avanzada.

Para crear un horario basic:

  • Selecciona los días de la semana.

  • Elige un intervalo de tiempo: hora, amanecer o atardecer.

  • Establece la hora para los días especificados:

    • Hora: Haz clic en el botón de subir/bajar o introduce un número para establecer una hora en horas y minutos.

    • Atardecer/amanecer: El dispositivo Shelly puede activarse/desactivarse (o realizar la acción especificada) automáticamente al amanecer/atardecer, o a una hora especificada antes o después del amanecer/atardecer. Haz clic en el botón de subir/bajar o introduce un número para establecer una hora en horas y minutos.

Para crear un horario advanced :

La función de horario avanzado usa cron para ejecutar tareas con un único horario, en lugar de usar varios horarios básicos.

Crear un horario avanzado difiere de crear un horario básico debido al menú When to execute.

Te solicita seleccionar uno o varios valores, un intervalo de valores o un paso entre valores (elige una de las tres opciones haciendo clic en el botón Select, Range o Step para cada valor) para:

  • Segundos (0-59)

  • Minutos (0-59)

  • Horas (0-23)

  • Días (1-31)

  • Meses (JAN-DEC)

  • Días laborables (SUN-SAT)

Para crear un horario que se repita cada segundo/minuto/hora/día/mes/día laborable, simplemente marca la casilla situada debajo de los valores en la sección correspondiente (segundos, minutos, horas, días, meses o días laborables). Además, puedes usar el desfase respecto al amanecer/atardecer marcando la casilla situada junto a esta opción. Al hacerlo, aparecerá un nuevo menú con horas y minutos. Si dejas las horas y los minutos sin especificar y seleccionas amanecer o atardecer, el horario se ejecutará exactamente al amanecer o al atardecer. Cambiar los valores de horas y minutos creará un desfase: introducir valores negativos hará que el horario se ejecute exactamente [set hours and/or minutes] antes del amanecer/atardecer, mientras que introducir valores positivos hará que el horario se ejecute [set hours and/or minutes] después del amanecer/atardecer. No puedes introducir un valor positivo para uno (horas/minutos) y uno negativo para el otro.

Después, simplemente especifica la acción que quieres que realice tu dispositivo en la sección Actions . Haz clic en Save cuando hayas terminado para guardar el nuevo horario.

En el menú Schedules, puedes ver todos tus horarios. Puedes elegir ver cada uno con la hora básica o avanzada. La hora básica muestra la hora y los días en que se ejecuta el horario, mientras que la hora avanzada muestra un texto en la tarjeta del horario que indica que debes hacer clic en ella para obtener más información.

Ambas vistas muestran las acciones en la parte superior. Si hay más de tres acciones, se muestran como +n, donde n es el número restante de acciones que no se muestran. Para activar o desactivar un horario, usa el botón de alternancia de la derecha.

Temporizadores

Permite gestionar automáticamente el suministro eléctrico. Puedes usar:

  • Encendido automático: después de apagarse, la salida del relé se encenderá automáticamente tras un periodo predefinido (en segundos).

  • Apagado automático: después de encenderse, la salida del relé se apagará automáticamente tras un periodo predefinido (en segundos).

Configuración de entrada

Nombre

Asigna un nombre o cambia el nombre de la entrada.

Activar

Activa o desactiva la entrada marcando o desmarcando la casilla.

Configuración de entrada/salidaSeleccionar modo de entrada:Botón: cada pulsación del botón alterna el estado de la salida del dispositivo.Interruptor: la posición del interruptor corresponde al estado de la salida del dispositivo.Analog (no disponible como opción en todos los dispositivos): mediante la entrada analógica, el dispositivo determina el porcentaje de brillo basándose en el porcentaje de la entrada.Establecer tipo de salida:Interruptor basculante (solo interruptor): el dispositivo funcionará como un interruptor con una posición para ENCENDIDO y otra para APAGADO. Si la entrada está en modo analógico, el dispositivo seguirá el estado de la entrada analógica.Interruptor momentáneo (solo botón): cada pulsación del botón alterna el estado de la salida del dispositivo. Si el interruptor está ENCENDIDO, se APAGARÁ, y viceversa. Interruptor de flanco (solo interruptor): cada cambio de posición del interruptor alterna el estado de la salida del dispositivo.Interruptor desconectado: la entrada se desconecta de la salida y no tiene ningún efecto sobre ella. En esencia, no podrás controlar la luz mediante la entrada.Acción al encender:Esta opción se utiliza normalmente cuando se produce un corte de suministro eléctrico; «encendido» se refiere al momento en que se restablece la electricidad y el dispositivo vuelve a recibir alimentación.Encender: cuando reciba alimentación, el dispositivo se encenderá.Apagar: cuando reciba alimentación, el dispositivo estará apagado.Restaurar el último estado conocido de la salida/relé: cuando reciba alimentación, la salida tendrá el mismo estado que la última vez que el dispositivo estuvo ENCENDIDO (antes de la interrupción del suministro eléctrico).Estado actual del interruptor (solo interruptor basculante): sigue el estado del interruptor; si se cambia a ENCENDIDO, el dispositivo se encenderá, y lo mismo se aplica cuando el interruptor se cambia a APAGADO. InvertirEsta opción permite invertir la lógica de la señal de entrada, invirtiendo efectivamente el comportamiento del dispositivo. De forma predeterminada, cuando la señal de entrada está ACTIVADA, el dispositivo responde ACTIVÁNDOSE. Cuando la señal de entrada está DESACTIVADA, el dispositivo se APAGA.Sin embargo, si activas la opción «Invertir entrada», ocurrirá lo contrario. Cuando la señal de entrada está ACTIVADA, el dispositivo se APAGARÁ, y cuando la señal de entrada está DESACTIVADA, el dispositivo se ENCENDERÁ. Esta opción puede ser útil en situaciones en las que sea necesario invertir el comportamiento del dispositivo. Restablecimiento de fábricaHabilitar esta configuración permitirá restablecer el dispositivo a los valores de fábrica desde su entrada, y no solo mediante la aplicación o la interfaz web.

Configuración

Configuración de red

  • Punto de acceso y extensor de alcance : configura el punto de acceso (AP) del dispositivo seleccionando la casilla Habilitar punto de acceso y estableciendo una contraseña para proteger tu 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. Habilita la función Extensor de alcance marcando 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 habilitado está conectado a un router Wi-Fi y a Internet, todos los dispositivos conectados a él también estarán conectados al router y a Internet.
    Aunque el dispositivo Shelly no esté conectado a un router 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 AP conectados: cuántos hay, su configuración IP, su dirección MAC y sus 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.

    Habilita 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 habilitadas y el dispositivo Shelly se desconecta de una de las redes, se conectará a la otra. Solo es posible habilitar Wi-Fi una vez configurado el nombre de la red (SSID). Si el dispositivo no tiene otras conexiones disponibles (AP, Bluetooth, Ethernet (si corresponde) o una segunda red Wi-Fi), al intentar deshabilitar Wi-Fi aparecerá una ventana emergente que te preguntará si deseas continuar.

  • Bluetooth: deshabilita o habilita Bluetooth activando o desactivando el interruptor. La configuración predeterminada de Bluetooth del dispositivo está habilitada.

Conectividad

Nota sobre la comunicación RPC: cuando una llamada RPC no se ejecuta correctamente, aparece un mensaje en un 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.

  • Nube : conectar tu Shelly a la nube te permite controlarlo de forma remota y recibir notificaciones y actualizaciones sobre tus dispositivos. Esta configuración está habilitada de forma predeterminada. Si deshabilitas la compatibilidad del dispositivo con la nube, ¡perderás la conexión con tu dispositivo desde fuera de su red local!

  • MQTT: configura el dispositivo Shelly para ejecutar acciones mediante MQTT. De forma predeterminada, MQTT está desactivado, pero puedes activarlo seleccionando la casilla de verificación vacía. Cambiar estos ajustes hará que el dispositivo se reinicie. También hay otros ajustes, como Notificaciones de estado RPC mediante MQTT (que permite comunicarte con tu dispositivo mediante notificaciones RPC) y Actualización de estado genérica mediante MQTT (para obtener una actualización general del estado), que puedes activar o desactivar. También puedes activar SSL e introducir el servidor, nombre de usuario y 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 aún la utiliza. De forma predeterminada, este ajuste está desactivado. Para activarlo, haz clic en el interruptor situado junto a Activar. Introduce la dirección de tu servicio en el cuadro de texto y, en el menú desplegable de Conectividad SSL, selecciona *, ca.pem o user_ca.pem.

  • RPC sobre UDP: comunícate con tu dispositivo y envía 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 tu dispositivo de forma remota, sin necesidad de un servidor o conexión dedicados.

    Para utilizar este ajuste, tendrás que 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 hayas introducido la información necesaria, puedes utilizar el protocolo RPC sobre UDP para enviar solicitudes a tu dispositivo y recibir respuestas.

Ajustes del dispositivo

  • Nombre del dispositivo (info) : consulta el ID de tu 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 te preguntará si estás seguro de que deseas reiniciar el dispositivo. Haz clic en Aceptar para reiniciar el dispositivo y en Cancelar si no deseas hacerlo.

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

  • Ubicación y zona horaria : tu zona horaria y ubicación se detectarán automáticamente, pero puedes cambiarlas manualmente desde este ajuste seleccionando una zona horaria en el menú desplegable e introduciendo tu 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 las programaciones y las acciones no funcionen como se espera. Aparecerá un mensaje para informarte si la hora no está sincronizada.

  • Autenticación : si activas la autenticación, se te pedirá que introduzcas una contraseña, que usarás para acceder a la interfaz web del dispositivo. Una vez activada, para desactivarla, haz clic en el interruptor e introduce tu contraseña de autenticación cuando se te 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 versiones nuevas disponibles, buscar actualizaciones y actualizar fácilmente tu dispositivo. También existe la opción de cargar tu propio firmware; sin embargo, instalar firmware personalizado anula irreversiblemente la garantía del dispositivo.

  • Certificado de usuario (configuración 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 designado. Haz clic en Cargar para cargar los archivos y en Borrar para eliminar los archivos que no quieras cargar.

  • Modo Eco : reduce el consumo de energía del dispositivo disminuyendo la frecuencia de la CPU y la actividad del módem mientras está en modo Eco. Para activar esta configuración, haz clic en el interruptor situado junto a Activar el modo Eco y, después, haz clic en el botón Aplicar para guardar los cambios.

  • 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 específica. Para la depuración de Udp, también se te pedirá que escribas una dirección Udp.

Scripts

Este dispositivo incluye funciones de scripting. Puedes utilizarlas para personalizar y mejorar la funcionalidad del dispositivo según las necesidades específicas del usuario. 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, al acceder 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á en ejecución o detenido) y un interruptor que te permite ejecutar el script al iniciar. Si tu script tiene algún error, el último error guardado se mostrará 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 el script. También puedes acceder a Fragmentos y Documentación haciendo clic en las etiquetas correspondientes.

Componentes

Crear un componente

La configuración de Componentes permite al usuario crear Componentes dinámicos, que inicialmente no existen 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 pueden agruparse; en la página de inicio solo se mostrarán los grupos y los componentes que contienen. 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 Crear new junto a Componentes definidos por el usuario.

  • Selecciona el tipo de componente que quieres crear: Booleano, Número, Texto, Enumeración o Botón. Al crearse, cada tipo de componente tiene los campos Nombre, Vista y URL del icono personalizado, que debes completar. El campo URL del icono personalizado 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, utilizando 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 Booleano 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 Oculto, Interruptor y Etiqueta. La vista Interruptor muestra un botón de alternancia, por lo que el valor del componente cambia con cada pulsación. La vista Etiqueta muestra el título correspondiente al valor del componente.

El tipo de componente Número 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 Oculto, Campo, Control deslizante, barra de progreso y Etiqueta. La vista Campo muestra un campo de entrada, la vista Etiqueta muestra el valor, la vista Barra de progreso representa visualmente el progreso y la vista Control deslizante muestra una interfaz de control deslizante para interactuar.

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 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. Ofrece 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 Hidden, no se mostrará en la página de inicio. 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.

Creación de un grupo de componentes

Para crear un grupo:

  • Haz clic en + junto a User-defined groups y accederás al menu de creación de grupos.

  • Introduce el nombre del grupo.

  • Selecciona los componentes que quieras incluir en ese grupo.

La edición del menu de tus grupos se realiza mediante el icono del lápiz situado junto a + y 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 menu de acciones ahora está estructurado según el tipo de componente. Así, puedes crear acciones para tus componentes y estas 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, debes usar su ID. Los ID de los componentes comienzan en 200 y están limitados a 299. Podrás ver el ID de tu componente en el menu Components.

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 usar componentes BTHome, primero debe establecerse una conexión Bluetooth correctamente. 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á los dispositivos Bluetooth disponibles, pero puedes hacer clic en el botón Buscar para volver a buscar. Los dispositivos encontrados aparecerán debajo de ese botón. Para que un dispositivo se encuentre durante la búsqueda, 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. 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 + junto a los que quieras añadir. Una vez añadidos, aparece un icono de lápiz junto al sensor; al hacer clic en él, puedes editar su nombre, añadir una URL de icono personalizada o utilizar el icono de la papelera para eliminar el sensor por completo.

Para guardar tu componente BTHome, haz clic en Guardar configuración. Para eliminar un componente, haz clic en el icono de la papelera situado encima de los campos de text.

Para editar un componente BTHome, haz clic en el icono de la rueda dentada. Accederás a su configuración, que es la misma pantalla que ves al añadir el componente.

KNX

KNX es un protocolo de comunicación estandarizado para la automatización de edificios. Se utiliza para controlar y gestionar diversos aspectos de los sistemas de un edificio, incluidos iluminación, calefacción, ventilación, seguridad, gestión energética y mucho más. KNX permite que distintos dispositivos y sistemas de diferentes fabricantes se comuniquen entre sí a través de una red común.

General

Para usar KNX, haz clic en la marca de verificación junto a Habilitar. A continuación, introduce una dirección individual única para tu dispositivo en la red KNX.

En la configuración de Multicast, introduce la dirección IP (denominada Dirección) del grupo multicast con el que quieres que se comunique tu dispositivo. Las direcciones van de 224.0.0.0 a 239.255.255.255. El ajuste Puerto designa el número de puerto dentro de ese grupo multicast donde tiene lugar la comunicación. Juntos, definen el destino de los mensajes multicast dentro de una red.

Entradas

Según el dispositivo, tendrás un número diferente de entradas en este menú. Para cada entrada, selecciona un estado de entrada, que puede ser Switch o Botón, o, específicamente para dispositivos con regulación, Single-button dimming o Dual-button dimming.

Debajo, según el estado de entrada seleccionado anteriormente, verás uno o más objetos, así como texto a la derecha del objeto que identifica su tamaño y tipo de datos. Para los distintos modos de entrada, son:

  • Interruptor - Tiene un objeto, denominado Switch object, con un tamaño de 1 bit y un DPT (tipo de punto de datos) 1.001, que corresponde a un tipo de interruptor con dos estados: encendido/apagado (1/0). Puedes añadir hasta tres objetos Switch mediante el botón Añadir .

  • Botón - Primero, selecciona una función para el botón: ON, OFF o Toggle. El estado de entrada del botón tiene dos objetos: un objeto Single-push y un objeto Feedback. Puedes añadir hasta tres objetos Single-push mediante el botón Añadir y un objeto Feedback. Ambos son de tipo Switch, tienen un tamaño de 1 bit y un DPT (tipo de punto de datos) 1.001, que corresponde a un tipo de interruptor con dos estados: encendido/apagado (1/0). El objeto Feedback puede ser el mismo que el objeto Single-push o tener otra dirección. Para ello, desmarca la opción Same as Single-push object e introduce una nueva dirección.

  • Regulación con un solo botón - Primero, selecciona un paso de regulación, desde regulación completa hasta regulación de 1/64. Esto cambia la velocidad de regulación. La regulación completa será la más rápida porque regulará del 0 al 100 % a la velocidad establecida, mientras que la regulación de 1/64 regulará 1/64 de la regulación completa durante el mismo tiempo. Este estado de entrada tiene tres objetos: Single-push, Long-push y Feedback. Puedes añadir hasta tres objetos Single-push y Long-push mediante el botón Añadir , y un objeto Feedback, que puede ser el mismo que el objeto Single-push o tener otra dirección. Para ello, desmarca la opción Same as Single-push object e introduce una nueva dirección. Los objetos Single-push y Feedback son de tipo Switch, tienen un tamaño de 1 bit y un DPT (tipo de punto de datos) 1.001, que corresponde a un tipo de interruptor con dos estados: encendido/apagado (1/0). El objeto Long-push se utiliza para controlar la regulación; tiene un tamaño de 4 bits y un DPT (tipo de punto de datos) 3.007. El objeto Control Dimming consta de dos valores: uno que indica un aumento (1) o una disminución (0), y otro correspondiente al paso.

  • dimming con dos botones - Primero, seleccione un paso de dimming, desde dimming completo hasta dimming de 1/64. Esto cambia la velocidad de dimming. El dimming completo será el más rápido porque atenuará del 0 al 100 % a la velocidad establecida, mientras que el dimming de 1/64 atenuará 1/64 del dimming completo durante el mismo tiempo. A continuación, seleccione la dirección del dimming: arriba/encender o abajo/apagar. Este estado de entrada tiene dos objetos: un objeto de pulsación corta y uno de pulsación larga. Puede añadir hasta tres objetos de pulsación corta y de pulsación larga mediante el botón Añadir . El objeto de pulsación corta es de tipo Switch, tiene un tamaño de 1 bit y un DPT (tipo de punto de datos) 1.001, que corresponde a un tipo de interruptor con dos estados: encendido/apagado (1/0). El objeto de pulsación larga sirve para controlar el dimming, tiene un tamaño de 4 bits y un DPT (tipo de punto de datos) de 3.007. El objeto Controlar el dimming consta de dos valores: uno que indica un aumento (1) o una disminución (0), y otro que corresponde al paso.

Salidas

El menu de salidas está dividido en tres secciones: Comandos, Respuestas y Mediciones. Para cada tipo de objeto de la sección Comandos, puede haber hasta cinco objetos. Estos son los tipos de objetos que tiene cada sección:

Comandos:

  • Objeto de interruptor - Tiene un tamaño de 1 bit y un DPT de 1.001, que corresponde a un tipo de interruptor con dos estados: encendido/apagado (1/0).

Respuestas:

  • Objeto de respuesta - Tiene un tamaño de 1 bit y un DPT de 1.001, que corresponde a un tipo de interruptor con dos estados: encendido/apagado (1/0). El objeto de respuesta se utiliza para informar del estado del dispositivo.

Mediciones (Estos tipos de objeto tienen un tamaño de 4 bytes.):

  • Objeto de tensión - Tiene un DPT de 14.027, que corresponde a un objeto de potencial eléctrico de tipo Double con tres valores.

  • Objeto de corriente - Tiene un DPT de 14.019, que corresponde a un objeto de corriente eléctrica de tipo Double con tres valores.

  • Objeto de potencia activa - Tiene un DPT de 14.056, que corresponde a un objeto de potencia de tipo Double con tres valores.

  • Objeto de energía activa - Tiene un DPT de 13.010, que corresponde a un objeto de energía activa de tipo long, medido en vatios-hora.

Según el dispositivo, es posible que haya tipos adicionales de objetos en las secciones, como:

Comandos:

  • Objeto de dimming relativo: tiene un tamaño de 4 bits y un DPT de 3.007, que corresponde a un objeto de control de dimming formado por dos valores: uno que indica un aumento (1) o una disminución (0), y otro correspondiente al paso.

  • Objeto de dimming absoluto: tiene un tamaño de 1 byte y un DPT de 5.001, que corresponde a un objeto de escala formado por un valor del 1 al 100 para representar un porcentaje.

Mediciones (Estos tipos de objeto tienen un tamaño de 4 bytes):

  • Objeto de energía generada: tiene un DPT de 13.010, que corresponde a un objeto de energía activa de tipo long, medido en vatios-hora.

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 funciona mediante 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á que introduzcas una clave (de hasta 42 caracteres) y un valor (de hasta 253 caracteres). Verás que debajo del cuadro de text del valor aparece 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 logs de depuración. No se recomienda activar el log de depuración sin un 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 logs 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, ordenados 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.