Skip to main content

GammaHeatingControl

coverage pipeline

Documentation

A python 3 interface to EBV Gamma Heating Control.

Description

Goal of this project is to create a python interface to communicate with EBV Gamma Heating Control Units.

The Company EBV manufactured the Heating Control Unit "Gamma" in the years 2000-2010 (citation needed!). The system is able to communicate via RS-485 network, linking the main unit with a cascade of satellite units, so-called room stations, either passive (temperature sensor) or active (display + remote control + temperature sensor).

Protocol

There have been notes on the protocol by certain developers [1] but none of them actually finished the job.

The RS-485 network used here is a single master bus. The master is the main unit and the master tries something like time-division-multiplexing. It sends sync frames with the address of the satellite system that is supposed to send something.

Example: 21 ... 21 ... 21 ... 21 ... 21 (... = ~60-80ms)

is to trigger the first room station controlling the first mixer circuit to send something. In general almost everything is repeated 5 times for robustness.

The room station answers to that slot announcement.

Some Notes

This Protocol was reverse engineered on a Rotex Gamma, a software variant of the EBV Gamma 2B, build into Rotex A1 B20i from 2002. That device received an active satellite unit RS10 in 2023 as an upgrade, primarily to get a room temperature reference into the controller to compensate overheating of >2degC due to sun effects. This also presented the chance to reverse engineer the protocol.

I recommend anyone to upgrade their heating system with a reference room temperature. If you don't want to buy such a device, build it yourself with a raspberry pi. The technology is dead cheap, and it saves vast amounts of energy costs!

The company EBV was not willing to share the protocol specification even decades after the production ended! Therefore, I do not recommend buying any of their products!

Deprecation of PyPi Packages

Packages on PyPi are no longer updated due to attempts of the Python Software Foundation to enforce new rules and basically flush out developers who do not consent.
Recent packages can be installed directly from git, i.e.
pip install git+https://gitlab.com/Menschel/GammaHeatingControl.git --upgrade

References

[1] https://github.com/bogeyman/gamma/wiki/Protokoll

Metadata

Release files for GammaHeatingControl 0.0.4

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

Source distribution (sdist)

Source distribution for GammaHeatingControl 0.0.4
File Size Uploaded Provenance
GammaHeatingControl-0.0.4.tar.gz 22.3 kB Without provenance Details

Release files / GammaHeatingControl-0.0.4.tar.gz

Download URL GammaHeatingControl-0.0.4.tar.gz
Size 22.3 kB
Tags Source
SHA-256 checksum
How to use checksums
c6ae2975738b8b14aa57a3cea9fdea048b61105820d17e8bbe987f34a6fd378a
BLAKE2b-256 checksum
How to use checksums
036fa2b356582a32798d922865c9629346ba21782f1eac3f126d36f27fbd8ecc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.3

Security for GammaHeatingControl 0.0.4

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.4 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page