跳转到内容
English

更新日志

  • 修复 CANFD 广播 0 发现:使用扩展帧接收真实从站地址的响应,再单播确认设备;保留地址过滤、去重和默认 126/127 单播兜底。
  • 修正压阻阵列掌心读取:寄存器 4037 实报点数大于 0 时从 4165 开始读取,包括实报 36 点的情况;为 0 或点数寄存器不可用时,从 4200 读取旧布局 36 点。

SDK 2.x 公共签名和调用方式不变,无需修改应用调用代码。

  • 新增 Python Hand、C++ Hand 和 C ABI 的硬件追溯码按需读取接口,返回完整 ASCII 字符串,不解析配置字段,也不自动执行 Factory KEY 认证。
  • 不支持功能/寄存器、空数据或全 0xFFFF 数据返回空字符串;通信、其他设备异常及数据格式错误仍报错。缺少追溯码不影响连接。
  • 修复 2.3.3 误删的逐关节保护电流能力,恢复 Python、C/C++ 和 GUI 的逐关节保护电流设置(201 + 关节索引)与配置读回(201~221)。200 保持只写,116 保持弃用;C 配置结构大小和后续字段偏移不变。
  • Python State、C++ State 和 C ABI 新增整手 21 关节位置、速度、电流、运行状态的独立读取。单项调用计入状态读取统计;多次独立调用不构成原子快照。
  • State、Touch、Health 订阅周期计入读取和调用方处理耗时;超期后立即开始下一次读取,不补采错过的周期。
  • 保护电流设置拒绝非有限值、负数及超过 32767 mA 的输入,不发送无效写入;该范围仅表示协议编码范围,实际设置仍须遵守设备和应用的电流限制。
  • CANFD 收到畸形长度时返回错误,保留 USB 接收错误;Python 动作示例限制清理等待并保留最初的通信错误。

从 2.3.3 升级后,可重新使用 set_joint_protect_current 和配置快照的 joint_protect_current_ma。从 2.3.1/2.3.2 升级时,旧 set_global_protect_current 改用 set_max_continuous_current;全局电流字段保持移除。C/C++ 应用须使用 2.3.4 头文件重新编译。

  • 全局最大持续电流改为通过只写寄存器 200 对所有关节生效;116 已弃用,配置快照不再读取电流设置。
  • 不兼容变更:移除全局、逐关节保护电流 setter 和 Python/C++ 配置快照中的三个电流字段。C 应用需使用新头文件重新编译,原电流槽位保留并始终清零。
  • 删除 GUI 中旧的保护电流控件;接触探测诊断需显式指定软件电流阈值。
  • 修正拇指初始限位:J16 根部屈伸为 0~75°,J20 自转为 0~105°。设备成功回读后仍覆盖默认值;公共关节编号与控制器槽位映射不变。
  • 同步 GUI 标签、握拳关节选择、时序测试目标、C API 注释和诊断示例中的拇指定义。
  • 增加默认限位、设备限位回读与 GUI 握拳目标的回归检查。
  • Windows 扫描:修复 Modbus 探测超时后重开串口被拒绝、导致后续设备无法发现的问题;重开前等待旧连接释放。
  • Modbus 恢复:修复请求超时或调用方取消使连接失效后,重连函数未实际重连的问题。保留原有超时阈值及迟到响应隔离保护。
  • 控制模式提示:选择整手 Position 或 Damping 模式时,提示已有控制可能需要先显式恢复 MIT 模式。
  • 整手控制模式:新增 Python Motion、C++ Motion 和 C ABI 的显式模式读取与设置,支持 Position、Damping、Mit,需要配套固件支持。
  • 兼容性:保留已有控制接口和单位,连接与控制调用不会隐式探测或切换整手模式。旧固件应用继续使用已有接口,并隐藏或禁用不支持的模式切换入口。
  • 错误处理:模式写入与运动、Servo、拖拽互斥;失败时不自动重试,不缓存或假定模式。发送后取消等待不能撤销已发送的写入。

MIT 位置跟踪需要按关节、负载与机械状态选择 Kp/Kd,不能直接沿用 Position 模式的精度预期。新增接口与限制见 Motion 与 ServoSession。

  • 连接与触觉布局:连接成功前读取支持的触觉阵列运行时点数,首次获取的布局可直接用于快照和订阅,无需先调用 hand.touch.point_counts()。无阵列设备不读取点数;旧固件保留既有兼容回退,点数初始化失败时连接返回错误。
  • Python 布局快照:布局对象不会自动更新。显式修改布局或再次查询点数后,重新获取 hand.touch.layout 及其 modules。
  • Linux C/C++ 分发:默认 portable 包继续携带 libusb、libudev;新增 download-lib.sh --system-deps,供已具备兼容系统库的环境使用。下载脚本保留 SDK 与第三方许可,不安装或替换系统库。Python wheel 分发方式不变。

现有 SDK 2.x 控制接口及调用方式不变。详见开发指南。

  • 掌心触觉读取:修复 UT1、UF2、UF3、UV1、UV2 的压阻阵列掌心读取,兼容 36 点和 71 点布局。实际点数以设备布局为准,保留对旧固件的兼容。
  • RS485 通信恢复:修复请求超时或取消后,后续读写及连接关闭可能持续等待的问题。内置 Modbus RTU 普通寄存器请求的等待时间上限为 1000 ms。
  • Linux 兼容性:x86_64 和 aarch64 安装包支持 glibc 2.31 及以上环境,包括 Ubuntu 20.04。
  • 内置 Modbus 请求超时或取消后,需关闭原 Manager,创建新 Manager 并重新连接。写入结果未确认时,重连后先读取设备实际状态,不要直接重发。自定义 Modbus 回调和 CANFD 不适用上述请求超时规则;OTA 数据写入使用专用超时。
  • 应用应按设备实际触觉布局处理数组长度。绘制 71 点掌心热力图时,需使用匹配的空间坐标,不能直接沿用 36 点坐标。

安装步骤见十分钟入门,触觉布局与连接恢复说明见开发指南。