Descripción general de la familia Shelly

Vista previa del material en texto

1 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
INDICE 
1) Descripción general de la familia Shelly 
a) Modos WiFi 
b) Servidor HTTP 
c) mDNS Discovery 
d) SNTP Time Sync 
e) Cloud 
f) ColoT 
g) Basado en Mongoose-OS 
2) API HTTP común 
a) Dialecto HTTP 
b) /shelly 
c) /settings 
d) /settings/ap 
e) /settings/sta 
f) /settings/login 
g) /settings/cloud 
h) /status 
i) /reboot 
3) Soporte MQTT 
a) Configuración MQTT 
b) Disponibilidad y anuncios 
c) Comandos MQTT comunes 
4) Shelly1 / Shelly1PM 
a) Shelly1/PM: Visión general 
b) Restablecimiento de fábrica 
c) Acerca del dispositivo 
d) Shelly1/1PM: MQTT 
e) Shelly1PM: /settings 
f) Shelly1/1PM: /settings/relay/0 
g) Shelly1/1PM: /status 
h) Shelly1/1PM: /relay/0 
i) Shelly1: flash/debug opciones 
de energía 
j) Shelly1: cableado en el campo 
5) Shelly2 
a) Shelly2: Visión general 
b) Restablecimiento de fábrica 
c) Shelly2 en modo Roller (Persiana) 
d) Detección de obstáculos 
e) Entrada de interruptor de 
seguridad 
f) Shelly2: MQTT 
g) MQTT en modo relé 
h) MQTT en modo Roller (Persiana) 
i) Shelly2 /settings 
j) Shelly2: /settings/relay/{index} 
k) Shelly2: /settings/roller/{index} 
l) Shelly2: /status 
m) Shelly2: /relay/{index} 
n) Shelly2: /roller/{index} 
o) Shelly2: /roller/{index}/calíbrate 
6) Shelly2.5 
a) Shelly2.5: Visión general 
b) Restablecimiento de fábrica 
c) Shelly2.5 en modo relé 
d) Shelly2.5 en modo Roller (persiana) 
e) Entrada de interruptor de 
seguridad 
f) Control de posición 
g) Shelly2.5: MQTT 
h) MQTT en modo retransmisión 
i) MQTT en modo Roller 
j) Shelly2.5: /settings 
k) Shelly2.5: /settings/relay/{index} 
l) Shelly2.5: /settings/roller/{index} 
m) Shelly2.5: /status 
n) Shelly2.5: /relay/{index} 
o) Shelly2.5: /roller/{index} 
p) Shelly2.5: /roller/{index}/calíbrate 
7) Shelly4Pro 
a) 4Pro: Visión general 
b) Restablecimiento de fábrica 
c) Acerca del dispositivo 
d) 4Pro: MQTT 
e) 4Pro : /settings 
f) 4Pro : /settings/relay/{index} 
g) 4Pro: /status 
h) 4Pro: /relay/{index} 
8) Shelly Plug / PlugS 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
2 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
a) Shelly Plug/PlugS: Visión general 
b) Restablecimiento de fábrica 
c) Acerca del dispositivo 
d) Shelly Plug: MQTT 
e) Shelly Plug: /settings 
f) Shelly Plug: /status 
g) Shelly Plug: /settings/relay/0 
9) Shelly Bulb 
a) Bulb: Visión general 
b) Restablecimiento de fábrica 
c) Bulb: Modos de dispositivo 
d) Bulb: MQTT 
e) Bulb: /settings 
f) Bulb: /settings/light/0 
g) Bulb: /light/0 
10) Shelly Sense 
a) Shelly Sense: Visión general 
b) Restablecimiento de fábrica 
c) Shelly Sense: MQTT 
d) Shelly Sense: /settings 
e) Shelly Sense Schedule: 
/settings/?schedule 
f) Shelly Sense Schedule rules: 
/settings/?schedule_rules 
g) Shelly Sense: /status 
h) Shelly Sense: /ir 
i) Shelly Sense: /ir/list 
j) Shelly Sense: /ir/add 
k) Shelly Sense: /ir/remove 
l) Shelly Sense: /ir/emit 
11) Shelly H&T 
a) H&T: Visión general 
b) Restablecimiento de fábrica 
c) H&T: MQTT 
d) H&T: /settings 
e) H&T: /status 
12) Shelly Smoke (detector de humos) 
a) Shelly Smoke(detector de humos) 
b) Restablecimiento de fábrica 
c) Smoke: MQTT 
d) Smoke: /settings 
e) Smoke: /status 
13) RGBW2 
a) RGBW2: Visión general 
b) Restablecimiento de fábrica 
c) RGBW2: MQTT 
d) Modo de color MQTT 
e) MQTT de modo blanco 
f) RGBW2: /settings 
g) RGBW2: /settings/color/0 
h) RGBW2: /color/0 
i) RGBW2: /settings/white/<n> 
j) RGBW2: /white/<n> 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
3 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Descripción general de la familia Shelly 
Estas páginas describen la API HTTP expuesta por la familia de dispositivos Shelly. Los 
dispositivos de la familia Shelly son nodos de IoT conectados a Internet a través de 
WiFi. Todos los dispositivos admiten un conjunto común de parámetros de 
configuración, algunos comparten características comunes. Aparte de estos, cada 
dispositivo extiende los puntos de conexión HTTP comunes con un conjunto de 
configuraciones y comportamiento específicos del dispositivo. 
 
Modos WiFi 
Los dispositivos Shelly pueden funcionar como punto de acceso WiFi (modo AP) o 
modo cliente (STA). El valor predeterminado de fábrica es el modo AP con 
SHELLY<MODEL>-XXXXXXXXXXXX SSID sin ninguna autenticación habilitada. 
Inicialmente, los dispositivos vienen pre programados en el modo de punto de acceso 
sin contraseña establecida. Para poder conectarse al servicio en la nube de Allterco, 
sincronizar el tiempo, etc., el dispositivo tiene que estar configurado para conectarse a 
una infraestructura WiFi existente conectada a Internet. 
Se puede conectar el dispositivo a una infraestructura WiFi existente: 
•A través de las aplicaciones móviles de Allterco para Android e iOS 
•Uso de la interfaz web local a través de un navegador (abierto http://192.168.33.1/) 
•Al realizar una solicitud HTTP para establecer la configuración WiFi deseada (consulte 
la API HTTP a continuación). 
El control de estos parámetros a través de HTTP es posible a través de los puntos 
finales /settings/sta y /settings/ap. 
 
Servidor HTTP 
Todos los dispositivos ejecutan un servidor HTTP local en el puerto 80. Sirve como una 
página web simple que permite al usuario configurar parámetros básicos. Mientras 
que en el modo AP WiFi, la página web se puede acceder en: 
http://192.168.33.1/ 
La interfaz Web hace uso de los puntos finales HTTP descritos en este documento. La 
autenticación HTTP está deshabilitada de forma predeterminada. 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
http://192.168.33.1/
4 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
mDNS Discovery 
Los dispositivos Shelly anuncian un servicio HTTP en el puerto 80 vía el mDNS. El 
nombre de host siempre está en forma de shelly<model>-XXXXXXXXXXXX. 
 
SNTP Time Sync 
Los dispositivos Shelly no tienen un reloj en tiempo real integrado, pero sincronizarán 
automáticamente su reloj cuando estén en modo cliente WiFi y haya conexión a 
Internet. Una vez que la hora está sincronizada, los dispositivos pueden ejecutar 
comandos activados por la programación semanal definida por el usuario o en función 
de las horas de salida y puesta del sol. Los datos de geolocalización utilizados para los 
eventos sun se obtienen automáticamente de la dirección IP pública del dispositivo. 
Sin embargo, si esto falla, tzautodetect se puede deshabilitar y los datos de zona 
horaria y geolocalización (para el cálculo del amanecer y del atardecer) se pueden 
establecer manualmente. El servidor NTP predeterminado es time.google.com, pero 
uno personalizado también se puede configurar. 
 
Nube (Cloud) 
Los dispositivos Shelly pueden informar de su configuración y estado a un servicio en la 
nube conectado a Internet. El servicio en la nube puede modificar la configuración y 
cambiar el estado del dispositivo. Toda la comunicación es a través de SSL. Este 
servicio permite la supervisión y el control de dispositivos a través de Internet 
utilizando las aplicaciones móviles que lo acompañan. 
CoIoT 
Los dispositivos Shelly implementan un protocolo basado en CoAP para la supervisión y 
el control que llamamos CoIoT. Documentación: 
 
• CoIoT para dispositivos Shelly (Rev 1.0). pdf 
http://shelly-api-
docs.shelly.cloud/images/CoIoT%20for%20Shelly%20devices%20(rev%201.0)%20.pdf 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
http://shelly-api-docs.shelly.cloud/images/CoIoT%20for%20Shelly%20devices%20(rev%201.0)%20.pdf
http://shelly-api-docs.shelly.cloud/images/CoIoT%20for%20Shelly%20devices%20(rev%201.0)%20.pdf5 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Basado en Mongoose-OS 
 
Los dispositivos Shelly están construidos en la parte superior de, y junto con 
Mongoose-OS. Mongoose proporciona un marco integrado para sockets seguros, 
actualizaciones por aire, almacenamiento de aplicaciones, tareas comunes de limpieza 
de dispositivos y más, que están haciendo posible la fiabilidad y seguridad de la cartera 
Shelly. 
 
Comentarios 
 
Si encuentra problemas con esta documentación o tiene otras preguntas o 
comentarios acerca de los dispositivos Shelly, envíe un correo electrónico a 
developers-shelly.cloud 
 
 
 
 
 
 
 
 
 
 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
https://ssl.microsofttranslator.com/bv.aspx?ref=TAns&from=&to=es&a=developers-shelly.cloud
6 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
API HTTP común 
 
Esta sección documenta la API HTTP implementada por todos los dispositivos Shelly, 
que define sus rasgos comunes: 
•Configuración WiFi 
•Configuración de la nube 
•Configuración de autenticación HTTP 
•Actualizaciones de firmware, identificación y otras funciones del sistema 
 
Para cada dispositivo Shelly, uno debe consultar esta sección, junto con el capítulo 
dedicado al modelo Shelly en cuestión. 
Dialecto HTTP 
Todas las solicitudes formadas correctamente devuelven una carga codificada en JSON 
con un tipo MIME application/json. El significado de los valores se describe como 
atributos para cada recurso documentado. 
Cada recurso también puede aceptar una lista de parámetros que se deben 
proporcionar como cadena de consulta en la dirección URL o como carga POST 
application/x-www-form-urlencoded. 
Las respuestas de error llevan un código de respuesta HTTP 4xx y un cuerpo de 
respuesta de texto/sin formato, normalmente con un mensaje informativo para el tipo 
de error que se produjo. 
Todos los recursos excepto /shelly requerirán autenticación HTTP básica cuando se 
habilite a través de /settings/login. 
http://shelly-api-docs.shelly.cloud/#settings-login 
El método HTTP utilizado para realizar cualquiera de las solicitudes siguientes se omite 
intencionalmente. La mayoría de los puntos de conexión siempre devolverán su carga 
json específica y realizarán acciones si se especifican parámetros de consulta. 
Los parámetros booleanos se pueden dar como 1, y, Y, t, T o mayúsculas y minúsculas 
true para true, cualquier otro valor se interpretará como false. 
 
 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
http://shelly-api-docs.shelly.cloud/#settings-login
7 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
/shelly 
Proporciona información básica sobre el dispositivo. No requiere autenticación HTTP, 
incluso si la autenticación está habilitada globalmente. Este punto final se puede 
utilizar junto con el mDNS para la detección e identificación del dispositivo. No acepta 
parámetros. 
Atributos 
 
Atributos Tipo Descripción 
Tipo cadena Shelly modelo e identificador 
mac cadena MAC dirección del dispositivo 
auth bool Si las solicitudes HTTP requieren 
autenticación 
fw cadena Versión actual del firmware 
num_outputs numero Número de salidas para actuadores 
 
 
/settings 
Representa la configuración del dispositivo: todos los dispositivos admiten un conjunto 
de características comunes que se describen aquí. Consulte el punto de conexión 
/settings específico del dispositivo para ver cómo lo extiende cada dispositivo. 
 
Para configurar manualmente la zona horaria y la ubicación (para el cálculo del 
amanecer/atardecer), establezca tzautodetect en false, de modo que los valores 
personalizados de lat, lng y timezone surtan efecto. Para obtener una lista de las zonas 
horarias admitidas, por favor busque: 
https://api.shelly.cloud/timezone/tzlist 
 
 
 
 
 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
https://api.shelly.cloud/timezone/tzlist
8 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
 Parametros estandard 
 
 
Atributos 
Atributos Tipo Descripción 
device.Tipo cadena Identificador del modelo de dispositivo 
device.mac cadena Dirección MAC del dispositivo en hexadecimal 
wifi_ap hash Configuración del punto de acceso WiFi, consulte /settings/ap para obtener 
más información 
wifi_sta hash Configuración del cliente WiFi. Consulte /settings/sta para obtener más 
información 
login hash credenciales utilizadas para la autenticación básica HTTP para la interfaz REST. 
Si habilitado es true los clientes deben incluir una autorización: Básico ... 
Encabezado HTTP con credenciales válidas al realizar solicitudes TP. 
name cadena nombre único del dispositivo. 
fw cadena versión actual de FW 
Parametros Tipo Descripción 
reset bool Realizará un restablecimiento de fábrica del 
dispositivo 
mqtt_enable bool Habilitar conexión a un intermediario MQTT 
mqtt_server cadena Dirección IP y puerto del bróker MQTT, ex. 
10.0.0.1:1883 
mqtt_user cadena MQTT username, déjalo vacío para deshabilitar la 
autenticación 
mqtt_pass cadena Contraseña MQTT 
mqtt_reconnect_timeout_max int intervalo máximo para los intentos de reconexión 
mqtt_reconnect_timeout_min int intervalo mínimo para los intentos de reconexión 
mqtt_clean_session bool Indicador de sesión limpia MQTT 
mqtt_keep_alive int MQTT mantener un período activo en segundos 
mqtt_max_qos int Valor máximo de QOS para paquetes MQTT 
mqtt_retain bool Indicador de retención MQTT 
mqtt_update_period int Actualización periódica en segundos, 0 para 
deshabilitar 
coiot_execute_enable bool Si se permite la ejecución de comandos CoIoT 
tzautodetect bool Establezca esta opción en false si desea establecer la 
geolocalización personalizada (lat y lng) o la zona 
horaria personalizada. 
lat numero Grados latitud en formato decimal, Sur es negativo 
lng numero Grados longitud en formato decimal, entre -180 y 
180 
timezone cadena Identificador de zona horaria. 
sntp_server cadena Host del servidor de tiempo que se utilizará en lugar 
del valor predeterminado time.google.com 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
9 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
cloud.enabled bool Nube (cloud) habilitada 
time cadena hora actual en formato HH:MM si está sincronizado 
mqtt hash contiene la configuración relacionada con MQTT 
 
/settings/ap 
Proporciona información sobre la configuración actual de WiFi AP y permite cambios. 
El documento devuelto es idéntico al devuelto por /settings en la clave wifi_ap. Los 
dispositivos Shelly no permiten que se cambie el SSID para el modo WiFi AP. 
Los parámetros se aplican inmediatamente. Establecer el indicador habilitado para el 
modo AP a 1 desactivará automáticamente el modo STA. 
Parámetros 
Parámetros Tipo Descripción 
enabled bool Establézcalo en 1 para devolver el dispositivo al modo WiFi AP 
key cadena Contraseña WiFi necesaria para la asociación con el dispositivo AP 
 
Atributos 
Attributo Tipo Descripción 
enabled bool si el modo AP está activo. 
ssid cadena SSID creado por el AP del dispositivo 
key cadena Contraseña WiFi necesaria para la asociación con el 
dispositivo AP 
 
 
/settings/sta 
Proporciona información sobre la configuración actual del modo de cliente WiFi y 
permite cambios. El documento devuelto es idéntico al devuelto por /settings en la 
clave wifi_sta. 
Los parámetros se aplican inmediatamente. Establecer el indicador habilitado para el 
modo STA en 1 desactivará automáticamente el modo AP. 
Parámetros 
Parámetro Tipo Descripción 
enabled bool Establézcalo en 1 para que STA sea el modo WiFi actual 
ssid cadena The WiFi SSID to associate with 
key cadena El SSID WiFi para asociar con 
ipv4 
method 
cadena "dhcp" o "estático" 
ip cadena addres ip locales si el método ipv4 es "estático"https://shelly-api-docs.shelly.cloud/#shelly-family-overview
10 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
gw cadena dirección IP local de Geateway si el método ipv4 es 
"estático" 
mask cadena Dirección de la máscara si el método ipv4 es "estático" 
dns cadena Dirección DNS si el método ipv4 es "estático" 
 
 
Atributos 
Atributo Tipo Descripción 
enabled bool si el modo STA está activo. 
ssid cadena SSID de STA el dispositivo se asociará con 
key cadena Contraseña WiFi para el SSID seleccionado 
ipv4 metodo cadena 
ip cadena dirección ip locales si el método ipv4 es "estático" 
gw cadena dirección IP local de Geateway si el método ipv4 es 
"estático" 
mask cadena Dirección de la máscara si el método ipv4 es 
"estático" 
dns cadena Dirección DNS si el método ipv4 es "estático" 
 
 
/settings/login 
Configuración de autenticación HTTP: indicador habilitado, credenciales. desprotegido 
es inicialmente falso y es utilizado por la interfaz de usuario para mostrar una 
advertencia cuando se inhabilita el auth. Si el usuario desea seguir usando Shelly sin 
una contraseña, puede establecer unprotected para ocultar la advertencia. 
 
Parametros 
Parametro Tipo Descripción 
username string longitud entre 1 y 50 
password string longitud entre 1 y 50 
enabled bool si se requiere autenticación HTTP 
unprotected bool si el usuario es consciente de los riesgos 
 
Atributos 
Los atributos son idénticos a los parámetros y su semántica. 
 
/settings/cloud 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
11 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Puede establecer la marca "conectar a la nube". Cuando se establece, Shelly 
mantendrá una conexión segura con los servidores de Allterco y permitirá la 
supervisión y el control desde cualquier lugar. 
 
 
/status 
Encapsula la información de estado actual del dispositivo. Aunque la configuración 
generalmente se puede modificar y no reacciona al entorno, este punto de conexión 
proporciona información sobre los datos transitorios que pueden cambiar debido a 
condiciones externas. 
Atributos 
Parámetro Tipo Descripción 
wifi_sta Hash Estado actual de la conexión WiFi 
wifi_sta.ip Cadena Dirección IP asignada a este dispositivo por el 
router WiFi 
cloud Hash estado actual de la conexión en la nube 
mqtt.connected Bool Conexión MQTT, cuando MQTT está habilitado 
time Cadena La hora y los minutos actuales, en formato HH:MM 
has_update Bool Si hay disponible una versión de firmware más 
reciente 
ram_total, 
ram_free 
Número Cantidad total y disponible de memoria del sistema 
en bytes 
uptime Número segundos transcurridos desde el arranque 
 
 
/reboot 
Cuando se solicite, se reiniciará el dispositivo. 
 
 
 
 
 
 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
12 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
 
 
 
Soporte MQTT 
Los dispositivos Shelly incluyen compatibilidad básica con MQTT desde la versión 1.3.0. 
Aunque muchos ajustes de dispositivos solo están disponibles a través de HTTP, MQTT 
permite la supervisión en tiempo real y facilita la integración con sistemas externos. 
 
 
 
Para configurar un dispositivo Shelly para MQTT, establezca los parámetros de 
conexión a través de la aplicación Shelly, la interfaz web o el punto final HTTP 
/settings. Tenga en cuenta que habilitar MQTT deshabilitará el servicio en la nube de 
Allterco. Los dispositivos Shelly no admiten conexiones MQTT seguras. 
Los ajustes obligatorios son: 
•mqtt_host es la dirección de su intermediario: port 
•mqtt_enable debe establecerse en true 
En caso de que se requiera autenticación, también se deben establecer mqtt_user y 
mqtt_pass. En ciertos escenarios, puede ser deseable establecer mqtt_qos y 
mqtt_retain para evitar la pérdida de datos. 
 
Disponibilidad y anuncios 
 
Nuevo en v1.4.3: en MQTT connect, Shellies publicará: 
•un mensaje de anuncio en shellies/announce. El mensaje tiene formato json y 
contiene una lista de atributos: id, mac, ip, new_fw es true cuando hay una 
actualización disponible, fw_ver contiene la versión de firmware actual. 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
13 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
•mensaje de disponibilidad en shellies/<shellymodel>-<deviceid>/online con carga útil 
verdadera 
•estado actual completo. Esto es específico del dispositivo y se describe en detalle 
para cada dispositivo a continuación. 
 
El estado del dispositivo se notifica periódicamente, cada 30 segundos de forma 
predeterminada. Esto se puede cambiar estableciendo un nuevo período para las 
actualizaciones: mqtt_update_period en /settings. Un valor de 0 deshabilitará las 
actualizaciones periódicas. 
El tema y el mensaje de LWT predeterminados son shellies/<shellymodel>-
<deviceid>/online, false. Si estos no se establecen después de una actualización de 
firmware, realice un restablecimiento de fábrica del dispositivo o establezca el tema y 
el mensaje LWT correctos manualmente. 
 
Comandos MQTT comunes 
 
Los Shellies admiten un conjunto de comandos publicados en shellies/command o 
shellies/<shellymodel>-<deviceid>/command para dirigir un dispositivo individual: 
•anunciar activará un paquete de anuncio por cada Shelly conectado al corredor en 
shellies / announce 
•actualizar hará que todos los Shellies publiquen su estado 
•update_fw para realizar una actualización de firmware cuando hay una disponible. 
 
Cada modelo Shelly exporta su propio conjunto de temas para la supervisión y el 
control, todos estructurados en /shellies/<shellymodel>-<deviceid>. El último 
testamento se puede configurar con los parámetros mqtt_will_topic y 
mqtt_will_message. Consulte los documentos del producto correspondientes para 
obtener más información sobre el protocolo: 
•Shelly1 •Shelly RGBW2 
•Shelly2 •Shelly Smoke 
•Shelly 4Pro •Shelly H&T 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
14 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
•Shelly Plug •Shelly Sense 
•Shelly Bulb 
 
 
 
Shelly1 / Shelly1PM 
 
 
 
 
 
 
Shelly1/PM: Visión general 
 
Shelly1 es el interruptor de alimentación Wi-Fi inteligente más pequeño del 
mercado en la actualidad. Visite la página del producto para obtener una 
descripción detallada y el Manual del usuario: 
 
https://shelly.cloud/shelly1/ 
 
Shelly1PM también incluye medición de energía: 
 
https://shelly.cloud/shelly-1pm-wifi-smart-relay-home-automation/ 
 
Los comandos para encender o apagar el relé pueden provenir de: 
•Un botón físico 
•Solicitud HTTP, a través de la interfaz web local 
•Un mandato enviado a través de la nube o MQTT 
•Un evento de programación semanal o un evento generado por el amanecer y 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
https://ssl.microsofttranslator.com/bv.aspx?ref=TAns&from=&to=es&a=https://shelly.cloud/shelly1/
https://ssl.microsofttranslator.com/bv.aspx?ref=TAns&from=&to=es&a=https://shelly.cloud/shelly-1pm-wifi-smart-relay-home-automation/
15 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
el atardecer 
•Sólo Shelly1PM: La condición de abloque apagará el relé 
 
 
 
Restablecimiento de fábrica 
 
Si no se puede acceder a la interfaz web del dispositivo, la configuración se 
puede volver a poner en marcha de forma predeterminada activando y 
apagando 5 veces el conmutador físico conectado al dispositivo, en el primer 
minuto después de un reinicio o encendido. 
 
Acerca del dispositivo 
 
Shelly1/1PM es compatible con los comandos ON y OFF que controlan la bobina de unrelé 16A 250VAC. 
Shelly1/1PM también admite la configuración auto_on y auto_off: estos son 
temporizadores en segundos que encenderán o apagarán el dispositivo cuando se haya 
apagado o activado respectivamente, ya sea desde un botón físico o un comando de 
red. Por lo tanto, el usuario puede establecer un límite durante cuánto tiempo el1 
puede estar activado o apagado. 
Al encender, la salida se inicializa usando una de las 4 estrategias disponibles: 
•Mantenga la salida desactivada 
•Activar la salida 
•Restaurar el estado de la salida desde antes de la pérdida de energía 
•Lea el estado del conmutador físico y configure la salida en consecuencia. 
Para controlar Shelly1, utilice estos recursos: 
•/settings/relay/0 para configurar el comportamiento 
•/relay/0 para controlar y monitorear. 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
16 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Shelly1/1PM: MQTT 
 
Shelly1 y Shelly1PM utilizan los temas siguientes, donde <model> es shelly1 o 
shelly1pm: 
•shellies/<model>-<deviceid>/relay/0 para informar del estado: encendido o apagado 
•shellies/<model>-<deviceid>/relay/0/command acepta encendido y apagado y se 
aplica en consecuencia 
•shellies/<model>-<deviceid>/input/0 informa del estado del terminal SW 
•shellies/<model>-<deviceid>/longpush/0 informa del estado de "longpush" como 0 o 
1 
 
Shelly1PM añade: 
•shellies/shelly1pm-<deviceid>/relay/0/power informa de potencia instantánea 
•shellies/shelly1pm-<deviceid>/relay/0/energy informa de un contador de energía en 
incremento en vatios-minuto 
•shellies/shelly1pm-<deviceid>/temperature informa de la temperatura interna del 
dispositivo en C 
•shellies/shelly1pm-<deviceid>/overtemperature informa 1 cuando el dispositivo se 
ha sobrecalentado, normalmente 0 
 
Shelly1PM: /settings 
Los parámetros comunes se aplican al punto de conexión /settings. Además: 
 
Parametro Tipo Descripción 
max_power número Shelly1PM solo, umbral de potencia por encima del cual se 
activará una condición de triger 
 
 
Shelly1/1PM: /settings/relay/0 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
17 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
El documento devuelto aquí es idéntico a los datos devueltos en /settings para el canal 
de salida único en la matriz relays. El índice de canal existe para conservar la 
compatibilidad de la API con dispositivos Shelly multicanal. Los atributos de la 
respuesta coinciden con el conjunto de parámetros aceptados. 
 
 
Parámetros 
Parámetro Tipo Descripción 
reset Cualquier El envío de un valor no vacío restablecerá la 
configuración de la salida a los valores predeterminados 
de fábrica. 
default_state Cadena Valores aceptados: apagado, encendido, último, 
interruptor 
btn_Tipo Cadena Valores aceptados: momentáneo, alternar, borde, 
separado 
auto_on Número Temporizador automático de retroceso, segundos. Se 
activará después de apagar Shelly1. 
auto_off Número Temporizador automático de retroceso, segundos. Se 
activará después de encender Shelly1. 
btn_on_url Número URL para acceder cuando se activa la entrada SW 
btn_off_url Cadena URL a la que acceder cuando se desactiva la entrada SW 
out_on_url Cadena URL para acceder cuando se activa la salida 
out_off_url Cadena URL a la que acceder cuando se desactiva la salida 
btn_reverse Booleana Invierte el estado lógico de la entrada 
 
Shelly1/1PM: /status 
/status se amplía con información sobre el estado actual del canal de salida, así como 
la presencia de un temporizador pendiente. 
Atributo Tipo Descripción 
relays matriz de 
hashes 
Contiene el estado actual de los canales de salida 
del relé. Consulte /relay/0 para obtener una 
descripción de los atributos 
meters matriz de 
hashes 
Shelly1PM sólo contiene información sobre la 
potencia instantánea y el contador de energía 
acumulativa 
temperature Número Shelly1PM sólo temperatura interna del 
dispositivo en .C 
overtemperature Boolean Shelly1PM sólo es cierto cuando el dispositivo se 
ha sobrecalentado 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
18 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
 
 
 
 
 
Shelly1/1PM: /relay/0 
Muestra el estado actual del canal de salida y acepta comandos para controlar el canal. 
Parámetros 
Parámetro Tipo Descripción 
turn Cadena Los valores aceptados están activados y desactivados. Esto 
encenderá/apagará el canal de salida respectivo cuando se 
envíe la solicitud. 
timer Número Un temporizador de un disparo en segundos. 
 
Atributos 
Atributo Tipo Descripción 
ison boolean Si el canal está encendido o apagado 
has_timer boolean Si un temporizador está actualmente armado para este canal 
overpower boolean Shelly1PM sólo si se superó la potencia máxima permitida 
 
 
Shelly1: flash/debug opciones de energía 
Shelly1 viene con un encabezado de programación/depuración que se puede utilizar 
para flashear firmwares alternativos en el dispositivo. Tiene un ESP8266 en su interior, 
con un chip flash de 2 MB. Se necesita un adaptador USB a UART, así como un fiable 
3.3V con al menos 350 mA de capacidad de accionamiento. El siguiente diagrama 
muestra el puente de selección de voltaje de pinout y fuente de alimentación del 
dispositivo: 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
19 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
El flash/connetor de depuración nunca debe utilizarse mientras el dispositivo esté 
conectado a la red u otra fuente de alimentación. Cuando se conecte a un PC, 
proporcione una fuente confiable de 3.3V externamente. 
 
Para arrancar el ESP8266 para la programación en serie, ate GPIO0 a GND antes de 
encenderlo. El parpadeo se puede hacer con esptool. Hay una amplia gama de 
plataformas, idiomas y bibliotecas para el chip ESP8266 que se pueden utilizar para 
integrar el dispositivo con prácticamente cualquier sistema. Algunos ejemplos son: 
•SDK de Espressif 
•Arduino 
•NodeMCU 
•Micropython 
•Sming 
•y muchos otros. 
 
Shelly1: cableado en el campo 
 
Cuando utilice la fuente de alimentación de CC, observe la polaridad indicada: 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
20 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
 
 
Nota: Tenga en cuenta que internamente, GND desde el conector flash/debug está 
conectado al terminal AC/L. El SW se puede conectar a través de un Switch a L o N y 
detectará las transiciones entre el estado abierto y cerrado del Switch. 
 
Shelly2 
 
 
Shelly2: Visión general 
Shelly2 es un relé de doble canal habilitado para WiFi con un medidor de potencia 
común. Para obtener más información y descargar el Manual del usuario, visite la 
página del producto 
 
https://shelly.cloud/shelly2/ 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
https://ssl.microsofttranslator.com/bv.aspx?ref=TAns&from=&to=es&a=https://shelly.cloud/shelly2/
21 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Shelly2 puede funcionar en dos modos de dispositivo distintos: Relé y Obturador de 
rodillos. Los dispositivos están programados inicialmente para funcionar en modo de 
relé. El modo de funcionamiento de Shelly2 se puede establecer a través del punto de 
conexión /settings. Los comandos para realizar acciones pueden provenir de: 
•Un interruptor de entrada físico (S1/S2) 
•Solicitud HTTP, a través de la interfaz web local 
•Un comando enviado a través de la nube 
•Un evento de programación semanal o un evento generado por el amanecer y el 
atardecer 
 
 
 
 
 
Restablecimiento de fábrica 
Si no se puede acceder a la interfaz web del dispositivo, la configuración se puede 
volver aponer en marcha de forma predeterminada activando y apagando 5 veces el 
conmutador físico conectado al dispositivo, en el primer minuto después de un reinicio 
o encendido. 
 
Shelly2 en modo relé 
 
En el modo de retransmisión, cada uno de los dos canales se controla individualmente 
y admite los comandos ON y OFF. En este modo, se puede habilitar un umbral de 
sobrepotencia para cada uno de los dos canales, a través del parámetro max_power en 
/settings. Si se establece en un valor distinto de 0, el relé se apagará automáticamente 
si el consumo de energía actual supera: 
•el valor de max_power cuando solo un canal está activado 
•el doble del valor de max_power cuando ambos canales están encendidos 
Los canales de retransmisión también admiten la configuración auto_on y auto_off: 
estos son temporizadores en segundos que encenderán o apagarán el canal cuando se 
haya apagado o activado respectivamente, ya sea desde un conmutador físico o un 
comando de red. Por lo tanto, el usuario puede establecer un límite durante cuánto 
tiempo el canal puede estar encendido o apagado. 
 
Al encenderse, las salidas se inicializan utilizando una de las 4 estrategias disponibles: 
•Mantenga la salida desactivada 
•Activar la salida 
•Restaurar el estado de la salida desde antes de la pérdida de energía 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
22 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
•Lea el estado del conmutador físico y configure la salida en consecuencia. 
 
Los interruptores de entrada físicos pueden ser uno de los: 
•un interruptor momentáneo con botón 
•un interruptor de palanca con dos estados estables 
•un interruptor de "borde". En este modo de entrada, cada transición de estado del 
conmutador provoca un cambio del estado de salida. Esto se puede utilizar con la 
entrada de las instalaciones de conmutadores bidireccionales existentes. 
•separados, los eventos de las entradas se ignoran. 
Nota: La configuración del estado de salida en función de las entradas encendidas no 
se admite cuando las entradas se configuran como momentáneas o perimetrales. 
Para controlar Shelly2 en modo de retransmisión, utilice estos recursos: 
/settings/relay/{index} para configurar el comportamiento de cada canal 
/relay/{index} para controlar y supervisar el canal 
Shelly2 en modo Roller (Persiana) 
En el modo Roller, el dispositivo se puede utilizar para controlar el motor bidireccional, 
con detección de obstáculos opcional y funciones de interruptor de seguridad. Los 
comandos son: Abrir, Cerrar y Detener. 
Shelly2 tiene un único Roller lógico, pero indexamos los recursos HTTP para permitir 
dispositivos futuros con más canales de salida y Roller-s. 
Cuando Shelly2 esté en modo Roller, utilice: 
• /settings/roller/{index} para configurar el comportamiento de este 
controlador De rodillos, incluidas las características avanzadas que se describen 
a continuación 
• /roller/{index} para consultar el estado y enviar comandos. 
 
Detección de obstáculos 
En el modo Roller, el medidor de potencia integrado de Shelly2 se puede utilizar para 
detectar la sobrecarga del motor, lo que generalmente significa algo que obstruye el 
movimiento de la puerta o del obturador de rodillos. Un conjunto de parámetros 
define el comportamiento de Shelly2 cuando se produce dicho evento. Estos son: 
•la dirección del movimiento para la que está habilitada la protección de obstáculos 
•la acción que se debe realizar cuando se produce el evento 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
http://shelly-api-docs.shelly.cloud/#shelly2-settings-relay-index
http://shelly-api-docs.shelly.cloud/#shelly2-settings-relay-index
http://shelly-api-docs.shelly.cloud/#shelly2-settings-roller-index
http://shelly-api-docs.shelly.cloud/#shelly2-roller-index
23 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
•número de segundos para esperar antes de activar la condición - los motores dibujan 
gran corriente inicial que puede ser falsamente interpretado como un obstáculo. 
Entrada de interruptor de seguridad 
Mientras que en el modo de rodillo y cuando las entradas están configuradas como 
"un botón", la segunda entrada física se puede utilizar como una entrada de seguridad 
- se puede vincular a un interruptor de parada final o botón de parada de seguridad del 
usuario. Sus parámetros de configuración son: 
•cuándo honrar los eventos en la entrada de seguridad: tanto en la dirección como en 
cualquier dirección de movimiento 
•qué hacer cuando el interruptor está activado: 
Pausa el movimiento, por lo que cuando el interruptor se desengancha continúa en la 
misma dirección. 
•qué comandos externos se permiten mientras se activalan las entradas de seguridad. 
Shelly2: MQTT 
Shelly2 permite el control y la supervisión a través de MQTT para los modos de relé y 
rodillo. El modo de dispositivo, junto con otros parámetros, deben configurarse 
mediante la aplicación móvil o la interfaz web. En cualquier modo, Shelly2 informa: 
• shellies/shellyswitch25-<deviceid>/input/<i> para cada entrada SW como <i> 
informa el estado actual como 0 o 1 
• shellies/shellyswitch25-<deviceid>/longpush/<i> para cada entrada SW como 
<i> un valor que indica el estado lpulsación largo como 0 o 1. 
 
MQTT en modo relé 
En el modo de retransmisión, se pueden utilizar los siguientes temas para leer y 
establecer los canales de salida 0 y 1: 
•shellies/shellyswitch-<deviceid>/relay/<i> para informar del estado: encendido, 
apagado o sobrepotencia 
•shellies/shellyswitch-<deviceid>/relay/<i>/command acepta encendido, apagado o 
alternar 
 
El dispositivo mide el consumo total en ambos canales, que se puede ver en: 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
24 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
• shellies/shellyswitch-<deviceid>/relay/power informa de la tasa de consumo de 
energía instantánea en vatios 
• shellies/shellyswitch-<deviceid>/relay/energy informa la cantidad de energía 
consumida en [Watt-min] 
 
MQTT en modo Roller (Persiana) 
Cuando se configura para funcionar en modo de rodillo, los temas MQTT utilizados por 
Shelly2 son: 
• shellies/shellyswitch-<deviceid>/roller/0 informa del estado actual: abrir, cerrar 
mientras está en movimiento, detenerse cuando no se mueve. 
•shellies/shellyswitch-<deviceid>/roller/0/command acepta rc (realiza la calibración 
del rodillo), se abre, se cierra y se detiene. 
 
Nuevo en v1.4.0: control de posición del modo de rodillo. Para que esto funcione, el 
dispositivo primero debe calibrarse con éxito, de modo que se conozca el tiempo que 
se tarda en cerrar y abrir. 
•shellies/shellyswitch-<deviceid>/roller/0/pos informa de la posición actual en 
porcentaje 
•shellies/shellyswitch-<deviceid>/roller/0/command/pos acepta un número entre 0 
y 100, que es la posición objetivo en porcentaje. 
 
Shelly2 /settings 
Shelly2 amplía el punto final /settings común con datos específicos de relé y modo de 
rodillo, estado de consumo de energía y contiene la configuración de los relés y 
rodillos de este dispositivo y añade /settings/relay/N y /settings/roller/M para 
configurar los parámetros. 
 HTTP: 
 
 
 
GET /settings?mode=relay 
 
{ 
 "name": "shellyswitch-163248", 
 "mode": "relay", 
 "max_power": 1840, 
 "relays": [ ... ], 
 "rollers": [ ... ], 
 "meters": [{"power": 0, "is_valid": true}] 
} 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
25 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
Parametros 
Parametros Tipo Descripción 
mode cadena Los valores aceptados son relé y roller (persiana 
max_power numero Umbral de sobrepotencia en vatios 
Atributos 
Atributo Tipo Descripción 
relays array of hashes Consulte /settings/relay para obtener una explicaciónde los 
valores 
rollers array of hashes Consulte /settings/roller para obtener una explicación de los 
valores 
meters array of hashes Contiene el estado del medidor de potencia integrado. 
Atributos metros 
Atributo Tipo Descripción 
is_valid boolean Si la medición de potencia se auto comprueba ok 
power numero Corriente real de alimentación de CA que se está dibujando, en vatios 
 
 
Shelly2: /settings/relay/{index} 
El documento devuelto aquí es idéntico a los datos devueltos en /settings para el canal 
de salida determinado en la matriz relays. Los atributos coinciden con el conjunto de 
parámetros aceptados. 
 
 HTTP: 
 
 
 
 
 
 
 
GET /settings/relay/0 
 
{ 
 "ison": false, 
 "has_timer": false, 
 "overpower": false, 
 "default_state": "off", 
 "btn_Tipo": "toggle", 
 "auto_on": 0, 
 "auto_off": 0, 
 "schedule": true, 
 "schedule_on": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX", 
 "schedule_off": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX", 
 "sun": true, 
 "sun_on_times": "0000000000000000000000000000", 
 "sun_off_times": "0000000000000000000000000000" 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
26 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Parametros 
Parametro Tipo Descripción 
Reset Cualquier El envío de un valor no vacío restablecerá la 
configuración de este canal de salida de retransmisión a 
los valores predeterminados de fábrica. 
default_state Cadena Valores aceptados: apagado, encendido, último, 
interruptor 
btn_Tipo Cadena Valores aceptados: momentáneo, alternar, borde y 
desprendido. 
auto_on Número Temporizador automático de retroceso, segundos. Se 
activará después de apagar el canal. 
auto_off Número Temporizador automático de retroceso, segundos. Se 
activará después de encender el canal. 
 
 
Shelly2: /settings/roller/{index} 
El documento devuelto aquí es idéntico a los datos devueltos en /settings como un 
hash en los rodillos. Los atributos coinciden con el conjunto de parámetros aceptados. 
 
 HTTP: 
 
 
 
 
 
 
 
 
Parametros 
Parametro Tipo Descripción 
Reset Cualquier El envío de un valor no vacío restablecerá la configuración 
del rodillo a los valores predeterminados de fábrica 
Maxtime Número El tiempo máximo necesario para que el mecanismo se abra 
o cierre por completo, segundos. 
GET /settings/roller/0 
 
{ 
 "maxtime": 20, 
 "default_state": "stop", 
 "swap": false, 
 "input_mode": "onebutton", 
 "button_Tipo": "toggle", 
 "state": "stop", 
 "power": 0, 
 "is_valid": true, 
 "safety_switch": false, 
 "obstacle_mode": "disabled", 
 "obstacle_action": "stop", 
 "obstacle_power": 200, 
 "obstacle_delay": 1, 
 "safety_mode": "while_opening", 
 "safety_action": "stop", 
 "safety_allowed_on_trigger": "none" 
} 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
27 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
default_state Cadena Uno de parada, abierto, cerca. Este parámetro determina el 
comportamiento en el encendido. 
Swap Booleana Si desea intercambiar direcciones abiertas y cercanas 
input_mode Cadena Uno de openclose - cada entrada controla una dirección de 
movimiento, un botón - un solo botón presiona ciclos a 
través de los estados: abrir, detener, cerrar, detener ... 
btn_Tipo Cadena Uno de momentáneo, alternar o desmontar. 
obstacle_mode Cadena Uno de deshabilitado, while_opening, while_closing, 
while_moving. 
obstacle_action Cadena Uno de parada, marcha atrás. 
obstacle_power Número Umbral de potencia para activar la condición "obstáculo", 
vatios. 
obstacle_delay Número Número de segundos que hay que esperar después de 
encender el motor antes de activar la detección de 
obstáculos 
safety_mode Cadena Uno de deshabilitado, while_opening, while_closing, 
while_moving 
safety_action Cadena Uno de parada, pausa, marcha atrás. 
safety_allowed_on_trigger Cadena Qué comandos se permiten mientras se activa el 
interruptor de seguridad: ninguno, abierto, cerca, todo. 
 
 
 
Shelly2: /status 
Shelly2 añade información sobre el estado actual de los canales de salida, el dispositivo 
lógico "roller" y la medición de potencia. 
 HTTP: 
 
 
 
 
 
 
 
 
GET /status 
 
"relays": [ 
{ 
 "ison": false, 
 "has_timer": false, 
 "overpower": false, 
 "is_valid": true 
}, 
{ 
 "ison": false, 
 "has_timer": false, 
 "overpower": false, 
 "is_valid": true 
} 
], 
"rollers": [ 
 { 
 "state": "stop", 
 "power": 0, 
 "is_valid": true, 
 "safety_switch": false, 
 "stop_reason": "normal", 
 "last_direction": "stop" 
 } 
], 
"meters": [ 
 { 
 "power": 0, 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
28 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
 
 
 
 
 
 
Atributo Tipo Descripción 
Relays array of hashes Contiene el estado actual de los canales de salida del relé. 
Consulte /relay/N para obtener una descripción de los 
atributos 
Rollers array of hashes Contiene el estado actual del dispositivo lógico "roller". 
Consulte /roller/N para la descripción de los atributos 
meters array of hashes Estado actual de los medidores de potencia 
 
 
 
 
Shelly2: /relay/{index} 
Muestra el estado actual de cada canal de salida y acepta comandos para controlar el 
canal. Esto sólo se puede utilizar cuando el modo de dispositivo está configurado para 
retransmitir a través de /settings 
Parametros 
Parametro Tipo Descripción 
turn cadena Los valores aceptados están activados y desactivados. Esto 
encenderá/apagará el canal de salida respectivo cuando se 
envíe la solicitud. 
timer numero Un temporizador de un disparo en segundos 
Atributos 
Atributo Tipo Descripción 
ison boolean Si el canal está encendido o apagado 
has_timer boolean Si un temporizador está actualmente armado para este canal 
overpower boolean Si una condición de sobrepotencia apagó el canal 
is_valid boolean Si el medidor de potencia asociado funciona correctamente 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
29 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Shelly2: /roller/{index} 
Controla el dispositivo lógico "roller" y recupera su estado actual. Cuando go-to_pos, 
roller_pos también debe ser especificado y válido. 
 
Parametros 
Parametro Tipo Descripción 
go Cadena Los valores aceptados son open, close, stop y to_pos 
roller_pos Número Posición deseada en porcentaje 
duration Número Si se especifica, el motor se moverá durante este período en 
segundos. Si falta, se utilizará el valor de maxtime en 
/settings/roller/N. 
Atributos 
Atributo Tipo Descripción 
state bool Uno de parada, abierto, cerca 
power numero Consumo de energía actual en vatios 
is_valid bool Si el medidor de potencia funciona correctamente 
safety_switch bool Si la entrada de seguridad está activada actualmente 
stop_reason bool Ultima causa para detenerse: normal, safety_switch, 
obstáculo 
last_direction bool Ultima dirección de movimiento, abrir o cerrar 
 
 
Shelly2: /roller/{index}/calíbrate 
Nuevo en v1.4.0: Al solicitar este punto final se desencadenará un procedimiento de 
calibración que se realizará. Shelly2 medirá el tiempo necesario para abrir y cerrar el 
dispositivo mecánico bajo control. Una vez que esto se complete con éxito, Shelly2 
será capaz no sólo de abrir y cerrar, pero apuntar a una posición específica entre los 
dos. 
 
 
 
 
 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
30 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Shelly2.5 
 
 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
31 
Traducción de la pagina de shelly …. FAMILIASHELLY por miracomovoy (Telegram) 
Shelly2.5: Visión general 
Shelly2.5 es el sucesor mejorado de nuestro popular modelo Shelly2. La página 
del producto: 
https://shelly.cloud/shelly-25-wifi-smart-relay-roller-shutter-home-automation/ 
tiene todas las características clave descritas, diagrama de cableado y manual de 
usuario. 
Shelly2.5 puede funcionar en dos modos de dispositivo distintos: Relé y 
Atributos ..............................................................................................................................7 
Parametros estandard ..........................................................................................................8 
Atributos ..............................................................................................................................8 
Parámetros ...........................................................................................................................9 
Atributos ..............................................................................................................................9 
Parámetros ...........................................................................................................................9 
Atributos ............................................................................................................................10 
Parametros .........................................................................................................................10 
Atributos ............................................................................................................................11 
Parámetros .........................................................................................................................17 
Parámetros .........................................................................................................................18 
Atributos ............................................................................................................................18 
Parametros .........................................................................................................................25 
Atributos ............................................................................................................................25 
Atributos metros ................................................................................................................25 
Parametros .........................................................................................................................26 
Parametros .........................................................................................................................26 
Parametros .........................................................................................................................28 
Atributos ............................................................................................................................28 
Parametros .........................................................................................................................29 
Atributos ............................................................................................................................29 
Shelly2.5: Visión general ........................................................................................................31 
Parametros .........................................................................................................................38 
Atributos ............................................................................................................................38 
Atributos metros ................................................................................................................38 
Parametros .........................................................................................................................39 
Parametros .........................................................................................................................40 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
https://ssl.microsofttranslator.com/bv.aspx?ref=TAns&from=&to=es&a=https://shelly.cloud/shelly-25-wifi-smart-relay-roller-shutter-home-automation/
32 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Parametros .........................................................................................................................43 
Atributos ............................................................................................................................43 
Parametros .........................................................................................................................43 
Atributos ............................................................................................................................43 
Parametros .........................................................................................................................47 
Atributos ............................................................................................................................47 
Atributos metros ................................................................................................................47 
Parametros .........................................................................................................................48 
Parametros .........................................................................................................................50 
Atributos ............................................................................................................................50 
Parametros .........................................................................................................................53 
Atributos ............................................................................................................................53 
meters Atributos ................................................................................................................54 
Parametros .........................................................................................................................55 
Parametros .........................................................................................................................55 
Atributos ............................................................................................................................55 
Parametros .........................................................................................................................59 
Atributos ............................................................................................................................59 
Parametros .........................................................................................................................60 
Atributos ............................................................................................................................60 
Atributos ............................................................................................................................63 
Parametros .........................................................................................................................63 
Shelly Sense Schedule: /settings/?schedule .......................................................................63 
Parametros .........................................................................................................................64 
Shelly Sense Schedule rules: /settings/?schedule_rules ....................................................64 
Shelly Sense: /status...............................................................................................................64 
Atributos ............................................................................................................................65Parametros .........................................................................................................................66 
Atributos ............................................................................................................................66 
Parametros .........................................................................................................................66 
Parametros .........................................................................................................................67 
Ejemplos .............................................................................................................................67 
Shelly Sense: /ir/emit .............................................................................................................67 
Parametros .........................................................................................................................68 
Parametros .........................................................................................................................69 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
33 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Atributos ............................................................................................................................70 
Parametros .........................................................................................................................73 
Atributos ............................................................................................................................73 
Parametros .........................................................................................................................77 
Atributos ............................................................................................................................78 
Parametros .........................................................................................................................79 
Atributos ............................................................................................................................79 
RGBW2: /white/<n> ...............................................................................................................79 
funcionar en modo de relé. El modo de funcionamiento de Shelly2.5 se puede 
establecer a través del punto de conexión /settings. Los comandos para realizar 
acciones pueden provenir de: 
• Un interruptor de entrada físico (SW1/SW2). 
• Solicitud HTTP, a través de la interfaz web local. 
• Un comando enviado a través del servicio en la nube de Allterco o mensajes 
MQTT. 
• Un evento de programación semanal o un evento generado por el amanecer y 
el atardecer. 
 
 
 
Restablecimiento de fábrica 
Para realizar un restablecimiento de fábrica en un dispositivo Shelly2.5, hágalo 
pulsando el botón de usuario o los interruptores de entrada del relé: 
•Mantenga pulsado el botón de usuario durante 5 segundos para restablecer la 
configuración WiFi al modo AP; 
•Mantenga pulsado el botón de usuario durante 10 segundos para realizar un 
restablecimiento completo de fábrica; 
•Voltear un interruptor de entrada rápidamente 5 veces en el primer minuto después 
de encenderlo para realizar un restablecimiento completo de fábrica. 
 
Shelly2.5 en modo relé 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
34 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
En el modo de retransmisión, cada uno de los dos canales se controla individualmente 
y admite los comandos ON y OFF. 
Los canales de retransmisión admiten la configuración auto_on y auto_off: se trata de 
temporizadores en segundos que encenderán o apagarán el canal cuando se haya 
apagado o activado respectivamente, ya sea desde un conmutador físico o un 
comando de red. Por lo tanto, el usuario puede establecer un límite durante cuánto 
tiempo el canal puede estar encendido o apagado. 
Al encenderse, las salidas se inicializan utilizando una de las 4 estrategias disponibles: 
•Mantenga la salida desactivada 
•Activar la salida 
•Restaurar el estado de la salida desde antes de la pérdida de energía 
•Lea el estado del conmutador físico y configure la salida en consecuencia, si el tipo de 
entrada seleccionado puede proporcionar esta información. 
Los interruptores de entrada físicos pueden ser uno de los: 
•un interruptor momentáneo con botón; 
•un interruptor de palanca con dos estados estables; 
•un interruptor de "borde". En este modo de entrada, cada transición de estado del 
conmutador provoca un cambio del estado de salida. Esto se puede utilizar con la 
entrada de las instalaciones de conmutadores bidireccionales existentes; 
•separados, los eventos de las entradas se ignoran; 
•interruptor de activación: cada evento enciende el canal y restablece el temporizador 
de apagado automático. 
Para controlar Shelly2.5 en el modo de retransmisión, utilice estos recursos: 
•/settings/relay/{ndex} para configurar el comportamiento de cada canal 
•/relay/{índex} para controlar y supervisar el canal 
 
Shelly2.5 en modo Roller (persiana) 
En el modo Roller, el dispositivo se puede utilizar para controlar un motor 
bidireccional, con detección de obstáculos opcional y funciones de interruptor de 
seguridad. Los comandos son: Abrir, Cerrar, Detener y Establecer posición. 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
35 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Shelly2.5 tiene un único Roller lógico, pero indexamos los recursos HTTP para permitir 
dispositivos futuros con más canales de salida y Roller-s. 
Cuando Shelly2.5 esté en modo Roller, utilice: 
•/settings/roller/0 para configurar el comportamiento de este controlador Roller, 
incluidas las funciones avanzadas que se describen a continuación 
•/roller/0 para consultar el estado y enviar comandos 
Detección de obstáculos 
En el modo Roller, el medidor de potencia integrado de Shelly2.5 se puede utilizar para 
detectar la sobrecarga del motor, lo que generalmente significa algo que obstruye el 
movimiento de la puerta o del obturador de rodillos. Un conjunto de parámetros 
define el comportamiento de Shelly2.5 cuando se produce dicho evento. Estos son: 
•la dirección del movimiento para el que está habilitada la detección de obstáculos 
•la acción que se debe realizar cuando se produce el evento 
•número de segundos para esperar antes de activar la condición - los motores dibujan 
gran corriente inicial que puede ser falsamente interpretado como un obstáculo. 
 
 
 
 
 
Entrada de interruptor de seguridad 
Mientras que en el modo de rodillo y cuando las entradas están configuradas como 
"un botón", la segunda entrada física se puede utilizar como una entrada de seguridad 
- se puede vincular a un interruptor de parada final o botón de parada de seguridad del 
usuario. Sus parámetros de configuración son: 
•cuándo honrar los eventos en la entrada de seguridad: tanto en la dirección como en 
cualquier dirección de movimiento 
•qué hacer cuando el interruptor está activado: 
Pausa el movimiento, por lo que cuando el interruptor se desengancha continúa en la 
misma dirección 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
36 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
•qué comandos externos se permiten mientras se activalan las entradas de seguridad 
 
Control de posición 
Shelly2.5 se puede ordenar que mueva la puerta (cubierta, puerta corredera, etc.) a 
una posición relativa entre completamente abierta y completamente cerrada. Para 
que esta función funcione, el dispositivo debe realizar un procedimiento de 
calibración, midiendo el tiempo que se tarda en cerrar y abrir. Véase 
'/roller/0/calibrate' 
 
Shelly2.5: MQTT 
Shelly2.5 permite elcontrol y la supervisión a través de MQTT para los modos de relé y 
rodillo. El modo de dispositivo, junto con otros parámetros, deben configurarse 
mediante la aplicación móvil o la interfaz web. En cualquier modo, Shelly2.5 informa: 
•shellies/shellyswitch25-<deviceid>/input/<i> para cada entrada SW como <i> 
informa del estado actual como 0 o 1 
•shellies/shellyswitch25-<deviceid>/longpush/<i> para cada entrada SW como <i> un 
valor que indica el estado longpush como 0 o 1 
•shellies/shellyswitch25-<deviceid>/temperature informa de la temperatura interna 
del dispositivo en C 
•shellies/shellyswitch25-<deviceid>/overtemperature informa 1 cuando el dispositivo 
se ha sobrecalentado, normalmente 0 
MQTT en modo retransmisión 
En el modo de retransmisión, se pueden utilizar los siguientes temas para leer y 
establecer los canales de salida 0 y 1: 
•shellies/shellyswitch25-<deviceid>/relay/<i> para informar del estado: encendido, 
apagado o sobrepotencia 
•shellies/shellyswitch25-<deviceid>/relay/<i>/command acepta encendido, apagado 
o alternar 
 
El dispositivo mide el flujo de energía para cada canal e informa de estos valores en: 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
37 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
•shellies/shellyswitch-<deviceid>/relay/<i>/power informa de la tasa de consumo de 
energía instantánea en vatios 
•shellies/shellyswitch-<deviceid>/relay/<i>/energy informa la cantidad de energía 
consumida en [Watt-min] 
 
MQTT en modo Roller 
Cuando se configura para funcionar en modo de rodillo, los temas MQTT utilizados por 
Shelly2.5 son: 
•shellies/shellyswitch-<deviceid>/roller/0 informa del estado actual: abrir, cerrar 
mientras está en movimiento, detenerse cuando no se mueve. 
•shellies/shellyswitch-<deviceid>/roller/0/command acepta rc (realiza la calibración 
del rodillo), se abre, se cierra y se detiene. 
Para que el control de posición funcione, el dispositivo debe calibrarse correctamente, 
de modo que se conozca el tiempo necesario para el cierre y la apertura. 
•shellies/shellyswitch-<deviceid>/roller/0/pos informa de la posición actual en 
porcentaje 
•shellies/shellyswitch-<deviceid>/roller/0/command/pos acepta un número entre 0 y 
100, que es la posición objetivo en porcentaje. 
 
 
 
Shelly2.5 /settings 
Shelly2 amplía el punto final /settings común con datos específicos de relé y modo de 
rodillo, estado de consumo de energía y contiene la configuración de los relés y 
rodillos de este dispositivo y añade /settings/relay/N y /settings/roller/M para 
configurar los parámetros. 
HTTP: 
 
 
 
GET /settings?mode=relay 
 
{ 
 "name": "shellyswitch-163248", 
 "mode": "relay", 
 "max_power": 1840, 
 "relays": [ ... ], 
 "rollers": [ ... ], 
 "meters": [{"power": 0, "is_valid": true, "counters": [5, 4, 3]}, 
...] 
} 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
38 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
Parametros 
Parametros Tipo Descripción 
mode cadena Los valores aceptados son relé y roller (persiana 
max_power numero Umbral de sobrepotencia en vatios 
Atributos 
Atributo Tipo Descripción 
relays array of hashes Consulte /settings/relay para obtener una explicación de los 
valores 
rollers array of hashes Consulte /settings/roller para obtener una explicación de los 
valores 
meters array of hashes Contiene el estado del medidor de potencia integrado. 
Atributos metros 
Atributo Tipo Descripción 
is_valid boolean Si la medición de potencia se auto comprueba ok 
power numero Corriente real de alimentación de CA que se está dibujando, en vatios 
 
 
 
 
 
 
 
 
Shelly2.5: /settings/relay/{index} 
El documento devuelto aquí es idéntico a los datos devueltos en /settings para el canal 
de salida determinado en la matriz relays. Los atributos coinciden con el conjunto de 
parámetros aceptados. 
 HTTP: 
 
 
 
GET /settings/relay/0 
 
{ 
 "ison": false, 
 "has_timer": false, 
 "overpower": false, 
 "default_state": "off", 
 "btn_Tipo": "toggle", 
 "auto_on": 0, 
 "auto_off": 0, 
 "schedule": true, 
 "schedule_on": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX", 
 "schedule_off": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX", 
 "sun": true, 
 "sun_on_times": "0000000000000000000000000000", 
 "sun_off_times": "0000000000000000000000000000" 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
39 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
 
 
 
Parametros 
Parametro Tipo Descripción 
reset Cualquier El envío de un valor no vacío restablecerá la 
configuración de este canal de salida de 
retransmisión a los valores predeterminados de 
fábrica. 
default_state Cadena Valores aceptados: apagado, encendido, último, 
interruptor 
btn_Tipo Cadena Valores aceptados: momentáneo, alternar, borde y 
desprendido. 
auto_on Número Temporizador automático de retroceso, segundos. Se 
activará después de apagar el canal. 
auto_off Número Temporizador automático de retroceso, segundos. Se 
activará después de encender el canal. 
btn_reverse bool Invertir el estado del interruptor de entrada 
schedule bool Activar o desactivar horarios y comandos de salida y 
puesta del sol para este canal 
schedule_rules array of 
strings 
Definición de comandos programados 
max_power numero Umbral de sobrepotencia por canal (utilizado en 
modo de relé) 
 
La matriz de contadores contiene los valores del contador de energía por canal para los 
últimos 3 minutos redondos. El valor siempre aumentará, pero se restablecerá a cero 
al reiniciar o al ciclo de alimentación. Al observar este valor (sobre MQTT o sondeo 
HTTP) el observador debe mantener un acumulador localmente y agregar el nuevo 
valor cada vez que vaya hacia atrás. 
Shelly2.5: /settings/roller/{index} 
El documento devuelto aquí es idéntico a los datos devueltos en /settings como un 
hash en los rodillos. Los atributos coinciden con el conjunto de parámetros aceptados. 
 HTTP: 
 
 
GET /settings/roller/0 
 
{ 
 "maxtime": 20, 
 "default_state": "stop", 
 "swap": false, 
 "input_mode": "openclose", 
 "button_Tipo": "toggle", 
 "btn_reverse": 0, 
 "state": "stop", 
 "safety_switch": false, 
 "schedule": false, 
 "schedule_rules": [], 
 "obstacle_mode": "disabled", 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
40 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Parametros 
Parametro Tipo Descripción 
reset Cualquier El envío de un valor no vacío restablecerá la configuración 
del rodillo a los valores predeterminados de fábrica 
maxtime Número El tiempo máximo necesario para que el mecanismo se abra 
o cierre por completo, segundos. 
default_state Cadena Uno de parada, abierto, cerca. Este parámetro determina el 
comportamiento en el encendido. 
swap Booleana Si desea intercambiar direcciones abiertas y cercanas 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
41 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
input_mode Cadena Uno de openclose - cada entrada controla una dirección de 
movimiento, un botón - un solo botón presiona ciclos a 
través de los estados: abrir, detener, cerrar, detener ... 
btn_Tipo Cadena Uno de momentáneo, alternar o desmontar. 
obstacle_mode Cadena Uno de deshabilitado, while_opening, while_closing, 
while_moving. 
obstacle_action Cadena Uno de parada, marcha atrás. 
obstacle_power Número Umbral de potencia para activar la condición "obstáculo", 
vatios. 
obstacle_delay Número Número de segundos que hay que esperar después de 
encender el motor antes de activar la detección de 
obstáculos 
safety_mode Cadena Uno de deshabilitado,while_opening, while_closing, 
while_moving 
safety_action Cadena Uno de parada, pausa, marcha atrás. 
safety_allowed_on_trigger Cadena Qué comandos se permiten mientras se activa el 
interruptor de seguridad: ninguno, abierto, cerca, todo. 
btn_reverse bool Si invertir el estado del interruptor de entrada antes de 
interpretarlo 
positioning Número Si el control de posición es posible (la calibración se realizó 
y tuvo éxito) 
off_power Número Valor de potencia por debajo del cual el rodillo se considera 
"detenido", es decir, el actuador se detiene mediante un 
interruptor de parada final 
schedule bool Activar o desactivar horarios y comandos de salida y puesta 
del sol para este canal 
schedule_rules matriz de 
cadenas 
Definición de comandos programados 
 
 
 
 
 
 
Shelly2.5: /status 
Shelly2.5 añade información sobre el estado actual de los canales de salida, el 
dispositivo lógico "roller" y la medición de potencia. 
 HTTP: 
 
GET /status 
 
"relays": [ 
{ 
 "ison": false, 
 "has_timer": false, 
 "overpower": false, 
 "is_valid": true 
}, 
{ 
 "ison": false, 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
42 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Atributo Tipo Descripción 
relays array of hashes Contiene el estado actual de los canales de salida del relé. 
Consulte /relay/N para obtener una descripción de los 
atributos 
rollers array of hashes Contiene el estado actual del dispositivo lógico "roller". 
Consulte /roller/N para la descripción de los atributos 
meters array of hashes Estado actual de los medidores de potencia 
 
 
 
 
Shelly2.5: /relay/{index} 
Muestra el estado actual de cada canal de salida y acepta comandos para controlar el 
canal. Esto sólo se puede utilizar cuando el modo de dispositivo está configurado para 
retransmitir a través de /settings 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
43 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Parametros 
Parametro Tipo Descripción 
turn cadena Los valores aceptados están activados y desactivados. Esto 
encenderá/apagará el canal de salida respectivo cuando se 
envíe la solicitud. 
timer numero Un temporizador de un disparo en segundos 
Atributos 
Atributo Tipo Descripción 
ison boolean Si el canal está encendido o apagado 
has_timer boolean Si un temporizador está actualmente armado para este canal 
overpower boolean Si una condición de sobrepotencia apagó el canal 
is_valid boolean Si el medidor de potencia asociado funciona correctamente 
 
Shelly2.5: /roller/{index} 
Controla el dispositivo lógico "roller" y recupera su estado actual. Cuando go-to_pos, 
roller_pos también debe ser especificado y válido. 
 
Parametros 
Parametro Tipo Descripción 
go Cadena Los valores aceptados son open, close, stop y to_pos 
roller_pos Número Posición deseada en porcentaje 
duration Número Si se especifica, el motor se moverá durante este período en 
segundos. Si falta, se utilizará el valor de maxtime en 
/settings/roller/N. 
Atributos 
Atributo Tipo Descripción 
state bool Uno de parada, abierto, cerca 
power numero Consumo de energía actual en vatios 
is_valid bool Si el medidor de potencia funciona correctamente 
safety_switch bool Si la entrada de seguridad está activada actualmente 
stop_reason bool Ultima causa para detenerse: normal, safety_switch, 
obstáculo 
last_direction bool Ultima dirección de movimiento, abrir o cerrar 
 
 
Shelly2.5: /roller/{index}/calíbrate 
Al solicitar este punto final se desencadenará un procedimiento de calibración que se 
realizará. Shelly2.5 medirá el tiempo necesario para abrir y cerrar el dispositivo 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
44 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
mecánico bajo control. Una vez que esto se complete con éxito, Shelly2.5 será capaz 
no sólo de abrir y cerrar, pero apuntar a una posición específica entre los dos. El 
procedimiento abrirá y cerrará la cubierta accionada (puerta, persiana enrollable, etc.) 
detectando cuando se alcanza una posición final. El dispositivo almacenará los tiempos 
medios de apertura y cierre y los utilizará cuando se emita un comando go-to_pos. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Shelly4Pro 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
45 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
 
 
4Pro: Visión general 
 
Shelly4pro es un relé conectado WiFi montable en DIN de 4 canales con medidores de 
potencia para cada canal. Con Shelly4Pro puedes controlar 4 circuitos eléctricos, 10 
amperios cada uno (4 x 2300 W). También puede supervisar el consumo en tiempo 
real. Visite la página del producto para obtener más información y descargar el Manual 
del usuario: 
 
https://shelly.cloud/shelly-4-pro/ 
 
El modo de funcionamiento de 4Pro se puede configurar a través del punto final 
/settings. Los comandos para realizar acciones pueden provenir de: 
•Un botón físico 
•Solicitud HTTP, a través de la interfaz web local 
•Un comando enviado a través de la nube 
•Un evento de programación semanal o un evento generado por el amanecer y el 
atardecer 
 
 
 
 
Restablecimiento de fábrica 
 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
https://ssl.microsofttranslator.com/bv.aspx?ref=TAns&from=&to=es&a=https://shelly.cloud/shelly-4-pro/
46 
Traducción de la pagina de shelly …. FAMILIA SHELLY por miracomovoy (Telegram) 
Si no se puede acceder a la interfaz web del dispositivo, los ajustes se pueden volver a 
los valores predeterminados pulsando y manteniendo pulsado el botón del dispositivo 
durante más de 10 segundos o hasta que la luz led comience a parpadear 
rápidamente. 
 
Acerca del dispositivo 
 
Cada uno de los cuatro canales se controla individualmente y admite los comandos ON 
y OFF. En este modo, se puede habilitar un umbral de sobrepotencia para cada uno de 
los canales, a través del parámetro max_power en /settings. Si se establece en un valor 
distinto de 0, el relé se apagará automáticamente si el consumo de energía actual 
supera: 
•el valor de max_power cuando solo un canal está activado 
•el doble del valor de max_power cuando ambos canales están encendidos 
 
Los canales de retransmisión también admiten la configuración auto_on y auto_off: 
estos son temporizadores en segundos que encenderán o apagarán el canal cuando se 
haya apagado o activado respectivamente, ya sea desde un conmutador físico o un 
comando de red. Por lo tanto, el usuario puede establecer un límite durante cuánto 
tiempo el canal puede estar encendido o apagado. 
 
Al encender, las salidas se inicializan usando una de estas estrategias: 
•Mantenga la salida desactivada 
•Activar la salida 
•Restaurar el estado de la salida desde antes de la pérdida de energía 
•Lea el estado del conmutador físico y configure la salida en consecuencia. 
 
Los interruptores de entrada físicos pueden ser uno de los: 
•un interruptor momentáneo con botón 
•un interruptor de palanca con dos estados estables 
•un interruptor de "borde". En este modo de entrada, cada transición de estado del 
conmutador provoca un cambio del estado de salida. Esto se puede utilizar con la 
entrada de las instalaciones de conmutadores bidireccionales existentes. 
 
Nota: La configuración del estado de salida en función de las entradas encendidas no 
se admite cuando las entradas se configuran como momentáneas o perimetrales. 
 
Para controlar Shelly4Pro en modo de retransmisión, utilice estos recursos: 
 
/settings/relay/'index' para configurar el comportamiento de cada canal /relay/'index' 
para controlar y supervisar el canal 
https://shelly-api-docs.shelly.cloud/#shelly-family-overview
47 
Traducción de la