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 1, 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 1, 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.15.tar.gz (13.9 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.15-py3-none-any.whl (15.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: zhong_hong_hvac-1.0.15.tar.gz
  • Upload date:
  • Size: 13.9 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.15.tar.gz
Algorithm Hash digest
SHA256 f4fd42f4303affd061b0ac4ea90b26634c02db982a7e7cd2d716a432314e7117
MD5 1a0a298361c32590381a81dc817075a1
BLAKE2b-256 02f38e05726325d4259ba58225ef394d1b001fa2d6e16cb59a6b15098826214e

See more details on using hashes here.

Provenance

The following attestation bundles were made for zhong_hong_hvac-1.0.15.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.15-py3-none-any.whl.

File metadata

File hashes

Hashes for zhong_hong_hvac-1.0.15-py3-none-any.whl
Algorithm Hash digest
SHA256 ee3b0d14d241fafa685fb99247bdb7a3826a3544d40dcfedb1ca40e143fd670d
MD5 608a3ff95ffbbcbda6669e8836ae70a4
BLAKE2b-256 00aa5cc104020e492cfff7b041af59af26cd4573e378fe878ec0e4966536a852

See more details on using hashes here.

Provenance

The following attestation bundles were made for zhong_hong_hvac-1.0.15-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