Home Climate Control, a.k.a. DZ

Create as many climates in your home as you never thought imaginable.
Control temperature, humidity and ventilation.
Do it on a schedule.
Have everything measured and recorded.
Do it from anywhere.

Psst!

• There's a fresh new driver for the Pimoroni Automation HAT that has just been integrated with DZ, here: https://github.com/home-climate-control/automation-hat-driver. This is the most compact HVAC relay solution so far.
• Dallas Semiconductor 1-Wire API that was integrated into DZ codebase some 20 years ago, survived, was hardened and optimized, is now a separate project again, here: https://github.com/home-climate-control/owapi-reborn/
• XBee radio driver has just flipped from imperative to reactive: https://github.com/home-climate-control/xbee-api-reactive

Pardon Our Dust...

A brief glance at the version control history will tell you that something major is happening. Yes, a major change is underway - migration to Reactive Streams. This is almost a complete overhaul, and is certainly a backward incompatible change.

What is What, Where, and When

• The long in the tooth, but rock stable code base now resides at last-imperative-maintenance branch.
• The bleeding edge development is happening at reactive branch. This code base has already been deployed to one production installation and is about to be deployed to the second.
• Once things are stabilized, reactive will be merged to dev and then to master.

If you're an existing user...

...you might want to wait a bit (until this message is gone).

If you just found this...

...then going for the reactive code base is your best shot. It is still raw, but is being actively worked on. And the learning curve is much easier.

Documentation

Due to the separation between the code itself, and the project Wiki, it will take a bit to make it all consistent. If in doubt, don't hesitate to post a message to our user forum, help will come fast.

Quick Start

This should get you going:

git clone https://github.com/home-climate-control/dz.git && \
cd dz && \
git submodule init && \
git submodule update && \
./gradlew build installDist

When completed successfully, it will create an executable script in ${project_root}./dz3-spring/build/install/dz/bin/dz. The next step would be to create the configuration and run the script with its path as an argument.

And now back to our regularly scheduled programming...

A few useful links:

• FAQ: DZ on Raspberry Pi - the platform of choice
• http://homeclimatecontrol.com/ - project home
• http://diy-zoning.blogspot.com/ - project blog
• http://groups.google.com/group/home-climate-control - user forum
• http://diy-zoning.sourceforge.net/ - legacy project site (yep. This is how it started 20 years ago).

New Developments

MQTT is now a protocol of choice for remote integrations.

• MQTT Sensors
• DZ as an MQTT Publisher
• MQTT Pimoroni Automation Hat Driver
• DZ to Home Assistant Integration
• DZ to ESPHome Integration

ESP8266/ESP32 is now a future direction for edge device development and integration.

• ~~hcc-esp8266 - 1-Wire over MQTT over WiFi on ESP8266 (Arduino IDE)~~ Use ESPHome Integration instead
• hcc-esp32 - 1-Wire over MQTT over WiFi on ESP32 (ESP-IDF)

InfluxDB is now supported as a data sink.

• DZ as InfluxDB Data Source