ThermIQ ASP1 — smart hybrid heating system documentation
Adrian Bretsch
0513248d7f
- Netzwerk aus 2.3 raus, neue Anforderungssektion 3.6 (NW-001..008) mit VPN, Firewall, Router, SSH/VPN Remote-Zugriff - Physische Installation klar als Out-of-Scope mit Verweis auf separates Pflichtenheft Inbetriebnahme - 2.2.2 präzisiert: vollautomatischer Modus-Wechsel = Wunsch, FA-014 Hinweis ergänzt (kein Widerspruch mehr) - NFA-006: Begründung für Python vs CodeSys ergänzt - SA-001: FLOW OK entfernt, Temperaturüberwachung als Ersatz - SA-002: Remote Safety-Reset per VPN erlaubt (Software-Zustand) - SA-006: bei Safety-Trip aktiv gRPC-Leistung auf 0 setzen - SA-007: Remote-Quittierung via VPN ergänzt - SA-008: Ventil-Verriegelung verständlicher erklärt - 6.1: Miner-Topics korrigiert (Miner 2 ohne hashrate), P3 als relay-only, erweiterte Inverter-Variablen, aussen+miner-Temps, power_setpoints als schreibbar in setpoints/ - 6.2: Publisher/Subscriber-Tabelle aktualisiert - 6.3: Nomenklatur (QoS 0/1, retained) mit Erklärungstabelle - Alle Hauptsektionen mit erklärendem Einleitungsabsatz - HARDWARE.md: FLOW OK entfernt, Sensor-Sektion strukturiert - Offene Punkte 11-13 ergänzt (Router, IP-Plan, Miner-2-Hashrate) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> |
||
|---|---|---|
| Angebot | ||
| docs | ||
| src | ||
| .gitignore | ||
| CONTEXT.md | ||
| README.md | ||
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/