欢迎光临
我们一直在努力
        找回密码
当前位置：171主机测评 > 服务器技术 > 正文

STM32保姆级入门教程｜第3章：从新建工程到LED闪烁点灯（Hex生成+ST-Link/J-Link切换全攻略）

2026-03-16 分类：服务器技术 阅读(76) 评论(0)

系列前置博客：

  • STM32保姆级入门教程｜第1章：零基础必看，从认知到实战全解析
  • STM32CubeIDE配置STM32F103RCT6点亮PA0 LED+J-Link下载教程 本文核心：解决新手“Hex文件找不到、调试器切换报错、点灯代码难维护”三大痛点，掌握Hex文件自定义生成、ST-Link/J-Link无缝切换，最终实现LED闪烁点灯

    • 一、前置准备

    1. 软件准备

    • 已安装STM32CubeIDE（2024/2025版），并完成基础环境配置；
    • 已安装ST-Link、J-Link官方驱动（确保电脑能识别调试器）；
    • 前置工程：已完成STM32F103RCT6 PA0引脚GPIO输出模式基础配置（无基础工程可参考系列第二篇）。

    2. 硬件准备

    硬件器材规格与说明
    STM32开发板 STM32F103RCT6核心板（PA0引脚接LED，低电平点亮）
    调试器 ST-Link、J-Link
    辅助工具 USB数据线、SWD杜邦线（看是否需要外置LED）、万用表（可选，验证电平）

    二、新建STM32CubeIDE工程（零基础也能会）

    步骤1：启动软件并选择工作空间

    【对应截图1：STM32CubeIDE启动与工作空间选择界面】

  • 双击打开STM32CubeIDE，首次启动弹出工作空间选择窗口，选择全英文、无空格、无特殊符号的文件夹（如F:\\Stm32Studio）；
  • 勾选Use this as the default and do not ask again，点击Launch启动软件。 在这里插入图片描述

    • 步骤2：新建STM32工程

  • 点击顶部菜单栏 File → New → STM32 Project，弹出芯片选择窗口。 在这里插入图片描述

  • 在Commercial Part Number搜索框输入STM32F103RCT6，选中对应芯片后点击Next。 在这里插入图片描述

    • 💡划重点 记得把第二个红框里面的星星点亮收藏起来，下次就可以直接选择不用搜索

  • 工程配置页面按以下要求填写：

    • Project Name：填写STM32F103RCT6_LED_Blink（禁止中文/空格/特殊符号）；
    • Project Location：默认继承工作空间路径，无需修改；
    • 其余选项保持默认，点击Finish。
    • 在这里插入图片描述

  • 弹出切换透视图提示，勾选Remember my decision，点击Yes，进入CubeMX配置界面。

    • 步骤3：基础配置（GPIO+时钟+调试接口）

  • 左侧System Core → SYS，Debug下拉选择Serial Wire（SWD模式，必配，否则芯片锁死）。

    • 在这里插入图片描述

  • 左侧System Core → RCC，HSE下拉选择Crystal/Ceramic Resonator（外部晶振），无外部晶振则选Internal RC Oscillator。

    • 在这里插入图片描述

  • 引脚视图找到PA0，右键选择GPIO_Output； 在这里插入图片描述

  • 左侧System Core → GPIO，选中PA0，配置参数：

    • GPIO output level：High（初始熄灭）；
    • GPIO mode：Output Push Pull（推挽输出）；
    • Pull-up/Pull-down：No pull-up and no pull-down；
    • User Label：LED1（别名，方便代码调用）。 在这里插入图片描述

  • 顶部Clock Configuration，HCLK输入72，回车自动配置时钟树，无红色报错即成功。 在这里插入图片描述

  • 点击右上角保存图标（💾），弹出提示点击Yes，等待代码生成完成后进入代码编辑界面。 在这里插入图片描述 在这里插入图片描述

    • 三、Hex文件自定义生成配置（精准找到烧录文件）

    新手常见痛点：编译后找不到Hex文件、默认路径太深、想自定义文件名/保存位置，以下是全流程配置：

    步骤1：开启Hex文件生成（默认关闭，必配）

  • 右键点击工程名（STM32F103RCT6_LED_Blink）→ 选择Properties，打开工程属性窗口。 在这里插入图片描述

  • 在左侧列表中找到C/C++ Build → Settings → 右侧选择Tool Settings → MCU Post build outputs；

  • 在这里插入图片描述

  • 勾选以下选项（核心）：

    • Convert to Intel Hex file (-Oihex)：生成Intel格式Hex文件（通用烧录格式）；
    • Convert to binary file (-Obinary)（可选）：生成bin文件，兼容更多烧录工具；

  • 点击Apply and Close保存配置。

    • 步骤2：自定义Hex文件保存路径/文件名（可选，新手友好）

  • 仍在C/C++ Build → Settings → MCU Post build outputs界面；
  • 在Artifact name（有的版本叫 Output file name）输入框中自定义文件名（如STM32F103RCT6_LED_Blink）；
  • 若想修改保存路径，可在Build Artifact中调整Output directory（建议新手先使用默认路径，避免配置错误）。 在这里插入图片描述

    • 步骤3：编译验证Hex文件生成

  • 点击顶部工具栏锤子图标（Build）编译工程，控制台显示Build Finished. 0 errors, 0 warnings.即为成功；
  • 打开工程目录 → Debug文件夹，可看到生成的xxx.hex文件（与自定义文件名一致）。 在这里插入图片描述

    • 四、ST-Link/J-Link调试器切换全流程（附避坑）

    核心需求：同一工程兼容ST-Link和J-Link两种调试器，无需重新创建工程，只需切换调试配置：

    前提：硬件连接规则

    调试器引脚STM32核心板SWD引脚备注
    3.3V 3.3V/VCC 禁止接5V，否则烧坏芯片/调试器
    SWDIO SWDIO/DIO 数据引脚，接反无法通信
    SWCLK SWCLK/CLK 时钟引脚，接反无法通信
    GND GND 共地，必须接

    步骤1：配置ST-Link调试器（默认配置）

  • 点击顶部菜单栏Run → Run Configurations…，打开运行配置窗口； 在这里插入图片描述

  • 左侧选择STM32 Cortex C/C++ Application → 右键工程名 → New Configuration，新建配置； 在这里插入图片描述

  • 右侧切换到Debugger选项卡：

    • Debug probe选择ST-Link (ST-LINK GDB server)；
    • Interface选择SWD（必选，JTAG模式占用引脚多，新手不用）；
    • Reset mode选择Software system reset（烧录后自动复位运行）； 在这里插入图片描述

  • 点击Apply保存，命名为ST-Link_Config（方便区分）。 在这里插入图片描述

    • 步骤2：切换为J-Link调试器

    【对应截图15：J-Link调试配置界面】

  • 仍在Run Configurations窗口，复制上述ST-Link配置（右键ST-Link_Config → Duplicate），命名为J-Link_Config；
  • 切换到Debugger选项卡：
    • Debug probe选择 SEGGER J-Link；
    • Interface仍选择SWD；
    • Device name填写芯片型号（如STM32F103RC，必须精准，否则识别失败）；
  • 点击Apply保存配置。 在这里插入图片描述

    • 步骤3：调试器切换使用

  • 烧录时，点击顶部工具栏绿色播放图标旁的下拉箭头，选择对应的配置（ST-Link_Config/J-Link_Config）；
  • 点击播放图标，软件自动识别对应调试器并烧录程序，无需重复接线（只需替换调试器硬件）。 在这里插入图片描述

    • 在这里插入图片描述

    五、LED闪烁点灯

    完成工程、Hex、调试器配置后，编写优化版闪烁代码，解决基础版代码“难维护、改引脚要全改”的问题：

    1. 闪烁核心原理

    LED闪烁本质是**“电平翻转+延时”**：PA0引脚交替输出低电平（亮）、高电平（灭），中间加入固定时长延时，形成视觉上的闪烁效果。

    • 优化版思路：用宏定义封装引脚和电平逻辑，代码可读性更高、更易维护。

    2. 优化版闪烁代码编写（附截图）

    【对应截图17：main.c文件代码编辑界面】

  • 打开工程Core → Src → main.c文件，在/* USER CODE BEGIN Includes */下方添加宏定义（封装引脚和电平）：

    • /* USER CODE BEGIN Includes */
    // 封装LED引脚和电平逻辑，后期修改仅需改此处
    #define LED1_PORT GPIOA
    #define LED1_PIN GPIO_PIN_0
    #define LED1_ON GPIO_PIN_RESET // 低电平点亮
    #define LED1_OFF GPIO_PIN_SET // 高电平熄灭
    /* USER CODE END Includes */

  • 在while(1)主循环中写入优化版闪烁代码：

    • /* USER CODE BEGIN WHILE */
    while (1)
    {
    // 点亮LED
    HAL_GPIO_WritePin(LED1_PORT, LED1_PIN, LED1_ON);
    HAL_Delay(500); // 延时500ms
    // 熄灭LED
    HAL_GPIO_WritePin(LED1_PORT, LED1_PIN, LED1_OFF);
    HAL_Delay(500); // 延时500ms
    /* USER CODE END WHILE */

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

    ⚠️ 关键说明：

    • 宏定义LED1_ON/LED1_OFF对应硬件电路的点亮逻辑，若你的LED是高电平点亮，只需修改这两个宏定义；
    • HAL_Delay()是毫秒级延时函数，参数越大，闪烁越慢，例如改为1000则1秒亮、1秒灭。

    六、实战验证（多调试器烧录+闪烁效果测试）

    1. 编译烧录验证

  • 点击顶部工具栏锤子图标（Build）重新编译工程，确保无报错；
  • 选择任意调试器配置（ST-Link/J-Link），点击播放图标烧录程序；
  • 烧录完成后，开发板PA0引脚的LED会以1秒为周期循环闪烁，验证成功。

    • STM32保姆级入门教程｜第3章：从新建工程到LED闪烁点灯

    2. 手动烧录Hex文件（备用方案）

    若调试器直接烧录失败，可手动烧录Hex文件：

    • ST-Link：使用ST-Link Utility软件，选择File → Open File导入Hex文件 → Program & Verify烧录；
    • J-Link：使用J-Flash软件，选择芯片型号 → 导入Hex文件 → Auto programming烧录。

    七、常见问题排查（90%新手必踩的坑）

    故障现象排查优先级解决方法
    生成Hex文件后提示“文件为空” 1 1. 未勾选Convert to Intel Hex file；2. 工程编译有报错，需先解决编译错误；3. 自定义路径无写入权限（换默认路径）
    切换J-Link后提示“Device not found” 1 1. 检查J-Link驱动是否安装成功；2. Device name填写错误（如STM32F103RC而非STM32F103RCT6）；3. SWD接线是否接反
    切换调试器后烧录成功但LED不闪 2 1. 延时函数参数过小（如10ms，肉眼无法识别）；2. 宏定义电平逻辑与硬件不符；3. 芯片复位模式配置错误（改为Software system reset）
    新建工程编译报错 2 1. 工程名/路径含中文/空格；2. 时钟树配置错误（HCLK超过芯片最大主频）；3. 固件包未完整安装

    八、核心知识点总结

  • 新建工程关键：必须配置SWD调试接口和时钟树，PA0引脚设为推挽输出模式，避免芯片锁死或功能异常；
  • Hex文件生成：STM32CubeIDE默认不生成Hex文件，需手动勾选Convert to Intel Hex file，自定义文件名/路径更便于管理；
  • 调试器切换：同一工程可创建多个调试配置，ST-Link/J-Link核心区别是Debug probe选择和J-Link需填写精准的Device name；
  • LED闪烁优化：用宏定义封装引脚和电平逻辑，后期修改无需改动核心代码，提升可维护性。

    • 原创不易，如果本文对你有帮助，欢迎点赞👍、收藏⭐、关注➕，有任何问题都可以在评论区留言，我会一一回复！ 本文所使用的工程文件已上传至配套资源中，如有需要可自行下载。也可关注博主后留言获取。

    🎁欢迎关注，获取更多技术干货！

    公众号：BackCatK Chen，文章末尾可以扫码关注

    🎁资料包亮点

    这份资料包涵盖了从硬件电路设计到STM32单片机开发，再到Linux系统学习的全链路内容，适合不同阶段的学习者：

    • 硬件基础：包含硬件电路合集、硬件设计开发工具包，帮你打牢底层基础。
    • STM32专项：从环境搭建、开发工具、传感器模块到项目实战，还有书籍和芯片手册，一站式搞定STM32学习。
    • C语言进阶：C语言学习资料包，助你掌握嵌入式开发的核心语言。
    • 面试求职：嵌入式面试题合集，提前备战技术面试。
    • Linux拓展：Linux相关学习资料包，拓宽技术视野。
    📂资料包目录
    • 00-STM32单片机环境搭建
    • 01-硬件电路合集
    • 02-硬件设计开发工具包
    • 03-C语言学习资料包
    • 04-STM32单片机开发工具包
    • 05-STM32传感器模块合集
    • 06-STM32项目合集
    • 07-STM32单片机书籍&芯片手册
    • 08-Linux相关学习资料包 在这里插入图片描述
    赞(0)
    未经允许不得转载：171主机测评 » STM32保姆级入门教程｜第3章：从新建工程到LED闪烁点灯（Hex生成+ST-Link/J-Link切换全攻略）
    分享到： 更多 (0)
    标签：

    相关推荐

    评论 抢沙发

    取消

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址

    热门标签

    #人工智能(59289)#python(20108)#开发语言(16861)#java(15468)#运维(15359)#linux(14947)#大数据(14576)#服务器(13065)#算法(11781)#前端(10903)#网络(9374)#ai(8915)#数据库(8898)#c++(8173)#课程设计(6802)#学习(6769)#机器学习(6712)#区块链(5919)#OpenClaw(5388)#后端(5154)#spring boot(5007)#深度学习(4950)#c语言(4376)#毕业设计(4293)#数据结构(4199)#安全(4062)#docker(3931)#架构(3853)#javascript(3809)#大模型(3652)

    热门文章

    最新文章

    归档

    分类