1. 项目概述：从零打造你的全能机器人伙伴RITZ
如果你对机器人技术感兴趣，想亲手搭建一个既能遥控、又能自己躲避障碍，甚至还能响应简单语音指令的移动平台，那么你来对地方了。今天要分享的，是我基于Arduino Uno R3为核心，折腾出来的一个名为RITZ的全能机器人项目。它不仅仅是一个简单的遥控小车，更是一个集成了全向移动、环境感知和多模式控制于一体的“多面手”原型平台。在智能家居巡检、教育演示甚至一些创意互动项目中，这样一个灵活的平台能为你打开很多思路。
RITZ的核心设计理念是“模块化”和“多功能”。硬件上，它采用了经典的Arduino Uno搭配电机驱动扩展板的架构，这使得动力和控制部分清晰分离，后期维护和升级非常方便。软件上，通过结构清晰的代码，实现了蓝牙遥控、自动避障和简易语音控制三种模式的切换。你可能会问，为什么选择全向移动？答案是为了灵活性。通过四个电机的差速组合，RITZ可以实现原地旋转、横向平移以及任意方向的平滑移动，这在狭小空间或需要精确定位的场景下非常有用。
无论你是刚接触Arduino和机器人编程的爱好者，还是有一定基础想深入理解传感器融合与多模式控制逻辑的开发者，这个项目都能提供一条从硬件连接到软件调试的完整路径。接下来，我会带你一步步拆解RITZ的构建过程，从每一个元件的选型理由、电路连接的避坑要点，到代码中每个函数的设计逻辑和三种控制模式的实现细节，并分享我在调试过程中踩过的那些“坑”以及解决之道。让我们开始吧。
2. 硬件系统深度解析与选型思考
搭建一个稳定的机器人，硬件是地基。RITZ的硬件清单看起来不复杂，但每一个部件的选择背后都有其考量。这里我们不仅列出清单，更要弄明白“为什么是它”。
2.1 核心控制器：为什么是Arduino Uno R3？
主控板选择了几乎成为创客代名词的Arduino Uno R3。对于RITZ这样的综合项目，Uno是一个平衡了性能、易用性和生态的绝佳起点。它基于ATmega328P微控制器，拥有14个数字I/O引脚（其中6个支持PWM）和6个模拟输入引脚，这为连接多个传感器和执行器提供了基础。其16MHz的主频对于处理传感器数据、电机PWM控制和串口通信（蓝牙）来说完全够用，不会因为性能过剩而造成成本浪费。
更重要的是其庞大的社区和丰富的库支持。例如，我们驱动电机需要AFMotor库，驱动舵机需要Servo库，这些库都经过长期测试，稳定可靠，能让我们从底层寄存器操作中解放出来，专注于功能逻辑的实现。对于初学者，其简单的IDE和基于C/C++的语法（经过封装）也大大降低了入门门槛。当然，如果未来需要连接更多传感器或实现更复杂的算法（如图像识别），可以考虑升级到Mega 2560或ESP32，但在项目初期，Uno的性价比和确定性是最高的。
2.2 动力与驱动：电机与驱动板的搭配艺术
动力系统是机器人的“双腿”。RITZ使用了四个减速直流电机。这里的关键词是“减速”和“齿轮”。普通的直流电机转速高、扭矩小，直接驱动轮子会导致机器人速度过快、力量不足，轻易就会被一个小坎卡住。减速电机内部集成了齿轮箱，通过牺牲一部分转速来大幅增加输出扭矩，这让机器人更有“劲”，能够适应略有不平的地面，移动也更稳定。在选择时，我重点关注了工作电压（与供电匹配）和减速比，最终选用了在7.5V电压下扭矩适中的型号。
驱动这四个电机，我选择了Adafruit Motor Shield V2或者兼容的电机驱动扩展板。这是硬件设计中的一个关键决策。为什么不直接用L298N等独立驱动模块？核心原因是集成度与简化布线。电机驱动扩展板可以直接插在Arduino Uno上，通过排针连接，省去了大量杜邦线的焊接和整理工作，使得整个系统更加整洁，也减少了接触不良的隐患。这块扩展板通常能驱动4路直流电机或2路步进电机，每路都内置了H桥电路和必要的保护二极管，我们只需要通过AFMotor库调用简单的API（如motor1.run(FORWARD)）就能控制电机的转向和速度，极大简化了代码。
注意：使用这类扩展板时，务必注意其供电逻辑。扩展板通常有独立的电机电源输入口和逻辑电源输入口。在RITZ中，我们使用一个7.5V的DC电源同时为电机和Arduino供电（通过扩展板的Vin），但必须确保电源的电流输出能力足够（建议2A以上），否则在电机启动或堵转时可能导致电压骤降，致使Arduino重启。
2.3 感知系统：机器人的“眼睛”与“耳朵”
机器人要与环境互动，传感器必不可少。RITZ配备了三种传感器，构成了一个基础的感知阵列。
超声波传感器 (HC-SR04)：这是实现自动避障功能的核心。它通过发射超声波并接收回波来计算前方障碍物的距离。我将其定义为机器人的“主眼”，安装在舵机云台上，可以转动扫描左右两侧。其优点是测距范围较广（2cm-400cm），成本低；缺点是波束角较宽，对细小障碍物或斜面探测可能不准，且容易受到柔软表面（如窗帘）的干扰。在代码中，我们通过
Trig和Echo引脚与它交互，计算出的距离值直接用于决策。红外避障传感器：项目中提到了两个IR传感器。这类传感器通常用于检测近距离（几厘米到十几厘米）内是否有障碍物，输出的是数字信号（有障碍物时输出低电平）。它们可以被布置在机器人的左右两侧或前侧，作为近距离碰撞的“保险”。与超声波相比，IR传感器响应更快，但受环境光影响较大。在RITZ的代码中，虽然定义了
L1、R1等变量，但并未在主要模式中直接使用，这为我们留下了扩展空间，例如可以实现沿墙走或更精确的侧面防撞。蓝牙模块 (HC-05/HC-06)：这是实现遥控和“语音”控制的关键。它负责建立机器人与手机或电脑之间的无线串口通信。我选择了HC-05，因为它既支持从机模式也支持主机模式，更灵活。通过蓝牙，我们可以用手机APP发送字符指令（如‘F’代表前进）来控制机器人，这也是实现“语音控制”的基础——实际上，是手机APP将语音识别成字符后再通过蓝牙发送。
2.4 辅助与执行单元
- 舵机 (SG90)：用于带动超声波传感器左右旋转，实现环境扫描。SG90是一款常见的9g微型舵机，工作电压4.8V-6V，扭矩约1.6kg/cm，足以带动轻巧的超声波模块。在代码中，我们通过
Servo库控制其角度，实现leftsee()、rightsee()等扫描函数。 - LED灯：代码中定义了前灯(
F_LED)、后灯(B_LED)和侧灯(SL_LED,SR_LED)。它们不仅仅是装饰，在避障或转向时点亮相应的LED，可以直观地显示机器人的当前状态，对于调试和演示非常有用。 - LCD显示屏：原始材料中提及，但代码未使用。它可以用来显示传感器数据、当前模式或电池电压等信息，是提升交互性的好部件，可以作为后续升级的选项。
供电系统：整个系统采用7.5V直流电源供电。这个电压值是一个折中选择：高于Arduino Uno推荐的7-12V输入范围，能确保稳定；同时也能让减速电机获得不错的转速和扭矩。务必使用稳压电源或容量足够的电池组（如2S锂电，配降压模块给Arduino），避免电机工作时拉低电压。
3. 电路连接详解与实操避坑指南
有了清晰的硬件蓝图，下一步就是动手搭建。电路连接是项目成功的第一步，也是最容易出错的一步。下面这张接线表是基于代码引脚定义和常见扩展板布局整理的，请务必对照你的具体模块型号进行微调。
| 模块/组件 | 引脚/接口 | 连接至 Arduino/扩展板 | 功能说明与注意事项 |
|---|---|---|---|
| 电机驱动扩展板 | 电机接口 M1, M2, M3, M4 | 分别连接 电机1, 2, 3, 4 | 注意电机线序，接反会导致转向相反。通常扩展板有螺丝端子，确保拧紧。 |
| 电源输入 (VIN, GND) | 连接 7.5V DC电源正负极 | 关键！这是总电源入口。确保极性正确，电源功率足够。 | |
| 板载排针 | 直接插在 Arduino Uno 上 | 实现逻辑控制和供电传输。插拔前确保引脚对齐。 | |
| 超声波传感器 HC-SR04 | Trig | Arduino 引脚 A1 | 触发测距信号。 |
| Echo | Arduino 引脚 A0 | 接收回波信号。 | |
| Vcc | Arduino 5V 或扩展板 5V | 工作电压5V。 | |
| Gnd | Arduino GND 或扩展板 GND | 共地。 | |
| 蓝牙模块 HC-05 | TXD | Arduino 引脚 RX (0) | 注意：蓝牙模块的TXD接Arduino的RXD。 |
| RXD | Arduino 引脚 TX (1) | 蓝牙模块的RXD接Arduino的TXD。 | |
| Vcc | Arduino 5V | 工作电压通常为3.3V或5V，HC-05兼容5V。 | |
| Gnd | Arduino GND | 共地。 | |
| 舵机 SG90 | 信号线 (橙色/黄色) | Arduino 引脚 10 (通过扩展板) | 控制信号。扩展板通常有专用的舵机接口，或使用数字引脚。 |
| 电源线 (红色) | 扩展板或外接 5V电源 | 注意电流！舵机动作时电流较大，最好单独供电或确保5V电源能提供足够电流。 | |
| 地线 (棕色/黑色) | 扩展板或外接电源 GND | 必须与Arduino共地。 | |
| LED灯 (前/后/侧) | 正极 (长脚) | Arduino 引脚 A4, A5, A2, A3 | 通过数字引脚控制亮灭。 |
| 负极 (短脚) | 串联一个220Ω电阻后接GND | 必须串联限流电阻！直接接GND会烧毁LED或损坏Arduino引脚。 |
实操步骤与关键细节：
- 先规划，后接线：在面包板或机器人底盘上大致规划好各模块的位置，考虑重心分布和线缆长度。超声波传感器应置于前方，舵机云台要确保转动顺畅不卡线。
- 断电操作：任何连接或拔插操作，务必确保电源完全断开。带电操作是烧毁元件的头号杀手。
- 核心连接：扩展板与Arduino：将电机驱动扩展板小心地对准Arduino Uno的引脚，垂直插入。确保没有引脚弯曲或错位。这是整个系统的“骨架”。
- 连接电机：将四个减速电机的线接入扩展板的M1-M4端子。此时先不要固定死电机在底盘上的位置。因为我们需要后续通过测试来确定正确的转向，如果转向反了，只需交换该电机两根线的顺序即可。
- 连接电源：将7.5V电源的正负极分别接到扩展板的电源输入端子。再次强调极性！通常扩展板会标有“+/-”或“VIN/GND”。接反极性的后果通常是灾难性的。
- 连接传感器与模块：参照上表，使用杜邦线连接超声波、蓝牙等模块。对于LED，务必记得串联限流电阻（220Ω-1kΩ均可）。
- 检查与上电前最后确认：
- 所有GND（地线）是否都连接到了共同的GND网络？
- 蓝牙模块的TX/RX是否与Arduino的RX/TX交叉连接？
- 所有接口是否插紧？特别是杜邦线容易松脱。
- 确保没有金属部件造成短路（如裸露的线头碰到一起）。
致命陷阱：上传代码时的跳线帽：很多电机驱动扩展板（包括Adafruit Motor Shield）上都有一个用于连接Arduino Uno的ICSP引脚的跳线帽。它的作用是当使用某些特定库或功能时，提供额外的PWM控制通道。但是，在通过USB线给Arduino上传代码（Sketch）时，这个跳线帽必须拔掉！因为它会占用串口通信引脚，导致上传失败并报错。上传完成后，再插回跳线帽，机器人才能正常受扩展板控制。这是我踩过的第一个大坑，务必牢记。
4. 代码架构与多模式控制逻辑剖析
硬件是躯体，软件是灵魂。RITZ的代码虽然不长，但结构清晰，完整地实现了三种控制模式。我们来逐层解析其设计思路和实现细节。
4.1 全局配置与初始化：打好地基
代码开头是库引入和全局变量的定义，这是程序的“配置中心”。
#include <Servo.h> #include <AFMotor.h>引入Servo库控制舵机，AFMotor库控制电机驱动板。这两个库极大地简化了底层操作。
char value; // 存储从串口（蓝牙）接收的字符 int speedCar=255; // 电机速度，默认最高速（PWM值范围0-255） boolean lightFront = false; // 前灯状态标志 boolean lightBack = false; // 后灯状态标志 boolean S_light = false; // 侧灯状态标志 // 传感器相关变量 int distance; // 超声波测距结果 int Left, Right; // 左右扫描距离 int L = 0, R = 0, L1 = 0, R1 = 0; // 存储历史或扩展传感器数据 // 引脚宏定义 #define Echo A0 #define Trig A1 #define S_motor 10 // 舵机信号引脚 #define F_LED A4 #define B_LED A5 #define SL_LED A2 #define SR_LED A3 #define spoint 90 // 舵机正前方角度使用宏定义（#define）来管理引脚分配是个好习惯。一旦硬件连接确定，只需修改这里的定义，而不必在整个代码中搜索替换。spoint定义为90度，这是舵机的中间位置，即传感器指向正前方。
// 电机对象初始化 Servo servo; AF_DCMotor motor1(1); AF_DCMotor motor2(2); AF_DCMotor motor3(3); AF_DCMotor motor4(4);这里初始化了四个直流电机对象，参数1、2、3、4对应电机驱动板上的M1、M2、M3、M4通道。这里有一个极其重要的细节：电机编号与物理位置的映射，决定了机器人的运动逻辑。在后续的运动函数中，我们需要根据这个映射来编写差速转向代码。通常假设motor1和motor2是左侧电机，motor3和motor4是右侧电机，但具体需要根据你的实际接线和安装方向来验证。
在setup()函数中，完成了串口初始化、引脚模式设置和舵机附着。Serial.begin(9600)设置了蓝牙通信的波特率，必须与蓝牙模块的波特率一致（HC-05默认通常是9600或38400）。
4.2 运动控制函数库：让机器人“动起来”
代码的核心是一系列运动函数，如forward(),backward(),left(),right()等。它们直接控制四个电机的转向和速度。
以forward()（前进）函数为例：
void forward() { motor1.run(FORWARD); motor2.run(FORWARD); motor3.run(FORWARD); motor4.run(FORWARD); motor1.setSpeed(speedCar); motor2.setSpeed(speedCar); motor3.setSpeed(speedCar); motor4.setSpeed(speedCar); forwardview(); // 将舵机回中 }motorX.run(FORWARD)：设置电机转向。FORWARD和BACKWARD是库中定义的常量，具体对应电机正转还是反转，取决于你的电机接线。如果机器人前进时实际在后退，只需将所有FORWARD改为BACKWARD，或者更简单地，交换电机的两根接线。motorX.setSpeed(speedCar)：设置电机速度。speedCar是全局变量，范围0-255，对应PWM占空比，0为停止，255为全速。forwardview()：调用一个函数将舵机转到正前方（90度）。这是一个很好的设计，在每次改变运动状态时，确保传感器的“视线”与运动方向一致。
差速转向原理：left()（左转）函数的实现是理解全向移动的关键：
void left() { motor1.run(BACKWARD); // 左侧电机反转 motor2.run(BACKWARD); motor3.run(FORWARD); // 右侧电机正转 motor4.run(FORWARD); // ... 设置速度 digitalWrite(SL_LED, HIGH); // 点亮左侧指示灯 leftview(); // 舵机向左看 }这个实现让左侧两个电机向后转，右侧两个电机向前转。这样，左右两侧就产生了方向相反的力，机器人会实现原地左转。这是最基础的差速转向。而forwardLeft()（前进左转）函数则不同：
void forwardLeft() { motor1.run(RELEASE); // 左前电机停止 motor2.run(FORWARD); // 左后电机正转 motor3.run(FORWARD); // 右前电机正转 motor4.run(FORWARD); // 右后电机正转 // ... 设置速度 }这里motor1（假设是左前电机）被RELEASE（释放/停止），其他三个电机前进。这会导致机器人绕着左前轮为支点，向左前方做弧线运动。通过组合不同电机的停止、正转、反转，就能实现丰富的全向移动模式。
4.3 三大核心模式实现解析
主循环loop()中，通过注释切换三种模式函数，这是控制逻辑的“总开关”。
4.3.1 蓝牙遥控模式 (blutooth_mode())
这是最直接的控制方式。函数不断检查串口是否有数据（来自蓝牙），接收到字符后，用一个switch-case结构进行解析。
- 方向控制：
F(前进)、B(后退)、L(原地左转)、R(原地右转)，以及I(前进右转)、G(前进左转)等复合方向。 - 速度控制：字符
0到9以及q，对应不同的speedCar值，实现无极调速。 - 灯光控制：
W/w控制前灯，U/u控制后灯，X/x控制侧灯。这里使用了布尔标志位（lightFront等），接收到开灯命令后置为true，在每次循环中根据标志位状态来设置LED引脚电平。这种“状态机”的思维比直接digitalWrite更清晰，利于扩展。
实操心得：蓝牙调试：在编写和调试蓝牙控制部分时，可以先用USB线连接电脑，打开Arduino IDE的串口监视器，手动输入字符发送，观察机器人的反应。这能有效隔离硬件问题（如电机接线错误）和软件逻辑问题。确保手机APP发送的字符与代码中定义的字符完全一致（注意大小写）。
4.3.2 自动避障模式 (obstacle_mode())
这是机器人自主性的体现。其逻辑是一个简单的“感知-决策-行动”循环。
- 感知：调用
ultrasonic()函数获取前方距离distance。 - 决策：
- 如果
distance <= 12（厘米），说明前方有障碍物。- 行动：先停止(
Stop())，然后短暂后退(backward())以腾出转向空间。 - 再感知：调用
leftsee()和rightsee()函数。这两个函数会控制舵机转向左侧（180度）和右侧（20度），并测量左右两侧的距离，结果存入L和R。 - 再决策：比较
L和R，选择距离较大的一侧作为转向方向。如果L < R（右侧空间大），则向右转(O_right())；反之向左转(O_left())。
- 行动：先停止(
- 如果
distance > 12，则安全，继续前进(forward())。
- 如果
这个算法非常经典，但也比较基础。它的缺点是“撞了南墙才回头”。优化思路可以是：在前进过程中就周期性扫描左右，提前规划路径；或者设置一个更大的安全距离（如20cm）开始减速并准备转向。
4.3.3 简易语音控制模式 (voice_control())
本质上，这是蓝牙控制的另一种形式。它假设手机APP端已经将语音指令（如“前进”、“左转”）识别并编码成了特定的字符（如^代表前进，<代表左转），然后通过蓝牙发送。机器人端只是解析这些特殊字符而已。
代码中，接收到<或>时，会先扫描对应方向的距离（leftsee()/rightsee()），只有距离大于等于10厘米时才执行转向，否则停止。这为语音控制增加了一点简单的安全性判断，防止在狭窄空间盲目转向撞墙。
模式切换的工程实现：原代码通过注释loop()函数中的不同模式函数调用来切换。在实际项目中，更优雅的方式是增加一个硬件开关（如拨码开关）或通过蓝牙发送一个特定指令（如M）来改变一个全局模式变量，然后在loop()中用if或switch根据这个变量来决定执行哪个模式函数。这样就不需要每次修改代码并重新上传了。
5. 从调试到优化：实战问题排查与进阶思考
硬件连好了，代码上传了，但机器人可能不会按预期工作。别急，这是学习和深化理解的最佳时机。下面是我在调试RITZ过程中遇到的一些典型问题及解决方法。
5.1 常见问题速查表
| 问题现象 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
| 上电后毫无反应，Arduino灯不亮 | 1. 电源未接通或电压不足。 2. 电源极性接反。 3. 扩展板与Arduino接触不良。 | 1. 用万用表测量电源输出电压是否达到7.5V，连接点是否有电压。 2. 立即检查电源线正负极是否接反。 3. 重新拔插扩展板，确保所有引脚接触良好。 |
| Arduino灯亮，但电机不转 | 1. 电机驱动板未使能或供电问题。 2. 代码未上传成功或错误。 3. 电机本身损坏或接线脱落。 | 1. 检查扩展板电机电源接线，确认跳线帽（如果有时）已插回。 2. 尝试上传一个最简单的“Blink”程序，确认Arduino和IDE环境正常。再检查当前代码是否有语法错误。 3. 直接将电机接上电池，看是否转动，以排除电机故障。 |
| 电机转动，但方向混乱或原地打转 | 1. 电机接线顺序错误。 2. 代码中电机对象（motor1-4）与物理电机位置映射错误。 3. 个别电机线序反了。 | 1.这是最常见的问题！单独测试每个电机：写一个测试程序，只让motor1正转，观察是哪个电机在转，并标记下来。依次测试完四个电机，建立正确的映射关系，然后修改运动函数中的电机控制逻辑。 |
| 蓝牙无法连接或连接后无控制 | 1. 蓝牙模块TX/RX接反。 2. 波特率不匹配。 3. 手机APP配对或连接错误。 | 1. 确认蓝牙TXD接Arduino RX(0)， RXD接TX(1)。 2. 检查代码 Serial.begin(9600)与蓝牙模块波特率是否一致（用AT指令配置）。3. 手机先搜索蓝牙设备（HC-05），配对密码常为1234或0000。在APP中选择已配对的设备进行连接。 |
| 超声波传感器读数不准或为0 | 1. 接线错误（Trig/Echo）。 2. 传感器前方有障碍物太近或太远。 3. 电源干扰或代码测量逻辑问题。 | 1. 核对Trig、Echo引脚连接。 2. 确保测量物体在2cm-400cm范围内，表面平整。 3. 尝试在 ultrasonic()函数中增加短暂的delayMicroseconds(2)，确保触发信号稳定。用串口打印原始脉冲时间t进行调试。 |
| 舵机不转动或抖动 | 1. 供电不足（电流不够）。 2. 信号线接触不良。 3. 机械结构卡死。 | 1.单独给舵机供电！这是解决舵机抖动最有效的方法。使用一个独立的5V电源（或电池）给舵机供电，同时将其GND与Arduino GND相连。 2. 检查信号线是否接在正确的PWM引脚（如10）。 3. 手动转动舵机盘，检查是否被线缆或结构阻挡。 |
| 机器人运动时Arduino自动重启 | 电机启动/堵转瞬间电流过大，导致系统电压被拉低。 | 1. 使用更大容量或更高放电倍率的电池。 2. 在电机电源输入端并联一个大容量电解电容（如1000uF 16V）以缓冲电流冲击。 3. 在代码中为电机加速/减速加入软启动/软停止逻辑，避免速度突变。 |
5.2 调试技巧与心得
- 分模块调试：不要试图一次性让所有功能工作。先上传一个简单的程序，只测试电机（例如，让所有电机以低速正转5秒）。然后单独测试超声波传感器（在串口监视器打印距离）。接着测试蓝牙（发送字符，在串口监视器回显）。最后再测试舵机。这样当问题出现时，你能快速定位范围。
- 善用串口打印：
Serial.print()是你的最佳朋友。在关键位置（如进入某个函数、收到蓝牙字符、测到障碍物时）打印状态信息或变量值，能让你清晰地了解程序的执行流程和逻辑判断是否正确。 - 电源是万恶之源：至少70%的奇怪问题都与电源有关。务必确保你的电源适配器或电池在带载（所有电机同时转动）时，电压仍能稳定在7V以上。一个USB电压电流表是很有用的工具，可以实时监测供电情况。
- 机械结构要稳固：电机的震动很大，如果底盘、传感器支架用胶水粘接或扎带固定不牢，很快就会松动。尽量使用螺丝、螺母和支架进行刚性固定。
5.3 项目优化与扩展方向
RITZ作为一个原型平台，有巨大的扩展潜力：
- 增加传感器融合：引入红外避障传感器，实现真正的侧面防撞。增加陀螺仪/加速度计（如MPU6050）实现姿态感知和更稳定的直线行走。
- 改进避障算法：实现“沿墙走”算法，或者引入更智能的路径规划算法（如简单的BUG算法）。
- 无线图传与第一人称视角：加装一个WiFi摄像头模块（如ESP32-CAM），就可以在手机上看到机器人看到的画面，实现FPV控制。
- 集成机械臂：在底盘上加装一个小型舵机机械臂，结合超声波或视觉识别，实现抓取功能。
- 升级主控：将Arduino Uno替换为ESP32，可以获得更强大的处理能力、双核CPU、WiFi和蓝牙，轻松实现网页控制、接入物联网平台等高级功能。
6. 核心代码段精讲与参数调优
让我们回到代码，深入几个关键函数，理解其内部运作和调优点。
6.1 超声波测距函数ultrasonic()
int ultrasonic(){ digitalWrite(Trig, LOW); delayMicroseconds(4); // 确保低电平稳定 digitalWrite(Trig, HIGH); delayMicroseconds(10); // 发送10微秒的高电平脉冲 digitalWrite(Trig, LOW); long t = pulseIn(Echo, HIGH); // 测量高电平持续时间 long cm = t / 29 / 2; // 将时间转换为厘米 return cm; }- 原理：
Trig引脚发出一个至少10微秒的高电平脉冲，触发传感器发射超声波。声波遇到障碍物返回，被接收器捕获，Echo引脚输出一个高电平脉冲，其宽度与距离成正比。 pulseIn(pin, value)：这个函数等待指定引脚变为指定电平（这里是HIGH），并开始计时，直到引脚变回LOW，返回持续的微秒数。这是一个阻塞式函数，意味着在测量期间，程序会停在这里等待。在复杂的多任务程序中，这可能影响其他功能的实时性，需要考虑非阻塞的计时方式。- 距离计算：声速在空气中约340m/s，即每微秒传播0.034cm。来回一次，所以距离
cm = (t * 0.034) / 2 ≈ t / 58.8。代码中t / 29 / 2等价于t / 58，是一个近似值，足够用于避障。 - 调优：
delayMicroseconds(4)和10是经验值，通常不需要改动。如果测量不稳定，可以尝试稍微增加delayMicroseconds(10)到12或15。测量范围最好限制在2cm-200cm之间，超出范围返回值可能不准确。
6.2 舵机扫描函数leftsee()与rightsee()
int rightsee(){ servo.write(20); // 舵机转到右侧20度位置 delay(500); // 等待舵机转动到位 Left = ultrasonic(); // 测量距离，注意这里变量名是Left，但测的是右侧 return Left; }- 关键点：
delay(500)。SG90舵机从0度转到180度大约需要0.3秒。这里等待500毫秒，确保了舵机有足够的时间运动到指定位置并稳定下来，然后再进行超声波测距。如果这个延时太短，测距时舵机还在晃动，会导致读数不准。 - 变量命名混淆：
rightsee()函数里，将结果赋给了变量Left，这容易引起混淆。更好的做法是统一变量含义，或者使用更具描述性的变量名，如distanceRight。 - 优化：频繁的舵机转动和长延时会影响机器人反应速度。在避障模式下，可以不必每次都扫描左右，可以记录上一次的扫描结果，或者只在检测到障碍物时进行一次扫描决策。
6.3 运动函数中的速度控制
所有运动函数中都调用了motorX.setSpeed(speedCar)。这个speedCar是一个全局变量，在蓝牙模式下可以通过数字键0-9调整。
- PWM与速度：
setSpeed的值是PWM占空比，0-255。但电机的实际转速与PWM值并非严格的线性关系，且存在死区（通常低于某个值电机不转）。你可以通过实验，找出能让电机平稳启动的最低PWM值（比如可能是50），然后在代码中设置一个最小速度限制。 - 转向平衡：在差速转向（如
left()）时，左右电机速度相同。但如果你的电机个体有差异，或者左右轮摩擦力不同，可能会导致转向不圆滑。一个进阶的调优方法是引入PID控制，通过编码器反馈实际转速，动态调整PWM输出，让两侧轮子转速精确一致。这对于要求直线行走或精确转角的场景是必要的。
7. 总结与项目展望
回顾整个RITZ机器人的构建过程，从硬件选型、电路搭建到软件编程和调试，它完整地展示了一个嵌入式机器人项目从概念到实物的全流程。这个项目的价值不仅在于做出了一个能动的机器人，更在于它提供了一个可扩展的框架和一套解决问题的通用方法。
通过这个项目，我们实践了如何将复杂的系统分解为感知、决策、执行等模块，并用代码将它们有机整合。我们遇到了电源干扰、信号冲突、机械结构等实际问题，并学会了通过分步调试、串口监控、模块化测试等方法去定位和解决它们。这些经验，远比单纯复制一段代码更有价值。
如果你成功让RITZ跑了起来，那么恭喜你，你已经跨入了机器人开发的大门。接下来，你可以尝试我前面提到的任何一个扩展方向，比如为它装上“眼睛”（摄像头），赋予它更聪明的“大脑”（更复杂的算法），或者让它完成一个具体的任务（比如巡线、搬运小物件）。机器人技术的乐趣，就在于这种不断的迭代和创造。希望RITZ能成为你探索之路上的一个坚实起点。如果在复现过程中遇到任何问题，欢迎随时带着你的现象和思考来交流，很多时候，解决问题的过程本身就是最好的学习。
