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
1 maintainer
Release files for hansa-ble-protocol 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hansa_ble_protocol-0.4.0.tar.gz | 5.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hansa_ble_protocol-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.7 kB
Release files / hansa_ble_protocol-0.4.0.tar.gz
| Download URL | hansa_ble_protocol-0.4.0.tar.gz |
|---|---|
| Size | 5.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
131c8afc1e18aed054cf848b3ba031d240f1b27e7ecb5f09d24ce79edff539af
|
|
BLAKE2b-256 checksum How to use checksums |
f95ab9e699df48b722512c46c95e4a15507abafa357257165282268b134eb2c3
|
| 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 logRelease files / hansa_ble_protocol-0.4.0-py3-none-any.whl
| Download URL | hansa_ble_protocol-0.4.0-py3-none-any.whl |
|---|---|
| Size | 6.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f9bc75075243f567b2de44d20a1e682b59c7ef070f3e6d03ab82646879c38e51
|
|
BLAKE2b-256 checksum How to use checksums |
1907f5c6138a24473e0f93ec2f1ed66e2a28f922b498760b639941c2c2c41c64
|
| 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
