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 7, 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 7, 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.16.tar.gz (14.0 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.16-py3-none-any.whl (15.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: zhong_hong_hvac-1.0.16.tar.gz
  • Upload date:
  • Size: 14.0 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.16.tar.gz
Algorithm Hash digest
SHA256 63175037ec25a05208602bd65f1c7aa3cb0d42e884286d9f2be08821429a8697
MD5 bc8b80b009020174a550d64f33a8d490
BLAKE2b-256 5e96720c869ff38d1b27ebb607cca3143501fe72d39d29b7a1c4579232d006b1

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zhong_hong_hvac-1.0.16-py3-none-any.whl
Algorithm Hash digest
SHA256 91f847a2ddf98aa1d44d929cf3cf1be4d9a55f8092237906547fd7c2b61b0c31
MD5 71cedfd99f7cf744377dc60105360dee
BLAKE2b-256 8dd6cb1d9bd0e5d4525de99dcdf3ef67f49dafb1f51ecca4be90e9ca3e743687

See more details on using hashes here.

Provenance

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