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

Descripción general

Los dispositivos Shelly proporcionan 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 appliances conectados a su 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 su navegador esté en la misma red Wi-Fi que su dispositivo Shelly.

Acceso 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), para acceder a la interfaz web, introduzca 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.

Conexión del 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 Ajustes>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 ha indicado. 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 para notificarle que no se ha podido establecer la conexión. Una vez establecida correctamente la conexión a la Wi-Fi, aparecerá un enlace que contiene la nueva dirección IP como texto encima de los ajustes 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 porque garantiza un acceso constante en esa dirección específica.

Descripción del 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 de tu 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 disponible 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 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.

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 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 ves en la pantalla, excepto el encabezado, el pie de página y el menu principal, se considera contenido principal.

Menu principalA 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 cinco iconos en el encabezado, incluido uno para las conexiones Wi-Fi, Bluetooth, Cloud, Websocket 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.

En la página de inicio, verás la entrada y la salida del dispositivo, así como el voltage, la frecuencia y un botón de encendido que controla la salida. Pulsa la salida o la entrada para ver las configuraciones específicas que se explican a continuación.

Configuración 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 cambia el estado de la salida del dispositivo. Interruptor: la posición del interruptor corresponde al estado de la salida del dispositivo. Analógico (no está disponible como opción en todos los dispositivos): mediante la entrada analógica, el dispositivo determina su porcentaje de brillo en función del porcentaje de la entrada.Establecer tipo de salida:Interruptor basculante (solo interruptor): el dispositivo funcionará como un interruptor con una posición para ACTIVADO y otra para 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 cambia 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 cambia 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 mediante la entrada.Acción al encender:Esta configuració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.Activar: cuando recibe alimentación, el dispositivo se activará. Desactivar: cuando recibe alimentación, el dispositivo estará desactivado. 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, de modo que, si se cambia a ACTIVADO, el dispositivo se activará; lo mismo se aplica cuando el interruptor se cambia a 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.Si utilizas 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 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 cualquier motivo, deseas quitar o eliminar el tipo de consumo externo de la configuración del dispositivo, puedes hacerlo simplemente dejando vacío el campo Tipo de consumo externo y haciendo clic en el botón Guardar configuración. De este modo, desactivas el tipo de consumo externo y restableces el comportamiento predeterminado del dispositivo, o dependes únicamente de la aplicación Shelly para el control y la automatización.

Protecciones de salida

• Sobrepotencia en vatios: configura el relé del interruptor Shelly para que se apague cuando el consumo de energía 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 alimentación supera un valor determinado, el canal se apagará.

• Sobretensión en voltios: si el voltage de alimentación supera un valor determinado, el canal se apagará.

Activa Enable Auto recovery para asegurarte de que el dispositivo vuelva a encenderse después de una sobretensión o sobrecorriente, si estaba encendido previamente.

Restablecer contadores

Establece todas las lecturas de las entradas en 0.

Medición de potencia inversa

Activa la medición de voltage inverso para permitir medir la potencia activa y la energía en la dirección inversa.

Bloquear entradas

Activa esta opción para ignorar todos los cambios realizados en las entradas físicas, independientemente del modo en el que se encuentren.

Acciones

Configura las acciones de tu dispositivo: crea acciones nuevas, edita acciones existentes o elimina acciones. Al crear acciones para tu dispositivo, deberás especificar la condición que desencadena la acción. También puedes establecer una duración para tus acciones, así como una URL que se consultará 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 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 encenderse/apagarse (o realizar la acción especificada) automáticamente al amanecer/atardecer, o a una hora determinada 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 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 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 Seleccionar, Intervalo o Paso para cada valor) para:

• Segundos (0-59)

• Minutos (0-59)

• Horas (0-23)

• Días (1-31)

• Meses (ENE-DIC)

• Días de la semana (DOM-SÁB)

Para crear un horario que se repita cada segundo/minuto/hora/día/mes/día de la semana, marca la casilla situada debajo de los valores de 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/atardecer 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 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 un valor 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 te indica que hagas 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, utiliza el botón de alternancia situado a la derecha.

Temporizadores

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

• Activación automática: después de desactivarse, la salida del relé se activará automáticamente tras un periodo predefinido (en segundos).

• Desactivación automática: después de activarse, la salida del relé se desactivará automáticamente tras un periodo predefinido (en segundos).

Configuración de entrada

Nombre

Nombra 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 cambia el estado de la salida del dispositivo. Interruptor: la posición del interruptor corresponde al estado de la salida del dispositivo. Analógico (no está disponible como opción en todos los dispositivos): mediante la entrada analógica, el dispositivo determina su porcentaje de brillo en función del porcentaje de la entrada.Establecer tipo de salida:Interruptor basculante (solo interruptor): el dispositivo funcionará como un interruptor con una posición para ACTIVADO y otra para 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 cambia 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 cambia 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 mediante la entrada.Acción al encender:Esta configuració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.Activar: cuando recibe alimentación, el dispositivo se activará. Desactivar: cuando recibe alimentación, el dispositivo estará desactivado. 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, de modo que, si se cambia a ACTIVADO, el dispositivo se activará; lo mismo se aplica cuando el interruptor se cambia a DESACTIVADO. InvertirEsta configuración permite invertir la lógica de la señal de entrada, lo que invierte 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 DESACTIVA.Sin embargo, si habilitas la configuración «Invertir entrada», ocurrirá lo contrario. Cuando la señal de entrada está ACTIVADA, el device se APAGARÁ, y cuando la señal de entrada está DESACTIVADA, el device se ENCENDERÁ. Esta configuración puede ser útil en situaciones en las que sea necesario invertir el comportamiento del device. Restablecimiento de fábricaHabilitar esta configuración te permitirá restablecer el device a los valores de fábrica desde su entrada, y no solo mediante la app o la interfaz web.

Configuración

Configuración de red

• Punto de acceso y extensor de alcance - Configura el punto de acceso (AP) del device 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 device 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 devices Wi-Fi. Si un device Shelly con el extensor de alcance habilitado está conectado a un router Wi-Fi y a Internet, todos los devices conectados a él también estarán conectados al router y a Internet.
  Aunque el device Shelly no esté conectado a un router Wi-Fi, todos los devices 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, así como su configuración IP, dirección MAC y direcciones IP internas y externas.

• Wi-Fi - Registra el device 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 chevron (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 device Shelly se desconecta de una de las redes, se conectará a la otra. Wi-Fi solo se puede habilitar una vez establecido el nombre de la red (SSID). Si el device 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 device es habilitada.

Conectividad

Nota sobre la comunicación RPC: Cuando una llamada RPC no se ejecuta correctamente, aparece un mensaje en un banner que te notifica que el device no responde a tiempo y ha perdido la conexión. Cuando se restablece la conexión, la solicitud se envía de nuevo.

• Nube -Conectar tu Shelly a su nube te permite controlarlo de forma remota y recibir notificaciones y actualizaciones sobre tus devices. Esta configuración está habilitada de forma predeterminada. Si deshabilitas la compatibilidad del device con la nube, perderás la conexión con tu device 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 del estado de RPC mediante MQTT\ (que te permite comunicarte con tu dispositivo mediante notificaciones RPC) y \Actualización genérica del estado mediante MQTT \ (para obtener una actualización general del estado), que puedes activar o desactivar. También puedes activar SSL e introducir tu servidor, nombre de usuario y contraseña, pero ten en cuenta que activar SSL afectará negativamente a la duración de la batería y probablemente la reduzca 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 está utilizando. De forma predeterminada, esta configuración está desactivada. Para activarla, 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\, 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 ser útil para controlar y supervisar tu dispositivo de forma remota, sin necesidad de un servidor o una conexión dedicados.

  Para utilizar esta configuración, 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\, se restablecerán todos los ajustes del dispositivo a los 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 esta configuración 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 lo consiguió la vez anterior.

Si la hora del dispositivo no está sincronizada con la hora actual, es posible que las programaciones y 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 escribas 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 sobre el ID del firmware o el 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 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 de TLS) : carga una autoridad de certificación personalizada, un certificado de cliente y una clave de cliente arrastrando y soltando los archivos o explorando tus archivos mediante 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á 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 específica. Para la depuración de Udp, también se te pedirá que escribas una dirección de Udp.

Scripts

Este dispositivo incluye 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, 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 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 Save, Start/Stop o Delete tu 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 para mostrar la funcionalidad del script en la página de home. Los componentes pueden agruparse; en la página de home 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 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 home. Puedes cambiar el nombre o eliminar un componente, así como crear acciones para él, mediante los buttons 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, así como dos iconos independientes. El menu 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 incremento. 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 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 Oculto, 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 home, y Oculto.

Si un componente está configurado como Oculto, no se mostrará en la página de home. 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 el signo + junto a Grupos definidos por el usuario y accederás al menu de creación de grupos.

• Introduce el nombre del grupo.

• Selecciona los componentes que deseas incluir en ese grupo.

La edición del menu de tus 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 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 pueden incluirse en scripts y programarse para cambiar sus valores en función de una condición. Para especificar un componente en un script, necesitarás utilizar 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 Componentes.

componentes BTHome

Los componentes BTHome permiten crear componentes virtuales/dinámicos vinculados a dispositivos reales que emiten paquetes BTHome, como los devices Shelly BLU. Para utilizar 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á devices Bluetooth disponibles, pero puedes hacer clic en el botón Buscar para realizar otra búsqueda. Los devices 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 deseas añadir.

Para añadir sensors, 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 home. 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 texto.

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.

Zigbee

Activa o desactiva la conectividad Zigbee mediante el botón de alternancia. Para añadir el dispositivo a la red Zigbee, debe estar en modo de emparejamiento. De forma predeterminada, la conexión está desactivada, como se muestra en el estado de conexión situado encima del botón de alternancia. Haz clic en Iniciar emparejamiento para acceder al modo de emparejamiento. El estado de conexión cambiará al hacerlo. Todas las opciones de estado son:

• Desactivada: cuando la conexión Zigbee está desactivada.

• Inicializando: aparece cuando inicias el proceso de emparejamiento.

• Emparejamiento: significa que tu dispositivo está actualmente en modo de emparejamiento.

• Conectado: se ha establecido correctamente la conexión.

• Fallida: la conexión no se ha realizado correctamente.

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 situada junto a Activar. A continuación, introduce una dirección individual única para tu dispositivo en la red KNX.

En la configuración de multidifusión, introduce la dirección IP (denominada Dirección) del grupo de multidifusión 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 de multidifusión donde tiene lugar la comunicación. Juntos, definen el destino de los mensajes de multidifusión 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 Conmutador 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:

• Conmutador - Tiene un objeto, llamado Objeto de conmutador, con un tamaño de 1 bit y un DPT (tipo de punto de datos) 1.001, que corresponde a un tipo de conmutador con dos estados: activado/desactivado (1/0). Puedes añadir hasta tres objetos de Conmutador mediante el botón Añadir .

• Botón - Primero, selecciona una función para el botón: ACTIVAR, DESACTIVAR o Alternar. El estado de entrada del botón tiene dos objetos: un objeto de Pulsación única y un objeto de Retroalimentación. Puedes añadir hasta tres objetos de Pulsación única mediante el botón Añadir y un objeto de Retroalimentación. 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 conmutador con dos estados: activado/desactivado (1/0). El objeto de Retroalimentación puede ser el mismo que el objeto de Pulsación única, o se puede introducir otra dirección para él; 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, que va 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 porque 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 tiempo. Este estado de entrada tiene tres objetos: Pulsación única, Pulsación prolongada y Retroalimentació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 Retroalimentación, que puede ser el mismo que el objeto de Pulsación única, o se puede introducir otra dirección para él; 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 Retroalimentación 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 conmutador con dos estados: activado/desactivado (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) 3.007. El objeto Control de atenuación consta de dos valores: uno indica un aumento (1) o una disminución (0), y el otro corresponde al paso.

• Regulación de doble botón: primero, seleccione un paso de dimming, desde dimming completo hasta dimming de 1/64. Esto cambia la velocidad de regulación. El dimming completo será el más rápido, ya que regulará del 0 al 100 % a la velocidad establecida, mientras que el dimming de 1/64 regulará 1/64 del dimming completo durante el mismo tiempo. A continuación, seleccione la dirección del dimming: hacia arriba/encender o hacia abajo/apagar. Este estado de entrada tiene dos objetos: un objeto de pulsación corta y un objeto 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 para indicar un aumento (1) o una disminución (0), y otro correspondiente 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 objeto 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 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 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 Escalado con un valor del 1 al 100 para representar el 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 esta opción, 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á que introduzcas 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 de la opción, accederás a la documentación de la API, donde encontrarás más información sobre el funcionamiento de KVS en los devices Shelly.

Diagnóstico

Desde esta opción, puedes descargar los registros de depuración. No se recomienda activar el log de depuración sin motivo, ya que ralentizará tu dispositivo y esta opción 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 eliminarán los datos del log.

Ping HTTP

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

Clientes del dispositivo

Consulta los devices conectados a tu dispositivo, organizados 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.