48.STM32内联函数

一、STM32中内联函数的典型使用示例

在STM32编程中，内联函数最常用于寄存器操作、位操作、高频小功能等场景，以下是几个实用且符合嵌入式最佳实践的例子：

示例1：寄存器读写（最常用）

// 头文件中定义 static inline 寄存器读写函数（STM32F103为例） #ifndef __REG_UTILS_H #define __REG_UTILS_H #include "stm32f10x.h" // static inline 保证仅当前文件可见，避免多重定义 static inline uint32_t stm32_reg_read(volatile uint32_t *reg_addr) { // 小函数（1行），高频调用，适合内联 return *reg_addr; } static inline void stm32_reg_write(volatile uint32_t *reg_addr, uint32_t value) { *reg_addr = value; } // GPIO位操作（小函数，高频调用） static inline void stm32_gpio_set_pin(GPIO_TypeDef *gpio_port, uint16_t pin) { gpio_port->BSRR = pin; // 直接操作BSRR寄存器置位引脚 } static inline void stm32_gpio_reset_pin(GPIO_TypeDef *gpio_port, uint16_t pin) { gpio_port->BRR = pin; // 直接操作BRR寄存器复位引脚 } #endif

使用场景：在主循环、中断服务函数中高频读写寄存器（比如每秒调用上千次的GPIO状态读取），内联后消除函数调用开销，保证实时性。
编译效果：调用stm32_gpio_set_pin(GPIOA, GPIO_Pin_0)时，编译器直接生成STR r1, [r0, #0x10]（BSRR寄存器地址偏移）指令，无BL调用指令。

示例2：简单数学/位运算

// STM32中常用的字节序转换（小函数，高频调用） static inline uint16_t stm32_swap16(uint16_t data) { return (data << 8) | (data >> 8); } // 位掩码生成（比如外设配置） static inline uint32_t stm32_gen_mask(uint8_t start_bit, uint8_t bit_len) { return ((1U << bit_len) - 1) << start_bit; }

使用场景：串口/ SPI通信中的字节序转换、外设寄存器掩码配置，内联后编译器可直接将常量代入计算（比如stm32_gen_mask(4, 3)直接编译为0x70），优化效果优于宏。

二、STM32中内联函数不起作用的场景

inline只是编译器的“建议”，以下情况编译器会直接忽略内联请求，即使写了inline也不会生效：

1. 函数体复杂（包含循环/递归/大分支）

编译器会判断函数“内联收益 < 代码膨胀成本”，拒绝内联：

// 不会内联：包含循环，函数体过大 static inline uint32_t stm32_calc_sum(uint32_t *buf, uint16_t len) { uint32_t sum = 0; // 循环导致函数体复杂，编译器拒绝内联 for (uint16_t i = 0; i < len; i++) { sum += buf[i]; } return sum; }

2. 编译器开启“代码尺寸优先”优化（-Os）

STM32开发中，若在MDK/STM32CubeIDE中选择-Os（优化等级：减小代码尺寸），编译器会优先拒绝内联非必要函数，即使是小函数：

• 比如：static inline uint32_t reg_read(volatile uint32_t *reg) { return *reg; }
• 开启-Os后，若该函数仅被调用1-2次，编译器会拒绝内联，以节省Flash空间。

3. 函数被取地址（用于函数指针）

若将内联函数的地址赋值给函数指针，编译器必须生成函数的独立副本，无法内联：

static inline uint32_t reg_read(volatile uint32_t *reg) { return *reg; } // 取函数地址，导致内联失效 uint32_t (*read_func)(volatile uint32_t *) = reg_read; // 调用 read_func(GPIOA->IDR) 时，执行的是独立函数副本，非内联

4. 仅写inline未写static（多文件包含场景）

若仅定义inline uint32_t reg_read(...)（无static），当该头文件被多个.c文件包含时：

• 编译器为了避免多重定义错误，会强制生成函数的独立副本，拒绝内联。
• 这也是为什么STM32中必须用static inline的核心原因。

5. 调试模式（-O0）

开发中开启-O0（无优化，方便调试）时，编译器会忽略所有内联建议，保留函数的独立调用形式，方便设置断点调试：

• 比如：在MDK中选择“Debug”配置，默认-O0，所有inline函数均不生效；
• 切换到“Release”配置（-O2/-Os），内联才会根据规则生效。

6. 函数包含特殊指令/属性

若内联函数包含asm内嵌汇编、__attribute__((noinline))属性，或调用了longjmp/setjmp等函数，编译器会拒绝内联：

// 包含asm汇编，内联失效 static inline void delay_us(uint32_t us) { __asm volatile ( "mov r0, %0\n" "loop: subs r0, #1\n" "bne loop\n" : : "r"(us) : "r0" ); }

三、验证STM32内联函数是否生效的方法

在STM32开发中，可通过以下方式确认内联是否生效：

• 反汇编查看：
• • MDK：编译后，打开*.elf文件，进入“Disassembly”窗口，查看调用处是否有BL指令：

• • • 内联生效：调用处直接显示函数体的指令（如LDR r0, [r1]）；
    • 内联失效：调用处显示BL reg_read（跳转指令）。
• 编译器警告/日志：
• • 在STM32CubeIDE中添加编译选项-Winline，编译器会对未内联的inline函数发出警告：

warning: inlining failed in call to 'reg_read': function not inlinable

总结

1. STM32中内联函数适合：小函数（<10行）、高频调用（寄存器读写/位操作）、用static inline定义；
2. 内联失效的核心场景：函数复杂（循环/递归）、编译器优化等级为-Os/-O0、函数被取地址、无static修饰、包含特殊指令；
3. 实际开发中，需结合“优化等级 + 函数复杂度 + 调用次数”选择内联，且通过反汇编验证生效状态，平衡性能和Flash占用。