aioswitcher

Switcher Python Integration.


Keywords
home, automation, switcher, smart, contributors-welcome, hacktoberfest, looking-for-contributors, looking-for-maintainer, maintainer-wanted, pypi-package, smart-switch, smarthome
License
Apache-2.0
Install
pip install aioswitcher==2019.3.20

Documentation

Help Wanted

Aioswitcher project is looking for maintainers and contributors!
For various reasons, I can only keep maintaining this project as far as dependency bumps and publishing.
As for new features and the occasional bug support, these will require other maintainers/contributors.

If that's you - please feel free to ping me and I will do all I can to make the onboarding process easy.

Switcher Python Integration
pypi-version pypi-downloads license-badge

gh-build-status gh-pages-status codecov

PyPi module integrating with various Switcher devices.
Check out the wiki pages for a list of supported devices.

pip install aioswitcher
Documentation Wiki Contributing

Example Usage

State Bridge
async def print_devices(delay):
    def on_device_found_callback(device):
        # a switcher device will broadcast a state message approximately every 4 seconds
        print(asdict(device))

    async with SwitcherBridge(on_device_found_callback):
        await asyncio.sleep(delay)

# run the bridge for 60 seconds
asyncio.run(print_devices(60))
Power Plug API
async def control_power_plug(device_ip, device_id, device_key) :
    # for connecting to a device we need its id, login key and ip address
    async with SwitcherType1Api(device_ip, device_id, device_key) as api:
        # get the device current state
        await api.get_state()
        # turn the device on
        await api.control_device(Command.ON)
        # turn the device off
        await api.control_device(Command.OFF)
        # set the device name to 'my new name'
        await api.set_device_name("my new name")

asyncio.run(control_power_plug("111.222.11.22", "ab1c2d", "00"))
Water Heater API
async def control_water_heater(device_ip, device_id, device_key) :
    # for connecting to a device we need its id, login key and ip address
    async with SwitcherType1Api(device_ip, device_id, device_key) as api:
        # get the device current state
        await api.get_state()
        # turn the device on for 15 minutes
        await api.control_device(Command.ON, 15)
        # turn the device off
        await api.control_device(Command.OFF)
        # set the device name to 'my new name'
        await api.set_device_name("my new name")
        # configure the device for 02:30 auto shutdown
        await api.set_auto_shutdown(timedelta(hours=2, minutes=30))
        # get the schedules from the device
        await api.get_schedules()
        # delete and existing schedule with id 1
        await api.delete_schedule("1")
        # create a new recurring schedule for 13:00-14:30
        # executing on sunday and friday
        await api.create_schedule("13:00", "14:30", {Days.SUNDAY, Days.FRIDAY})

asyncio.run(control_water_heater("111.222.11.22", "ab1c2d", "00"))
Runner API
async def control_runner(device_ip, device_id, device_key) :
    # for connecting to a device we need its id, login key and ip address
    async with SwitcherType2Api(device_ip, device_id, device_key) as api:
        # get the device current state
        await api.get_shutter_state()
        # open the shutter to 30%
        await api.set_position(30)
        # stop the shutter if currently rolling
        await api.stop()

asyncio.run(control_runner("111.222.11.22", "ab1c2d", "00"))
Breeze API
async def control_breeze(device_ip, device_id, device_key, remote_manager, remote_id) :
    # for connecting to a device we need its id, login key and ip address
    async with SwitcherType2Api(device_ip, device_id, device_key) as api:
        # get the device current state
        await api.get_breeze_state()
        # initialize the Breeze RemoteManager and get the remote
        remote = remote_manager.get_remote(remote_id)
        # prepare a control command that turns on the Breeze
        # set to 24 degree (Celsius) cooling with vertical swing
        # send command to the device
        await api.control_breeze_device(
            remote,
            DeviceState.ON,
            ThermostatMode.COOL,
            24,
            ThermostatFanLevel.MEDIUM,
            ThermostatSwing.ON,
        )

# create the remote manager outside the context for re-using
remote_manager = SwitcherBreezeRemoteManager()
asyncio.run(control_breeze("111.222.11.22", "ab1c2d", "00", remote_manager, "DLK65863"))

Command Line Helper Scripts

Disclaimer

This is NOT an official module and it is NOT officially supported by the vendor.
That said, thanks are in order to all the people at Switcher for their cooperation and general support.

Contributors all-contributors

Thanks goes to these wonderful people (emoji key):

Aviad Golan
Aviad Golan

🔣
Dolev Ben Aharon
Dolev Ben Aharon

📖
Fabian Affolter
Fabian Affolter

💻
Itzik Ephraim
Itzik Ephraim

💻
Kesav890
Kesav890

📖
Liad Avraham
Liad Avraham

💻
Or Bin
Or Bin

💻
Shai rod
Shai rod

🔣
Shay Levy
Shay Levy

💻 🤔
YogevBokobza
YogevBokobza

💻 ⚠️ 🚧
dmatik
dmatik

📝 🤔 📓
jafar-atili
jafar-atili

💻 📖