跳到主要内容

config.txt 参考手册

config.txt 是一个纯文本配置文件，存储在 FGA Logger 的 SD 卡上。它允许您在不重新刷写固件的情况下应用传感器校准参数并调整运行设置。

配置在启动时加载一次，即在按住多功能按键的同时为设备上电时读取。

备注

config.txt 配置功能需要固件 v1.0.4 或更高版本。可配置输出速率需要 v1.0.5 或更高版本。

文件位置​

将 config.txt 放置在 FAT32 格式 SD 卡的根目录下。

文件格式​

  • 每行一个参数
  • 格式：PARAMETER=value
  • = 号两侧不加空格
  • 以 # 开头的行视为注释，将被忽略
  • 参数名区分大小写

示例：

# 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

参数参考​

传感器 1 校准​

参数类型默认值描述
S1_X_OFFSETfloat0传感器 1 X 轴偏移校正（nT）
S1_Y_OFFSETfloat0传感器 1 Y 轴偏移校正（nT）
S1_Z_OFFSETfloat0传感器 1 Z 轴偏移校正（nT）
S1_X_GAINfloat1.0传感器 1 X 轴增益系数
S1_Y_GAINfloat1.0传感器 1 Y 轴增益系数
S1_Z_GAINfloat1.0传感器 1 Z 轴增益系数

传感器 2 校准​

参数类型默认值描述
S2_X_OFFSETfloat0传感器 2 X 轴偏移校正（nT）
S2_Y_OFFSETfloat0传感器 2 Y 轴偏移校正（nT）
S2_Z_OFFSETfloat0传感器 2 Z 轴偏移校正（nT）
S2_X_GAINfloat1.0传感器 2 X 轴增益系数
S2_Y_GAINfloat1.0传感器 2 Y 轴增益系数
S2_Z_GAINfloat1.0传感器 2 Z 轴增益系数

传感器 2 参数仅在第二个传感器连接至 B2 输入时生效。

校准应用方式​

固件对每个轴的值按以下公式进行校准：

corrected = (raw_value - OFFSET) * GAIN

例如，对于传感器 1 的 X 轴：

B1x_corrected = (B1x_raw - S1_X_OFFSET) * S1_X_GAIN

该操作在数值写入 CSV 或通过串口流传输之前执行。

加载配置​

  1. 将 config.txt 写入 SD 卡根目录
  2. 将 SD 卡插入 FGA Logger
  3. 按住多功能按键并为设备上电
  4. LED 将依次亮灭，确认文件已被读取
  5. 通过 USB 串口连接以验证——控制台将输出已加载的参数值：
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
提示

校准参数永久存储在记录仪内部。加载完成后无需将 config.txt 保留在 SD 卡上——这些值在断电后和固件更新后仍会保留。

完整 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

故障排除​

参数未加载

  • 确认文件名为 config.txt（小写），且位于 SD 卡根目录
  • 确保 SD 卡已格式化为 FAT32
  • 确认在上电前按住多功能按键——提前松开将跳过配置加载
  • 查看串口控制台输出以确认已加载的参数值

加载后测量值异常

  • 通过将所有 OFFSET 设为 0、所有 GAIN 设为 1.0 重置校准，然后重新加载配置
  • 如果问题持续，重新刷写固件并重新加载

相关页面​