STM32H723ZG最小系统搭建：从CubeMX配置到点灯与串口调试

开箱一块 NUCLEO-H723ZG，我最直接的感受是：这块板子的性能余量给得很足。STM32H723ZG 这颗芯片是 Cortex-M7 内核，主频最高能到 550 MHz，片上带了 1 MB Flash 和 564 KB SRAM，板型用的是 NUCLEO-144 这个标准尺寸，Arduino 兼容口、ST Zio 扩展座、板载调试器全都有。对于想从 F4/L4 往 H7 爬、或者项目本身有以太网、多路 CAN、高速 ADC 采集这类需求的开发者来说，这是一块特别适合用来验证方案、跑通原型的板子。

这篇文章就围绕如何用 NUCLEO-H723ZG 从零搭一个最简单可跑的示例工程来写。我会把环境搭建、CubeMX 配置、点灯、串口打印、按键输入全部过一遍，同时把 H7 系列特有的时钟树、Cache、Flash 等待周期这些坑也讲清楚。适合刚拿到板子、想快速确认工具链和硬件是否正常的开发者，也适合那些已经在用 F1/F4、第一次切到 H7 的人。

1. 项目整体思路：先跑通最小系统，再谈外设

很多人拿到新板子第一件事就是开例程、点灯，这个方向是对的。但点灯本身不是目的，真正的目的是把一整条开发链路验证通：芯片能识别、时钟能跑、GPIO 能翻转、编译链没问题、下载探针正常。这套链路一旦通了，后面加任何外设都只是“套模板”的事。

1.1 先看清 NUCLEO-H723ZG 的核心规格与定位

我习惯拿到板子先看三张图：芯片数据手册、板卡用户手册、板卡原理图。NUCLEO-H723ZG 的核心参数可以先记住，后面配置时钟和看引脚时都用得上：

H723 系列在 STM32H7 里属于“高性价比走量”的定位。它砍掉了 H743/H750 上的图形处理相关外设，保留了对工业控制和通信最重要的东西：高频 M7 内核、以太网 MAC、多路 FDCAN、USB、高速 ADC。所以这块板子特别适合做电机控制、工业网关、数据采集、音频处理这些方向的原型验证。

NUCLEO-144 这个板型还有一个好处：只要你会用 NUCLEO-H743ZI、NUCLEO-F746ZG，拿到 H723ZG 几乎不需要重新学，引脚排布和扩展座位置都是同一套体系，迁移成本很低。

1.2 为什么“点灯 + 串口”是最小工程的黄金组合

点灯验证数字输出，串口打印验证数据通路，这两个加在一起，基本就能覆盖日常调试的 80% 需求。你可能觉得点灯太幼稚，但实际项目中，我见过太多人一上来就铺复杂外设，最后连最基本的板子好坏都判断不了，出了问题根本不知道是硬件、软件还是工具链的问题。

先跑一个最小工程还有一个好处：它会逼你把软件版本、驱动、调试器、串口工具这些环境问题全部解决掉。后面写再复杂的逻辑，都是在这个稳定的地基上盖楼。

2. 开发环境准备：官方工具链还是开源组合

H723 这类高性能 MCU，开发环境的坑比你在网上看到的要多。核心问题是工具链版本和固件包版本必须匹配，否则编译出来的代码莫名其妙跑飞。我的建议是：第一次上手别折腾，直接用官方全家桶。

2.1 最省事的组合：STM32CubeMX + STM32CubeIDE

官方推荐的流程是这样的：STM32CubeMX 负责可视化配置引脚、时钟、外设，生成初始化 C 代码；STM32CubeIDE 负责编译、烧录、调试。新版 STM32CubeIDE 里其实已经集成了 CubeMX 的大部分功能，你也可以直接在 IDE 里新建 STM32 工程，打开图形化配置界面。

具体准备步骤：

1. 去 ST 官网下载 STM32CubeIDE，安装过程不用额外配环境变量。
2. 把 NUCLEO-H723ZG 用 USB 线连到电脑。注意看板子丝印，插在标着 ST-LINK 的那个 USB 口上，不是另一个用户 USB 口。USB 线一定要用带数据传输的线，只供电的线会坑死你。
3. 打开设备管理器确认能识别到 ST-LINK，同时会多出一个虚拟串口 COM 口，这个是后面串口打印用的。
4. 首次新建工程时，IDE 会自动下载 STM32CubeH7 固件包。国内网络有时候会很慢，卡住就耐心等，或者提前在 STM32CubeMX 的“Manage embedded software packages”里手动装好。

我见过不少人卡在第三步。Windows 下如果插上去完全没反应，先换线、换 USB 口，再用 STM32CubeProgrammer 里的固件升级功能刷新 ST-LINK 固件，90% 的问题能解决。

2.2 想折腾：VSCode + CMake + GCC

如果你习惯开源工具链，也可以用 VSCode + CMake + arm-none-eabi-gcc + OpenOCD 的组合。CubeMX 可以生成 CMake 工程，配合 ST-LINK 工具链也能烧录调试。这套方案灵活，但第一次配置时变量太多，容易出现编译器版本不一致、链接脚本不对、调试器配置出错这些问题。

我的态度很明确：先用官方工具把板子跑通，建立起“正常状态”的参考，再根据项目需要切到自定义工具链。否则出了问题，你根本不知道是硬件问题、代码问题还是工具问题。

2.3 板载 ST-LINK/V3 的正确打开方式

NUCLEO-H723ZG 上集成的 ST-LINK/V3 同时承担三个角色：程序烧录器、调试探针、虚拟串口。这是好事，但也带来一个问题：很多人以为把它当串口用还要接额外的 USB-TTL 模块，完全没必要。

使用板载 ST-LINK 时注意几点：

• 板子供电：默认由 USB 的 5V 供电，板载稳压器转出 3V3。
• 虚拟串口：驱动装好后会出现 COM 口，直接用串口助手连接，波特率看你工程里怎么配，我下面统一用 115200。
• 固件版本：如果 STM32CubeProgrammer 提示升级 ST-LINK 固件，顺手升一下，旧固件在一些新 IDE 版本下会报错。

3. 从零创建工程：点灯并不只是点灯

下面进入实操。我会用 STM32CubeIDE 作为主流程，CubeMX 的操作逻辑完全一致。

3.1 在 CubeMX 里选板，别自己从空白芯片开始

新建工程时，工具会问你是选具体板子还是选芯片。新手一定要从 Board Selector 进入，输入 NUCLEO-H723ZG，然后选中板卡图片，点击 Start Project。

这一下就能帮你省掉大量手工配置：板载 LED 的引脚标签、用户按键、调试口 SWD 都已经按官方板卡预设好了。虽然我们还是会在后面手动确认一遍，但至少不会完全瞎抓。

进入工程后，你会看到 STM32H723ZG 的引脚图，周围一圈有很多带颜色的引脚。这比看 500 页数据手册直观得多：绿色表示已配置为模拟/外设功能，黄色表示 GPIO 输出，灰色表示未配置。

3.2 时钟配置：先把 550 MHz 用起来

打开 System Core 下的 RCC 配置，把 HSE 设成 Crystal/Ceramic Resonator。NUCLEO-H723ZG 板子上有一颗 25 MHz 的外部晶振，接在 PH0-OSC_IN 和 PH1-OSC_OUT 上。CubeMX 会默认识别到这颗晶振，你只需要告诉它“外部高速时钟用的是晶振，不是信号发生器”。

然后切到 Clock Configuration 标签页，把 HCLK 改成 550 MHz，输入后按回车，CubeMX 会弹一个确认框，告诉你 PLL 参数已经重新计算、Flash 等待周期需要调整，点 OK 就行。

这里大概发生了什么，值得简单说一句：

• HSE 25 MHz 通过 PLL1 倍频到 550 MHz，作为 SYSCLK。
• SYSCLK 经过 AHB 预分频得到 HCLK，默认 1 分频，所以 HCLK 也是 550 MHz。
• APB1/APB2 再各自分频，串口、CAN、定时器这些外设的时钟都从这两个总线取。
• CPU 跑 550 MHz 时，内部 Flash 速度跟不上，所以需要插入等待周期，同时打开 Cortex-M7 的 I-Cache 和 D-Cache 来缓解取指瓶颈。

这些参数在生成的SystemClock_Config函数里都能看到。你不需要背下来，但要知道改主频这件事不是填一个数字那么简单，后面换别的晶振频率或者降频省电时，理解这套链路才能不犯错。

3.3 配置 GPIO：找到板载 LED 并起个好名字

在 Pinout & Configuration 视图里，用左下角 Search 输入 PB0，快速定位到引脚。NUCLEO-H723ZG 板载用户绿色 LED 接在 PB0，高电平点亮。把 PB0 设为 GPIO_Output，然后在右下角的 User Label 里给它起个名字，叫 LED。

这里必须加一句提醒：NUCLEO-144 系列里，不同型号的 LED 引脚并不统一，H723ZG 这个板子最常见的是 PB0，但你拿到手的如果是特殊批次，或者你后面换了别的型号板子，一定要以板卡原理图和 CubeMX 引脚图为准。我踩过这个坑，照着网上的教程配了引脚，结果灯不亮，查了半天发现是板子型号不同、LED 脚位不一样。

GPIO 的参数我用的是默认值：输出电平 Low、无上下拉、推挽输出、低速。LED 这种负载不需要高速翻转，Low 速度足够，还能减少一点噪声。CubeMX 默认参数就合理，不用改。

3.4 生成代码并加上点灯逻辑

点击 Generate Code，工具链选择 STM32CubeIDE，生成后自动打开工程。如果你用的是独立 CubeMX，生成后导入 IDE 即可。

生成的工程结构大概是这样的：Core/Src/main.c 放主逻辑，Core/Inc 放头文件，Drivers 下面是 HAL 库和 CMSIS 相关代码。main.c 里已经有几个函数：SystemClock_Config、MX_GPIO_Init，以及一个空的while(1)循环。

在 main.c 里找到这里，注意 CubeMX 生成的代码里有成对出现的注释标记：

/* USER CODE BEGIN 3 */ /* USER CODE END 3 */

所有你自己的代码，都必须写在这对注释之间。这是 CubeMX 重新生成代码时唯一会保留的区域。如果你把代码写在注释外面，下次在 CubeMX 里改了配置重新生成，你的代码会被直接覆盖。

在这个区域里加上点灯逻辑：

/* USER CODE BEGIN 3 */ while (1) { HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); HAL_Delay(500); } /* USER CODE END 3 */

LED_GPIO_Port和LED_Pin是 CubeMX 根据你的 User Label 自动生成的宏，如果不改代码，默认生成的可能是 GPIOB 和 GPIO_PIN_0。HAL_GPIO_TogglePin做电平翻转，HAL_Delay(500)让 SysTick 延时 500 毫秒。效果就是 LED 每 500ms 翻转一次，亮灭节奏是 1 秒一个周期。

3.5 编译、烧录、看现象

点工具栏的 Build 按钮，第一次编译要等一会儿，因为要编译整个 HAL 库。编译成功后点 Run 旁边的下拉箭头，选 Run Configurations，确认 Debugger 是 ST-LINK，然后运行。

正常情况下，板子上的绿色 LED 开始按 1 秒周期闪烁。这一步完成了，说明整条链路已经通了：芯片识别、时钟配置、GPIO 控制、编译烧录全部正常。

如果你用命令行工具，也可以用 st-flash 这类工具烧录生成的 .elf 或 .hex 文件，但第一次不建议折腾，等环境稳了再玩。

4. 让示例更像样：串口打印 + 按键

点灯只是热身。下面给示例工程加两个功能：串口打印和按键控制。这样它就不再是纯“玩具”，而是一个可以复用的调试模板。

4.1 在 CubeMX 里打开 USART2

NUCLEO-H723ZG 的板载 ST-LINK 虚拟串口接在 USART2 上，对应引脚是 PA2（TX）和 PA3（RX）。打开 Connectivity 下的 USART2，Mode 选 Asynchronous，参数设 115200、8 位数据、无校验、1 位停止位，这是最常见的串口配置。

如果发现 PA2/PA3 已经显示别的颜色，说明板卡默认配置可能把它们分配给了别的功能，先检查一下，有冲突就按板卡默认方案处理。引脚冲突这个问题在 H7 上很常见，H7 的引脚复用功能多，同一个引脚能当 SPI、USART、定时器通道、ADC 输入，配置时经常打架。

改完配置先重新生成代码，再继续写逻辑。

4.2 重定向 printf 到串口

HAL 库本身没有 printf 支持，需要我们自己把 printf 的输出重定向到 UART。对于 GCC 工具链（STM32CubeIDE 用的就是），在 main.c 的 USER CODE 区域添加一个_write函数：

/* USER CODE BEGIN 4 */ #include <stdio.h> int _write(int file, char *ptr, int len) { HAL_UART_Transmit(&huart2, (uint8_t *)ptr, len, HAL_MAX_DELAY); return len; } /* USER CODE END 4 */

原理是 C 标准库在调用 printf 输出字符时，会逐字符调用底层_write函数，我们把它替换成 HAL_UART_Transmit 的发送逻辑，printf 的输出就能直接进串口。

如果你用的是 Keil 或 IAR，重定向方式略有不同：Keil 重写fputc函数，IAR 重写__write