pywizlight
Version 0.5.14
Um conector Python para dispositivos WiZ.
https://docs.pro.wizconnected.com/#introduction
pip install pywizlight Nota: Requer a versão Python >=3.7 .
Em um sistema baseado em Fedora ou em uma máquina CentOS/RHEL 8 que tenha EPEL habilitado, já que pywizlight está presente na coleção de pacotes do Fedora.
sudo dnf -y install python3-pywizlight Para NixOS e Nix, a versão mais recente do pywizlight geralmente está disponível no canal unstable . Versões estáveis podem fornecer versões mais antigas do pywizlight .
nix-env -iA nixos.python37Packages.pywizlightSeth Nickell | David Zurow | Eduardo Ibáñez | Angad Singh | Fabian Affolter | Henrique Ruhs | Alberto Panu |
enferrujado | Mathias Roth | Durnezj | Noëlle | Patrick Kelly | Elis Michael | Gughan Ravikumar |
Charlotte | Aarni Koskela | UH-60 | J.Nick Koston |
Para encontrar lâmpadas via cli você pode usar o seguinte:
python -m pywizlight.cli discover import asyncio
from pywizlight import wizlight , PilotBuilder , discovery
async def main ():
"""Sample code to work with bulbs."""
# Discover all bulbs in the network via broadcast datagram (UDP)
# function takes the discovery object and returns a list of wizlight objects.
bulbs = await discovery . discover_lights ( broadcast_space = "192.168.1.255" )
# Print the IP address of the bulb on index 0
print ( f"Bulb IP address: { bulbs [ 0 ]. ip } " )
# Iterate over all returned bulbs
for bulb in bulbs :
print ( bulb . __dict__ )
# Turn off all available bulbs
# await bulb.turn_off()
# Set up a standard light
light = wizlight ( "192.168.1.27" )
# Set up the light with a custom port
#light = wizlight("your bulb's IP address", port=12345)
# The following calls need to be done inside an asyncio coroutine
# to run them from normal synchronous code, you can wrap them with
# asyncio.run(..).
# Turn the light on into "rhythm mode"
await light . turn_on ( PilotBuilder ())
# Set bulb brightness
await light . turn_on ( PilotBuilder ( brightness = 255 ))
# Set bulb brightness (with async timeout)
timeout = 10
await asyncio . wait_for ( light . turn_on ( PilotBuilder ( brightness = 255 )), timeout )
# Set bulb to warm white
await light . turn_on ( PilotBuilder ( warm_white = 255 ))
# Set RGB values
# red to 0 = 0%, green to 128 = 50%, blue to 255 = 100%
await light . turn_on ( PilotBuilder ( rgb = ( 0 , 128 , 255 )))
# Get the current color temperature, RGB values
state = await light . updateState ()
print ( state . get_colortemp ())
red , green , blue = state . get_rgb ()
print ( f"red { red } , green { green } , blue { blue } " )
# Start a scene
await light . turn_on ( PilotBuilder ( scene = 4 )) # party
# Get the name of the current scene
state = await light . updateState ()
print ( state . get_scene ())
# Get the features of the bulb
bulb_type = await bulbs [ 0 ]. get_bulbtype ()
print ( bulb_type . features . brightness ) # returns True if brightness is supported
print ( bulb_type . features . color ) # returns True if color is supported
print ( bulb_type . features . color_tmp ) # returns True if color temperatures are supported
print ( bulb_type . features . effect ) # returns True if effects are supported
print ( bulb_type . kelvin_range . max ) # returns max kelvin in INT
print ( bulb_type . kelvin_range . min ) # returns min kelvin in INT
print ( bulb_type . name ) # returns the module name of the bulb
# Turn the light off
await light . turn_off ()
# Do operations on multiple lights in parallel
#bulb1 = wizlight("<your bulb1 ip>")
#bulb2 = wizlight("<your bulb2 ip>")
# --- DEPRECATED in 3.10 see [#140](https://github.com/sbidy/pywizlight/issues/140)
# await asyncio.gather(bulb1.turn_on(PilotBuilder(brightness = 255)),
# bulb2.turn_on(PilotBuilder(warm_white = 255)))
# --- For >3.10 await asyncio.gather() from another coroutine
# async def turn_bulbs_on(bulb1, bulb2):
# await asyncio.gather(bulb1.turn_on(PilotBuilder(warm_white=255)), bulb2.turn_on(PilotBuilder(warm_white=255)))
# def main:
# asyncio.run(async turn_bulbs_on(bulb1, bulb2))
loop = asyncio . get_event_loop ()
loop . run_until_complete ( main ()) wizlight é uma ferramenta de linha de comando para realizar interações básicas com lâmpadas.
$ wizlight
Usage: wizlight [OPTIONS] COMMAND [ARGS]...
Simple command-line tool to interact with Wizlight bulbs.
Options:
--version Show the version and exit.
--help Show this message and exit.
Commands:
discover Discover bulb in the local network.
off Turn the bulb off.
on Turn the bulb on.
set-state Set the current state of a given bulb.
state Get the current state from the given bulb. $ wizlight discover --b 192.168.0.101
Search for bulbs in 192.168.0.101 ...
{'ip_address': '192.168.0.101', 'mac_address': 'a8bs4090193d'}
$ wizlight on --ip 192.168.0.101 --k 3000 --brightness 128
Turning on 192.168.0.101
$ wizlight off --ip 192.168.0.101
Turning off 192.168.0.101
$ wizlight state --ip 192.168.0.101
{'mac': 'a8bs4090193d', 'rssi': -57, 'src': '', 'state': False, 'sceneId': 0, 'temp': 3000, 'dimming': 50}
Execute wizlight COMMAND --help para ver o uso e as opções.
A descoberta funciona com uma solicitação UDP Broadcast e coleta todas as lâmpadas da rede.
Para E/S assíncrona, este componente usa o asyncio DatagramTransport integrado do Python, que permite transporte UDP completamente sem bloqueio.
wizlight(ip) : Cria uma instância de uma lâmpada WiZ. Construído com o IP addCancel changeress da lâmpada.
Primeiro você precisa buscar o estado chamando light.updateState() . Depois disso, todos os estados podem ser obtidos de light.state , que é um objeto PilotParser .
PilotParser.get_brightness() obtém o valor do brilho 0-255
PilotParser.get_rgb() obtém o estado da cor rgbW da lâmpada
PilotParser.get_colortemp() obtém a temperatura da cor da lâmpada
PilotParser.get_warm_white/get_cold_white() obtém a configuração atual de quente/frio (não compatível com lâmpadas Philips Wiz originais)
PilotParser.get_scene() obtém o nome da cena atual
PilotParser.get_state() retorna Verdadeiro/Falso. Verdadeiro = ativado, Falso = desativado
getBulbConfig(self) retorna a configuração de hardware da lâmpada
updateState(self) obtém o estado atual da lâmpada da luz usando sendUDPMessage e o define como self.state
lightSwitch(self) liga ou desliga a lâmpada como um interruptor
getMAC(self) retorna o endereço MAC da lâmpada. Pode ser usado como um ID exclusivo
sendUDPMessage(self, message, timeout = 60, send_interval = 0.5, max_send_datagrams = 100): envia a mensagem UDP para a lâmpada. Como o UDP pode perder pacotes e sua luz pode estar muito distante do roteador, continuamos enviando o datagrama de comando UDP até que haja uma resposta da lâmpada. Nos testes, isso funcionou muito melhor do que apenas enviar uma vez e aguardar o tempo limite. Você pode definir o tempo limite da operação assíncrona usando timeout , definir o intervalo de tempo para dormir entre envios UDP contínuos usando send_interval e o número máximo de pings contínuos para enviar usando max_send_datagrams . Ele já está codificado para um valor mais baixo para setPilot (definir estado de luz) vs getPilot (estado de busca de luz) para evitar oscilação da luz.
turn_off(self) apaga a luz
turn_on(PilotBuilder) acende a luz. Isso leva um objeto PilotBuilder , que pode ser usado para definir todos os parâmetros programaticamente - rgb, temperatura de cor, brilho, etc. Para definir a luz para o modo de ritmo, crie um PilotBuilder vazio.
get_power(self) retorna o consumo atual de energia de um Smart Plug com medição.
Envie mensagem para a lâmpada: {"method":"setPilot","params":{"r":255,"g":255,"b":255,"dimming":50}} Resposta: {"method":"setPilot","env":"pro","result":{"success":true}}
Obtenha o estado da lâmpada: {"method":"getPilot","params":{}} Respostas:
modo de cor personalizado:
{'method': 'getPilot', 'env': 'pro', 'result': {'mac': 'a8bb50a4f94d', 'rssi': -60, 'src': '', 'state': True, 'sceneId': 0, 'temp': 5075, 'dimming': 47}}
modo de cena:
{'method': 'getPilot', 'env': 'pro', 'result': {'mac': 'a8bb50a4f94d', 'rssi': -65, 'src': '', 'state': True, 'sceneId': 12, 'speed': 100, 'temp': 4200, 'dimming': 47}}
modo de ritmo:
{'method': 'getPilot', 'env': 'pro', 'result': {'mac': 'a8bb50a4f94d', 'rssi': -63, 'src': '', 'state': True, 'sceneId': 14, 'speed': 100, 'dimming': 100, 'schdPsetId': 9}}
