https://github.com/Danielhiversen/pySwitchbot

Retha Runolfsson 00f530dc48 Add support for hub3 (#337) преди 1 седмица
.github 95e4054c0c chore(ci): bump codecov/codecov-action from 5.4.0 to 5.4.2 in the github-actions group (#324) преди 3 седмици
scripts 5e58ac7cde Finish enabling ruff rules (#327) преди 3 седмици
switchbot 00f530dc48 Add support for hub3 (#337) преди 1 седмица
tests 00f530dc48 Add support for hub3 (#337) преди 1 седмица
.gitignore 3175309f58 Fix issue with SB password issue and Temp issue. (#28) преди 3 години
.isort.cfg 93ecb3aabd fix: drop python 3.10 support since it does not have StrEnum (#242) преди 11 месеца
.pre-commit-config.yaml 23ab4ee8e1 chore(pre-commit.ci): pre-commit autoupdate (#332) преди 2 седмици
.travis.yml 93ecb3aabd fix: drop python 3.10 support since it does not have StrEnum (#242) преди 11 месеца
LICENSE 555bc08aa5 Initial commit преди 6 години
MANIFEST.in a6068bbc4d Add MANIFEST.in (#19) преди 4 години
README.md b0d759a485 Add codecov to readme (#333) преди 2 седмици
pyproject.toml 5e58ac7cde Finish enabling ruff rules (#327) преди 3 седмици
requirements.txt 067989c8c1 Fix lock encryption key retrieval (#236) преди 1 година
requirements_dev.txt 067989c8c1 Fix lock encryption key retrieval (#236) преди 1 година
setup.py 29f8294a7b Release 0.62.2 (#336) преди 1 седмица

README.md

pySwitchbot codecov

Library to control Switchbot IoT devices https://www.switch-bot.com/bot

Obtaining encryption key for Switchbot Locks

Using the script scripts/get_encryption_key.py you can manually obtain locks encryption key.

Usage:

$ python3 get_encryption_key.py MAC USERNAME
Key ID: XX
Encryption key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Where MAC is MAC address of the lock and USERNAME is your SwitchBot account username, after that script will ask for your password. If authentication succeeds then script should output your key id and encryption key.

Examples:

WoLock (Lock-Pro)

Unlock:

import asyncio
from switchbot.discovery import GetSwitchbotDevices
from switchbot.devices import lock
from switchbot.const import SwitchbotModel

BLE_MAC="XX:XX:XX:XX:XX:XX" # The MAC of your lock
KEY_ID="XX" # The key-ID of your encryption-key for your lock
ENC_KEY="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" # The encryption-key with key-ID "XX"
LOCK_MODEL=SwitchbotModel.LOCK_PRO # Your lock model (here we use the Lock-Pro)


async def main():
    wolock = await GetSwitchbotDevices().get_locks()
    await lock.SwitchbotLock(
        wolock[BLE_MAC].device, KEY_ID, ENCRYPTION_KEY, model=LOCK_MODEL
    ).unlock()


asyncio.run(main())

Lock:

import asyncio
from switchbot.discovery import GetSwitchbotDevices
from switchbot.devices import lock
from switchbot.const import SwitchbotModel

BLE_MAC="XX:XX:XX:XX:XX:XX" # The MAC of your lock
KEY_ID="XX" # The key-ID of your encryption-key for your lock
ENC_KEY="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" # The encryption-key with key-ID "XX"
LOCK_MODEL=SwitchbotModel.LOCK_PRO # Your lock model (here we use the Lock-Pro)


async def main():
    wolock = await GetSwitchbotDevices().get_locks()
    await lock.SwitchbotLock(
        wolock[BLE_MAC].device, KEY_ID, ENCRYPTION_KEY, model=LOCK_MODEL
    ).lock()


asyncio.run(main())

WoCurtain (Curtain 3)

import asyncio
from pprint import pprint
from switchbot import GetSwitchbotDevices
from switchbot.devices import curtain


async def main():
    # get the BLE advertisement data of all switchbot devices in the vicinity
    advertisement_data = await GetSwitchbotDevices().discover()

    for i in advertisement_data.values():
        pprint(i)
        print()  # print newline so that devices' data is separated visually

    # find your device's BLE address by inspecting the above printed debug logs, example below
    ble_address = "9915077C-C6FD-5FF6-27D3-45087898790B"
    # get the BLE device (via its address) and construct a curtain device
    ble_device = advertisement_data[ble_address].device
    curtain_device = curtain.SwitchbotCurtain(ble_device, reverse_mode=False)

    pprint(await curtain_device.get_device_data())
    pprint(await curtain_device.get_basic_info())
    await curtain_device.set_position(100)


if __name__ == "__main__":
    asyncio.run(main())