Adrian Bretsch
ba6622bed7
All Markdown documentation files for the ThermIQ smart hybrid heating system. PDFs excluded via .gitignore — generated on demand. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
59 lines
2.3 KiB
Markdown
59 lines
2.3 KiB
Markdown
# 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/`
|