第2章开发环境搭建

2、开发环境搭建：STM32CubeIDE安装、G4系列Pack包安装、第一个LED工程

好，咱们正式开始动手了。

这一章其实没什么高深的理论，但却是整个课程的地基。我见过不少朋友，算法写得飞起，结果卡在环境配置上，折腾一整天连个灯都点不亮。嗯，咱们别走那个弯路。

说白了，开发环境搭建就三件事：装IDE、装芯片支持包、写个LED程序验证一下。咱们一步步来。

2.1 STM32CubeIDE 安装

STM32CubeIDE 是ST官方基于Eclipse打造的免费IDE。我个人习惯用它，因为集成了代码编辑、编译、调试，还自带CubeMX图形化配置，省去了来回切换工具的麻烦。

下载与安装步骤：

去ST官网搜索“STM32CubeIDE”，找到对应操作系统的安装包。Windows就选.exe，Linux选.deb或.rpm。
双击安装，一路默认路径就行。我建议别装到C盘，万一后面工程多了，C盘容易爆。
安装过程中会提示是否安装驱动，选“是”。尤其是ST-Link驱动，后面调试全靠它。
安装完成后，首次启动会提示选择工作空间（Workspace）。我习惯单独建一个文件夹，比如 D:\STM32_Workspace，方便管理。

小技巧： 工作空间路径不要带中文和空格。我曾经因为路径里有个“项目”两个字，编译死活报错，查了半天才发现是编码问题。

2.2 G4系列Pack包安装

IDE装好了，但这时候它还认不出STM32G4系列芯片。你得给它装“芯片支持包”，也就是Pack包。

为什么需要Pack包？ 你想想看，IDE本身只是个框架，它得知道G4芯片有多少引脚、有哪些外设、寄存器地址是多少。这些信息都封装在Pack包里。

安装步骤：

打开STM32CubeIDE，点击菜单栏 Help → Manage Embedded Software Packages。
在弹出的窗口中，找到 STM32G4 Series，勾选你需要的版本。我建议选最新的稳定版，比如当前最新的 1.2.0 或更高。
点击 Install Now，等待下载完成。这个过程取决于网速，有时候会比较慢，耐心等。
安装完成后，在 Installed 标签页里能看到G4系列已经打勾了。

注意： 如果你在公司内网，或者网络受限，可能会下载失败。这时候可以手动去ST官网下载离线Pack包，然后通过 File → Import → Existing Projects 导入。我遇到过好几次这种情况，后来干脆把常用Pack包都下载到本地U盘里备着。

2.3 创建第一个LED工程

环境搭好了，咱们来点实际的。让板子上的LED灯闪起来，这是嵌入式开发的“Hello World”。

步骤一：新建工程

点击 File → New → STM32 Project。
在芯片选择界面，输入你的芯片型号。比如我用的是 STM32G431KB，直接搜就行。
选中后点击 Next，给工程起个名字，比如 LED_Blink。注意，名字也别带中文。
选择编译链，默认是 STM32CubeIDE (GCC)，不用改。点击 Finish。

步骤二：配置引脚

工程创建后会自动打开CubeMX的图形化配置界面。咱们要配置一个GPIO输出，用来控制LED。

在 Pinout & Configuration 标签页里，找到芯片引脚图。
假设LED接在 PC13 引脚（很多G4开发板默认是这样）。点击 PC13，在弹出菜单中选择 GPIO_Output。
在左侧 System Core → GPIO 里，可以配置输出模式。我一般选 Push-Pull（推挽输出），速度选 Low 就行，LED不需要高速。

  核心点： 配置完引脚后，记得按 Ctrl+S 保存。CubeMX会自动生成初始化代码。这一步很多人会忘，结果代码里根本没有GPIO初始化函数。

步骤三：编写代码

保存后，切换到 Core → Src → main.c。找到 main() 函数里的 while(1) 循环，加入以下代码：

/* 用户代码开始 */
while (1)
{
  HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);  // 翻转PC13电平
  HAL_Delay(500);                           // 延时500ms
  /* 用户代码结束 */
}

这段代码的逻辑很简单：每500ms翻转一次LED引脚的电平，灯就会一亮一灭。

步骤四：编译与下载

点击工具栏上的小锤子图标（或者按 Ctrl+B）编译工程。如果代码没问题，控制台会输出 Build Finished。
用ST-Link连接开发板和电脑。点击绿色小虫子图标（或者按 F11）进入调试模式。
在调试界面，点击 Resume（F8）让程序全速运行。这时候，板子上的LED应该开始闪烁了。

避坑指南： 我曾经遇到过一次，编译通过但下载后灯不亮。查了半天，发现是ST-Link的接线松了。所以，如果灯不亮，先检查硬件连接，别急着怀疑代码。

2.4 小结

到这，你的开发环境就算搭好了。LED闪烁虽然简单，但它验证了从IDE安装、芯片包配置、到代码编写和下载的完整流程。后面咱们要做的数字电源算法，都是在这个基础上一步步加进来的。

📚 课程目录

2、开发环境搭建：STM32CubeIDE安装、G4系列Pack包安装、第一个LED工程

2.1 STM32CubeIDE 安装

2.2 G4系列Pack包安装

2.3 创建第一个LED工程

2.4 小结