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.2.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.2.0
File Size Uploaded
hansa_ble_protocol-0.2.0.tar.gz 5.7 kB Details

Built distribution (wheel)

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

Total release size: 11.7 kB

Release files / hansa_ble_protocol-0.2.0.tar.gz

Download URL hansa_ble_protocol-0.2.0.tar.gz
Size 5.7 kB
Tags Source
SHA-256 checksum
How to use checksums
068603fb367c46ceddd13afb88fcf44ce51b8d7b3c8d5a33ae6289242299357e
BLAKE2b-256 checksum
How to use checksums
edd270a7329f1f8ce985a74b32b7f4bfcc16cc7b9f25adad89c2a5045f99e3d5
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.2.0-py3-none-any.whl

Download URL hansa_ble_protocol-0.2.0-py3-none-any.whl
Size 6.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
91aa2b4094cf053e10ee089ef8ff8edb0ee6f8fd684d0c7d6fb2a11c2d2ecd5d
BLAKE2b-256 checksum
How to use checksums
153669c38c0ac526498cfdf7112d96fa0fbd16cd89173fc36e98c85b813ff339
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

0.3.0

2 release files

This release

0.2.0 This release

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