第 4 章我们第一次接触中断按钮下降沿。本章系统讲透中断的完整机制向量、上下文切换、ISR 的硬规则为什么必须快、为什么不能随便调用函数、volatile/IRAM_ATTR 的作用、以及从 ISR 安全地通知任务的标准做法。这些是区分会抄示例和能写可靠固件的分水岭。15.1 中断机制硬件插队电平 vs 中断回顾轮询软件不断问——浪费 CPU、响应延迟不确定中断硬件检测到事件沿/电平→ 直接打断 CPU 当前工作 →保存现场 → 跳到中断服务函数ISR→ 处理 → 恢复现场 →回到被打断的地方。正常代码 ────► 某条指令执行中 │ 硬件事件边沿发出中断请求 ▼ 保存现场寄存器、返回地址压栈 ▼ ISR 执行必须快 ▼ 恢复现场 ──► 继续原来的代码两个词先讲清向量、上下文中断向量表硬件发生某个中断时CPU 怎么知道该跳去执行哪个函数芯片里有一张**“电话簿”——按下表第 N 号号码就打给第 N 号处理函数ISR。这张事件号 → 处理函数地址的对照表就叫中断向量表**往表里登记你的函数叫填向量/挂 ISR第 4 章的gpio_isr_handler_add干的就是这件事。上下文context某一刻 CPU正在为谁干活的全部现场跑着哪段代码、各寄存器/栈是什么值。中断一来等于临时换穿别人ISR的鞋去干活干完再把原来的鞋换回来接着跑。所谓保存现场/恢复现场就是这双鞋换来换去。理解这点就懂了为什么ISR 上下文里不能调用会阻塞的函数15.2 细讲——你正穿着中断这双鞋一阻塞就没人能把鞋换回去整个系统卡住。中断优先级与抢占芯片的中断有优先级更高优先级的中断可以打断低优先级 ISR。极端情况下嵌套中断会加深栈、增加延迟——所以ISR 里不要再开中断做复杂事。15.2 ISR 的三条硬规则背下来必须快ISR 执行期间普通任务被冻结。执行太久 系统卡顿、错过其他中断不能调用阻塞函数vTaskDelay、xQueueReceive阻塞版、printf等都不允许——ISR 上下文不能阻塞、printf 太慢且非中断安全只做最少的必要操作置一个标志、给信号量/队列FromISR 版本、改一个变量。重活在任务里做。一句话ISR 只负责记下来通知任务负责干活处理。这叫中断与处理分离。15.3 volatile给会被外部改的变量贴标签staticvolatilebools_event_flagfalse;问题编译器优化时-O2/-Os它可能把多次读同一个变量优化成只读一次因为普通变量在程序自己看来不会变。打个比方编译器像个偷懒的书记员你让他每次开会都念一遍桌上那份通知他觉得通知又没动我背下来念一次就行了于是把值抄在自己的便签上反复用——可 ISR/硬件这块外部随时在改桌上原件书记员却只看自己的旧便签。volatile就是批示**“每次都要重新看原件不许抄便签”**告诉编译器这个变量可能被外部改每次访问都回内存读不许缓存优化。⚠️volatile只解决读写可见性不解决多任务竞争两个任务共享计数还要用原子操作/互斥锁。volatile 常用于ISR 与主循环之间的标志位、硬件寄存器访问。15.4 IRAM_ATTR为什么 ISR 要放快速内存Flash 访问慢有 cache 未命中时可能卡几十周期——即 CPU 空等几十个自己的节拍才能拿到下一条指令平时几乎感觉不到可中断等不起这点延迟而中断要求低延迟。IRAM_ATTR把函数放进IRAM指令 RAM位于 SRAM 内保证 ISR 不从 Flash 取指令——避免Flash cache 未命中导致 ISR 迟到。staticvolatilebools_flagfalse;// volatile见 15.3staticvoidIRAM_ATTRmy_isr(void*arg){s_flagtrue;// ISR 里只做最快的一件事}同样的还有DRAM_ATTR数据放 SRAM、NOINIT_ATTRISR 里访问的变量也要考虑放 IRAM/DRAMcache 禁用场景经验ISR 和它访问的数据都加 IRAM/DRAM 属性最稳。15.5 GPIO 中断 从 ISR 通知任务标准模式完整示例按键 → 队列 → 任务处理完整可编译本章借用引脚按键中断GPIO21安全脚。为什么不用常见的 GPIO0因为 0 是 strapping 脚、还连着板上的 BOOT 键——上电时按住 BOOT(GPIO0) 会让芯片直接进下载模式拿它当普通按键中断是个陷阱。这里换到 GPIO21 就干净了。【动手框 · 抄代码前先把线接好】① 在哪接断电状态下在开发板排针上操作。② 接什么一个按键或杜邦线手动碰——一脚接 GPIO21另一脚接 GND。程序里给 GPIO21 开了内部上拉pull_up_en ENABLE所以没人按时引脚被拉到高电平 3.3V按下→引脚被接到 GND→变低电平→下降沿触发中断。③ 预期看到每按一次打印一行I (…) btn: 按键事件开始干活...。④ 没反应三步排查a) 线插错脚/没共地重插 GPIO21 与 GNDb) **拿杜邦线直接碰 GND 一下当按下**验证通路应打印一行c) 想验证高电平侧可临时把该脚碰 3.3V 再碰 GND 模拟一次释放→按下。// main/btn_isr.cpp —— 完整可编译占用 GPIO21#includefreertos/FreeRTOS.h// 必须放最前#includefreertos/task.h// xTaskCreate / vTaskDelay#includefreertos/queue.h// 队列 xQueueSendFromISR#includedriver/gpio.h// GPIO 与中断服务#includeesp_attr.h// IRAM_ATTR#includeesp_err.h// esp_err_t / ESP_ERROR_CHECK#includeesp_log.h// ESP_LOGIstaticconstchar*TAGbtn;#defineBTN_PINGPIO_NUM_21// 按键一端接此脚、另一端接 GND程序开内部上拉按下低电平staticQueueHandle_t s_btn_q;// 队列存发生了按下事件staticvoidIRAM_ATTRbtn_isr(void*arg){BaseType_t higherpdFALSE;uint32_tevt1;// ISR 安全版发送满则不等待、不阻塞xQueueSendFromISR(s_btn_q,evt,higher);// 如果 higher 被置真表示有更高优先级任务被唤醒 → 请求退出中断时切换portYIELD_FROM_ISR(higher);}staticvoidbtn_task(void*arg){uint32_te;while(1){xQueueReceive(s_btn_q,e,portMAX_DELAY);// 阻塞等事件ESP_LOGI(TAG,按键事件开始干活...);vTaskDelay(pdMS_TO_TICKS(20));// 消抖/慢活都在任务里做}}externCvoidapp_main(void){s_btn_qxQueueCreate(8,sizeof(uint32_t));gpio_config_t io{};io.pin_bit_mask(1ULLBTN_PIN);io.modeGPIO_MODE_INPUT;io.pull_up_enGPIO_PULLUP_ENABLE;io.intr_typeGPIO_INTR_NEGEDGE;// 下降沿触发按下瞬间拉低ESP_ERROR_CHECK(gpio_config(io));// esp_err_t 一律要接住第 6 章铁律——别裸调用ESP_ERROR_CHECK(gpio_install_isr_service(0));// 启动 GPIO 中断服务ESP_ERROR_CHECK(gpio_isr_handler_add(BTN_PIN,btn_isr,NULL));// 注册我的 ISRxTaskCreate(btn_task,btn,2048,NULL,5,NULL);// 处理任务}// 用完要回收在你确定不再需要这个按键中断的地方调用它// 长时间运行的固件里热插拔/重配引脚时特别用得上// [[maybe_unused]] 只是告诉编译器暂时没人调用别报警你要用时删掉它即可[[maybe_unused]]staticvoidbtn_isr_cleanup(void){ESP_ERROR_CHECK(gpio_isr_handler_remove(BTN_PIN));// 摘掉这个脚的 ISRESP_ERROR_CHECK(gpio_isr_service_uninstall());// 关掉 GPIO 中断服务vQueueDelete(s_btn_q);// 删掉队列}// main/CMakeLists.txt idf_component_register(SRCS btn_isr.cpp INCLUDE_DIRS . REQUIRES esp_driver_gpio) # driver/gpio.h【预期输出 / 没输出怎么办】预期输出每按一次 GPIO21 上的按键打印一行I (…) btn: 按键事件开始干活...快速连按可能出现连续几行机械按键有抖动第 4 章讲过这里没做软件消抖属正常。没反应/按一次蹦多行 → 见上面【动手框】的三步排查与消抖说明完全无日志 → 见 2.11。模式拆解ISRIRAM_ATTR只做一件事xQueueSendFromISR通知任务用xQueueReceive阻塞等待醒来后做重活打印、延时、消抖portYIELD_FROM_ISR(higher)如果唤醒了高优先级任务立刻切换减少延迟不用了要回收btn_isr_cleanup()里gpio_isr_handler_remove→gpio_isr_service_uninstall→vQueueDelete按注册的反顺序来。FromISR 版本一览ISR 里只能用这些普通版本ISR 安全版本用途xQueueSend / xQueueReceivexQueueSendFromISR / xQueueReceiveFromISR队列xSemaphoreGive / xSemaphoreTakexSemaphoreGiveFromISR /xSemaphoreTakeFromISR信号量xEventGroupSetBitsxEventGroupSetBitsFromISR事件组—taskYIELD / portYIELD_FROM_ISR请求调度xSemaphoreTakeFromISR确实存在semphr.h核实但它只对二值/计数信号量有意义——mutex互斥锁不要在 ISR 里 takemutex 讲究谁拿谁还中断没有持有者身份语义对不上。ISR 里最常见的是Give举旗通知任务去 take。⚠️ 记住阻塞版函数禁止在 ISR 里调用只能用 FromISR 后缀版本而且它们只入队通知不阻塞。15.6 临界区保护不能被中断打断的代码先定义原子原子操作 要么整个没发生、要么已经整个完成中间没有做了一半的可观测状态就像电灯开关没有半开这个位置——按下去就是开。有时一段代码必须原子执行比如读一个共享值 清零两步不能被 ISR插进来打断一半否则读到改一半的数据或丢了中途的更新。把这段代码用临界区critical section包起来进出之间本核的可屏蔽中断被暂时挡住。下面是一个完整可编译、约 30 行的小实验ISR 负责给按键计数任务每秒用临界区把读快照 清零这个两步操作原子地取走再打印// main/critical_demo.cpp —— 完整可编译占用 GPIO21把它碰一下 GND 就计数一次#includefreertos/FreeRTOS.h// portMUX_TYPE / portENTER_CRITICAL 都来自它#includefreertos/task.h// v6.0.1 没有 esp_critical_section.h别找它#includedriver/gpio.h#includeesp_attr.h// IRAM_ATTR#includeesp_err.h#includeesp_log.hstaticconstchar*TAGcrit;#defineBTN_PINGPIO_NUM_21staticvolatileuint32_ts_isr_count0;// ISR 写、任务读共享变量staticportMUX_TYPE s_muxportMUX_INITIALIZER_UNLOCKED;// 保护它的锁// ISR只做最快的一件事——计数 1单条自增够快符合 15.2 铁律staticvoidIRAM_ATTRbtn_isr(void*arg){s_isr_count;}// 任务每秒进临界区把读快照 清零两步原子地完成staticvoidreport_task(void*arg){while(1){vTaskDelay(pdMS_TO_TICKS(1000));uint32_tsnapshot;portENTER_CRITICAL(s_mux);// 这两行之间不许被中断打断snapshots_isr_count;// 否则读旧值后、清零前若又来一次 s_isr_count0;// 那次按键就会被抹掉丢计数portEXIT_CRITICAL(s_mux);ESP_LOGI(TAG,过去 1 秒按下 %lu 次,(unsignedlong)snapshot);}}externCvoidapp_main(void){gpio_config_t io{};io.pin_bit_mask1ULLBTN_PIN;io.modeGPIO_MODE_INPUT;io.pull_up_enGPIO_PULLUP_ENABLE;// 内部上拉不接高电平io.intr_typeGPIO_INTR_NEGEDGE;// 碰一下 GND 一个下降沿 计数一次ESP_ERROR_CHECK(gpio_config(io));ESP_ERROR_CHECK(gpio_install_isr_service(0));ESP_ERROR_CHECK(gpio_isr_handler_add(BTN_PIN,btn_isr,NULL));xTaskCreate(report_task,report,4096,NULL,5,NULL);}// main/CMakeLists.txt idf_component_register(SRCS critical_demo.cpp INCLUDE_DIRS . REQUIRES esp_driver_gpio) # driver/gpio.h【预期输出 / 没输出怎么办】预期输出什么都不碰时每秒一行I (…) crit: 过去 1 秒按下 0 次用杜邦线把 GPIO21 快速碰几下 GND下一秒的行里数字就等于刚才碰的次数碰 3 下 →过去 1 秒按下 3 次随后清零继续。没反应 → ① 内部上拉下悬空读恒为高、不触发必须碰 GND制造下降沿② 无日志 → 见 2.11③ 数字对不上是消抖问题第 4 章不影响理解临界区。临界区越短越好屏蔽中断 全局延迟普通任务间共享用互斥锁第 13 章不要用临界区临界区用于ISR 与任务共享同一个多字节变量比如 32 位读写在S3 上虽通常原子但复杂场景仍要临界保护。15.7 实时性设计几个工程原则分层ISR快、通知→ 高优先级任务紧急处理→ 普通任务ISR 只置标志/发通知一切耗时在任务里避免高优先级任务死循环饿死低优先级 看门狗触发固定频率任务用 vTaskDelay / esp_timer不要自己数循环测量esp_timer_get_time()打点量出关键路径耗时。15.8 常见问题速查现象原因解决ISR 里 printf 卡死/乱printf 非中断安全、太慢移到任务里打日志变量值不对编译器优化缓存了变量加 volatile只读标志ISR 延迟大函数在 Flashcache 未命中加 IRAM_ATTR中断触发多次抖动第 4 章任务里消抖嵌套中断栈溢出ISR 里又开中断嵌套保持 ISR 简单任务永远不醒FromISR 忘了给/给了错误句柄检查通知对象15.9 想一想 小测验想一想为什么 ISR 不能调用vTaskDelay从上下文角度volatile能解决两个任务竞争同一个变量吗为什么ISR 里printf为什么是禁忌小测验ISR 的三条硬规则第一条是____。ISR 通知任务的标准工具是A. xQueueSendFromISR B. vTaskDelay C. printfIRAM_ATTR把函数放到哪A. Flash B. IRAM/SRAM C. PSRAMportYIELD_FROM_ISR的作用是什么15.10 本章总结中断 硬件插队保存现场 → ISR → 恢复现场ISR 必须快、不阻塞、不 printf——只记下来通知任务volatile防止优化缓存被外部改的变量不解决并发IRAM_ATTR把 ISR 放 IRAM避免 Flash cache 延迟FromISR 系列是 ISR→任务通信的唯一安全通道。下一章连上 WiFi——让芯片上网。