pywizlight
Version 0.5.14
用於 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}}
