用于 WiZ 设备的 Python 连接器。
https://docs.pro.wizconnected.com/#introduction
pip install pywizlight
注意:需要 Python 版本>=3.7
。
在基于 Fedora 的系统或启用了 EPEL 的 CentOS/RHEL 8 计算机上,因为pywizlight
存在于 Fedora Package Collection 中。
sudo dnf -y install python3-pywizlight
对于 NixOS 和 Nix,最新版本的pywizlight
通常可在unstable
通道中获取。稳定版本可能会附带旧版本的pywizlight
。
nix-env -iA nixos.python37Packages.pywizlight
赛斯·尼克尔 | 大卫·祖罗 | 爱德华多·伊巴内斯 | 安加德·辛格 | 法比安·阿福尔特 | 亨利·鲁斯 | 阿尔贝托·帕努 |
生锈的 | 马蒂亚斯·罗斯 | 杜尔内兹 | 诺埃尔 | 帕特里克·凯利 | 埃利斯·迈克尔 | 古根·拉维库玛 |
夏洛特 | 阿尔尼·科斯凯拉 | UH-60 | J·尼克·科斯顿 |
要通过 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 广播请求一起使用,并收集网络中的所有灯泡。
对于异步 I/O,该组件使用 Python 的内置 asyncio DatagramTransport,它允许完全非阻塞 UDP 传输。
wizlight(ip)
:创建 WiZ 灯泡的实例。用灯泡的 IP addCancel Changesress 构建。
首先,您需要通过调用light.updateState()
来获取状态。之后,可以从light.state
获取所有状态,这是一个PilotParser
对象。
PilotParser.get_brightness()
获取亮度0-255的值
PilotParser.get_rgb()
获取灯泡的rgbW颜色状态
PilotParser.get_colortemp()
获取灯泡的色温
PilotParser.get_warm_white/get_cold_white()
获取当前的暖/冷设置(原装飞利浦 Wiz 灯泡不支持)
PilotParser.get_scene()
获取当前场景名称
PilotParser.get_state()
返回 True/False。 True=开,False=关
getBulbConfig(self)
返回灯泡的硬件配置
updateState(self)
使用sendUDPMessage
从灯获取当前灯泡状态并将其设置为self.state
lightSwitch(self)
像开关一样打开或关闭灯泡
getMAC(self)
返回灯泡的 MAC 地址。可用作唯一ID
sendUDPMessage(self, message, timeout = 60, send_interval = 0.5, max_send_datagrams = 100):
将 UDP 消息发送到灯泡。由于 UDP 可能会丢失数据包,并且您的灯可能距离路由器很远,因此我们不断发送 UDP 命令数据报,直到灯泡做出响应。在测试中,这比仅仅发送一次并等待超时要好得多。您可以使用timeout
设置异步操作超时,使用send_interval
设置连续 UDP 发送之间的睡眠时间间隔,并使用max_send_datagrams
设置要发送的连续 ping 的最大数量。它已经被硬编码为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}}