# ThermIQ

Smart hybrid heating system for German residential properties using crypto miner waste heat, solar PV, battery storage, and a heat pump — controlled by a RevolutionPi PLC.

## Concept

Crypto miners (Antminer S19J ASICs) generate significant waste heat. ThermIQ captures this heat and routes it into the building's heating circuit (Pufferspeicher / Warmwasserspeicher). A smart controller decides whether to source energy from the grid, solar panels, or battery storage — and coordinates the heat pump (Buderus WLW186i) as backup or supplement.

## Project Structure

```
ThermIQ/
├── docs/
│   ├── HARDWARE.md          # All hardware components with specs
│   ├── ARCHITECTURE.md      # System architecture and topology
│   ├── SAFETY.md            # Safety layer and non-negotiable constraints
│   ├── COMMUNICATION.md     # RS485 Modbus, MQTT, gRPC, network topology
│   └── SCHALTSCHRANK.md     # Electrical cabinet design and wiring
├── src/
│   ├── miners/              # Miner integration (Braiins gRPC API)
│   └── nodered/             # Node-RED flows
├── CONTEXT.md               # Full AI context / knowledge base
└── README.md
```

## Tech Stack

| Layer | Technology |
|-------|-----------|
| PLC / Control | RevolutionPi (Core + DIO + AIO) |
| Automation | Node-RED (Modbus client, logic flows) |
| Message Bus | MQTT (Mosquitto) |
| Visualization | Home Assistant |
| Miner API | Braiins OS gRPC (port 50051) |
| Inverter | Deye via RS485 Modbus (sunsynk library) |
| Field Bus | RS485 Modbus (energy meters, inverters) |
| HW Safety | Dual-channel safety relay, hardware contactors |

## First Installation: Walda (ASP1)

- Site: Walda, Germany
- Miners: 2x Antminer S19J
- Inverters: Deye hybrid
- Heat pump: Buderus WLW186i
- Pumps: 3x Wilo Stratos PICO plus (P3, P4, P5)
- Valves: 2x Belimo C320Q-J (RV1, RV2)

## Key Principles

- Safety is purely hardware — never software-dependent
- Miners must always be hard-disconnectable via contactors
- Cloud is optional / read-only — never required for operation
- No WiFi for critical energy components
- Local-first architecture

## Related

- Shared team folder: `~/Nextcloud/Projekte/ThermIQ` (do not commit here)
- Prior Kryptoheat work: `~/Projects/Kryptoheat/`