【动手学电机驱动】 STM32-FOC（2）STM32 导入和创建项目

STM32-FOC（1）STM32 电机控制的软件开发环境
 STM32-FOC（2）STM32 导入和创建项目
 STM32-FOC（3）STM32 互补 PWM 输出
 STM32-FOC（4）IHM03 电机控制套件介绍
 STM32-FOC（5）IHM03 套件无感FOC 控制

【动手学电机驱动】STM32-FOC（2）STM32G4 导入和创建项目

- [1. 使用 CubeIDE 导入 LED 闪灯例程](#1. 使用 CubeIDE 导入 LED 闪灯例程)
- [2. 使用 CubeMX 导入和生成 LED 闪灯程序](#2. 使用 CubeMX 导入和生成 LED 闪灯程序)
- [3. 使用 CubeMX 创建和编写 LED 闪灯程序](#3. 使用 CubeMX 创建和编写 LED 闪灯程序)

本节内容：

本节通过 NUCLEO-G431RB 开发板，以 LED 点灯实验为例，介绍 STM32G4 的编程和调试。这是 STM32G4 学习的第一个实验。

以 LED 点灯实验为例，学习使用 STM32CubeIDE 开发工具导入项目，编译、烧录和运行程序。
以 LED 点灯实验为例，学习使用 STM32CubeMX 开发工具创建、配置新项目，导入例程生成代码，编译与调试程序。
以 LED 点灯实验为例，学习使用 STM32CubeMX 开发工具创建、配置新项目，编写程序代码，编译与调试程序。

实验条件:

① 硬件平台：NUCLEO-G431RB 开发板

② 软件平台：STM32CubeMX， STM32CubeIDE

1. 使用 CubeIDE 导入 LED 闪灯例程

导入已有的例程项目，以LED 闪灯程序（GPIO_IOToggle 项目）为例，具体操作步骤如下：

打开 STM32CubeIDE。
打开已有的例程项目 GPIO_IOToggle。

选择 Import STM32Cube example 导入 STM32Cube 例程：

弹出 STM32 Project from STM32Cube examples 窗口；
在例程选择器（Example Selector）-- 开发板选择（Board）选择使用的 MCU开发板为 "NUCLEO-G431RB" ；
在例程列表（Examples List）中选择 GPIO_IOToggle，如下图所示。
点击 "Next" 导入例程，在 "CubeFW G4 License Agreement" 时要选择接受版权协议。

打开例程文件 main.c。

导入 GPIO_IOToggle 项目后，自动转换到 STM32CubeIDE 的主界面

从 Application - User 目录下打开程序文件 main.c，如下图所示。
打开例程文件 main.c。

轮询程序 while(1) 的代码如下，通过延时 100ms 翻转 LED2_PIN，来实现 LED2 以 100ms 进行闪烁。

c 复制代码

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
    HAL_GPIO_TogglePin(LED2_GPIO_PORT, LED2_PIN);
    /* Insert delay 100 ms */
    HAL_Delay(100);
  }
  /* USER CODE END 3 */

点击工具栏中 "Build Debug" 按键对程序代码进行编译。

用 USB连接线，连接 PC 与 NUCLEO-G431RB 开发板。
点击工具栏中 "Debug" 按键，将程序下载烧录到目标板 NUCLEO-G431RB 。

点击工具栏中 "Resume" 按键或 F8 快捷键，运行程序。NUCLEO-G431RB 开发板上的 LD2 指示灯以 100ms 开始闪烁。

修改延时时间，重新编译、烧录和运行程序。

将轮询程序 while(1) 中的延时时间修改为 1000ms，来实现 LED2 以 1s 进行闪烁。

c 复制代码

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
    HAL_GPIO_TogglePin(LED2_GPIO_PORT, LED2_PIN);
    /* Insert delay 1000 ms */
    HAL_Delay(1000);
  }
  /* USER CODE END 3 */

程序烧录后，点击工具栏中 "Resume" 按键或 F8 快捷键，运行程序。此时 NUCLEO-G431RB 开发板上的 LD2 指示灯以 1000ms 开始闪烁。

关闭项目，关闭 STM32CubeIDE 。
NUCLEO-G431RB 开发板重新上电（只要用 USB 为开发板供电即可，并不需要连接 PC）。按下黑色按键 B2，MCU 重启（Reset），开发板上的 LD2 指示灯以 1000ms 开始闪烁。

2. 使用 CubeMX 导入和生成 LED 闪灯程序

用户创建新的项目，以创建 LED 闪灯程序项目为例，具体操作步骤如下：

打开 STM32CubeMX。
选择 New Project（或Ctrl-N快捷键）新建工程，进入 New Project 界面。

选择MCU为 STM32G431RBT6（参考开发板的 MCU 型号选择）。

选择开发板为 NUCLEO-G431RB 开发板。

如果要直接导入STM32Cube 例程，可以继续从 Example Selector 选择所需的例程，然后点击 "Start Project" 建立项目。

点击 "Start Project" 建立项目。弹出项目信息确认窗口如下，点击 "Install" 安装选择的例程项目。

例程项目安装完成后，自动转入 CubeMX 的 Pinout Configuration 视图。
如下图所示，在右下角的搜索栏中搜索 PA5 管脚，将其设置为 GPIO_Output。

代码生成。
点击菜单 "Project Manager" 按钮，进入工程配置界面，如下图所示。

输入项目名称，选择项目的保存路径。
将Toolchain / IDE 设定为 STM32CubeIDE（根据用户安装和使用的 IDE 选择，也可以选择 EWARM、MDK-ARM、MakeFile、CMake 等IDE工具）
点击右上角 "GENERATE CODE" 生成代码
加载完毕后，弹出代码生成提示窗口，点击" OPEN PROJECT"，进入 STM32CubeIDE。

在 STM32CubeIDE 打开例程文件 main.c。

代码生成后，已经自动进入 STM32CubeIDE，并打开 GPIO_IOToggle 项目。注意这个 GPIO_IOToggle 项目，不是系统提供的例程项目，而是我们刚刚创建新项目，其文件目录结构也与上节例程项目不同。但本项目中的程序内容仍是从例程项目下载安装的，详见前文 "继续从 Example Selector 选择所需的例程"。

从 Scr 目录打开程序文件 main.c，如下图所示。
打开例程文件 main.c。

轮询程序 while(1) 的代码如下，通过延时 100ms 翻转 LED2_PIN，来实现 LED2 以 100ms 进行闪烁。

c 复制代码

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
    HAL_GPIO_TogglePin(LED2_GPIO_PORT, LED2_PIN);
    /* Insert delay 100 ms */
    HAL_Delay(100);

  }
  /* USER CODE END 3 */

程序编辑、编译与调试

用 USB连接线，连接 PC 与 NUCLEO-G431RB 开发板。
点击工具栏中 "Build Debug" 按键对程序代码进行编译。
点击工具栏中 "Debug" 按键，将程序下载烧录到目标板 NUCLEO-G431RB 。
点击工具栏中 "Resume" 按键或 F8 快捷键，运行程序。NUCLEO-G431RB 开发板上的 LD2 指示灯以 100ms 开始闪烁。

修改延时时间，重新编译、烧录和运行程序。

将轮询程序 while(1) 中的延时时间修改为 1000ms，来实现 LED2 以 1s 进行闪烁。

c 复制代码

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
    HAL_GPIO_TogglePin(LED2_GPIO_PORT, LED2_PIN);
    /* Insert delay 1000 ms */
    HAL_Delay(1000);

  }

程序烧录后，点击工具栏中 "Resume" 按键或 F8 快捷键，运行程序。此时 NUCLEO-G431RB 开发板上的 LD2 指示灯以 1000ms 开始闪烁。

关闭项目，关闭 STM32CubeIDE 。
NUCLEO-G431RB 开发板重新上电（只要用 USB 为开发板供电即可，并不需要连接 PC）。按下黑色按键 B2，MCU 重启（Reset），开发板上的 LD2 指示灯以 1000ms 开始闪烁。

3. 使用 CubeMX 创建和编写 LED 闪灯程序

使用 CubeMX 创建和编写 LED 闪灯程序，前面的步骤与上节 "使用 CubeMX导入LED 闪灯程序" 相同，但在新建工程时，只选择MCU 型号和开发板型号，不从 Example Selector 选择例程，而是自行编写相关的程序内容。

仍以创建 LED 闪灯程序项目为例，具体操作步骤如下：

打开 STM32CubeMX。
选择 New Project（或Ctrl-N快捷键）新建工程，进入 New Project 界面。

选择MCU为 STM32G431RBT6（参考开发板的 MCU 型号选择）。
选择开发板为 NUCLEO-G431RB 开发板。

本节不从 Example Selector 选择例程，而是在选择 MCU 和开发板后直接点击 "Start Project" 建立项目。弹出项目选项窗口，勾选 "Generate demonstration code"，如下图所示。

自动转入 CubeMX 的 Pinout Configuration 视图，如下图所示。

在右下角的搜索栏中搜索 PA5 管脚，将其设置为 GPIO_Output。
代码生成。

点击菜单 "Project Manager" 按钮，进入工程配置界面，如下图所示。

输入项目名称，选择项目的保存路径。（注意不要与之前的项目名称相同）
将Toolchain / IDE 设定为 STM32CubeIDE（根据用户安装和使用的 IDE 选择，也可以选择 EWARM、MDK-ARM、MakeFile、CMake 等IDE工具）
点击右上角 "GENERATE CODE" 生成代码
加载完毕后，弹出代码生成提示窗口，点击" OPEN PROJECT"，进入 STM32CubeIDE。

在 STM32CubeIDE 打开例程文件 main.c。
代码生成后，已经自动进入 STM32CubeIDE，并打开 GPIO_IOToggle 项目。注意这个 GPIO_IOToggle 项目，不是系统提供的例程项目，而是我们刚刚创建新项目，其文件目录结构也与上节例程项目不同。
本项目中的程序内容也不是从例程项目下载安装的，而是 CubeMX 根据用户在新建项目中的配置自动生成的。
从 Scr 目录打开程序文件 main.c，如下图所示。

打开程序文件 main.c。

本项目中的程序文件 main.c 不是从例程项目下载安装的，而是 CubeMX 根据用户在新建项目中的配置自动生成的。因此，在轮询程序 while(1) 中，并没有延时翻转实现 LED 闪烁的程序代码。

CubeMX 生成的程序文件 main.c 中的轮询程序 while(1) 的代码如下。

c 复制代码

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {

    /* -- Sample board code for User push-button in interrupt mode ---- */
    if (BspButtonState == BUTTON_PRESSED)
    {
      /* Update button state */
      BspButtonState = BUTTON_RELEASED;
      /* -- Sample board code to toggle leds ---- */
      BSP_LED_Toggle(LED_GREEN);

      /* ..... Perform your action ..... */
    }
    /* USER CODE END WHILE */
  }

编写 LED 闪烁的程序代码。

在轮询程序 while(1) 中，在 "/* ... Perform your action ... */" 位置，添加延时翻转实现 LED 闪烁的程序代码如下。

c 复制代码

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {

    /* -- Sample board code for User push-button in interrupt mode ---- */
    if (BspButtonState == BUTTON_PRESSED)
    {
      /* Update button state */
      BspButtonState = BUTTON_RELEASED;
      /* -- Sample board code to toggle leds ---- */
      BSP_LED_Toggle(LED_GREEN);
    }

    /* ..... Perform your action ..... */
    /* USER CODE BEGIN 3 */
    HAL_GPIO_TogglePin(LED2_GPIO_PORT, LED2_PIN);
    /* Insert delay 200 ms */
    HAL_Delay(200);
    /* USER CODE END 3 */
  }
  /* USER CODE END WHILE */

程序编辑、编译与调试

用 USB连接线，连接 PC 与 NUCLEO-G431RB 开发板。
点击工具栏中 "Build Debug" 按键对程序代码进行编译。
点击工具栏中 "Debug" 按键，将程序下载烧录到目标板 NUCLEO-G431RB 。
点击工具栏中 "Resume" 按键或 F8 快捷键，运行程序。NUCLEO-G431RB 开发板上的 LD2 指示灯以 200ms 开始闪烁。

修改延时时间，重新编译、烧录和运行程序。

将轮询程序 while(1) 中的延时时间修改为 1000ms，来实现 LED2 以 1s 进行闪烁。

c 复制代码

    /* ..... Perform your action ..... */
    /* USER CODE BEGIN 3 */
    HAL_GPIO_TogglePin(LED2_GPIO_PORT, LED2_PIN);
    /* Insert delay 1000 ms */
    HAL_Delay(1000);
    /* USER CODE END 3 */

程序烧录后，点击工具栏中 "Resume" 按键或 F8 快捷键，运行程序。此时 NUCLEO-G431RB 开发板上的 LD2 指示灯以 1000ms 开始闪烁。

关闭项目，关闭 STM32CubeIDE 。
NUCLEO-G431RB 开发板重新上电（只要用 USB 为开发板供电即可，并不需要连接 PC）。按下黑色按键 B2，MCU 重启（Reset），开发板上的 LD2 指示灯以 1000ms 开始闪烁。