Pular para o conteúdo principal

Referência config.txt

O arquivo config.txt é um arquivo de configuração em texto simples armazenado no cartão SD do FGA Logger. Ele permite aplicar parâmetros de calibração do sensor e ajustar configurações de operação sem regravar o firmware.

A configuração é carregada uma vez na inicialização, quando você liga o dispositivo mantendo o botão multifunção pressionado.

observação

A configuração via config.txt requer firmware v1.0.4 ou posterior. A taxa de saída configurável requer v1.0.5 ou posterior.

Localização do Arquivo​

Coloque o config.txt no diretório raiz do cartão SD formatado em FAT32.

Formato do Arquivo​

  • Um parâmetro por linha
  • Formato: PARAMETER=value
  • Sem espaços ao redor do sinal =
  • Linhas que começam com # são tratadas como comentários e ignoradas
  • Os parâmetros diferenciam maiúsculas de minúsculas

Exemplo:

# 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

Referência de Parâmetros​

Calibração do Sensor 1​

ParâmetroTipoPadrãoDescrição
S1_X_OFFSETfloat0Correção de offset do eixo X para o sensor 1 (nT)
S1_Y_OFFSETfloat0Correção de offset do eixo Y para o sensor 1 (nT)
S1_Z_OFFSETfloat0Correção de offset do eixo Z para o sensor 1 (nT)
S1_X_GAINfloat1.0Multiplicador de ganho do eixo X para o sensor 1
S1_Y_GAINfloat1.0Multiplicador de ganho do eixo Y para o sensor 1
S1_Z_GAINfloat1.0Multiplicador de ganho do eixo Z para o sensor 1

Calibração do Sensor 2​

ParâmetroTipoPadrãoDescrição
S2_X_OFFSETfloat0Correção de offset do eixo X para o sensor 2 (nT)
S2_Y_OFFSETfloat0Correção de offset do eixo Y para o sensor 2 (nT)
S2_Z_OFFSETfloat0Correção de offset do eixo Z para o sensor 2 (nT)
S2_X_GAINfloat1.0Multiplicador de ganho do eixo X para o sensor 2
S2_Y_GAINfloat1.0Multiplicador de ganho do eixo Y para o sensor 2
S2_Z_GAINfloat1.0Multiplicador de ganho do eixo Z para o sensor 2

Os parâmetros do Sensor 2 se aplicam apenas quando um segundo sensor está conectado à entrada B2.

Como a Calibração É Aplicada​

O firmware aplica a calibração a cada valor de eixo usando:

corrected = (raw_value - OFFSET) * GAIN

Por exemplo, para o eixo X do sensor 1:

B1x_corrected = (B1x_raw - S1_X_OFFSET) * S1_X_GAIN

Isso é aplicado antes que o valor seja gravado no CSV ou transmitido via serial.

Carregando a Configuração​

  1. Grave seu config.txt na raiz do cartão SD
  2. Insira o cartão SD no FGA Logger
  3. Mantenha o botão multifunção pressionado e ligue o dispositivo
  4. Os LEDs acenderão e apagarão em sequência para confirmar que o arquivo foi lido
  5. Conecte via serial USB para verificar — o console exibirá os valores de parâmetros carregados:
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
dica

Os parâmetros de calibração são armazenados permanentemente dentro do logger. Não é necessário manter o config.txt no cartão SD após o carregamento — os valores persistem entre ciclos de energia e atualizações de firmware.

Exemplo 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

Solução de Problemas​

Parâmetros não carregando

  • Verifique se o arquivo está nomeado exatamente como config.txt (letras minúsculas) na raiz do cartão SD
  • Certifique-se de que o cartão SD está formatado em FAT32
  • Confirme que você está mantendo o botão multifunção pressionado antes de ligar — soltá-lo muito cedo ignorará o carregamento da configuração
  • Verifique a saída do console serial para ver quais valores foram carregados

Valores de medição inesperados após o carregamento

  • Redefina a calibração configurando todos os OFFSETs para 0 e todos os GAINs para 1.0, e recarregue a configuração
  • Se o problema persistir, regravar o firmware e recarregar

Páginas Relacionadas​