OpenBot(手机驱动的开源小车) 复刻全流程
OpenBot(手机驱动的开源小车) 从采购、打印、组装到装软件、标定和训练的 687 个步骤,附物料表、购买链接与官方出处。
README 称车体约 50 美元(手机自备),BOM 只给亚马逊与速卖通链接、无总价。RTR‑520 亚马逊美国站四台装 2026‑10‑31 显示缺货、无报价;RTR‑TT 链接跳转淘宝,未核对
采购
- 选择 Arduino 机器人小车套件
使用基础机器人小车套件作为起点;套件包含底盘、电机和配件。
- 获取手机支架
购买手机支架,用于将控制手机固定在机器人上。
- 获取所需组件
获取“Required components”下列出的全部组件;文档提供了德国、美国和 AliExpress 的购买链接。
- 购买一个 Arduino Nano
购买 1 个 Arduino Nano。
- 购买四个带轮胎的 TT 电机
购买 4 个带轮胎的 TT 电机。
- 购买三个 18650 电池
购买 3 个 18650 电池。
- 购买一个 18650 电池盒
购买 1 个 18650 电池盒。
- 购买一根 USB OTG 数据线
购买 1 根 USB OTG 数据线。
- 购买弹簧或橡皮筋
购买 1 个弹簧或橡皮筋。
- 购买十六个 M3x25 螺钉
购买 16 个 M3x25 螺钉。
- 购买十六个 M3 螺母
购买 16 个 M3 螺母。
- 购买六个 M3x5 螺钉
购买 6 个 M3x5 螺钉。
- 购买杜邦线
获取用于 DIY 布线的杜邦线。
- 提供 USB 转 TTL 串行接口
提供 1 个 USB 转 TTL 串行接口,用于与智能手机通信。
- 提供电机 PWM 输出
提供 4 个 PWM 输出,用于控制电机。
- 提供电池监测引脚
提供 1 个模拟引脚,用于电池监测。
- 提供速度传感器引脚
提供 2 个数字引脚,用于速度计。
- 提供超声波传感器引脚
提供 1 个用于超声波传感器的数字引脚,该引脚为可选。
- 订购 RTR OpenBot 车辆
RTR OpenBot 车辆可从 openbot.info 订购,提供 RTR_TT 和 RTR_520 两种版本。
- 购买自建所需部件
自行制作 OpenBot RTR 需要打印底盘、制造 PCB,并购买电机和手机支架。
- 购买开箱即用的 OpenBot
在 Amazon 上购买 RTR-TT 或 RTR-520 开箱即用的 OpenBot。
- 选择兼容的其他 MCU
选择具有 USB-to-TTL 串口、4 个 PWM 输出、1 个电池监测模拟引脚、2 个速度传感器引脚、1 个超声波传感器引脚和 2 个指示 LED 引脚的 MCU。超声波传感器和指示 LED 为可选。
- 准备高规格训练计算机
使用高规格笔记本电脑或配备大量内存和独立 GPU 的工作站,尤其是在使用较大数据集进行训练时。
- 阅读免责声明
开始构建前阅读免责声明。
打印与加工
- 制造 OpenBot RTR 的 PCB
制造自建 OpenBot RTR 所需的 PCB。
- 打印 shell_bottom 底盘
打印 shell_bottom 底盘;文档提供 STL 和 STEP 文件。
- 打印 shell_top 外壳
打印 shell_top 外壳;文档提供 STL 和 STEP 文件。
- 打印 phone_mount 手机支架
打印 phone_mount 手机支架;文档提供 STL 和 STEP 文件。
- 选择 A 型底板
选择裸底板方案;通过外部连接器连接电机驱动板和外部微控制器板。
- 选择 B 型底板
选择模块化底板,并通过排针连接外部微控制器。
- 选择 C 型一体底板
选择完全集成的底板;文档建议大多数用户使用此方案。
- 准备 TT 电机底板
为 TT-motor 版本准备 1 个 Arduino 底板。
- 准备状态 LED 板
为 TT-motor 版本准备 1 个状态 LED 板。
- 准备碰撞传感器板
为 TT-motor 版本准备前、顶部和后部碰撞传感器板。
- 准备速度传感器板
为 TT-motor 版本准备 4 个 Arduino 速度传感器板。
- 准备 520 电机底板
为 520-motor 版本准备 1 个 ESP32 底板。
- 准备状态 LED 板
为 520-motor 版本准备 1 个状态 LED 板。
- 准备碰撞传感器板
为 520-motor 版本准备前、顶部和后部碰撞传感器板。
- 获取状态 LED 板文件
获取状态 LED 板的 gerber、BOM 和 centroid 文件。
- 获取顶部碰撞板文件
获取顶部碰撞传感器板的 gerber、BOM 和 centroid 文件。
- 获取后部碰撞板文件
获取后部碰撞传感器板的 gerber、BOM 和 centroid 文件。
- 获取 CH340G 前板文件
获取采用 CH340G USB 驱动器的前部碰撞传感器板的 gerber、BOM 和 centroid 文件。
- 获取 CP2102N 前板文件
获取采用 CP2102N USB 驱动器的前部碰撞传感器板的 gerber、BOM 和 centroid 文件。
- 制作 ESP32 DRV8870 电机驱动板
使用链接中的 Gerber、BOM 和拾取放置坐标文件制作 ESP32 DRV8870 电机驱动板。
- 打印方块机身
选择 @Christos-Ps 设计的方块机身。它有内部空间更大的变体和兼容乐高的顶部,需要 221mm x 150mm 的打印区域。
- 打印手机支架底座
使用提供的 STL 或 STEP 文件打印 phone_mount_bottom。
- 打印手机支架顶部
使用提供的 STL 或 STEP 文件打印 phone_mount_top。
- 打印倾斜式手机支架
如需将手机向上倾斜最多 30°,请打印倾斜版本,而不是 phone_mount_bottom。
- 清理打印件
继续组装前清理 3D 打印件。
组装
- 制作自定义底盘和手机支架
使用自己选择的材料制作 OpenBot 底盘和手机支架,例如木材、纸板或泡沫塑料。
- 选择 DIY 或 PCB 组装方案
选择使用 L298N 电机驱动器的 DIY 方案,该方案适合具备电子经验的爱好者;也可选择定制 PCB,以获得更整洁的组装或构建多台机器人。
- 制作 5V 和 GND 电源分配板
将 6x2 公针焊接在洞洞板上。再将电源分配板连接到电机驱动板的 5V 和 GND。
- 准备电机和编码器圆盘
给电机焊接导线。如果要使用速度传感器,请在前两个电机上安装编码器圆盘。
- 将电机连接到 L298N
将左侧两个电机分别连接到 L298N 的 OUT1(+)和 OUT2(-)。将右侧两个电机分别连接到 L298N 的 OUT4(+)和 OUT3(-)。
- 安装电机
使用八颗 M3x25 螺钉和螺母安装电机。
- 安装 L298N 驱动板
使用四颗 M3x5 螺钉安装 L298N 驱动板。
- 安装可选的超声波传感器
安装超声波传感器。将弯角连接器替换为直连接器,或小心弯折引脚。
- 安装可选的橙色指示 LED
安装用于指示信号的橙色 LED。
- 安装手机支架底座
使用两颗 M3x25 螺钉和螺母,将手机支架底部安装到顶板上。
- 完成手机支架
插入手机支架上部,并安装弹簧或橡皮筋。
- 安装速度传感器
将弯角连接器替换为直连接器,或小心弯折引脚。每个速度传感器使用一颗 M3x5 螺钉安装。
- 安装电池盒
安装电池盒,例如使用魔术贴固定。
- 插入可选的电源开关
将开关接入供电回路。将开关推入合适的开孔,直到听到咔哒声。
- 焊接电源开关
将电池盒和电源线的红色导线(12V)分别焊接到开关的两个引脚。连接黑色导线(GND),并用热缩管覆盖连接处。
- 固定电源线
使用胶带固定电缆。
- 安装 OLED 显示屏
可选地安装 OLED 显示屏。
- 连接 L298N 的 PWM 输入
将 L298N 的 PWM 输入连接到 Arduino 的 D5、D6、D9 和 D10 引脚。
- 为速度传感器和超声波传感器供电
将速度传感器和超声波传感器连接到 5V 和 GND。
- 连接速度传感器输出
将速度传感器的 D0 引脚连接到 Arduino 的 D2(左)和 D3(右)引脚。
- 连接超声波传感器信号
将超声波传感器的 Echo 和 Trigger 引脚分别连接到 Arduino 的 D11 和 D12 引脚。
- 连接指示 LED
可选地将左 LED 连接到 D4、右 LED 连接到 D7,并将两者连接到 GND。建议串联 150 欧姆电阻以限制电流。
- 连接电池电压分压器
可选地将电压分压器连接到 Arduino 的 A7 引脚,用于测量电池电压。
- 通过 I2C 连接 OLED
可选地通过 I2C 总线将 SSD1306 OLED 显示屏连接到 Arduino Nano。
- 连接 OLED 电源引脚
将显示器的 VIN 和 GND 引脚连接到 5V 和 GND。
- 连接 OLED 时钟引脚
将显示器的 SCL 引脚连接到 Arduino 的 A5 引脚。
- 连接 OLED 数据引脚
将显示器的 SDA 引脚连接到 Arduino 的 A4 引脚。
- 为 L298N 供电
将电源线连接到 L298N 的 +12V 和 GND。
- 布置 Arduino USB 线
将 USB 线连接到 Arduino,并使其穿过顶盖。
- 安装顶盖
将六个 M3 螺母插入底板,并使用六枚 M3x25 螺钉安装顶盖。
- 安装车轮
安装车轮。
- 准备电机
给电机焊接 Micro JST PH 2.0 接头线。如果要使用速度传感器,请给两个前电机添加编码器盘。
- 安装电机
使用八枚 M3x25 螺钉和螺母安装电机。
- 将电机连接到 PCB
将左侧两个电机连接到 M3 和 M4,右侧两个电机连接到 M1 和 M2。
- 安装 PCB 和电机
使用四枚 M3x5 螺钉安装 PCB,并使用八枚 M3x25 螺钉和螺母安装电机。
- 继续执行 DIY 组装步骤
按照 DIY 选项的第 5 至 12 步操作。
- 连接超声波传感器
将超声波传感器的 VCC/+、Trig、Echo 和 GND/- 引脚连接到 PCB 上标为 SONAR 的四针排针。
- 连接指示灯信号
将橙色 LED 连接到 PCB 上标为 SIGNAL_L 和 SIGNAL_R 的两针排针。较长引脚为正极,较短引脚为负极。
- 连接速度传感器
将左右速度传感器的 VCC/+、GND/- 和 D0 引脚连接到 PCB 上标为 SPEED_L 和 SPEED_R 的三针排针。
- 将 OLED 连接到 IO2
可选地将 SSD1306 OLED 显示屏连接到 PCB 的 IO2 排针。
软件与固件
- 在浏览器中配置固件
打开 tools.openbot.org/firmware,选择机器人和零件,然后使用电脑上的 Chrome 或 Edge。可直接刷写固件,或下载 Arduino IDE 设置文件。
- 手动编辑固件设置
直接配置固件时,只修改 openbot.ino 顶部的 SETTINGS 部分。其下方内容无需更改。
- 更新时保留设置
更新固件时若要保留设置,请将 SETTINGS 部分中 #else 与 #endif 之间的行复制到 openbot.ino 旁的新文件 openbot_settings.h,并在该文件中修改。若 openbot_settings.h 存在,固件会使用它而不是 openbot.ino 中的对应部分;Git 会忽略该文件,避免意外推送。
- Select the Robot Body
Set `OPENBOT` as the robot body in Arduino IDE and select a board supported by that body. The firmware detects the board and stops the build with an error on an unsupported board.
- Use the Updated DIY Body
Use `DIY` instead of `DIY_ESP32` when the selected body is an ESP32 board.
- Enable No Phone Mode
Set `NO_PHONE_MODE 1` to use No Phone mode instead of normal phone-app control.
- Enable Gamepad Control
On ESP32, set `HAS_GAMEPAD 1` to operate the robot with a gamepad.
- Configure Coast and Debug Modes
Set `COAST_MODE` to `1` for motor coasting or `0` for braking when there is no control input. Set `DEBUG 1` to display debug output in the serial monitor.
- Set the Bluetooth Name
Set `BLE_NAME` to the robot name shown in the app. The name may contain up to 20 characters, numbers, spaces, hyphens, or underscores, such as `#define BLE_NAME "Team 3"`.
- Review Component Defaults
Each component in the settings defaults to the value for the selected body, such as `#define HAS_SONAR DEFAULT_HAS_SONAR`. Review the body-specific defaults listed for the components.
- Enable or Disable Components
Override a component default with `1` to enable it or `0` to disable it.
- Disable an Uninstalled Sonar
If the sonar sensor is not installed, set `#define HAS_SONAR 0` so the app does not show meaningless readings such as 300 cm.
- Enable ESP32 Bluetooth
Bluetooth connection with the phone is also enabled on ESP32.
- Set Battery Voltage Limits
The app battery display ranges from `VOLTAGE_LOW` for an empty battery to `VOLTAGE_MAX` for a fully charged battery. Keep the selected body's defaults or change them when using a different battery.
- Set the Low Voltage Value
Set the empty-battery threshold in the configuration, for example `#define VOLTAGE_LOW 6.8f`.
- Set the Voltage Divider Factor
If the voltage divider differs from the body's, set `VOLTAGE_DIVIDER_FACTOR` to (R1 + R2) / R2.
- Set the Minimum Motor Voltage
Set `VOLTAGE_MIN` to the lowest voltage at which the motors still rotate. The firmware uses this value only in No Phone mode.
- 安装 PinChangeInterrupt
为 Arduino Nano 的速度传感器和超声波传感器安装 PinChangeInterrupt 库。
- 安装 OLED 库
如果启用 OLED,请安装 Adafruit_SSD1306 和 Adafruit_GFX Library 库。
- 在 Arduino IDE 中安装库
打开库管理器,在搜索框中输入所需的库名称,选择最新版本并点击“安装”。如果已经安装该库,IDE 会显示它并允许更新。
- 安装 WCH340 驱动
中国版 Nano 克隆板可能需要芯片厂商提供的 WCH340 驱动。使用对应链接下载 Windows、Linux 或 Mac 驱动。
- 打开 Arduino 首选项
在 Arduino IDE 中,转到“文件 > 首选项”。
- 添加 ESP32 开发板 URL
在“附加开发板管理器 URL”字段中输入 https://dl.espressif.com/dl/package_esp32_index.json,然后点击“确定”。如果已有 ESP8266 开发板 URL,请用逗号分隔两个 URL。
- 打开开发板管理器
转到“工具 > 开发板 > 开发板管理器”以打开开发板管理器。
- 安装 ESP32 版本 2.0.17
搜索 ESP32,找到 Espressif Systems 的 ESP32,确认下拉框中选择了版本 2.0.17,然后点击“安装”。3.x.x 版本无法使用。
- 确认 ESP32 环境配置
Arduino 开发环境现已具备成功刷写 OpenBot ESP32 开发板所需的全部内容。
- 选择 ESP32 Dev Module
使用新代码刷写 OpenBot 时,从“工具 > 开发板 > ESP32 Arduino”中选择 ESP32 Dev Module。
- 降低上传速度
如果上传遇到问题,请转到“工具”菜单并将上传速度设置为 115200。
- 配置 Arduino Nano
选择 Arduino AVR Boards > Arduino Nano、处理器 ATmega328P(旧引导加载程序)和 USB 端口。如果无法上传固件,请将处理器改为 ATmega328P。
- 配置 ESP32
选择 ESP32 Arduino > ESP32 Dev Module 和 USB 端口。
- 上传固件
通过 Sketch > Upload 上传固件,或按 Upload 按钮(向右箭头)上传。
- 启用无手机模式
将 `NO_PHONE_MODE 1` 设为开启状态。汽车以普通速度(75% PWM)行驶,在障碍物附近减速;当接近 `TURN_THRESHOLD`(默认 50 cm)时随机转向,当前侧面的 LED 亮起;前方估算空间低于阈值时缓慢倒车,两侧 LED 亮起。
- 添加 Bluepad32 开发板 URL
在 Arduino IDE 中打开环境设置,在“附加开发板管理器网址”中添加文档给出的 URL。
- 安装 Bluepad32 开发板包
在开发板管理器中安装 `esp32_bluepad32` 4.1.0。它基于与普通固件相同的 ESP32 核心 2.0.17。
- 选择 ESP32 Dev Module
从可用的 esp32_bluepad32 开发板中选择 **ESP32 Dev Module**。
- 启用手柄模式并上传
设置 `NO_PHONE_MODE 1` 和 `HAS_GAMEPAD 1`,然后上传固件。手柄使用 ESP32 蓝牙,因此此模式下会关闭与手机的蓝牙连接;使用手机应用控制时,请设置 `HAS_GAMEPAD 0` 并将手柄与手机配对。
- 在串口监视器显示手柄名称
设置 `DEBUG 1`,即可在串口监视器中显示已连接手柄的名称。
- 选择提供的固件目标
对于采用 ATmega328P 微控制器的 Arduino Nano 或 ESP32 开发套件,使用提供的 openbot.ino 固件。
- 选择机器人和组件
打开固件设置页面并选择机器人及组装中使用的组件。
- 在浏览器中刷写固件
使用电脑上的 Chrome 或 Edge,直接从设置页面刷写固件。
标定与测试
- 设置电池、部件和手机模式
设置电池、部件以及机器人是否携带智能手机,使预配置固件无需编译即可匹配机器人。
- 选择机器人主体和开发板
为机器人主体设置 `OPENBOT`,并在 Arduino IDE 中选择受支持的开发板。固件会自动检测开发板,使用其他开发板时构建将报错并中止。
- 启用无手机和游戏手柄模式
设置 `NO_PHONE_MODE 1` 启用无手机模式。使用 ESP32 时,还可设置 `HAS_GAMEPAD 1`,通过游戏手柄驾驶。
- 配置滑行和调试输出
将 `COAST_MODE` 设为 `1` 时,电机在无控制状态下滑行;设为 `0` 时刹车。设置 `DEBUG 1` 可在串口监视器输出调试信息。
- 设置蓝牙机器人名称
设置 `BLE_NAME` 为机器人在手机应用中显示的名称。名称最多可包含 20 个字母、数字、空格、连字符或下划线。
- 使用主体默认组件
每种主体会启用其通常具备的组件,ESP32 还会启用与手机的蓝牙连接。除非需要修改,否则将各组件保留为对应主体的默认值。
- 启用或禁用组件
将组件设为 `1` 可启用,设为 `0` 可禁用;例如未安装超声波传感器时使用 `#define HAS_SONAR 0`。启用但未安装的组件不会损坏机器人,但应用可能显示无意义的数据,例如 300 厘米的超声波距离。
- 设置电池电压阈值
使用 `VOLTAGE_LOW` 表示电量耗尽,使用 `VOLTAGE_MAX` 表示电量充足。为其他电池设置合适的最低电压值。
- 设置电压分压器系数
如果电压分压器与机器人本体的分压器不同,请将 `VOLTAGE_DIVIDER_FACTOR` 设置为 (R1 + R2) / R2。`VOLTAGE_MIN` 是电机仍能转动的最低电压,仅在无手机模式下使用。
- 使用合适电池或降低速度
高速行驶时,尤其是从地面起步时,电机可能消耗大量电流,导致开发板重启并使应用或游戏手柄断开。请使用新的或可充电的 NiMH 或锂离子电池,或使用较慢的速度档位。
- 必要时重新配对手柄
机器人因电压下降而重启后,可能需要重新配对手柄。
- 检查启动配置
以 115200 波特率打开串口监视器,检查所报告的机器人本体和已启用部件。第二行会显示配置来源为 `openbot_settings.h`;没有设置文件时则为 `openbot.ino`。
- 设置轮式里程计间隔
发送 `w<time_ms>`,其中时间以毫秒为单位,表示轮式里程计测量之间的时间间隔。轮速会持续受到监控,转速平均值按该时间间隔计算;默认值为 1000 毫秒。
- 设置电压测量间隔
发送 `v<time_ms>`,其中时间以毫秒为单位,表示电压测量之间的时间间隔。电压通过大小为 10 的滑动平均滤波器进行滤波;发送此命令还会请求最小电机驱动电压(`vmin:<value>`)、最低电池电压(`vlow:<value>`)和最高电池电压(`vmax:<value>`)。
- 设置心跳停止超时
发送 `h<time_ms>`,其中时间以毫秒为单位,表示未收到新的心跳消息后机器人停止的时间。默认值为 -1。
- 设置保险杠触发器重置时间
发送 `b<time_ms>`,其中时间以毫秒为单位,表示保险杠触发器重置前的时间。默认值为 750 毫秒。
- 控制状态指示灯
发送 `n<color>,<state>` 来控制状态指示灯。支持的颜色为蓝色(`b`)、绿色(`g`)和黄色(`y`);`0` 表示关闭,`1` 表示开启。
- 检查电池电压消息
以 `v` 开头的消息报告电池电压。打开汽车开关时应显示电池电压,关闭开关时应显示一个较小的值。
- 检查轮速消息
以 `w` 开头的消息报告速度传感器测量值,单位为每分钟转数。使用 `DISK_HOLES` 设置编码器盘孔数;标准的 20 孔盘每转一圈产生 20 次计数。
- 检查超声波距离消息
以 `s` 开头的消息报告超声波传感器前方估计的空闲空间,单位为厘米。
- 检查碰撞消息
以 `b` 开头的消息报告碰撞。代码用于标识触发碰撞的传感器:`lf` 左前、`rf` 右前、`cf` 前中、`lb` 左后、`rb` 右后。
- 测试左右转向指示灯
发送 `i1,0` 并观察左侧指示灯闪烁。然后发送 `i0,1` 使右侧指示灯闪烁,最后发送 `i0,0` 关闭两个指示灯。
- 启用无手机模式
在设置中将 `NO_PHONE_MODE 1` 设为启用。这样小车将以正常速度行驶,对应 75% PWM。
- 观察无手机模式下的行驶行为
当超声波传感器检测到障碍物时,小车会减速。接近默认值为 50 cm 的 `TURN_THRESHOLD` 时,小车会随机转向并点亮该侧的 LED;低于该阈值时,小车会缓慢倒退并同时点亮两个 LED。
- 拆除轮胎并观察串口输出
运行小车前,拆下轮胎,将 Arduino 连接到电脑,并按照 `Testen` 部分观察串口监视器。监视器会显示电池电压、左右电机转速以及前方估计的可用空间。
- 使用超声波传感器测试避障响应
在超声波传感器前方来回移动一个大型物体。观察前方估计可用空间变化时,电机速度如何改变。
- 检查超声波传感器安全设置
测试前确保已安装并启用超声波传感器。如果传感器缺失或被禁用,小车会以 75% PWM 向前行驶,并最终发生碰撞。
- 配对游戏手柄
打开机器人并将游戏手柄置于配对模式。它会在几秒内连接,之后每次开机都会重新连接。
- 配对其他游戏手柄
配对其他游戏手柄前,先关闭当前已连接的手柄。机器人始终只使用一个游戏手柄驾驶。
- 通过调试输出识别游戏手柄
将 DEBUG 设为 1。串口监视器随后会显示每个已连接游戏手柄的名称。
- 重新配对手柄并重启
如果已配对的游戏手柄未接管控制,请再次将其置于配对模式并重启机器人。对于 PS4 或 PS5 控制器,灯条保持蓝色而不是变为绿色、橙色或红色,表示尚未接管控制。
- 忘记所有已配对手柄
如果游戏手柄仍无法连接,请在刷写时于设置页面勾选 Forget paired gamepads。机器人随后会忘记所有已配对的游戏手柄。
- 为探索配置声呐
连接声呐传感器并设置 `HAS_SONAR 1`。没有该传感器时,机器人只会直线行驶。
- 启用声呐障碍物停止
连接声呐传感器并设置 `HAS_SONAR 1`。否则机器人不会在障碍物前停车。
- 配置电池、组件和模式
在机器人上设置电池、组件以及是否使用手机。预编译固件随后即可适配机器人,无需编译。
- 仅发送后续设置更改
初始设置完成后,使用 Update settings only 将更改后的设置发送到机器人,无需重新刷写。
- 手动编辑 SETTINGS 部分
如需手动配置固件,仅修改 openbot.ino 顶部的 SETTINGS 部分,不修改其下方内容。
- 设置电池电量范围
对于其他电池,请在设置中调整 `VOLTAGE_LOW` 和 `VOLTAGE_MAX`。示例将 `VOLTAGE_LOW` 设置为 6.8f。
- 调整电压分压器系数
如果电压分压器与机身上的不同,请将 `VOLTAGE_DIVIDER_FACTOR` 设置为 (R1 + R2) / R2。`VOLTAGE_MIN` 是电机仍能运行的最低电压,固件仅在无手机模式下使用它。
- 防止低电压断开连接
高速运行时,尤其是在地面上启动时,电量不足或碱性 AA 电池可能造成电压下降,使控制板重启并断开应用或手柄连接。请使用新的或可充电的 NiMH 或锂离子电池,或使用较慢模式;如有需要,随后重新配对手柄。
采数据与训练
- 连接蓝牙游戏控制器
将蓝牙游戏控制器连接到手机,例如 PS4 控制器。要进入配对模式,按下 PS 和 share 键,直到 LED 快速闪烁。
- 选择手机命令模型
在应用中选择 `CIL-Mobile-Cmd` 模型。
- 驾驶并录制数据集
使用游戏控制器驾驶汽车并录制数据集;在 PS4 控制器上,可按 X 按钮切换录制。驾驶行为越稳定、越一致,网络学到的驾驶方式就越好。
- 查找录制的数据集
在智能手机内部存储的 *Documents/OpenBot* 文件夹中查找录制文件。每次录制对应一个名为 *yyyymmdd_hhmmss.zip* 的压缩文件,名称表示录制开始时的时间戳。
- 创建 dataset 文件夹
在与 Jupyter 笔记本相同的文件夹中创建名为 `dataset` 的文件夹。
- 创建训练和测试子文件夹
在 `dataset` 内创建 `train_data` 和 `test_data` 两个子文件夹。
- 按 80/20 划分数据
通常将 80% 的数据放入训练数据,20% 的数据用于测试。
- 创建录制会话文件夹
在 `train_data` 和 `test_data` 内分别创建录制会话文件夹,并命名为 `my_openbot_1`、`my_openbot_2` 等。
- 放入解压后的录制文件
将从手机上的 *Openbot* 文件夹传输并解压的每个 zip 录制文件放入对应的录制会话文件夹。
- 将 uploaded 作为训练会话
将 `uploaded` 文件夹作为一个录制会话文件夹,并把它移动到 `train_data`。
- 保留测试录制会话
如果 `test_data` 中还没有录制会话,至少将 `train_data/uploaded` 中的一条录制移到 `test_data/uploaded`。
- 转换训练与测试数据集
将 dataset/train_data 和 dataset/test_data 转换为 dataset/tfrecords 下的 train.tfrec 与 test.tfrec。默认情况下,训练开始时会自动执行此转换。
- 打开策略学习笔记本
打开 policy_learning.ipynb,它会引导你使用自己的数据训练自动驾驶模型。浏览器窗口将自动打开并加载该笔记本。
- 配置 Shell 训练参数
可选择模型架构:cil_mobile、cil_mobile_fast、cil 或 pilot_net;代码默认值为 pilot_net,帮助文本默认值为 cil_mobile。可使用 batch_size=16、learning_rate=0.0001、num_epochs=10,以及 --batch_norm、--flip_aug、--cmd_aug 和 --resume。
- 使用 TFRecord 训练策略
当数据集已经转换为 tfrecord 时,通过 openbot.train 模块从 Shell 训练策略。
- 训练前创建 TFRecord
添加 --create_tf_record 标志,在训练前将数据集转换为 tfrecord。
- 训练部署模型
使用较大的批次大小和较多轮次进行训练,并启用批归一化。pilot_net 比默认的 cil_mobile 更大,在部分任务中可获得更好的性能,同时仍可在大多数智能手机上实时运行。
- 自动上传记录会话
应用会自动加载记录或会话。更多细节请参阅“问题解决”部分。
- 将会话移入数据集
在网页应用中,将一个会话移动到所选数据集中。
- 删除会话
从网页应用中删除不再需要的会话。
- 用基础参数训练模型
设置基础训练参数来训练模型,并在网页应用中显示进度条。
- 连接蓝牙游戏手柄
将蓝牙游戏手柄连接到手机,例如 PS4 手柄。按住 PS 和 Share 键,直到 LED 快速闪烁,进入配对模式。
- 选择遥控命令模型
在应用程序中选择 `CIL-Mobile-Cmd` 模型。
- 驾驶并记录数据集
使用游戏手柄驾驶汽车并记录数据集。在 PS4 手柄上,可按 **X** 键启用或停用记录。
- 整理训练与测试数据
在 `dataset` 文件夹中创建 `train_data` 和 `test_data` 两个子文件夹,并为每次记录会话创建文件夹,例如 `my_openbot_1`。将各个解压后的记录 zip 文件放入对应会话文件夹;通常按 80% 训练数据和 20% 测试数据划分。
- 自动下载并解压记录
也可以将日志自动下载到计算机上的 Python 服务器。ZIP 文件会被下载并解压到 `dataset/uploaded`。
- 移动上传文件夹到训练数据
将 `uploaded` 文件夹视为一个记录会话,并将其移入 `train_data`。Jupyter 笔记本随后会将这些记录识别为训练数据。
- 准备至少一个测试记录
如果 `test_data` 中还没有记录会话,则将至少一个 `train_data/uploaded` 记录移到 `test_data/uploaded`。
- 转换训练和测试数据集
使用 `openbot.tfrecord` 将训练和测试数据集转换为 TFRecord,输出到 `dataset/tfrecords`,文件名为 `train.tfrec` 和 `test.tfrec`。默认情况下,训练开始时会自动执行此转换。
- 配置数据和模型训练参数
可使用 --no_tf_record 直接读取文件目录,或使用 --create_tf_record 创建新的 tfrecord。模型选项包括 cil_mobile、cil_mobile_fast、cil 和 pilot_net,批量大小默认值为 16,学习率默认值为 0.0001。
- 配置训练周期和增强选项
训练周期数默认值为 10,可使用 --batch_norm 启用批量归一化。--flip_aug 会随机翻转图像和命令,--cmd_aug 会向命令输入添加噪声,--resume 用于恢复之前的训练。
- 从现有 tfrecord 训练策略
如果数据集已经转换为 tfrecord,直接运行 openbot.train 即可从 shell 训练策略。
- 训练前创建 tfrecord
在训练前使用 --create_tf_record,将数据集转换为新的 tfrecord,然后开始训练。
- 直接使用文件训练
使用 --no_tf_record 可跳过 tfrecord 转换,直接从文件训练数据集。此方法假定数据已放在正确位置。
- 训练最终部署模型
使用 pilot_net、批量大小 128、100 个训练周期和批量归一化来训练最终部署模型。pilot_net 比默认的 cil_mobile 更大,在某些任务上可能性能更好,同时仍能在大多数智能手机上实时运行。
- 选择并重命名 TFLite 模型
训练结束后会生成两个 TFLite 文件:验证指标最佳的检查点和最后一个检查点。选择其中一个并重命名为 autopilot_float.tflite。
- 耐心完成数据收集与调参
获得适合自定义数据集的良好驾驶策略需要耐心,并涉及数据收集和超参数调整。
- 通过 Python 服务器上传日志
通过电脑上的 Python Web 应用自动上传日志;ZIP 文件会被解压到 `dataset/uploaded`。
- 整理训练与测试数据
将 `uploaded` 作为采集会话移入 `train_data`。如果 `test_data` 中还没有采集会话,还需至少将一个 `train_data/uploaded` 采集移到 `test_data/uploaded`。
- 可选转换 TFRecord 数据
可创建训练数据集和测试数据集的 TFRecord,分别输出为 `train.tfrec` 和 `test.tfrec`。默认情况下,训练开始时会自动执行此转换。
用起来
- 打开主菜单
打开应用进入主菜单,该界面显示所有可用屏幕。
- 打开设置界面
点击主菜单右上角的图标以打开设置。
- 访问应用中的各个界面
点击主菜单上的其他图标,以访问可用的应用界面及其功能。
- 使用 Free Roam 控制机器人
Free Roam 提供简单的机器人控制与实时信息:电池电量图标、3 种驱动状态(D 前进、N 中立、R 倒车,方向盘按转向角转动)、速度表、前方自由距离(厘米),以及 Controller、Drive Mode、Speed 控制项。
- 设置点目标导航
此功能需要 ARCore 和相机权限;如果设备不支持 ARCore,应用会崩溃。以机器人当前位置和朝向为基准,输入前方距离和左侧距离,单位为米;负值分别表示后方和右侧。
- 查看模型管理和基准结果
查看可用模型及其基准结果。模型均经过量化以提高嵌入式设备上的性能;基准测试使用 COCO Detection 2017 验证集,每个模型运行约 1 分钟,并对最后 100 帧的推理时间取平均值。
- 打开 DefaultActivity 主界面
使用 DefaultActivity 在一个界面中查看车辆连接状态和传感器测量值。可使用标准 BT 游戏手柄,或运行 OpenBot controller app 的另一部智能手机控制机器人。
- 选择控制模式
使用第一个按钮选择控制模式。
- 使用蓝牙游戏手柄
在 Gamepad 模式下,应用从已连接的 BT 控制器接收控制输入。
- 通过手机或电脑控制机器人
在另一部智能手机上安装控制器应用后即可控制机器人;也可以让计算机运行 Python 脚本,并连接到同一网络。
- 选择游戏手柄驾驶模式
使用第二个按钮选择游戏模式。在游戏模式中,R2 和 L2 肩部扳机分别控制前进和倒车油门,任一摇杆用于转向。
- 选择摇杆驾驶模式
使用第二个按钮选择 Joystick 模式,然后用任意一个摇杆控制机器人。
- 选择双摇杆差速模式
使用第二个按钮选择 Dual 模式。左右摇杆分别控制车辆左右两侧,这是原始差速转向。
- 选择低速模式
使用第三个按钮选择 Slow 模式。电机电压限制为输入电压的 50%,约为 6V。
- 选择普通速度模式
使用第三个按钮选择 Normal 模式。电机电压限制为输入电压的 75%,约为 9V。
- 选择高速模式
使用第三个按钮选择 Fast 模式。电机不设电压限制,全油门时施加完整输入电压,约为 12V。这是运行神经网络的默认设置。
- 使用手柄调整速度模式
使用游戏手柄时,按下右摇杆 R3 可提高速度模式,按下左摇杆 L3 可降低速度模式。
- 查看发送给机器人的控制量
在界面右侧查看当前发送给机器人的控制量。
- 使用人物跟随模型
使用应用自带的 `MobileNetV1-300` 模型进行人物跟随。它使用带 MobileNet V1 骨干网络的 SSD 目标检测器,并经过量化以提高嵌入式设备上的性能。
- 启停神经网络
使用右侧开关开启或关闭网络。网络运行时会产生机器人控制指令并禁用游戏手柄,但仍可使用手柄按钮,例如用 R1 扳机键切换开关以重新控制机器人。
- 打开并刷新项目列表
After signing in with a Google account, the Projects Screen lists OpenBot Playground projects; when signed out, you can still scan project QR codes. If “Oops, no project found” appears, ensure the account has projects stored on Google Drive; pull down on the project screen to reload the latest projects.
- 运行 Google Drive 项目
点按要执行的项目并等待项目文件读取完成。成功后会弹出项目名称及“Start”和“Cancel”按钮;点击“Start”执行,点击“Cancel”取消活动。
- 扫描项目二维码
点击右上角的二维码图标,并授予应用相机访问权限。扫描后等待文件读取,成功时点击“Start”执行或点击“Cancel”停止活动;如果出现错误,请在 Playground 中生成新的二维码并重试。
- 运行并停止项目命令
OpenBot Playground 项目成功运行后,屏幕会显示代码块名称和停止按钮。使用停止按钮可停止 Playground 块命令的执行。
- 删除项目
长按要删除的项目,会弹出确认删除的窗口。点击“Yes”确认删除。
- 使用 Google 账号登录
当用户未登录时,点击 `Google Sign-in` 按钮并使用 Google 账号登录。
- 查看已登录账户选项
登录后,`Profile` 选项卡会显示 `Edit Profile` 和 `Logout` 两个按钮。
- 编辑个人资料
点击 `Edit Profile` 打开新界面,可更新姓名和头像等个人资料。
- 退出账户
点击 `Logout`,确认退出账户并返回登录界面。
- 打开 OpenBot Playground
点击屏幕顶部工具栏中的 OpenBot Playground 图标以访问相关服务。
- 直接运行 OpenBot Playground
打开 https://www.playground.openbot.org/,直接使用 OpenBot Playground。
- 同步 Google Drive 数据
将 Google Drive 与 OpenBot 同步,数据会自动保存在 Google Drive 中。
- 将数据保存到本地存储
将应用数据保存到本地存储。
- 扫描输出二维码运行程序
在 OpenBot 应用中直接扫描输出的二维码以运行程序。
- 从 Google Drive 加载文件
在 OpenBot 移动应用中登录后,可从 Google Drive 检索已保存的文件,并一键加载。
- 无代码设计 OpenBot 指令
使用 OpenBot Playground 的积木,以零代码方式设计机器人指令。
- 在移动设备上使用应用
通过针对手机和平板浏览优化的响应式界面使用 OpenBot Playground。
- 探索 OpenBot Playground 积木
查看 OpenBot Playground 提供的积木。
- 了解 Playground 的工作方式
打开 OpenBot Playground 首页,阅读轮播内容,了解平台的工作方式。
- 查看或创建项目
在首页的项目区域查看项目列表,或使用“Create new Project”按钮创建新项目。
常见问题
物料
- 主控:Arduino Nano(ATmega328P)或 ESP32 开发板(固件 README)
- DIY 版:4 个 TT 减速电机与轮胎、L298N 电机驱动(或定制 PCB V1/V2)、3 节 18650 电池与电池盒、USB OTG 线、M3 螺丝螺母
- 选配:2 个测速传感器、超声波传感器、转向 LED、SSD1306 OLED、电源开关
- 3D 打印车体(常规版需 240×150 mm 打印平台,另有 slim、可粘接与 Blocky 版)与手机支架
- RTR 版:防溅 ABS 外壳;RTR_TT 用 TT 电机、主要在室内,RTR_520 用 ESP32、520 电机、金属齿轮箱与全地形轮
- 一部 Android 手机(iOS 版为测试版)
工具
- 3D 打印机;也可用现成 Arduino 小车底盘,或用纸板、木板自制车体
- 烙铁(电机焊线、开关)与杜邦线
- 装 Arduino IDE 的电脑(ESP32 需 2.0.17 版核心);自行编译 App 需 Android Studio 或 Xcode
技能
- 基础焊接与接线(DIY 版接线较多,定制 PCB 可减少)
- Arduino 固件配置、烧录与串口测试
- 侧载 APK;训练驾驶策略需 Python 与 conda 环境
- Blockly 积木(OpenBot Playground)
软件
- OpenBot robot App(Android,v0.9.0 于 2026‑10‑07 发布):自由驾驶、数据采集、Autopilot、80 类物体跟踪、Point Goal Navigation
- Flutter 控制器 App,以及 Node.js、Python 与 web-server 控制器
- OpenBot Playground:网页 Blockly 积木编程,项目存 Google Drive 或扫码运行
- policy 驾驶策略训练代码与 Arduino 固件(含无手机模式与蓝牙手柄驾驶)