pywizlight
Version 0.5.14
Коннектор Python для устройств WiZ.
https://docs.pro.wizconnected.com/#introduction
pip install pywizlight Примечание. Требуется версия Python >=3.7 .
В системе на базе Fedora или на компьютере CentOS/RHEL 8 с включенным EPEL, поскольку pywizlight присутствует в коллекции пакетов Fedora.
sudo dnf -y install python3-pywizlight Для NixOS и Nix последняя версия pywizlight обычно доступна в unstable канале. Стабильные выпуски могут включать в себя более старые версии pywizlight .
nix-env -iA nixos.python37Packages.pywizlightСет Никелл | Дэвид Зуров | Эдуардо Ибаньес | Ангад Сингх | Фабиан Аффольтер | Генри Рус | Альберто Пану |
бегающий, ржавый | Матиас Рот | дурнеж | Ноэль | Патрик Келли | Эллис Майкл | Гуган Равикумар |
Шарлотта | Аарни Коскела | УХ-60 | Дж. Ник Костон |
Чтобы найти лампочки через cli, вы можете использовать следующее:
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 — это инструмент командной строки для выполнения основных взаимодействий с лампочками.
$ 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}
Запустите команду wizlight COMMAND --help чтобы просмотреть использование и параметры.
Обнаружение работает с запросом UDP Broadcast и собирает все лампочки в сети.
Для асинхронного ввода-вывода этот компонент использует встроенный в Python asyncio DatagramTransport, который обеспечивает полностью неблокируемый транспорт UDP.
wizlight(ip) : Создает экземпляр лампочки WiZ. Создан с помощью IP-адреса addCancel, изменяющего лампочку.
Сначала вам нужно получить состояние, вызвав light.updateState() . После этого все состояния можно получить из light.state , который является объектом PilotParser .
PilotParser.get_brightness() получает значение яркости от 0 до 255.
PilotParser.get_rgb() получает цветовое состояние лампочки rgbW.
PilotParser.get_colortemp() получает цветовую температуру лампочки.
PilotParser.get_warm_white/get_cold_white() получает текущие настройки теплого/холодного света (не поддерживается оригинальными лампами Philips Wiz)
PilotParser.get_scene() получает имя текущей сцены.
PilotParser.get_state() возвращает True/False. Истина = вкл., Ложь = выкл.
getBulbConfig(self) возвращает аппаратную конфигурацию лампочки.
updateState(self) получает текущее состояние лампочки от источника света с помощью sendUDPMessage и устанавливает для него значение self.state
lightSwitch(self) включает или выключает лампочку, как переключатель
getMAC(self) возвращает MAC-адрес лампочки. Может использоваться как уникальный идентификатор.
sendUDPMessage(self, message, timeout = 60, send_interval = 0.5, max_send_datagrams = 100): отправляет UDP-сообщение в лампочку. Поскольку UDP может терять пакеты, а ваш светильник может находиться на большом расстоянии от маршрутизатора, мы постоянно продолжаем отправлять дейтаграмму команды UDP, пока не получим ответ от лампочки. В тестах это работало намного лучше, чем просто отправить один раз и дождаться таймаута. Вы можете установить тайм-аут асинхронной операции с помощью timeout , установить временной интервал ожидания между непрерывными отправками UDP с помощью send_interval и максимальное количество непрерывных пингов для отправки с помощью max_send_datagrams . В нем уже жестко запрограммировано более низкое значение для setPilot (установка состояния освещения) и getPilot (выборка состояния освещения), чтобы избежать мерцания света.
turn_off(self) выключает свет
turn_on(PilotBuilder) включает свет. Для этого требуется объект PilotBuilder , с помощью которого можно программно задать все параметры — RGB, цветовую температуру, яркость и т. д. Чтобы установить свет в ритмический режим, создайте пустой PilotBuilder .
get_power(self) возвращает текущее энергопотребление умной розетки с измерением.
Отправить сообщение лампочке: {"method":"setPilot","params":{"r":255,"g":255,"b":255,"dimming":50}} Ответ: {"method":"setPilot","env":"pro","result":{"success":true}}
Получить состояние лампочки: {"method":"getPilot","params":{}} Ответы:
пользовательский цветовой режим:
{'method': 'getPilot', 'env': 'pro', 'result': {'mac': 'a8bb50a4f94d', 'rssi': -60, 'src': '', 'state': True, 'sceneId': 0, 'temp': 5075, 'dimming': 47}}
сюжетный режим:
{'method': 'getPilot', 'env': 'pro', 'result': {'mac': 'a8bb50a4f94d', 'rssi': -65, 'src': '', 'state': True, 'sceneId': 12, 'speed': 100, 'temp': 4200, 'dimming': 47}}
ритм-режим:
{'method': 'getPilot', 'env': 'pro', 'result': {'mac': 'a8bb50a4f94d', 'rssi': -63, 'src': '', 'state': True, 'sceneId': 14, 'speed': 100, 'dimming': 100, 'schdPsetId': 9}}
