用CircuitPython与BLE为乐高机器人实现蓝牙遥控改造

1. 项目概述：为经典乐高机器人注入蓝牙“灵魂”

如果你和我一样，是个对老式电子玩具和嵌入式开发都抱有浓厚兴趣的“技术考古学家”，那么手边很可能躺着一套尘封已久的乐高Mindstorms Droid Developer Kit。这套诞生于1999年的套件，其核心“大脑”是一个名为Micro Scout的简易可编程砖块。它功能简单，仅通过一个可见光链路协议进行通信，在当年看来很酷，但以今天的标准，其交互方式已显笨拙。这个项目的核心目标，就是利用现代、易得的开源硬件和软件，为这个经典玩具搭建一座通往智能时代的桥梁——一个基于蓝牙低功耗的无线遥控系统。

整个系统的技术栈非常清晰：我们使用Adafruit的Feather M0 Bluefruit LE作为主控，它集成了微控制器和蓝牙模块，小巧且自带电池管理；编程语言则选用CircuitPython，以其对硬件友好的高级API和交互式开发环境，让嵌入式开发变得像写脚本一样简单。最关键的一步，是让Feather板模拟Micro Scout能理解的“光语言”，即VLL协议，从而实现对乐高机器人电机和蜂鸣器的无线控制。最终，你只需在手机或平板上使用Adafruit Bluefruit LE Connect应用，就能像玩遥控车一样操控你的乐高机器人。这不仅是一次硬件改造，更是一次对经典协议的软件逆向与重现，整个过程充满了工程实现的乐趣。

2. 核心硬件选型与原理剖析

2.1 主控板：为何是Feather M0 Bluefruit LE？

在众多开发板中，选择Adafruit Feather M0 Bluefruit LE并非偶然，而是基于几个关键考量。首先，集成度是关键。这块板子本质上是一个Feather M0 Basic Proto与一个Bluefruit LE SPI Friend模块的合体。这意味着我们无需再额外连接复杂的蓝牙模块，也省去了焊接SPI接口的麻烦，所有无线通信功能都已就绪，开箱即用。

其次，供电与便携性。Feather系列设计之初就考虑了移动应用，板载的LiPo电池充电管理芯片（如MCP73831）允许我们直接连接一块3.7V的锂电池，并通过USB口为其充电。对于需要移动的机器人项目，这种一体化的电源解决方案比外接电池盒或移动电源要优雅和可靠得多。最后是CircuitPython的完美支持。Adafruit官方为Feather M0系列提供了稳定的CircuitPython固件，并且其丰富的GPIO引脚（包括本项目用到的D4、D6、D7、D8）都能在CircuitPython中通过board模块轻松调用，极大简化了开发流程。

注意：这里有一个容易踩坑的细节。Feather M0 Bluefruit LE在CircuitPython固件选择上，必须使用“Feather M0 Adalogger”版本的UF2文件。这是因为只有这个变体固件正确定义了board.D8引脚，而我们的代码需要用它来控制蓝牙模块的片选信号。如果刷错了其他版本（如通用的Feather M0 Express），代码将无法找到D8引脚而报错。

2.2 通信协议逆向：理解VLL光脉冲语言

乐高Micro Scout砖通过一个光传感器接收指令，这套指令体系被称为Visible Light Link协议。它不是简单的摩尔斯电码，而是一种定义好的数字通信协议。经过社区开发者（如Jorge Pereira）的逆向工程，我们得知其基本帧结构如下：

1. 初始化脉冲：一个长达400ms的高电平光信号，用于唤醒或同步接收端。
2. 起始位：一个短暂的低电平间隔。
3. 数据位：每个数据位由“高电平时间+低电平时间”的组合来表示。通常，1用20ms高电平+40ms低电平表示，0用40ms高电平+20ms低电平表示。这种不对称的占空比有助于接收端区分比特。
4. 停止位：以特定的高低电平序列结束一帧传输。

一个完整的命令由7位数据位和3位校验位组成，共10位。校验算法是固定的，确保了传输的可靠性。在我们的代码中，vll1()和vll0()函数就是精确生成这两种脉冲波形的关键。理解这一点至关重要，因为任何时序上的偏差都可能导致Micro Scout无法解析指令。在调试时，如果机器人无反应，第一个要怀疑的就是LED发出的光脉冲时序是否准确。

2.3 外围电路：LED与电阻的考量

协议要求一个可控的光源。虽然Feather板载的红色用户LED在暗光环境下勉强可用，但其亮度和方向性难以保证稳定通信。因此，外接一个高亮度的LED是更稳妥的方案。我选择了一颗5mm的白色窄光束LED，其亮度高，指向性强，更容易被Micro Scout的光传感器“看到”。

这里涉及一个基础但重要的电路知识：限流电阻。微控制器GPIO引脚（如D6）的输出电压通常是3.3V，而LED的工作电压一般在1.8V-3.3V之间，工作电流约为20mA。如果不加电阻直接连接，过大的电流会损坏LED甚至微控制器引脚。根据欧姆定律R = (Vcc - V_led) / I_led，假设Vcc=3.3V，V_led=2.0V，I_led=0.02A，计算得出R=(3.3-2.0)/0.02=65Ω。我们选用常见的330Ω电阻，实际电流约为(3.3-2.0)/330≈4mA，这个电流对于通信来说足够亮，且更为安全，能显著延长LED和板子的寿命。

3. 软件环境搭建与代码深度解析

3.1 CircuitPython固件安装与避坑指南

为Feather M0 Bluefruit LE安装CircuitPython是第一步。访问CircuitPython官网，找到对应板子的页面，下载“Feather M0 Adalogger”的UF2文件。按住板子上的复位按钮，连接USB线，等待FEATHERBOOT盘符出现，然后将下载的.uf2文件拖入即可。完成后，盘符会变为CIRCUITPY。

实操心得：我遇到过CIRCUITPY盘符不出现的情况。这通常有两个原因：一是USB线仅能供电不能传输数据，务必换一根已知良好的数据线；二是旧版板子可能未预装UF2引导程序。如果双击复位键后出现的是FEATHERBOOT而非FEATHERBOOT，就需要先使用bossac命令行工具刷入UF2引导程序，这是一个稍显繁琐但一次性的步骤。安装成功后，打开CIRCUITPY盘符下的boot_out.txt文件，确认里面的CircuitPython版本号。

3.2 核心库的部署与作用

CircuitPython通过库文件扩展功能。我们需要两个库：

1. adafruit_bus_device：提供底层总线设备（如SPI、I2C）的抽象支持，是许多其他库的基础依赖。
2. adafruit_bluefruitspi：这是与Bluefruit LE SPI Friend模块通信的专用库，封装了通过SPI发送AT命令与蓝牙芯片交互的所有复杂细节。

安装方法很简单：从Adafruit的CircuitPython库合集页面下载与你的CircuitPython版本匹配的库包（例如，如果你运行的是7.x，就下载7.x的库包）。解压后，找到上述两个库的文件夹（通常是adafruit_bus_device和adafruit_bluefruitspi），将它们完整复制到CIRCUITPY盘符下的/lib目录中。如果/lib目录不存在，就新建一个。

提示：库的版本必须与CircuitPython固件版本大致匹配。使用过旧或过新的库可能导致无法导入或运行时错误。当代码出现ImportError时，首先检查库文件是否放对了位置，其次检查版本兼容性。

3.3 主控代码逐行解读与定制

项目的核心是code.py文件。我们将其复制到CIRCUITPY盘符的根目录，CircuitPython会自动运行它。

import time import board import busio from digitalio import DigitalInOut, Direction from adafruit_bluefruitspi import BluefruitSPI

导入必要的模块：time用于控制延时；board定义了板子特有的引脚；busio用于硬件通信协议；digitalio用于控制数字输入输出；最后是蓝牙SPI库。

spi_bus = busio.SPI(board.SCK, MOSI=board.MOSI, MISO=board.MISO) cs = DigitalInOut(board.D8) irq = DigitalInOut(board.D7) rst = DigitalInOut(board.D4) bluefruit = BluefruitSPI(spi_bus, cs, irq, rst, debug=False)

初始化SPI总线和蓝牙模块的控制引脚。cs是片选，irq是中断请求，rst是复位。debug=False关闭调试信息，使输出更简洁。

boardled = DigitalInOut(board.D6) boardled.direction = Direction.OUTPUT

将D6引脚设置为输出，用于控制外接的LED。如果你想在初期测试时使用板载红色LED，可以将board.D6替换为board.D13。

VLL协议函数群：vll1(),vll0(),vllinit(),vllstart(),vllstop()这几个函数严格遵循了之前分析的协议时序，通过精确的time.sleep()调用来控制LED亮灭的时间，组合成不同的光脉冲。send(command)函数是协议组装器，它将命令码和计算出的校验位组合成一个10位的帧，然后循环调用vll1或vll0逐位发送出去。

蓝牙连接与命令解析循环：这是代码的主逻辑。init_bluefruit()函数会初始化蓝牙模块，并执行工厂重置以确保状态干净，同时将设备广播名称设置为BlueMicroScout，方便我们在手机App上识别。主循环是一个while True，内部嵌套了连接管理try...except块。一旦蓝牙连接建立，程序便持续检查是否有数据包从手机App传来。

当按下App上的按钮时，手机会通过BLE UART服务发送一个数据包。代码解析这个包，如果是以'B'开头的按钮包，并且是按下事件（button_down为真），则根据按钮编号映射到对应的乐高命令（前进、后退、停止、蜂鸣），并通过send()函数发送出去。

一个关键的调试技巧：代码中使用了check_connection函数来缓存连接状态，每3秒才真正查询一次模块。这是因为频繁通过SPI查询蓝牙连接状态会占用大量资源，可能干扰光脉冲时序。如果你的项目出现控制响应迟缓或光脉冲紊乱，可以尝试调整这个时间间隔。

4. 系统集成、组装与实战调试

4.1 硬件连接与安全组装

按照电路图，将LED的长脚（阳极）通过330Ω电阻连接到Feather的D6引脚，短脚（阴极）连接到GND。对于快速原型，可以像原文那样，将电阻引脚和LED引脚绞合在一起，并将末端弯折成双股以增加在板子插孔里的摩擦力。但我强烈建议，只要条件允许，尽量进行焊接。一个松动的连接在机器人运动时极易脱落，导致控制失灵，而且裸露的线头可能碰到其他引脚造成短路。

警告：这是一个必须严格遵守的安全事项！在将导线插入Feather的插孔或进行焊接时，务必确保裸露的金属部分不会触碰到背面的其他焊盘或元件。最好使用绝缘胶带或热缩管对焊接点进行绝缘处理。短路可能瞬间损坏你的Feather主板。

4.2 供电方案与电池极性纠错

本项目使用3.7V的LiPo电池供电。Adafruit推荐的400mAh电池是理想选择，其JST PH接头极性是正确的。但市场上很多第三方电池的线序可能是反的（红黑线对调）。在连接任何电池前，请务必用万用表确认极性！将电池接反是烧毁板载充电芯片的最快途径。如果电池极性不对，需要小心地用小镊子或挑针将接头内的金属端子顶出，交换位置后再重新插入。操作时一定要确保工具绝缘，且电池两极不会同时被短路。

4.3 机械固定与光路对准

如何将Feather板固定在乐高机器人上？这考验你的手工创意。可以使用乐高积木和橡皮筋搭建一个支架，也可以3D打印一个定制外壳。最简单的方法如原文所述，使用两条绝缘胶带。无论哪种方式，核心原则是稳固和可维护。要确保在机器人运动时板子不会掉落，同时也要方便你拔插USB线进行调试。

成败关键一步：光路对准。LED必须正对着Micro Scout砖上的光传感器（那个黑色的小窗口）。在光线强烈的室内，环境光可能会淹没LED的脉冲信号。我的经验是，用一个用黑纸卷成的细长筒套在LED上，做成一个简易的“遮光罩”，能显著提高通信可靠性。你也可以尝试用乐高积木搭建一个黑暗的通道来连接LED和传感器。

4.4 使用Bluefruit LE Connect App进行控制

在手机应用商店搜索并安装“Adafruit Bluefruit LE Connect”。打开应用，授予蓝牙权限，刷新设备列表，你应该能看到名为“BlueMicroScout”的设备。点击连接。

进入“Controller”界面，你会看到一个方向键和多个按钮。默认的按键映射是：上方向键发送BUTTON_UP，对应机器人后退；下方向键发送BUTTON_DOWN，对应机器人前进；按钮1发送BUTTON_1，对应蜂鸣。这个映射关系可以在代码的if button_down:部分轻松修改。

实测调试：首先，确保Micro Scout砖已装入电池，并按下“Select”按钮，将模式切换到“P”（Program）模式，此时会听到一声蜂鸣。然后启动你的Feather板。在App中连接并尝试按下按钮。如果机器人没有反应，请按以下步骤排查：

1. 检查电源：Feather板上的红色LED是否亮起？电池电量是否充足？
2. 检查连接：App是否显示已连接？串行监视器（如Mu编辑器）是否有接收到数据包的打印信息？
3. 检查光路：在暗处观察，按下按钮时，外接LED是否在快速闪烁？如果没有，检查D6引脚的连接。
4. 检查模式：确认Micro Scout确实在P模式。

5. 常见问题排查与进阶玩法

5.1 故障排除速查表

5.2 项目扩展与创意改造

基础功能实现后，这个项目可以成为更多创意的起点：

1. 增加传感器，实现半自主行为：为Feather连接一个加速度计（如ADXL343）。你可以编写代码，让机器人在碰撞到障碍物（通过加速度突变检测）后，自动执行“后退-转向”的避障 routine，将遥控升级为半自主驾驶。
2. 扩展执行器：Feather M0还有多余的GPIO和模拟输入。你可以通过伺服电机扩展板控制额外的伺服电机，让机器人的头部可以左右转动，或者增加一个可升降的“手臂”。
3. 自定义控制器界面：Adafruit Bluefruit LE Connect App的“Controller”面板是通用的。你可以使用它的“UART”模式，或者更好的是，利用MIT App Inventor或Swift/ Kotlin开发一个专属的控制App，设计更酷的界面，并发送更复杂的指令序列（如编队舞蹈）。
4. 协议扩展：目前的代码只实现了Micro Scout的部分命令。深入研究VLL协议文档，你可以发现它还支持设置电机功率、读取光传感器值等功能。尝试实现这些，让你的控制更加精细化。
5. 更换主控平台：如果你手头有Raspberry Pi Pico W，同样可以运行CircuitPython并连接蓝牙模块。或者使用支持Arduino的ESP32，利用其内置的蓝牙功能，整个系统的成本和体积可以进一步优化。

这个项目的魅力在于，它完美地展示了如何用现代的开源工具链，去理解和“对话”一个二十多年前的封闭系统。当你按下手机屏幕，看到古老的乐高机器人应声而动时，那种跨越时间的工程乐趣，正是嵌入式开发最吸引人的地方。