STM32L471RET6基于HAL API的Bank Swap功能失效问题求助

核心问题分析 #

你的代码存在解锁逻辑不完整的关键问题：仅在关闭BFB2的分支执行了解锁操作，而开启BFB2的分支完全没有解锁FLASH控制器和Option Bytes区域。STM32L4系列要求修改Option Bytes前必须先完成这两步解锁，否则硬件会直接拒绝编程操作，导致Option Bytes无任何变化。

此外，STM32L4与L0的HAL库在Option Byte编程的细节上存在差异，需确保参数设置的完整性。

修复后的代码 #

HAL_StatusTypeDef SwapBank(void)
{
    FLASH_OBProgramInitTypeDef OB;
    HAL_StatusTypeDef status = HAL_OK;

    // 获取当前Option Bytes配置
    HAL_FLASHEx_OBGetConfig(&OB);

    // 确认当前处于双Bank模式
    if (!(OB.USERConfig & OB_DUALBANK_DUAL))
    {
        return HAL_ERROR;
    }

    // 统一解锁FLASH和Option Bytes（无论开启/关闭BFB2都需要）
    HAL_FLASH_Unlock();
    if (HAL_FLASH_OB_Unlock() != HAL_OK)
    {
        HAL_FLASH_Lock();
        return HAL_ERROR;
    }

    // 设置BFB2的目标状态
    OB.OptionType = OPTIONBYTE_USER;
    OB.USERType = OB_USER_BFB2;
    if (OB.USERConfig & OB_BFB2_ENABLE)
    {
        OB.USERConfig = OB_BFB2_DISABLE;
    }
    else
    {
        OB.USERConfig = OB_BFB2_ENABLE;
    }

    // 编程Option Bytes
    status = HAL_FLASHEx_OBProgram(&OB);
    if (status != HAL_OK)
    {
        // 出错时先锁定硬件再返回
        HAL_FLASH_OB_Lock();
        HAL_FLASH_Lock();
        return status;
    }

    // 触发Option Bytes加载，锁定硬件，重启生效
    HAL_FLASH_OB_Launch();
    HAL_FLASH_OB_Lock();
    HAL_FLASH_Lock();   
    NVIC_SystemReset();

    return HAL_OK;
}

额外排查要点 #

• 双Bank模式确认：STM32L471RET6的Flash为512KB，支持双Bank（256KB/Bank），需确保Option Bytes中的DBANK位已设置为1。若未开启，需先通过STM32CubeProgrammer或代码开启双Bank模式。
• HAL库版本验证：确保使用的STM32L4 HAL库版本适配L471系列，老旧版本可能存在Option Byte编程的兼容性问题。
• 硬件写保护检查：确认开发板未启用Flash硬件写保护（部分板子通过BOOT引脚或跳线控制写保护状态）。
• 错误码定位：调用HAL_FLASHEx_OBProgram失败后，可通过HAL_FLASH_GetError()获取具体错误码，快速定位问题（如FLASH_ERROR_WRP表示写保护触发，FLASH_ERROR_OPTV表示Option Byte验证错误）。

内容的提问来源于stack exchange，提问作者Mehdi Sadeghi