1.8 KiB
1.8 KiB
SDK 接口
扩展 CAN
from a7_can_sdk import MotorBus
from a7_can_sdk.transport import SocketCan
from a7_can_sdk.configuration import load
cfg = load('config/left.json')
# 构造 SocketCan 会打开接口;以下示例只发送读取请求。
bus = MotorBus(SocketCan(cfg['interface'], cfg['bitrate']), cfg['motors'], allow_control=False)
try:
bus.start()
for motor in cfg['motors']:
mid = motor['motor_id']
uid = bus.identify(mid)
position_rad = bus.read_parameter(mid, 'position')
finally:
bus.close()
主要接口:
- identify(id):查询并核对配置中的 UID。
- read_parameter(id, name):按参数类型读回,未支持或超时明确报错。
- get_state(id):返回已有反馈及时间戳;未知物理速度/力矩保留 None。
- enable(...):仅 allow_control=True 时可调用,先执行原静止/身份/模式/目标预置等核对,再使能。
- set_positions({id: radians}):模式5位置目标,完整检查后再发送。
- disable():请求停止/掉使能,返回确认结果;没有确认不得当成已停。
- close():结束线程并关闭传输;控制会话会按原拥有的电机及停止规则处理,不能把它当成保持使能命令。
- set_torque / set_impedance:未完成 commissioning,抛出 NotCommissionedError。
Runtime 是与 ROS 无关的适配层,接受上层提供的 spline 和关节边界;它不是 MoveJ 控制器,也不是完整避障规划器。StartupEnable 只有显式 requested=True 且模式合适才会进入一次使能流程,不会故障重试。
反馈时间是主机接收时间。配置限位/应用速度上限不等同独立测得的机械硬限位或额定能力。SocketCan 的独占文件锁只能协调遵守同一锁的程序,不能阻止其他主机或不使用该锁的程序竞争总线。