pydanalock-ble

Unofficial async Python client library for Danalock V3 smart locks over Bluetooth Low Energy. Key material is obtained from the sibling cloud client pydanalock-cloud and passed in as opaque bytes.

from pydanalock.ble import DanalockLock

lock = DanalockLock(
    "AA:BB:CC:DD:EE:FF",
    serial=bytes.fromhex("010203040506"),
    login_token=blob_from_your_cloud_client,
    trust_anchor=anchor_der_bytes,
)
async with lock:
    print(await lock.state())
    print(await lock.battery())

unlock() and lock() are only ever called by your code — the library never moves the lock implicitly.

Disclaimer. This project is unofficial and is not affiliated with, endorsed by, or sponsored by Danalock AS or Poly-Control. It is built for interoperability with devices you own. Use it at your own risk; only control devices you are authorized to control.

Install

pip install pydanalock-ble

Status

Work in progress. Development is spec-first; see specs/ for the protocol specifications and their status.

Implemented:

• DMI frame codec (envelope, byte stuffing, CRC-16) — spec 0001
• Reliable delivery layer (sequence/acknowledgement, retransmissions) and GATT transport — spec 0002
• TLS 1.2 session (ECDHE-ECDSA-AES-256-GCM-SHA384, extended master secret, lock certificate validation) — spec 0003
• Application command layer and the public async DanalockLock API (connect/login/state/battery/unlock/lock) — spec 0004
• Passive state from BLE advertisements — spec 0005
• Lock settings read and write (read 4.6, one-member writes with verification reads) — spec 0006
• Device information read (product, hardware version, firmware version, firmware identifier) — spec 0008

Requirements

• Python >= 3.11
• bleak >= 3.0
• cryptography >= 44

Development

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/ruff check .
.venv/bin/ruff format --check .
.venv/bin/mypy
.venv/bin/pytest -m "not live"

Synthetic protocol test vectors (shape mirrors observed frames; no real device data) live in tests/vectors/. Live tests (real lock) stay behind the live marker and are run manually only.

License

MIT