pragma vector在C语言中如何使用？

#pragma vector 是一个编译器指令，主要用于嵌入式系统开发，特别是针对单片机，它的作用是将一个指定的 C 函数绑定到处理器的一个特定中断向量上。

当你告诉单片机某个引脚被按下、定时器时间到了或者串口收到了数据时，CPU 会暂停当前正在执行的程序，转而去执行一个特定的“中断服务程序”。#pragma vector 就是用来告诉编译器：“嘿，这个函数就是我设定的中断服务程序，请把它放到内存中那个专门处理这类中断的位置。”

为什么需要 #pragma vector？

在没有 pragma 的情况下，你可以通过修改启动文件（如 startup_*.s 或 startup_*.c）中的中断向量表来将中断处理函数的地址填入表中,但这非常繁琐且容易出错：

1. 平台依赖性强：不同厂商、不同型号的单片机,其启动文件和中断向量表格式都不同。
2. 维护困难：每次更换芯片或更新库函数,都可能需要手动修改这个底层文件。
3. 容易出错：手动填写函数地址，一旦出错，程序就可能直接跳转到未知地址,导致系统崩溃。

#pragma vector 提供了一种在 C 语言层面、可移植性更好的方式来解决这个问题，你只需要在你的中断处理函数前加上这个编译器指令,编译器就会自动在后台处理好将函数地址放入向量表的工作。

#pragma vector 的语法和工作原理

语法格式通常如下：

#pragma vector <中断向量名>
__interrupt void <中断处理函数名>(void)
{
    // 中断服务程序代码
    // ...
}

让我们分解一下这个语法：

• #pragma vector：这是编译器指令的标识。
• <中断向量名>：这是一个由芯片厂商定义的宏，代表一个特定的中断源。TIM2_UP_TIM10_IRQn 可能代表 TIM2 更新中断或 TIM10 中断，你需要查阅你所使用单片机的数据手册或头文件来找到这些宏的正确名称。
• __interrupt：这是一个关键字或编译器指令，用于告诉编译器这个函数是一个中断服务程序，编译器会为这个函数生成特殊的入口和出口代码，
  • 保存上下文：在函数开始时，自动保存当前用到的 CPU 寄存器（如 R0-R15）的值,以便中断返回后能恢复原来的状态。
  • 禁止中断嵌套（可选）：通常在进入中断服务程序后，会自动关闭全局中断，防止自己被其他中断打断,除非你明确地重新开启它。
  • 恢复上下文：在函数返回前,自动恢复之前保存的寄存器值。
  • 执行中断返回指令：使用特殊的指令（如 RETI）而不是普通的 RET 来返回被中断的程序。

工作流程：

1. 编译器在编译代码时，遇到 #pragma vector。
2. 它会查找 <中断向量名> 对应的内存地址（这个地址在中断向量表中有定义）。
3. 编译器会将 <中断处理函数名> 的入口地址,自动填充到中断向量表的对应位置。
4. 当中断发生时，CPU 会自动跳转到向量表中该地址指向的函数，也就是你的 __interrupt 函数。

一个具体的例子（基于 STM32 HAL 库）

这是一个非常典型的使用场景，以 STM32 单片机为例。

场景： 配置 STM32 的外部中断 0，当连接到 PA0 引脚的按键被按下时，触发中断，翻转 PC13 引脚上的 LED 状态。

代码：

#include "stm32f1xx_hal.h" // 包含芯片特定的头文件
// 1. 定义中断处理函数
// 注意：函数名可以自定义，但必须是 void 返回值且无参数
// __attribute__((interrupt)) 是 GCC/ARMCC 常用的替代 __interrupt 的写法
void EXTI0_IRQHandler(void)
{
    // 2. 检查是否是 EXTI0 中断触发的
    // 这是一个好习惯，可以防止误触发
    if (__HAL_GPIO_EXTI_GET_IT(GPIO_PIN_0) != RESET)
    {
        // 3. 清除中断标志位
        // 这一步至关重要！如果不清除，中断会一直重复触发
        __HAL_GPIO_EXTI_CLEAR_IT(GPIO_PIN_0);
        // 4. 在这里执行你的中断处理逻辑
        HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); // 翻转 LED
    }
}
// 在 main.c 中，你需要配置 GPIO 和 EXTI
// (这部分代码通常由 STM32CubeMX 生成)
int main(void)
{
    // ... HAL_Init(), SystemClock_Config() 等初始化代码 ...
    // GPIO 初始化代码 (示例)
    __HAL_RCC_GPIOA_CLK_ENABLE();
    __HAL_RCC_GPIOC_CLK_ENABLE();
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    // 配置 PA0 为输入，上拉
    GPIO_InitStruct.Pin = GPIO_PIN_0;
    GPIO_InitStruct.Mode = GPIO_MODE_IT_RISING; // 设置为上升沿触发中断
    GPIO_InitStruct.Pull = GPIO_PULLUP;
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
    // 配置 PC13 为输出，控制 LED
    GPIO_InitStruct.Pin = GPIO_PIN_13;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);
    // ... NVIC 配置代码 ...
    // 在 STM32 中，你还需要配置嵌套向量中断控制器
    // 使能 EXTI0 中断通道，并设置其优先级
    HAL_NVIC_SetPriority(EXTI0_IRQn, 0, 0); // 设置优先级
    HAL_NVIC_EnableIRQ(EXTI0_IRQn);         // 使能中断
    while (1)
    {
        // 主循环可以执行其他任务，或者进入低功耗模式
        // 当按键按下时，CPU 会自动跳转到 EXTI0_IRQHandler 函数
        HAL_Delay(100);
    }
}

#pragma vector 在 STM32 中的说明：

在上面的 STM32 示例中，你可能没有直接看到 #pragma vector EXTI0_IRQn，这是因为像 STM32 这种复杂的芯片，其中断处理流程通常由 HAL 库或 标准外设库 封装得非常好。

• 库的开发者已经定义了 EXTI0_IRQHandler 这个函数名，并将其放在了启动文件（startup_stm32f1xx.s）的中断向量表中。
• 你要做的，就是重新定义一个同名函数 EXTI0_IRQHandler，当链接器链接你的代码和库文件时，你的函数会覆盖掉库中那个空的“占位符”函数。

在这种高级库的环境下，你通过函数名覆盖的方式来实现中断服务，而不是直接写 #pragma vector。

什么时候会直接用到 #pragma vector 呢？

1. 使用简单的寄存器操作开发：不使用 HAL/LL 库，直接操作寄存器时，你可能需要自己从头开始写中断处理，这时 #pragma vector 就非常有用。
2. 一些资源有限的 8/16 位 MCU：TI 的 MSP430、MSP432 系列单片机，它们的开发中 #pragma vector 是标准用法。

#pragma vector 在其他 MCU 上的示例（MSP430）

让我们看一个更直接使用 #pragma vector 的例子，来自 TI 的 MSP430 系列单片机。

场景： 配置 MSP430 的 Port 1，当 P1.0 引脚的按键被按下时，触发中断，翻转 P1.6 引脚上的 LED 状态。

#include <msp430.h>
// 定义一个 volatile 变量，防止编译器优化掉看似“无用”的代码
volatile unsigned int i;
// 中断服务函数
// 注意这里的语法
#pragma vector=PORT1_VECTOR // 告诉编译器，这个函数属于 PORT1 的中断向量
__interrupt void Port_1(void) // __interrupt 是 MSP430 的关键字
{
    // 检查是否是 P1.0 引脚触发的中断
    if (P1IFG & BIT0)
    {
        // 清除 P1.0 的中断标志位
        P1IFG &= ~BIT0;
        // 翻转 P1.6 的 LED
        P1OUT ^= BIT6;
    }
}
int main(void)
{
    WDTCTL = WDTPW + WDTHOLD; // 停止看门狗定时器
    // 配置 P1.0 为输入，上拉
    P1DIR &= ~BIT0; // P1.0 为输入
    P1OUT |= BIT0;  // P1.0 使能上拉电阻
    P1REN |= BIT0;  // P1.0 使能内部电阻
    // 配置 P1.6 为输出
    P1DIR |= BIT6;   // P1.6 为输出
    P1OUT &= ~BIT6; // 初始状态为低电平，LED 灭
    // 使能 P1.0 的中断，下降沿触发
    P1IE |= BIT0;   // 使能 P1.0 中断
    P1IES |= BIT0;  // 设置为下降沿触发 (按键按下时，电平从高变低)
    P1IFG &= ~BIT0; // 清除 P1.0 的中断标志位
    // 全局中断使能
    _BIS_SR(GIE); // 等同于 __enable_interrupt();
    while (1)
    {
        // 主循环可以进入低功耗模式
        // LPM3 是一个常用的低功耗模式，CPU 停止，但外设和中断仍然工作
        _BIS_SR(LPM3_bits + GIE);
        // 当中断发生时，CPU 会唤醒，执行 ISR，然后返回这里继续执行 LPM3
        __no_operation(); // 只是为了方便调试，看汇编代码
    }
}

在这个 MSP430 的例子中，#pragma vector=PORT1_VECTOR 就非常直观地告诉编译器：“Port_1 这个函数就是 PORT1_VECTOR（端口1中断向量）的服务程序。”