Raspberry Pi Pico SDK中关于__not_in_flash_func宏的注意事项

在Raspberry Pi Pico SDK开发过程中，开发者有时需要将特定函数从闪存(Flash)移动到RAM中执行，这通常是为了提高关键代码的执行速度或满足实时性要求。SDK提供了__not_in_flash_func宏来帮助实现这一功能，但使用时需要注意一个重要细节。

问题背景

当开发者使用__not_in_flash_func宏标记函数时，期望该函数不会被放置在闪存中。然而，在某些情况下，即使使用了这个宏，函数仍然可能被编译器优化为内联函数，导致代码实际上还是留在了闪存中。

原因分析

__not_in_flash_func宏的主要作用是改变函数的存储位置，但它并不自动包含防止内联的功能。现代编译器(如GCC)会积极进行优化，包括自动内联小型函数。当函数被内联时，它的代码会被直接插入到调用位置，而不再作为一个独立函数存在，这使得__not_in_flash_func的效果失效。

解决方案

Pico SDK实际上提供了专门的宏__no_inline_not_in_flash_func来解决这个问题。这个宏不仅确保函数不会存储在闪存中，还会阻止编译器将其内联。对于需要确保函数既不在闪存中又不会被内联的情况，应该使用这个宏。

实际应用建议

1. 对于性能关键且需要快速执行的代码，使用__no_inline_not_in_flash_func宏
2. 如果只是希望函数不在闪存中，但不介意是否内联，可以使用__not_in_flash_func
3. 另一种替代方案是将函数放在单独的编译单元中，但这会增加项目复杂度

最佳实践

在Pico开发中，当需要将中断服务程序(ISR)或其他时间敏感的代码放入RAM时，建议总是使用__no_inline_not_in_flash_func宏，这样可以确保：

• 代码确实从闪存移动到RAM
• 函数不会被意外内联
• 保持预期的函数调用行为

理解这些宏的细微差别对于开发高性能Pico应用程序非常重要，特别是在实时性要求高的场景中。