嘿，朋友！我是 Agnes。既然你点开了这篇指南，我猜你手里可能正摆着一个看起来有点“傻乎乎”但又充满潜力的乐探机器人，或者你正打算入坑。别担心，哪怕你连 print("Hello World") 都还没写过，这篇指南就是为你准备的。我们不讲那些让人头疼的大学教材，咱们像聊天一样，把这个大家伙彻底玩明白。

第一章：初识你的新伙伴——它到底是什么？

首先，让我们给乐探机器人（通常指基于 Makeblock mBot 或类似架构的教育机器人，如 mBot2、Yujin 等，这里我们以通用的开源智能小车逻辑为例）正个名。它不是一个普通的玩具，它是一个可编程的移动计算平台。

想象一下，如果你把 Raspberry Pi（树莓派）或者 Arduino 塞进一辆小车的底盘，再给它装上眼睛（超声波传感器）和手（机械臂），你就得到了它。

核心组件拆解

在写第一行代码之前，你得知道它的身子骨由什么组成：

  1. 主控板（大脑）：通常是 STM32 或 ESP32 芯片。它负责接收指令、处理数据。
  2. 驱动模块（肌肉）：L298N 或 TB6612 电机驱动芯片。单片机输出电压太小，带不动电机，所以需要这个“放大器”。
  3. 电机（四肢）：直流减速电机。左边一个，右边一个，通过控制转速和方向来实现前进、后退、转弯。
  4. 传感器（感官）：
    • 超声波传感器：像蝙蝠一样，发出声波测距离，用于避障。
    • 红外传感器：像蛇一样，感知热量或用于循迹（识别地面上的黑线）。
    • 巡线模块：发射红外光，根据地面反射率判断黑白线。
  5. 电源系统：18650 锂电池组，提供稳定的 7.4V-12V 电力。

小贴士：很多新手上来就急着写代码，结果发现车不动。90% 的情况是电源没开或者线没插紧。乐探机器人的 Jack 接口虽然防呆，但有时需要轻轻按压才能接触良好。

第二章：搭建你的开发环境——工欲善其事

乐探机器人的编程生态非常友好，主要有两条路线：图形化编程（适合初学者和小朋友）和 Python/C++ 代码编程（适合进阶和实战）。我们直接上硬货——Python 编程，因为它是目前最流行的 AI 和物联网语言，学会了这波不亏。

1. 硬件连接

以经典的 mBot 为例：

  • 将超声波传感器插入 I2C 或 UART 接口（具体看型号，通常标记为 U 或 I2C）。
  • 将巡线传感器插入左侧 3 和右侧 4 号接口（这是默认定义）。
  • 确保电池盒开关关闭，连接 USB 线到电脑。

2. 软件安装

你需要安装 mBlock（图形化）或者直接使用 VS Code 配合 MicroPython。为了让内容更通用且具备实战价值，我们采用 MicroPython 方案。

  • 下载 MicroPython 固件：去乐探官网或 MicroPython 官网下载对应板型的 .uf2 固件。
  • 烧录方法：按住板子上的 RESET 和 BOOT 键，再按一下 RESET，松开 RESET，保持 BOOT 按住，电脑会识别为一个 U 盘。把 .uf2 文件拖进去，重启即可。

3. 配置 VS Code

  • 安装 Python 扩展。
  • 安装 Pymakr 或直接用 Thonny IDE（Thonny 对 MicroPython 支持极好，新手首选）。
  • 在 Thonny 中选择对应的端口和解释器（MicroPython for STM32/ESP32）。

第三章：Hello, World! —— 让小车动起来

不要小看基础。如果连简单的移动都搞不定，后面的智能行为就是空中楼阁。

第一个程序：前进两秒

在 Thonny 中，我们输入以下代码：

from machine import Pin, PWM
import time

# 定义电机引脚
# 根据乐探 mBot 的官方定义进行映射
MOTOR_A = Pin(15, Pin.OUT)  # 左电机方向
MOTOR_B = Pin(4, Pin.OUT)   # 右电机方向
ENA = PWM(Pin(13))          # 左电机速度
ENB = PWM(Pin(12))          # 右电机速度

# 设置 PWM 频率
ENA.freq(1000)
ENB.freq(1000)

def forward(speed):
    """前进函数，speed 范围 0-100"""
    MOTOR_A.value(1)  # 左电机正转
    MOTOR_B.value(1)  # 右电机正转
    ENA.duty_u16(int(speed * 65))  # 计算占空比，最大 65535
    ENB.duty_u16(int(speed * 65))

def stop():
    """停止函数"""
    MOTOR_A.value(0)
    MOTOR_B.value(0)
    ENA.duty_u16(0)
    ENB.duty_u16(0)

# 主程序
print("Robot Starting...")  # 打印启动信息
forward(50)                # 以 50% 的速度前进
time.sleep(2)              # 持续 2 秒
stop()                     # 停止
print("Done!")

运行起来后，你的小车应该会直直地往前冲两秒，然后停下。

常见问题排查

  • 车不动？ 检查电池是否有电（电压要高于 6V）。
  • 车歪着走？ 左右电机特性有差异，这是正常现象。我们在后面校准章节会讲怎么修。
  • 报错 OSError？ 引脚定义错了，请对照你具体型号的引脚图修改代码。

第四章：感知世界——传感器实战

现在车会动了，但它还是“瞎”的。我们需要给它装上眼睛。

1. 超声波避障

超声波测距原理很简单：发出声波，碰到障碍物反射回来，计算时间差得到距离。

from machine import Pin, UART
import time

# 使用 UART2 连接超声波传感器
uart = UART(2, baudrate=9600)

def get_distance():
    """读取超声波距离，单位：厘米"""
    uart.write('U')  # 发送查询指令
    time.sleep(0.1)
    if uart.any():
        data = uart.read().decode()
        try:
            return int(data)
        except:
            return 999  # 读取失败返回一个大数
    return 999

while True:
    dist = get_distance()
    print(f"Distance: {dist} cm")
    
    if dist < 20:  # 如果距离小于 20 厘米
        stop()
        time.sleep(0.5)
        print("Obstacle detected! Stopping.")
    else:
        forward(30)
    
    time.sleep(0.1)

2. 红外巡线

巡线传感器通常输出 0（检测到黑线）或 1（检测到白地）。我们需要同时读取左右两个传感器的值。

from machine import Pin

left_sensor = Pin(3, Pin.IN)   # 左巡线
right_sensor = Pin(4, Pin.IN)  # 右巡线

def line_follower():
    left = left_sensor.value()
    right = right_sensor.value()
    
    if left == 0 and right == 0:
        # 两条线都在，直行
        forward(50)
    elif left == 0 and right == 1:
        # 左边压线，向右修正
        turn_right(30)
    elif left == 1 and right == 0:
        # 右边压线，向左修正
        turn_left(30)
    else:
        # 都没压到，可能是白线，原地调整
        stop()
        time.sleep(0.2)

def turn_right(speed):
    MOTOR_A.value(1)
    MOTOR_B.value(0)
    ENA.duty_u16(int(speed * 65))
    ENB.duty_u16(0)

def turn_left(speed):
    MOTOR_A.value(0)
    MOTOR_B.value(1)
    ENA.duty_u16(0)
    ENB.duty_u16(int(speed * 65))

教学点：告诉小朋友，巡线就像玩“走钢丝”，眼睛要时刻盯着绳子（黑线），歪了就往回扭，但扭得过猛又会掉下去，所以要微调，不能猛打方向。

第五章：从模仿到创造——进阶算法

光会动和避障还不够，我们要让机器人“聪明”一点。

状态机思维

不要写长长的 if-else 嵌套。使用有限状态机（FSM）。想象机器人有三种状态：

  1. STATE_FORWARD：正常前进巡线。
  2. STATE_TURN：遇到转角，进行旋转修正。
  3. STATE_STOP：完成任务，停止。
import time

class RobotController:
    def __init__(self):
        self.state = "FORWARD"
        
    def update(self):
        if self.state == "FORWARD":
            self.handle_forward()
        elif self.state == "TURN":
            self.handle_turn()
            
    def handle_forward(self):
        left = left_sensor.value()
        right = right_sensor.value()
        
        if left == 0 and right == 0:
            forward(50)
        elif left == 0:
            self.state = "TURN_LEFT"
        elif right == 0:
            self.state = "TURN_RIGHT"
        else:
            forward(20)  # 白地慢走
            
    def handle_turn(self):
        # 简单的旋转逻辑，实际项目中需要更复杂的 PID
        turn_right(60)
        time.sleep(0.3)
        self.state = "FORWARD"

# 使用示例
rc = RobotController()
while True:
    rc.update()

这种结构化的写法，不仅代码清晰，而且方便以后增加新的功能，比如加入“遇障碍后退”的状态。

PID 控制（简化版）

对于想要挑战高难度的小朋友，可以尝试简单的 PID。

  • P（比例）：误差越大，修正力度越大。
  • D（微分）：误差变化越快，预判并提前修正，防止超调。

虽然 PID 需要调参，但你可以先理解：不要只看现在错多少，还要看变化趋势。

第六章：实战项目——智能搬运工

我们来做一个完整的项目：机器人识别三种颜色的球，并将它们运送到指定的区域。

项目需求

  1. 感知：使用颜色传感器（TCS3200 或类似模块）识别红、绿、蓝球。
  2. 执行：使用舵机控制的机械臂或翻转托盘来放下球。
  3. 逻辑：
    • 前进寻找颜色。
    • 识别颜色后停止。
    • 根据颜色移动到对应区域。
    • 放下球。
    • 返回起点。

核心代码框架

import time
from machine import Pin, PWM, ADC
import utime

# 初始化硬件
color_sensor = ADC(26)  # 假设颜色传感器接在 26 号引脚
servo = PWM(Pin(13))
servo.freq(50)

def read_color():
    """读取颜色值，返回 ('RED', 'GREEN', 'BLUE') 或 None"""
    val = color_sensor.read()
    if val > 2000:
        return 'RED'
    elif val > 1000:
        return 'GREEN'
    else:
        return 'BLUE'

def drop_ball(color):
    """根据颜色放下球"""
    if color == 'RED':
        servo.duty_u16(2000)  # 红色区角度
    elif color == 'GREEN':
        servo.duty_u16(4000)  # 绿色区角度
    else:
        servo.duty_u16(6000)  # 蓝色区角度
    time.sleep(1)
    servo.duty_u16(3000)  # 回中位

def search_and_sort():
    while True:
        color = read_color()
        if color:
            print(f"Detected: {color}")
            stop()
            # 移动到目标位置（这里需要结合里程计或时间控制）
            move_to_target(color)
            drop_ball(color)
            return_to_start()
            break

def move_to_target(color):
    # 简单的执行器逻辑
    if color == 'RED':
        forward(50)
        time.sleep(2)
    # ... 其他颜色
    
def return_to_start():
    # 原路返回
    backward(50)
    time.sleep(2)
    turn_left(90)
    time.sleep(1)
    forward(50)
    time.sleep(1)

if __name__ == "__main__":
    print("Sorting Robot Started")
    search_and_sort()

第七章：避坑指南——那些没人告诉你的事

作为过来人，我得给你透露几个实战中的“坑”：

  1. 电源干扰：电机启动时电流很大，会导致主控板电压跌落，造成重启或传感器误读。解决方案：给主控板和电机供电分开（如果硬件支持），或者在电源端并联大电容。
  2. 轮子打滑：地面太光滑（如瓷砖），轮子空转，里程计不准。解决方案：在轮子上缠一圈橡胶圈，或者使用更粗糙的地面进行测试。
  3. 红外干扰：阳光中含有大量红外线，会干扰巡线传感器。解决方案：在传感器上加遮光罩，或者改用超声波/视觉方案。
  4. 代码死循环：MicroPython 中如果 while True 里没有 sleep 或阻塞操作，CPU 会占用过高，导致其他任务无法运行。解决方案：每个循环里至少加 time.sleep_ms(10)。

结语：开始你的探索之旅

乐探机器人不仅仅是一个玩具，它是你通往机器人学、嵌入式开发、人工智能世界的钥匙。从最简单的“前进后退”，到复杂的“视觉识别+路径规划”，每一步都是你能力的提升。

不要害怕报错，每一个 Error 都是学习的机会。不要害怕改动硬件，拆拆装装才是工程师的日常。

现在，插上电源，打开 Thonny，写下你的第一行代码吧。世界在等着你的机器人去探索。

附录：推荐学习资源

  • MicroPython 官方文档：最权威的参考，虽然有点干，但查函数必备。
  • 乐探官方 Wiki：针对特定型号的引脚定义和示例代码。
  • GitHub 上的开源项目：搜索 mBot 或 MicroPython Robot，看看别人是怎么做的，借鉴思路。

希望这篇指南能帮你顺利入门！如果有任何具体的技术问题，欢迎随时交流。