Referencia de config.txt
El archivo config.txt es un archivo de configuración en texto plano almacenado en la tarjeta SD del FGA Logger. Permite aplicar parámetros de calibración de sensores y ajustar la configuración operativa sin necesidad de volver a instalar el firmware.
La configuración se carga una vez al inicio cuando se enciende el dispositivo mientras se mantiene pulsado el botón multifunción.
La configuración mediante config.txt requiere firmware v1.0.4 o posterior. La frecuencia de salida configurable requiere v1.0.5 o posterior.
Ubicación del archivo
Coloque config.txt en el directorio raíz de la tarjeta SD con formato FAT32.
Formato del archivo
- Un parámetro por línea
- Formato:
PARÁMETRO=valor - Sin espacios alrededor del signo
= - Las líneas que comienzan con
#se tratan como comentarios y se ignoran - Los parámetros distinguen entre mayúsculas y minúsculas
Ejemplo:
# 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
Referencia de parámetros
Calibración del sensor 1
| Parámetro | Tipo | Valor por defecto | Descripción |
|---|---|---|---|
S1_X_OFFSET | float | 0 | Corrección de offset en el eje X del sensor 1 (nT) |
S1_Y_OFFSET | float | 0 | Corrección de offset en el eje Y del sensor 1 (nT) |
S1_Z_OFFSET | float | 0 | Corrección de offset en el eje Z del sensor 1 (nT) |
S1_X_GAIN | float | 1.0 | Multiplicador de ganancia en el eje X del sensor 1 |
S1_Y_GAIN | float | 1.0 | Multiplicador de ganancia en el eje Y del sensor 1 |
S1_Z_GAIN | float | 1.0 | Multiplicador de ganancia en el eje Z del sensor 1 |
Calibración del sensor 2
| Parámetro | Tipo | Valor por defecto | Descripción |
|---|---|---|---|
S2_X_OFFSET | float | 0 | Corrección de offset en el eje X del sensor 2 (nT) |
S2_Y_OFFSET | float | 0 | Corrección de offset en el eje Y del sensor 2 (nT) |
S2_Z_OFFSET | float | 0 | Corrección de offset en el eje Z del sensor 2 (nT) |
S2_X_GAIN | float | 1.0 | Multiplicador de ganancia en el eje X del sensor 2 |
S2_Y_GAIN | float | 1.0 | Multiplicador de ganancia en el eje Y del sensor 2 |
S2_Z_GAIN | float | 1.0 | Multiplicador de ganancia en el eje Z del sensor 2 |
Los parámetros del sensor 2 solo se aplican cuando hay un segundo sensor conectado a la entrada B2.
Cómo se aplica la calibración
El firmware aplica la calibración a cada valor de eje usando:
corrected = (raw_value - OFFSET) * GAIN
Por ejemplo, para el eje X del sensor 1:
B1x_corrected = (B1x_raw - S1_X_OFFSET) * S1_X_GAIN
Esto se aplica antes de que el valor se escriba en el CSV o se transmita por serie.
Carga de la configuración
- Escriba su
config.txten la raíz de la tarjeta SD - Inserte la tarjeta SD en el FGA Logger
- Mantenga pulsado el botón multifunción y encienda el dispositivo
- Los LED se encenderán y apagarán en secuencia para confirmar que el archivo fue leído
- Conéctese a través del puerto serie USB para verificar — la consola mostrará los valores de parámetros cargados:
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
Los parámetros de calibración se almacenan de forma permanente dentro del registrador. No es necesario mantener config.txt en la tarjeta SD después de cargar los valores — estos persisten entre ciclos de encendido y actualizaciones de firmware.
Ejemplo completo 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
Resolución de problemas
Los parámetros no se cargan
- Verifique que el archivo se llame exactamente
config.txt(minúsculas) y esté en la raíz de la tarjeta SD - Asegúrese de que la tarjeta SD tenga formato FAT32
- Confirme que está manteniendo pulsado el botón multifunción antes de encender — soltarlo demasiado pronto omitirá la carga de la configuración
- Compruebe la salida de la consola serie para ver qué valores se cargaron
Valores de medición inesperados después de cargar
- Restablezca la calibración configurando todos los OFFSETs a
0y todas las GAINs a1.0, y vuelva a cargar la configuración - Si el problema persiste, vuelva a instalar el firmware y recargue
Páginas relacionadas
- Procedimiento de calibración — guía paso a paso para medir y calcular los valores de offset
- Actualizaciones de firmware — versiones de firmware que introdujeron el soporte de config.txt