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.21

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.21
File	Size	Uploaded
zhong_hong_hvac-1.0.21.tar.gz	15.7 kB	Sep 11, 2026	Details

Built distribution (wheel)

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

Total release size: 32.9 kB

Release files / zhong_hong_hvac-1.0.21.tar.gz

Download URL	zhong_hong_hvac-1.0.21.tar.gz
Size	15.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`a45f7ec82ae9779d94d7de57c7e220fc6a67b9f59acdf97366c659f5469affea`
BLAKE2b-256 checksum How to use checksums	`dda4978e3b17f2e4eb1285fb49c811ed0c6e65e799f6d935b30e5c0b93d095b7`
Upload date	Sep 11, 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/3f06c117e137212654ac8a680b608df1858c09be

Workflow

Publishing configuration: github.com/crhan/ZhongHongHVAC/blob/3f06c117e137212654ac8a680b608df1858c09be/.github/workflows/publish.yml
Publishing logs: github.com/crhan/ZhongHongHVAC/actions/runs/34545553650/attempts/1

Artifact

Subject: zhong_hong_hvac-1.0.21.tar.gz
SHA-256 checksum: a45f7ec82ae9779d94d7de57c7e220fc6a67b9f59acdf97366c659f5469affea Verifying attestations

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

Download URL	zhong_hong_hvac-1.0.21-py3-none-any.whl
Size	17.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d2b7585655b7c69897fb079cf050626ec3118c1a502de131a3283dc4afa1c87b`
BLAKE2b-256 checksum How to use checksums	`d357dbfe2003ab2b4b4187c11866fdf3b7190509c1d3d9848fcb3a334a5dc826`
Upload date	Sep 11, 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/3f06c117e137212654ac8a680b608df1858c09be

Workflow

Publishing configuration: github.com/crhan/ZhongHongHVAC/blob/3f06c117e137212654ac8a680b608df1858c09be/.github/workflows/publish.yml
Publishing logs: github.com/crhan/ZhongHongHVAC/actions/runs/34545553650/attempts/1

Artifact

Subject: zhong_hong_hvac-1.0.21-py3-none-any.whl
SHA-256 checksum: d2b7585655b7c69897fb079cf050626ec3118c1a502de131a3283dc4afa1c87b Verifying attestations