pywizlight
Version 0.5.14
WiZ デバイス用の Python コネクタ。
https://docs.pro.wizconnected.com/#introduction
pip install pywizlight注: Python バージョン>=3.7が必要です。
pywizlightが Fedora パッケージ コレクションに存在するため、Fedora ベースのシステムまたは EPEL が有効になっている CentOS/RHEL 8 マシン上で。
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 Light Bulb のインスタンスを作成します。電球の IP addCancel 変更ストレスを使用して構築されます。
まず、 light.updateState()を呼び出して状態を取得する必要があります。その後、すべての状態をPilotParserオブジェクトであるlight.stateから取得できます。
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 を返します。 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)ライトをオンにします。これは、RGB、色温度、明るさなどのすべてのパラメータをプログラムで設定するために使用できるPilotBuilderオブジェクトを受け取ります。ライトをリズム モードに設定するには、空の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}}
