【CanMV K210】基础实验 轻触按键输入与双色 LED 切换

在智能硬件项目中，按键和 LED 是最常见的一组交互组合。按键负责接收外部输入，LED 负责给出状态反馈。开发板上的一次按下动作，经过 GPIO 输入检测、中断触发、状态判断和输出控制后，会转化成真实可见的灯光变化。这类实验看起来简单，却包含了硬件编程中非常核心的输入、输出和事件响应思想。

本实验使用 CanMV K210 开发板控制一个双色 LED 模块和一个轻触按键。程序运行后，双色 LED 默认显示红色；每按下一次轻触按键，LED 会在红色和绿色之间切换。代码中使用 GPIO 输出控制红色 LED 与绿色 LED，使用 GPIO 输入读取按键状态，并通过下降沿中断捕捉按键按下动作。为了避免机械按键抖动造成多次误触发，程序还加入了 200 毫秒的软件消抖判断。

这个实验的重点不只是“按一下灯变色”，而是理解输入事件如何影响输出状态。按键是输入端，双色 LED 是输出端，中断函数负责记录事件，主循环负责处理事件。后续的按键控制蜂鸣器、按键切换菜单、按键确认任务、传感器触发报警等实验，都可以复用这种事件处理结构。

理论基础

GPIO 实验通常可以分成两类：一类是输出控制，例如点亮 LED、控制蜂鸣器、驱动继电器；另一类是输入检测，例如读取按键、检测开关状态、判断传感器数字输出。本实验同时包含输入和输出：双色 LED 由 GPIO 输出控制，轻触按键由 GPIO 输入检测。

普通轮询读取按键时，程序需要不断在主循环中读取按键电平。如果主循环中还有其他任务，按键按下的瞬间可能被错过。中断机制可以解决这个问题。程序提前告诉 GPIO：当按键引脚出现指定电平变化时，自动触发回调函数。这样按键动作就不再依赖主循环反复读取，而是像事件一样通知程序。

本实验中的轻触按键使用上拉输入。未按下时，引脚保持高电平；按下后，引脚被拉到低电平。因此按键按下瞬间对应的是从高电平变成低电平，也就是下降沿。程序使用GPIO.IRQ_FALLING捕捉这个下降沿，再通过中断回调函数记录一次按键事件。

这张流程图展示的是按键控制双色 LED 的事件链路。按键按下后，IO6 产生下降沿；GPIOHS0 捕捉到变化后进入中断回调；中断函数只负责消抖和记录事件；主循环检测到事件后再执行 LED 颜色切换。这样做的好处是中断函数保持简短，业务逻辑放在主循环中处理，程序更清晰，也更便于后续扩展。

机械按键还存在抖动问题。一次真实按下动作，在电气信号上可能表现为短时间内多次高低电平跳变。如果没有消抖处理，程序可能把一次按下误判成多次按下。本实验使用time.ticks_ms()获取当前时间，再用time.ticks_diff()计算两次有效按下之间的间隔。只有间隔大于DEBOUNCE_MS时，才认为这是一次新的有效按键事件。

硬件设施

本实验围绕轻触按键和双色 LED 展开。双色 LED 的红色控制端和绿色控制端分别接到不同 IO 引脚，由程序输出高低电平控制亮灭。轻触按键接入输入引脚，通过上拉输入方式保持默认高电平，按下时变为低电平。代码没有使用 LCD、摄像头、蜂鸣器、传感器等模块，因此这些硬件不作为本节重点。

接线关系可以先通过下面这张图建立整体印象。实验重点关注 IO7、IO8、IO6 三个连接点：IO7 连接红色 LED 控制端，IO8 连接绿色 LED 控制端，IO6 连接轻触按键 S 端。

实验中用到的核心模块如下。双色 LED 用来显示当前状态，轻触按键用来触发状态变化，CanMV K210 负责运行程序并完成输入输出控制。这个实验不需要复杂外设，但对接线顺序和电平逻辑比较敏感。

接线关系来自代码中的硬件连接说明和fm.register()映射。红色 LED 控制端连接 IO7，绿色 LED 控制端连接 IO8，轻触按键 S 端连接 IO6。由于代码中使用的是双色 LED 常见的低电平点亮方式，所以LED_ON_LEVEL = 0，LED_OFF_LEVEL = 1。按键使用上拉输入，未按下时为高电平，按下时为低电平。

完成接线后的整体效果如下。检查时重点看三处：双色 LED 的红绿控制端是否分别接到 IO7 和 IO8，轻触按键 S 端是否接到 IO6，模块供电和 GND 是否连接正确。程序运行后，默认红色 LED 亮起，每按下一次按键，红绿状态切换一次。

软件代码

本实验代码围绕 GPIO 输入、GPIO 输出和中断事件处理展开。程序将 IO7、IO8 注册为普通 GPIO 输出，用于控制双色 LED；将 IO6 注册为 GPIOHS0 输入，用于接收轻触按键的下降沿中断。按键触发后，程序不会在中断函数里直接执行复杂逻辑，而是先记录一次按键事件，再由主循环完成 LED 颜色切换。

#!/usr/bin/env python3# -*- coding: utf-8 -*-""" CanMV K210 轻触按键控制双色 LED 实验 Demo 实验说明： 按下轻触按键后，双色 LED 在红色和绿色之间切换。 本实验主要练习 GPIO 输入、GPIO 输出、中断触发、按键消抖和状态切换。 硬件连接： 红色 LED 控制端 -> IO7 绿色 LED 控制端 -> IO8 轻触按键 S 端 -> IO6 """importtimefrommaiximportGPIOfromfpioa_managerimportfm# =========================# 硬件配置区# =========================RED_LED_PIN=7GREEN_LED_PIN=8BUTTON_PIN=6RED_LED_GPIO=fm.fpioa.GPIO0 GREEN_LED_GPIO=fm.fpioa.GPIO1 BUTTON_GPIO=fm.fpioa.GPIOHS0# 双色 LED 模块常见为低电平点亮LED_ON_LEVEL=0LED_OFF_LEVEL=1# 按键使用上拉输入，未按下为 1，按下为 0BUTTON_PRESS_LEVEL=0# 按键消抖时间，单位毫秒DEBOUNCE_MS=200# =========================# 全局状态# =========================red_led=Nonegreen_led=Nonebutton=Nonecurrent_color="red"button_event=Falselast_press_time=0# =========================# 初始化函数# =========================defsetup():"""初始化 GPIO"""globalred_led,green_led,button fm.register(RED_LED_PIN,RED_LED_GPIO,force=True)fm.register(GREEN_LED_PIN,GREEN_LED_GPIO,force=True)fm.register(BUTTON_PIN,BUTTON_GPIO,force=True)red_led=GPIO(GPIO.GPIO0,GPIO.OUT)green_led=GPIO(GPIO.GPIO1,GPIO.OUT)button=GPIO(GPIO.GPIOHS0,GPIO.IN,GPIO.PULL_UP)# 默认显示红色set_red()# 下降沿触发：按键从未按下的高电平变成按下的低电平button.irq(button_irq_handler,GPIO.IRQ_FALLING)print("按键控制双色 LED 实验启动")print("当前状态：红灯亮起")# =========================# LED 控制函数# =========================defled_all_off():"""关闭双色 LED"""red_led.value(LED_OFF_LEVEL)green_led.value(LED_OFF_LEVEL)defset_red():"""显示红色"""globalcurrent_color red_led.value(LED_ON_LEVEL)green_led.value(LED_OFF_LEVEL)current_color="red"defset_green():"""显示绿色"""globalcurrent_color red_led.value(LED_OFF_LEVEL)green_led.value(LED_ON_LEVEL)current_color="green"deftoggle_led_color():"""切换双色 LED 状态"""ifcurrent_color=="red":set_green()print("按键触发：切换为绿色")else:set_red()print("按键触发：切换为红色")# =========================# 按键中断函数# =========================defbutton_irq_handler(pin):""" 按键中断回调函数 注意： 中断函数里只记录事件，不直接执行复杂逻辑。 真正的 LED 切换放到主循环中处理。 """globalbutton_event,last_press_time now=time.ticks_ms()iftime.ticks_diff(now,last_press_time)>DEBOUNCE_MS:ifpin.value()==BUTTON_PRESS_LEVEL:button_event=Truelast_press_time=now# =========================# 主循环# =========================defloop():"""主循环：检测按键事件并切换 LED"""globalbutton_eventwhileTrue:ifbutton_event:button_event=Falsetoggle_led_color()time.sleep_ms(20)# =========================# 程序入口# =========================if__name__=='__main__':try:setup()loop()exceptKeyboardInterrupt:led_all_off()print("程序已停止，双色 LED 已关闭")

这段程序可以分成配置区、状态区、初始化函数、LED 控制函数、按键中断函数和主循环。配置区集中保存引脚、电平规则和消抖时间；状态区保存当前 LED 颜色和按键事件标记；初始化函数负责建立 FPIOA 映射、创建 GPIO 对象并设置中断；LED 控制函数负责红绿灯状态切换；中断函数只负责记录有效按键事件；主循环负责真正执行颜色切换。

代码中LED_ON_LEVEL = 0和LED_OFF_LEVEL = 1表示双色 LED 采用低电平点亮逻辑。如果实际模块是高电平点亮，只需要调整这两个常量。BUTTON_PRESS_LEVEL = 0表示按键按下时为低电平，这与GPIO.PULL_UP和GPIO.IRQ_FALLING的使用方式一致。DEBOUNCE_MS = 200用于过滤短时间内的重复触发，避免一次按下被识别成多次切换。

这个实验中的关键设计是“中断函数只记录事件，不直接处理复杂业务”。按键按下时，中断回调函数判断是否满足消抖条件，满足后只把button_event设置为True。主循环检测到这个标记后，再调用toggle_led_color()切换 LED。这样可以避免在中断环境中执行较复杂的输出逻辑，也方便后续把 LED 切换替换成蜂鸣器提示、屏幕刷新或模式切换。

扩展应用

按键控制 LED 的实验容易出现灯不亮、按键无反应、一次按下切换多次等情况。排查时应围绕供电、接线、电平规则、GPIO 映射、中断触发方式和消抖参数进行确认，不需要把问题扩大到无关模块。

按键控制双色 LED 的实验不只是一个简单开关案例，它对应了智能硬件中常见的“输入触发状态变化”模型。按键相当于外部事件入口，LED 相当于状态反馈出口，程序负责把按键动作转换成设备状态变化。这个模式可以扩展到模式切换、菜单选择、设备启动确认、异常状态提示和教学交互演示等场景。

从工程结构看，这段代码已经具备较好的扩展基础。硬件引脚、电平规则和消抖时间集中放在配置区，LED 控制逻辑被拆成set_red()、set_green()和toggle_led_color()，按键中断只负责记录事件，主循环负责处理状态切换。后续增加更多状态时，可以继续围绕current_color或新的状态变量扩展，而不需要推翻整段程序结构。

总结

本实验通过 CanMV K210 开发板完成了轻触按键控制双色 LED 的红绿切换，核心能力包括 FPIOA 引脚映射、GPIO 输出、GPIO 上拉输入、下降沿中断、按键消抖、状态变量管理和主循环事件处理。代码把硬件连接关系转换成程序对象，再把按键输入转化成 LED 输出变化，完整展示了硬件交互程序从输入检测到状态反馈的基本流程。

这类实验非常适合作为 GPIO 输入输出课程的过渡案例。LED 实验侧重输出控制，按键实验开始引入外部输入，中断机制又让程序从单纯循环执行变成事件驱动响应。理解这套结构后，后续可以继续扩展到按键控制蜂鸣器、按键切换屏幕页面、传感器触发 LED 状态、摄像头识别结果反馈、AI 硬件交互控制等方向。硬件编程的核心并不是单个模块如何运行，而是让输入、处理和输出形成稳定可靠的闭环。