正在连接信源…

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”按钮创建新项目。

常见问题

  • 自动驾驶模型训练后仍无法正确驾驶 #31
  • Windows 上 Python 控制器无法连接或传输视频 #189 #190 #215
  • 手机应用无法稳定连接并控制电机 #51 #268
  • 保存最佳和最终检查点时 TensorFlow Lite 导出失败 #39
  • Arduino 固件编译时出现大量错误 #47
  • ESP32 运行时反复复位并启动失败 #455

物料

  • 主控: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 固件(含无手机模式与蓝牙手柄驾驶)

文档