ZhongHongHVAC

Python driver for ZhongHong HVAC Controller

Connection robustness

The gateway connection is self-healing:

  • Unknown protocol values (for example fan speed 0x00 reported by an indoor unit right after power-off) are tolerated instead of crashing the listener. A malformed frame is logged and skipped while the rest of the buffer is still processed.
  • The listener thread survives unexpected errors and keeps running.
  • When no status data has been received for probe_interval seconds the hub sends a status query as a health probe. After max_probe_failures consecutive failed probes the TCP connection is reopened.
  • ZhongHongGateway.connected reflects the health of the connection so integrations can mark entities unavailable instead of showing stale values.

Tunables (instance attributes, set before start_listen()):

Attribute Default Meaning
_recv_timeout 30.0 socket read timeout in seconds
_probe_interval 60.0 seconds without data before probing
_probe_response_timeout 10.0 seconds to wait for a probe response
_max_probe_failures 3 consecutive probe failures before reopening the socket
_stale_timeout 300.0 seconds without data before connected turns False

Release

Pushing a vX.Y.Z tag publishes the package to PyPI automatically (workflow: .github/workflows/publish.yml). It runs the test suite, builds the sdist and wheel, verifies that the tag matches the package version, and uploads.

  1. Bump the version in zhong_hong_hvac/version.py and pyproject.toml.

  2. Commit the change, then tag and push:

    git tag vX.Y.Z
git push origin vX.Y.Z

First-time setup, one of:

  • Trusted publishing (recommended, no secrets needed): add a trusted publisher on PyPI for this repository (crhan/ZhongHongHVAC), workflow publish.yml, environment pypi, project zhong-hong-hvac.
  • Or add a repository secret PYPI_TOKEN with a PyPI API token scoped to the zhong-hong-hvac project.

Project links

Data verified by PyPI on Aug 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.19)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ruohan.chen from gravatar.com ruohan.chen

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: ruohan.chen

GitHub Statistics

Data verified by PyPI on Aug 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache-2.0)

Requires

Python <4.0, >=3.9

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zhong_hong_hvac-1.0.18.tar.gz (14.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zhong_hong_hvac-1.0.18-py3-none-any.whl (16.3 kB view details)

Uploaded Python 3

File details

Details for the file zhong_hong_hvac-1.0.18.tar.gz.

File metadata

  • Download URL: zhong_hong_hvac-1.0.18.tar.gz
  • Upload date:
  • Size: 14.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for zhong_hong_hvac-1.0.18.tar.gz
Algorithm Hash digest
SHA256 39c0bf6431cbc0e11ca5cb5eb86e2dd42b4fe23160d008bea9b86441839d68f5
MD5 8de508111f87c2a2af392ce8412cee61
BLAKE2b-256 2caf3e11fff66c8cf6400588d66d7807271c1a4cde2e10a3653197ab90a53777

See more details on using hashes here.

Provenance

The following attestation bundles were made for zhong_hong_hvac-1.0.18.tar.gz:

Publisher: publish.yml on crhan/ZhongHongHVAC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zhong_hong_hvac-1.0.18-py3-none-any.whl.

File metadata

File hashes

Hashes for zhong_hong_hvac-1.0.18-py3-none-any.whl
Algorithm Hash digest
SHA256 db6811ae4fe9c6f6f69a07647ab1ea1c07bf87c381fb650abc7118b972f3eff1
MD5 0b2b464f50dd00318559626e4b67fb5e
BLAKE2b-256 7fcb679e37c26755dbf2d804b7c18d8a0e318ea5fa2e146413d8c87799db059f

See more details on using hashes here.

Provenance

The following attestation bundles were made for zhong_hong_hvac-1.0.18-py3-none-any.whl:

Publisher: publish.yml on crhan/ZhongHongHVAC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page