3. STM32N6开发环境搭建与工程创建

STM32N6 是 ST 首款集成自研 NPU 的 MCU，图形 HMI 与边缘 AI 是它的两条主线。围绕这两条主线，官方工具链被拆成四个角色：STM32CubeMX 负责引脚、时钟、外设与中间件的图形化配置并生成初始化代码；STM32CubeIDE 负责代码编辑、编译、下载与调试；STM32CubeProgrammer 负责烧录、读保护、外部 Flash 与 OTP 操作；TouchGFX Designer 负责 UI 画面、控件与交互逻辑的可视化设计。四者不是并列关系，而是"配置 → 生成 → 编码 → 设计 UI → 烧录验证"的接力关系，理解这条链路比记住安装步骤更重要。

一、安装顺序与版本匹配

推荐安装顺序为：STM32CubeMX → STM32CubeIDE → STM32CubeProgrammer → TouchGFX Designer（或 X-CUBE-TOUCHGFX 扩展包）。原因是 CubeIDE 内置了 CubeMX 的部分能力，但独立版 CubeMX 的器件包管理更完整；TouchGFX 需要识别 CubeMX 生成的 .ioc 文件，因此必须后装。

版本匹配是新手最容易踩的坑。以示例环境为例（以下版本号仅为教学示例，实际请以 ST 官网当前发布为准）：

安装时统一选择默认路径，避免中文路径与空格。若使用 Windows，建议关闭杀毒软件对安装目录的实时扫描，否则 CubeIDE 首次索引器件包会明显变慢。

二、用 CubeMX 创建首个 N6 工程

打开 CubeMX，选择 File → New Project，在 Part Number 搜索框输入 STM32N657X0H3Q（示例型号，N6 系列常见封装之一）。选中后进入 Pinout 视图，按以下顺序配置：

1. 调试接口：SYS → Debug 选择 Serial Wire，否则下载一次后可能锁死 SWD。
2. 时钟源：RCC → HSE 选择 Crystal/Ceramic Resonator，N6 通常外接 24 MHz 晶振。
3. 时钟树：在 Clock Configuration 中把 CPU 时钟设为 800 MHz（示例目标），注意 PLL 分频系数需与晶振频率匹配，CubeMX 会用红色标出超限项。
4. 图形外设：启用 LTDC，配置像素时钟、时序参数（HSYNC/VSYNC/前后沿），并绑定到实际屏幕分辨率，例如 800×480。
5. 中间件：在 Middleware 中勾选 TouchGFX，选择图形模式与显存布局。

配置完成后，在 Project Manager 中设置工程名（如 N6_HMI_Demo）、路径、工具链为 STM32CubeIDE，并勾选 Generate peripheral initialization as a pair of .c/.h files。点击 GENERATE CODE，CubeMX 会输出完整的工程骨架，包括 main.c、stm32n6xx_hal_msp.c、.ioc 与 TouchGFX 相关目录。

三、在 CubeIDE 中编译与首次下载

用 CubeIDE 打开 CubeMX 生成的工程目录，选择 File → Open Projects from File System，指向工程根目录。首次打开会自动索引，完成后在 Project → Build All 编译。若报错找不到器件头文件，检查 Project → C/C++ Build → Settings → MCU Settings 中器件是否被正确识别为 STM32N657X0H3Q。

编译成功后生成 .elf 与 .bin。连接开发板，在 Run → Debug Configurations 中新建 STM32 Cortex-M C/C++ Application，选择 ST-LINK 调试器，接口为 SWD，速度建议先降到 4000 kHz 提高稳定性。点击 Debug，若能在 main() 断点处停下，说明工具链、调试器、目标板三者已打通。

四、用 CubeProgrammer 完成外部 Flash 烧录

打开 CubeProgrammer，连接方式选 ST-LINK，点击 Connect。在左侧 External Loader 中选择与开发板匹配的 loader（例如针对板载 Octal-SPI NOR Flash 的 loader），然后：

1. 选择 External Loader → 确认 Flash 型号与容量
2. 打开 Erasing & Programming
3. File path 选择 CubeIDE 生成的 .bin
4. Start address 填 0x70000000（示例，外部 Flash 映射基址）
5. 勾选 Verify after programming
6. 点击 Start，观察进度与校验结果

烧录完成后复位开发板。若屏幕出现 TouchGFX 默认画面（通常是示例的欢迎界面或色块），说明从配置、编译、UI 生成到烧录的完整链路已经跑通。若黑屏，优先检查 LTDC 时序参数与屏幕实际规格是否一致，其次确认外部 Flash 的映射地址与启动配置是否匹配。

五、TouchGFX Designer 的接入方式

在 CubeMX 中勾选 TouchGFX 中间件并生成代码后，工程目录会出现 TouchGFX 文件夹与 .touchgfx 工程文件。用 TouchGFX Designer 打开该文件，即可在画布上拖拽控件、设置交互。Designer 中每次保存并生成代码，会更新 TouchGFX/generated 下的文件，回到 CubeIDE 重新编译即可把 UI 变更带入固件。

需要特别注意的是：不要在 CubeIDE 中手动修改 generated 目录下的文件，它们会被 Designer 覆盖。自定义逻辑应写在 TouchGFX/gui 或用户回调中。这条边界一旦混淆，后续 UI 迭代会频繁丢代码。

六、首个工程的验收清单