串行和CSV格式

本页记录FGA Logger和FG-3C传感器使用的串行通信设置和数据格式。

---

FGA Logger

串行设置

参数	值
接口	USB-C虚拟COM端口或DB9 UART
波特率	可配置（请参阅固件文档了解可用波特率）
数据位	8
奇偶校验	无
停止位	1
流控制	无

通过USB-C将FGA Logger连接到PC。它将显示为虚拟COM端口（Windows：COMx，Linux/macOS：/dev/ttyUSBx或/dev/tty.usbserial-x）。

---

CSV格式

FGA Logger以**逗号分隔值（CSV）**格式输出数据，在串行接口和SD卡日志文件中均如此。每行代表一个测量样本。

标题行

Timestamp_ms,B1x_nT,B1y_nT,B1z_nT,B1v_nT,B2x_nT,B2y_nT,B2z_nT,B2v_nT,Lat_deg,Lon_deg,Alt_m,SIV,Fix,HDOP_m

示例数据行

1710500123456,24312.5,-1823.1,44521.8,50234.6,24318.2,-1819.4,44518.3,50231.1,46.051980,14.506280,312.4,8,3,1.2

---

字段描述

字段	单位	描述
Timestamp_ms	ms	自上电或纪元以来的系统时间戳（毫秒）
B1x_nT	nT	磁场，传感器1，X轴
B1y_nT	nT	磁场，传感器1，Y轴
B1z_nT	nT	磁场，传感器1，Z轴
B1v_nT	nT	总场矢量幅度，传感器1（√(x²+y²+z²)）
B2x_nT	nT	磁场，传感器2，X轴
B2y_nT	nT	磁场，传感器2，Y轴
B2z_nT	nT	磁场，传感器2，Z轴
B2v_nT	nT	总场矢量幅度，传感器2
Lat_deg	°	GPS纬度，十进制度（WGS84）
Lon_deg	°	GPS经度，十进制度（WGS84）
Alt_m	m	GPS海拔（平均海平面以上）
SIV	—	可见卫星数
Fix	—	GPS定位类型（0=无定位，2=2D，3=3D）
HDOP_m	m	水平精度因子

梯度仪使用

在单传感器配置中，B2字段（B2x_nT、B2y_nT、B2z_nT、B2v_nT）将为零或未填充。在梯度仪配置中，B1和B2均处于活动状态，梯度可按轴计算为B1 − B2。

GPS质量

使用Fix和HDOP_m过滤低质量GPS行。Fix为3且HDOP_m低于2.0表示可靠的GPS位置。

---

FG-3C串行输出

设置

参数	值
波特率	115200
数据位	8
奇偶校验	无
停止位	1
流控制	无

UART模式

在UART模式下，FG-3C通过引脚4（TX）以**ASCII文本形式（nT）**传输测量的磁场。将引脚4连接到MCU的RX或USB-UART桥接器。

示例输出

24315.2
24318.6
24311.9
24320.4

每行是一个测量样本。该值是传感器灵敏轴方向的场强，单位为纳特斯拉。

备注

输出率和确切格式（固定小数位、有符号与无符号）可能因固件版本而异。完整规格请参阅FG-3C数据手册。