视觉暂留与引脚复用：用11个GPIO驱动24颗LED的嵌入式实践
1. 项目概述：用视觉暂留“欺骗”眼睛，驱动24颗LED
玩嵌入式开发的朋友，估计都遇到过引脚不够用的尴尬。手里有个不错的显示模块，但算来算去，IO口数量就是差那么几个。最近我在Pimoroni上看到一个挺有意思的双色LED条形图模块，它在一个封装里集成了12个段，每个段里又有一红一绿两颗LED，加起来总共24颗灯。按常理，独立驱动这24颗灯，就算用最省引脚的多路复用，也得不少线。但这个模块的封装背面，赫然只有14个引脚，其中还有三对是内部连通的，实际可用的独立控制引脚只有11个。这立刻勾起了我的兴趣：怎么用11个引脚，去控制24个独立的发光状态？
答案就在我们每天都会用到，却常常被忽略的生理现象——视觉暂留。我们的眼睛和大脑在处理快速变化的图像时，会有短暂的“延迟”和“融合”效果。电影、电视都是基于这个原理。在这个项目里，我们同样可以利用它。我们不需要同时点亮所有LED，而是以极高的速度轮流扫描点亮目标LED。只要这个速度足够快（通常超过每秒60次），在人眼看来，所有的LED就像是同时稳定地点亮一样。这就是本次项目的核心思路：用时间换空间，以动态扫描克服硬件引脚数量的限制。
我选择使用Adafruit的ItsyBitsy M4 Express作为主控，并用CircuitPython来编写程序。选择CircuitPython的原因很简单：它对硬件抽象做得很好，语法接近标准Python，读写GPIO就像操作变量一样简单，特别适合快速验证想法和原型开发。整个项目的目标是实现两种动态效果：一是让一个红、绿或黄色的光点沿着条形图来回移动；二是根据输入值，显示一个从左对齐的、红绿或黄色的“进度条”。为了提供输入，我使用了一个10KΩ的电位器，将其旋转角度映射到0-12的数值，用来控制光点位置或进度条长度。
2. 核心硬件解析与电路设计思路
2.1 双色LED条形图模块的引脚奥秘
驱动这个模块的第一步，是彻底理解它的内部结构。它并非24颗LED的简单堆砌，而是经过了精心的电气设计以实现引脚复用。
模块的12个段被分成了3个“区段”：低区（左侧4段）、中区（中间4段）和高区（右侧4段）。每个区段共享一个公共阳极。具体来说：
- 低区（Low）：包含第1至第4段，其公共阳极连接在引脚1和引脚14上，这两脚在模块内部是相连的。
- 中区（Mid）：包含第5至第8段，公共阳极连接在引脚6和引脚9上，内部相连。
- 高区（High）：包含第9至第12段，公共阳极连接在引脚7和引脚8上，内部相连。
这意味着，阳极控制实际上只有3个独立节点（Low, Mid, High），每个节点控制一个区段里的8颗LED（4段 × 红绿双色）。
阴极侧则按颜色分组。所有12个段的红色LED阴极是独立的，分别引出到引脚2、3、4、5（对应低区到高区的红色阴极）。同样，所有12个段的绿色LED阴极也是独立的，分别引出到引脚13、12、11、10（对应低区到高区的绿色阴极，顺序相反）。这里需要注意，绿色阴极的引脚编号顺序是反的，这在编程时是关键的细节。
所以，总计控制引脚为：3个阳极选择引脚 + 4个红色阴极引脚 + 4个绿色阴极引脚 = 11个独立控制引脚。这正好印证了模块的设计。
注意：模块数据手册通常不直接给出这种复用结构的真值表，需要自己通过万用表二极管档位测量验证，或者根据厂商提供的示例原理图反推。务必确认阳极和阴极的对应关系，接反了会导致无法点亮或逻辑混乱。
2.2 主控与外围器件选型考量
主控：Adafruit ItsyBitsy M4 Express我选择这款板子有几个原因。首先，它基于ATSAMD51，这是一颗Cortex-M4内核的微控制器，运行频率高达120MHz，性能足以支撑高速、稳定的扫描刷新，确保无闪烁的视觉暂留效果。其次，它原生支持CircuitPython，固件安装和开发环境搭建非常方便。最后，它体积小巧但GPIO数量充足，且有模拟输入引脚用于读取电位器，完全符合项目需求。
限流电阻的计算与选择ItsyBitsy M4 Express的GPIO输出电压是3.3V。双色LED（以普通5mm为例）的正向压降（Vf）通常在1.8V-2.2V（红）和3.0V-3.2V（绿）之间。为了保证LED亮度适中且不损坏MCU引脚（通常单个引脚最大灌电流约20-25mA），必须串联限流电阻。
我们以压降较高的绿色LED做保守计算：
- 电源电压 (Vcc): 3.3V
- LED正向压降 (Vf_green): 取3.0V
- 目标电流 (I_target): 设为10mA（一个明亮且安全的数值）
- 所需电阻 R = (Vcc - Vf) / I = (3.3V - 3.0V) / 0.01A = 30Ω
以压降较低的红色LED计算：
- Vf_red: 取2.0V
- R = (3.3V - 2.0V) / 0.01A = 130Ω
考虑到电阻的标准阻值、为MCU引脚留有余量以及简化物料，我选择了330Ω的电阻。对于绿色LED，实际电流约为 (3.3V-3.0V)/330Ω ≈ 0.9mA，亮度可能稍暗但足够指示；对于红色LED，电流约为 (3.3V-2.0V)/330Ω ≈ 3.9mA，亮度会更高。这也解释了为什么在后来的效果中，红绿混合的“黄色”会偏橙红——因为红色更亮。如果想得到更纯的黄色，可以在红色LED的阴极通路上再串联一个额外的电阻（例如100-220Ω）来降低红色亮度。
输入设备：10KΩ线性电位器电位器在这里充当模拟输入传感器。将其两端分别接3.3V和GND，中间滑动端接MCU的模拟输入引脚。旋转电位器时，滑动端的电压在0-3.3V之间线性变化。MCU内部的ADC（模数转换器）将这个电压值转换为数字量（例如0-65535），我们再通过程序将其映射到0-12的区间，用于控制显示。选择10KΩ是常见值，在功耗和抗噪声能力之间取得平衡。
2.3 电路连接实战与布线技巧
我选择使用条状万用板进行焊接，以获得更可靠的连接，适合长期演示。如果只是临时验证，面包板也是完全可行的。
连接清单如下：
- 电源：将ItsyBitsy的3.3V输出端连接到面包板或万用板的正极总线，GND连接到负极总线。
- 电位器：电位器两端引脚分别接3.3V和GND，中间引脚接ItsyBitsy的某个模拟输入引脚，例如
A1。 - LED模块阳极：模块的三个阳极区（Pin1/14, Pin6/9, Pin7/8）各通过一个330Ω电阻，连接到ItsyBitsy的三个GPIO引脚（例如
D13,D12,D11）。注意：模块上成对的阳极引脚是内部连通的，任选其一连接电阻即可，另一个可以悬空或一起接上。 - LED模块阴极：模块的8个阴极引脚（红：Pin2,3,4,5；绿：Pin13,12,11,10）直接连接到ItsyBitsy的另外8个GPIO引脚（例如
D10, D9, D8, D7, D6, D5, D4, D3）。务必对照原理图，确认阴极顺序与程序中的定义一致。 - 共地：确保ItsyBitsy、电位器、LED模块的GND全部连接在一起。
实操心得：在万用板上布线时，建议先用记号笔根据原理图画出连接关系。对于数字电路，电源去耦很重要，可以在ItsyBitsy的3.3V和GND引脚附近焊接一个0.1uF-10uF的陶瓷电容，以滤除电源噪声。所有信号线尽量短，避免平行长线，可以减少干扰。
3. CircuitPython驱动程序设计详解
3.1 开发环境搭建与基础库导入
首先需要准备CircuitPython开发环境：
- 访问Adafruit官网，下载对应ItsyBitsy M4 Express的最新版CircuitPython UF2固件文件。
- 按住ItsyBitsy上的BOOT（或RESET）按钮，同时通过USB连接电脑，待出现
ITSYM4BOOT磁盘后松开。 - 将下载的UF2文件拖入该磁盘，板子会自动重启，并出现一个名为
CIRCUITPY的新磁盘。 - 安装Mu Editor或任何你喜欢的代码编辑器。Mu Editor集成了串行REPL和代码上传功能，对初学者很友好。
在CIRCUITPY磁盘的根目录下，我们会创建主程序文件code.py。CircuitPython启动后会自动执行这个文件。
程序开头需要导入必要的库：
import board import digitalio import analogio import timeboard：定义了该开发板所有引脚的易记名称（如board.D13）。digitalio：用于配置和控制数字输入输出引脚，驱动LED。analogio：用于读取模拟输入引脚的值（电位器）。time：提供延时函数，控制扫描时序。
3.2 硬件初始化与引脚配置
接下来，我们需要严格按照硬件连接，初始化所有用到的GPIO。
# --- 阳极引脚配置 (区段选择) --- # 这些引脚输出高电平时，对应区段的LED才有可能导通 anode_pins = [board.D13, board.D12, board.D11] # 对应 Low, Mid, High 区段 anodes = [] for pin in anode_pins: io = digitalio.DigitalInOut(pin) io.direction = digitalio.Direction.OUTPUT io.value = False # 初始化为低电平，关闭所有区段 anodes.append(io) # --- 阴极引脚配置 (LED颜色选择) --- # 红色LED阴极引脚 (顺序: 段1 -> 段4) red_cathode_pins = [board.D10, board.D9, board.D8, board.D7] # 绿色LED阴极引脚 (顺序: 段1 -> 段4) 注意模块上引脚号是反的 green_cathode_pins = [board.D6, board.D5, board.D4, board.D3] red_cathodes = [] green_cathodes = [] for pin in red_cathode_pins: io = digitalio.DigitalInOut(pin) io.direction = digitalio.Direction.OUTPUT io.value = True # 初始化为高电平，关闭LED（因为阳极是低） red_cathodes.append(io) for pin in green_cathode_pins: io = digitalio.DigitalInOut(pin) io.direction = digitalio.Direction.OUTPUT io.value = True green_cathodes.append(io) # --- 电位器 (模拟输入) 配置 --- potentiometer = analogio.AnalogIn(board.A1)关键点解析：
- 方向与初始值：GPIO被设置为
OUTPUT方向。对于阳极，我们初始化为False（低电平），因为我们的电路是共阳极接法，阳极低电平则整个区段失能。对于阴极，初始化为True（高电平），因为阴极高电平会阻止电流流过（阳极低时，无论阴极高低都不会亮；但为安全起见，先置高）。 - 驱动逻辑：要点亮某个区段的一颗特定颜色的LED，需要：1) 将该区段对应的阳极置高；2) 将该LED对应的阴极置低。其他所有阳极应置低，其他所有阴极应置高。
3.3 核心扫描显示函数实现
这是整个项目的引擎，负责以视觉暂留原理刷新显示。
def set_led(segment, color): """ 点亮指定段和颜色的LED。 segment: 0-11，对应从左到右的12个段。 color: 'R'(红), 'G'(绿), 'Y'(黄)。 注意：此函数执行时间必须极短，它只设置一个瞬间状态。 需要被高频循环调用才能形成稳定显示。 """ # 1. 首先关闭所有阳极和阴极（消隐） for anode in anodes: anode.value = False for cathode in red_cathodes + green_cathodes: cathode.value = True # 2. 计算目标LED的区段和段内索引 # 区段: 0=Low, 1=Mid, 2=High anode_index = segment // 4 # 段内索引: 0-3 segment_index = segment % 4 # 3. 根据颜色设置阴极 if color == 'R' or color == 'Y': red_cathodes[segment_index].value = False # 红色阴极拉低 if color == 'G' or color == 'Y': # 注意：绿色阴极引脚顺序是物理反向的，但我们的列表顺序是逻辑顺序(段1->段4) # 所以索引可以直接使用 segment_index green_cathodes[segment_index].value = False # 绿色阴极拉低 # 4. 开启对应区段的阳极 anodes[anode_index].value = True # 函数结束，引脚状态保持，直到下一次调用被刷新。这个函数是“静态”的，它只在某一时刻点亮一颗（或两颗，如果是黄色）LED。要形成动态效果，我们需要一个主循环，根据当前想要显示的模式（光点或进度条），快速循环调用set_led。
3.4 主循环逻辑与模式控制
主循环需要完成几件事：读取电位器值、更新显示模式、以极高频率刷新LED。
# 显示模式：'dot' 移动光点， 'bar' 进度条 display_mode = 'dot' # 光点移动方向 dot_direction = 1 # 1向右， -1向左 dot_position = 0 dot_color = 'Y' # 上次模式切换时间，用于防抖 last_mode_change = time.monotonic() mode_debounce_delay = 0.5 # 秒 # 主循环 while True: # 1. 读取电位器并映射到0-12 pot_raw = potentiometer.value # ADC是16位 (0-65535)，映射到0-12 pot_value = int((pot_raw / 65535) * 13) # 13是为了包含0-12共13个整数 pot_value = min(pot_value, 12) # 确保不超过12 # 2. 简单的模式切换（例如通过连接一个按钮到D0，这里用条件模拟） # 假设当电位器值快速跳到0又回来时切换模式（实际应用建议用按钮） current_time = time.monotonic() if pot_value == 0 and (current_time - last_mode_change) > mode_debounce_delay: display_mode = 'bar' if display_mode == 'dot' else 'dot' last_mode_change = current_time print("Switched mode to:", display_mode) # 3. 根据模式更新显示 if display_mode == 'dot': # 移动光点模式：电位器控制颜色 if pot_value == 0: dot_color = 'R' elif pot_value <= 4: dot_color = 'Y' else: dot_color = 'G' # 更新光点位置 dot_position += dot_direction if dot_position <= 0: dot_position = 0 dot_direction = 1 elif dot_position >= 11: dot_position = 11 dot_direction = -1 # 刷新显示：高速循环中，每次只画光点 # 为了实现平滑移动，刷新率必须远高于人眼识别闪烁的频率（>60Hz） set_led(dot_position, dot_color) time.sleep(0.05) # 控制光点移动速度，并非扫描延时 elif display_mode == 'bar': # 进度条模式：电位器值直接对应点亮段数 bar_length = pot_value bar_color = 'G' if pot_value <= 6 else 'Y' if pot_value <= 9 else 'R' # 关键：视觉暂留扫描实现进度条 # 我们快速扫描所有需要点亮的段 for seg in range(bar_length): set_led(seg, bar_color) # 这里不需要延时，因为set_led本身执行很快， # 并且会被循环快速重复调用。 # 对于未点亮的部分，我们不做任何操作（set_led函数已消隐） # 4. 控制整体刷新率 # 主循环的迭代速度就是扫描速度。 # 可以通过微调或使用更精确的定时来控制。 # 对于进度条模式，循环中会遍历多个段，实际每段的点亮时间更短， # 需要确保总刷新率足够高。一个简单的办法是限制循环最大频率。 time.sleep(0.001) # 主循环最小延时，防止CPU占用率100%逻辑深度剖析：
- 映射计算：
pot_value = int((pot_raw / 65535) * 13)将0-65535映射到0-12。乘以13是为了得到0-12（包含）的13个整数区间。int()向下取整，所以pot_value范围是0-12。 - 视觉暂留的实现：在
bar模式下，for seg in range(bar_length):循环会依次（且非常快地）点亮第0段到第bar_length-1段。因为主循环整体在不停重复（每秒数百甚至上千次），每次循环都会重新绘制整个进度条。人眼看到的就是一个稳定的、连续的光条。刷新率等于主循环频率除以需要绘制的段数。如果主循环每秒1000次，绘制5段长的光条，那么每段的刷新率是200Hz，远高于视觉暂留阈值。 - 延时控制：
time.sleep(0.001)给主循环一个微小延时。一方面可以降低CPU使用率，另一方面也是控制整体刷新率。如果去掉它，循环会跑得飞快，刷新率极高，但可能造成电源噪声稍大。这个值可以根据实际情况调整。
4. 项目调试与效果优化实录
4.1 常见问题与排查指南
在实际焊接和编程中，你可能会遇到以下问题：
| 问题现象 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
| 所有LED都不亮 | 1. 电源未接通或电压不对。 2. 共阳极未正确接到3.3V（通过电阻）。 3. 主控程序未运行或 code.py有语法错误。 | 1. 用万用表测量ItsyBitsy的3.3V输出和GND之间电压。 2. 检查三个330Ω电阻是否一端接3.3V，另一端接模块阳极引脚。 3. 连接USB，用Mu Editor打开串行REPL，查看是否有错误信息。尝试运行简单测试代码，如 print(“Hello”)。 |
| 只有部分区段LED能亮 | 1. 某个阳极电阻虚焊或接错引脚。 2. 代码中对应阳极的GPIO配置错误。 | 1. 检查对应不能亮区段的阳极电阻连接。用万用表通断档测量。 2. 在REPL中手动设置该阳极引脚为高电平，看对应区段是否有LED微亮（阴极可能为高阻）。 |
| 单个LED无法点亮 | 1. 该LED对应的阴极引脚连接错误或虚焊。 2. 模块内部该LED损坏（概率低）。 3. 程序中阴极引脚顺序定义错误。 | 1. 确认硬件连接。尝试在代码中单独测试：设置对应阳极高，其他阳极低；设置该阴极低，其他阴极高。观察是否点亮。 2. 交换怀疑损坏的LED所在段的红绿阴极信号，如果颜色跟着信号走，则LED是好的。 |
| 显示闪烁严重 | 1. 扫描刷新率过低（低于60Hz）。 2. 主循环中有不必要的长延时( time.sleep)。3. set_led函数执行太慢。 | 1. 计算刷新率。如果显示N个LED，主循环一次耗时T秒，则刷新率=1/(N*T)。确保>60Hz。 2. 移除或减少 bar模式循环内的延时。确保主循环的sleep非常短。3. 优化 set_led函数，减少循环和函数调用开销。 |
| “黄色”显示为橙色 | 红色LED和绿色LED的亮度不一致，通常红色更亮。 | 这是硬件特性。解决方案：在红色LED的阴极通路上串联一个额外的电阻（如100-220Ω），以降低红色LED的电流，使其亮度与绿色匹配。需要实验确定阻值。 |
| 电位器控制不跟手或跳变 | 1. ADC读取有噪声。 2. 映射算法不连续或电位器本身有抖动。 | 1.软件滤波：采用滑动平均滤波。例如，保存最近5次的ADC读数，取平均值作为当前值。 2.硬件滤波：在电位器输出端与地之间并联一个0.1uF的电容，可滤除高频噪声。 3.死区处理：在映射值变化小于某个阈值时，保持原值不变，避免显示抖动。 |
4.2 软件滤波算法示例
在while True循环开头，读取电位器部分可以改进为：
# 滑动平均滤波 readings = [] # 在循环外初始化一个空列表 READING_COUNT = 5 while True: pot_raw = potentiometer.value readings.append(pot_raw) if len(readings) > READING_COUNT: readings.pop(0) # 移除最旧的读数 filtered_raw = sum(readings) // len(readings) # 计算平均值 pot_value = int((filtered_raw / 65535) * 13) pot_value = min(pot_value, 12) # ... 后续代码4.3 性能优化与扩展思路
1. 使用array和memoryview提升速度CircuitPython中，直接操作digitalio对象的.value属性有一定开销。对于需要极高刷新率的应用，可以考虑使用bitbangio或直接操作寄存器，但这更复杂。一个折中方案是确保set_led函数尽可能精简。
2. 引入色彩混合与亮度控制目前的“黄色”是红绿同时点亮的结果。如果想实现更丰富的颜色（如橙色、黄绿），或者调节亮度，可以引入PWM（脉宽调制）。CircuitPython的pwmio模块可以让你控制引脚输出方波的占空比，从而控制LED的平均电流，实现灰度或亮度调节。不过，这需要将阴极控制引脚更换为支持PWM的引脚，并且会大大增加代码复杂度（因为需要为每个LED维护一个PWM对象和占空比值），刷新率管理也更困难。
3. 扩展输入方式除了电位器，可以增加按钮来切换显示模式、改变颜色主题。增加旋转编码器可以更精确地控制数值。甚至可以通过光敏电阻实现环境光自适应亮度调节。
4. 代码结构化将显示驱动部分抽象成一个BarGraph类，将硬件细节封装起来。主程序只需要调用类似graph.set_bar(length, color)或graph.set_dot(position, color)的方法，使代码更清晰，易于维护和移植到其他项目。
这个项目虽然小，但完整地展示了从硬件原理分析、电路设计、到软件驱动和视觉算法（视觉暂留）的嵌入式开发全流程。它证明了即使在资源受限的微控制器上，通过巧妙的算法和对硬件特性的深入理解，也能实现超出硬件接口能力的视觉效果。下次当你遇到引脚不够时，不妨想想是否能用时间（高速扫描）来换取空间（更多设备）。