OpenKairo Mining · Home Assistant Integration

Mining. Automatisch.
Stabil.

Steuere deine ASICs vollautomatisch — basierend auf PV-Überschuss, Batteriestatus, Raumtemperatur oder KI-Planung. Direkt in Home Assistant.

Jetzt einrichten → GitHub
VERSION
v1.4.0
STATUS
STABLE
MODI
6 Automation
PLATFORM
Home Assistant

Welchen Modus brauche ich?

Alle Modi laufen vollautomatisch im 15-Sekunden-Takt. Wähle den passenden für dein Setup.

☀️ Empfohlen

PV-Überschuss

Miner läuft wenn Solar-Überschuss vorhanden. Leistung folgt automatisch dem Ertrag.

🔋 Batterie

SOC-Modus

Miner läuft wenn der Hausakku ausreichend geladen ist. Entlädt kontrolliert auf Zielwert.

🔥 Heizung

Heizmodus

Miner als Raumheizung. Schaltet bei Kälte ein, bei Wunschtemperatur aus.

🏝️ Offgrid

Offgrid

Dreistufige SOC-Kurve für Inselanlagen. Volle Kontrolle über Lade- und Entladeschwellen.

🤖 Beta

AI Akku-Optimierer

KI berechnet wann der Miner nachts starten muss, damit der Akku morgens den Ziel-SOC erreicht.

🖐️ Manuell

Manuell

Volle Kontrolle per Hand oder HA-Automatisierung.

Installation

In drei Schritten startklar — keine Programmierung erforderlich.

Schritt für Schritt

  • 1 → HACS → Integrationen → Benutzerdefinierte Repositories → URL einfügen
  • 2 → Herunterladen → Home Assistant neu starten
  • 3 → Geräte & Dienste → Integration hinzufügen → OpenKairo Mining → Zentrale einrichten
  • 4 → Erneut Integration hinzufügen → IP des Miners eingeben → fertig
Tipp: Zuerst immer die Zentrale einrichten, dann jeden Miner einzeln per IP hinzufügen.
# HACS → Custom Repository
→ github.com/openkairo/openKairo_Mining
→ Kategorie: Integration ✔

# Integration hinzufügen
→ Dashboard (Zentrale) einrichten ✔

# Miner verbinden
→ IP: 192.168.1.100 → erkannt ✔
→ Antminer S19 → verbunden ✔
→ Engine aktiv (15s Takt) ✔

Modus-Einrichtung

Schritt-für-Schritt für jeden Modus — so wenig Klicks wie möglich.

☀️ Empfohlen

PV-Überschuss

Miner läuft wenn Solar-Überschuss vorhanden. Live-Tracking ohne Konfigurationsaufwand.

  • → Modus: PV-Überschuss auswählen
  • → PV-Sensor wählen (Watt-Wert)
  • → Einschalten ab / Ausschalten unter (Watt) setzen
  • → Speichern — fertig ✓
Live-Tracking: Power-Limit Sensor setzen → Leistung folgt dem Überschuss automatisch.
🔋 Batterie

SOC-Modus

Miner läuft wenn die Hausbatterie ausreichend geladen ist.

  • → Modus: Batterie SOC auswählen
  • → Batterie-Sensor wählen (% Wert)
  • → Einschalten ab (z.B. 80%) / Ausschalten unter (z.B. 30%)
Optional: Automatische Nachskalierung — Leistung folgt proportional dem SOC.
🔥 Heizung

Heizmodus

Den Miner als smarte Raumheizung betreiben.

  • → Modus: Heiz-Modus auswählen
  • → Temperatursensor wählen → aktueller Wert wird direkt angezeigt
  • → Einschalten unterhalb / Ausschalten oberhalb (°C) setzen
Tipp: Mindestens 1–2°C Abstand zwischen den Schwellen setzen.
🤖 Beta

AI Akku-Optimierer

KI berechnet die optimale Startzeit für nächtliches Mining.

  • → Batterie SOC-Sensor wählen → SOC wird sofort angezeigt
  • → Akku-Kapazität (kWh) eintragen
  • → Hausverbrauch-Sensor wählen
  • → Ziel-Uhrzeit & Ziel-SOC setzen (z.B. 07:00 / 10%)

Sicherheit & Grenzen

Gelten für alle Modi als absolute Grenzen — der Engine überschreibt sie nie.

Leistungsgrenzen

FeldFunktion
min_powerUntere Wattgrenze — Miner geht nie darunter
max_powerObere Wattgrenze — gilt auch für Soft-Start & Tracking
max_tempNotabschaltung bei Überhitzung (°C)
max_runtimeAutomatische Pause nach X Stunden
min_off_timePflichtpause in Minuten nach jeder Abschaltung

🚀 Soft-Start / Soft-Stop

Mehrstufiges Hoch- und Runterfahren schont Netzteile.

  • 1 → Soft-Start und/oder Soft-Stop aktivieren
  • 2 → ⚡ Auto drücken → 4 Stufen werden aus Min/Max berechnet
  • 3 → Intervall setzen (z.B. 60 Sekunden pro Stufe)

Standby-Watchdog

Erkennt eingefrorene Miner automatisch und greift ein — ohne manuelle Überwachung.

Standard

🔄 Toggle

Steckdose kurz aus und wieder an. Funktioniert für alle Miner ohne API.

API

🔌 Hardware-Reboot

Reboot-Befehl direkt an den Miner per API. Schneller als Toggle, erfordert IP.

Schonend

⚙️ Backend-Neustart

Nur Mining-Software neu starten ohne Hardware-Reboot. Am schonendsten.

Kein separater Watchdog-Switch nötig: Fällt automatisch auf den Haupt-Miner-Switch zurück wenn kein dedizierter Standby-Switch konfiguriert ist.

HA-Sensoren

Pro Miner werden 5 Entitäten automatisch angelegt und alle 15 Sekunden aktualisiert.

EntitätBeschreibung
*_session_runtimeLaufzeit der aktuellen Session
*_today_runtimeGesamtlaufzeit heute
*_session_energyVerbrauch diese Session (Wh)
*_today_energyVerbrauch heute (Wh)
*_total_startsGesamte Einschaltvorgänge

Fleet-Management

Mehrere Miner mit globalem Power-Budget und automatischer Priorisierung.

  • 1 → Einstellungen → Fleet Max Power (W) setzen
  • 2 → Jeden Miner mit Priorität versehen (1 = höchste)
  • 3 → Engine drosselt automatisch bei Budget-Überschreitung
Hardware

Unterstützte Miner

Verbindung per IP-Adresse — Plug & Play ohne Treiber.

7 Hersteller unterstützt
⛏️ Antminer
⚙️ Whatsminer
⛏️ Canaan Avalon
⚡ Bitaxe
🧊 IceRiver
🚀 FutureBit
🤖 NerdMiner
+ Viele weitere Hersteller werden über die native pyasic-Bibliothek automatisch unterstützt.
Changelog

Update Notes

Was sich in den letzten Versionen geändert hat.

Alle Versionen →
v1.4.0 Aktuell Stability & Zero-Click Automation

Kritische Bugfixes, PV Live-Tracking ohne Opt-In, neue UI-Verbesserungen und 5 neue HA-Sensoren.

🐛 Kritische Bugfixes

  • → Miner ohne Schalter erschien immer als "An" — behoben
  • → Watchdog löste nie die konfigurierte Aktion aus — komplett neu
  • → Fallback auf Haupt-Switch wenn kein Standby-Switch gesetzt

⚡ PV Live-Tracking

  • → Leistung folgt automatisch dem Überschuss bei gesetztem Power-Sensor
  • → Kein soft_continuous_scaling Opt-In mehr nötig
  • → Standard-Skalierung auf Proportional (besser für Solar)

🎛️ UI Verbesserungen

  • → ⚡ Auto-Button: Soft-Start Stufen aus Min/Max berechnen
  • → Live-Temperatur & Live-SOC direkt im Formular
  • → AI-Modus: nativer Zeitpicker statt Freitext
  • → Batterie Min-SOC Default: 100% → 50%

📊 Neue HA-Sensoren

  • → 5 Sensor-Entitäten pro Miner (Laufzeit, Energie, Starts)
  • → Service reset_session_stats zum Zurücksetzen
  • → Leistungs-Slider nutzt korrekt max_power
v1.3.21 The Intelligence Update

AI Akku-Optimierer, Heizmodus, Mobile Dashboard, Wetter-Integration.

🤖 AI Akku-Optimierer

  • → Predictive Entladestrategie aus historischem Verbrauch
  • → Solar-Prognose für den nächsten Tag einbeziehen
  • → Percentile-Filter gegen Lastspitzen

🔥 Heizmodus & Offgrid

  • → Mining as a Heater mit Temperatur-Gating
  • → 3-Punkt SOC-Kurve für Inselanlagen
  • → SOC-Wächter verhindert kritische Entladung
v1.3.5 Fleet, MQTT & Pyasic Core
  • → Fleet Power Budget mit Priorisierung
  • → MQTT-Publisher für externe Dashboards
  • → Soft-Start / Soft-Stop Ramping
  • → Native pyasic Hardware-Anbindung (Antminer, Bitaxe, IceRiver)