diff --git a/README.md b/README.md index f50099a..b141c7a 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -# A7 机械臂直连 CAN SDK +# A7 左臂直连 CAN SDK(固定配置) -通过 Linux SocketCAN 直接访问 A7 机械臂电机的 Python SDK,提供协议编解码、参数读写、位置控制、反馈保护和内存假 CAN。 +面向现有 A7 左臂固定电机配置,通过 Linux SocketCAN 直接访问电机的 Python SDK,提供协议编解码、参数读写、位置控制、反馈保护和内存假 CAN。适合复用同配置的通信与控制代码;不是任意机械臂通用驱动,也不是在线控制器 TCP SDK,不提供 MoveJ、逆运动学或完整抓取流程。 ## 安装 @@ -26,7 +26,7 @@ check 只使用内存假 CAN、报文编码和只读入口的计划模式,不 .venv/bin/a7-can-inspect --config config/left.json --output out ~~~ -config/left.json 是原设备的配置快照:ID61–67、host253、1 Mbps、前五轴 P80、后两轴 PA43。UID、方向、限位与 verified 字段仅适用于原设备与原现场,不代表新设备已完成校验。需由现场预先接线并配置 can0,SDK 不会自行配置 CAN 接口。 +config/left.json 保留项目默认 UID 和配置,不要求用户例行替换 UID。默认硬件映射为:ID61–67、host253、1 Mbps、前五轴 P80、后两轴 PA43。当前配置加载器固定要求上述左臂映射、host与波特率。默认 UID 仍按实读结果核对;若不匹配,应核对实际连接与设备信息,不删除身份检查。方向、限位与 verified 字段记录原现场条件,不代表其他现场已完成校验。需由现场预先接线并配置 can0,SDK 不会自行配置 CAN 接口。 ## 组成 @@ -43,3 +43,9 @@ config/left.json 是原设备的配置快照:ID61–67、host253、1 Mbps、 接口和控制边界见 [SDK 接口](docs/API.md),两套协议的区别与现场结果见 [协议说明](docs/PROTOCOLS.md)。 MotorBus 默认 allow_control=False;导入 SDK 不打开设备。实际位置写入仍要求显式开启控制并通过原身份、模式、反馈、限位等检查。模式5位置控制是现有使用路径;未核验的力矩/阻抗接口拒绝执行。停止与关闭行为见 SDK 接口说明。 + +## 已知问题与复用边界 + +历史遇到的标准协议无响应、模式编号误解、运动波动、反馈滞后和速度上限问题,见 **[历史问题与排查](docs/TROUBLESHOOTING.md)**。文档区分实机观察、离线分析与尚未验证的能力,不将完成报文编码等同实机支持。 + +本仓库目前未附 LICENSE,使用、修改和再分发的许可说明尚待补齐。 diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md new file mode 100644 index 0000000..cab33d8 --- /dev/null +++ b/docs/TROUBLESHOOTING.md @@ -0,0 +1,56 @@ +# 历史问题与排查 + +本页针对直连 CAN SDK。默认 UID 保留,身份匹配检查保留。以下历史实测发生于原 A7 左臂配置,不代表其他固件或设备的结果;本轮文档整理没有操作真机。 + +## 1. 扩展协议能通信,标准协议查询无响应 + +2026-10-09:七轴扩展 UID/模式查询14次成功,模式均为5;标准 classic 查询21次无响应。2026-10-10在J3和J7逐模式寄存器试验中,24次标准查询仍无响应。 + +结论:手册标准帧编解码通过,不等于当前设备已支持该通信方式。先核对实际扩展/标准协议、CAN格式及配置;不要将标准查询超时解释为全部CAN通信故障,也不要直接切换CAN FD。当前使用路径仍是29位扩展classic CAN。详见[协议说明](PROTOCOLS.md)。 + +## 2. 模式编号写入并读回,不代表该控制模式已验证 + +2026-10-10仅J3(P80)和J7(PA43)在停止状态下测试扩展寄存器0x7005,0~5均可写入并原值读回。该次没有使能或发送运动目标,因此没有验证各编号的控制律。P80与PA43手册枚举也不同,不能直接套到扩展寄存器上。 + +有历史位置运动证据的是模式5与0x7016位置目标链。其他模式、力矩/阻抗控制及标准协议运动仍需单独核验;SDK拒绝未完成准备的力矩/阻抗接口,不应通过改枚举绕过。 + +## 3. 轨迹减点或提高发送频率,不保证消除卡顿 + +2026-10-09两端点正反测试没有经过录制的中间节点,位置误差仍有周期波动。10月10日离线分析中,J2正反向主峰约2.734Hz;发送间隔约10ms,未发现足以解释约0.366秒周期的长时间发送中断。 + +这说明该次波动不需要密集示教节点也会出现,但没有证明控制环、摩擦或机械结构中的唯一根因。不要把“减少节点”“提高频率”写成已解决卡顿。配置中的500/250Hz及实验1000Hz也不是本SDK已认证的硬件运行频率;历史回放成功记录为约100Hz。 + +## 4. 位置差分速度与拟合延迟不能直接当补偿参数 + +历史速度曲线来自位置差分,时间依据为主机发送/接收时间,不是同步编码器采样时钟。完整回放拟合得到部分关节约66~94ms延迟,但同时包含控制、采集和接收延迟;J2去掉拟合延迟后仍有明显剩余波动。 + +需要区分目标、实际位置、原生速度及主机接收时间。缺少同步速度/电流数据时,不能据此断言饱和、扭矩不足,也不能直接把拟合值设置成提前量补偿。 + +## 5. 提速缩短了时长,周期波动仍未消失 + +2026-10-10历史上层回放把规划/驱动速度10提高到12°/s,重新配时后单程从24.4614秒降至21.2106秒。节点布局也发生变化,不能把全部差异都归于速度设置。 + +位置回放完成了正向、反向及回零;但J2的2~4Hz绝对波动未减小,J7该频段反而增大。不能据此宣称全臂平滑度问题已修复。默认12°/s、实测速度保护15°/s以及配置加载器的应用门限都不是测得的机械最大能力。 + +## 6. 掉使能录制时,要区分直连CAN与在线状态链 + +2026-10-23曾出现人工移动手臂但ROS /left/arm_state录制七轴恒值的情况。该记录走在线状态链,不能据此判断直连CAN位置读取无效,也不能把消息刷新当成实际关节角刷新。 + +同日直连CAN位置查询取得118组、约12.342秒数据,七轴角度随人工运动变化;七轴顺序查询最大跨度约6.96ms。它证明该次读取能跟踪人工运动,但不是七轴同步采样。掉使能由操作者描述,程序当时未独立验证使能状态,不能推广为所有设备均支持掉使能实时反馈。 + +## 7. 当前错误应如何理解 + +| 现象 | 含义与处理 | +| --- | --- | +| UID mismatch | 默认UID与本次实读不符;核对接线、ID和设备,不删除身份检查 | +| Requires UP CAN… | 检查接口是否UP、1Mbps、classic CAN MTU16及非listen-only;SDK不会配置接口 | +| 取得接口锁失败 | 检查同接口的其他SDK进程;锁不能阻止不遵守该锁的程序或其他主机 | +| 反馈超时、过期或故障 | 记录原始错误和最后有效反馈;失去反馈不等于已停止,不自动重发运动 | +| 停止未确认 | 停止请求已发送不等于设备已停止,应保留确认结果,不伪报成功 | +| 力矩/阻抗未准备异常 | 当前能力边界,不是安装失败;不能仅开启allow_control跳过协议核验 | + +## 记录来源与范围 + +协议数字与运动分析来自原项目历史记录:mode_register_hardware_summary_20261010.md、tracking_lag_analysis_20261010.md、position_speed_comparison_20261010.md,以及10月23日直连读取记录。这里只整理可复用结论,原始实机日志和上层回放程序不随本SDK打包;这些文件名是溯源标识,不是本仓库可运行入口。 + +当前交付验证见[VALIDATION.md](VALIDATION.md):独立安装与26项离线测试已通过。历史观察不等于新设备验收,也不等于本轮重新进行了实机测试。 diff --git a/docs/package_manifest.json b/docs/package_manifest.json index 039eb13..2d9f107 100644 --- a/docs/package_manifest.json +++ b/docs/package_manifest.json @@ -7,8 +7,8 @@ }, { "file": "README.md", - "bytes": 2222, - "sha256": "e3e8bb7e894523b058d5abcfaf9e2d992863ff3411ce29f30665715d29345edd" + "bytes": 3083, + "sha256": "d9d80b6423a07523942b2252df435ed60b62c8e5be334770fe4b9cd39ae287d6" }, { "file": "config/left.json", @@ -25,6 +25,11 @@ "bytes": 1677, "sha256": "588c852cd0557baaaf438256a13f9c098c844aae4e7d1cb0b8564007434ac351" }, + { + "file": "docs/TROUBLESHOOTING.md", + "bytes": 5121, + "sha256": "7f84c6812bcb5f6101adc2849a28561c35df861cbb29e6716fb421fa9ad9ea7f" + }, { "file": "docs/VALIDATION.md", "bytes": 1192,