前阵子做一个小型仪器的人机界面主控是一片STM32G071RB显示需求就是一块小尺寸彩屏配上导航按键。硬件同事扔了两块板子过来一块NUCLEO-G071RB一块X_NUCLEO_GFX01M1扩展板让我先把GUI流程跑通。这块扩展板在ST的文档里不算高调但实际用起来很顺手——1.1英寸SPI彩屏、五向摇杆、microSD卡槽正好覆盖了一个嵌入式小设备最常见的交互要素。这篇应用笔记记录我从CubeMX初始化、点亮屏幕、读摇杆到选定GUI开发方式的全过程主要围绕如何在STM32G0这类入门级MCU上规划GUI项目。文章适合正在评估小屏界面方案、或者刚拿到GFX01M1想快速上手的开发者。先说结论只要选对刷新策略Cortex-M0也能做出流畅的菜单和界面。1. 从硬件开始X-NUCLEO-GFX01M1的构成与工作边界1.1 板载资源一览屏幕、摇杆与SD卡槽X-NUCLEO-GFX01M1是一块Arduino UNO R3引脚兼容的扩展板设计目标很明确给Nucleo开发板补齐“小屏幕加方向输入加外部存储”让原型机在很短时间里就能看到界面。板子正面的LCD模组尺寸是1.1英寸分辨率160x128接口为SPI。屏幕的显示控制器属于ST7735系列这类控制器在常见的小屏模块上非常普遍如果你之前接触过几块钱的1.8寸TFT屏对它的初始化流程不会陌生。板子侧面还有一个microSD卡插槽用于存放图片、字库或者曲线数据同样走SPI和LCD共用一条SPI总线通过片选区分。板上的五向摇杆值得单独说。我一开始以为它是四个方向的独立GPIO按键看了原理图才发现是两路模拟信号加一个按键摇杆X轴和Y轴的输出电压随拨动方向变化MCU用两个ADC通道读取中心位置大约在1.65V附近也就是参考电压的一半。垂直往下按时摇杆内部的一个微动开关会导通输出数字电平。这种设计比四个分离按键占用的引脚更少操作手感也更接近游戏机手柄。需要注意的是不同方向组合时ADC读数会呈现近似椭圆分布方向判定不能只看单轴要结合两轴坐标做象限判断。1.2 为什么ST选择用SPI而不是并口答案很直白省引脚。并口8080接口的LCD至少需要8根数据线加上读写控制线算下来十几根引脚没有了RGB并行接口要求更高MCU必须带对应外设。X-NUCLEO-GFX01M1是要直接插在Nucleo的Arduino兼容排针上的引脚资源总共就这一圈用SPI只需要SCK、MOSI、片选、数据命令选择、复位五根线最多再加一路背光控制。这样剩下的引脚还能留给用户自己的外设。代价是SPI刷新速度不如并口但对160x128这样的小屏SPI带宽完全够用后面我会算这笔账。选择SPI还有一个原因这块板不仅面向性能较高的STM32也兼容低端Cortex-M0比如STM32G0。G0的硬件SPI时钟可以到系统时钟的一半在64MHz主频下SPI理论能跑到32MHz实际考虑到从设备上限一般配置在16MHz左右显示一帧全屏RGB565数据大约需要20毫秒对交互界面来说相当够用。1.3 与STM32G0 Nucleo的物理连接方式把扩展板直接叠在Nucleo的Arduino兼容排针上即可不需要额外跳线。插上之后扩展板会覆盖大部分板卡区域但ST-LINK的USB口和调试接口仍然保留整体看起来像一台带小屏幕的迷你设备。我用的NUCLEO-G071RB型号是ST官方最常搭配这块扩展板的板子之一如果你手上是NUCLEO-G0B1RE同样能叠上去资源还更宽裕。从这一步开始有两条路。第一条是图省事用STM32CubeMX的软件包功能自动配置让X-CUBE-GFX01把引脚和外设初始化全部接好适合快速验证。第二条是自己画底板或者用其它MCU这时需要对照X-NUCLEO-GFX01M1的用户手册找到屏幕、摇杆、SD卡对应的信号定义再分配到自己的引脚上。如果自己设计底板我建议给LCD留出专用SPI端口并分配独立片选摇杆的ADC通道尽量不要和调试引脚冲突否则在线调试时会出现干扰。1.4 选型账G071还是G0B1G071和G0B1都是STM32G0家族成员但内部资源差异足以改变你的GUI方案。先做一道算术题160x128分辨率的RGB565帧缓冲需要160乘128乘2字节也就是40KB。G071RB的SRAM只有36KB连一帧都装不下。G0B1RE则有144KB SRAM和512KB Flash不仅能轻松放下一整帧还能余出大量空间给GUI库和业务代码。所以如果界面只是几行菜单、数值显示和简单图标G071够用如果界面带图片切换、大块动画、或者想用成熟的GUI框架直接上NUCLEO-G0B1RE省去后续内存优化的痛苦。这个账必须在选型阶段算清楚不要等代码写了一半才发现RAM不够。2. 搭建工程从CubeMX到能跑SPI的最小工程2.1 工具链选择与准备我用的是STM32CubeIDE它集成了CubeMX配置界面和编译调试环境对一个应用笔记来说是最省心的路径。你也可以用独立版STM32CubeMX生成代码再用Keil MDK或IAR打开逻辑一样。版本建议用较新的CubeIDE或CubeMX因为X-CUBE-GFX01这类扩展包只有在较新版本里才能直接搜索到。安装完成后先打开“Help”菜单下的“Manage Embedded Software Packages”把STM32G0系列的固件包更新到较新版本后面生成外设驱动时会顺畅很多。这个步骤容易被跳过但跳过后经常遇到HAL库版本不匹配我建议不要省。2.2 用Board Selector创建工程打开CubeMX选择新建工程然后切到Board Selector标签页输入Nucleo-G071RB或Nucleo-G0B1RE。Board Selector的好处是可以根据板载的LED、按键、串口等特性自动初始化省去手动查丝印的麻烦。生成工程后CubeMX会给出一个默认的HAL空工程此时先不要急着配置引脚因为扩展板需要的引脚映射会由软件包自动接管。2.3 安装X-CUBE-GFX01扩展包在CubeMX的Software Packs区域打开组件选择界面搜索GFX01或X-CUBE-GFX01。如果本地仓库没有它会提示联网下载。找到后勾选系统会显示组件的依赖关系一般要求本地的STM32G0系列固件包满足一定版本。这里有一个容易踩的点组件选择页面里有一点版本匹配逻辑如果板级固件包版本太低会出现组件不匹配或者生成代码时报错。遇到这种情况先把STM32G0系列的固件包升级再重新打开组件选择。生成工程后CubeMX会按扩展板默认映射把SPI、ADC、GPIO等外设配置好并在main函数里带入BSP初始化。你不需要手动去改每个引脚功能如果此时打开Pinout视图会看到不少引脚被标记成类似BSP_...的名称这些是BSP层的命名表示它们已被扩展包接管。如果你的应用里某几个引脚需要复用就得对照原理图手动调整但初期不建议动等整个流程跑通再改不迟。2.4 不使用扩展包时的备选路径如果你不想依赖X-CUBE-GFX01或者需要把驱动迁移到自研PCB上可以去ST官网下载X-CUBE-GFX01压缩包解压后手工把 STM32G0与GFX01M1扩展板：小屏GUI开发实战指南
前阵子做一个小型仪器的人机界面主控是一片STM32G071RB显示需求就是一块小尺寸彩屏配上导航按键。硬件同事扔了两块板子过来一块NUCLEO-G071RB一块X_NUCLEO_GFX01M1扩展板让我先把GUI流程跑通。这块扩展板在ST的文档里不算高调但实际用起来很顺手——1.1英寸SPI彩屏、五向摇杆、microSD卡槽正好覆盖了一个嵌入式小设备最常见的交互要素。这篇应用笔记记录我从CubeMX初始化、点亮屏幕、读摇杆到选定GUI开发方式的全过程主要围绕如何在STM32G0这类入门级MCU上规划GUI项目。文章适合正在评估小屏界面方案、或者刚拿到GFX01M1想快速上手的开发者。先说结论只要选对刷新策略Cortex-M0也能做出流畅的菜单和界面。1. 从硬件开始X-NUCLEO-GFX01M1的构成与工作边界1.1 板载资源一览屏幕、摇杆与SD卡槽X-NUCLEO-GFX01M1是一块Arduino UNO R3引脚兼容的扩展板设计目标很明确给Nucleo开发板补齐“小屏幕加方向输入加外部存储”让原型机在很短时间里就能看到界面。板子正面的LCD模组尺寸是1.1英寸分辨率160x128接口为SPI。屏幕的显示控制器属于ST7735系列这类控制器在常见的小屏模块上非常普遍如果你之前接触过几块钱的1.8寸TFT屏对它的初始化流程不会陌生。板子侧面还有一个microSD卡插槽用于存放图片、字库或者曲线数据同样走SPI和LCD共用一条SPI总线通过片选区分。板上的五向摇杆值得单独说。我一开始以为它是四个方向的独立GPIO按键看了原理图才发现是两路模拟信号加一个按键摇杆X轴和Y轴的输出电压随拨动方向变化MCU用两个ADC通道读取中心位置大约在1.65V附近也就是参考电压的一半。垂直往下按时摇杆内部的一个微动开关会导通输出数字电平。这种设计比四个分离按键占用的引脚更少操作手感也更接近游戏机手柄。需要注意的是不同方向组合时ADC读数会呈现近似椭圆分布方向判定不能只看单轴要结合两轴坐标做象限判断。1.2 为什么ST选择用SPI而不是并口答案很直白省引脚。并口8080接口的LCD至少需要8根数据线加上读写控制线算下来十几根引脚没有了RGB并行接口要求更高MCU必须带对应外设。X-NUCLEO-GFX01M1是要直接插在Nucleo的Arduino兼容排针上的引脚资源总共就这一圈用SPI只需要SCK、MOSI、片选、数据命令选择、复位五根线最多再加一路背光控制。这样剩下的引脚还能留给用户自己的外设。代价是SPI刷新速度不如并口但对160x128这样的小屏SPI带宽完全够用后面我会算这笔账。选择SPI还有一个原因这块板不仅面向性能较高的STM32也兼容低端Cortex-M0比如STM32G0。G0的硬件SPI时钟可以到系统时钟的一半在64MHz主频下SPI理论能跑到32MHz实际考虑到从设备上限一般配置在16MHz左右显示一帧全屏RGB565数据大约需要20毫秒对交互界面来说相当够用。1.3 与STM32G0 Nucleo的物理连接方式把扩展板直接叠在Nucleo的Arduino兼容排针上即可不需要额外跳线。插上之后扩展板会覆盖大部分板卡区域但ST-LINK的USB口和调试接口仍然保留整体看起来像一台带小屏幕的迷你设备。我用的NUCLEO-G071RB型号是ST官方最常搭配这块扩展板的板子之一如果你手上是NUCLEO-G0B1RE同样能叠上去资源还更宽裕。从这一步开始有两条路。第一条是图省事用STM32CubeMX的软件包功能自动配置让X-CUBE-GFX01把引脚和外设初始化全部接好适合快速验证。第二条是自己画底板或者用其它MCU这时需要对照X-NUCLEO-GFX01M1的用户手册找到屏幕、摇杆、SD卡对应的信号定义再分配到自己的引脚上。如果自己设计底板我建议给LCD留出专用SPI端口并分配独立片选摇杆的ADC通道尽量不要和调试引脚冲突否则在线调试时会出现干扰。1.4 选型账G071还是G0B1G071和G0B1都是STM32G0家族成员但内部资源差异足以改变你的GUI方案。先做一道算术题160x128分辨率的RGB565帧缓冲需要160乘128乘2字节也就是40KB。G071RB的SRAM只有36KB连一帧都装不下。G0B1RE则有144KB SRAM和512KB Flash不仅能轻松放下一整帧还能余出大量空间给GUI库和业务代码。所以如果界面只是几行菜单、数值显示和简单图标G071够用如果界面带图片切换、大块动画、或者想用成熟的GUI框架直接上NUCLEO-G0B1RE省去后续内存优化的痛苦。这个账必须在选型阶段算清楚不要等代码写了一半才发现RAM不够。2. 搭建工程从CubeMX到能跑SPI的最小工程2.1 工具链选择与准备我用的是STM32CubeIDE它集成了CubeMX配置界面和编译调试环境对一个应用笔记来说是最省心的路径。你也可以用独立版STM32CubeMX生成代码再用Keil MDK或IAR打开逻辑一样。版本建议用较新的CubeIDE或CubeMX因为X-CUBE-GFX01这类扩展包只有在较新版本里才能直接搜索到。安装完成后先打开“Help”菜单下的“Manage Embedded Software Packages”把STM32G0系列的固件包更新到较新版本后面生成外设驱动时会顺畅很多。这个步骤容易被跳过但跳过后经常遇到HAL库版本不匹配我建议不要省。2.2 用Board Selector创建工程打开CubeMX选择新建工程然后切到Board Selector标签页输入Nucleo-G071RB或Nucleo-G0B1RE。Board Selector的好处是可以根据板载的LED、按键、串口等特性自动初始化省去手动查丝印的麻烦。生成工程后CubeMX会给出一个默认的HAL空工程此时先不要急着配置引脚因为扩展板需要的引脚映射会由软件包自动接管。2.3 安装X-CUBE-GFX01扩展包在CubeMX的Software Packs区域打开组件选择界面搜索GFX01或X-CUBE-GFX01。如果本地仓库没有它会提示联网下载。找到后勾选系统会显示组件的依赖关系一般要求本地的STM32G0系列固件包满足一定版本。这里有一个容易踩的点组件选择页面里有一点版本匹配逻辑如果板级固件包版本太低会出现组件不匹配或者生成代码时报错。遇到这种情况先把STM32G0系列的固件包升级再重新打开组件选择。生成工程后CubeMX会按扩展板默认映射把SPI、ADC、GPIO等外设配置好并在main函数里带入BSP初始化。你不需要手动去改每个引脚功能如果此时打开Pinout视图会看到不少引脚被标记成类似BSP_...的名称这些是BSP层的命名表示它们已被扩展包接管。如果你的应用里某几个引脚需要复用就得对照原理图手动调整但初期不建议动等整个流程跑通再改不迟。2.4 不使用扩展包时的备选路径如果你不想依赖X-CUBE-GFX01或者需要把驱动迁移到自研PCB上可以去ST官网下载X-CUBE-GFX01压缩包解压后手工把