1. 项目概述：从开箱到第一束光
收到一块虾米扩展板，对于玩惯了micro:bit原生开发板的我来说，总是件让人兴奋的事。这不仅仅意味着又多了一个可以折腾的硬件，更意味着能解锁更多传感器、执行器，甚至是更复杂的显示和交互方式。这次测评的开篇，我决定从最经典、也最富仪式感的“点灯”开始。为什么是点灯？因为它简单直接，是硬件世界的“Hello World”，能最快地验证板卡基础功能是否正常、开发环境是否就绪，同时也是理解GPIO控制、PWM调光等核心概念的绝佳入口。
这块虾米扩展板，顾名思义，是为micro:bit设计的拓展配件。它通常通过金手指或排针与micro:bit底部连接，将micro:bit有限的几个GPIO口扩展成更多、功能更专一的接口，比如专用的RGB LED灯珠接口、舵机接口、电机驱动接口，甚至是连接LED点阵屏的HUB75这类特殊接口。我手头这块板子，就赫然印着一个RGB LED的标识。所以，我们今天的目标很明确：让这个RGB LED听我们的话，发出我们想要颜色的光。这过程会涉及硬件连接、编程环境选择、代码编写，以及最重要的——对RGB色彩模型和PWM控制原理的理解。无论你是刚接触硬件编程的新手，还是想寻找一个稳定扩展方案的老玩家，这篇从开箱点灯开始的深度体验，或许都能给你带来一些实用的参考。
2. 硬件初探与核心思路解析
2.1 虾米扩展板硬件架构拆解
开箱第一件事，不是急着上电，而是仔细端详。这块虾米扩展板的布局相当清晰。中央是micro:bit的插槽，确保主板能严丝合缝地插入。围绕在其周围的，便是丰富的扩展接口。我们重点关注那个RGB LED。它通常不是一个简单的双色LED，而是一个集成了红、绿、蓝三个芯片的LED灯珠，共用一个阳极或阴极。板子上可能会标注其连接到的micro:bit引脚，例如P0、P1、P2。如果没有标注，就需要查阅板子的原理图或用户手册，这是硬件开发中必须养成的好习惯。
除了这个板载RGB LED，扩展板还可能引出了这些引脚到排针上，允许你外接更长的RGB LED灯带。这就需要理解RGB LED的驱动方式。对于普通亮度的小功率LED，micro:bit的GPIO口（最大5V，驱动电流有限）可以直接通过一个限流电阻驱动。但对于高亮LED或灯带，就需要额外的驱动电路，可能是三极管，也可能是专用的LED驱动芯片（如WS2812B这类集成IC的智能灯珠则使用单线串行协议）。虾米扩展板的设计考量之一，就是内置了这部分驱动电路，让我们无需担心电流不足的问题，可以直接用程序逻辑控制。
另一个关键点是电源。RGB LED，尤其是全亮度白色时，功耗不小。micro:bit的USB口或电池盒供电能力有限。好的扩展板会设计有外部电源输入接口，当驱动多个外设时，建议使用外部电源，避免micro:bit主板重启或工作不稳定。检查了一下这块板子，确实有一个VIN引脚或端子，这个设计很贴心。
2.2 软件方案选型与对比
点亮RGB LED，在软件层面有多个路径，选择哪种取决于你想学习的深度和项目最终的复杂度。
方案一：MakeCode图形化编程这是最快速的上手方式。MakeCode提供了led和pins积木块，我们可以直接设置特定引脚的数字输出（高/低电平）来开关单色LED。但对于RGB调色，就需要用到PWM模拟输出。MakeCode的pins类别下有analog write pin积木，可以设置0-1023的值来控制引脚输出不同占空比的PWM波，从而调节LED亮度。通过分别控制R、G、B三个引脚的PWM值，就能混合出各种颜色。优点是直观、零门槛，适合快速验证和初学者理解概念。缺点是代码结构灵活性稍差，难以实现复杂的色彩渐变或响应式效果。
方案二：MicroPython文本编程这是我个人更推荐的方式，它平衡了易用性和灵活性。通过MicroPython，我们可以直接使用microbit模块的pin对象。例如，pin0.write_digital(1)用于数字输出点亮，pin0.write_analog(511)用于PWM输出（范围0-1023）。更重要的是，我们可以方便地使用函数、循环和数学库来实现动态效果。例如，用一个循环渐变PWM值来实现呼吸灯，或者根据传感器读数实时改变颜色。MicroPython的REPL（交互式环境）还能让我们实时调试，输入一行命令就能立即看到LED的反应，学习体验非常棒。
方案三：Arduino C/C++环境对于追求极致性能和底层控制的开发者，可以通过Arduino IDE来给micro:bit编程（需要安装特殊的板卡支持包）。这种方式下，你可以使用Arduino丰富的库，并且对内存和时序有更精细的控制。例如，驱动WS2812B灯带时，Arduino社区有非常成熟高效的NeoPixel或FastLED库。但此方案设置环境稍复杂，且需要一定的C语言基础。
对于本次开箱点灯，我们的目标是快速体验并理解原理，因此将采用MicroPython作为主要工具，因为它代码清晰，易于讲解背后的原理，同时功能足够强大。
3. 核心原理：RGB色彩与PWM调光详解
3.1 RGB色彩模型与数值转换
我们想让LED发出“天蓝色”或“暖黄色”的光，就需要告诉它红、绿、蓝各需要多亮。这就是RGB色彩模型，通过调节Red、Green、Blue三种基色的亮度来混合出各种颜色。
在数字世界，亮度通常用一个数值来表示。常见的有两种范围：
- 0-255范围：这是8位精度，也是最常见的（如网页颜色
#RRGGBB）。255代表最亮，0代表熄灭。 - 0-1023范围：这是micro:bit的PWM输出精度。1023代表100%占空比（常亮），0代表0%占空比（熄灭）。
因此，我们需要进行数值映射。比如，你想让红色半亮，在0-255体系中是127，那么在micro:bit上对应的PWM值就是127 / 255 * 1023 ≈ 511。
有时你会看到HSL（色相、饱和度、亮度）或YUV等色彩空间。比如网络热词中提到了“hsl转rgb”。HSL更符合人类对颜色的直观感知（先选色相，再调饱和度和明度）。如果你有一个HSL值，想用在micro:bit上，就需要先通过公式将其转换为RGB的0-255值，然后再映射到0-1023。这是一个常见的编程需求，好在网上有现成的转换公式或代码片段。
注意：micro:bit的PWM频率是固定的，对于LED调光完全足够。但需要注意的是，人眼对亮度的感知不是线性的。直接线性增加PWM值（如从500到600），感觉上的亮度增加可能不明显。如果需要非常平滑的呼吸灯效果，可能需要对PWM值进行伽马校正（使用非线性映射），这是一个进阶技巧。
3.2 PWM脉冲宽度调制原理
PWM是点亮RGB LED，并让其变色的核心技术。它不是通过改变电压来调节亮度（那需要复杂的模拟电路），而是通过快速开关LED来实现。
想象一下你用手指反复遮挡手电筒，如果遮挡的时间很短，打开的时间很长，整体看起来就很亮；如果遮挡的时间很长，打开的时间很短，整体看起来就很暗。PWM就是这样工作的：在一个固定的周期内，高电平（打开）的时间占比称为“占空比”。占空比100%就是常亮，50%就是半亮，0%就是熄灭。
micro:bit的GPIO引脚在输出PWM信号时，就在高速地重复这个开关过程（频率很高，比如几百赫兹到上千赫兹），由于视觉暂留效应，我们看不到闪烁，只能感受到亮度的变化。通过独立控制R、G、B三个引脚的PWM占空比，就相当于调节了三原色光源的“强度”，最终混合成我们看到的颜色。
例如，要显示纯黄色。黄色是红色和绿色的混合，蓝色为0。那么我们可以设置：
- 红色引脚 PWM = 1023 (100%)
- 绿色引脚 PWM = 1023 (100%)
- 蓝色引脚 PWM = 0 (0%)
这样，红色光和绿色光以最大亮度混合，就得到了最亮的黄色。
4. 实操过程：从连接至编写第一个程序
4.1 硬件连接与环境准备
首先，确保micro:bit主板已经通过USB线连接到电脑，并被系统识别（通常会显示为一个名为MICROBIT的U盘）。然后，将micro:bit插入虾米扩展板的专用插槽中，注意方向，micro:bit的LED点阵屏应朝外，与扩展板上的标识一致。插入时应对准排针，均匀用力按下，听到轻微的“咔哒”声或感觉完全插到底即可。
接下来，我们需要一个编程环境。这里我们使用Mu Editor，它是一个非常适合初学者的MicroPython编辑器，内置了micro:bit模式。去官网下载安装后，打开Mu，在模式选择中选择“MicroPython for micro:bit”。连接正常的话，顶部会显示串口号。
在写代码之前，我们必须确认RGB LED连接到了micro:bit的哪几个引脚。假设（请根据你的板子手册确认）：
- 红色（R）引脚连接到了P0
- 绿色（G）引脚连接到了P1
- 蓝色（B）引脚连接到了P2
并且，这个RGB LED是共阳极的（即三个LED的阳极接在一起接到VCC，我们通过控制阴极拉低来点亮）。这意味着，当引脚输出低电平（0）时，LED点亮；输出高电平（1）时，LED熄灭。对于PWM来说，write_analog(0)是100%点亮（占空比0%？这里需要澄清：对于共阳极接法，逻辑是反的）。实际上更常见的接法是共阴极（阴极接地，阳极通过限流电阻接GPIO），这样write_analog(1023)就是最亮。我们必须根据实际电路确定逻辑。为了保险，我们可以先进行一个简单测试。
4.2 基础点灯与色彩混合代码实现
让我们在Mu Editor中新建一个文件，开始编写代码。首先，导入必要的模块，并定义引脚。
from microbit import * # 假设RGB LED为共阴极接法，连接P0, P1, P2 # 如果是共阳极，逻辑需要取反（即用1023减去以下值） led_r = pin0 led_g = pin1 led_b = pin2 # 初始化，先关闭所有LED（对于共阴极，输出0即为关闭） led_r.write_analog(0) led_g.write_analog(0) led_b.write_analog(0)接下来，我们编写一个函数，将直观的0-255 RGB值转换为micro:bit的PWM值并设置输出。这个函数将是我们的调色核心。
def set_color(r, g, b): """ 设置RGB LED颜色 :param r: 红色亮度， 0-255 :param g: 绿色亮度， 0-255 :param b: 蓝色亮度， 0-255 """ # 将0-255映射到0-1023 pwm_r = int(r / 255 * 1023) pwm_g = int(g / 255 * 1023) pwm_b = int(b / 255 * 1023) # 输出PWM信号（如果是共阳极，此处应为 write_analog(1023 - pwm_xxx)） led_r.write_analog(pwm_r) led_g.write_analog(pwm_g) led_b.write_analog(pwm_b)现在，我们可以在主循环中调用这个函数来显示颜色了。为了让效果更明显，我们让LED依次显示红、绿、蓝、白、黄、紫、青这几种基础色。
# 定义一些常用颜色 (R, G, B) RED = (255, 0, 0) GREEN = (0, 255, 0) BLUE = (0, 0, 255) WHITE = (255, 255, 255) YELLOW = (255, 255, 0) PURPLE = (255, 0, 255) CYAN = (0, 255, 255) BLACK = (0, 0, 0) colors = [RED, GREEN, BLUE, WHITE, YELLOW, PURPLE, CYAN] while True: for color in colors: set_color(*color) # 解包元组，传入set_color函数 sleep(1000) # 显示1秒 sleep(500) # 一轮结束后暂停0.5秒将代码保存为main.py，点击Mu Editor的“刷入”按钮。代码会被编译并下载到micro:bit中。下载完成后，micro:bit会自动重启运行。你应该能看到板载的RGB LED开始按照红、绿、蓝、白、黄、紫、青的顺序循环变色。
实操心得：第一次下载后LED没亮？别急，先检查硬件连接是否牢固。如果硬件没问题，大概率是引脚定义或逻辑搞反了。尝试将
set_color函数中的write_analog(pwm_x)改为write_analog(1023 - pwm_x)。如果还不行，用pinX.write_digital(1)和pinX.write_digital(0)分别测试每个颜色的引脚，看是高电平点亮还是低电平点亮，从而确定电路是共阴还是共阳。这个排查过程是硬件调试的基本功。
5. 进阶应用与动态效果实现
5.1 实现呼吸灯与平滑渐变
静态颜色展示只是第一步。让灯光“活”起来，比如实现呼吸效果（亮度平滑起伏），更能体现PWM控制的魅力。呼吸灯的本质是让PWM值随时间呈正弦或三角波变化。
我们可以修改循环，让某一个颜色（比如白色）的亮度平滑变化。这里以白色呼吸灯为例：
import math def breath_white(): """ 白色呼吸灯效果 """ while True: # 使用正弦函数生成0-1的平滑变化值 for i in range(0, 360, 5): # 0到360度，步长5度 # 将正弦波从[-1,1]映射到[0,1] brightness = (math.sin(math.radians(i)) + 1) / 2 # 将亮度值转换为0-255的RGB值 val = int(brightness * 255) set_color(val, val, val) sleep(20) # 短暂延迟，控制呼吸速度如果你觉得数学计算有点复杂，也可以用更简单的线性渐变（三角波）来实现，效果略有不同但代码更易懂：
def breath_white_linear(): """ 线性白色呼吸灯 """ direction = 1 # 1表示变亮，-1表示变暗 brightness = 0 while True: brightness += direction * 5 # 每次变化5 if brightness >= 255: brightness = 255 direction = -1 elif brightness <= 0: brightness = 0 direction = 1 set_color(brightness, brightness, brightness) sleep(30)将主循环改为调用breath_white()或breath_white_linear()，就能看到LED像在呼吸一样明暗交替了。
5.2 响应外部输入：按键控制与光敏传感
让灯光与外界交互，项目会更有趣。我们可以利用micro:bit自带的按键A、B，或者连接虾米扩展板上的额外传感器（如光敏电阻）来控制LED。
示例1：按键切换颜色模式我们定义两种模式：静态彩虹色循环和呼吸灯模式。按A键切换。
mode = 0 # 0: 静态循环， 1: 呼吸灯 while True: if button_a.was_pressed(): mode = 1 - mode # 在0和1之间切换 # 切换模式时先熄灭LED set_color(0, 0, 0) sleep(200) if mode == 0: # 静态颜色循环模式 for color in colors: if button_a.was_pressed(): break # 如果中途按键，跳出循环以响应模式切换 set_color(*color) sleep(1000) else: # 呼吸灯模式 (使用线性呼吸) breath_white_linear_single_cycle() # 这里需要修改呼吸函数，使其只执行一个周期并返回，以便检测按键示例2：光敏电阻控制亮度假设虾米扩展板有一个光敏电阻接到了模拟输入引脚P3（需要根据实际连接修改）。光敏电阻值随环境光变化，光线越强，电阻越小，读取的模拟值（0-1023）越大。我们可以用这个值来控制LED的整体亮度。
# 假设光敏电阻接在P3 light_sensor = pin3 while True: # 读取环境光强度 (0-1023) light_value = light_sensor.read_analog() # 将光强度映射到亮度系数 (0.1 到 1.0)，避免全黑 brightness_factor = light_value / 1023 * 0.9 + 0.1 # 设定一个基础颜色，比如淡蓝色 (173, 216, 230) base_r, base_g, base_b = 173, 216, 230 # 根据光线调整实际输出亮度 r = int(base_r * brightness_factor) g = int(base_g * brightness_factor) b = int(base_b * brightness_factor) set_color(r, g, b) sleep(100) # 每100ms更新一次这样，LED的亮度就会随着环境光线自动调整，在光线暗时变暗（节能且不刺眼），光线亮时变亮。
6. 常见问题排查与深度优化技巧
6.1 硬件连接与驱动问题排查表
在点灯过程中，你可能会遇到LED不亮、颜色不对、亮度异常等问题。下表列出了一些常见现象和排查思路：
| 现象 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
| LED完全不亮 | 1. 电源未接通或接触不良。 2. 引脚定义错误。 3. 共阴/共阳极逻辑弄反。 4. 限流电阻过大或LED已损坏。 | 1. 检查micro:bit USB连接，重新插拔扩展板。 2. 核对原理图，确认R、G、B引脚号。 3. 用 pinX.write_digital(1)和(0)分别测试，看哪种能点亮。4. 用万用表测量引脚输出电压，或更换LED测试。 |
| 只有一种颜色亮 | 1. 另外两个颜色的引脚定义错误或虚焊。 2. 代码中只设置了其中一个颜色。 3. 另外两个颜色的LED芯片损坏。 | 1. 单独测试每个颜色的引脚控制代码。 2. 检查 set_color函数中三个引脚是否都正确赋值。3. 交换引脚测试，如果问题跟随引脚走，则是代码或引脚问题；如果问题跟随颜色走，可能是LED损坏。 |
| 颜色混合结果不对 | 1. RGB引脚顺序接错（如R和G反了）。 2. PWM映射计算错误。 3. 不同颜色LED的电压-亮度特性不一致。 | 1. 分别发送纯红(255,0,0)、纯绿(0,255,0)、纯蓝(0,0,255)测试，看亮起的是否是对应颜色。 2. 检查 set_color函数中的映射公式int(r/255*1023)。3. 这是物理特性，可通过软件校准，为每个颜色设置不同的亮度曲线。 |
| LED亮度很低 | 1. 限流电阻阻值过大。 2. PWM值设置过低。 3. 电源带载能力不足。 | 1. 查看扩展板原理图，RGB通路上的限流电阻是否过大（通常330Ω-1kΩ为宜）。 2. 确保PWM值接近1023时能达到最亮。 3. 尝试使用外部电源为扩展板供电。 |
| LED闪烁或亮度不稳定 | 1. PWM频率过低，被人眼察觉。 2. 主循环中有长时间阻塞（如 sleep(1000)）。3. 电源噪声干扰。 | 1. micro:bit的PWM频率对于LED调光足够高，通常不是主因。 2. 避免在主循环中使用长延时，改用非阻塞的时间判断逻辑。 3. 在电源引脚附近增加滤波电容（如10uF电解并联0.1uF瓷片）。 |
6.2 软件层面的优化与进阶技巧
当基础功能实现后，可以考虑以下优化，让你的项目更专业、更高效：
1. 非阻塞式编程上面的示例代码中大量使用了sleep()函数，这会导致程序在延时期间无法做其他事情（比如响应按钮）。更好的方式是使用running_time()函数来记录时间，进行非阻塞判断。
from microbit import * color_index = 0 last_change_time = running_time() colors = [(255,0,0), (0,255,0), (0,0,255)] # 红，绿，蓝 interval = 1000 # 切换间隔1秒 while True: current_time = running_time() # 检查是否到了该切换颜色的时间 if current_time - last_change_time >= interval: color_index = (color_index + 1) % len(colors) set_color(*colors[color_index]) last_change_time = current_time # 在这里可以随时插入按钮检测或其他任务，不会受sleep阻塞 if button_a.was_pressed(): interval = max(200, interval - 200) # 按A键加快切换速度 if button_b.was_pressed(): interval = min(5000, interval + 200) # 按B键减慢切换速度2. 色彩平滑过渡（渐变）实现从一个颜色到另一个颜色的平滑过渡，能极大提升视觉效果。这需要计算两个RGB值之间的差值，并分步改变。
def color_transition(start_color, end_color, steps=100, duration=2000): """ 颜色平滑过渡 :param start_color: 起始颜色 (R,G,B) :param end_color: 结束颜色 (R,G,B) :param steps: 过渡步数 :param duration: 过渡总时长（毫秒） """ r1, g1, b1 = start_color r2, g2, b2 = end_color r_step = (r2 - r1) / steps g_step = (g2 - g1) / steps b_step = (b2 - b1) / steps step_delay = duration // steps for i in range(steps + 1): r = int(r1 + r_step * i) g = int(g1 + g_step * i) b = int(b1 + b_step * i) set_color(r, g, b) sleep(step_delay) # 使用示例：从红色渐变到蓝色 color_transition((255,0,0), (0,0,255))3. 使用列表和函数组织复杂灯光效果对于复杂的灯光序列（比如模拟跑马灯、彩虹循环），可以将每一帧的颜色状态保存在列表中，然后通过一个函数循环播放这些帧。
# 定义一个简单的彩虹色序列 rainbow = [ (255, 0, 0), # 红 (255, 127, 0), # 橙 (255, 255, 0), # 黄 (0, 255, 0), # 绿 (0, 0, 255), # 蓝 (75, 0, 130), # 靛 (148, 0, 211) # 紫 ] def play_sequence(sequence, frame_delay=200): """播放一个颜色序列""" for color in sequence: set_color(*color) sleep(frame_delay) # 在主循环中播放彩虹 while True: play_sequence(rainbow) if button_a.was_pressed(): break # 按A键停止通过以上这些技巧，你已经超越了简单的“点灯”，开始创作具有动态美感和交互性的灯光项目了。虾米扩展板上的这个RGB LED，就像一块调色板，而MicroPython是你的画笔，限制你的只有想象力。从这里的PWM控制出发，你可以去驱动更长的RGB灯带，配合传感器制作环境氛围灯，甚至结合音乐做出声光同步的效果——这，就是硬件编程让人着迷的地方。
