Clarify fixed A7 left-arm scope and document historical CAN issues

This commit is contained in:
2026-10-29 15:40:59 +08:00
parent cda4cc2930
commit 5e2cd9020a
3 changed files with 72 additions and 5 deletions
+9 -3
View File
@@ -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,使用、修改和再分发的许可说明尚待补齐。
+56
View File
@@ -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项离线测试已通过。历史观察不等于新设备验收,也不等于本轮重新进行了实机测试。
+7 -2
View File
@@ -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,