机智云Gokit3开发篇 — 搭建Gokit3工程（HAL库版）

 

在当今物联网时代，越来越多的开发者希望能够快速上手并实现创新的产品与应用。机智云的Gokit3开发板因其易用性和丰富功能受到初学者的青睐。该开发板核心主控采用了高性价比的STM32F103C8T6微控制器，支持多种开发环境，使学习与开发变得更加便捷。

 

本文将带您从零基础开始，逐步搭建Gokit3的HAL库工程，并通过简单的点灯实验，让您感受开发的乐趣。在这个过程中，我们将学习如何使用STM32的HAL库，掌握基本的开发流程，为后续更复杂的项目打下坚实的基础。

文章结尾附本文章源码、原理图资料链接。

 

01硬件清单
 

 

Gokit3 开发板（核心：STM32F103C8T6）

Micro USB 数据线（供电 / 下载）

ST-Link 下载器（若板子自带则无需额外，Gokit3 一般集成了 ST-Link）

 

软件清单

软件名称

l STM32CubeMX----可视化配置工程、生成 HAL 库代码

官网下载链：（https://www.st.com/en/development-tools/stm32cubemx.html）；

安装时需下载STM32F1 系列固件包（CubeMX 内可直接下载）；

l Keil MDK-ARM V5代码编译、下载调试

下载V5 版本（需兼容 F1 系列）；

安装对应芯片包（STM32F1xx_DFP）；

需破解（新手可自行找教程，注意选择支持F1 的许可证）。

 

02开始搭建工程
 

 

1、步骤1：STM32CubeMX 新建工程

 

介绍：STM32CubeMX 是 ST 官方的可视化配置工具，能极大简化 HAL 库工程搭建，新手不用手动配置寄存器，效率拉满

 

打开CubeMX，选择芯片型号

双击打开STM32CubeMX，点击主界面的 “New Project”；

 

 

 

在“Part Number Search” 搜索框输入 STM32F103C8T6，选中搜索结果中的芯片（注意区分 LQFP48 封装），点击 “Start Project”；

 

 

2、步骤 2：基础配置（时钟 / 调试接口）

（1）配置调试接口（必须，否则无法下载程序）

点击左侧菜单栏“System Core” → “SYS”；

右侧“Debug” 选项选择 “Serial Wire”（SWD 模式，占用引脚少，Gokit3自带SWD烧录接口）；

 

 

 

（2）配置时钟源和时钟树（决定系统主频）

Gokit3 的 STM32F103C8T6 外接 8MHz 晶振（HSE），我们配置系统主频为 72MHz（F103 的最大主频）：

 

点击左侧“RCC”；

右侧“High Speed External (HSE)” 选择 “Crystal/Ceramic Resonator”（外部晶振）；

 

 

点击顶部菜单栏“Clock Configuration”（时钟配置）；

配置时钟树：

HSE 设为 8MHz；

PLLSRC 选择 HSE；

PLLMUL 选择 x9（8*9=72MHz）；

HCLK 选择 72MHz；

PCLK1 选择 36MHz（APB1 最大 36MHz）；

PCLK2 选择 72MHz；

 

 

 

3、步骤 3：配置 LED 引脚（Gokit3 硬件对应）

先查 Gokit3 原理图：有4个LED 正极接PB1、PB11、PB14、PB15 引脚（高电平点亮，低电平熄灭）原理图如下：

 

 

 

 

 

配置如下：（我们以LED1为例）

点击左侧“GPIO”；

在引脚列表中找到 PB1，点击下拉菜单：

Mode 选择 “Output Push Pull”（推挽输出）；

Pull-up/Pull-down 选择 “Pull down”（下拉，默认低电平，LED 灭）；

Speed 选择 “Low”（低速即可，LED 无需高速）；

可给 PB0 重命名（方便识别）：在 “User Label” 栏输入 LED0，后续代码中可直接用这个别名。

 

 

 

STM32F103C8T6 的 GPIO 外设支持八种工作模式，可分为输入模式、输出模式、复用输出模式三大类

这里介绍GPIO的八种模式

 

输入浮空（GPIO_Mode_IN_FLOATING）

输入上拉（GPIO_Mode_IPU）

输入下拉（GPIO_Mode_IPD）

模拟输入（GPIO_Mode_AIN）

开漏输出（GPIO_Mode_Out_OD）

推挽输出（GPIO_Mode_Out_PP）

复用开漏输出（GPIO_Mode_AF_OD）

复用推挽输出（GPIO_Mode_AF_PP）

 

4、步骤 4：生成工程代码

点击顶部菜单栏“Project Manager”；

配置项目基本信息：

Project Name：输入工程名（如Gokit3_LED_HAL）；

Project Path：选择保存路径（这里推荐全英文路径，兼容性问题）；

Toolchain/IDE：选择 “MDK-ARM”；

 

 

 

配置代码生成选项：

勾选“Generate peripheral initialization as a pair of '.c/.h' files per peripheral”（按外设生成独立的.c/.h 文件，代码更整洁）；

其他默认即可；

点击右上角“GENERATE CODE”，等待代码生成完成，然后点击 “Open Project” 自动打开 Keil 工程。

 

03Keil 工程配置与代码编写
 

1、步骤 1：编写点灯代码（核心逻辑）

STM32CubeMX 生成的代码已包含 HAL 库底层驱动，我们只需在main.c中添加点灯逻辑即可：

打开Core/main.c文件，找到while(1)循环（约 95 行左右）；

在while(1)中添加如下代码：

HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_1);

HAL_Delay(500);

 

 

 

完整main.c关键片段参考：

 

@font-face{font-family:"Times New Roman";}@font-face{font-family:"宋体";}@font-face{font-family:"Calibri";}p.MsoNormal{mso-style-name:正文;mso-style-parent:"";margin:0pt;margin-bottom:.0001pt;mso-pagination:none;text-align:justify;text-justify:inter-ideograph;font-family:Calibri;mso-fareast-font-family:宋体;mso-bidi-font-family:'Times New Roman';font-size:10.5000pt;mso-font-kerning:1.0000pt;}span.msoIns{mso-style-type:export-only;mso-style-name:"";text-decoration:underline;text-underline:single;color:blue;}span.msoDel{mso-style-type:export-only;mso-style-name:"";text-decoration:line-through;color:red;}@page{mso-page-border-surround-header:no;mso-page-border-surround-footer:no;}@page Section0{}div.Section0{page:Section0;}int main(void){  /* 1. 初始化HAL库 */  HAL_Init();   /* 2. 配置系统时钟（CubeMX自动生成） */  SystemClock_Config();   /* 3. 初始化外设（CubeMX自动生成，包含PB0） */  MX_GPIO_Init();   /* 4. 主循环 */  while (1)  { /* 点灯核心代码：LED0（PB0）翻转电平，间隔500ms闪烁 */ HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_1);  // 翻转PB0电平（亮→灭/灭→亮） HAL_Delay(500);                         // 延时500ms（HAL库自带延时函数，单位ms）  }}     

 

代码解释

 

HAL_Init()：初始化 HAL 库核心组件（如 SysTick 定时器，用于HAL_Delay）；

SystemClock_Config()：CubeMX 自动生成的时钟配置函数，对应我们之前设置的 72MHz 主频；

MX_GPIO_Init()：初始化 GPIO（包含 PB0 的输出配置）；

HAL_GPIO_TogglePin()：HAL 库 GPIO 电平翻转函数，参数 1=GPIO 端口（GPIOB），参数 2 = 引脚（GPIO_PIN_0）；

HAL_Delay()：HAL 库毫秒级延时函数，底层基于 SysTick 定时器实现。

 

2、步骤 2：下载程序到 Gokit3:

不会烧录下载的可以此文章

链接：

《机智云Gokit3开发篇》1如何给Gokit3烧录程序(MCU+ST-Link版)-GoKit 开源套件-开源项目及赛事-机智云

 

3、步骤 3：验证效果

此时Gokit3 上的LED 1会以 500ms 为间隔循环闪烁，STM32 HAL 库工程搭建成功，点灯实例也成功跑起来。

 

 

通过本次介绍，我们从零基础开始成功搭建了Gokit3的HAL库工程，并完成了简单的点灯实验，体验了开发的乐趣与成就感。希望这篇文章能够为您的STM32学习之旅提供帮助，并激发您在物联网开发领域的探索兴趣。