跳到主要内容

🦾 VT-TacGripper SDK 使用手册

版本:1.2.0 平台:Linux x86_64 · Python 3.10 / 3.12 适用夹爪:VT-TacGripper-85-S、VT-TacGripper-85-L、VT-TacGripper-Slim

VT-TacGripper SDK 用于通过 USB2CANFD 适配器控制 VT 视触觉夹爪,支持设备枚举、通信配置、自动标定、手动示教、位置/力控运动与状态读取。


📖 手册导航​

章节内容建议阅读
🦾 SDK 介绍能力、环境、组成、首次流程、已知限制第一次使用前
🛠️ 使用指南安装、权限、标定、验证(teach / 代码)上手与现场操作
📚 API 文档VTacGripper 构造、属性、方法、返回对象写控制代码时
🚨 错误码与异常用户可见报错、电机状态码、故障恢复、CLI 退出码排障时

🚀 推荐使用顺序​

  1. 安装 SDK → 安装 wheel
  2. 配置设备权限 → udev 权限
  3. 确认设备与通信 → 发现设备与首次配置
  4. 标定夹爪 → 自动标定
  5. 验证动作 → teach 验证 或 代码验证

💡 提示 新的夹爪或更换机构后,必须先标定再运行应用代码。标定会让夹爪在机械限位处短暂受力,请确保夹爪空载、行程内无阻挡。


🧭 阅读约定​

  • <SN> 为 USB2CANFD 适配器序列号,可用 list_devices 查询;单适配器时可省略。
  • 命令默认在仓库根目录执行;--config ./devices.json 表示把一机一码配置保存到当前目录。
  • 代码中的 vel、force 均为 0–100 百分比,不是 rad/s 或 Nm。
  • 首次使用建议使用 POS_FORCE 模式;固件不支持时再改用 POS_VEL。
  • VTacGripper 构造默认不使能;运动前先调用 enable()。release() 不改变使能状态,需要失能时显式调用 disable()。
  • 夹具/机构发生变更、重新安装电机或配置丢失后,应重新标定。

🆘 获取帮助​

遇到问题时,请先查看 错误码与异常,并在反馈中附上:

  • 操作系统与 Python 版本
  • 适配器 SN
  • 完整报错文本
  • 复现步骤
  • diagnose 的输出(如可运行)