一、默认调试方式说明
AG32 工程默认采用 PlatformIO 内置pio-debug工具完成程序调试，直接通过 PIO 调试入口即可启动调试会话。
从 SDK1.5.2 版本起，官方新增支持cortex-debug调试插件。相较于原生pio-debug，该插件功能更完善，具备实时变量监视(Live Watch)、RTOS 可视化信息面板等特色调试功能，大幅提升嵌入式开发调试效率。
二、cortex-debug 启用完整步骤
步骤 1：VSCode 安装 cortex-debug 插件
在 VSCode 扩展市场搜索并安装cortex-debug官方插件。
步骤 2：修改工程 platformio.ini 配置
打开项目根目录platformio.ini配置文件，在[setup]分区下添加对应配置参数，复制下述配置保存文件即可生效。
配置文本可直接复制使用，无需图片录入
步骤 3：启动 cortex-debug 调试会话
配置保存完成后，打开 VSCode 调试下拉列表，会自动新增三组 cortex-debug 调试选项。
选中对应 Debugger 条目，点击界面绿色启动三角按钮，即可进入 cortex-debug 专属调试界面。
三、cortex-debug 与 pio-debug 核心差异对比
两款调试工具区别主要体现在 VSCode 侧边栏与底部调试面板，核心功能差距如下：
CORTEX LIVE WATCH(核心优势)
cortex-debug 侧边栏新增该功能菜单，支持变量实时动态监视，是对比 pio-debug 最核心的提升点;
XPERIPERALS 外设寄存器面板
替代原有 pio-debug 的 PERIPERALS 外设查看菜单，功能与外设寄存器查看能力基本持平。