更新日志
2.3.5 · 2026-11-03
Section titled “2.3.5 · 2026-11-03”- 修复 CANFD 广播 0 发现:使用扩展帧接收真实从站地址的响应,再单播确认设备;保留地址过滤、去重和默认 126/127 单播兜底。
- 修正压阻阵列掌心读取:寄存器
4037实报点数大于 0 时从4165开始读取,包括实报 36 点的情况;为 0 或点数寄存器不可用时,从4200读取旧布局 36 点。
SDK 2.x 公共签名和调用方式不变,无需修改应用调用代码。
2.3.4 · 2026-11-03
Section titled “2.3.4 · 2026-11-03”- 新增 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 头文件重新编译。
2.3.3 · 2026-11-03
Section titled “2.3.3 · 2026-11-03”- 全局最大持续电流改为通过只写寄存器 200 对所有关节生效;116 已弃用,配置快照不再读取电流设置。
- 不兼容变更:移除全局、逐关节保护电流 setter 和 Python/C++ 配置快照中的三个电流字段。C 应用需使用新头文件重新编译,原电流槽位保留并始终清零。
- 删除 GUI 中旧的保护电流控件;接触探测诊断需显式指定软件电流阈值。
2.3.2 · 2026-10-26
Section titled “2.3.2 · 2026-10-26”- 修正拇指初始限位:J16 根部屈伸为 0~75°,J20 自转为 0~105°。设备成功回读后仍覆盖默认值;公共关节编号与控制器槽位映射不变。
- 同步 GUI 标签、握拳关节选择、时序测试目标、C API 注释和诊断示例中的拇指定义。
- 增加默认限位、设备限位回读与 GUI 握拳目标的回归检查。
2.3.1 · 2026-10-26
Section titled “2.3.1 · 2026-10-26”- Windows 扫描:修复 Modbus 探测超时后重开串口被拒绝、导致后续设备无法发现的问题;重开前等待旧连接释放。
- Modbus 恢复:修复请求超时或调用方取消使连接失效后,重连函数未实际重连的问题。保留原有超时阈值及迟到响应隔离保护。
- 控制模式提示:选择整手 Position 或 Damping 模式时,提示已有控制可能需要先显式恢复 MIT 模式。
2.3.0 · 2026-10-22
Section titled “2.3.0 · 2026-10-22”- 整手控制模式:新增 Python Motion、C++ Motion 和 C ABI 的显式模式读取与设置,支持 Position、Damping、Mit,需要配套固件支持。
- 兼容性:保留已有控制接口和单位,连接与控制调用不会隐式探测或切换整手模式。旧固件应用继续使用已有接口,并隐藏或禁用不支持的模式切换入口。
- 错误处理:模式写入与运动、Servo、拖拽互斥;失败时不自动重试,不缓存或假定模式。发送后取消等待不能撤销已发送的写入。
MIT 位置跟踪需要按关节、负载与机械状态选择 Kp/Kd,不能直接沿用 Position 模式的精度预期。新增接口与限制见 Motion 与 ServoSession。
2.2.1 · 2026-10-19
Section titled “2.2.1 · 2026-10-19”- 连接与触觉布局:连接成功前读取支持的触觉阵列运行时点数,首次获取的布局可直接用于快照和订阅,无需先调用
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 控制接口及调用方式不变。详见开发指南。
2.2.0 · 2026-10-16
Section titled “2.2.0 · 2026-10-16”- 掌心触觉读取:修复
UT1、UF2、UF3、UV1、UV2的压阻阵列掌心读取,兼容 36 点和 71 点布局。实际点数以设备布局为准,保留对旧固件的兼容。 - RS485 通信恢复:修复请求超时或取消后,后续读写及连接关闭可能持续等待的问题。内置 Modbus RTU 普通寄存器请求的等待时间上限为 1000 ms。
- Linux 兼容性:x86_64 和 aarch64 安装包支持 glibc 2.31 及以上环境,包括 Ubuntu 20.04。
升级注意事项
Section titled “升级注意事项”- 内置 Modbus 请求超时或取消后,需关闭原
Manager,创建新Manager并重新连接。写入结果未确认时,重连后先读取设备实际状态,不要直接重发。自定义 Modbus 回调和 CANFD 不适用上述请求超时规则;OTA 数据写入使用专用超时。 - 应用应按设备实际触觉布局处理数组长度。绘制 71 点掌心热力图时,需使用匹配的空间坐标,不能直接沿用 36 点坐标。