3.0 KiB
A7 左臂直连 CAN SDK(固定配置)
面向现有 A7 左臂固定电机配置,通过 Linux SocketCAN 直接访问电机的 Python SDK,提供协议编解码、参数读写、位置控制、反馈保护和内存假 CAN。适合复用同配置的通信与控制代码;不是任意机械臂通用驱动,也不是在线控制器 TCP SDK,不提供 MoveJ、逆运动学或完整抓取流程。
安装
Linux、系统 Python 3.12 + venv,真机传输需要 SocketCAN 和 iproute2。SDK 运行时仅使用 Python 标准库。
bash scripts/setup.sh
bash scripts/check.sh
check 只使用内存假 CAN、报文编码和只读入口的计划模式,不连接真机。
示例
# 内存假电机
.venv/bin/python examples/fake_can.py
# 只显示读取计划,不连接 CAN
.venv/bin/python examples/read_angles.py
# 明确只读现场查询:核对 UID 后读取七轴位置
.venv/bin/python examples/read_angles.py --config config/left.json --samples 10 --execute
# 完整只读参数诊断;此命令会立即打开 CAN 并发送查询
.venv/bin/a7-can-inspect --config config/left.json --output out
config/left.json 保留项目默认 UID 和配置,不要求用户例行替换 UID。默认硬件映射为:ID61–67、host253、1 Mbps、前五轴 P80、后两轴 PA43。当前配置加载器固定要求上述左臂映射、host与波特率。默认 UID 仍按实读结果核对;若不匹配,应核对实际连接与设备信息,不删除身份检查。方向、限位与 verified 字段记录原现场条件,不代表其他现场已完成校验。需由现场预先接线并配置 can0,SDK 不会自行配置 CAN 接口。
组成
| 模块 | 用途 |
|---|---|
| protocol.py | 已使用的 29 位扩展 CAN 协议、参数及反馈解码 |
| client.py | MotorBus:身份、读取、受限写入、使能与停止确认 |
| transport.py | SocketCAN、独占锁、classic/FD 与帧类型检查 |
| configuration.py | 七轴映射与配置校验 |
| runtime.py / startup.py | 上层轨迹适配、显式启动状态机 |
| manual_protocol.py / manual_client.py | P80/P50、PA43 手册标准帧编码与受限客户端 |
| fake.py / trace.py | 内存假电机与执行日志 |
接口和控制边界见 SDK 接口,两套协议的区别与现场结果见 协议说明。
MotorBus 默认 allow_control=False;导入 SDK 不打开设备。实际位置写入仍要求显式开启控制并通过原身份、模式、反馈、限位等检查。模式5位置控制是现有使用路径;未核验的力矩/阻抗接口拒绝执行。停止与关闭行为见 SDK 接口说明。
已知问题与复用边界
历史遇到的标准协议无响应、模式编号误解、运动波动、反馈滞后和速度上限问题,见 历史问题与排查。文档区分实机观察、离线分析与尚未验证的能力,不将完成报文编码等同实机支持。
本仓库目前未附 LICENSE,使用、修改和再分发的许可说明尚待补齐。