开箱一块 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 的核心参数可以先记住后面配置时钟和看引脚时都用得上项目参数主控芯片STM32H723ZGLQFP144 封装内核Arm Cortex-M7最高 550 MHzFlash / SRAM1 MB Flash / 564 KB SRAM板载调试器ST-LINK/V3支持虚拟串口常用外设10/100M 以太网 MAC、USB OTG、2x FDCAN、SPI、I2C、USART/UART模拟外设16-bit ADC多通道、DAC扩展接口ST Zio Arduino Uno V3 兼容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 工程打开图形化配置界面。具体准备步骤去 ST 官网下载 STM32CubeIDE安装过程不用额外配环境变量。把 NUCLEO-H723ZG 用 USB 线连到电脑。注意看板子丝印插在标着 ST-LINK 的那个 USB 口上不是另一个用户 USB 口。USB 线一定要用带数据传输的线只供电的线会坑死你。打开设备管理器确认能识别到 ST-LINK同时会多出一个虚拟串口 COM 口这个是后面串口打印用的。首次新建工程时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 里打开 USART2NUCLEO-H723ZG 的板载 ST-LINK 虚拟串口接在 USART2 上对应引脚是 PA2TX和 PA3RX。打开 Connectivity 下的 USART2Mode 选 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