Zum Inhalt

Inhero MR2 – CLI Cheat-Sheet

Alle board-spezifischen CLI-Befehle auf einen Blick. Präfix ist immer board. – also get board.<cmd> bzw. set board.<cmd> <wert>.

Siehe FAQ.md für Erläuterungen der wichtigsten Parameter (imax, fmax, batcap) und DATASHEET.md für Chemie-Details.

Setter (Konfiguration ändern)

# Akkuchemie
set board.bat liion1s          # Li-ion 1S (3.7V nominal)
set board.bat lifepo1s         # LiFePO4 1S (3.2V nominal)
set board.bat lto2s            # LTO 2S (2x 2.3V nominal)
set board.bat naion1s          # Na-ion 1S (3.1V nominal)
set board.bat none             # Kein Akku / unbekannt (Laden deaktiviert)

# Akkukapazität (100–100000 mAh)
# Faustregel: 90% der Nennkapazität (siehe FAQ #4)
set board.batcap 10000

# Maximaler Ladestrom (50–1500 mA)
set board.imax 500

# Frost-Ladestromabsenkung (T-Cool ca. -2 °C bis +3 °C, siehe JEITA-Tabelle im README)
set board.fmax 0%              # Laden gesperrt
set board.fmax 20%             # max. 20% von imax
set board.fmax 40%             # max. 40% von imax
set board.fmax 100%            # keine Reduktion
# Hinweis: Bei LTO / Na-ion ohne Wirkung (JEITA deaktiviert)

# MPPT ein/aus
set board.mppt 1               # MPPT aktivieren
set board.mppt 0               # MPPT deaktivieren

# LEDs ein/aus (Heartbeat + BQ-Stat)
set board.leds on              # LEDs aktivieren  (on/1)
set board.leds off             # LEDs deaktivieren (off/0)

# SOC manuell setzen (0–100%)
set board.soc 85.0

Kalibrierung

# NTC-Temperatur-Kalibrierung
# Best Practice: Am frühen Morgen vor Sonnenaufgang ausführen,
# wenn sich die Akkutemperatur an die Umgebung angeglichen hat (siehe FAQ #12).
set board.tccal                # Auto-Kalibrierung via BME280
set board.tccal reset          # Offset auf 0.00 zurücksetzen

Getter (Status abfragen)

# Konfiguration & Hardware
get board.bat                  # Aktueller Akkutyp
get board.batcap               # Akkukapazität in mAh (set/default)
get board.imax                 # Maximaler Ladestrom in mA
get board.fmax                 # Frost-Ladeverhalten (0%/20%/40%/100% oder N/A)
get board.mppt                 # MPPT-Status (0/1)
get board.leds                 # LED-Status (ON/OFF)
get board.conf                 # Kurzübersicht aller Konfigs (B, F, M, I, Vco, V0)

# Echtzeit-Telemetrie
get board.telem                # Battery+Solar: V, I, T, SOC

# Energie & Statistik
get board.stats                # Energie-Bilanz (24h/3d/7d), C/D, MPPT%, Batt-TTL
                               #   Batt-TTL = Battery Time-To-Live (Stunden bis Akku leer),
                               #   kein Hop-Limit
                               #   Basis: 7-Tage-Durchschnitt des tägl. Netto-Defizits
                               #   aus stündlichen INA228-Coulomb-Counter-Samples (168h-Ringpuffer)
                               #   Formel: entnehmbare Ladung / |7d-Avg-Defizit| × 24, wobei
#   entnehmbar = SOC% × Kapazität − eingeschlossene Ladung
#   (Kälte-Derating; bei Normaltemperatur 0)
                               #   Batt-TTL erscheint nur im BAT-Modus (Netto-Defizit)
                               #   Voraussetzung: mind. 24h Daten + Kapazität bekannt

# Ladegerät & Diagnose
get board.cinfo                # Charger-Status + letzter PG-Stuck HIZ-Toggle
get board.bqdiag               # Diagnose/Debug: kompakter BQ25798-Register-Dump
                               #   PG-/Ladezustand, TS-Region (COLD/COOL/WARM/HOT),
                               #   aktive Status-/Fehler-Flags (z.B. VINDPM, VBAT_OVP)
get board.selftest             # Alle I2C-Komponenten prüfen (INA228/BQ25798/RV-3028/BME280)
                               #   Ausgabe: "INA:OK BQ:OK RTC:OK BME:OK"
                               #   RTC inkl. User-RAM Write/Readback-Verifikation
                               #   — erkennt kalte Lötstellen (Chip ACKt, akzeptiert
                               #   aber keine Writes). Mögliche Werte je Gerät:
                               #     OK      — antwortet (RTC: Write persistiert)
                               #     NACK    — keine I2C-Antwort
                               #     WR_FAIL — (nur RTC) ACKt, aber Write/Read stimmen nicht überein
get board.socdebug             # Diagnose/Debug: SOC-Tracking-Interna
                               #   SHUNT_CAL, präziser Strom, CHARGE-Register (mAh),
                               #   Stundenzähler Laden/Entladen, Update-Zähler,
                               #   RTC-Zeit, Temperatur-Derating-Faktor

# Kalibrierung
get board.tccal                # NTC-Temperatur-Offset in °C (0.00 = default)

Getter-Kurzinfos

Befehl Beschreibung
get board.bat Akkutyp (liion1s, lifepo1s, lto2s, naion1s, none)
get board.batcap Akkukapazität in mAh (set/default)
get board.imax Maximaler Ladestrom in mA
get board.fmax Frost-Ladeverhalten (0%/20%/40%/100%, bei LTO/Na-ion: N/A)
get board.mppt MPPT-Status (0/1)
get board.leds LED-Status Heartbeat + BQ-Stat (ON/OFF)
get board.conf Kurzübersicht: B(at) F(max) M(ppt) I(max) Vco V0
get board.telem Echtzeit-Telemetrie: Battery/Solar V, I, T, SOC — siehe TELEMETRY.md
get board.stats Energie-Bilanz (24h/3d/7d), C/D, MPPT%, Batt-TTL (7d-Avg-basiert)
get board.cinfo Charger-Status + PG-Stuck HIZ-Toggle (z.B. "PG / CC HIZ:3m ago")
get board.bqdiag Diagnose/Debug: BQ25798-Register-Dump — PG-/Ladezustand, TS-Region, aktive Fehler-Flags
get board.selftest I2C-Komponenten-Probe — INA:OK BQ:OK RTC:OK BME:OK (RTC inkl. Write-Verify)
get board.socdebug Diagnose/Debug: SOC-Interna — SHUNT_CAL, Strom, CHARGE, Stundenzähler, Derating-Faktor
get board.tccal NTC-Temperatur-Offset in °C (0.00 = default)

Setter-Kurzinfos

Befehl Wertebereich Beschreibung
set board.bat liion1s · lifepo1s · lto2s · naion1s · none Akkuchemie wählen
set board.batcap 100–100000 (mAh) Akkukapazität setzen
set board.imax 50–1500 (mA) Max. Ladestrom setzen
set board.fmax 0% · 20% · 40% · 100% Frost-Ladestromabsenkung (nicht bei LTO/Na-ion)
set board.mppt 0/1 · true/false MPPT ein-/ausschalten
set board.leds on/off · 1/0 LEDs ein-/ausschalten
set board.soc 0–100 (%) SOC manuell setzen
set board.tccal reset · (leer = auto) NTC-Temperatur kalibrieren oder zurücksetzen

Schnellstart-Rezepte

Li-ion 1S mit 10Ah und Solar

set board.bat liion1s
set board.batcap 10000
set board.imax 500
set board.fmax 20%
set board.mppt 1
set board.leds off

LiFePO4 1S mit 6Ah und Solar

set board.bat lifepo1s
set board.batcap 6000
set board.imax 300
set board.fmax 40%
set board.mppt 1
set board.leds off

LTO 2S mit 18Ah und Solar

set board.bat lto2s
set board.batcap 18000
set board.imax 700
set board.mppt 1
set board.leds off

Na-ion 1S mit 10Ah und Solar

set board.bat naion1s
set board.batcap 10000
set board.imax 500
set board.mppt 1
set board.leds off

Status-Check (alles auf einen Blick)

get board.conf
get board.telem
get board.stats
get board.cinfo

Siehe auch