Zum Inhalt

Inhero MR2 Quick-Start

Diese Anleitung führt Sie durch die Inbetriebnahme und die wichtigsten CLI-Commands.

1) Temperaturfühler (TS/NTC) vorbereiten

  • Entweder den 3-poligen Akkuanschluss mit TS/NTC nutzen oder die Onboard-NTC-Lötbrücke auf der Rückseite schließen.
  • Firmware-NTC-Typ: NCP15XH103F03RC (10k @ 25C, Beta 3380).
  • Zweck: Der Charger nutzt den TS-Pin für JEITA/Frost-Logik.
  • FAQ #2 — Akkupacks ohne NTC

2) Antennen anschließen

  • Nie ohne Antenne betreiben, sonst Gefahr für das RF-Frontend.

3) Akku anschließen

  • Ein Ladestand >90% wird empfohlen, damit der Akku per USB voll geladen werden kann und damit die SOC-Berechnung stabil startet.

⚠ WARNUNG — Kein Verpolschutz: Das Board hat keinen Hardware-Verpolschutz. Ein verpolter Akkuanschluss führt zu sofortiger, irreversibler Beschädigung. Vor dem Anschließen immer die Polarität prüfen.

4) Firmware flashen und Repeater konfigurieren

  • Board per USB-Kabel mit dem Rechner verbinden.
  • Ausgeliefert wird das Board nur mit Bootloader. Die Firmware für den MR2 wird aus dem Inhero-Fork veröffentlicht — flasher.meshcore.io führt dieses Board noch nicht (die Upstream-PRs #3131 / #3132 stehen aus).
  • UF2 von https://github.com/liekmarflow/MeshCore/releases laden.
  • Reset-Taster doppelt tippen (rechte Seite, unter USB-C). Es erscheint ein Massenspeicher-Laufwerk namens RAK4630 oder FTHR840.
  • UF2 auf dieses Laufwerk ziehen; das Board startet in die Firmware.
  • Der MR2 fährt die Repeater-Rolle von MeshCore (Build Inhero_MR2_repeater); ein Sensor-Build (Inhero_MR2_sensor) steht ebenfalls bereit.
  • Danach auf https://flasher.meshcore.io -> Repeater-Setup die LoRa-Settings, den Namen und das Admin-Passwort konfigurieren.

5) CLI öffnen

  • https://flasher.meshcore.io -> Console
  • oder MeshCore-App -> Manage -> Command-Line
  • Hier werden die Board-spezifischen Commands gesetzt.

6) Akkuchemie setzen

  • Command:
  • set board.bat liion1s
  • oder set board.bat lifepo1s
  • oder set board.bat lto2s
  • oder set board.bat naion1s
  • Legt Ladeparameter und Low-Voltage-Schwellen fest.
  • FAQ #1 | BATTERY_GUIDE.md — Welche Akkuchemie soll ich einsetzen?

7) Akkukapazität setzen

8) Maximalen Ladestrom setzen

  • Command: set board.imax
  • Bereich laut Firmware: 50 bis 1500 mA (BQ25798-Minimum: 50mA).
  • Passend zum Solar-Setup wählen, damit die Ströme zum PG-Check passen.
  • Faustformel: Panelleistung / Panelspannung * 1.2
  • FAQ #5 — Warum imax setzen?

9) Frost-Ladestromabsenkung einstellen

  • Command: set board.fmax <0%|20%|40%|100%>
  • Begrenzt den maximalen Ladestrom im T-Cool-Bereich (ca. -2 °C bis +3 °C, siehe JEITA-Tabelle im README) auf X% von board.imax.
  • 0% = Laden im T-Cool-Bereich gesperrt.
  • 20% = max. 20% von imax (z.B. 500mA → 100mA bei ca. -2 °C bis +3 °C).
  • 40% = max. 40% von imax (z.B. 500mA → 200mA bei ca. -2 °C bis +3 °C).
  • 100% = keine Reduktion, voller Ladestrom auch bei Kälte.
  • Unter ca. -2 °C (T-Cold): Laden immer komplett gesperrt durch JEITA.
  • Wichtig: Nur das Laden wird eingeschränkt. Bei ausreichend Solar wird das Board weiterhin mit Solarstrom betrieben — der Akku wird weder ge- noch entladen.
  • Hinweis: Bei LTO und Na-ion ist JEITA deaktiviert (set board.fmax wird mit Fehler abgelehnt, lädt auch bei Frost).
  • FAQ #6 — Was steuert fmax?

10) MPPT aktivieren

  • Command: set board.mppt <0|1>
  • 1 = MPPT an, 0 = MPPT aus.
  • Für Solar-Eingang typischerweise aktivieren.

11) LEDs aktivieren/deaktivieren

  • Command: set board.leds oder set board.leds <1|0>
  • Steuert Heartbeat-LED und BQ-Status-LED (Bootloader-LED-Muster bleiben unberührt).
  • FAQ #17 — Was bedeuten die LEDs?

12) Akku voll laden (SOC-Sync)

Hinweis Kältebetrieb: SOC% ist rein Coulomb-basiert und ändert sich nur durch reale Ladungsflüsse. Bei Kälte sperrt das Trapped-Charge-Modell den Boden der Entladekurve — bei niedrigem SOC fällt die entnehmbare Kapazität steil, und get board.telem zeigt den derateten Wert in Klammern: SOC:95.0% (78%). Siehe FAQ #13 für Details.

Zusatzhinweise (Praxis)

  • Nach dem Setzen der Akkuchemie lohnt ein kurzer Check mit get board.bat, ob die Einstellung gespeichert wurde.
  • Bei Solarbetrieb ist set board.mppt 1 empfehlenswert; bei reinem USB-Betrieb kann MPPT aus bleiben.

Beispielwerte je Akkuchemie (Startpunkt)

Diese Werte sind sichere Startpunkte und sollten an Akku, Panel und Einsatzprofil angepasst werden.

Die imax-Werte unten leiten sich aus der Faustformel aus Abschnitt 8 ab: imax ≈ Panelleistung ÷ Panelspannung × 1.2 (z.B. 2 W ÷ 5 V × 1.2 ≈ 480 mA → aufgerundet auf 500). fmax ist ein Prozentwert von imax und wirkt nur in der T-Cool-Zone (ca. -2 °C bis +3 °C, siehe JEITA-Tabelle im README).

Li-ion 1S (3.7V nominal)

set board.bat liion1s    # Chemie: 1S Li-ion (setzt Ladeprofil + Low-V-Schwellen)
set board.imax 500       # max. Ladestrom — ≈ 2 W Panel @ 5 V (2 W ÷ 5 V × 1.2 ≈ 480 mA)
set board.fmax 20%       # T-Cool (ca. -2…+3 °C): begrenzt auf 20 % × 500 mA = 100 mA

LiFePO4 1S (3.2V nominal)

set board.bat lifepo1s   # Chemie: 1S LiFePO4 (setzt Ladeprofil + Low-V-Schwellen)
set board.imax 300       # max. Ladestrom — ≈ 1 W Panel @ 5 V (1 W ÷ 5 V × 1.2 ≈ 240 mA, aufgerundet als Reserve)
set board.fmax 40%       # T-Cool (ca. -2…+3 °C): begrenzt auf 40 % × 300 mA = 120 mA

LTO 2S (2x 2.3V nominal)

set board.bat lto2s      # Chemie: 2S LTO (setzt Ladeprofil + Low-V-Schwellen)
set board.imax 700       # max. Ladestrom — ≈ 3 W Panel @ 5 V (3 W ÷ 5 V × 1.2 = 720 mA → 700)
                         # fmax entfällt: wird bei LTO abgelehnt (JEITA deaktiviert — LTO lädt auch bei Frost)

Na-ion 1S (3.1V nominal)

set board.bat naion1s    # Chemie: 1S Na-ion (setzt Ladeprofil + Low-V-Schwellen)
set board.imax 500       # max. Ladestrom — ≈ 2 W Panel @ 5 V (2 W ÷ 5 V × 1.2 ≈ 480 mA)
                         # fmax entfällt: wird bei Na-ion abgelehnt (JEITA deaktiviert)

Hinweis: set board.fmax wird bei LTO und Na-ion mit Fehler abgelehnt (JEITA deaktiviert); get board.fmax zeigt N/A.

Solarpanel-Hinweise

  • Maximale Leerlaufspannung (Voc) für den Eingang: 25V.
  • Typische Panels haben 5V oder 6V (MPP darunter).
  • Das Board hat Buck/Boost und kann auch mit niedrigerer Panelspannung höhere Akkuspannungen laden.
  • 24V-Panels oder Serienverschaltung können die 25V-Voc-Grenze überschreiten und sind nicht geeignet.
  • Wattklasse: mindestens 1W, typisch 2W.
  • Bei 1W-Panels wird eine Akkukapazität von >7Ah empfohlen.
  • Gilt nur bei Südausrichtung, vertikaler Montage und unverschattetem Standort.
  • Bei schlechteren Solarbedingungen entweder auf 2W gehen oder die Akkukapazität für "Winterüberleben" erhöhen.

FAQ #8 — Welche Solarpanels?

USB-Laden

  • Das Board kann auch über USB-C (5V) geladen werden.
  • USB-C VBUS wird über eine Schottky-Diode auf den BQ25798 VBUS-Eingang geführt — derselbe einzelne Eingang wie das Solarpanel. Der BQ25798 hat nur einen VBUS-Eingang und unterscheidet nicht zwischen USB und Solar.
  • Die Schottky-Diode verhindert einen Rückfluss vom Solarpanel zum USB-Bus. Allerdings kann Strom von USB-VBUS über den Solarstecker abfließen.
  • CC1/CC2 sind über 4,7kΩ auf GND gezogen (USB-Sink, 5V Standard).
  • ⚠ Warnung: Da VBUS-USB und VBUS-BQ denselben Bus teilen (über die Schottky-Diode), führt ein Kurzschluss am Solarstecker auch zum Kurzschluss von VBUS-USB. Den Solareingang niemals kurzschließen, während USB angeschlossen ist.

Spannungsschwellen je Akkuchemie

Die Schwellen sind auf lange Lebensdauer und stabilen Betrieb ausgelegt.

Akkuchemie lowv_sleep_mv (System Sleep) lowv_wake_mv (0% SOC) Hysterese
Li-ion 1S 3100 3300 200mV
LiFePO4 1S 2700 2900 200mV
LTO 2S 3900 4100 200mV
Na-ion 1S 2500 2700 200mV

Verhalten bei Low-Voltage

  • Low-Voltage System Sleep: Wenn VBAT unter lowv_sleep_mv fällt, feuert der INA228 ALERT-Interrupt (P1.02). Die Firmware latcht CE HIGH (digitalWrite(BQ_CE_PIN, HIGH) → FET ON → CE LOW → Laden aktiv), konfiguriert den RTC-Wake-Timer und geht in System Sleep mit GPIO-Latch (< 500µA). P0.04 wird von disconnectLeakyPullups() ausgeschlossen, damit der GPIO-Latch HIGH bleibt. Periodische RTC-Wakes (stündlich) prüfen die Spannung — erst bei Erholung über lowv_wake_mv wird normal gebootet.
  • Solar-Recovery: Im System Sleep bleibt der GPIO4-Latch HIGH erhalten → DMN2004TK-7 FET ON → CE LOW → Laden aktiv. Solar-Laden läuft autonom weiter bis der Akku über lowv_wake_mv geladen ist. Ohne GPIO-Latch (RAK stromlos): ext. Pull-Down am Gate → FET OFF → CE HIGH → Laden AUS (Safety-Default).

CLI-Beispiele (kompakt)

# Akkuchemie und Kapazität
set board.bat liion1s
set board.batcap 10000

# Ladeparameter
set board.imax 500
set board.fmax 20%
set board.mppt 1

# LEDs
set board.leds off

# Statuschecks
get board.bat
get board.imax
get board.fmax
get board.mppt
get board.leds
get board.batcap
get board.telem
get board.stats
get board.cinfo
get board.selftest
get board.conf

Getter-Kurzinfos (alle relevanten Board-Getter)

  • get board.bat - Aktueller Akkutyp (liion1s, lifepo1s, lto2s, naion1s, none).
  • get board.fmax - Aktuelles Frost-Ladeverhalten (0%/20%/40%/100%; N/A bei LTO/Na-ion).
  • get board.imax - Maximaler Ladestrom in mA.
  • get board.mppt - MPPT-Status (0/1).
  • get board.leds - LED-Status (Heartbeat + BQ-Stat).
  • get board.batcap - Akkukapazität in mAh (set/default).
  • get board.telem - Echtzeit-Telemetrie (Battery/Solar inkl. SOC, V/I/T). Siehe TELEMETRY.md für die App-Anzeige.
  • get board.stats - Energie-Bilanz (24h/3d/7d), Charge/Discharge-Breakdown und MPPT-Anteil.
  • get board.cinfo - Ladegerät-Status (Charger State + Flags).
  • get board.selftest - I²C-Hardware-Probe (INA:OK BQ:OK RTC:OK BME:OK). RTC inkl. Write/Readback-Verifikation (Zustand WR_FAIL bei Mismatch).
  • get board.conf - Kurzübersicht aller Konfigs (B, F, M, I, Vco, V0).
  • get board.tccal - NTC-Temperatur-Kalibrieroffset in °C (0.00 = default).
  • FAQ #12 — Wann tccal ausführen?

Siehe auch