Python SDK
Python SDK
本章节介绍 AMFITRACK Python SDK，包括如何下载安装以及如何使用。
AMFITRACK 提供了两个 Python SDK（PyPI 软件包），分别用于设备管理和数据采集。
1. amfiprot
amfiprot 是一个发布在 PyPI（Python Package Index） 上的 Python 软件包，主要用于设备管理。
它可以实现以下功能：
获取设备名称（Device Name）
读取和修改设备设置（Settings）
执行设备固件升级（Firmware Update）
下载方式
方法一：通过 PyPI 页面下载
https://pypi.org/project/amfiprot/
方法二：使用 pip 安装（推荐）
打开终端（Terminal）或命令提示符（Command Prompt），执行：
pip install amfiprot
安装完成后，即可在 Python 程序中导入并使用该库。
示例代码
官方提供了使用示例，可参考：
https://pypi.org/project/amfiprot/
2. amfiprot-amfitrack
amfiprot-amfitrack 是另一个 PyPI 软件包，主要用于获取 AMFITRACK 系统的实时数据。
它负责读取来自 EMF Sensor（传感器） 和 EMF Source（电磁场发射器） 的各种数据。
可获取的数据
来自传感器（Sensor）
包括但不限于：
Position（位置）
Orientation（姿态/方向）
IMU 数据
加速度（Accelerometer）
陀螺仪（Gyroscope）
磁力计（如适用）
来自 EMF Source
包括：
Current（电流）
Frequency（工作频率）
下载方式
方法一：通过 PyPI 页面下载
https://pypi.org/project/amfiprot-amfitrack/
方法二：使用 pip 安装（推荐）
在终端执行：
pip install amfiprot-amfitrack
示例代码
官方示例可参考：
https://pypi.org/project/amfiprot-amfitrack/
两个 SDK 的区别
| 软件包 | 主要用途 | 可实现功能 |
|---|---|---|
| amfiprot | 设备管理 | 获取设备名称、读取/修改配置、固件升级等 |
| amfiprot-amfitrack | 数据采集 | 获取传感器位置、姿态、IMU 数据，以及 Source 的电流、频率等实时数据 |
推荐使用流程
对于开发 AMFITRACK 应用程序，一般建议按以下流程使用这两个 SDK：
安装 SDK
pip install amfiprotpip install amfiprot-amfitrack使用
amfiprot连接设备
读取设备信息
配置设备参数
如有需要，更新固件
使用
amfiprot-amfitrack建立与 EMF Source 和 EMF Sensor 的通信
实时获取传感器的六自由度（6DOF）位置与姿态数据
获取 IMU 数据
获取 EMF Source 的运行状态（如电流、频率）
将数据用于机器人控制、动作捕捉、导航、VR/AR 或科研分析等应用。
总体来说，amfiprot 更偏向设备管理与配置，amfiprot-amfitrack 则侧重于实时数据采集，是进行二次开发和应用集成时最常用的 SDK。