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.3

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.3
File Size Uploaded
hansa_ble_protocol-0.3.3.tar.gz 5.7 kB Details

Built distribution (wheel)

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

Total release size: 11.7 kB

Release files / hansa_ble_protocol-0.3.3.tar.gz

Download URL hansa_ble_protocol-0.3.3.tar.gz
Size 5.7 kB
Tags Source
SHA-256 checksum
How to use checksums
f19c2c105e2aee109dc1994e8feafa41d6a9f3b1240970ce32eb4942e5505b5c
BLAKE2b-256 checksum
How to use checksums
e46bffdc3485bd8f9e057e4f5deea2b8cfef716a072c7a5ae3f7098ce4c4a86c
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 22, 2026.

Transparency log

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

Download URL hansa_ble_protocol-0.3.3-py3-none-any.whl
Size 6.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
89c0a1cf02d9ee462cbafae6a348585d57e7387b924cf75aeeebadebd87e224e
BLAKE2b-256 checksum
How to use checksums
db8adea1ef98689920dd6983f01696cc8ebbc9983fce336a836223c17aaf7569
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 22, 2026.

Transparency log

Release history Release notifications | RSS feed

0.4.1

2 release files

0.4.0

2 release files

This release

0.3.3 This release

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

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