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.

Bump the version in zhong_hong_hvac/version.py and pyproject.toml.
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.

Metadata

Release files for zhong-hong-hvac 1.0.20

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zhong-hong-hvac 1.0.20
File	Size	Uploaded
zhong_hong_hvac-1.0.20.tar.gz	15.4 kB	Sep 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for zhong-hong-hvac 1.0.20
File	Interpreter	ABI	Platform	Reset
zhong_hong_hvac-1.0.20-py3-none-any.whl 17.0 kB Sep 10, 2026	Python 3	none	any	Details

Total release size: 32.4 kB

Release files / zhong_hong_hvac-1.0.20.tar.gz

Download URL	zhong_hong_hvac-1.0.20.tar.gz
Size	15.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`69edff81a0984b85ce42b1613d346e817b9c017586c6bb0e4a82ebc07a0c0d8d`
BLAKE2b-256 checksum How to use checksums	`bbe1d84f299fb159b4e81796a87d656fb1964aa8932cac247d394ca86f1b6054`
Upload date	Sep 10, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/crhan/ZhongHongHVAC
Publishing commit: github.com/crhan/ZhongHongHVAC/tree/fe9d63b88d57a2f80c21a97c7b7d6d8bf03be46c

Workflow

Publishing configuration: github.com/crhan/ZhongHongHVAC/blob/fe9d63b88d57a2f80c21a97c7b7d6d8bf03be46c/.github/workflows/publish.yml
Publishing logs: github.com/crhan/ZhongHongHVAC/actions/runs/34534591014/attempts/1

Artifact

Subject: zhong_hong_hvac-1.0.20.tar.gz
SHA-256 checksum: 69edff81a0984b85ce42b1613d346e817b9c017586c6bb0e4a82ebc07a0c0d8d Verifying attestations

Release files / zhong_hong_hvac-1.0.20-py3-none-any.whl

Download URL	zhong_hong_hvac-1.0.20-py3-none-any.whl
Size	17.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2403be95afbb9575770fc844378fb3c1d3df46d3630bc153228c37e8932d65a1`
BLAKE2b-256 checksum How to use checksums	`f71c7891dd14ff09fd50cca88ff47bdb91c0b9f1656d7e0eee56dde58545d086`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/crhan/ZhongHongHVAC
Publishing commit: github.com/crhan/ZhongHongHVAC/tree/fe9d63b88d57a2f80c21a97c7b7d6d8bf03be46c

Workflow

Publishing configuration: github.com/crhan/ZhongHongHVAC/blob/fe9d63b88d57a2f80c21a97c7b7d6d8bf03be46c/.github/workflows/publish.yml
Publishing logs: github.com/crhan/ZhongHongHVAC/actions/runs/34534591014/attempts/1

Artifact

Subject: zhong_hong_hvac-1.0.20-py3-none-any.whl
SHA-256 checksum: 2403be95afbb9575770fc844378fb3c1d3df46d3630bc153228c37e8932d65a1 Verifying attestations