【CanMV K210】传感器实验 倾斜传感器检测与红绿灯反馈

在智能硬件项目中，设备姿态变化经常代表一种需要被系统捕捉的状态。例如设备被移动、外壳发生倾斜、安装角度异常、运输过程中产生晃动，这些现象如果只停留在物理层面，程序无法感知；只有通过传感器把姿态变化转换成电信号，再由代码读取并处理，硬件系统才具备基本的环境感知能力。

本实验使用 CanMV K210 开发板连接倾斜传感器，并通过红色 LED 和绿色 LED 表示设备状态。正常情况下，绿色 LED 点亮，表示设备处于稳定状态；当倾斜传感器检测到姿态变化时，程序通过中断方式记录触发事件，主循环再执行红灯闪烁告警，模拟设备异常提醒。代码中还加入了防抖处理，避免一次倾斜动作被重复识别成多次触发。

这个实验的重点不只是让 LED 亮灭，而是把“传感器输入、中断触发、状态变量、防抖处理、告警反馈”串成一个完整的小型硬件控制流程。对于 Python 硬件编程入门来说，这类实验比单纯点灯更接近真实项目，因为程序已经开始根据外部环境变化做出响应。

文章目录

• 理论基础
• 硬件设施
• 软件代码
• 扩展应用
• 总结

理论基础

倾斜传感器可以把设备姿态变化转换成电平变化。设备保持稳定时，传感器信号处于一种固定状态；设备发生倾斜或晃动时，传感器内部结构变化，信号引脚产生高低电平变化。程序只要检测到这个电平变化，就能判断外部姿态发生了变化。

普通轮询方式可以不断读取传感器输入值，但这种方式会让主循环持续检查同一个引脚。中断方式更适合处理“状态突然变化”的场景。程序提前把倾斜传感器绑定到 GPIOHS0 输入中断，当传感器信号出现指定边沿变化时，中断回调函数会被触发。这样主程序不需要每一行都盯着传感器，只有出现事件时才记录状态。

本实验没有在中断函数里直接闪烁 LED，而是让中断函数只负责修改 tilt_event 状态变量。红灯闪烁、绿灯恢复等动作放在主循环中执行。这样可以避免中断函数内部执行长时间延时，也让程序结构更稳定。实际项目中，按键中断、传感器触发、限位开关检测、碰撞检测等场景，都可以复用这种“中断记录事件，主循环处理事件”的思路。

#mermaid-svg-izv9JeGBW9h8ij8j{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-izv9JeGBW9h8ij8j .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-izv9JeGBW9h8ij8j .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-izv9JeGBW9h8ij8j .error-icon{fill:#552222;}#mermaid-svg-izv9JeGBW9h8ij8j .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-izv9JeGBW9h8ij8j .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-izv9JeGBW9h8ij8j .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-izv9JeGBW9h8ij8j .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-izv9JeGBW9h8ij8j .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-izv9JeGBW9h8ij8j .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-izv9JeGBW9h8ij8j .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-izv9JeGBW9h8ij8j .marker{fill:#333333;stroke:#333333;}#mermaid-svg-izv9JeGBW9h8ij8j .marker.cross{stroke:#333333;}#mermaid-svg-izv9JeGBW9h8ij8j svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-izv9JeGBW9h8ij8j p{margin:0;}#mermaid-svg-izv9JeGBW9h8ij8j .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-izv9JeGBW9h8ij8j .cluster-label text{fill:#333;}#mermaid-svg-izv9JeGBW9h8ij8j .cluster-label span{color:#333;}#mermaid-svg-izv9JeGBW9h8ij8j .cluster-label span p{background-color:transparent;}#mermaid-svg-izv9JeGBW9h8ij8j .label text,#mermaid-svg-izv9JeGBW9h8ij8j span{fill:#333;color:#333;}#mermaid-svg-izv9JeGBW9h8ij8j .node rect,#mermaid-svg-izv9JeGBW9h8ij8j .node circle,#mermaid-svg-izv9JeGBW9h8ij8j .node ellipse,#mermaid-svg-izv9JeGBW9h8ij8j .node polygon,#mermaid-svg-izv9JeGBW9h8ij8j .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-izv9JeGBW9h8ij8j .rough-node .label text,#mermaid-svg-izv9JeGBW9h8ij8j .node .label text,#mermaid-svg-izv9JeGBW9h8ij8j .image-shape .label,#mermaid-svg-izv9JeGBW9h8ij8j .icon-shape .label{text-anchor:middle;}#mermaid-svg-izv9JeGBW9h8ij8j .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-izv9JeGBW9h8ij8j .rough-node .label,#mermaid-svg-izv9JeGBW9h8ij8j .node .label,#mermaid-svg-izv9JeGBW9h8ij8j .image-shape .label,#mermaid-svg-izv9JeGBW9h8ij8j .icon-shape .label{text-align:center;}#mermaid-svg-izv9JeGBW9h8ij8j .node.clickable{cursor:pointer;}#mermaid-svg-izv9JeGBW9h8ij8j .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-izv9JeGBW9h8ij8j .arrowheadPath{fill:#333333;}#mermaid-svg-izv9JeGBW9h8ij8j .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-izv9JeGBW9h8ij8j .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-izv9JeGBW9h8ij8j .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-izv9JeGBW9h8ij8j .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-izv9JeGBW9h8ij8j .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-izv9JeGBW9h8ij8j .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-izv9JeGBW9h8ij8j .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-izv9JeGBW9h8ij8j .cluster text{fill:#333;}#mermaid-svg-izv9JeGBW9h8ij8j .cluster span{color:#333;}#mermaid-svg-izv9JeGBW9h8ij8j div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-izv9JeGBW9h8ij8j .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-izv9JeGBW9h8ij8j rect.text{fill:none;stroke-width:0;}#mermaid-svg-izv9JeGBW9h8ij8j .icon-shape,#mermaid-svg-izv9JeGBW9h8ij8j .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-izv9JeGBW9h8ij8j .icon-shape p,#mermaid-svg-izv9JeGBW9h8ij8j .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-izv9JeGBW9h8ij8j .icon-shape .label rect,#mermaid-svg-izv9JeGBW9h8ij8j .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-izv9JeGBW9h8ij8j .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-izv9JeGBW9h8ij8j .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-izv9JeGBW9h8ij8j :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}#mermaid-svg-izv9JeGBW9h8ij8j .input>*{fill:#E8F3FF!important;stroke:#5B9BFF!important;stroke-width:2px!important;color:#1F3B6D!important;}#mermaid-svg-izv9JeGBW9h8ij8j .input span{fill:#E8F3FF!important;stroke:#5B9BFF!important;stroke-width:2px!important;color:#1F3B6D!important;}#mermaid-svg-izv9JeGBW9h8ij8j .input tspan{fill:#1F3B6D!important;}#mermaid-svg-izv9JeGBW9h8ij8j .irq>*{fill:#EAFBF1!important;stroke:#42B983!important;stroke-width:2px!important;color:#1F5C3A!important;}#mermaid-svg-izv9JeGBW9h8ij8j .irq span{fill:#EAFBF1!important;stroke:#42B983!important;stroke-width:2px!important;color:#1F5C3A!important;}#mermaid-svg-izv9JeGBW9h8ij8j .irq tspan{fill:#1F5C3A!important;}#mermaid-svg-izv9JeGBW9h8ij8j .code>*{fill:#F4EEFF!important;stroke:#8E6AD8!important;stroke-width:2px!important;color:#3D2B68!important;}#mermaid-svg-izv9JeGBW9h8ij8j .code span{fill:#F4EEFF!important;stroke:#8E6AD8!important;stroke-width:2px!important;color:#3D2B68!important;}#mermaid-svg-izv9JeGBW9h8ij8j .code tspan{fill:#3D2B68!important;}#mermaid-svg-izv9JeGBW9h8ij8j .output>*{fill:#FFF4E8!important;stroke:#F4A261!important;stroke-width:2px!important;color:#7A4A00!important;}#mermaid-svg-izv9JeGBW9h8ij8j .output span{fill:#FFF4E8!important;stroke:#F4A261!important;stroke-width:2px!important;color:#7A4A00!important;}#mermaid-svg-izv9JeGBW9h8ij8j .output tspan{fill:#7A4A00!important;}#mermaid-svg-izv9JeGBW9h8ij8j .power>*{fill:#FCEEF4!important;stroke:#E76F51!important;stroke-width:2px!important;color:#7A2740!important;}#mermaid-svg-izv9JeGBW9h8ij8j .power span{fill:#FCEEF4!important;stroke:#E76F51!important;stroke-width:2px!important;color:#7A2740!important;}#mermaid-svg-izv9JeGBW9h8ij8j .power tspan{fill:#7A2740!important;}

倾斜传感器检测设备姿态变化

物理引脚 6接收传感器信号

GPIOHS0 输入中断下降沿触发

中断回调函数on_tilt_detect

事件标志位tilt_event = True

主循环处理检测 tilt_event

红灯闪烁告警异常状态反馈

绿灯常亮恢复正常状态

物理引脚 7GPIO0 输出

物理引脚 8GPIO1 输出

VCC / GND模块供电与公共地

这张流程图展示的是电路和程序之间的关系。倾斜传感器负责产生输入信号，GPIOHS0 负责捕捉信号变化，中断函数负责记录事件，主循环负责处理事件，红绿 LED 负责把程序状态变成可见反馈。这个链路比单纯点亮 LED 多了输入检测和事件响应两个环节，更接近真实硬件项目中的控制结构。

防抖也是本实验的重要内容。倾斜传感器属于接触类或机械类检测元件，状态变化时可能在短时间内出现多次抖动。如果每一次电平变化都立即触发告警，程序就会把一次倾斜动作误判成多次事件。代码中使用 time.ticks_ms() 记录触发时间，再用 time.ticks_diff() 判断两次触发之间是否超过 DEBOUNCE_TIME，从而过滤掉过于密集的重复触发。

硬件设施

本实验围绕倾斜传感器输入和双色 LED 状态反馈展开。代码中实际使用到的硬件包括 CanMV K210 开发板、倾斜传感器、红色 LED 和绿色 LED。软件侧主要依赖 maix.GPIO、fpioa_manager.fm 和 time，分别负责 GPIO 控制、引脚功能映射和时间处理。

接线关系可以先通过下面这张图建立整体印象。当前实验真正用到的是三路信号：物理引脚 6 连接倾斜传感器信号端，物理引脚 7 控制红色 LED，物理引脚 8 控制绿色 LED。传感器和 LED 模块还需要正确连接供电和 GND。

实验中使用的核心模块如下。倾斜传感器负责检测姿态变化，红绿 LED 负责显示状态，CanMV K210 负责运行程序并完成输入检测和输出控制。接线时需要同时关注信号线和电源线，不能只连接 GPIO 信号而忽略 VCC 与 GND。

接线关系可以从代码中的引脚常量和 fm.register() 配置推导出来。红色 LED 连接到物理引脚 7，并映射为 GPIO0；绿色 LED 连接到物理引脚 8，并映射为 GPIO1；倾斜传感器信号引脚连接到物理引脚 6，并映射为 GPIOHS0。GPIOHS 常用于高速 GPIO 和中断处理，因此倾斜传感器输入使用 GPIOHS0 比普通 GPIO 更适合做中断检测。

物理引脚是开发板实际连接外设的位置，GPIO 功能是芯片内部可分配的输入输出能力，代码变量则是程序操作硬件时使用的对象名称。当前程序把物理引脚 7 和 8 配置成普通 GPIO 输出，用来控制红绿两个 LED；把物理引脚 6 配置成 GPIOHS0 输入，用来接收倾斜传感器的信号变化。这样一来，传感器负责发现状态变化，LED 负责把程序判断结果可视化。

完成接线后的整体效果如下。检查时重点关注倾斜传感器信号线是否接到物理引脚 6，红色 LED 是否接到物理引脚 7，绿色 LED 是否接到物理引脚 8，以及所有模块是否共地。程序正常运行后，默认应显示绿色 LED 点亮；触发倾斜传感器后，红色 LED 会快速闪烁。

软件代码

本实验代码围绕倾斜传感器中断检测和红绿灯状态反馈展开。程序先定义物理引脚、GPIO 功能和 LED 电平逻辑，再通过 setup() 完成引脚注册、GPIO 对象创建、中断绑定和初始状态设置。主循环 loop() 不断检查倾斜事件标志，一旦检测到事件，就执行红灯闪烁告警，并在告警结束后恢复绿灯常亮状态。

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

"""
CanMV K210 倾斜传感器实验 Demo

功能说明：
1. 倾斜传感器检测到姿态变化时触发中断
2. 正常状态下绿灯亮
3. 倾斜触发后红灯闪烁，模拟设备异常告警
4. 加入防抖处理，避免一次倾斜产生多次误触发
"""

from maix import GPIO
from fpioa_manager import fm
import time

# =========================
# 引脚配置区
# =========================

RED_LED_PIN = 7 # 红色 LED 引脚
GREEN_LED_PIN = 8 # 绿色 LED 引脚
TILT_PIN = 6 # 倾斜传感器信号引脚

RED_LED_GPIO = fm.fpioa.GPIO0
GREEN_LED_GPIO = fm.fpioa.GPIO1
TILT_GPIO = fm.fpioa.GPIOHS0

# =========================
# 电平配置区
# =========================
# 如果实际现象相反，可以把 LED_ON 和 LED_OFF 对调

LED_ON = 0
LED_OFF = 1

# =========================
# 全局状态变量
# =========================

red_led = None
green_led = None
tilt_sensor = None

tilt_event = False
last_trigger_time = 0

DEBOUNCE_TIME = 300 # 防抖时间，单位毫秒

# =========================
# LED 控制函数
# =========================

def red_on():
red_led.value(LED_ON)

def red_off():
red_led.value(LED_OFF)

def green_on():
green_led.value(LED_ON)

def green_off():
green_led.value(LED_OFF)

def led_all_off():
red_off()
green_off()

def show_normal_state():
"""
正常状态：
绿灯亮，红灯灭
"""
red_off()
green_on()

def show_tilt_warning():
"""
倾斜告警状态：
红灯快速闪烁，绿灯关闭
"""
green_off()

for _ in range(3):
red_on()
time.sleep_ms(120)
red_off()
time.sleep_ms(120)

# =========================
# 倾斜传感器中断函数
# =========================

def on_tilt_detect(pin):
"""
倾斜传感器触发回调函数

注意：
中断函数里不要做复杂逻辑，也不要做长时间延时。
这里只记录事件，真正的处理放到主循环中。
"""
global tilt_event
global last_trigger_time

now = time.ticks_ms()

if time.ticks_diff(now, last_trigger_time) > DEBOUNCE_TIME:
tilt_event = True
last_trigger_time = now

# =========================
# 初始化函数
# =========================

def setup():
global red_led
global green_led
global tilt_sensor

fm.register(RED_LED_PIN, RED_LED_GPIO, force=True)
fm.register(GREEN_LED_PIN, GREEN_LED_GPIO, force=True)
fm.register(TILT_PIN, TILT_GPIO, force=True)

red_led = GPIO(GPIO.GPIO0, GPIO.OUT)
green_led = GPIO(GPIO.GPIO1, GPIO.OUT)

tilt_sensor = GPIO(GPIO.GPIOHS0, GPIO.IN, GPIO.PULL_UP)

led_all_off()
show_normal_state()

tilt_sensor.irq(on_tilt_detect, GPIO.IRQ_FALLING)

print("倾斜传感器初始化完成")
print("正常状态：绿灯亮")
print("倾斜触发：红灯闪烁告警")

# =========================
# 主循环函数
# =========================

def loop():
global tilt_event

while True:
if tilt_event:
tilt_event = False

print("检测到设备倾斜，触发告警")
show_tilt_warning()

print("告警结束，恢复正常状态")
show_normal_state()

time.sleep_ms(20)

# =========================
# 程序入口
# =========================

if __name__ == '__main__':
try:
setup()
loop()
except KeyboardInterrupt:
led_all_off()
print("程序已停止，LED 已关闭")

这段程序可以分成三个层级。底层是 fm.register() 和 GPIO()，负责完成引脚映射和输入输出对象创建；中间层是 red_on()、green_on()、show_normal_state()、show_tilt_warning() 这些状态显示函数，负责把 LED 控制封装成更容易理解的动作；上层是 on_tilt_detect() 和 loop()，负责记录倾斜事件并执行告警流程。

代码中设置 LED_ON = 0、LED_OFF = 1，说明当前 LED 按低电平点亮逻辑编写。部分 LED 模块或接线方式可能是高电平点亮，如果实验现象刚好相反，只需要对调这两个常量，不需要修改每一个 LED 控制函数。这个写法能把硬件差异集中到配置区处理。

中断函数 on_tilt_detect(pin) 是本实验的核心。倾斜传感器触发后，程序不会在中断函数里直接闪烁 LED，而是只修改 tilt_event 这个状态变量。这样的设计更符合嵌入式开发习惯，因为中断函数应尽量短，避免在中断内部执行复杂逻辑或长时间延时。真正的告警动作放到主循环中处理，程序结构更稳定，也更容易扩展。

扩展应用

倾斜传感器实验常见问题集中在接线、电平逻辑、中断触发方式和防抖参数上。排查时应围绕传感器输入是否变化、LED 电平是否匹配、GPIOHS 中断是否绑定成功几个方向逐步确认。

倾斜传感器实验的价值在于把外部姿态变化转化成程序事件，再通过 LED 反馈结果。这个流程可以迁移到很多真实硬件场景中，例如设备防拆提醒、运输姿态检测、智能盒子倾倒告警、机器人姿态异常提示、教学实验状态演示等。当前代码已经具备输入检测、中断响应、防抖过滤和状态反馈能力，因此很适合作为传感器类课程的入门案例。

从工程角度看，当前程序已经把硬件控制拆成了清晰的状态结构。传感器只负责触发事件，中断函数只负责记录事件，主循环负责处理事件，LED 函数负责显示状态。这样的拆分方式比把所有逻辑堆在一个循环里更稳定。后续接入蜂鸣器、屏幕、数据上传或日志记录时，可以继续沿用 tilt_event 这种事件标志思路，把不同硬件反馈挂接到同一个状态处理流程中。

总结

本实验通过 CanMV K210 开发板完成了倾斜传感器检测与红绿 LED 告警反馈，核心能力包括 FPIOA 引脚映射、GPIO 输出控制、GPIOHS 输入检测、中断回调、防抖处理、状态变量管理和主循环事件调度。代码不是简单读取一个传感器值，而是把外部姿态变化转换成程序事件，再通过 LED 形成可见反馈，完整体现了硬件编程中“输入检测—事件记录—状态处理—输出反馈”的基本模式。

这类实验非常适合作为传感器课程的起点。倾斜动作对应真实世界的物理变化，中断函数对应程序对变化的快速响应，红绿灯状态对应系统反馈结果。后续课程可以继续扩展到按键输入、蜂鸣器报警、LCD 状态显示、传感器数据采集、AI 摄像头识别和网络状态上报等方向。理解了本节中的 GPIO 输入、中断触发和状态反馈逻辑，更多智能硬件实验都可以建立在同一套编程思路之上。