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

Descripción general

Los dispositivos Shelly proporcionan una interfaz web local que te permite controlar y configurar tus dispositivos mediante un navegador web estándar en tu ordenador o dispositivo móvil. Con ella, puedes encender o apagar appliances conectados a tu dispositivo, establecer programaciones y configurar acciones que se ejecuten cuando se cumplan determinadas condiciones.

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

Acceder a la interfaz web

Para acceder a la interfaz web:

1. Connecta tu dispositivo a una red Wi-Fi con un nombre (SSID) que siga este formato: "DeviceName-XXXXXXXXXX", donde «DeviceName» es el nombre del dispositivo al que quieres 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 una conexión con el punto de acceso / AP del dispositivo (la red Wi-Fi mencionada en el paso 1), accede a la interfaz web introduciendo en tu navegador la dirección IP universal de todos los dispositivos Shelly: 192.168.33.1.

Ahora estás en la interfaz web de tu dispositivo.

Connectar tu dispositivo a una red Wi-Fi

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

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

2. Introduce o selecciona tu red Wi-Fi preferida y, a continuación, introduce su contraseña. Como alternativa, también puedes 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. Espera unos segundos para que tu dispositivo intente connect a la red Wi-Fi que proporcionaste. Si la contraseña que introdujiste es incorrecta, o la red Wi-Fi no tiene suficiente intensidad o estabilidad, aparecerá un mensaje en la interfaz web para informarte de que no se pudo establecer la conexión. Tras connect correctamente a la red Wi-Fi, aparecerá un enlace que contiene la nueva dirección IP como text encima de la configuración de Wi-Fi. Simplemente copia y pega este enlace en tu navegador.

Ahora estás en la interfaz web de tu dispositivo conectado a Internet. La próxima vez que necesites acceder a la interfaz web, simplemente connect a la misma red Wi-Fi que tu dispositivo e introduce la nueva dirección IP obtenida en el paso 3. Se recomienda establecer una dirección IP estática porque garantiza un acceso constante en esa dirección específica.

Comprender la distribución

La interfaz web se puede dividir en cuatro secciones principales: encabezado, pie de página, menu principal y 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 actualización de firmware new 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 explican únicamente 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 horarios 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 accederás a una página diferente. También puedes usarlo 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 aparece 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 visualiza como contenido principal al hacer clic en los distintos 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 seis iconos en el encabezado, incluido uno para cada conexión de 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 con Shelly Cloud está desactivada. Blanco: la conexión con 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.

La salida y la entrada se muestran en la página home, y al hacer clic en ellas se mostrará un conjunto de ajustes específicos que se explican a continuación.

Configuración de la salida

NombreNombra o cambia el nombre de la salida. Configuración de entrada/salidaSeleccionar el 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. Analógica (no disponible como opción en todos los dispositivos): mediante la entrada analógica, el dispositivo determina el porcentaje de brillo según el porcentaje de la entrada.Establecer el tipo de salida:Interruptor basculante (solo interruptor): el dispositivo funcionará como un interruptor con una posición de ACTIVADO y otra de DESACTIVADO. 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á ACTIVADO, se DESACTIVARÁ, 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 separa de la salida y no tiene ningún efecto sobre ella. En esencia, no podrás controlar la luz a través de la entrada.Acción al encender:Esta configuración se utiliza normalmente cuando se produce un corte de suministro eléctrico, y «encendido» se refiere al momento en que se restablece la electricidad y el dispositivo vuelve a recibir alimentación.ACTIVAR: cuando recibe alimentación, el dispositivo se enciende. DESACTIVAR: cuando recibe alimentación, el dispositivo permanece apagado. Restaurar el último estado conocido de la salida/relé: cuando recibe alimentación, el estado de la salida será el mismo que la última vez que el dispositivo estuvo ACTIVADO (antes de la pérdida de alimentación). Estado actual del interruptor (solo interruptor basculante): sigue el estado del interruptor; si está en ACTIVADO, el dispositivo se encenderá, y lo mismo se aplica cuando el interruptor está en DESACTIVADO.

Tipo de consumoEsta configuración 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é se debe introducir en este campo. La documentación del sistema de terceros normalmente indicará los parámetros, credenciales u otros datos necesarios que deben 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 algún motivo deseas eliminar el tipo de consumo externo de la configuración del dispositivo, puedes hacerlo dejando vacío el campo Tipo de consumo externo y haciendo clic en el botón Guardar configuración. De este modo, desactivas eficazmente el tipo de consumo externo y restableces el comportamiento predeterminado del dispositivo o haces que dependa exclusivamente de la aplicación Shelly para el control y la automatización. Protecciones:

• Exceso de potencia en vatios: configura el relé del interruptor Shelly para que se apague cuando el consumo de potencia alcance un valor determinado. El valor máximo de potencia permitido es igual a la corriente máxima multiplicada por el voltage máximo.

Sobrecorriente en amperios: si la corriente de suministro supera un valor determinado, el canal se apagará.Sobretensión en voltios: si el voltage de suministro supera un valor determinado, el canal se apagará.
Restablecer contadoresEstablece todas las lecturas de entrada en 0.

Acciones

Configura las acciones de tu dispositivo: crea acciones nuevas, edita las existentes o elimina acciones. Al crear acciones para tu dispositivo, deberás especificar la condición en la que se ejecutará la acción. También puedes establecer una duración para tus acciones, así como una URL a la que se accederá cuando se cumpla la condición de la acción.

Horarios

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

Hay dos tipos de horarios: Básico y Avanzado.

Para crear un horario básico:

• Selecciona los días de la semana.

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

• Establece la hora para los días especificados:

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

  • Amanecer/Anochecer: El dispositivo Shelly puede encenderse/apagarse (o realizar la acción especificada) automáticamente al amanecer/anochecer, o a una hora especificada antes o después del amanecer/anochecer. Haz clic en el botón arriba/abajo o introduce un número para establecer una hora en horas y minutos.

Para crear un horario avanzado :

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

Crear un horario avanzado difiere de crear un horario básico debido al menu Cuándo ejecutar.

Te pide 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 Seleccionar, Intervalo o Paso para cada valor) para:

• Segundos (0-59)

• Minutos (0-59)

• Horas (0-23)

• Días (1-31)

• Meses (JAN-DEC)

• Días de la semana (SUN-SAT)

Para crear un horario que se repita cada segundo/minuto/hora/día/mes/día de la semana, simplemente marca la casilla situada debajo de los valores en la sección deseada (segundos, minutos, horas, días, meses o días de la semana). También puedes usar el desfase respecto al amanecer/anochecer marcando la casilla situada junto a esta opción. Al hacerlo, aparecerá un nuevo menu con horas y minutos. Si dejas las horas y los minutos sin modificar y seleccionas amanecer o anochecer, el horario se ejecutará exactamente al amanecer o al anochecer. 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/anochecer, mientras que introducir valores positivos hará que el horario se ejecute [set hours and/or minutes] después del amanecer/anochecer. 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 Acciones . Haz clic en Guardar cuando hayas terminado para guardar el nuevo horario.

En el menu Programaciones, puedes ver todas tus programaciones. Puedes elegir ver cada una con la hora básica o avanzada. La hora básica muestra la hora y los días en que se ejecuta la programación, mientras que la hora avanzada muestra un texto en la tarjeta de programación que indica que debes hacer clic en ella para obtener más información.

Ambas vistas muestran las acciones anteriores. 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 una programación, 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 a la entrada o cambia su nombre.

Activar

Activa o desactiva la entrada marcando o desmarcando la casilla.

Configuración de entrada/salidaSeleccionar el 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. Analógica (no disponible como opción en todos los dispositivos): mediante la entrada analógica, el dispositivo determina el porcentaje de brillo según el porcentaje de la entrada.Establecer el tipo de salida:Interruptor basculante (solo interruptor): el dispositivo funcionará como un interruptor con una posición de ACTIVADO y otra de DESACTIVADO. 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á ACTIVADO, se DESACTIVARÁ, 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 separa de la salida y no tiene ningún efecto sobre ella. En esencia, no podrás controlar la luz a través de la entrada.Acción al encender:Esta configuración se utiliza normalmente cuando se produce un corte de suministro eléctrico, y «encendido» se refiere al momento en que se restablece la electricidad y el dispositivo vuelve a recibir alimentación.ACTIVAR: cuando recibe alimentación, el dispositivo se enciende. DESACTIVAR: cuando recibe alimentación, el dispositivo permanece apagado. Restaurar el último estado conocido de la salida/relé: cuando recibe alimentación, el estado de la salida será el mismo que la última vez que el dispositivo estuvo ACTIVADO (antes de la pérdida de alimentación). Estado actual del interruptor (solo interruptor basculante): sigue el estado del interruptor; si está en ACTIVADO, el dispositivo se encenderá, y lo mismo se aplica cuando el interruptor está en DESACTIVADO. InvertirEsta configuració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 activa la configuració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 configuración puede ser útil en situaciones en las que sea necesario invertir el comportamiento del dispositivo. Restablecimiento de fábricaAl activar esta configuración, podrá 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 : configure 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. El punto de acceso del dispositivo es una red abierta de forma predeterminada. El SSID es único y no se puede cambiar. Active la función Extensor de alcance marcando la casilla. El extensor de alcance crea un punto de acceso al que puede connectar dispositivos Wi-Fi. Si un dispositivo Shelly con el extensor de alcance activado está conectado a un router Wi-Fi y a Internet, todos los dispositivos connectados a él también estarán connectados al router y a Internet.
  Aunque el dispositivo Shelly no esté conectado a un router Wi-Fi, todos los dispositivos connectados a él pueden seguir comunicándose con él y entre sí. Debajo se muestra información sobre los clientes AP connectados: cuántos hay, así como su configuración IP, dirección MAC y direcciones IP internas y externas.

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

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

  Active 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 activadas y el dispositivo Shelly se desconecta de una de las redes, se connectará 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) o una segunda red Wi-Fi), al intentar desactivar Wi-Fi aparecerá una ventana emergente que le preguntará si desea continuar.

• Bluetooth: desactive o active Bluetooth mediante el interruptor. La configuración predeterminada de Bluetooth del dispositivo está activada.

Conectividad

Nota para la comunicación RPC: Cuando una llamada RPC no se puede ejecutar, aparece un mensaje en forma de banner que le notifica que el dispositivo no responde a tiempo y ha perdido la conexión. Cuando se restablezca la conexión, la solicitud se enviará de nuevo.

• Nube : conectar tu Shelly a su nube te permite controlarlo de forma remota y recibir notificaciones y actualizaciones sobre tus dispositivos. De forma predeterminada, la nube está activada. Si desactivas 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 te permite comunicarte con tu dispositivo mediante notificaciones 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 genera una excepción de E/S cuando se cierra una conexión entrante mientras el servlet aún la está utilizando. 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 situado bajo Conectividad SSL, elige *, ca.pem o user_ca.pem.

• RPC sobre UDP: comunícate con tu dispositivo y envía solicitudes mediante un servidor de llamada a procedimiento remoto (RPC) sobre el 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 una conexión específicos.

  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 del 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 quieres reiniciar el dispositivo. Haz clic en Aceptar para reiniciar el dispositivo y en Cancelar si no quieres reiniciarlo.

• Restablecimiento de fábrica : al hacer clic en el botón Restablecer, todos los ajustes del dispositivo se restablecerán a los valores predeterminados. Se revertirán todos los cambios que hayas realizado. Puedes confirmar que quieres 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 : tu zona horaria y ubicación se detectarán automáticamente, pero puedes cambiarlas manualmente desde esta configuración seleccionando una zona horaria en el menu 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 los horarios 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 después 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 del 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, buscar actualizaciones y actualizar fácilmente el dispositivo. También hay una opción para 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 explorándolos en tus archivos mediante el botón correspondiente. Haz clic en Cargar para cargar los archivos y en Limpiar 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á activado el 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 correspondiente. Para la depuración de Udp, también se te pedirá que introduzcas una dirección Udp.

Scripts

Este dispositivo ofrece funciones de scripting. Puedes usarlas 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 permitirá ejecutar el script al iniciar. Si tu script tiene errores, 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 Save, Start/Stop o Delete del script. También puedes acceder a Snippets y Docs haciendo clic en las etiquetas correspondientes.

Components

Creación de un componente

La configuración Components permite al usuario crear Dynamic Components, 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 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 Create new situado junto a User-defined components.

• Selecciona el tipo de componente que quieres crear: Boolean, Number, Text, Enum o Button. Al crearse, 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.

El tipo de componente Text almacena una cadena de hasta 255 caracteres. Las opciones de visualización 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 visualización son Hidden, Dropdown, y Label. Si selecciona 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 Button proporciona una entrada virtual simulada que permite a los usuarios interactuar con la interfaz registrando e informando de los clics. A continuación, envía notificaciones a través de los canales conectados y puede utilizarse para activar automatizaciones y webhooks. Ofrece dos opciones de visualización: Button, que muestra el componente de botón en la página de home, y Hidden.

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

Crear un grupo de componentes

Para crear un grupo:

• Haga clic en el signo + situado junto a User-defined groups y accederá al menu de creación de grupos.

• Introduzca el nombre del grupo.

• Seleccione los componentes que desea incluir en ese grupo.

La edición del menu de sus grupos se realiza mediante el icono del lápiz situado junto al signo + 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 Actions ahora está estructurado según el tipo de componente. Así, puede crear acciones para sus componentes, que se separarán en las cinco categorías mencionadas anteriormente.

Scripting

Los componentes pueden incluirse en scripts y programarse para cambiar sus valores en función de una condición. Para especificar un componente en un script, deberá utilizar su ID. Los ID de los componentes empiezan en 200 y están limitados a 299. Podrá ver el ID de su 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 correctamente una conexión Bluetooth. Si el observador de Bluetooth está desactivado, aparecerá un mensaje informándole de ello, junto con un botón para activarlo y reiniciar el dispositivo.

Una vez establecida la conexión, para añadir un dispositivo BTHome (Bluetooth), haz clic en el signo + situado junto a componentes BTHome. El dispositivo buscará devices 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 aparezca 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 sensors, haz clic en Configurar junto al dispositivo Bluetooth que elijas. 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 paquetes y se puede obtener mediante la aplicación Shelly BLU Debug .

Debajo del campo de la clave de cifrado aparecen los sensors compatibles, que puedes añadir haciendo clic en el signo + situado 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 usar 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 lighting, heating, ventilación, seguridad, gestión energética y mucho más. KNX permite que distintos devices 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 Activar. 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 menu. Para cada entrada, selecciona un Estado de entrada, que puede ser Interruptor o Botón, o específicamente para dispositivos con atenuación, Atenuación con un solo botón o Atenuación con dos botones.

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 los siguientes:

• Interruptor - Tiene un objeto llamado Objeto de interruptor, con un tamaño de 1 bit y 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 de Interruptor mediante el botón Añadir .

• Botón - Primero, selecciona una función para el botón: ENCENDIDO, APAGADO o Alternar. El estado de entrada del botón tiene dos objetos: un objeto de Pulsación única y un objeto de Realimentación. Puedes añadir hasta tres objetos de Pulsación única mediante el botón Añadir , y un objeto de Realimentación. Ambos son del tipo Switch, tienen un tamaño de 1 bit y 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 Realimentación puede ser el mismo que el objeto de Pulsación única, o bien puedes introducir otra dirección. Para ello, desmarca la opción Igual que el objeto de Pulsación única e introduce una nueva dirección.

• Atenuación con un solo botón - Primero, selecciona un paso de atenuación, desde atenuación completa hasta atenuación de 1/64. Esto cambia la velocidad de atenuación. La atenuación completa será la más rápida, ya que atenuará del 0 al 100 % a la velocidad establecida, mientras que la atenuación de 1/64 atenuará 1/64 de la atenuación completa durante el mismo período. Este estado de entrada tiene tres objetos: Pulsación única, Pulsación prolongada y Realimentación. Puedes añadir hasta tres objetos de Pulsación única y Pulsación prolongada mediante el botón Añadir , y un objeto de Realimentación, que puede ser el mismo que el objeto de Pulsación única, o bien puedes introducir otra dirección. Para ello, desmarca la opción Igual que el objeto de Pulsación única e introduce una nueva dirección. Los objetos de Pulsación única y Realimentación son del tipo Switch, tienen un tamaño de 1 bit y 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 prolongada sirve para controlar la atenuación, tiene un tamaño de 4 bits y un DPT (Tipo de punto de datos) de 3.007. El objeto Control de atenuación consta de dos valores: uno que indica un aumento (1) o una disminución (0), y otro que corresponde al paso.

• Dimming de 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 ajustará del 0 al 100 % a la velocidad establecida, mientras que el dimming de 1/64 ajustará 1/64 del dimming completo durante el mismo período. 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 breve y un objeto de pulsación prolongada. Puede añadir hasta tres objetos de pulsación breve y de pulsación prolongada mediante el botón Añadir . El objeto de pulsación breve 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 prolongada sirve para controlar el dimming; tiene un tamaño de 4 bits y un DPT (tipo de punto de datos) 3.007. El objeto Control de dimming consta de dos valores: uno indica un aumento (1) o una disminución (0), y el otro corresponde al paso.

Salidas

El menu de salidas está dividido en tres secciones: Comandos, Respuestas y Mediciones. Para cada tipo de objeto en Comandos, puede haber hasta cinco objetos. Estos son los tipos de objetos de 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 objetos 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 de objetos adicionales en las secciones, como los siguientes:

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 compuesto por dos valores: uno para indicar 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 compuesto 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 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á 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 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 puedes descargar los registros anteriores y actuales. Ten en cuenta que al salir de esta página se restablecerán el registrador y 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 indicará si la solicitud se realizó correctamente o falló.

Clientes del dispositivo

Consulta los devices conectados a tu dispositivo, ordenados en la categoría correspondiente. Para la mayoría de los devices hay dos opciones:

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

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

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