# Python

FDILink Python 例程用户使用手册

通过 Python 读取 FDISYSTEMS IMU / AHRS / INS 产品数据，便于在桌面、脚本与数据处理场景中快速集成。

# 1. 简介

FDILink Python 例程基于串口接收 FDILink 协议数据，完成常用数据包的解析与打印。示例未覆盖全部数据包，可按现有结构参照 FDILink 通讯协议 自行扩展。

安装包下载见 SDK 下载与文档 中的 FDILink_Python。

# 2. 环境准备

  1. 安装 Python 3（建议 3.8 及以上）。
  2. 安装串口依赖，例如：
pip install pyserial
  1. 若电脑尚未安装串口驱动，请先下载：串口驱动下载。
  2. 解压 FDILink_Python 安装包，进入例程目录。

# 3. 使用方法

# (1) 地面站配置数据输出

  1. 将产品通过 USB / 串口连接到电脑，打开 FDIGroundStation。
  2. 配置目标 COM 口波特率，并按需使能要输出的 FDILink 数据包及频率。
  3. 保存参数并重启设备，使配置生效。
  4. 可用串口助手确认总线上有以 FC 开头的数据帧。

数据包字段定义见 FDILink 数据包。

# (2) 运行 Python 例程

  1. 确认例程中的串口号、波特率与上位机配置一致（Windows 形如 COM3，Linux / macOS 形如 /dev/ttyUSB0 或 /dev/cu.usbserial-*）。
  2. 在例程目录执行：
python main.py

（若入口文件名不同，以压缩包内 README 或实际脚本名为准。）

  1. 终端正常打印解析后的 IMU / 姿态 / 位置等字段，即表示通信成功。

# (3) 二次开发

  • 需要其他数据包时，请对照协议手册中的 Packet ID 与字段表，在解析函数中增加对应分支。
  • 修改输出内容后，须在上位机中使能相应数据包，否则总线上不会出现该帧。
  • 指令配置（波特率、端口协议、滤波开关等）见 FDILink 指令配置说明。

# 4. 相关链接

← C# →