Control a Tuya Ceiling fan over LAN.
Project description
local-tuya-ceiling-fan
Control a Tuya Ceiling fan over LAN.
Features
- asynchronous methods and transport
- persistent communication to the device
- automatic remote device state updates (remotes can still be used)
- configurable buffering for subsequent updates
- constraints between device commands
- Domoticz plugin using a dedicated thread
Usage
See local tuya requirements first to find device information.
Example usage:
from local_tuya import DeviceConfig, ProtocolConfig
from local_tuya_ceiling_fan import FanDevice, FanSpeed
async with FanDevice(DeviceConfig(ProtocolConfig("{id}", "{address}", b"{key}"))) as device:
await device.switch(True)
await device.set_speed(FanSpeed.L2)
await device.switch(False)
💡 There is a safety mechanism that turns off the fan and waits 30s before changing the direction.
Domoticz plugin
The plugin requires having fetched device information using instructions above. Make sure to read plugin instructions first.
💡 The Domoticz version should be
2022.1
or higher.
python -m pip install --upgrade local-tuya-ceiling-fan[domoticz]
python -m local_tuya_ceiling_fan.domoticz.install
Domoticz path defaults to ~/domoticz
but you can pass a -p
option to the second command to change that:
python -m local_tuya_ceiling_fan.domoticz.install -p /some/other/path
Restart Domoticz and create a new Hardware using Tuya Ceiling Fan
. Fill in device information and add.
The hardware will create up to 5 devices to control the fan (all prefixed with hardware name):
power
: turn the fan on or offspeed
: set the speeddirection
: set directionlight
: turn the light on or offmode
: set the operating mode
You can customize the devices you want added in the hardware page.
All device names and levels can be changed once added as only IDs are used internally.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for local_tuya_ceiling_fan-2.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | f14c88797187ccada0376cb11b3453c555084feaa33ac29307926538c7aa02ea |
|
MD5 | ce07ffcb46bdd9fc1017cffa6950edb9 |
|
BLAKE2b-256 | c2a4bcc0c8a6d853c785d9bed79d9f8ecd4574f2c8ae486628ffe883f31b1e8f |
Hashes for local_tuya_ceiling_fan-2.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8c22a79a814244ce80ee17c4a4f9e5d875bbce97f04852d90a6d40084aa9d78d |
|
MD5 | 8a5619605b9c0079d64b902d903a3150 |
|
BLAKE2b-256 | d8c956c75a97b974279ee295aba1fc8c43bc0bde04bd3ae068e47ed2565ed7c2 |