正在连接信源…

RoboArm 复刻全流程

RoboArm 从采购、打印、组装到装软件、标定和训练的 58 个步骤,附物料表、购买链接与官方出处。

RoboArm 是一个开源三轴机械臂,使用三个步进电机和两个舵机。仓库提供 SolidWorks 零件与装配体、STEP 文件、硬件清单、接线与安装说明、Arduino UNO 固件以及 PySide6 桌面控制软件。

采购

  • 克隆项目仓库

    克隆仓库并进入 roboArm 目录进行本地安装。

  • 无需向 Arduino 复制验证工具

    所有源码都在项目目录中。.venv 是本机依赖环境;.tools 如果存在,是验证用工具或构建缓存,不需要烧录或复制到 Arduino。

  • 下载完整 CAD 目录

    下载整个 roboArm Model 目录,并保持所有文件名和相对路径不变,以免破坏装配体引用。

组装

  • 安装 Shield 和 A4988 驱动器

    将 CNC Shield V3 装到 UNO,并在 X、Y、Z 每个驱动器槽各安装一块 A4988。依据模块和 Shield 上的标识核对 EN、STEP、DIR、VMOT、GND,不要仅凭电位器朝向判断,因为模块布局可能不同。

  • 连接并识别三个电机

    将三个电机分别接到 X/Y/Z 电机接口。用万用表找出两组线圈,同一线圈的两根线接到同一输出对,不要只依赖线色;未安装的轴不要发送运动命令。

  • 连接独立电机电源

    Shield 的电机电源端子连接独立直流电源,例如按板卡规格使用 12V,并确认极性和电流能力。USB 只为控制逻辑供电,不能替代电机电源;整个 Shield 应按实际板卡额定值使用,不能直接套用 A4988 的 VMOT 范围。

  • 配置全步测试模式

    断电后移除对应轴槽下的三个细分跳线以使用全步模式,200 步/圈电机发出约 200 个脉冲可转一圈。三个跳线全装时通常为 1/16 细分,即每圈 3200 个脉冲;各轴独立配置,因为软件不会自动识别电机步距角或细分设置。

  • 检查 Shield 电源信号

    确认 Shield 的 RESET/SLEEP 正常拉高、电源共地,并确认 VMOT 附近具有足够的电源滤波。如果板上电容不足,按驱动器厂商说明补充,并核对耐压和极性。

  • 了解三轴共用使能方式

    D8 ENABLE 由三轴共用,任意一轴运行时三块驱动器都会使能。停止或完成某一轴只停止该轴 STEP,其余轴继续运行;全部轴空闲后统一释放保持力。

  • 连接 D12/D13 舵机

    将两个舵机的信号线分别连接到 UNO 的 D12 和 D13。电源应按各舵机型号的额定电压和电流配置,使用容量足够的独立稳压电源,并将电源 GND 与 UNO GND 共地。不要把舵机电源接到信号引脚或直接接 Shield 的电机高压电源,也不要将外部电源与 UNO 5V 输出直接并联。

  • 使用 SolidWorks 打开原生文件

    使用兼容 SolidWorks 2025 的版本打开原生文件;其他版本尚未验证,文档也未确认两个编号装配体中哪一个是最终整机版本。

  • 在本地解析装配体引用

    打开装配体时,让 SolidWorks 在本目录中查找引用文件;如果出现缺件提示,请在本目录中重新定位被引用的文件。

  • 缺件时停止使用装配体

    不要忽略报错,也不要在全部引用文件齐备前将该装配体视为完整整机使用。

  • 修复完整的 STEP 导出

    在 SolidWorks 中检查完整装配,然后重新导出包含全部几何的 STEP,或补齐所有外部引用的 STEP 文件;缺失引用包括文档所列的传动齿轮、机械臂、夹爪、底座、轴承外圈、连接件和连杆文件。

软件与固件

  • 安装依赖并启动上位机

    创建 .venv 环境,安装 requirements.txt,并运行 main.py。D:\roboArm 只是 Windows 路径示例,可以替换为克隆目录。

  • 使用 Arduino 官方 Servo 库

    D12、D13 两个 0~180°位置舵机使用 Arduino 官方 Servo 库。下位机为 Arduino UNO。

  • 必要时烧录协议 v3 固件

    如果开发板仍使用先前的长按限速版协议 v4,需要烧录项目中的协议 v3 固件。已经使用协议 v3 时无需重新烧录;关闭旧上位机窗口并重启 start.bat。

  • 安装 Arduino IDE

    安装 Arduino IDE,并通过 USB 连接 UNO。

  • 打开固件项目

    在 IDE 中打开 D:\roboArm\arduino\roboarm_x\roboarm_x.ino,并保持文件名与 roboarm_x 文件夹同名。

  • 配置开发板和库
  • 验证并上传固件

    关闭本项目控制软件以及所有占用串口的程序。点击“验证”,通过后点击“上传”。此固件会替换板上原有程序。

  • 安装 Python 依赖

    在 64 位 Windows 10/11 上安装 64 位 Python 3.10~3.13,建议使用 3.12,并在安装时勾选加入 PATH。创建虚拟环境并安装依赖,无需激活;已有可用 `.venv` 时可跳过创建,若 `python` 打开 Microsoft Store,可改用 `py -3.12`。

  • 启动控制软件

    进入项目目录后使用虚拟环境运行 `main.py`,或双击 `start.bat`。启动后不会自动连接或自动运行,没有插入 Arduino 也可以打开界面。

  • 实现串口运动调度器

    使用固定长度接收缓冲、固定长度发送队列和 `micros()` 调度实现协议;唯一等待是 3µs 的 STEP 高脉冲,因此 STOP 无需等待整段运动结束。发送队列满时可能丢弃反馈行,但运动和 STOP 仍会执行,后续 STATUS 可恢复当前状态。

  • 运行模拟串口单元测试

    使用项目虚拟环境运行 unittest 测试套件。测试使用模拟串口,不打开 COM7,也不驱动电机。

  • 扩展 A 轴接口

    以后扩展 A 轴时,先明确实际 Shield 跳线和引脚映射,再更新握手能力、状态反馈和测试。固件使用 Axis 注册表,Python 使用 AXES 以及带轴名的命令和反馈。

标定与测试

  • 设置 A4988 限流

    按电机额定相电流、模块散热能力和实际采样电阻设置 A4988 限流,使用 I_limit = VREF / (8 × R_sense)。克隆模块的采样电阻可能不同,不能套用固定 VREF;先配置散热片或风冷,初测时低速、空载运行。

  • 进行安全的空载首次测试

    全部停止、断开或超时停止后,电机将失去保持力。首次测试必须使用无悬挂负载的条件,尤其是 Z 轴。

  • 注意停止方式与反馈限制

    GUI 软件停止依赖 USB 传输,不是独立的硬件急停。步数表示发出的脉冲数;由于没有编码器反馈,系统无法判断失步、堵转或真实位置。

  • 选择位置型舵机

    使用 0~180°位置舵机。连续旋转舵机不适用于本角度控制;在本程序中,D12/D13 专用于舵机。

  • 设置舵机初始位置

    UNO 上电、复位或上传固件后,两个舵机都会写入 90°。打开 USB 串口通常也会触发 UNO 复位,因此重新连接时可能回到 90°。仅打开 GUI 窗口不会发送运动命令。

  • 理解舵机角度数值

    滑块旁的角度是用户目标,“设备设定”是 Arduino 已确认写入的角度,不是真实角度传感器反馈。项目使用 Servo 库默认的脉宽映射,因此应按舵机型号校准实际角度和机械端点,并先从 90°附近进行小幅验证。

  • 检查串口协议

    可选地将串口监视器设置为 115200 和“新行”或“NL 和 CR”。应看到 READY protocol=3 axes=X,Y,Z servos=D12,D13,以及轮流的步进/舵机状态。发送 STATUS 和 SERVO_STATUS 进行检查;监视器不要与 GUI 同时连接。

  • 连接并选择串口

    确认接线和限流后上电,点击“刷新串口”,选择 COM7 或设备管理器中的实际端口,再点击“连接”。也可以手工输入 COM 名称。

  • 确认连接状态与通信日志

    等待连接状态显示“已连接”,日志应出现 TX `STOP ALL`、`STATUS`、`SERVO_STATUS`,以及 RX `OK STOP_ALL`、三轴停止状态和 D12/D13 舵机角度。旧版固件需要重新烧录。

  • 逐轴测试正转

    在 X 轴控制区设置 200 步、200 脉冲/秒并点击“正转”,应约一秒完成,显示 DONE、已发出 200、剩余 0;200 步/圈电机在全步模式下约转一圈。随后在 Y、Z 控制区重复测试,先逐轴验证,再并行运行。

  • 测试反转和方向选择

    点击“反转”,确认轴以相同步数向相反方向转动。也可以先从方向下拉框选择方向,再点击“运行”;这些按钮执行的都是有限步数运动,不是无限连续转动。

  • 测试较大步数与速度

    将设置改为 400 步,测试约两圈。默认电机为 200 整步/圈,圈数等于脉冲数除以 200 与细分倍率的乘积;全步模式下 500 脉冲/秒约为 150 RPM。

  • 测试停止与轴独立性

    在 X 轴设置 10000 步、200 脉冲/秒并启动,运行中点击“停止 X 轴”。应迅速停止并显示 STOPPED,已发出与剩余之和等于总步数;再次运行会创建新任务而不会续跑旧任务,运行中的轴会暂时禁用新运行命令,其他空闲轴仍可操作。

  • 测试多轴并行任务

    先运行 Y 轴长任务,再运行 Z 轴长任务,也可以加入 X 轴任务。每个控制区显示本轴状态、方向、已发出与剩余脉冲、设备设定速度和进度;停止 Y 轴时其他运行轴继续运行,“停止全部步进”会停止三轴。

  • 测试 USB 异常断线

    在无负载测试条件下启动长任务并拔掉 USB;若 Arduino 仍有供电,应在最后有效心跳约 1.5 秒后停止,若断电则立即失去驱动。重新连接只读取状态,不会自动恢复运动。

  • 逐步提高速度

    低速运动正常后再逐渐提高速度。此最小版本没有加减速曲线,直接以高速度起步可能失步;2000 是软件上限,不保证所有电机都能可靠达到。

  • 验证舵机角度与映射

    先将舵机从 90°小幅拖到 80°、100°,分别验证 D12/D13 映射和方向,再在实际机械范围内检查更大角度。日志应出现 `SERVO D12 100` 和 `OK SERVO D12 angle=100`,另一舵机保持原值;GUI 角度范围为 0~180°。

  • 验证舵机与步进并行

    运行低速步进任务时拖动舵机,检查两者是否都正常。“停止全部步进”和断开后,舵机应维持最后目标;重新连接时若 UNO 发生复位,两个舵机应回到 90°。

  • 配置 v3 串口协议

    将串口接口配置为使用大写 ASCII 命令和 LF 换行;也可接受 CRLF,每行不含换行的长度不得超过 79 个字符。步数使用 −1000000~1000000 的非零整数,速度使用 1~2000 STEP 脉冲/秒的正整数。

  • 测试各轴独立运动

    发送包含轴、带符号步数和速度的 MOVE 命令;正步数向正方向运动,负步数向反方向运动。命令被接受后返回对应轴的 `OK ...` 和 `RUNNING ...`,各轴独立运行,不保证同时起步或同步完成。

  • 停止单轴或全部轴

    发送 STOP 可结束指定轴的任务并保留已有计数,响应包含 `reason=USER`,空闲轴也可执行该命令。使用 STOP ALL 时先停止全部三轴,然后返回 `OK STOP_ALL`。

  • 查询轴与舵机状态

    使用 STATUS 查询三个步进轴,或使用 STATUS X、STATUS Y、STATUS Z 查询指定轴。在正常通信负载下,系统约每 80ms 在三轴和两个舵机之间轮流反馈,每个设备约每 400ms 更新一次。

  • 设置两个舵机角度

    发送 SERVO D12 或 SERVO D13,并在后面指定 0~180 的整数角度。控制器返回已设定反馈,例如 `OK SERVO D12 angle=90`,也可能返回 ANGLE_RANGE、BAD_NUMBER 或 SERVO_UNSUPPORTED 错误。

  • 读取舵机设定角度

    使用 SERVO_STATUS 查询两个舵机的设定,或使用 SERVO_STATUS D12 和 SERVO_STATUS D13 查询指定舵机。响应包含所查询的角度,而普通 STATUS 只查询步进轴。

  • 保持通信心跳

    发送 PING 可收到 `OK PING`;GUI 每约 300ms 自动发送并隐藏心跳日志。手动测试长运动时,必须至少每 1.5 秒发送一次有效的 PING 或 STATUS。

  • 验证链路超时行为

    运动中若超过 1500ms 未收到有效的 PING、STATUS、SERVO_STATUS、STOP、被接受的 MOVE 或 SERVO,所有正在运行的步进轴会自动停止并返回 `reason=LINK_TIMEOUT`。舵机保持最后的目标角度。

  • 处理忙碌与非法命令

    某轴运动期间再次向该轴发送 MOVE,会返回包含 `code=BUSY` 和轴名的错误,但其他空闲轴仍可开始运行。STOP 不会清零已有计数,非法命令不会启动电机,也不会改变原任务。

  • 执行真机烧录与验收

    将固件烧录到真实硬件,并按照第五节的验收流程检查运行结果。

用起来

  • 控制两条独立滑块

    两条滑块相互独立,拖动滑块会立即发送目标角度,并按 80ms 限频。松开滑块时立即提交最终值。可以点击滑轨,并使用方向键微调;新值会替换同一舵机尚未发送的旧角度。

  • 与步进轴并行控制舵机

    舵机控制不会等待舵机转动完成,仍可同时控制三轴步进。Servo 库使用定时器中断,会影响 UNO 的 D9/D10 analogWrite PWM;本项目步进使用 D2~D7 普通数字输出。并行运行时的实际步进抖动和负载表现需要实测。

  • 理解 STOP ALL 行为

    “停止全部步进”/STOP ALL 只停止 X/Y/Z,并丢弃尚未发送的舵机目标。UNO 仍供电时,舵机会继续输出最后接受的目标角度,不会自动回中或断力。断开或通信超时也会让舵机保持最后目标;UNO 再次复位时恢复 90°。

  • 上传后启动 GUI

    上传完成后关闭串口监视器,再启动 GUI。打开串口会让 UNO 复位;GUI 自动等待约两秒,并执行 STOP ALL、STATUS 和 SERVO_STATUS 握手。只有收到全停确认、三轴停止状态和两个舵机状态后,才会开放控制。

文档