Keil5 下编译 RFAL V2.8.0 时遇到的失败问题，主要源于工程配置、头文件包含路径、宏定义以及平台适配文件缺失或不正确。以下是针对常见编译错误的系统性解决方案，基于移植RFAL库至STM32F103C8T6的典型流程[ref_1]。 ## 一、常见编译错误与根因分析 编译失败通常由以下几类问题导致，其症状与解决方案如下表所示： | 错误症状 | 可能原因 | 解决方案 | | :--- | :--- | :--- | | `fatal error: 'platform.h' file not found` | V2.8.0 版本已弃用 `platform.h`，改用 `rfal_platform.h`[ref_1]。 | 创建或正确配置 `rfal_platform.h` 文件。 | | `error: #5: cannot open source input file "stm32f4xx_hal.h"` | 头文件包含路径错误，或平台宏定义未正确设置[ref_1]。 | 在Keil中正确添加包含路径，并修改平台宏。 | | 大量未定义标识符错误 (如 `HAL_SPI_*`, `__IO`) | 未正确包含对应MCU系列的HAL库头文件，或未将HAL库源文件加入工程。 | 根据目标MCU（如STM32F103）包含正确的头文件，并确保HAL库已链接。 | | `rfal_*.c` 文件中的编译错误 | `rfal_platform.h` 或 `rfal_defConfig.h` 中的配置与硬件或HAL库不匹配。 | 仔细检查并适配平台配置文件和默认配置文件。 | | 链接错误（如 `undefined symbol st25r3911Isr`）| 中断处理函数未在工程中实现或声明，或相关源文件未加入编译。 | 在外部中断服务函数中调用 `st25r3911Isr()`，并确保所有必要文件已添加[ref_1]。 | ## 二、分步解决方案 ### 1. 解决 `platform.h` 缺失问题 RFAL V2.8.0 使用 `rfal_platform.h` 作为平台适配层接口，而非旧的 `platform.h`[ref_1]。 * **操作**：在工程中（例如 `Middlewares/ST/rfal/` 目录下）创建或复制一份 `rfal_platform.h` 文件。 * **关键配置**：在该文件中，你需要包含正确的HAL库头文件，并实现或指向必要的平台函数（如延时、GPIO控制等）。**特别注意**：`rfal_defConfig.h` 应放在所有定义之后包含，以避免重复定义错误[ref_1]。 一个针对 **STM32F103** 的 `rfal_platform.h` 基础框架示例如下： ```c /* rfal_platform.h */ #ifndef RFAL_PLATFORM_H #define RFAL_PLATFORM_H #ifdef __cplusplus extern "C" { #endif /* 1. 包含目标MCU的HAL头文件 [ref_1] */ #include "stm32f1xx_hal.h" // 根据你的MCU系列修改，这里是STM32F1 /* 2. 包含RFAL核心头文件 */ #include "rfal.h" /* 3. 在此处定义或声明你的平台特定函数和宏， 例如：延时函数、SPI读写、中断使能/禁止等 */ /* 示例：定义一个毫秒延时宏，指向你的HAL_Delay */ #define PLATFORM_DELAY_MS(ms) HAL_Delay(ms) /* 4. 最后包含默认配置头文件 [ref_1] */ #include "rfal_defConfig.h" #ifdef __cplusplus } #endif #endif /* RFAL_PLATFORM_H */ ``` ### 2. 修正头文件包含路径和宏定义 Keil工程中的设置至关重要。 * **包含路径 (Include Paths)**： 打开“Options for Target” -> “C/C++” -> “Include Paths”，确保添加以下路径（根据你的实际工程结构调整）： * 你的 `HAL/LL` 库目录（如 `Drivers/STM32F1xx_HAL_Driver/Inc`）。 * `Middlewares/ST/rfal` 目录。 * `Drivers/BSP/Components/st25r3911` 目录。 * 你存放 `logger.h`, `spi.h` 等从示例工程复制过来的文件的目录[ref_1]。 * **预处理器宏 (Preprocessor Symbols)**： 在“Options for Target” -> “C/C++” -> “Preprocessor Symbols” 的 `Define` 框中，添加必要的宏。根据博文建议，通常需要[ref_1]： * `USE_LOGGER=LOGGER_ON` （如果你需要使用日志功能） * `ST25R3911` （明确使用ST25R3911B芯片） * 你的MCU系列宏，例如：`STM32F103xB` （具体型号请参考数据手册）。 ### 3. 修正平台相关的源文件包含 你遇到的 `#include "stm32f4xx_hal.h"` 错误，是因为原始的示例工程或RFAL配置是针对STM32F4或L4系列的。你需要根据你的MCU修改。 * **操作**：检查所有从示例工程复制的文件（如 `platform.h` 或你创建的 `rfal_platform.h`，以及 `spi.c`, `timer.c` 等），将其中的HAL头文件包含语句改为针对 **STM32F1** 系列的。 * **示例**：将原有的条件编译修改为： ```c /* 在你的平台适配文件中，例如原 platform.h 或新的 rfal_platform.h 中 */ /* 删除或注释掉原有的F4/L4判断，直接包含F1的头文件 */ #include "stm32f1xx_hal.h" // #ifdef STM32L476xx // #include "stm32l4xx_hal.h" // #else // #include "stm32f4xx_hal.h" // #endif ``` ### 4. 添加必要的中断处理函数 ST25R3911B 需要通过外部中断引脚与MCU通信。你必须在MCU的外部中断服务例程(IRQHandler)中调用RFAL库提供的中断处理函数。 * **操作**：找到并打开你的 `stm32f1xx_it.c` 文件，在对应的外部中断服务函数中添加以下代码[ref_1]： ```c /* stm32f1xx_it.c */ #include "st25r3911.h" // 确保能访问中断处理函数声明 void EXTIx_IRQHandler(void) // ‘x’对应你的中断线号，例如 EXTI4_IRQHandler { /* 处理MCU EXTI中断标志 */ if(__HAL_GPIO_EXTI_GET_IT(你的_GPIO_PIN) != RESET) { __HAL_GPIO_EXTI_CLEAR_IT(你的_GPIO_PIN); /* 调用ST25R3911B的中断服务程序 [ref_1] */ st25r3911Isr(); } // ... 其他中断处理 } ``` ### 5. 关于 `#include "rfal_t4t.h"` 缺失的问题 `rfal_t4t.h` 是RFAL库中用于处理 **NFC Forum Type 4 Tag** 功能的头文件。如果您的应用不需要与Type 4标签通信，则可能不需要它。如果需要： * **确认**：在 `en.STSW-ST25RFAL001` 的源代码包中，检查 `Middlewares/ST/rfal/st25r3911` 或 `Middlewares/ST/rfal/util` 等目录下是否存在 `rfal_t4t.h` 和 `rfal_t4t.c` 文件。 * **操作**：如果存在，确保它们已被复制到你的工程目录中，并且 `rfal_t4t.c` 已加入Keil工程的编译组（例如添加到 `Middlewares/ST/rfal` 分组中）。同时，在需要调用T4T功能的源文件中正确包含 `#include "rfal_t4t.h"`。 ## 三、编译检查清单 完成以上步骤后，请按此清单复查： 1. [ ] 所有必要的 `.c` 文件（RFAL库、ST25R3911驱动、从示例工程复制的 `logger.c`, `spi.c` 等）都已添加到Keil工程对应的分组中[ref_1]。 2. [ ] 头文件包含路径已正确设置，包含了HAL库、RFAL、BSP组件等所有目录。 3. [ ] 预处理器宏 `ST25R3911` 和 `USE_LOGGER=LOGGER_ON`（如需要）已正确定义。 4. [ ] `rfal_platform.h` 文件已创建并正确配置，包含了 `stm32f1xx_hal.h` 且最后包含了 `rfal_defConfig.h`[ref_1]。 5. [ ] 中断服务函数中已添加 `st25r3911Isr()` 调用。 6. [ ] 全局搜索并修改了所有残留的 `stm32f4xx_hal.h` 或 `stm32l4xx_hal.h` 包含语句，改为 `stm32f1xx_hal.h`。 通过系统性地排查和修正上述环节，可以解决绝大多数 Keil5 下编译 RFAL V2.8.0 的失败问题。核心在于确保平台适配文件 (`rfal_platform.h`) 的正确性，以及工程配置与目标硬件（STM32F103 + ST25R3911B）的完全匹配[ref_1]。