# SDK 接口 ## 扩展 CAN ~~~python 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 的独占文件锁只能协调遵守同一锁的程序,不能阻止其他主机或不使用该锁的程序竞争总线。