1. 为什么我选择用 UNO Q 做一台桌面机器人去年年底我在整理工作台的时候发现角落里堆了三块吃灰的开发板一块经典的 Arduino UNO R3、一块 ESP32-C3、还有一块树莓派 Pico。它们各自都能跑起来但每次想做个稍微完整点的项目就会陷入这块板子算力不够、那块板子没有 Wi-Fi、另一块板子 GPIO 又太少的循环纠结里。直到 Arduino UNO Q 出来我才觉得桌面机器人这个念头可以真正落地了——它把经典 UNO 的引脚兼容性和一颗能跑 Linux 的协处理器塞进了同一块板子等于一次性解决了实时控制和上层逻辑两个层面的问题。JBR-001 就是在这个背景下诞生的。它不是那种追求炫技的双足人形也不是动辄几千块的商用桌面机械臂而是一台完全开源、结构件全部可 3D 打印、核心控制基于 Arduino UNO Q的小型桌面机器人。整机成本控制在三百元以内不含 3D 打印机本身所有 STL 文件、固件源码、装配文档都会公开。它适合谁如果你是会一点 Arduino、家里有台 3D 打印机、想做一个能放在桌上陪你干活的小玩意儿的人那这台机器人就是给你准备的。如果你完全没碰过嵌入式也没关系我会把每一步的为什么讲清楚你照着做也能跑通。我给它起名 JBR是 Just a Basic Robot 的缩写。这个名字本身就说明了定位不追求花哨先把能动能感知能交互这条链路完整跑通再谈扩展。桌面机器人这个品类其实很尴尬——大的太贵小的太玩具开源的又大多停留在能亮个灯的程度。JBR-001 想做的是把 3D 打印、嵌入式控制、开源协作这三件事拧成一股绳做出一个真正能摆在桌上、有存在感、还能持续迭代的东西。2. UNO Q 这块板子到底解决了什么痛点2.1 传统 UNO 做机器人的三个硬伤先说说为什么以前的方案让我一直下不了决心。用经典 UNO R3 做桌面机器人会遇到三个绕不过去的问题。第一是算力天花板。UNO 用的是 ATmega328P16MHz 主频、2KB SRAM。你要它同时跑舵机 PWM、读传感器、处理串口指令稍微复杂一点就开始丢步、卡顿。我试过在 UNO 上做六轴舵机的插补运算结果舵机抖得像得了帕金森根本没法看。第二是没有原生网络能力。桌面机器人如果只能靠 USB 线连着电脑才能工作那它就是个线控玩具谈不上桌面伙伴。想加 Wi-Fi 就得外挂 ESP8266 或 ESP32接线一堆还要处理两个 MCU 之间的通信协议调试成本直接翻倍。第三是引脚和资源紧张。UNO 的数字引脚就那么十几个舵机一占就是六七个再想接个 OLED、几个按键、一个超声波基本就满了。想扩展只能上 I2C 扩展板又是一层堆叠结构上很难看。2.2 UNO Q 的双核架构MCU 管实时MPU 管逻辑UNO Q 最让我兴奋的地方是它把一颗实时微控制器和一颗能跑 Linux 的应用处理器放在了同一块板子上两者通过内部高速总线通信。这个架构在工业界其实很常见叫异构双核但出现在 UNO 这个价位的开发板上是真的少见。具体到 JBR-001 的分工是这样的MCU 那一侧专门负责硬实时任务——舵机的 PWM 波形生成、编码器脉冲计数、按键消抖、超声波测距的时序控制。这些任务对时间精度要求极高差几微秒舵机就会抖。MPU 那一侧跑 Linux负责上层逻辑——接收网络指令、跑简单的路径规划、驱动 OLED 显示表情、处理语音模块的数据。两边通过串口或共享内存交换数据各干各的互不干扰。这个分工带来的直接好处是我再也不用在舵机要稳和逻辑要复杂之间做取舍了。以前用单核 MCU你写个delay()都会影响 PWM 输出现在 MPU 那边就算卡一下MCU 的舵机波形照样稳如老狗。2.3 引脚兼容带来的结构设计自由另一个容易被忽略但极其重要的点UNO Q 保持了经典 UNO 的引脚布局。这意味着什么意味着我可以用现成的 UNO 扩展板、现成的传感器模块、现成的舵机驱动板不用重新设计 PCB不用等打样。对于桌面机器人这种结构件比电路更花时间的项目来说这一点直接省掉了我至少两周的硬件调试周期。我在 JBR-001 上用的是一块标准的 16 路舵机驱动板PCA9685直接插在 UNO Q 的 I2C 引脚上就能用。电源部分单独走一路 5V 6A 的降压模块给舵机供电逻辑供电和动力供电完全隔离避免舵机启动瞬间把 MCU 拉复位——这个坑我踩过后面会细说。3. 3D 打印结构件的设计取舍与装配细节3.1 为什么结构件要能少一个螺丝就少一个JBR-001 的机身一共 14 个 3D 打印件全部用 PETG 打印。我一开始设计的时候犯了个典型错误追求工业感用了大量 M3 螺丝和热熔铜柱结果装配花了整整一个下午而且拆一次就滑丝。后来我推倒重来核心原则改成**能卡扣就不上螺丝能一体成型就不分件**。最终的方案里底座和躯干是一体打印的靠一个燕尾槽和两条弹性卡扣固定两条手臂的肩关节用的是打印出来的柔性铰链TPU 材质省掉了轴承和螺丝头部和躯干之间用一个 360 度舵机直连靠摩擦力定位不需要额外的紧固件。整机装配下来只需要 6 颗螺丝全部集中在舵机盘的固定上。这个取舍的逻辑很简单桌面机器人的结构件不是承重结构不需要工业级的连接强度。3D 打印的层间结合力本来就有限你拧螺丝的预紧力稍大一点就可能把打印件撑裂。用卡扣和柔性结构反而更耐用而且装配体验好太多。3.2 打印参数我踩过的层高和填充率坑打印参数这块我试过好几组配置最后稳定下来的方案是这样的参数推荐值原因层高0.2mm0.1mm 太慢且强度提升有限0.3mm 表面太糙影响卡扣配合填充率25% 网格低于 20% 卡扣容易断高于 30% 纯属浪费时间和材料壁厚3 层卡扣和铰链处的强度主要靠外壁3 层是性价比拐点打印温度240°CPETG低了层间结合差高了拉丝严重热床温度80°CPETG 必须够热才粘得住否则翘边打印速度40mm/s结构件不追求速度慢一点层间结合更牢特别提醒一句卡扣和柔性铰链这些关键部位一定要单独设置打印方向和填充。我最早把肩关节的柔性铰链和躯干一起打印结果因为打印方向不对铰链的受力方向和层纹方向垂直掰了两次就断了。后来改成单独打印、让层纹沿着受力方向走寿命直接翻了好几倍。3.3 装配顺序先装什么后装什么很讲究装配顺序不是随便定的它直接决定了你能不能把线藏好、能不能顺利合壳。我的建议顺序是先装底座和电源模块。电源线从底座底部走留出足够的余量因为后面合壳的时候你会需要把线往里塞。再装躯干和舵机驱动板。驱动板固定在躯干内侧所有舵机线先插好、理好用扎带固定再合躯干。然后装头部和 OLED。头部的 OLED 排线很脆弱一定要在头部还没固定到躯干之前就插好、测试亮屏再装上去。最后装手臂。手臂是最后装的因为它的柔性铰链在装配过程中容易被压到装早了容易变形。提示每装完一个模块先通电测试一次再继续。我见过太多人一口气装完结果发现某个舵机线插反了只能全部拆开重来。4. 固件架构MCU 和 MPU 各管一摊4.1 MCU 侧把实时性做到极致MCU 侧的固件我用的是 Arduino 框架核心思路是**主循环只做状态机所有耗时操作全部非阻塞**。具体来说舵机控制用的是 PCA9685 的硬件 PWMMCU 只需要通过 I2C 写目标角度不需要自己生成波形超声波测距用的是定时器中断触发避免pulseIn()阻塞主循环按键用的是外部中断加软件消抖。这里有个关键细节MCU 和 MPU 之间的通信协议必须足够轻量。我用的是一个自定义的二进制帧格式每帧 8 字节包含帧头、指令类型、参数、校验和。为什么不用 JSON因为 JSON 解析在 MCU 上太慢而且字符串处理容易出内存碎片。二进制帧虽然不直观但解析速度快、内存占用固定适合实时场景。// MCU 侧接收 MPU 指令的简化示例 void loop() { if (Serial1.available() 8) { uint8_t frame[8]; Serial1.readBytes(frame, 8); if (frame[0] 0xAA checksum(frame) frame[7]) { handleCommand(frame[1], frame[2], frame[3]); } } updateSensors(); // 非阻塞传感器更新 updateStateMachine(); }4.2 MPU 侧Linux 上跑什么、不跑什么MPU 侧跑的是 Linux我用 Python 写上层逻辑。这里有个原则MPU 只做决策不做控制。比如手臂抬到 45 度这个动作MPU 只负责把45 度这个目标值发给 MCU具体怎么插补、怎么限速、怎么防止舵机堵转全部由 MCU 处理。这样即使 Linux 那边因为某个进程卡了一下机器人的动作也不会突然抽搐。MPU 上跑的东西包括一个轻量的 Web 服务用来接收手机或电脑的指令、一个 OLED 表情渲染程序、一个简单的语音唤醒模块。这些任务对实时性要求都不高Linux 完全能胜任。4.3 两边通信的坑波特率和缓冲区MCU 和 MPU 之间的串口通信我踩过两个坑。第一个是波特率不匹配导致的乱码。我一开始设的 115200但 MPU 侧的 Linux 串口默认可能有流控或者缓冲设置不对导致数据丢包。后来改成 921600 并关闭流控才稳定下来。第二个坑是缓冲区溢出。MPU 侧如果一次性发太多指令MCU 的串口缓冲区会满导致后面的指令被丢弃。解决办法是在协议里加一个简单的流控MCU 每处理完一条指令就回一个 ACKMPU 收到 ACK 才发下一条。虽然牺牲了一点吞吐量但换来了可靠性对于桌面机器人这种低频指令场景完全够用。5. 调试过程中那些让我抓狂的瞬间5.1 舵机一启动MCU 就复位这是我最开始遇到的最诡异的问题每次舵机一动MCU 就重启串口打印一堆乱码。排查了半天最后用示波器抓到真相——舵机启动瞬间的电流冲击把 5V 电源拉低到了 3.3V 以下MCU 的欠压复位电路触发了。解决方案是逻辑供电和动力供电彻底隔离。舵机单独用一块 5V 6A 的降压模块MCU 和传感器用另一块 5V 2A 的模块两块模块的输入都来自同一个 12V 电源但输出完全不共地——只在一点用磁珠连接。改完之后舵机怎么动 MCU 都稳如泰山。注意如果你也用舵机做机器人电源隔离这一步千万别省。我见过太多项目因为这个问题卡好几天最后发现是电源的锅。5.2 3D 打印件的公差理论值和实际值差了多少3D 打印有个绕不开的问题尺寸公差。你模型上画的 10mm 孔打出来可能是 9.7mm 也可能是 10.3mm取决于打印机、材料、温度、速度。我最早设计的卡扣理论配合间隙是 0.2mm结果打出来要么太松一碰就掉要么太紧根本扣不上。后来我的做法是所有配合面都留 0.3mm 间隙然后用小刀或砂纸修配。听起来很土但这是最可靠的办法。另外关键配合尺寸我会先打一个测试件——只打配合的那一小部分验证公差后再打整个零件。虽然多花十几分钟但省下的返工时间远不止这些。5.3 柔性铰链的疲劳寿命肩关节用的 TPU 柔性铰链我一开始以为能无限弯折结果连续测试了两天大概几千次往复之后铰链根部出现了白色应力纹再弯几次就断了。后来我做了三件事一是把铰链的厚度从 1.2mm 加到 1.8mm二是把铰链的弯曲半径加大让应力分散三是在 TPU 里混了一点 PLA大概 10%提高一点刚性。改完之后同样的测试跑了一周都没事。这个经验告诉我柔性结构的设计不能只看能不能弯还要看能弯多少次。如果你要做频繁动作的机器人柔性铰链的疲劳寿命必须提前验证。6. 开源协作代码和模型怎么放、怎么维护6.1 仓库结构让第一次来的人能快速上手JBR-001 的仓库我分了四个目录hardware/放 STL 和 STEP 文件firmware/放 MCU 和 MPU 的代码docs/放装配文档和接线图examples/放几个开箱即用的示例程序。每个目录下都有一个 README说明这个目录里有什么、怎么用。我特别在意的一点是新人第一次打开仓库应该能在五分钟内知道我要下载哪些文件、按什么顺序做。所以我在根目录的 README 里放了一个快速开始清单从下载 STL 到烧录固件到装配一步一步列清楚每步都附上对应的文件链接。6.2 版本管理硬件和软件要分开打标签硬件和软件的迭代节奏不一样。结构件可能改一次就稳定了固件却要持续更新。所以我的做法是硬件用hw-v1.0这样的标签软件用fw-v1.2这样的标签两者独立。在文档里明确说明hw-v1.0 配合 fw-v1.0 及以上版本使用避免用户下载了新版固件却发现结构件不兼容。另外STL 文件我建议同时提供 STEP 格式。STL 只能看不能改STEP 可以导入 CAD 二次编辑。对于开源硬件项目来说提供可编辑的源文件是对社区最基本的尊重。6.3 我收到的最有价值的反馈项目开源之后我收到的最有价值的一条反馈来自一位做教育的老师。他说他在课堂上用 JBR-001 教学生但学生总是把舵机线插反导致舵机烧掉。他建议我在舵机驱动板的接线处加一个防反插的设计。这个反馈让我意识到开源项目的用户不都是像我这样的老手很多是新手。后来我在结构件上加了一个简单的理线槽每根线的走向都固定死插反了根本插不进去。这个改动很小但大大降低了新手的上手门槛。7. 这台机器人现在能做什么、还能怎么扩展7.1 当前能力清单JBR-001 目前能做的事情包括通过网页或手机控制手臂和头部的动作、显示简单的表情动画、超声波避障虽然桌面场景用得不多、语音唤醒并执行预设动作。它的动作精度大概在正负 2 度左右对于桌面交互来说完全够用。我平时用它做什么主要是当个桌面助手——比如我写代码的时候它会定时提醒我喝水有消息来了它会转头看我我离开工位太久它会做个睡觉的表情。这些功能都很简单但组合起来就有了一种它在陪我的感觉。7.2 三个我认为最有价值的扩展方向第一个是视觉。UNO Q 的 MPU 侧算力跑个轻量的图像识别模型是够的加一个 USB 摄像头就能做手势识别或者物体追踪。这个方向我已经在做了难点在于怎么把识别结果低延迟地传给 MCU 执行动作。第二个是多机协作。如果桌上有两台 JBR它们可以通过网络互相通信做同步动作或者对话。这个扩展的想象空间很大但需要设计一套简单的多机协议。第三个是模块化末端执行器。现在的手臂末端是个简单的夹爪如果做成快拆接口就可以换装笔架、摄像头云台、小风扇等等。这个改动主要在结构件上固件层面只需要加一个末端类型的配置项。7.3 给想复现的人几句实在话如果你打算复现 JBR-001我的建议是先别急着打印全部零件先打一个底座和一条手臂把电路跑通再说。我见过太多人一上来就打印全套结果发现电路有问题一堆零件全白打了。另外电源和舵机驱动板一定要买质量好的。这两个东西是整机稳定性的基石省这点钱后面会加倍还回来。舵机我推荐用金属齿轮的塑料齿轮的桌面机器人用几个月就扫齿了。最后别怕改。开源项目的意义不是让你照抄而是给你一个起点。你觉得哪个结构不合理、哪段代码写得烂尽管改改完如果觉得有价值欢迎提回来。JBR-001 从第一版到现在有一半的改进都来自别人的反馈。这台小机器人能不能变得更好取决于有多少人愿意动手折腾它。