【产出】 > 会用
attachInterrupt()和digitalPinToInterrupt()给引脚挂外部中断,能按官方表格选对自己板子的中断引脚,分清 LOW / CHANGE / RISING / FALLING 四种触发方式,写出"短小、用 volatile、读取时关中断"的正确中断服务函数。
【版本】 > 按 Arduino 官方语言参考(attachInterrupt、volatile、noInterrupts)编写,适用于 Arduino IDE 2.x 与 Arduino CLI。示例以 UNO R3 为例,引脚表覆盖官方列出的各类板子。
一、为什么需要中断
普通写法是在 loop() 里反复 digitalRead(),这叫轮询。轮询有两个问题:
- 程序在做别的事(比如刷新屏幕、等串口)时,信号来了也看不到;
- 想不漏掉任何一个脉冲,就得一刻不停地读引脚,什么别的事都干不了。
官方文档举的例子:旋转编码器的脉冲、声音传感器捕捉一次拍手、对射光电开关检测投币。这些信号短、来得突然,用中断最合适。
中断的工作方式是:引脚电平满足条件时,硬件立刻打断正在执行的代码,跳去执行你指定的函数(中断服务函数,ISR),执行完再回到原处继续。主程序不需要一直盯着引脚。
二、基本写法
官方推荐的语法:
attachInterrupt(digitalPinToInterrupt(pin), ISR, mode);
| 参数 | 含义 |
|---|---|
digitalPinToInterrupt(pin) | 把 Arduino 引脚号换算成中断号 |
ISR | 中断发生时调用的函数,不能有参数,也不返回值 |
mode | 触发条件,见第四节 |
返回值:无。
另外两种写法官方不推荐:
attachInterrupt(interrupt, ISR, mode):直接写中断号。老代码里常见0(对应 UNO 的 2 号引脚)、1(3 号引脚)。不同板子的引脚和中断号对应关系不一样,换板就可能出错。attachInterrupt(pin, ISR, mode):直接写引脚号,只在 SAMD 板、Uno WiFi Rev2、Due、101 上有效。
为什么要用 digitalPinToInterrupt()?看 Mega2560 的对应关系就明白了:
| 板子 | int.0 | int.1 | int.2 | int.3 | int.4 | int.5 |
|---|---|---|---|---|---|---|
| Uno、Ethernet | 2 | 3 | ||||
| Mega2560 | 2 | 3 | 21 | 20 | 19 | 18 |
| 32u4 系列(Leonardo、Micro) | 3 | 2 | 0 | 1 | 7 |
同样是 int.0,在 Leonardo 上是 3 号引脚,在 UNO 上是 2 号引脚。官方还提到,这里的编号是历史原因形成的,和芯片手册里的编号也不一定一致(例如 Mega2560 的 int.0 对应芯片的 INT4)。Uno WiFi Rev2、Due、Zero、MKR 系列和 101 的中断号等于引脚号。
三、哪些引脚能用中断
以官方语言参考的表格为准:
| 板子 | 可用作中断的数字引脚 | 备注 |
|---|---|---|
| Uno Rev3、Nano、Mini 及其他 328 板 | 2、3 | |
| UNO R4 Minima、UNO R4 WiFi | 2、3 | |
| Uno WiFi Rev2、Nano Every | 全部数字引脚 | |
| Mega、Mega2560、MegaADK | 2、3、18、19、20、21 | 20、21 用作 I2C 时不能当中断用;这两脚带无法关闭的外部上拉 |
| Micro、Leonardo | 0、1、2、3、7 | |
| Zero | 0–3、5–13、A0–A5 | 4 号引脚不能用作中断 |
| MKR 系列 | 0、1、4、5、6、7、8、9、A1、A2 | |
| Nano 33 IoT | 2、3、9、10、11、13、A1、A5、A7 | |
| Nano 33 BLE、Nano 33 BLE Sense(rev1、rev2) | 全部引脚 | |
| Nano RP2040 Connect | 0–13、A0–A5 | |
| Nano ESP32 | 全部引脚 | |
| GIGA R1 WiFi | 全部引脚 | |
| Due | 全部数字引脚 | |
| 101 | 全部数字引脚 | 只有 2、5、7、8、10、11、12、13 支持 CHANGE |
【注意】 > UNO R3 和经典 Nano 只有 2、3 两个外部中断引脚。如果你把按键接在 4 号引脚上调用
attachInterrupt,程序能编译,但中断不会触发。选引脚前先查上表。
四、四种触发方式
| mode | 什么时候触发 | 适合场景 |
|---|---|---|
LOW | 引脚为低电平期间持续触发 | 外部芯片用低电平"报警",处理完它自己会释放 |
CHANGE | 电平发生变化(高变低或低变高) | 编码器、需要同时知道按下和松开 |
RISING | 由低变高 | 传感器输出正脉冲 |
FALLING | 由高变低 | 上拉按键按下、开漏输出拉低 |
Due、Zero 和 MKR1000 还额外支持 HIGH:引脚为高电平期间持续触发。
【注意】 >
LOW是"电平触发",不是"边沿触发"。只要引脚一直是低,ISR 执行完马上又会进入,主程序几乎得不到运行时间。按键这类场合用FALLING,不要用LOW。
五、第一个中断程序
接线:按键一端接 2 号引脚,另一端接 GND。开启内部上拉,松开时为高,按下时变低。
const byte ledPin = LED_BUILTIN;
const byte interruptPin = 2;
volatile byte state = LOW;
void setup() {
pinMode(ledPin, OUTPUT);
pinMode(interruptPin, INPUT_PULLUP);
attachInterrupt(digitalPinToInterrupt(interruptPin), onChange, CHANGE);
}
void loop() {
digitalWrite(ledPin, state);
}
void onChange() {
state = !state;
}
这是官方示例的结构:ISR 里只翻转一个变量,真正写引脚的工作放在 loop() 里做。
你会发现按一次按键,LED 有时翻转一次、有时翻转好几次。这是按键抖动:机械触点接触瞬间会弹跳,产生一串高低变化,每次变化都触发一次中断。第七节会给出处理方法。
六、ISR 里不能做的事
官方对 ISR 的要求是"尽可能短、尽可能快"。原因和限制如下:
| 在 ISR 里 | 情况 | 原因 |
|---|---|---|
delay() | 不工作 | delay() 依赖中断计时,而 ISR 执行期间其他中断在排队 |
millis() | 可以读,但不会增加 | 它靠定时器中断累加,ISR 期间这个中断无法执行 |
micros() | 起初正常,1–2 ms 后开始出错 | 同上 |
delayMicroseconds() | 正常 | 不依赖计数器 |
| 串口接收 | ISR 期间收到的数据可能丢失 | 接收也要靠中断 |
| 多个 ISR | 同一时刻只运行一个 | 其他中断在当前 ISR 结束后按优先级执行 |
所以在 ISR 里读一次 millis() 记下发生时间是可以的,它返回进入 ISR 那一刻的值;但在 ISR 里循环等待 millis() 变化会永远等不到。
至于 Serial.print(),官方原文只说明了串口接收可能丢数据。按通用经验,ISR 里也不要调用 Serial.print():它可能要等发送缓冲区腾出空间,而腾空间又要靠被挡住的中断,最坏情况会卡死。打印放到 loop() 里做。
推荐模式:ISR 只做最少的事(设一个标志、计个数、记个时间),其余全部交给 loop()。
七、volatile:告诉编译器"这个变量会被别人改"
在 ISR 和主程序之间传数据,一般用全局变量。官方要求:ISR 里修改的变量都要声明成 volatile。
原因是编译器会做优化:它看到 loop() 里没有代码修改某个变量,就可能把它读进寄存器后反复使用寄存器里的旧值,不再去内存里重新读。ISR 改的是内存里的值,主程序就一直看不到变化。volatile 强制编译器每次都从内存(RAM)读取。
volatile byte changed = 0; // 正确
byte changed2 = 0; // 被 ISR 修改却没加 volatile,主程序可能永远看不到变化
八、读多字节变量时要关中断
UNO 用的 ATmega328P 是 8 位单片机,一次只能读 8 位。int(16 位)、long 和 unsigned long(32 位)要分几次读完。官方文档描述的风险:loop() 刚读完低 8 位,中断来了,把整个变量改掉,loop() 再读高 8 位,拼出来的就是一个从未存在过的错误数值。
解决办法是在读取期间暂时关闭中断。官方给了两种方式:
方式一:noInterrupts() / interrupts()
noInterrupts();
unsigned long copy = pulseCount; // 拷贝一份
interrupts();
// 后面只用 copy
方式二:AVR 的 ATOMIC_BLOCK 宏
#include <util/atomic.h>
ATOMIC_BLOCK(ATOMIC_RESTORESTATE) {
copy = pulseCount;
}
ATOMIC_BLOCK 来自 AVR 工具链的头文件,只能在 AVR 板(UNO、Nano、Mega 等)上用。需要跨平台时用方式一。
关中断的时间要尽量短,只包住"拷贝"这一步。官方提醒:关中断期间部分功能不工作,通信数据可能被忽略;在 Leonardo 这类原生 USB 的板子上,关中断还会让板子从端口列表里消失。
九、完整例子:数脉冲 + 软件去抖
下面的程序在 2 号引脚上统计下降沿次数,用 ISR 内记录时间的方法过滤按键抖动,主程序每秒打印一次计数。
const byte inputPin = 2;
const unsigned long debounceMs = 50; // 两次有效触发的最小间隔
volatile unsigned long pulseCount = 0;
volatile unsigned long lastPulseMs = 0;
void onPulse() {
unsigned long now = millis(); // ISR 里读一次 millis() 是可以的
if (now - lastPulseMs >= debounceMs) {
pulseCount++;
lastPulseMs = now;
}
}
void setup() {
Serial.begin(9600);
pinMode(inputPin, INPUT_PULLUP);
attachInterrupt(digitalPinToInterrupt(inputPin), onPulse, FALLING);
}
void loop() {
static unsigned long lastPrint = 0;
if (millis() - lastPrint >= 1000) {
lastPrint = millis();
noInterrupts();
unsigned long count = pulseCount; // 32 位变量,关中断后再拷贝
interrupts();
Serial.print("count = ");
Serial.println(count);
}
}
几个设计点:
pulseCount和lastPulseMs都在 ISR 里被修改,所以都加volatile;pulseCount是 32 位,loop()里先关中断再拷贝;- 打印放在
loop()里,ISR 里没有任何Serial调用; - 50 ms 的去抖间隔是按键的常用经验值。用于高速脉冲(如编码器、流量计)时要改小或去掉,否则会漏计。
【提示】 > 不想要某个中断时,用
detachInterrupt(digitalPinToInterrupt(pin))把它关掉。它只影响这一路外部中断,millis()、串口等不受影响;noInterrupts()会关闭所有中断。
十、排查清单
| 现象 | 先检查 |
|---|---|
| 中断完全不触发 | 引脚是否在第三节的表里;第一个参数是否用了 digitalPinToInterrupt() |
| 按一次触发好几次 | 按键抖动,按第九节去抖或加硬件 RC 滤波 |
| 主程序卡住不动 | 是否用了 LOW 模式且引脚一直为低;ISR 里有没有 delay() 或 Serial |
| 主程序看不到变量变化 | 变量是否声明了 volatile |
| 读到的计数偶尔是离谱的大数 | 多字节变量读取时没有关中断 |
| Mega 上 20、21 号引脚中断异常 | 这两脚同时被 I2C 占用 |
参考资料
- Arduino 语言参考:attachInterrupt() https://docs.arduino.cc/language-reference/en/functions/external-interrupts/attachInterrupt/
- Arduino 语言参考:volatile https://docs.arduino.cc/language-reference/en/variables/variable-scope-qualifiers/volatile/
- Arduino 语言参考:noInterrupts() https://docs.arduino.cc/language-reference/en/functions/interrupts/noInterrupts/
- 语言参考源文件:https://github.com/arduino/reference-en
评价 (0)