Shelly Bulbs Gen3 podem ser controladas localmente através da sua Wi-Fi/LAN usando comandos HTTP diretos.
Isto é útil quando pretende que um dispositivo Shelly, automação, navegador, script local ou sistema de terceiros controle uma Shelly Bulb diretamente, sem depender da execução na nuvem.
Este tipo de controlo é frequentemente referido como comunicação Direta Dispositivo-para-Dispositivo, ou DDD.
ÍNDICE
- Antes de começar
- Shelly Multicolor Bulb Gen3
- Shelly Standard Bulb Gen3
- Referência rápida de comandos
- Resolução de problemas
------------------------------------------------------------------------------------------------------------------------------
Antes de começar
Certifique-se de que o dispositivo que envia o comando e a Shelly Bulb estão ligados à mesma rede local.
Também precisa de saber o endereço IP local da lâmpada.
Nos exemplos abaixo, substitua:
192.168.X.X
pelo endereço IP real da sua Shelly Bulb.
Exemplo:
http://192.168.1.82/...
------------------------------------------------------------------------------------------------------------------------------
Shelly Multicolor Bulb Gen3
A Shelly Multicolor Bulb Gen3 usa o componente RGBCCT.
Isto significa que a lâmpada suporta ambos:
Controlo de cor RGB para luz colorida
Controlo CCT para luz branca com temperatura de cor ajustável
O endpoint direto local é:
http://192.168.X.X/rgbcct/0?...
Ligar a lâmpada:
http://192.168.X.X/rgbcct/0?turn=on
Desligar a lâmpada:
http://192.168.X.X/rgbcct/0?turn=off
Alternar a lâmpada:
http://192.168.X.X/rgbcct/0?turn=toggle
Ligar a 50% de brilho:
http://192.168.X.X/rgbcct/0?turn=on&brightness=50
O brilho é definido de 0 a 100.
Valores de exemplo:
10 = muito fraco
50 = brilho médio
100 = brilho máximo
#Para Shelly Bulbs Gen3, use o novo endpoint rgbcct em vez do antigo comando /color/0!
#Novo comando Shelly Multicolor Bulb Gen3:
http://192.168.X.X/rgbcct/0?turn=on&red=255&green=86&blue=112&brightness=100
Os valores são:
red de 0 a 255
green de 0 a 255
blue de 0 a 255
brightness de 0 a 100
*O antigo parâmetro white=0 não é necessário no novo formato.*
A mesma Multicolor Bulb também pode ser usada como uma lâmpada de temperatura branca.
Exemplo de branco neutro:
http://192.168.X.X/rgbcct/0?turn=on&brightness=100&temp=4000
O valor temp é a temperatura de cor em Kelvin.
Valores típicos:
2700 = branco quente
4000 = branco neutro
6500 = branco frio
Usar efeitos de transição
http://192.168.X.X/rgbcct/0?turn=on&red=255&green=86&blue=112&brightness=100&transition=1000
O valor transition é em milissegundos.
1000 = 1 segundo
3000 = 3 segundos
5000 = 5 segundos
------------------------------------------------------------------------------------------------------------------------------
Shelly Standard Bulb Gen3
A Shelly Standard Bulb Gen3 usa o componente CCT.
Isto significa que controla apenas luz branca, com brilho e temperatura de cor ajustáveis.
O endpoint direto local é:
http://192.168.X.X/cct/0?...
Ligar a lâmpada:
http://192.168.X.X/cct/0?turn=on
Desligar a lâmpada:
http://192.168.X.X/cct/0?turn=off
Alternar a lâmpada:
http://192.168.X.X/cct/0?turn=toggle
Ligar a 50% de brilho:
http://192.168.X.X/cct/0?turn=on&brightness=50
O brilho é definido de 0 a 100.
Definir temperatura de cor branca:
Exemplo de branco neutro:
http://192.168.X.X/cct/0?turn=on&brightness=100&temp=4000
O valor temp é a temperatura de cor em Kelvin.
Também pode usar efeitos de transição.
http://192.168.X.X/cct/0?turn=on&brightness=100&temp=2700&transition=1000
O valor transition é em milissegundos.
1000 = 1 segundo
3000 = 3 segundos
5000 = 5 segundos
------------------------------------------------------------------------------------------------------------------------------
Referência rápida de comandos
Lâmpada Multicolor Gen3:
/rgbcct/0
Lâmpada Standard Gen3:
/cct/0
Ligar:
turn=on
Desligar:
turn=off
Alternar:
turn=toggle
Brilho:
brightness=0-100
Cor RGB:
red=0-255&green=0-255&blue=0-255
Temperatura do branco:
temp=2700-6500
Transição:
transition=1000
------------------------------------------------------------------------------------------------------------------------------
Resolução de problemas
Se o comando não funcionar, primeiro abra o endereço IP da lâmpada no seu navegador e confirme que a interface web da lâmpada está acessível.
Certifique-se de que o dispositivo que envia o comando e a lâmpada estão na mesma rede local.
Para Lâmpada Multicolor Gen3, use /rgbcct/0.
Para Lâmpada Standard Gen3, use /cct/0.
Não use o antigo endpoint /color/0 para Shelly Bulbs Gen3.