1. 项目缘起：当“行空板”遇上“麦昆Plus”

最近在折腾一个给小朋友的编程教育项目，手头正好有一块行空板和一辆麦昆Plus小车。行空板是啥？简单说，它是一块为编程教育设计的、功能强大的单板计算机，自带屏幕、按键、传感器和Wi-Fi，用Python编程特别方便。而麦昆Plus，则是DFRobot出品的一款经典的可编程小车底盘，集成了电机、巡线传感器、超声波模块等，是很多创客和学生的入门神器。

我就在想，如果把这两者结合起来，会碰撞出什么火花？行空板作为“大脑”，麦昆Plus作为“身体”，这组合简直是为STEAM教育和创客项目量身定做的。它不再是一个简单的遥控车，而是一个可以跑Python代码、能感知环境、能联网、还能在屏幕上实时显示信息的智能移动平台。无论是做巡线、避障、视觉识别，还是物联网小车，这个组合都能轻松胜任。今天，我就来详细拆解一下这个组合的玩法，从硬件连接到软件编程，再到几个经典项目的实战，希望能给同样在探索创客教育和智能硬件的朋友们一些参考。

2. 硬件连接：让大脑与身体“握手”

要让行空板控制麦昆Plus，第一步就是建立物理连接。这个过程看似简单，但有几个关键点决定了后续编程的便利性和稳定性。

2.1 接口选择与引脚定义

麦昆Plus的控制核心是它的主控板，通常通过I2C接口与扩展设备通信。而行空板提供了丰富的GPIO引脚，其中就包含I2C接口。最直接的连接方式是使用杜邦线。

连接步骤如下：

1. 确认引脚：找到行空板上的I2C引脚。以常见的行空板型号为例，其I2C0接口通常对应SDA(数据线) 和SCL(时钟线) 两个引脚。具体引脚号需要查阅你所使用的行空板官方文档，例如可能是GPIO21 (SDA)和GPIO22 (SCL)。
2. 连接电源与地线：除了数据线，必须连接电源 (VCC, 通常是3.3V或5V) 和地线 (GND)。行空板的3.3V和5V引脚都可以为麦昆Plus的主控板供电，但需要注意电流需求。如果只是驱动主控板逻辑部分，3.3V足够；如果还需要为外接传感器供电，建议使用5V引脚。同时，务必将两块板子的GND连接在一起，这是保证信号稳定的基础。
3. 连接I2C线：将行空板的SDA引脚连接到麦昆Plus主控板的SDA引脚，SCL连接到SCL。

注意：在连接前，务必确保行空板和麦昆Plus都处于断电状态。带电插拔杜邦线是损坏电子元件的常见原因。

连接完成后，你的硬件架构就变成了：行空板作为主设备 (Master)，通过I2C总线向作为从设备 (Slave) 的麦昆Plus主控板发送指令，从而控制小车的电机、读取传感器数据。

2.2 供电方案考量

供电是另一个需要仔细考虑的问题。麦昆Plus小车本身有电池盒，可以为其主控板和电机供电。而行空板通常也需要独立的USB供电或电池供电。

这里有几种方案：

• 方案A：独立供电（推荐初试）：麦昆Plus使用自带的电池（如4节AA电池），行空板通过USB线连接电脑或移动电源供电。两者仅通过信号线（SDA, SCL）和共地线（GND）连接。这种方案最简单，隔离了电机大电流对行空板的干扰，调试阶段最安全。
• 方案B：行空板为麦昆主控板供电：断开麦昆Plus的电池，将行空板的5V和GND输出连接到麦昆Plus主控板的VCC和GND。这样，行空板的电源同时为两块板子的逻辑部分供电。但要注意：行空板的5V输出电流有限（通常500mA-1A左右），绝对不足以直接驱动麦昆Plus的两个直流电机。电机必须仍然由麦昆Plus自身的电机驱动电路和电池供电。此方案仅适用于简化布线，且需确保电机电源地与行空板电源地共地。
• 方案C：统一电池供电：如果你想做一个完全无线、一体的移动平台，可以考虑使用一块大容量的锂电池（如7.4V 2S锂电）通过降压模块分别给行空板（降至5V）和麦昆Plus电机驱动供电。这涉及到电源管理，复杂度较高，适合进阶项目。

对于大多数入门和中级应用，方案A（独立供电）是最稳妥的选择。它避免了复杂的电源噪声和电流不足问题，让你可以专注于逻辑和代码的调试。

3. 软件环境搭建与驱动库安装

硬件连通后，我们需要在行空板上配置软件环境，并安装控制麦昆Plus所需的Python库。

3.1 行空板基础环境

行空板通常预装了基于Linux的操作系统（如Debian）和Python环境。你需要通过SSH或者行空板自带的Web IDE（如果支持）连接到行空板。我更喜欢用SSH，在电脑终端用ssh pi@行空板IP地址命令连接（默认用户密码请查阅行空板说明书），这样操作更灵活。

连接后，首先更新一下软件包列表并确保Python3和pip已安装：

sudo apt update sudo apt upgrade -y sudo apt install python3-pip -y

3.2 安装麦昆Plus的Python控制库

DFRobot为麦昆系列提供了官方的Python库，例如pymakr或dfrobot_micropython的某个子模块。但更通用、更底层的方式是直接使用smbus2或python-periphery这类库来操作I2C，因为麦昆Plus的主控板本质是一个I2C从设备，遵循特定的指令协议。

不过，为了快速上手，我们可以寻找或编写一个简单的驱动类。假设我们通过查阅资料，得知麦昆Plus的I2C地址是0x10，并且知道控制电机和读取传感器的基本指令格式。

我们可以创建一个名为maqueen_plus.py的驱动文件：

import smbus2 import time class MaQueenPlus: def __init__(self, bus=1, address=0x10): """ 初始化麦昆Plus :param bus: I2C总线编号，行空板通常是1 :param address: 麦昆Plus的I2C地址，默认0x10 """ self.bus = smbus2.SMBus(bus) self.addr = address def set_motor(self, motor, speed): """ 设置单个电机速度 :param motor: 0-左电机， 1-右电机 :param speed: -255 ~ 255，负值为反转 """ if motor not in [0, 1]: raise ValueError("Motor must be 0 (left) or 1 (right)") if speed < -255 or speed > 255: speed = max(-255, min(255, speed)) # 限幅 direction = 0x02 if speed >= 0 else 0x01 speed_abs = abs(speed) # 假设指令格式： [指令头, 电机编号, 方向, 速度值] cmd = [0x00, motor, direction, speed_abs] try: self.bus.write_i2c_block_data(self.addr, 0x00, cmd) except Exception as e: print(f"写入电机指令失败: {e}") def move(self, left_speed, right_speed): """同时控制左右电机""" self.set_motor(0, left_speed) self.set_motor(1, right_speed) def stop(self): """停止所有电机""" self.move(0, 0) def get_distance(self): """读取超声波测距值 (单位: cm)，假设指令为0x01""" try: self.bus.write_byte_data(self.addr, 0x00, 0x01) time.sleep(0.05) # 等待测量 data = self.bus.read_i2c_block_data(self.addr, 0x00, 2) distance = (data[0] << 8) + data[1] return distance except Exception as e: print(f"读取距离失败: {e}") return -1 # 可以继续添加读取巡线传感器、RGB灯控制等方法

这个类封装了基本的控制功能。你需要将它上传到行空板上。使用scp命令或Web IDE的文件上传功能都可以。

然后，在行空板上安装smbus2库：

pip3 install smbus2

实操心得：在实际操作中，麦昆Plus的确切I2C指令集可能需要查阅其官方文档或源码。上述代码中的指令格式（[0x00, motor, direction, speed_abs]）是一个示例，务必替换为你设备真实的协议。一个更可靠的方法是找到DFRobot官方提供的MicroPython或Python库，并适配到行空板的Linux环境。如果官方库是给MicroPython的，你可能需要参考其通信逻辑，用smbus2重新实现。

4. 基础控制实战：让小车动起来

环境准备好后，我们来写第一个测试程序，验证控制是否成功。

创建一个test_car.py文件：

#!/usr/bin/env python3 import time from maqueen_plus import MaQueenPlus def main(): car = MaQueenPlus() # 使用默认I2C总线1和地址0x10 print("向前行驶2秒") car.move(150, 150) # 左右电机同速正转 time.sleep(2) print("原地左转1.5秒") car.move(-150, 150) # 左电机反转，右电机正转 time.sleep(1.5) print("向右弧线行驶2秒") car.move(100, 200) # 右电机速度更快，向右转 time.sleep(2) print("停止") car.stop() # 测试超声波 print("测量距离...") for i in range(5): dist = car.get_distance() print(f" 第{i+1}次测量: {dist} cm") time.sleep(0.5) if __name__ == "__main__": main()

运行这个脚本：

python3 test_car.py

如果小车能按照指令运动，并且超声波传感器能返回距离值（注意前方要有物体），那么恭喜你，最基础的通信和控制链路已经打通了！这是所有高级项目的基础。

常见问题排查：

• 小车不动：
  • 检查电源：确保麦昆Plus电池有电，开关已打开。
  • 检查接线：确认SDA、SCL、VCC、GND四根线连接牢固且正确。特别是GND，必须连接。
  • 检查I2C地址：使用i2cdetect -y 1命令（在行空板终端运行）扫描I2C总线，看看是否能找到0x10或其他地址的设备。如果找不到，说明物理连接或设备地址不对。
  • 检查指令协议：最大的可能是驱动类MaqueenPlus中的指令格式与你的麦昆Plus主控板不匹配。这是最需要根据实际设备调整的地方。
• 超声波读数一直是-1或固定值：
  • 可能是读取数据的指令码不对，或者需要更长的延时 (time.sleep) 等待测量完成。
  • 检查超声波传感器是否完好，有无遮挡。

5. 进阶项目一：自动避障巡逻车

基础控制没问题后，我们可以实现更智能的行为。第一个经典项目就是避障小车。逻辑很简单：不断测量前方距离，如果距离小于安全阈值（比如20厘米），就后退、转弯，然后继续前进。

创建avoid_obstacle.py：

#!/usr/bin/env python3 import time from maqueen_plus import MaQueenPlus class ObstacleAvoider: def __init__(self, safe_distance_cm=20): self.car = MaQueenPlus() self.safe_dist = safe_distance_cm self.running = True def avoid(self): """主避障循环""" print("避障程序启动，按 Ctrl+C 停止。") try: while self.running: dist = self.car.get_distance() print(f"前方距离: {dist} cm", end='\r') if 0 < dist < self.safe_dist: # 检测到障碍物 print(f"\n障碍物太近 ({dist} cm < {self.safe_dist} cm)，执行避障动作。") # 1. 停车 self.car.stop() time.sleep(0.2) # 2. 后退一小段 self.car.move(-180, -180) time.sleep(0.5) self.car.stop() time.sleep(0.2) # 3. 随机左转或右转 import random if random.choice([True, False]): print(" 向左转") self.car.move(-200, 200) # 原地左转 else: print(" 向右转") self.car.move(200, -200) # 原地右转 time.sleep(0.8) # 转弯时长 self.car.stop() time.sleep(0.3) print(" 继续前进") else: # 安全，继续前进 self.car.move(180, 175) # 略微调整左右速度，让小车走直线 time.sleep(0.1) # 主循环延时 except KeyboardInterrupt: print("\n程序被用户中断。") finally: self.car.stop() print("小车已停止。") if __name__ == "__main__": robot = ObstacleAvoider(safe_distance_cm=25) # 设置安全距离为25cm robot.avoid()

这个程序实现了一个基本的避障逻辑。你可以调整safe_distance_cm、后退速度、转弯速度和转弯时间来改变小车的“性格”，是激进还是保守。

经验技巧：在实际测试中，我发现超声波传感器在近距离、小角度斜面物体检测上可能会失灵或跳变。为了提高鲁棒性，可以引入“滤波”机制。例如，连续读取3次距离，取中位数作为最终值，或者要求连续两次检测到障碍物才触发避障动作，这样可以有效避免因单次误测导致的“抽搐”行为。

6. 进阶项目二：图形化遥控与状态显示

行空板的优势在于它有屏幕！我们可以利用这个屏幕，结合板载按键或触摸屏（如果支持），做一个简单的图形化遥控器，并实时显示小车传感器数据。

这里我们需要用到行空板的图形库，比如Pygame或tkinter。以Pygame为例，首先安装它：

sudo apt install python3-pygame

然后创建一个remote_control.py的程序。这个程序会做以下几件事：

1. 初始化Pygame窗口，绘制UI（方向按钮、速度条、状态显示区）。
2. 将行空板的物理按键（如A、B键）或屏幕触摸事件映射为控制指令（前进、后退、左转、右转、停止）。
3. 在屏幕上实时显示从麦昆Plus读取回来的数据，如超声波距离、电池电压（如果麦昆Plus支持回传）等。
4. 通过一个循环，将控制指令通过I2C发送给小车，并不断读取传感器数据更新UI。

由于代码较长，这里给出核心逻辑框架：

import pygame import sys from maqueen_plus import MaQueenPlus import threading import time # 初始化Pygame和屏幕 pygame.init() screen = pygame.display.set_mode((320, 240)) pygame.display.set_caption("行空板-麦昆Plus遥控器") clock = pygame.time.Clock() car = MaQueenPlus() current_speed = [0, 0] # [left_speed, right_speed] sensor_data = {"distance": 0} def control_thread(): """独立的控制线程，负责定时发送电机指令""" while True: car.move(current_speed[0], current_speed[1]) time.sleep(0.05) # 20Hz控制频率 def sensor_thread(): """独立的传感器读取线程""" while True: sensor_data["distance"] = car.get_distance() time.sleep(0.2) # 5Hz更新频率 # 启动线程 # threading.Thread(target=control_thread, daemon=True).start() # threading.Thread(target=sensor_thread, daemon=True).start() # 主循环：处理事件、绘制UI running = True while running: for event in pygame.event.get(): if event.type == pygame.QUIT: running = False elif event.type == pygame.KEYDOWN: # 映射行空板按键，例如K_UP, K_DOWN等 if event.key == pygame.K_UP: current_speed = [200, 200] elif event.key == pygame.K_DOWN: current_speed = [-150, -150] elif event.key == pygame.K_LEFT: current_speed = [-180, 180] elif event.key == pygame.K_RIGHT: current_speed = [180, -180] elif event.type == pygame.KEYUP: # 松开按键时停止 if event.key in [pygame.K_UP, pygame.K_DOWN, pygame.K_LEFT, pygame.K_RIGHT]: current_speed = [0, 0] # 绘制UI背景 screen.fill((50, 50, 50)) # 绘制方向按钮（用矩形模拟） # 显示传感器数据 font = pygame.font.SysFont(None, 24) dist_text = font.render(f"距离: {sensor_data['distance']} cm", True, (255, 255, 255)) screen.blit(dist_text, (10, 200)) pygame.display.flip() clock.tick(30) car.stop() pygame.quit() sys.exit()

这个框架展示了如何将图形界面与控制逻辑结合。你可以在此基础上丰富UI，比如添加滑块控制速度，用不同颜色显示距离危险程度等。

踩坑实录：在多线程编程中，直接在主线程和子线程中同时读写current_speed和sensor_data可能引发资源竞争。虽然这个简单例子问题不大，但在更复杂的控制中，建议使用threading.Lock来保护这些共享变量，或者使用线程安全的队列 (queue.Queue) 来传递指令和数据。

7. 网络功能拓展：打造物联网智能小车

行空板自带Wi-Fi，这是它区别于普通单片机开发板的巨大优势。我们可以让小车连接到局域网甚至互联网，实现远程控制、数据上传和智能联动。

7.1 搭建简易Web遥控服务器

我们可以用Python的轻量级Web框架（如Flask或Bottle）在行空板上快速搭建一个Web服务器。这样，同一网络下的任何设备（手机、电脑）通过浏览器就能遥控小车。

首先安装Flask：

pip3 install flask

然后创建web_control.py：

#!/usr/bin/env python3 from flask import Flask, render_template_string, request, jsonify import threading from maqueen_plus import MaQueenPlus app = Flask(__name__) car = MaQueenPlus() # 一个简单的HTML遥控界面 HTML = ''' <!DOCTYPE html> <html> <head><title>麦昆Plus Web遥控</title> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <style> body {text-align:center; font-family: sans-serif;} .control {margin:20px;} button {font-size:24px; padding:15px 30px; margin:5px;} #status {margin-top:20px; padding:10px; background:#eee;} </style> </head> <body> <h1>行空板-麦昆Plus Web遥控器</h1> <div class="control"> <div><button onmousedown="sendCmd('forward')" ontouchstart="sendCmd('forward')" onmouseup="sendCmd('stop')" ontouchend="sendCmd('stop')">前进</button></div> <div> <button onmousedown="sendCmd('left')" ontouchstart="sendCmd('left')" onmouseup="sendCmd('stop')" ontouchend="sendCmd('stop')">左转</button> <button onmousedown="sendCmd('stop')">停止</button> <button onmousedown="sendCmd('right')" ontouchstart="sendCmd('right')" onmouseup="sendCmd('stop')" ontouchend="sendCmd('stop')">右转</button> </div> <div><button onmousedown="sendCmd('backward')" ontouchstart="sendCmd('backward')" onmouseup="sendCmd('stop')" ontouchend="sendCmd('stop')">后退</button></div> </div> <div id="status">状态: 就绪</div> <script> function sendCmd(cmd) { fetch('/cmd/' + cmd) .then(response => response.json()) .then(data => { document.getElementById('status').innerHTML = '状态: ' + data.status + ' 距离: ' + (data.distance || 'N/A') + ' cm'; }); } // 定期获取传感器数据 setInterval(()=>{ fetch('/sensor').then(r=>r.json()).then(d=>{ document.getElementById('status').innerHTML = '状态: 就绪 距离: ' + (d.distance || 'N/A') + ' cm'; })}, 500); </script> </body> </html> ''' @app.route('/') def index(): return render_template_string(HTML) @app.route('/cmd/<command>') def control(command): speed = 200 if command == 'forward': car.move(speed, speed) status = '前进中' elif command == 'backward': car.move(-speed, -speed) status = '后退中' elif command == 'left': car.move(-speed, speed) status = '左转中' elif command == 'right': car.move(speed, -speed) status = '右转中' elif command == 'stop': car.stop() status = '已停止' else: status = '未知指令' distance = car.get_distance() return jsonify({'status': status, 'distance': distance}) @app.route('/sensor') def get_sensor(): distance = car.get_distance() return jsonify({'distance': distance}) if __name__ == '__main__': # 获取行空板IP，以便知道访问地址 import socket hostname = socket.gethostname() local_ip = socket.gethostbyname(hostname) print(f" * 服务器启动，请在浏览器访问: http://{local_ip}:5000") # 注意：在行空板上运行，可能需要指定host='0.0.0.0'以允许外部访问 app.run(host='0.0.0.0', port=5000, debug=False, threaded=True)

运行这个脚本后，在行空板终端会打印出IP地址。用同一Wi-Fi下的手机或电脑浏览器打开http://[行空板IP]:5000，就能看到一个简单的网页遥控器了。按下按钮小车就会运动，松开或点击停止按钮就会停下，页面还会自动刷新显示超声波测距数据。

7.2 接入物联网平台

更进一步，我们可以将小车传感器数据上报到物联网平台（如阿里云IoT、ThingsBoard等），或者接收来自云平台的指令。这里以使用MQTT协议为例，这是一个在物联网中非常流行的轻量级消息协议。

首先安装MQTT客户端库：

pip3 install paho-mqtt

然后，你可以编写一个mqtt_client.py脚本，订阅一个主题（如car/control）来接收控制指令，同时向另一个主题（如car/sensor/distance）发布超声波数据。

import paho.mqtt.client as mqtt import json import time from maqueen_plus import MaQueenPlus car = MaQueenPlus() BROKER = "你的MQTT服务器地址" # 例如 test.mosquitto.org PORT = 1883 CLIENT_ID = "xingkong_maqueen" TOPIC_CONTROL = "car/control" TOPIC_SENSOR = "car/sensor" def on_connect(client, userdata, flags, rc): print(f"连接到MQTT Broker， 返回码: {rc}") client.subscribe(TOPIC_CONTROL) def on_message(client, userdata, msg): payload = msg.payload.decode() print(f"收到指令: {payload}") try: cmd = json.loads(payload) if cmd['action'] == 'move': car.move(cmd['left'], cmd['right']) elif cmd['action'] == 'stop': car.stop() except Exception as e: print(f"解析指令失败: {e}") client = mqtt.Client(CLIENT_ID) client.on_connect = on_connect client.on_message = on_message client.connect(BROKER, PORT, 60) client.loop_start() # 启动网络循环线程 print("MQTT客户端已启动，等待指令...") try: while True: # 定期发布传感器数据 distance = car.get_distance() sensor_msg = json.dumps({"distance_cm": distance}) client.publish(TOPIC_SENSOR, sensor_msg) time.sleep(2) # 每2秒发布一次 except KeyboardInterrupt: print("程序退出") finally: car.stop() client.loop_stop() client.disconnect()

这样，你就可以通过任何MQTT客户端（手机APP、电脑软件）向car/control主题发送如{"action": "move", "left": 200, "right": 200}的JSON消息来控制小车前进，同时可以在car/sensor主题实时接收距离数据。这就实现了基本的物联网遥控与监控。

8. 项目优化与扩展思路

“行空板+麦昆Plus”的组合潜力远不止于此。以下是一些可以继续深入探索的方向：

• 视觉能力加持：行空板有USB接口，可以连接摄像头。使用OpenCV库，你可以让小车实现颜色追踪、人脸检测、二维码识别等功能。例如，让小车自动追踪一个红色的球，或者走到特定的视觉标记前停下。
• 多传感器融合：除了超声波，麦昆Plus还有巡线传感器。可以编写复杂的算法，让小车在避障的同时，还能沿着地上的黑线行走，实现更复杂的路径规划。
• 语音交互：利用行空板的音频输入输出，集成语音识别（如Snowboy、Vosk）和语音合成（pyttsx3）库，实现“前进”、“左转”等语音控制，让小车能“听”会说。
• 强化学习实验：对于高级玩家，可以尝试用行空板运行简单的强化学习算法（如Q-Learning），让小车在模拟或真实环境中自主学习避障策略。这虽然挑战大，但极具教育意义。
• 结构设计与3D打印：为这个组合设计并3D打印一个专属的上层结构，用来固定行空板、摄像头或其他传感器，让整个项目看起来更完整、更专业。

在整个项目搭建和调试过程中，最深的体会就是“软硬结合”的魅力。每一个硬件连接、每一行代码都直接对应着小车的真实动作。遇到的问题也从单纯的代码Bug，扩展到硬件兼容性、电源噪声、通信协议、实时性等多个层面。这种全方位的挑战和解决过程，正是创客精神和STEAM教育的核心所在。从让轮子转起来，到让它智能地跑起来，这个过程带来的成就感，是单纯软件或硬件项目无法比拟的。希望这篇长文能为你打开一扇门，剩下的精彩，就等你亲手去创造了。