myCobot 280 树莓派版(myCobot 280 Pi 2023) 复刻全流程
myCobot 280 树莓派版(myCobot 280 Pi 2023) 从采购、打印、组装到装软件、标定和训练的 139 个步骤,附物料表、购买链接与官方出处。
myCobot 280 Pi 2023 单机 799 美元(大象机器人国际官方商店,2026‑10‑31,运费与适用税费、关税另计);含底座 858 美元起,加平面底座与自适应夹爪 978 美元。硬件不开源,没有物料成本
组装
- 将 280PI 放入包装
参照图片,将 280PI 手动摆放成 W 形。
- 使用 USB 音频输入输出
树莓派的 3.5mm 耳机接口不支持音频输入。要使用音频输入和输出,需要使用 USB 接口麦克风或耳机。
- 避开已占用引脚
接线或扩展硬件前,先确认所选 GPIO 未被占用。280JN 的已占用引脚包括 GPIO0、GPIO1、GPIO3 等,具体信息请查阅对应机械臂 Gitbook 材料的 GPIO 说明。
- 连接设备
将 MyCobot 和手柄连接到计算机。
- 连接并开启手柄
运行程序前,将手柄连接到 myAGVPro,并开启手柄电源。
软件与固件
- 烧录最新 atomMain 固件
使用 Atom 烧录最新版本的 atomMain。
- 创建并保存校准测试脚本
在桌面创建一个新的 Python 文件,将给出的代码复制进去并保存;文件名必须为 rasp_mycobot_test_gui.py。代码也可从文档给出的 Github 下载地址获取。
- 添加灯光板测试按钮
创建“Set Red”和“Set Green”按钮,点击后分别调用 send_color("red") 和 send_color("green"),并将两个按钮放在第 7 行。
- 添加老化测试控制
创建“start”和“stop”按钮,分别调用 start_aging_test 和 stop_aging_test,并在第 9 行显示。
- 添加电机释放按钮
创建“Relax all motors”按钮,点击后调用 release_mycobot,并将其放在第 10 行。
- 添加 PID 校准按钮
创建“Calibrate pids”按钮,点击后调用 rectify_mycobot,并将其放在第 10 行。
- 添加滚动日志窗口
创建宽度为 100、高度为 35 的日志文本框,连接垂直滚动条,并将滚动条放在文本框右侧。
- 运行图形界面
调用 self.win.mainloop() 启动并保持图形界面窗口运行。
- 启动 myCobot 测试界面
打开终端,切换到桌面目录并运行 rasp_mycobot_test_gui.py。
- 刷写 Atom 和 Transponder 固件
将 `Atom` 固件刷入顶部 Atom,将 `Transponder` 固件刷入底部 Basic。可从 myCobot Software 下载固件,或使用 myStudio 刷写。
- 通过 Pip 安装并升级
使用 Pip 安装 Python API `pymycobot` 并升级到可用版本。
- 从源代码安装 API
克隆 `pymycobot` 仓库的 develop 分支并进入 `pymycobot` 目录。可使用 Python 2、Python 3 或现代的 Pip 形式安装。
- 卸载 pymycobot
使用 pip 卸载当前目录安装的 pymycobot 包。
- 导入 MyCobot 280 接口
为 MyCobot 280 导入 MyCobot280 和 MyCobot280Socket。
- 按型号选择接口
从 v3.6.0 开始,接口按机器人型号区分;MyCobot 280 使用对应的 API 文档。
- 安装所需库
打开终端,切换到此文件夹目录,然后运行以下命令。
- 连接设备
将MyCobot和手柄连接到电脑。
- 安装所需软件包
打开终端,切换到该文件夹,运行requirements.txt中列出的依赖包安装命令。
- 设置端口和波特率
编辑myCobot280_handle_control.py,将示例中的/dev/ttyAMA0和1000000改为电脑检测到的实际端口号和波特率。
- 运行手柄控制程序
运行myCobot280_handle_control.py程序。
- 下载对应的 Atom 固件
查阅 Gitbook 章节,并使用 myStudio 下载对应版本的 Atom 固件。文档建议下载最新版本。
- 使用 PI/JN 系列 GPIO
以 280JN 为例,参考文档图片中的源代码。使用其他型号时,需要更改设备串口信息。
- 选择对应的通信接口
基于微处理器的机械臂支持 Socket 通信 TCP。基于微控制器的机械臂可通过 USB 转串口进行通信。
- 克隆 pymycobot 仓库
在 myAGVPro 系统上克隆 pymycobot 仓库。
- 进入复合套件目录
进入 pymycobot 仓库中的 myAGVPro_Composite_Kit 目录。
- 安装项目依赖
在复合套件目录中安装 requirement.txt 列出的依赖。
- 运行 myCobot 测试工具
运行 rasp_mycobot_test_gui.py,用该测试工具校准机械臂并检测连接。
- 初始化 40PIN GPIO 输出
在树莓派上导入 RPi.GPIO,使用 BCM 模式,并将 GPIO 20 和 GPIO 21 配置为输出。
- 创建教学测试类
创建 TeachingTest 并传入 mycobot 实例;初始化时读取终端尺寸、设置机器人引用和 record.txt 路径。
- 运行拖拽示教脚本
使用 CTRL+ALT+t 快捷键打开终端,进入 Desktop 目录并运行 drag_trial_teaching.py。
- 烧录最新 atomMain 固件
先让 Atom 烧录最新版本的 atomMain 固件。
- 创建并保存 Python 测试脚本
在桌面新建一个 .py 文件,把文档中的代码复制进去并保存。
- 安装项目依赖
运行控制示例前,安装 requirement.txt 中列出的依赖。
- 运行控制程序
在项目目录中运行 main.py,启动 myArm M&C 控制示例。
- 重启树莓派蓝牙服务
在Ubuntu 20.04系统上,先重启蓝牙服务。
- 运行蓝牙服务器
运行uart_peripheral_serial.py脚本以启动蓝牙服务器。
- 安装最新固件
为 myBuddy 使用最新固件。
标定与测试
- 选择端口并连接机器人
读取所选串口和波特率,将波特率转换为整数,并使用 MyCobot(port, baud) 建立连接;缺少端口或波特率时写入提示信息,连接成功后记录“connection succeeded !”。
- 启动循环老化测试
Starts a daemon thread that runs _aging_test and records “Start cyclic aging test ...”.
- 停止老化测试并清理文件
停止 aging_test.service,删除 aging_test.sh、aging_test.py 和 systemd 服务文件,然后重新加载 systemd。成功或失败时写入日志。
- 整定各舵机的 PID 数据
连接 myCobot 后,对 1 至 6 号舵机将寄存器 24 设为 0、寄存器 26 和 27 设为 3,每次操作间隔 0.1 秒。随后读取三个寄存器的值并写入日志。
- 检查 myCobot 连接状态
Checks whether a myCobot object exists; when disconnected it records “Mycobot is not connected yet!!!” and returns False, otherwise it returns True.
- 运行舵机老化动作序列
先将 LED 设为红色,再让六个关节依次移动到零位、170°、-170°、零位、90°、-90°和零位。动作速度均设置为 95,等待时间依次为 5、3、3、3、3、3 和 3 秒。
- 执行第一组高速关节校准
按顺序执行前五条角度指令,速度参数为95。每条指令使用wait(3)并发送指定的六轴角度数组。
- 继续第五和第六轴校准
继续执行速度为95的五条角度指令。角度序列包括回到零位、第五轴正负165度以及第六轴180度。
- 切换至中速绿色校准
先将第六轴移动至-180度,然后设置绿色灯光。接下来的角度指令使用速度55,并开始第一轴的正负170度运动。
- 校准第一和第二轴
在速度55下依次执行回到零位、第一轴正负170度、第二轴正负90度和再次归零。
- 校准第三和第四轴
继续以速度55执行第二轴归零、第三轴正负140度、归零及第四轴正负130度等动作。
- 校准第四第五和第六轴
以速度55执行第四轴正负130度、归零、第五轴正负165度、归零和第六轴180度。
- 切换至蓝色低速校准
完成第五轴正负165度后归零,并将第六轴移动至180度。接着设置蓝色灯光,以速度15开始归零和第一轴170度运动。
- 低速校准第一和第二轴
以速度15执行第一轴正负170度、归零、第二轴正负90度及再次归零。
- 低速校准第三和第四轴
继续以速度15执行归零、第三轴正负140度、归零、第四轴130度和第四轴-110度。
- 连接机器人并选择波特率
选择对应波特率并点击 Connect;myCobot 280-Pi 使用 1000000,myCobot 320-Pi 使用 115200。
- 执行机械臂零位校准
手动将机械臂的每个关节移动到零位,然后点击 Start Calibration;界面出现 Calibration End 即表示校准完成。
- 修改端口号
编辑 myCobot280_handle_control.py 文件,将示例中的端口号和速率改为计算机检测到的值。
- 按住 Left 1 初始化关节零点
按住 **Left 1** 2 秒,将机器人初始化到关节零点状态。
- 按住 Right 1 移动到初始点
按住 **Right 1** 2 秒,机器人初始化并移动到初始点。
- 先到达初始点位
程序运行后,首先点击Right 1按钮;机器到达初始点位后,才能进行其他操作。
- 初始化到关节零位
长按Left 1按钮2秒,将机器人初始化到关节零位状态。
- 停止力矩并放松关节
长按Left 2按钮2秒,机器人停止力矩输出并放松所有关节。
- 初始化到移动初始点
长按Right 1按钮2秒,将机器人初始化到移动初始点位。
- 打开力矩并锁定关节
长按Right 2按钮2秒,机器人打开力矩输出并锁定所有关节。
- 调整 PID 以优化关节
按照文档提供的链接调整 PID,以处理关节抖动、关节角度偏差过大或关节无力问题。
- 将机械臂校准到零点
按照 Gitbook 第 5 章或文档提供的校准链接,将机械臂校准到零点位置。
- 手动检查关节间隙
对于使用超过 3 个月的机器,按照文档提供的视频手动弯曲关节,检查是否存在关节间隙。
- 识别关节零点标记
关节与关节外壳边缘之间设计有拱形凹槽,该凹槽就是关节零点。
- 确认校准后的零点姿态
校准后,机械臂应处于文档图片所示的一般零点姿态。
- 确认 270 关节零点姿态
特别注意按照文档图片所示确认 270 关节的零点姿态。
- 执行零点位置校准
按照 Gitbook 第 5 章或文档提供的链接执行零点位置校准。
- 配置 MyCobot Pro630 网络
选择 MyCobotPro630 时使用 TCP 协议,无需配置串口;设置 COMPOSITE_KIT_HOST 为机器人 IP 地址、COMPOSITE_KIT_PORT 为端口号,默认端口为 5001。机器人应与 MyAGVPro 位于同一局域网,并可通过内置软件 roboflow 查看 IP 地址和端口号。
- 注意 MyArmM750 吸盘限制
myArmM750 机器人臂不支持吸盘,使用时程序会给出提示。
- 运行连接检测工具
文件命名为 myCobot_test_demo_CN.py,运行后可在界面选择串口(默认第二项波特率 115200)、点击 connect 连接,用 Start detection 检测各关节连接,并可测试 Atom Light Board 的红灯、绿灯和查看日志输出。
- 按顺序打开串口
先打开 myArmM 的串口连接,再打开 myArmC 的串口连接。
- 查看演示测试文件
查看 demo 目录中的测试用例文件,并确认 pymycobot 提供的接口。
采数据与训练
- 启动关节运动录制
调用 record() 会清空 record_list、设置录制状态并释放舵机,然后启动后台记录线程。MyCobot320 使用 release_all_servos(1),其他型号使用 release_all_servos()。
- 采集编码器与舵机速度
记录线程读取各关节编码器和舵机速度,并测量采样间隔;每个有效样本以 angles、speeds、interval_time 的形式加入 record_list。
- 停止录制并恢复舵机
调用 stop_record() 会停止录制并等待记录线程结束;非 MyArm 机器人随后调用 focus_all_servos(),MyArm 则调用 power_on()。
- 回放录制的关节轨迹
调用 play() 会按记录顺序读取编码器、速度和间隔,用 set_encoders_drag() 设置关节位置。第一段记录后等待 3 秒,其余记录按各自间隔回放。
用起来
- 运行控制程序
运行 myCobot280_handle_control.py 程序。
- 先点击 Right 1
程序运行后,必须先点击 **Right 1** 按钮。只有机器到达初始点后,才能执行其他操作。
- 按钮 1 增加 RX 坐标
按 **1**,RX 方向的坐标值增加。
- 按钮 2 减少 RX 坐标
按 **2**,RX 方向的坐标值减少。
- 按钮 3 增加 RY 坐标
按 **3**,RY 方向的坐标值增加。
- 按钮 4 减少 RY 坐标
按 **4**,RY 方向的坐标值减少。
- 按钮 5 增加 X 坐标
按 **5**,X 方向的坐标值增加。
- 按钮 6 减少 X 坐标
按 **6**,X 方向的坐标值减少。
- 按钮 7 减少 Y 坐标
按 **7**,Y 方向的坐标值减少。
- 按钮 8 增加 Y 坐标
按 **8**,Y 方向的坐标值增加。
- 按钮 9 减少 Z 坐标
按 **9**,Z 方向的坐标值减少。
- 按钮 10 增加 Z 坐标
按 **10**,Z 方向的坐标值增加。
- 按钮 11 减少 RZ 坐标
按 **11**,RZ 方向的坐标值减少。
- 按钮 12 增加 RZ 坐标
按 **12**,RZ 方向的坐标值增加。
- 按钮 13 唤醒手柄
连接后长时间不使用手柄时,手柄会进入睡眠模式。按 **13** 唤醒手柄。
- 按钮 14 检查连接状态
按 **14** 检查机器连接状态。Atom LED 闪烁绿色三次表示机器正常,闪烁红色三次表示状态异常。
- 按 X 打开夹爪
按 **X** 打开夹爪。
- 按 Y 关闭夹爪
按 **Y** 关闭夹爪。
- 按 A 开启吸泵
按 **A** 开启吸泵。
- 按 B 关闭吸泵
按 **B** 关闭吸泵。
- 按住 Left 2 放松关节
按住 **Left 2** 2 秒,机器人停止输出扭矩并放松所有关节。
- 按住 Right 2 锁定关节
按住 **Right 2** 2 秒,机器人开启扭矩输出并锁定所有关节。
- 增加RX方向坐标
点击手柄的1按钮,RX方向坐标值增加。
- 减小RX方向坐标
点击手柄的2按钮,RX方向坐标值减小。
- 增大RY方向坐标
点击手柄的3按钮,RY方向坐标值增大。
- 减小RY方向坐标
点击手柄的4按钮,RY方向坐标值减小。
- 增加X方向坐标
点击手柄的5按钮,X方向坐标值增加。
- 减小X方向坐标
点击手柄的6按钮,X方向坐标值减小。
- 减小Y方向坐标
点击手柄的7按钮,Y方向坐标值减小。
- 增加Y方向坐标
点击手柄的8按钮,Y方向坐标值增加。
- 减小Z方向坐标
点击手柄的9按钮,Z方向坐标值减小。
- 增大Z方向坐标
点击手柄的10按钮,Z方向坐标值增大。
- 减小RZ方向坐标
点击手柄的11按钮,RZ方向坐标值减小。
- 增加RZ方向坐标
点击手柄的12按钮,RZ方向坐标值增加。
- 张开夹爪
点击X按钮,夹爪张开。
- 关闭夹爪
点击Y按钮,夹爪关闭。
- 打开吸泵
点击A按钮,打开吸泵。
- 关闭吸泵
点击B按钮,关闭吸泵。
- 唤醒休眠手柄
手柄连接后长时间不使用会进入休眠,按下13键可以唤醒手柄。
- 检查机器连接状态
按下14键检测机器连接状态;atom LED闪烁绿灯三次表示机器正常,闪烁红灯三次表示状态异常。
常见问题
物料
- 整机出厂装配:6 个伺服电机关节(型号未写),J1 ±168°、J6 ±180°
- 树莓派 4B(BCM2711 四核 1.5 GHz,2GB 内存),Ubuntu Mate 20.04,Wi‑Fi 与蓝牙
- 底座:2 个 USB 3.0、2 个 USB 2.0、2 个 micro‑HDMI、网口、音频口、SD 卡槽与 GPIO 接口;12V 5A DC 供电
- 末端:Atom 模块(5×5 RGB 点阵与按键)、Grove、Type‑C 与夹爪舵机接口;基座兼容乐高孔与 M4 螺丝,末端兼容乐高孔与螺纹孔
- 选配:平面或 G 型底座、自适应/平行/柔性夹爪、吸泵、摄像头法兰、手柄、AI Kit 2023
工具
- 出厂已装配;用平面底座(吸附)或 G 型底座(夹在桌边)固定,或经基座 M4 螺丝孔安装
- 独立使用需显示器、键盘与鼠标
技能
- myBlockly 图形化编程(入门)
- Python(pymycobot:关节、坐标、夹爪与 IO 控制)
- ROS1/ROS2 与 RViz、MoveIt 仿真
软件
- pymycobot(MIT,v4.0.7 于 2026‑09‑05 发布)
- mycobot_ros(BSD‑3)与 mycobot_ros2 中的 mycobot_280pi 等包
- myStudio(固件烧录与教程)、myBlockly、RoboFlow;商店页另列 Mind+