Zum Hauptinhalt springen

config.txt Referenz

Die Datei config.txt ist eine Klartextkonfigurationsdatei, die auf der SD-Karte des FGA Loggers gespeichert wird. Sie ermöglicht die Anwendung von Sensorkalibrierungsparametern und die Anpassung der Betriebseinstellungen, ohne die Firmware neu flashen zu müssen.

Die Konfiguration wird einmalig beim Start geladen, wenn das Gerät eingeschaltet wird, während der Multifunktionsknopf gedrückt gehalten wird.

hinweis

Die config.txt-Konfiguration erfordert Firmware v1.0.4 oder neuer. Die konfigurierbare Ausgangsrate erfordert v1.0.5 oder neuer.

Dateispeicherort​

Platzieren Sie config.txt im Stammverzeichnis der FAT32-formatierten SD-Karte.

Dateiformat​

  • Ein Parameter pro Zeile
  • Format: PARAMETER=wert
  • Keine Leerzeichen um das =-Zeichen
  • Zeilen, die mit # beginnen, werden als Kommentare behandelt und ignoriert
  • Parameter sind Groß-/Kleinschreibung-sensitiv

Beispiel:

# FGA Logger Konfiguration
S1_X_OFFSET=128.5
S1_X_GAIN=1.0
S1_Y_OFFSET=-45.0
S1_Y_GAIN=1.0
S1_Z_OFFSET=0
S1_Z_GAIN=1.0

Parameterreferenz​

Sensor 1 Kalibrierung​

ParameterTypStandardBeschreibung
S1_X_OFFSETfloat0X-Achsen-Offset-Korrektur für Sensor 1 (nT)
S1_Y_OFFSETfloat0Y-Achsen-Offset-Korrektur für Sensor 1 (nT)
S1_Z_OFFSETfloat0Z-Achsen-Offset-Korrektur für Sensor 1 (nT)
S1_X_GAINfloat1.0X-Achsen-Verstärkungsmultiplikator für Sensor 1
S1_Y_GAINfloat1.0Y-Achsen-Verstärkungsmultiplikator für Sensor 1
S1_Z_GAINfloat1.0Z-Achsen-Verstärkungsmultiplikator für Sensor 1

Sensor 2 Kalibrierung​

ParameterTypStandardBeschreibung
S2_X_OFFSETfloat0X-Achsen-Offset-Korrektur für Sensor 2 (nT)
S2_Y_OFFSETfloat0Y-Achsen-Offset-Korrektur für Sensor 2 (nT)
S2_Z_OFFSETfloat0Z-Achsen-Offset-Korrektur für Sensor 2 (nT)
S2_X_GAINfloat1.0X-Achsen-Verstärkungsmultiplikator für Sensor 2
S2_Y_GAINfloat1.0Y-Achsen-Verstärkungsmultiplikator für Sensor 2
S2_Z_GAINfloat1.0Z-Achsen-Verstärkungsmultiplikator für Sensor 2

Sensor-2-Parameter gelten nur, wenn ein zweiter Sensor am B2-Eingang angeschlossen ist.

Anwendung der Kalibrierung​

Die Firmware wendet die Kalibrierung auf jeden Achsenwert wie folgt an:

korrigiert = (rohwert - OFFSET) * GAIN

Zum Beispiel für die X-Achse von Sensor 1:

B1x_corrected = (B1x_raw - S1_X_OFFSET) * S1_X_GAIN

Dies wird angewendet, bevor der Wert in CSV geschrieben oder über seriell gestreamt wird.

Konfiguration laden​

  1. Schreiben Sie Ihre config.txt in das Stammverzeichnis der SD-Karte
  2. Stecken Sie die SD-Karte in den FGA Logger
  3. Halten Sie den Multifunktionsknopf gedrückt und schalten Sie das Gerät EIN
  4. Die LEDs leuchten nacheinander auf und erlöschen, um zu bestätigen, dass die Datei gelesen wurde
  5. Verbinden Sie sich über USB seriell, um zu überprüfen — die Konsole gibt die geladenen Parameterwerte aus:
Config: reading from SD card
config.txt found.

Input 1: Offset(x,y,z): 128.5, -45.0, 0.0
Gain(x,y,z): 1.00000000, 1.00000000, 1.00000000
tipp

Kalibrierungsparameter werden dauerhaft im Logger gespeichert. Sie müssen config.txt nach dem Laden nicht auf der SD-Karte behalten — die Werte bleiben über Stromzyklen und Firmware-Updates hinweg erhalten.

Vollständiges Beispiel config.txt​

# FGA Logger Konfigurationsdatei
# Erfordert Firmware v1.0.4 oder neuer

# --- Sensor 1 Kalibrierung ---
S1_X_OFFSET=128.5
S1_X_GAIN=1.0
S1_Y_OFFSET=-45.0
S1_Y_GAIN=1.0
S1_Z_OFFSET=22.0
S1_Z_GAIN=1.0

# --- Sensor 2 Kalibrierung (falls angeschlossen) ---
S2_X_OFFSET=40
S2_X_GAIN=1.0
S2_Y_OFFSET=50
S2_Y_GAIN=1.0
S2_Z_OFFSET=60
S2_Z_GAIN=1.0

Fehlerbehebung​

Parameter werden nicht geladen

  • Stellen Sie sicher, dass die Datei genau config.txt (Kleinbuchstaben) im Stammverzeichnis der SD-Karte heißt
  • Stellen Sie sicher, dass die SD-Karte FAT32-formatiert ist
  • Bestätigen Sie, dass Sie den Multifunktionsknopf vor dem Einschalten gedrückt halten — zu frühes Loslassen überspringt das Laden der Konfiguration
  • Überprüfen Sie die serielle Konsolenausgabe, um zu sehen, welche Werte geladen wurden

Unerwartete Messwerte nach dem Laden

  • Setzen Sie die Kalibrierung zurück, indem Sie alle OFFSETs auf 0 und alle GAINs auf 1.0 setzen und die Konfiguration neu laden
  • Wenn das Problem weiterhin besteht, flashen Sie die Firmware neu und laden Sie erneut

Verwandte Seiten​

  • Kalibrierungsverfahren — Schritt-für-Schritt-Anleitung zur Messung und Berechnung von Offset-Werten
  • Firmware-Updates — Firmware-Versionen, die die config.txt-Unterstützung eingeführt haben