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.14.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.14-py3-none-any.whl (15.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: zhong_hong_hvac-1.0.14.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.14.tar.gz
Algorithm Hash digest
SHA256 e941352a4b7d4dcc4fd569b1879932da7559c3ceb91d20e03fdc40fe992fc6be
MD5 1727ec34540f91948a6238ebd8e15841
BLAKE2b-256 1bc37f2555bbb2aaf6b73747fa75720f785ef673128766f0e1a918f0361ac106

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zhong_hong_hvac-1.0.14-py3-none-any.whl
Algorithm Hash digest
SHA256 00d25c23a2d5ed017478a1c4504ab006c80d8f15953a991dc5af2e3c1962e04b
MD5 e6ccd2376b431a3367257203c23c39a1
BLAKE2b-256 f8a5e6e9254f2786a87266379ad263c5b212f6ee61d7963d73716bd4f38fc49e

See more details on using hashes here.

Provenance

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