1. BootSwap和 DisJTAG 原理

BootSwap 用于切换芯片下一次启动使用的 Flash Bank，DisJTAG 用于关闭 JTAG/SWD 调试连接。

CUSNVR：CUS_NVR（Customized NVR）是芯片中存放客户定制信息的非易失性 Flash 区域，断电后数据保留，也用于保存调试口禁用和、Flash 地址保护和BOOT_SWAP配置。

BootSwap：A/B面切换。 芯片把BOOT_SWAP配置保存在 CUS_NVR 中。程序调用BootSwap命令后会更改CUSNVR中的BOOT_SWAP字节段的内容**（A面是0xFF，B面是0x5A）**来实现A/B面的切换

DisJTAG：决定是否允许调试器连接。 芯片把调试禁用配置同样保存在 CUS_NVR 中。程序通过更改CUSNVR中的Disable JTAG字节段的内容**（禁用是0x5A，启用是0xFF)**来实现调试口的状态。

芯片差异说明： MD14 的 BootSwap 与 DisJTAG 配置均保存在 CUS_NVR 中，因此对该区域的擦写可能影响另一项配置。L 系列不支持 BootSwap；M 系列的其他芯片将 BootSwap 配置保存在 BOOTNVR 中，DisJTAG 配置保存在 CUSNVR 中，两项配置位于不同的存储区域，不存在因共用同一配置区域而产生的擦写影响。下文的组合使用注意事项及处理方案仅针对 MD14 芯片。

2. BootSwap 和 DisJTAG 组合使用注意事项

2.1 B→A 切换时会清除原调试配置

《YTM32B1MD1x_RM》“Embedded Flash Module (EFM) → Boot Swap Operation”说明：

即：如果 STS [BOOT_INFO] 为 1，在执行 BOOT_SWAP 命令后，CUS_NVR 将会被擦除，这意味着用户需要重新配置 Disable_JTAG/SSWD 以及地址保护（Address_Protection）。

例如：当芯片所在程序位于B面且调试口的状态为禁用时，如果此时执行BootSwap命令此时CUSNVR中调试字节段上的内容0x5A（禁用调试口）会被擦除变成0xFF（启用调试口），调试口的状态就由禁用变成了启用

2.2 Disable Jtag可能误修改 Boot Swap

执行CUSNVR写入操作之前需要执行CUSNVR擦除操作，但CUSNVR擦除以扇区为单位，代码中的 FLASH_DRV_EraseNVR() 会清空整个 1 KB CUS_NVR 扇区。如果擦除后只向其中的调试字段写入 0x5A5A5A5A5A5A5A5A，其他原有配置就没有被保留下来。

所以代码需要通过“先保存、再修改、最后写回”处理这个影响：

1. 将整个 1 KB 扇区读到 RAM 中。

2. 在 RAM 中只修改调试字段，保留其余内容。

3. 擦除 CUS_NVR，再将修改后的整个扇区写回。

在读取、擦除和编程均成功的条件下，这个流程可以保留调用时的其他配置。Enable_Jtag() 采用相同流程，只是把调试字段改为全 1。这说明组合使用时要处理好共享区域的擦写，不能仅凭一次擦除操作推断 BootSwap 一定会被改变。

3. BootSwap 和 DisJTAG 并行组合方案

程序执行流程介绍

程序主线如下：

Board_Init()
    → 初始化时钟、引脚、Flash 和 UART 日志
    → 启用 GPIOB/GPIOC 中断
    → 读取 BlockFlag()，打印当前 Bank 及 CTRL_OVRD
    → 进入无限循环：
         根据 BlockFlag() 翻转绿灯或红灯，延时约 1 秒
         → 处理 SwFlag：按当前 Bank 选择切换路径
         → 处理 Jtag_log：执行共用的调试开关逻辑

Board_Init() 当前没有检查初始化调用的返回值。串口使用 LINFlexD2，115200、8 数据位、无校验、1 停止位。LED 每隔约 1 秒翻转一次，完整亮灭周期约为 2 秒；按键请求在主循环延时结束后处理。

3.2 同一份代码如何判断当前启动面

BlockFlag() 的定义为：

#define BlockFlag() ((EFM->STS & EFM_STS_BOOT_INFO_MASK) >> EFM_STS_BOOT_INFO_SHIFT)
#define ABANKFlag   0
#define BBANKFlag   1

该宏读取 EFM->STS 的 BOOT_INFO 位，将返回值与 ABANKFlag、BBANKFlag 比较。初始化、按键中断、Flash 驱动、NVR 缓冲区和调试开关函数均共用；运行时按当前状态选择 LED 和切换处理。

3.3 共用的按键中断与请求标志

SW2 为 PB2 上升沿中断，SW3 为 PC1 上升沿中断，Flash 操作均在主循环执行：

GPIOB_IRQHandler() 检查 PTB2 标志，设置 SwFlag=1 并清除引脚中断标志；GPIOC_IRQHandler() 对 PTC1 执行相同处理，设置 Jtag_log=1。Jtag_log 是调试开关请求标志，并非日志缓冲区。

3.4 共用的 Disable_Jtag 与 Enable_Jtag

3.4.1 Disable_Jtag：先读取整扇区，再修改并写回

当前禁用函数如下图所示：

FEATURE_EFM_NVR_ARRAY_SECTOR_SIZE=0x400，缓冲区为 volatile uint32_t CUS_NVR_data[256]。逻辑修改范围是调试字段的 8 字节，实际读取和编程范围均为整个 1 KB 扇区。

在读取、擦除和编程均成功的条件下，函数可以保留CUSNVR中写保护和BootSwap配置

3.4.2 Enable_Jtag：将调试字段改为全 1 后整扇区写回

当前启用函数如下：

在读取、擦除和编程均成功的条件下，函数可以保留CUSNVR中写保护和BootSwap配置

3.5 A 面处理：切换后直接复位，不重建调试禁用字段

SW2 请求进入主循环后，先执行 SwFlag=0。当 BlockFlag()==ABANKFlag 时，进入 A 面分支：

当前执行顺序为：

1. 调用 FLASH_DRV_BootSwap(FLASH_INST)，其中 FLASH_INST=0。

2. 若返回 STATUS_SUCCESS，立即调用 SystemSoftwareReset()。

3. 若返回非成功，打印 Boot swap failed, status: ...。

4. 失败路径随后仍会执行 SW2 处理末尾共用的 SystemSoftwareReset()。

A 面分支没有调用 Disable_Jtag()，切换后直接请求复位。 原因是正常 A→B 场景的切换前 BOOT_INFO=0，不满足手册所述“BOOT_INFO=1 时正常 Boot Swap 擦除 CUS_NVR”的条件，所以没有采用 B 面同样的正常切换补偿。

3.6 B 面处理：切换后按条件重建调试禁用字段，再复位

当 BlockFlag()==BBANKFlag 时，进入 B 面分支：

当前执行顺序为：

1. 调用 FLASH_DRV_BootSwap(0)。

2. 切换命令返回后，判断 EFM->CTRL_OVRD==0x02。

3. 条件成立时，调用共用的 Disable_Jtag()，重新写入调试禁用配置。

4. 执行 SW2 处理末尾共用的 SystemSoftwareReset()。

B 面比 A 面多了一步“切换后、复位前重建调试禁用配置”。 这是因为 B→A 的切换前 BOOT_INFO=1，正常 Boot Swap 本身就会擦除 CUS_NVR。原禁用字段一旦被清除，直接复位就不能依靠原 NVR 值保持禁用状态，因此需要在切换命令结束后重新写入。

调用顺序是关键：

A 面：BlockFlag() == 0
    → Boot Swap
    → 请求软件复位

B 面：BlockFlag() == 1
    → Boot Swap（该状态下会擦除 CUS_NVR）
    → CTRL_OVRD == 0x02 时调用 Disable_Jtag()
         读取切换后的整个扇区
         修改调试禁用字段
         擦除并整扇区写回
    → 请求软件复位

如果先写禁用值，再执行会擦除 CUS_NVR 的切换命令，刚写入的值仍可能被清除。因此，补偿必须放在切换之后、复位之前。若切换返回时 CTRL_OVRD 不等于 0x02，当前 B 面分支跳过补偿，直接请求复位。

3.7 两条切换路径的差异汇总

两条路径共用请求标志、NVR 缓冲区、调试开关函数及 Flash 驱动。主要区别来自切换前的硬件 Bank 状态，以及 B→A 擦除 CUS_NVR 后增加的补偿操作。

3.7.1 补偿能恢复什么

Disable_Jtag() 会保留调用时读到的其他字段，但 B 面补偿中的读取发生在 Boot Swap 之后。若切换前的地址保护等配置已经被擦除，函数无法从切换后的 NVR 恢复其原值。

当前实现重建的是调试禁用字段，没有在切换前备份并恢复全部 CUS_NVR 配置。此外，补偿依据切换后的整个 CTRL_OVRD 值是否恰好为 0x02，没有提前保存调试策略，也没有只按 bit 1 掩码判断。

3.8 SW3 触发的调试开关：A/B 面共用相同流程

SW3 处理没有使用 BlockFlag() 分支，而是清除 Jtag_log 后，直接依据 CTRL_OVRD 执行相同逻辑：

4.测试验证

4.1 将程序烧录到 PFlash0

4.1.1 加载当前工程编译产物

将当前工程编译生成的镜像加载到 J-Flash。当前程序按逻辑地址 0x00000000 链接，可将同一编译产物分别烧录到两个物理 Bank，运行时由 BlockFlag() 区分当前启动面。

4.1.2 擦除并烧录 PFlash0

在初始调试连接可用、Bank 映射为默认状态时，先完成芯片擦除，再把当前镜像烧录到 PFlash0。擦除和编程命令以当前 J-Flash 版本及配置为准。

4.2 将同一程序烧录到 PFlash1

4.2.1 设置地址偏移

《YTM32B1MD1x_DS》说明 PFlash 总大小为 512 KB，由两个 256 KB Block 组成；当前 SDK 定义的主 Flash 地址范围为 0x00000000～0x0007FFFF。

使用同一份按零地址链接的镜像。在默认 Bank 映射下，将镜像的烧录地址整体偏移 0x00040000，使其放入 PFlash1。这里修改的是烧录位置，不是将代码重新链接到 0x00040000；已处于交换映射时需先核对当前物理 Bank 对应关系。

4.2.2 烧录 PFlash1

完成 PFlash1 烧录，保留已经写入 PFlash0 的程序，避免在此步骤再次整片擦除。

4.3 重新上电与基本操作

• BlockFlag()==0 时，程序按 A 面逻辑运行，PB5 绿灯约每 1 秒翻转一次。

• BlockFlag()==1 时，同一程序按 B 面逻辑运行，PE8 红灯约每 1 秒翻转一次。

• 按 SW2 切换执行BootSwap操作，切换程序的启动面。

• 按 SW3 切换调试口的状态。

串口打印数据如下：

项目代码

project.zip