该 SDK 目前已针对 Python 3.10 及以上版本进行测试。

建议通过 pip 安装

对于 Mac 和 Linux：

pip install aero-open-sdk

对于 Windows（使用 PowerShell）：

python -m pip install --upgrade pip
python -m pip install aero-open-sdk

选项 2：从源代码安装（获取最新更新）

1.将代码库克隆到本地计算机

git clone https://github.com/TetherIA/aero-hand-open.git

2.导航到 SDK 目录：

cd aero-hand-open/sdk

3.以可编辑模式安装该软件包：

pip install -e .

步骤 2：图形用户界面GUI — Aero Hand Open控制程序

安装后从终端启动图形用户界面：

对于 Mac 和 Linux：

aero-open-gui

对 Windows 系统：

python -m aero_open_sdk

注意：如果系统找不到该命令，请确保Python环境的脚本目录已添加到PATH中，并且包已安装到活动环境中。如需更多故障排除信息，请参阅文档末尾的“故障排除”部分。

Find port查找端口号：

点击“刷新”按钮（靠近端口选择处），下拉菜单将弹出。如果Windows电脑上未连接多个串行设备，刷新后会自动选择正确的COM端口。这在仅用一只手操作时很方便。如果双手都使用，拔掉所有设备，再逐一插回以确定每个手（左手或右手）

对应的COM端口。在Linux系统中，刷新后会找到类似/dev/ttyACM0、/dev/ttyACM1或/dev/ttyUSB*的设备路径，然后使用正确的端口连接手部设备。

Homing

连接手部后，你将在图形用户界面（GUI）中看到一个“Homing”按钮。按下此按钮开始归位。请确保手部处于安全位置，且前方没有障碍物。如果运动不符合预期，我们建议执行归位操作。归位过程中，手部不会响应其他命令，且需要一些时间完成整个过程。完成后，图形用户界面（GUI）将显示确认信息（ACK），表明归位已完成。

滑动滑块以控制位置

在图形用户界面中，您可以使用滑块控制每个手指或执行器的位置。每个滑块代表一个通道（手指或拇指关节），允许您将其位置设置为从0（完全打开/伸展）到1（完全闭合/抓握）。

只需点击并拖动滑块至所需值，手部会实时移动到该位置。这有助于测试单个手指的运动，也可手动将手部定位到您选择的某种姿势。

步骤 3：Python 控制与示例

Aero Hand 通过 USB-C 线缆连接到主机 PC。要在 Windows 电脑上操作 SDK，必须为您的设备指定正确的串口。

Find port查找端口号：

Linux

如果你只用一只手进行操作和工作，可以直接初始化手部。

from aero_open_sdk.aero_hand import AeroHand

aero_hand = AeroHand()

Windows

在 Windows 系统中，连接到 USB 端口的设备会显示为 COM 端口，例如 COM12 或 COM3。您可以通过在“设备管理器”中的“端口 (COM & LPT)”下检查来找到正确的端口。该设备将被列为类似“USB 串行设备 (COM12)”的条目。

然后您可以使用检测到的COM端口初始化您的灵巧手：

from aero_open_sdk.aero_hand import AeroHand
aero_hand = AeroHand(port="COM3")

一旦你从上述步骤中知道了设备的端口，你就可以运行sdk/examples文件夹中的任何示例文件来测试或控制你的Aero Hand Open。

运行示例

run_sequence

如果归位操作正确完成且手部处于安全位置，运行 run_sequence.py 示例将使您的手依次通过一系列姿势：掌心张开、逐一捏起每个手指、掌心张开、比出和平手势、掌心张开、比出摇滚手势，然后回到掌心张开。

你也可以创建任何自定义轨迹并使用 hand.run_trajectory 来执行它。

power_grasp

运行 power_grasp.py 示例时，你可以使用键盘上的空格键在手的张开和闭合姿态之间切换。这允许你快速切换手的状态，以便进行测试或演示。

你也可以将 open_pose 和 grip_pose 更改为任何你想要的目标姿态，然后调用 hand.set_joint_positions。请确保检查 SDK 中的关节常量，因为每个关节的输入值必须在支持范围内，否则输入值将被截断到上下限范围。

探索更多示例

更多示例可在 sdk 文件夹中找到