Skip to main content

hansa-ble-protocol

The wire protocol of Hansa and Oras electronic faucets that speak Bluetooth Low Energy: how to decode what they send, how to encode what they accept, and how the PIN exchange works.

This package handles bytes only. It opens no connections and pulls in no Bluetooth stack, so it runs and tests without hardware. The Home Assistant integration that uses it lives in the parent repository; how each byte offset was established is documented in docs/protocol.md.

from hansa_ble_protocol import parse_state_a, auth_response

state = parse_state_a(raw_bytes)
print(state["valve_open"], state["battery_level"])

# Answer the faucet's challenge with the PIN from the vendor app.
response = auth_response(nonce, password, "1234")

Not affiliated with, endorsed by, or supported by Hansa or Oras.

License

MIT

Release files for hansa-ble-protocol 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hansa-ble-protocol 0.3.0
File Size Uploaded
hansa_ble_protocol-0.3.0.tar.gz 5.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for hansa-ble-protocol 0.3.0
File Interpreter ABI Platform
hansa_ble_protocol-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 11.7 kB

Release files / hansa_ble_protocol-0.3.0.tar.gz

Download URL hansa_ble_protocol-0.3.0.tar.gz
Size 5.7 kB
Tags Source
SHA-256 checksum
How to use checksums
bbb1567020bc60d581d7c3b9dcbfffe8374ffa4c41610f3eb35661f65a5ff301
BLAKE2b-256 checksum
How to use checksums
42c23a14ef71f6780437d451a73b0ef372704bca39f61fae22156b3675ae7d81
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.

Transparency log

Release files / hansa_ble_protocol-0.3.0-py3-none-any.whl

Download URL hansa_ble_protocol-0.3.0-py3-none-any.whl
Size 6.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5717ce736ae85d803f0bf0ad46517f4c2dd4ac671bb1f925e2fbd17f10d0bd73
BLAKE2b-256 checksum
How to use checksums
3a46b35fd2aa9e32227b288166c44351f928d5261bf02a3f82bf468f7656bb2a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.

Transparency log

Release history Release notifications | RSS feed

0.4.1

2 release files

0.4.0

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

This release

0.3.0 This release

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page