Référence config.txt
Le fichier config.txt est un fichier de configuration en texte brut stocké sur la carte SD du FGA Logger. Il vous permet d'appliquer des paramètres de calibration des capteurs et d'ajuster les réglages de fonctionnement sans reflasher le firmware.
La configuration est chargée une seule fois au démarrage lorsque vous mettez l'appareil sous tension tout en maintenant le bouton multifonction enfoncé.
La configuration via config.txt nécessite le firmware v1.0.4 ou ultérieur. Le débit de sortie configurable nécessite la v1.0.5 ou ultérieur.
Emplacement du fichier
Placez config.txt dans le répertoire racine de la carte SD formatée en FAT32.
Format du fichier
- Un paramètre par ligne
- Format :
PARAMETRE=valeur - Aucun espace autour du signe
= - Les lignes commençant par
#sont traitées comme des commentaires et ignorées - Les paramètres sont sensibles à la casse
Exemple :
# FGA Logger configuration
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
Référence des paramètres
Calibration du capteur 1
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
S1_X_OFFSET | float | 0 | Correction du décalage sur l'axe X pour le capteur 1 (nT) |
S1_Y_OFFSET | float | 0 | Correction du décalage sur l'axe Y pour le capteur 1 (nT) |
S1_Z_OFFSET | float | 0 | Correction du décalage sur l'axe Z pour le capteur 1 (nT) |
S1_X_GAIN | float | 1.0 | Multiplicateur de gain sur l'axe X pour le capteur 1 |
S1_Y_GAIN | float | 1.0 | Multiplicateur de gain sur l'axe Y pour le capteur 1 |
S1_Z_GAIN | float | 1.0 | Multiplicateur de gain sur l'axe Z pour le capteur 1 |
Calibration du capteur 2
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
S2_X_OFFSET | float | 0 | Correction du décalage sur l'axe X pour le capteur 2 (nT) |
S2_Y_OFFSET | float | 0 | Correction du décalage sur l'axe Y pour le capteur 2 (nT) |
S2_Z_OFFSET | float | 0 | Correction du décalage sur l'axe Z pour le capteur 2 (nT) |
S2_X_GAIN | float | 1.0 | Multiplicateur de gain sur l'axe X pour le capteur 2 |
S2_Y_GAIN | float | 1.0 | Multiplicateur de gain sur l'axe Y pour le capteur 2 |
S2_Z_GAIN | float | 1.0 | Multiplicateur de gain sur l'axe Z pour le capteur 2 |
Les paramètres du capteur 2 s'appliquent uniquement lorsqu'un second capteur est connecté à l'entrée B2.
Application de la calibration
Le firmware applique la calibration à chaque valeur d'axe selon la formule :
corrigé = (valeur_brute - OFFSET) * GAIN
Par exemple, pour l'axe X du capteur 1 :
B1x_corrected = (B1x_raw - S1_X_OFFSET) * S1_X_GAIN
Ceci s'applique avant que la valeur soit écrite dans le CSV ou transmise via la liaison série.
Chargement de la configuration
- Écrivez votre fichier
config.txtà la racine de la carte SD - Insérez la carte SD dans le FGA Logger
- Maintenez le bouton multifonction enfoncé et mettez l'appareil SOUS TENSION
- Les LEDs s'allument et s'éteignent en séquence pour confirmer que le fichier a été lu
- Connectez-vous via le port série USB pour vérifier — la console affichera les valeurs de paramètres chargés :
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
Les paramètres de calibration sont stockés de façon permanente dans le logger. Vous n'avez pas besoin de conserver config.txt sur la carte SD après le chargement — les valeurs persistent à travers les cycles d'alimentation et les mises à jour du firmware.
Exemple complet de config.txt
# FGA Logger configuration file
# Requires firmware v1.0.4 or later
# --- Sensor 1 calibration ---
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 calibration (if connected) ---
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
Dépannage
Les paramètres ne se chargent pas
- Vérifiez que le fichier est nommé exactement
config.txt(en minuscules) à la racine de la carte SD - Assurez-vous que la carte SD est formatée en FAT32
- Confirmez que vous maintenez le bouton multifonction enfoncé avant la mise sous tension — le relâcher trop tôt ignorera le chargement de la configuration
- Vérifiez la sortie de la console série pour voir quelles valeurs ont été chargées
Valeurs de mesure inattendues après le chargement
- Réinitialisez la calibration en mettant tous les OFFSET à
0et tous les GAIN à1.0, puis rechargez la configuration - Si le problème persiste, reflashez le firmware et rechargez
Pages associées
- Procédure de calibration — guide étape par étape pour mesurer et calculer les valeurs de décalage
- Mises à jour du firmware — versions du firmware ayant introduit la prise en charge de config.txt