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

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

Built distribution (wheel)

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

Total release size: 11.7 kB

Release files / hansa_ble_protocol-0.3.2.tar.gz

Download URL hansa_ble_protocol-0.3.2.tar.gz
Size 5.7 kB
Tags Source
SHA-256 checksum
How to use checksums
97b941653b0939014d3f7bce6fa5fb64a61c259f1d6851d4f89f09854446ae66
BLAKE2b-256 checksum
How to use checksums
c845bc836e9ace8eb5e208a160ae847a429e5faa997113e915c67993ff7da74d
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.2-py3-none-any.whl

Download URL hansa_ble_protocol-0.3.2-py3-none-any.whl
Size 6.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
85dd93208d3922c23d00f2fab357bd63be31c792aa07f116a8a88d18cc36e250
BLAKE2b-256 checksum
How to use checksums
0a958ea98f6e29b36d57374efce783ec93a22fee15414beaaff297ba2d9d52ce
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

This release

0.3.2 This release

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