STM32Cube开发工具详解 课件 第2章 STM32CubeMX的安装和应用

安装STM32CubeMXCONTENTS•STM32CubeMX概述•STM32CubeMX主要特点•STM32Cube开发组件介绍•安装前准备•软件下载流程•安装程序启动•安装配置步骤•安装完成与验证目录01STM32CubeMX概述软件定义与作用软件核心定义STM32CubeMX软件是ST有限公司为STM32系列微控制器快速建立工程，并快速初始化使用到的外设、GPIO等而设计的工具。该软件不仅能配置STM32外设，还能进行第三方软件系统的配置，例如FreeRTOS、FAT32、LWIP等，同时具备功耗预估功能。主要功能作用STM32CubeMX可输出PDF、TXT文档，显示所开发工程中的GPIO等外设配置信息，供开发者进行原理图设计等工作，大大缩短了开发时间，提升了项目开发效率。支持平台与产品系列跨平台支持范围STM32CubeMX是ST官方推出的跨平台图形化工具，支持在Linux、MacOS、Window系统下开发，满足不同开发者的系统环境需求。兼容产品系列该软件支持ST的全系列产品，目前包括STM32L0、STM32L1、STM32L4、STM32L5、STM32F0、STM32F1、STM32F2、STM32F3、STM32F4、STM32F7、STM32G0、STM32G4、STM32H7、STM32WB、STM32WL、STM32MP1等系列。0102核心价值与开发效率提升底层接口与中间件集成STM32CubeMX对接的底层接口是HAL库，除集成MCU/MPU的硬件抽象层外，还集成了RTOS、文件系统、USB、网络、显示、嵌入式AI等中间件，方便开发者进行底层驱动配置。0102开发效率提升体现通过该工具，开发者能够轻松完成MCU/MPU的底层驱动配置，从而留出更多精力开发上层功能逻辑，进一步提高了嵌入式开发效率，简化了开发流程。02STM32CubeMX主要特点图形化配置界面与IO管理集成化图形配置界面STM32CubeMX集成了ST有限公司每一款型号的MCU/MPU的可配置图形界面，能够直观展示芯片外设资源和引脚分布。开发者可通过拖拽、勾选等操作完成GPIO、外设功能的配置，无需手动编写初始化代码，大幅降低配置难度。0102IO冲突自动检测与分配该工具能够自动提示IO冲突，当多个外设尝试使用同一引脚时，会实时给出警告并提供解决方案。对于复用IO，系统可根据配置需求自动分配引脚功能，避免手动配置时的疏漏，确保硬件资源分配的准确性。动态时钟树验证功能动态时钟树配置机制STM32CubeMX具备动态验证的时钟树功能，支持可视化配置芯片的系统时钟、外设时钟等。开发者可通过图形界面调整时钟源、分频系数、倍频参数等，系统会实时计算并显示各模块的时钟频率，确保配置符合芯片时序要求。时钟配置实时验证工具会对配置的时钟树进行动态验证，当设置的参数超出芯片硬件限制（如最大频率、最小频率、时钟源兼容性等）时，会立即提示错误并给出调整建议，避免因时钟配置不当导致的系统不稳定问题。中间件集成与应用支持丰富中间件集成能力STM32CubeMX除集成MCU/MPU的硬件抽象层外，还集成了多种中间件，如RTOS（FreeRTOS等）、文件系统（FAT32等）、USB、网络（LWIP等）、显示、嵌入式AI等。开发者可直接在工具中选择并配置所需中间件，无需手动移植，简化系统构建流程。中间件配置简化流程通过图形化界面，开发者可对中间件的参数进行配置，如RTOS的任务优先级、堆栈大小，文件系统的存储路径、缓存大小等。配置完成后，工具会自动生成相应的初始化代码，使开发者能够快速将中间件集成到项目中，专注于上层功能逻辑开发。功耗估算与多编译器支持多场景功耗预估功能STM32CubeMX具有功耗估算功能，可根据配置的MCU主频、外设工作状态（如开启/关闭、工作模式等）、中间件运行情况等，估算芯片在不同运行场景下的功耗。帮助开发者在设计阶段优化功耗配置，延长电池供电设备的续航时间。多编译器工程输出支持该软件能够输出不同编译器的工程，如MDK（Keil）、EWArm（IAR）、STM32CubeIDE、MakeFile等。开发者可根据自身开发环境选择对应的编译器格式，工具会自动生成适配该编译器的工程文件和编译脚本，确保工程能够直接在目标环境中编译运行，提高开发兼容性和灵活性。03STM32Cube开发组件介绍图形化配置工具组成图形化配置工具功能定位STM32CubeMX是ST官方推出的跨平台图形化配置工具，支持Linux、MacOS、Windows系统。该工具通过直观的图形界面实现STM32系列MCU/MPU的快速工程搭建，可配置外设、GPIO及第三方软件系统（如FreeRTOS、FAT32、LWIP等），显著缩短开发周期。0102核心功能特性工具集成动态时钟树验证、功耗估算功能，支持自动提示IO冲突与复用IO分配。可输出PDF、TXT格式的外设配置文档，辅助原理图设计，并能生成MDK、EWArm、STM32CubeIDE等多编译器工程。固件集软件资料包固件包组成结构STM32Cube固件集包含MCU/MPU硬件抽象层（HAL）、中间件组件及示例工程。硬件抽象层提供统一的外设接口，中间件涵盖RTOS、文件系统、USB、网络、显示及嵌入式AI等模块，支持快速功能集成。固件包应用价值固件集通过标准化接口简化底层驱动开发，开发者可专注上层逻辑设计。软件资料包持续更新，支持ST全系列产品（包括STM32L0/L1/L4/L5、F0/F1/F2/F3/F4/F7、G0/G4、H7、WB、WL、MP1等系列），确保开发兼容性与前瞻性。0102HAL库底层接口对接HAL库设计理念HAL库（硬件抽象层）是STM32Cube开发组件的核心，采用面向对象设计思想，提供与硬件无关的统一API接口。其接口设计兼顾易用性与性能，支持外设初始化、配置及数据处理的标准化操作。接口对接优势HAL库实现跨系列MCU的软件复用，降低迁移成本。通过STM32CubeMX配置工具可自动生成HAL库初始化代码，减少手动编码错误。底层接口与中间件无缝对接，支持快速扩展复杂功能，提升嵌入式开发效率。04安装前准备官方下载渠道说明官网下载页面访问获取STM32CubeMX安装包需首先访问STMicroelectronics官方网站，具体网址为/content/st_com/zh/stm32cubemx.html。该页面提供软件概述、特性介绍及各系统版本的下载链接，是官方唯一指定的安全获取渠道。安装包版本选择版本选择依据与推荐STM32CubeMX提供多系统支持，包括Windows、MacOS和Linux，各系统均有对应的最新版本（如当前最新版为6.11.1）。选择时需根据开发主机操作系统匹配对应安装包，同时建议优先选择最新稳定版以获取完整功能支持和安全更新。系统环境要求安装环境规范STM32CubeMX对安装环境有明确要求：安装路径必须避免中文、空格及非下划线特殊符号，推荐设置在纯英文路径下（如示例路径“C:\ProgramFiles\STMicroelectronics\STM32Cube\STM32CubeMX”）。此外，若需后续安装MCU固件包，建议将其与软件安装在同一根目录下，便于统一管理。05软件下载流程官网下载页面访问访问官方下载地址首先登录ST公司官网，STM32CubeMX的官方下载页面网址为/content/st_com/zh/stm32cubemx.html。在该页面中，用户可以找到STM32CubeMX软件的相关信息及下载资源。选择软件版本与系统官网页面提供了不同操作系统的最新版本安装包，包括Windows、Mac和Linux系统，当前最新版本为6.11.1。用户需根据自己的操作系统选择对应的安装包进行下载。许可协议接受步骤进入许可协议界面在官网下载页面单击“下载软件”后，会进入STM32CubeMX安装包下载许可协议选择界面。用户需要仔细阅读许可协议的相关条款。接受许可协议条款在许可协议界面中，用户需选择“IACCEPT”以表示接受协议条款，只有接受协议后才能继续进行后续的下载操作。MyST账户登录与验证进入MyST账户登录界面接受许可协议后，系统会提示用户登录MyST账户或创建新账户，也可选择作为访客下载。单击“登录MyST”按钮进入登录界面。0102输入账户信息完成登录在Login界面中，已注册用户需输入自己的电子邮箱地址和密码，然后单击“Login”按钮进行登录验证。登录成功后即可开始下载STM32CubeMX软件包。安装包获取与保存下载软件包完成MyST账户登录验证后，系统开始下载STM32CubeMX软件包。下载的软件包名称格式为en.stm32cubemx-win-v6-11-1（以Windows系统为例）。0102保存安装包文件下载完成后，用户需将软件包保存到合适的位置，以便后续进行安装操作。建议选择容易找到的文件夹，方便后续双击运行安装程序。06安装程序启动安装包文件格式说明安装包文件命名规则下载后STM32CubeMX软件包名称为en.stm32cubemx-win-v6-11-1，该命名包含软件名称、适用系统及版本信息，便于用户识别和管理。安装程序文件类型软件包下载完成后，对应的安装程序为SetupSTM32CubeMX-6.11.1-Win应用程序，双击该程序即可启动安装流程。安装模式选择（推荐选项）安装模式选项说明STM32CubeMX提供两种安装模式，分别是“Installformeonly(recommended)”和“Installforallusers”，其中“Installforallusers”模式需要管理员权限。推荐安装模式选择推荐选择“Installformeonly(recommended)”模式，该模式无需管理员权限，适合个人用户使用，能有效避免权限相关问题，简化安装流程。安装向导初始化流程安装向导启动界面双击安装程序后，弹出STM32CubeMX安装模式选择界面，完成模式选择并确认后，将弹出STM32CubeMX安装向导界面，显示“WelcometotheInstallationofSTM32CubeMX6.11.1”欢迎信息。初始化流程说明安装向导启动后，将开始STM32CubeMX6.11.1的安装准备工作，用户只需按照向导提示逐步操作即可完成后续安装配置，向导会引导用户完成许可协议确认、安装路径设置等关键步骤。07安装配置步骤许可协议条款确认许可协议阅读与接受在STM32CubeMX安装过程中，会弹出LicenseAgreement界面。用户需仔细阅读软件许可协议条款，只有勾选“Iacceptthetermofthislicenseagreement”选项，同意许可协议内容，才能继续进行后续安装步骤。隐私政策与使用条款同意隐私政策内容确认安装向导会进入STPrivacyandTermsofUse界面，用户需勾选“IhavereadandunderstoodtheSTTermofUse”。该条款涉及ST对用户使用统计信息的收集及用途说明，用户可在后续软件使用中通过设置更改统计信息收集偏好。安装路径设置规范（中文路径规避）安装目录选择要点安装路径设置时，需确保目录不包含汉字、空格和非下划线符号。推荐将其安装在“C:\ProgramFiles\STMicroelectronics\STM32Cube\STM32CubeMX”路径下，便于与后续可能安装的MCU固件包统一管理，避免因路径问题导致软件运行异常。快捷方式创建选项快捷方式配置选项安装程序会默认勾选“CreateshortcutsintheStart-Menu”和“Createadditionalshortcutsonthedesktop”，用户可根据需求选择是否创建桌面快捷方式及程序组。推荐保留默认设置，方便后续快速启动STM32CubeMX软件。08安装完成与验证安装进度监控与完成提示安装进度实时查看在STM32CubeMX安装过程中，安装向导会显示实时进度，包括Pack安装进度和总体进度，用户可直观了解安装状态。当进度条显示“14/14”且状态为“Finished”时，表示安装包已全部完成部署。01安装完成确认步骤安装进度完成后，点击安装向导中的“Next”按钮，进入安装完成界面。此时界面会提示“Installationhascompletedsuccessfully”，并显示卸载程序的保存路径，确认安装过程正常结束。02桌面快捷方式生成确认快捷方式创建结果检查安装时若勾选“Createadditionalshortcutsonthedesktop”选项，安装完成后，在计算机桌面上会生成STM32CubeMX软件图标，图标为蓝色背景搭配“STM32CubeMX”字样，便于快速识别。快捷方式功能验证双击桌面快捷方式，若能正常启动STM32CubeMX程序，则说明快捷方式创建成功且可正常使用。若无法启动，需检查安装路径是否正确或重新安装软件。软件启动与主界面验证软件启动操作流程通过桌面快捷方式或开始菜单中的程序组启动STM32CubeMX，首次启动时可能需要短暂加载配置文件，随后进入软件主界面。主界面包含工程管理、外设配置等核心功能模块，界面布局清晰直观。0102主界面核心元素识别成功启动后，主界面顶部显示软件版本号（如6.11.1），左侧为工程创建与导入选项，中间为功能配置区域，右侧为帮助与资源链接。确认界面元素完整且无报错信息，即可进行后续开发操作。后续更新与支持资源获取官方更新渠道说明为确保工具功能最新，用户需定期访问STMicroelectronics官网（/content/st_com/zh/stm32cubemx.html），在“下载”页面获取最新版本安装包或更新补丁。技术支持资源获取ST官方提供丰富的支持资源，包括用户手册、入门视频、固件库资料包等，可通过主界面“Help”菜单中的“Documentation”选项或官网“支持”板块获取。此外，MyST账户可用于获取个性化技术支持与社区交流服务。感谢您的观看安装MCU固件包CONTENTS•安装MCU固件包概述•STM32CubeMX软件启动•软件库文件夹设置•UpdaterSettings对话框配置•嵌入式软件包管理入口•STM32CubeMCUPackages管理•固件包安装操作指南•固件包维护与管理目录01安装MCU固件包概述固件包安装的重要性固件包的核心作用安装MCU固件包是使用STM32CubeMX进行后续开发的基础前提，它包含了软件库文件夹设置和管理嵌入式软件包两大部分。只有正确安装固件包，才能为STM32系列MCU提供必要的驱动库、中间件及示例代码，确保开发过程的顺利进行。未正确安装的影响若未安装或安装不当，STM32CubeMX将无法识别目标MCU型号，导致无法生成初始化代码、配置外设功能等关键操作。同时，缺乏完整固件包支持会使项目开发受阻，无法充分利用MCU的硬件资源和功能特性。0102安装流程总览整体步骤框架MCU固件包安装流程主要包括两大阶段：首先是软件库文件夹（RepositoryFolder）的设置，需指定固件包的安装目录并避免默认路径问题；其次是通过EmbeddedSoftwarePackagesManager管理界面，选择并安装所需的STM32CubeMCUPackages，支持本地安装和在线安装两种方式。关键操作节点流程中需注意路径设置的永久性（设置后不可更改）、固件包版本的选择（建议保留最新版本）、安装方式的灵活选用（本地或在线），以及安装失败时的解决方案（如以管理员身份运行软件）。完成安装后，固件包会自动存储在指定的软件库目录下，形成结构化的固件库文件系统。02STM32CubeMX软件启动软件启动界面介绍启动界面组成双击桌面STM32CubeMX图标后，软件启动界面包含标题栏、主菜单栏及功能区域。标题栏显示“STM32CubeMXUntitled”，主菜单栏有File、Window、Help选项，功能区域提供新建项目、打开现有项目等快捷入口。主菜单项功能说明Help菜单核心功能Help菜单包含CheckforUpdates（检查更新）、Manageembeddedsoftwarepackages（管理嵌入式软件包）等关键功能。其中，Manageembeddedsoftwarepackages是安装和管理MCU固件包的入口，通过此选项可打开嵌入式软件包管理对话框。主界面快捷入口启动界面功能区域提供“Ineedto”操作列表，包括StartMyprojectfromMCU（从MCU创建项目）、Installorremoveembeddedsoftwarepackages（安装/卸载软件包）等快捷操作，方便用户快速访问常用功能。03软件库文件夹设置RepositoryFolder设置步骤进入UpdaterSettings对话框在STM32CubeMX软件启动后的界面，通过单击最上方主菜单项Help，然后选择UpdaterSettings，即可打开UpdaterSettings对话框，在其中进行RepositoryFolder的相关设置。设置软件库文件夹路径在UpdaterSettings对话框中，RepositoryFolder即为需设置的软件库文件夹，所有MCU固件包和扩展包都将安装到此目录下。建议设置为“C:\Users\lenovo\STM32Cube\Repository”，且该文件夹设置并安装固件包后不可更改。避免默认路径的原因默认路径存在的问题默认的软件库文件夹位于用户工作目录下，该路径可能带有汉字或空格。使用这样的路径安装固件包后，在后续使用过程中容易导致出错，影响软件的正常运行和操作。路径设置注意事项路径设置要点设置软件库文件夹路径时，需确保路径中不包含汉字、空格等特殊字符，选择简洁、规范的目录作为存储路径。同时，要牢记所设置的路径，以便后续对固件包进行管理和操作，如安装、卸载等。04UpdaterSettings对话框配置CheckandUpdateSettings设置更新方式设置选项CheckandUpdateSettings单选框用于配置STM32CubeMX软件的更新方式。用户可根据需求选择自动或手动检查更新，灵活控制软件获取最新版本的时机。建议根据网络环境和使用习惯合理设置，以确保软件功能及时更新。DataAuto-Refresh选项配置启动时数据刷新设置DataAuto-Refresh单选框用于设置STM32CubeMX启动时是否自动刷新已安装软件库的数据和文档。为加快软件启动速度，推荐选择NoAuto-RefreshatApplicationstart（不在启动时自动刷新）。用户可在软件启动后通过相应菜单项手动触发数据刷新。ConnectionParameters网络设置网络代理参数配置ConnectionParameters界面用于设置网络连接参数。无网络代理时，直接选择NoProxy（无代理）模式即可正常连接；若存在网络代理，需准确填写代理服务器地址、端口等参数。正确配置网络参数是确保软件正常获取在线资源的前提。05嵌入式软件包管理入口打开软件包管理的方法通过主菜单打开管理界面在STM32CubeMX软件启动后的主界面上，找到顶部的主菜单项“Help”，单击展开下拉菜单，从中选择“Manageembeddedsoftwarepackages”选项，即可打开嵌入式软件包管理对话框。此操作是进入软件包管理功能的主要途径，适用于需要安装、更新或卸载MCU固件包及扩展包的场景。EmbeddedSoftwarePackagesManager界面介绍管理对话框核心区域说明EmbeddedSoftwarePackagesManager对话框主要用于管理STM32CubeMCU固件包和扩展包，界面顶部会显示版本信息的最后刷新时间。中央区域以目录树形式展示不同厂商提供的软件包，包括STM32CubeMCUPackages和STMicroelectronics等分类，每个分类下包含具体系列的固件包及其已安装版本、可用版本等信息。界面下方设有FromLocal、Install、Remove等操作按钮，用于执行本地安装、在线安装、卸载等功能。分类名称包含内容管理功能STM32CubeMCUPackages各STM32系列MCU对应的固件包，如STM32F4系列的STM32CubeMCUPackage支持版本选择、在线安装、本地安装、卸载及刷新版本信息等操作STMicroelectronicsST官方提供的扩展包，包括人工智能库（X-CUBE-AI）、图形用户界面库（X-CUBE-TOUCHGFX）及MEMS、BLE、NFC芯片驱动库等可查看扩展包详情、管理已安装版本及获取可用更新软件包分类说明01主要软件包类型及内容06STM32CubeMCUPackages管理固件包版本选择原则版本选择核心依据在选择STM32CubeMCU固件包版本时，应优先考虑最新稳定版。最新版本通常包含已知缺陷修复、功能增强及对新工具链的支持，如STM32CubeIDE。同时需结合开发项目实际需求，确保所选版本支持目标MCU型号及必要功能。版本更新注意事项固件包更新会带来功能迭代，例如部分旧版工具链支持可能被discontinued，如SW4STM32已由STM32CubeIDE替代。选择时需参考官方更新说明，避免因版本不兼容导致开发障碍。建议定期通过Refresh功能检查可用版本，保持固件包时效性。目录树节点展开操作节点展开基本方法在EmbeddedSoftwarePackagesManager界面中，STM32CubeMCUPackages下列出各MCU系列节点，如STM32F4。双击系列节点或点击节点前展开图标，即可显示该系列下所有可用固件包版本，包括已安装和可更新版本。0102节点信息查看要点展开节点后，可查看各版本的详细信息，如版本号、发布日期、更新内容及文件大小。例如STM32CubeF4V1.28.0版本包含773.0MB文件，更新内容涉及缺陷修复和工具链支持调整。通过节点展开，可直观对比不同版本特性，辅助版本选择。多版本固件包处理建议版本管理核心原则为避免版本冲突和存储空间占用，建议在STM32CubeMX中仅保留一个最新版本固件包。多版本共存可能导致项目配置混乱，且旧版本漏洞未修复，存在潜在风险。多版本处理具体方法若需保留旧版本用于兼容性测试，可通过Remove按钮卸载不再使用的版本。当打开旧版本项目时，软件会提示迁移至新版本，通常可自动完成迁移。如需回退版本，可重新安装目标旧版本，但需确保项目配置与版本匹配。版本维护最佳实践定期使用Refresh功能同步版本信息，通过Install按钮更新至最新版，利用Remove清理冗余版本。对于团队开发，建议统一固件包版本，确保项目环境一致性，减少因版本差异导致的协作问题。07固件包安装操作指南FromLocal本地安装方法本地安装入口与文件选择在EmbeddedSoftwarePackagesManager界面中，点击FromLocal按钮即可启动本地安装流程。此功能适用于已从ST官网下载固件包压缩文件的场景，如stm32cube_fw_f4_v1280.zip（STM32F4系列1.28.0版本固件包）。选择目标压缩文件时，需注意无需提前解压，直接选中zip格式文件即可开始安装。01本地安装路径要求固件包压缩文件不能放置在软件库根目录下，否则可能导致安装失败或路径冲突。安装文件需存储在独立文件夹中，确保软件库目录结构清晰，避免与其他系统文件混淆。安装完成后，固件包将自动解压至预设的RepositoryFolder目录，并生成对应版本的子文件夹。02Install在线安装步骤在线安装入口与版本选择在EmbeddedSoftwarePackagesManager界面的STM32CubeMCUPackages目录树中，展开目标MCU系列节点（如STM32F4），勾选需安装的固件包版本。若该版本未安装，界面下方的Install按钮将变为可用状态，点击即可启动在线安装流程。建议优先选择最新稳定版本，以获取最新功能与缺陷修复。01在线安装流程与权限处理点击Install按钮后，STM32CubeMX将自动联网从ST官网下载固件包并完成安装，进度可在界面实时查看。若安装过程中弹出错误提示，需关闭所有弹窗后，以管理员身份重新运行STM32CubeMX，再次执行安装操作。安装完成后，固件包将自动存放至RepositoryFolder指定路径，如C:\Users\lenovo\STM32Cube\Repository\STM32Cube_FW_F4_V1.28.0。02失败类型解决方案网络连接问题检查网络代理设置（通过UpdaterSettings配置），确保ConnectionParameters正确；尝试刷新网络或更换网络环境后重试。用户权限不足关闭STM32CubeMX，右键以“管理员身份运行”软件，重新执行安装步骤。路径设置错误确认RepositoryFolder路径无中文、空格或特殊字符，建议使用纯英文路径（如C:\STM32CubeRepository）。安装文件损坏若为本地安装，重新从ST官网下载固件包压缩文件，校验文件完整性后重试安装。安装失败解决方案常见安装失败原因分析安装失败多由网络连接异常、用户权限不足或路径设置错误导致。网络问题可能表现为下载中断或超时；权限不足时，系统可能拒绝文件写入操作；路径包含中文或空格字符也会引发安装异常。针对性解决方法08固件包维护与管理Refresh刷新功能使用Refresh功能作用Refresh功能用于刷新EmbeddedSoftwarePackagesManager界面的目录树，确保显示最新的固件包版本信息。定期使用该功能可及时获取ST官网发布的固件包更新，避免因信息滞后导致安装旧版本。在固件包管理过程中，若长时间未操作界面，建议手动执行Refresh刷新，以同步服务器端的版本状态，确保版本选择的准确性。Remove卸载操作方法卸载操作步骤卸载固件包需先在EmbeddedSoftwarePackagesManager界面的目录树中选中已安装的版本，此时Remove按钮变为可用状态，单击该按钮即可删除对应版本的固件包。卸载前建议确认该版本未被当前项目使用，避免因依赖缺失导致项目异常。若卸载后需重新使用，可通过FromLocal或Install按钮重新安装。固件包版本安装路径示例目录名称1.28.0C:\Users\lenovo\STM32Cube\RepositorySTM32Cube_FW_F4_V1.28.0固件库目录结构说明固件库目录示例目录结构意义固件库目录由STM32CubeMX自动创建，命名格式包含系列名称（如F4）和版本号（如V1.28.0），便于用户识别和管理不同系列、版本的固件资源。目录下包含芯片驱动、中间件、示例代码等核心文件，是嵌入式项目开发的基础资源库，其路径需与软件库文件夹（RepositoryFolder）设置保持一致。感谢您的观看STM32CubeMX软件功能与基本使用CONTENTS•软件界面概述•初始主界面详解•主菜单功能详解•新建项目概述•选择MCU创建项目详解•其他新建项目方式•MCU图形化配置界面总览•MCU配置详解目录01软件界面概述初始主界面初始主界面组成STM32CubeMX启动后的初始界面主要分为主菜单栏、标签导航栏和工作区三个功能区。主菜单栏位于窗口最上方，包含File、Window、Help和myST四个主菜单项，前三个菜单项有下拉菜单供用户操作，myST用于用户登录，右端还有快捷按钮可打开相关网站。标签导航栏在主菜单栏下方，新建或打开项目后可在Home、新建项目、项目管理三个主要视图间快速切换。工作区为窗口其他区域，采用单文档界面，会根据当前操作显示不同内容。0102Home视图工作区Home视图工作区分为ExistingProjects、NewProject和Managesoftwareinstallations三个区域。ExistingProjects区域显示最近打开的项目，单击可打开；NewProject区域有三个按钮，分别用于选择MCU、开发板或交叉选择创建项目；Managesoftwareinstallations区域有CHECKFORUPDATES和INSTALL/REMOVE两个按钮，前者检查更新，后者打开软件包管理对话框。STM32CubeMX软件启动后的界面主菜单功能File菜单功能File菜单包含多项操作，NewProject用于打开选择MCU新建项目对话框创建.ioc后缀项目；LoadProject通过文件对话框选择并载入已有项目；ImportProject可导入其他项目的MCU设置，需新项目与导入项目MCU型号一致且未做设置；SaveProject保存当前项目，首次保存需选择文件夹和名称；SaveProjectAs将当前项目另存为新文件；CloseProject关闭当前项目；GenerateReport生成项目设置内容的PDF报告并保存；RecentProjects显示最近项目列表；Exit退出软件。Window菜单功能Window菜单主要有Outputs和Fontsize两个菜单项。Outputs为复选菜单项，勾选时在工作区最下方显示输出子窗口以显示输出信息；Fontsize包含三个子菜单项，用于设置软件界面字体大小，设置后需重启软件生效。Help菜单功能Help菜单功能丰富，Help显示英文版用户手册PDF文档；About显示软件相关信息对话框；Docs&Resources在打开或新建项目后有效，显示与项目MCU相关的技术文档列表，可下载并打开；RefreshData打开DataRefresh对话框刷新MCU和开发板数据或下载解压文档；UserPreferences设置是否允许软件收集用户使用习惯；CheckforUpdates检查软件及固件包等是否有更新；Manageembeddedsoftwarepackages打开对话框管理嵌入式软件包；UpdaterSettings设置软件库文件夹、检查更新及数据刷新方式。01020302初始主界面详解主菜单栏主菜单项组成窗口最上方是主菜单栏，有4个主菜单项，分别是File、Window、Help和myST。前3个菜单项有下拉菜单，可供用户通过下拉菜单项进行一些操作。单击myST可进行用户登录。主菜单栏功能主菜单栏右端是一些快捷按钮，单击这些按钮就会用浏览器打开相应的网站，如ST社区、ST官网等。软件的很多功能操作都是通过前三个主菜单项实现的。标签导航栏标签导航栏作用主菜单栏下方是标签导航栏。在新建或打开项目后，标签导航栏可以在STM32CubeMX的3个主要视图之间快速切换。三个主要视图这3个视图分别是Home（主页）视图，即初始界面；新建项目视图，新建项目时显示的用于选择具体型号的MCU或开发板创建项目的对话框；项目管理视图，用于对创建或打开的项目进行MCU图形化配置、中间件配置、项目管理等操作。工作区工作区特点窗口其他区域都是工作区。STM32CubeMX使用的是单文档界面，工作区会根据当前操作的内容显示不同的界面。Home视图工作区组成Home视图的工作区可以分为ExistingProjects区域、NewProject区域和Managesoftwareinstallations区域。ExistingProjects区域显示最近打开过的项目，单击某个项目就可以打开此项目。NewProject区域有3个按钮用于新建项目，选择MCU创建项目，选择开发板创建项目，或交叉选择创建项目。Managesoftwareinstallations区域有两个按钮：CHECKFORUPDATES按钮用于检查STM32CubeMX和嵌入式软件包的更新信息；INSTALL/REMOVE按钮用于打开相应对话框。Home视图按钮功能Home视图上的这些按钮的功能都可以通过主菜单里的菜单项实现操作。03主菜单功能详解File菜单◈NewProject（新建项目）打开选择MCU新建项目对话框，用于创建新的项目。STM32CubeMX的项目文件后缀是.ioc，一个项目只有一个文件。新建项目对话框是软件的3个视图之一，界面功能比较多，在后面具体介绍。◈LoadProject（加载项目）通过打开文件对话框选择一个已经存在的.ioc项目文件并载入项目。◈ImportProject（导入项目）选择一个ioc项目文件并导入其中的MCU设置到当前项目。注意，只有新项目与导入项目的MCU型号一致且新项目没有做任何设置，才可以导入其他项目的设置。◈SaveProject（保存项目）保存当前项目。如果新建的项目第一次保存，会提示选择项目名称，需要选择一个文件夹，项目会自动以最后一级文件夹的名称作为项目名称。◈SaveProjectAs（项目另存为）将当前项目保存为另一个项目文件。◈CloseProject（关闭项目）关闭当前项目。◈GenerateReport（生成报告）为当前项目的设置内容生成一个PDF报告文件，PDF报告文件名称与项目名称相同，并自动保存在项目文件所在的文件夹里。◈RecentProjects（最近的项目）显示最近打开过的项目列表，用于快速打开项目。◈Exit（退出）退出STM32CubeMX。Window菜单Outputs（输出）一个复选的菜单项，被勾选时，在工作区的最下方显示一个输出子窗口，显示一些输出信息。Fontsize（字体大小）有3个子菜单项，用于设置软件界面字体大小，需重启STM32CubeMX后才生效。Help菜单Help（帮助）显示STM32CubeMX的英文版用户手册PDF文档，文档有300多页，是个很齐全的使用手册。About（关于）显示关于本软件的对话框。Docs&Resources（文档和资源）仅在打开或新建项目后生效。选择该项将弹出对话框，列出与项目所用MCU型号相关的技术文档：数据手册、参考手册、编程手册、应用笔记等，均为ST官方资料，单击即可打开PDF。RefreshData（刷新数据）会显示DataRefresh对话框，自动用于刷新MCU和开发板的数据，或下载和解压选择的官方文档。UserPreferences（用户选项）会打开一个对话框用于设置用户选项，只有一个需要设置的选项，即是否允许软件收集用户使用习惯。CheckforUpdates（检查更新）会打开一个对话框，用于检查STM32CubeMX软件、各系列MCU固件包、STM32Cube扩展包是否有新版本需要更新。Manageembeddedsoftwarepackages（管理嵌入式软件包）会打开EmbeddedSoftwarePackagesManager对话框，对嵌入式软件包进行管理。UpdaterSettings（更新设置）会打开UpdaterSettings对话框，用于设置软件库文件夹，设置软件检查更新方式和数据刷新方式。04新建项目概述选择MCU创建项目NewProjectfromaMCU/MPU对话框单击主菜单项File→NewProject，或Home视图上的ACCESSTOMCUSELECTOR按钮，均可打开NewProjectfromaMCU/MPU对话框。该对话框是STM32CubeMX的3个主要视图之一，用于选择MCU或开发板以新建项目，界面包含MCU/MPUSelector、BoardSelector和CrossSelector三个界面。MCU/MPUFilters区域MCU/MPUFilters区域用于设置筛选条件以缩小MCU选择范围，上方有工具栏，包含Showfavorites（显示收藏）、SaveSearch（保存搜索条件）、LoadSearches（加载保存的搜索条件）和Resetallfilters（复位所有筛选条件）按钮。下方有PartNumberSearch编辑框用于型号搜索，以及Core、Series、Package等各组筛选条件，单击可展开选项。MCUs/MPUsList区域MCUs/MPUsList区域展示通过筛选或搜索得到的MCU列表，包含器件型号、封装、Flash、RAM等参数。可进行收藏/取消收藏、导出列表、双击新建项目、单击查看资料等操作，列表上双击条目会以所选MCU新建项目并关闭对话框进入项目管理视图。MCU资料显示区域在MCU列表单击条目时，MCU资料显示区域会展示该型号MCU的资料，包含Features（基本特性参数）、BlockDiagram（功能模块图）、Docs&Resources（文档和资源列表）、CADResources（CAD资源）等界面，以及Datasheet（数据手册）、Buy（购买界面）、StartProject（创建项目）等按钮。选择开发板新建项目选择开发板新建项目界面在NewProjectfromaMCU/MPU窗口中可选择开发板新建项目，STM32CubeMX目前仅支持ST官方的开发板。其界面会列出ST官方开发板相关信息，用户可从中选择所需开发板来创建项目。交叉选择MCU新建项目交叉选择MCU功能CrossSelector界面用于交叉选择MCU新建项目，针对其他厂家的MCU或STM32具体型号MCU，选择性能和外设资源相似的STM32MCU。对于在已有设计基础上选择新MCU重新设计非常有用，如替换其他厂家MCU或升级STM32MCU。交叉选择操作流程在左上方PartNumberSearch部分选择原有MCU的厂家和型号，厂家有NXP、Microchip、ST、TI等，选择后下方MatchingSTcandidates框会显示可选STM32MCU及匹配百分比。选择候选MCU后，右边区域会显示原MCU与候选STM32MCU的具体参数对比，帮助用户快速找到替换MCU。010205选择MCU创建项目详解NewProjectfromaMCU/MPU对话框对话框功能概述NewProjectfromaMCU/MPU对话框是STM32CubeMX用于新建项目的关键界面之一，作为软件的3个主要视图之一，其核心功能是供用户选择具体型号的MCU或开发板来创建项目。用户可通过单击主菜单项File→NewProject，或Home视图上的ACCESSTOMCUSELECTOR按钮打开该对话框。该对话框包含MCU/MPUSelector、BoardSelector和CrossSelector三个界面，分别对应选择MCU、选择开发板以及交叉选择MCU三种新建项目的方式，满足不同场景下的项目创建需求。MCU/MPUFilters区域筛选功能与操作MCU/MPUFilters区域主要用于设置筛选条件，帮助用户缩小MCU的选择范围，快速定位所需型号。区域内包含局部工具栏、型号搜索框以及多组筛选条件，如Core、Series、Package等，用户单击某个条件即可展开其选项进行设置。工具栏中设有Showfavorites（显示收藏）、SaveSearch（保存搜索条件）、LoadSearches（加载保存的搜索条件）和Resetallfilters（复位所有筛选条件）四个按钮，方便用户对筛选过程进行管理。型号搜索框支持直接输入MCU型号进行精准搜索，例如输入STM32F407可快速列出相关型号。MCUs/MPUsList区域列表功能与操作MCUs/MPUsList区域用于展示通过筛选或搜索得到的MCU列表，包含器件的具体型号、封装、Flash、RAM等参数。用户可在此区域进行多种操作，如单击星星图标收藏或取消收藏条目、通过Export按钮将列表内容导出为Excel文件。双击列表中的条目可直接以所选MCU新建项目并进入项目管理视图，单击条目则会在上方的MCU资料显示区域展示该MCU的详细资料，帮助用户进一步了解和确认所选型号。MCU资料显示区域资料内容与功能MCU资料显示区域在用户单击MCU列表中的条目时激活，用于展示该具体型号MCU的详细资料，包含多个界面和操作按钮。Features界面显示基本特性参数，BlockDiagram界面展示MCU功能模块图（首次显示需下载），Docs&Resources界面提供相关文档和资源列表，CADResources界面可访问和下载设计工具的Symbol原理图符号等资源。区域内还设有Datasheet（打开数据手册）、Buy（打开购买界面）和StartProject（创建项目）等按钮，用户可直接在此区域查看资料并启动项目创建流程，提升操作便捷性。06其他新建项目方式选择开发板新建项目开发板新建项目入口用户可在NewProjectfromaMCU/MPU窗口中选择开发板新建项目。该功能为熟悉开发板的用户提供了便捷的项目创建途径，无需手动选择具体MCU型号。01开发板支持范围说明STM32CubeMX目前仅支持ST官方的开发板。通过此方式新建项目时，软件会自动匹配开发板对应的MCU型号及预设配置，简化项目初始设置流程。02交叉选择MCU新建项目交叉选择功能用途交叉选择MCU新建项目适用于在已有设计基础上更换MCU的场景。例如，当原有设计的MCU性能不足或需替换其他厂家型号时