基于Nucleo-STM32L476RG的WolfSSL编译报错：stm32f4xx_hal.h缺失

问题根源 #

你使用的是STM32L4系列开发板，但wolfSSL编译配置错误触发了STM32F4的代码分支（启用了WOLFSSL_STM32F4宏），导致代码尝试包含F4系列的HAL头文件，而你的工程仅包含L4系列的HAL库，因此报错。直接注释代码分支会破坏预编译逻辑，引发连锁错误。

解决方案 #

1. 修正wolfSSL的硬件宏定义

   • 移除编译配置中的WOLFSSL_STM32F4宏，添加适配L4系列的宏：
     • 若使用HAL库，添加WOLFSSL_STM32L4和WOLFSSL_STM32HAL
   • 操作方式：
     • CubeMX配置：在Project Settings → Toolchain/IDE → Defines中修改宏列表
     • 手动修改Makefile：在CFLAGS中加入-DWOLFSSL_STM32L4 -DWOLFSSL_STM32HAL，删除-DWOLFSSL_STM32F4

2. 确认HAL库路径配置

   • 确保编译系统能找到STM32L4的HAL头文件，检查Makefile中的INCLUDE路径，确认包含Drivers/STM32L4xx_HAL_Driver/Inc及其子目录

3. 排除无关硬件port文件编译

   • 报错显示工程在编译atmel、stsafe等非STM32L4的port文件，这些是其他硬件的适配代码，需排除：
     • 修改subdir.mk或Makefile，仅保留wolfcrypt/src/port/st/stm32.c这类适配STM32的文件
     • 或在编译宏中禁用WOLFSSL_STSAFE、WOLFSSL_ATMEL，关闭对应硬件支持

4. 禁用不必要的测试代码（可选）

   • 若仅需建立TLS连接，无需编译wolfSSL的测试代码，添加WOLFSSL_NO_TEST宏，避免编译test.c等测试文件

内容的提问来源于stack exchange，提问作者Yasantha Biyuranga