跳到主要内容

注意事项

使用前检查电池、接线和活动部件,按本页说明完成首次上电、首次运动和异常处理。

机器人会突然移动

Web 控制、Jupyter Notebook、ROS2 键盘或手柄、视觉跟随都可能使轮子立即转动,机械臂也可能突然动作。

首次测试前请确认:

  • 周围空旷,并清理可能卷入轮子或缠住机械臂的线缆、工具;
  • 同一时间只运行一种控制程序,不要让网页、Notebook 和 ROS2 同时发运动指令;
  • 第一次运动测试必须架空轮子,不要用手托着车上电;
  • 确认底盘电源开关的位置,保证异常时能够立即断电;
  • 手、衣物和头发远离轮子、减速箱和机械臂。

上电前检查​

  1. 确保底盘电源关闭且充电器断开。电机、舵机、电源和串口线不得带电插拔。
  2. 按 产品组装 安装或复核电池与 UPS:
    • 对照电池座 / UPS 仓内 +、- 丝印,确认 3 节 18650 方向正确;
    • 确认反接提示灯未亮;灯亮或无法确认极性时,立即取出电池重新检查;
    • 确认电池方向正确且反接提示灯未亮后,按组装页的步骤完成 UPS 首次激活;
    • 不得在极性错误时开机或充电。
  3. 检查轮子、减速箱和机械臂,清除包装材料、扎带和可能卷入转动部件的线缆。
  4. 确认机械臂已通过扩展组件固定到底盘并完成接线。检查树莓派、散热器、ESP32 驱动板、USB 摄像头是否固定牢靠,接口是否完全插入。
  5. 将车体稳定架空,确保四个驱动轮均能自由转动。支撑位置应避开轮子、线缆和活动部件,并能承受机械臂姿态变化造成的重心移动。不要用手托着车上电测试。不要用手转动轮子,以免损坏减速箱。

Acce 版本首次准备​

Acce 不含树莓派。自行准备对应的树莓派 4B 或树莓派 5,写入产品镜像后再按 产品组装 装到车上。

先确认系统,再刷写

随附树莓派的套件通常已预装产品环境,不要重复刷机。Acce、更换过树莓派或 TF 卡时,再按 树莓派镜像写入 准备系统。刷机可能覆盖数据,操作前备份 Notebook 和修改过的源码。

首次上电与首次运动​

  1. 保持轮子架空,开启底盘电源,等待树莓派和 ESP32 完成启动。
  2. 观察 OLED 和风扇。出现异味、异常发热、冒烟、异常响声或反复重启时,立即关闭底盘电源并断开充电器。
  3. 第一次进入控制页后,先确认视频和状态信息能够更新,不要立即推动摇杆或发送运动命令。详见 控制配置检查。
  4. 使用入门教程中的 Web 方向控制进行首次测试。确认能够释放方向控制,并能够在异常时立即关闭底盘电源。无法执行这两项时,不要开始运动测试。
  5. 在 Web 中选择最低速度,短时操作前进、后退和左右转向。每次只测试一个方向,释放方向控制后确认轮子停止。其他控制方式应执行其规定的停止操作;ROS2 锁存式键盘遥控不能依靠松键停止。
  6. 方向错误、无法停止、单侧不转或速度明显异常时,立即停止并关闭电源。排除故障前不要落地运行。
  7. 基础方向和停止通过后,再放到平整、开阔的地面。第一次落地不要同时运行巡线、视觉跟随或 ROS2。

控制程序与设备占用​

Web 后端、自定义串口程序和 ROS2 实体驱动不应同时访问同一底盘串口。即使程序都能启动,也可能发生指令竞争或反馈读取冲突。切换控制方式前,应先停止原控制程序,并确认串口已释放。关闭浏览器页面不会停止 Web 后端,也不能证明串口或相机已经释放。

JupyterLab 是运行程序的入口。Notebook 是否占用串口或相机,取决于其中正在执行的代码。访问同一相机的程序应避免资源冲突。

Ctrl+C 用于中断当前终端中的前台程序。关闭页面、中断 Notebook 或退出程序,不能代替实体运动停止确认。退出控制程序前,应先执行对应的停止操作,并观察底盘和机械臂是否已经静止。

不要使用 killall python 或 pkill python 批量结束 Python 进程。这些命令可能同时终止 Web、JupyterLab 和其他应用。

充电安全​

使用套件配套的充电器

套件配备 12.6 V 2 A 充电器。不要仅根据插头外形或标称电压选择替代充电器。充电器丢失或损坏时,确认替代型号与本产品兼容后再充电。

首次安装或重新安装电池后,UPS 可能暂时没有输出。激活步骤见 产品组装。

UPS 支持边充电边供电,充电时可以开机。

  1. 充电前停止运动,把车放在干燥、通风且稳定的位置。不要覆盖充电器或散热部件。
  2. 检查 3 节电池的方向和外观。反接提示灯亮起,或电池外皮破损、漏液、异常发热或进水时,不得充电。
  3. 充电开始后的几分钟内检查电池和充电器。出现异味、冒烟、异常响声或温度快速升高时,在确保人员安全的前提下断开外部电源。
  4. 建议在底盘运动前断开充电器,避免车辆移动拉扯充电线。不要在无人看管时充电。

正常关机​

确认底盘和机械臂停止后,保存数据,再关闭底盘电源。具体步骤见 系统启动。

停止指令无效时,立即关闭底盘电源。不要进入机械臂运动范围或为支撑机械臂而延误断电。

机械臂​

  • 通电后不要拆解机械臂。关节较多,拆开后不易还原。
  • 车上机械臂由底盘 3S UPS 供电(9~12.6 V)。
  • 运动范围内不要对着头部、眼部等部位。
  • 通电后不要用手掰关节。关节卡滞时停止操作,不要反复发送目标或用手强行推动;无法停止或状态不明时,按下方异常处理步骤断电。
  • 堵转会使舵机电流和发热增加。断电后检查车体干涉、缠绕线缆和夹持物,排除阻挡前不要重新运动。
  • 长时间运行后舵机可能发热,停止使用并冷却后再接触。出现异常发热、异味或持续异常声音时,不要继续运行。
  • 堵转扭矩不是整臂可抓取重量,也不能据此换算安全负载。不要通过持续堵转或逐步增加夹持物来测试负载极限。
  • 机械臂失电后可能下垂。正常断电前,如果当前姿态可能在失电后下落,可以在机械臂静止且自动任务停止后放置稳定的外部支撑。
  • Ahead 或键盘 0 会发送机械臂折叠和夹爪闭合目标。确认夹爪没有夹持物、周围留出空间后再发送,不要将其作为停止操作。
  • 底盘最大速度档位不控制机械臂速度。首次操作机械臂时使用小幅、短时输入,并清空运动范围;不要将指令中的 spd=0 理解为停止或低速。
  • 远离儿童,避免碰撞。

遇到异常时如何处理​

  1. 执行当前控制方式提供的停止操作,并观察底盘和机械臂是否停止。不要仅根据页面关闭、程序退出或终端返回判断实体已停止。
  2. 运动未停止、控制失去响应或无法确认状态时,立即关闭底盘电源。不要用手阻挡轮子或进入机械臂运动范围。
  3. 记录异常发生前的操作、终端命令、OLED 信息、指示灯状态和发生时间。
  4. 断电后检查电池与接线。如果程序提示串口被占用,或切换控制方式后无法打开串口,复测前检查是否还有其他程序占用串口。
  5. 每次只改变一个条件,并在轮子架空、低速和短时运行的条件下复测。异常重复出现时停止测试,记录出现异常时的操作、设备状态和报错。

产品不防水,不能承受强烈撞击。不要在雨天、潮湿、高温环境使用。不要在桌面边缘、楼梯口、斜坡或湿滑地面上测试运动。

开始使用前确认​

进入入门教程前,完成电池、接线、安装固定和紧急断电位置检查:

  • 3 节电池安装方向正确,外观和温度正常,UPS 已完成首次激活;
  • 线缆固定可靠,不会接触轮子或机械臂;
  • 上位机、下位机固定可靠,启动时没有异常状态;
  • 已掌握正常关机和紧急断电位置;
  • 当前只运行一个底盘控制程序,同一相机只由一个程序占用。

完成本页检查后,再进入 入门教程。