RT-Thread调试利器：get_irq_priority——像Keil一样在MSH中查看和设置中断优先级

@[toc]

一、引言：嵌入式开发中的中断调试“痛点”

在RT-Thread等实时操作系统（RTOS）的开发中，中断（IRQ）是确保系统实时性和响应性的核心机制。然而，随着项目复杂度的提升，中断管理也带来了独特的挑战：

• 优先级冲突：不合理的中断优先级配置，可能导致高优先级任务被低优先级中断阻塞，破坏系统的实时性。
• 状态不透明：在设备运行时，我们如何才能直观地了解当前哪些中断被使能？它们的优先级究竟是多少？
• 动态调试困难：想要测试不同优先级对系统性能的影响，难道只能反复修改代码、编译、烧录吗？

传统上，开发者严重依赖J-Link、ST-Link等硬件调试器，配合Keil MDK或IAR等IDE提供的NVIC（嵌套向量中断控制器）外设视图来解决这些问题。这个视图可以清晰地展示所有中断的状态和优先级。

graph TD
    subgraph "传统调试流程"
        A["编写代码<br/>(配置中断优先级)"] --> B["编译 & 烧录"];
        B --> C["连接硬件调试器<br/>(e.g., J-Link)"];
        C --> D["在Keil/IDE中打开<br/><b>NVIC外设视图</b>"];
        D --> E["暂停程序, 查看中断状态"];
    end
    style D fill:#cce5ff,stroke:#333,stroke-width:2px

图1：传统的硬件调试器中断查看流程

但这种方式有其局限性：一旦设备脱离了调试器独立运行，我们就仿佛失去了“透视眼”，无法实时洞察系统的中断状态。

为了解决这一“痛点”，get_irq_priority软件包应运而生。它将强大的NVIC视图功能，直接带到了RT-Thread的MSH（FinSH）控制台中，让中断调试变得前所未有的直观和便捷。

二、get_irq_priority：您的随身NVIC调试器

get_irq_priority是一个轻量级的RT-Thread软件包，它允许开发者通过简单的MSH命令，实时查询和设置Cortex-M内核MCU的中断优先级。其设计哲学就是仿照Keil IDE的NVIC视图，提供一种非侵入式、无需硬件调试器的中断状态观测方案。

核心功能一览

1. 中断信息全景展示：一键列出所有当前已使能的中断，包括中断号（IRQn）、中断优先级和标准中断名称。
2. 多维度排序：支持按中断号或中断优先级进行排序，方便快速定位和分析。
3. 运行时动态设置：无需重新编译，直接通过命令在运行时修改中断的优先级，极大提升了调试效率。

工作原理

该软件包巧妙地调用了ARM CMSIS (Cortex Microcontroller Software Interface Standard) 核心库提供的标准API，如NVIC_GetEnableIRQ()和NVIC_GetPriority()。这使得它在理论上可以支持所有Cortex-M内核的MCU。目前，软件包内已集成了STM32F1/F4/F7/H7等系列的中断名称定义，开箱即用。

---

三、快速上手：如何使用 get_irq_priority

1. 安装软件包

最简单的方式是通过RT-Thread Studio或Env工具，在RT-Thread online packages中启用该软件包：
RT-Thread online packages ---> miscellaneous packages ---> get_irq_priority

保存配置后，软件包会自动下载并集成到您的项目中。

注意：该软件包的Kconfig文件默认依赖SOC_FAMILY_STM32。如果您的工程中没有此宏，导致找不到软件包，可以手动在任意Kconfig文件中添加以下代码以显示它：

> config SOC_FAMILY_STM32
>     bool
>     default y
> 

2. MSH命令实战

软件包的所有功能都通过nvic_irq命令进行调用。

A. 默认查询 (按中断号排序)

在MSH控制台输入nvic_irq并回车，即可获得按中断号从小到大排列的已使能中断列表。

msh /> nvic_irq
IRQn | Priority | IRQ_Name
-----------------------------------
-14  | 0        | BusFault_Handler
-12  | 0        | MemManage_Handler
-11  | 0        | UsageFault_Handler
-5   | 48       | SVCall_Handler
-2   | 112      | PendSV_Handler
-1   | 240      | SysTick_Handler
0    | 64       | WWDG_IRQHandler

B. 优先级查询 (按优先级排序)

当您想分析中断抢占关系时，按优先级排序就显得尤为重要。输入nvic_irq priority命令：

msh /> nvic_irq priority
IRQn | Priority | IRQ_Name
-----------------------------------
-14  | 0        | BusFault_Handler
-12  | 0        | MemManage_Handler
-11  | 0        | UsageFault_Handler
-5   | 48       | SVCall_Handler
6    | 64       | TAMP_STAMP_IRQHandler
...

**C. 动态设置优先级**

这是`get_irq_priority`的“杀手级”功能。假设您想临时提高`ETH_IRQHandler`（中断号83）的优先级以测试网络响应，可以执行以下命令：

```shell
msh /> nvic_irq set
Please input irq number and priority.
> 83 60
Set irq[83] priority success.

设置后，您可以再次使用nvic_irq命令来验证优先级是否已成功修改。

---

四、意义与价值：为何 get_irq_priority 是一个不可或缺的工具？

1. 提升调试效率：它将原本需要硬件调试器和复杂环境才能完成的中断状态检查，简化为一条简单的命令，极大地缩短了调试周期。
2. 增强系统透明度：为开发者提供了一个直观的窗口，可以随时“透视”系统底层的中断配置，有助于快速理解和定位与中断相关的疑难杂症。
3. 赋能现场调试：对于已经部署到现场、无法连接调试器的设备，get_irq_priority提供了一种远程（通过串口、网络等控制台）诊断中断问题的能力，这在产品维护阶段尤为重要。
4. 促进学习理解：对于初学者而言，这是一个绝佳的学习工具，可以动态地修改优先级并观察其对系统行为（如任务调度）的影响，从而更深刻地理解RTOS和ARM Cortex-M的中断机制。

五、总结

get_irq_priority软件包以其小巧的体积和强大的功能，成功地将桌面IDE的核心调试体验带入了嵌入式设备的运行时环境。它不仅是一个解决实际问题的工具，更是一种提升开发与调试效率的先进理念的体现。如果您正在使用RT-Thread进行STM32或其它Cortex-M平台的开发，强烈建议您将这个“随身NVIC调试器”集成到您的项目中，体验前所未有的中断调试便利性。

项目地址：https://github.com/wdfk-prog/rt-thread-get_irq_priority