你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

基于STM32实战搭建模板工程经验分享

[复制链接]
攻城狮Melo 发布时间:2023-6-14 16:00
从今天起我会更新一个STM32实战系列教程,以STM32F103RCT6核心板为例由浅至深的向大家介绍嵌入式软件开发的学习过程,计划是先从最基础的搭建工程开始,到裸机开发,再到各种中间件的使用,最后以一个综合例程结束该系列。想要一起学习的童鞋可以点一下上方的关注,让我们开始我们的开发之旅吧
本次例程会建立一个STM32F1的HAL(Hardware Abstract Layer)库的Keil工程模板,然后点亮一个LED,以后的开发可以基于该模板进行。有的童鞋可能会觉得直接从网上下一个模板就行了,没必要自己搭建;但事实上是我们自己搭建模板并不仅仅是为了之后用起来方便,更重要的是了解STM32工程的组成,启动顺序等知识。其实很多初做嵌入式开发的人只是面向百度开发,没有建立起自己知识框架的意识;我曾经问过身边用过STM做开发的一些朋友,向上都用过各种外设但自己搭建个工程却困难重重。如果想要把STM32学透,还是应该多尝试使用官方提供的芯片数据手册等解决问题而不是查百度。
7 j' B, R3 Y5 F3 Q$ \  X& m7 o
好的我们言归正传,本系列使用的核心板主控为STM32F103RCT6,芯片内建256KB FLASH、48KB SRAM,板载了SPI FLASH、USB转TTL、一个LED与一个按键,其余引脚均用排针引出,童鞋们也可以使用其他开发板,开发过程大同小异。
  d, R# Q" q% Z+ y: R7 }
1、准备
本教程所需的内容如下:
  • STM32F1核心板
  • JLINK或者其他调试器(已装好驱动)
  • Keil开发环境
  • STM32F1的HAL库
    $ T5 f1 j# x0 Q* r
$ i  P4 _  X# N9 y$ `* Z8 g, f
所需的前两项都可用淘宝解决,也可以自己制作,百度一个驱动装好。其次我们需要安装Keil5环境,这个可以直接从KEIL的官网上下到,注意要下三个东西:keil5本体、CMSIS包、STM32F1器件包,下完之后一路安装即可。再次我们需要去ST官网上下载STM32F1的HAL库,我们需要先创建一个ST帐号,然后在搜索框中搜索HAL,选择工具与软件,下图中就是:
) I2 J6 K/ F% w% y: r" S
微信图片_20230614160043.png

% w+ r% L+ P4 f  V! K
下载到本地后解压缩,然后将文件夹下的Drivers->CMSIS与Drivers->STM32F1xx_HAL_Driver放到一个你觉得可以存放库文件的位置,例如:D:\STM32\lib\f1,之后就可以开始下一步了。

1 `" u3 O1 U& F! H- A) _4 R
2、搭建
在打开KEIL之前,我们先创建一个文件夹用来存放模板,这里以为D:\STM32\Template\为例,再在该文件夹下按照如图所示的文件结构创建文件夹(也可按自己想法组织文件):

) G! T  i) W9 R& p5 ^/ T  ~. \( o
微信图片_20230614160040.png
, d9 ^% B" h! L
然后我们需要准备几个工程所需的文件,需要注意有些从库中拷出的文件是只读的,记得右键属性取消只读。
1. stm32f1xx_hal_msp.c
该文件是HAl库提供的存放芯片支持包(MCU Support Package)函数的位置,该文件在库文件的Drivers->STM32F1xx_HAL_Driver->Src中有模板,名为stm32f1xx_hal_msp_template.c,我们可以将其拷到Template\Core中改名为stm32f1xx_hal_msp.c。该文件中的HAL_MspInit函数是在HAL库初始化完成后被调用,我们计划在这里使能外部晶振,配置芯片时钟,让其运行在72MHz。
这里给出适合于STM32F103RCT6的配置部分,F1系列应该都可用。
  1. void SystemClockConfig(void)+ w7 S+ C, V- T( s2 u3 d
  2. {4 l* _8 y: H$ [: u
  3.   RCC_OscInitTypeDef RCC_OscInitStruct = {0};
    + A1 G0 I* G, k8 _6 I3 T
  4.   RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
    ! q% O: \. e0 H

  5. 8 [8 A% K0 Z& ^) i
  6.   /** Initializes the RCC Oscillators according to the specified parameters8 q% I6 `/ C; _: x* J
  7.   * in the RCC_OscInitTypeDef structure., D( A4 w* _9 F, W- f
  8.   */
    - i: i: @$ X! d7 g
  9.   RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;  P5 U& `1 T8 V; n1 a
  10.   RCC_OscInitStruct.HSEState = RCC_HSE_ON;2 u2 Y) h3 E( G+ r0 ]. a
  11.   RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;' [6 K4 I: v4 b( [" A& t( ^6 r1 B
  12.   RCC_OscInitStruct.HSIState = RCC_HSI_ON;
    # u) t! \; Y1 T+ u
  13.   RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;8 H5 V1 z7 J( E, b/ I5 h
  14.   RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
    ' c  p5 M, n! e0 k& `4 r
  15.   RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;; ?1 N& j( p% k
  16.   /* 使能外部时钟 */3 ~. x, d$ I! E8 j0 K! K
  17.   if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)1 P. _( D+ W3 q; I. d
  18.   {) t- G7 a& q1 x7 i1 T8 L
  19.     while(1);
    . m. U& ^9 X! k- G' {- m
  20.   }
    # G/ s# l0 p+ K7 C
  21. 3 {' S' G! }1 Z+ y1 H
  22.   /** Initializes the CPU, AHB and APB buses clocks
    - R" I2 W8 e* U% Z! p5 \' ]
  23.   */  r4 a# \! \* g  q2 s- i% ?
  24.   RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK9 t9 ^  D, c. ~- o1 o
  25.                               |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
    : p) S: f9 y& w1 i3 v8 p* A
  26.   RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;, U& C. W) c5 z. G$ _8 V4 L
  27.   RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;# H, Q8 S; c3 E0 M8 i
  28.   RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;. u$ {/ O: N+ K, q
  29.   RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;
    2 m1 c: F3 a) W
  30.   /* 配置RCC */
    ; X+ s) s1 q5 E$ M
  31.   if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK)
    4 Q) p; n" O. L* a5 F
  32.   {
    / s# {, y( ^) ^9 z
  33.     while(1);! P7 F' P5 {/ u7 q8 Y# I+ O- Y
  34.   }
    8 e$ t8 ~) O( g- E# a" j  Z
  35. }
      j3 G/ _! O/ Y2 u; R) \, D2 K" O. J

  36. ! M6 {" n4 b0 O0 S& b% z( s6 U( U3 ~7 L
  37. /**
    0 z  O! w, j' z' d- a3 n+ G
  38.   * @brief  Initializes the Global MSP.
    ' x! V# Q) l/ H
  39.   * @retval None
    . s0 Q3 ]" K% i+ y5 D7 a3 T( J- r7 u
  40.   */3 {# ]5 U( o4 @- d' }( m* F
  41. void HAL_MspInit(void)
    / r# k/ E3 z, b0 z- c# q
  42. {
    # F, x* }9 a4 Y9 O5 f+ a
  43.   SystemClockConfig();) m- R1 p& Q0 `, a# Y# U+ d
  44. }
复制代码
2. stm32f1xx_it.c与stm32f1xx_it.h
该文件存放的是中断函数,本次我们只需要其中的滴答定时器中断函数SysTick_Handler来给HAL库提供时间基准,其他函数可以暂不添加到文件。这个文件可以从下载的库文件中找个例程的替代,例如这次使用STM32Cube_FW_F1_V1.8.0\Projects\STM32F103RB-Nucleo\Templates\Src下的stm32f1xx_it.c与STM32Cube_FW_F1_V1.8.0\Projects\STM32F103RB-Nucleo\Templates\Inc下的stm32f1xx_it.h,将两个文件拷到Template\Core和Template\Core\include下。

& \& B9 V  G" Q4 E# t8 H; i9 N# f3 |
3. stm32f1xx_hal_conf.h
该文件是HAL库的配置文件,可以实现对HAL库的裁剪。从库文件的Drivers->STM32F1xx_HAL_Driver->Inc中把stm32f1xx_hal_conf_template.h删掉后面的template后放到Template\Core\include下。这是我裁剪的部分:
  1. #define HAL_MODULE_ENABLED
    ; W+ E7 g" Z/ J9 r
  2. #define HAL_ADC_MODULE_ENABLED
    7 L0 b/ v2 [% [4 v
  3. #define HAL_CAN_MODULE_ENABLED. T4 O: c. P* E$ o1 M
  4. /* #define HAL_CAN_LEGACY_MODULE_ENABLED */" t3 p+ b! L2 I* T
  5. #define HAL_CEC_MODULE_ENABLED) |6 l* _% t; O* L
  6. #define HAL_CORTEX_MODULE_ENABLED& g5 ^  g% G6 p0 t
  7. #define HAL_CRC_MODULE_ENABLED+ h! Y' Z* V: t, D& }5 ]- _% R
  8. #define HAL_DAC_MODULE_ENABLED
    - x" @5 b8 Z  B' ^9 M. V( E
  9. #define HAL_DMA_MODULE_ENABLED* z0 Z+ X% x/ P- N
  10. //#define HAL_ETH_MODULE_ENABLED% b; D/ m+ B0 [- z  r9 T
  11. #define HAL_EXTI_MODULE_ENABLED8 C7 w+ p: x6 B
  12. #define HAL_FLASH_MODULE_ENABLED
    / i$ a+ @2 q" |" H% g9 N6 J/ U
  13. #define HAL_GPIO_MODULE_ENABLED
    $ E/ q" F6 p- d
  14. // #define HAL_HCD_MODULE_ENABLED
    ! C, Z2 P) ~7 \' W: f$ Q1 B
  15. #define HAL_I2C_MODULE_ENABLED
    % P$ |  j6 D3 t$ U* X, A4 ~" w4 S
  16. #define HAL_I2S_MODULE_ENABLED
    3 B' \2 P9 M$ D) U! m; a
  17. #define HAL_IRDA_MODULE_ENABLED9 x; h+ l0 E/ V! a
  18. #define HAL_IWDG_MODULE_ENABLED$ y& m( ~) |( e; K/ }
  19. // #define HAL_NAND_MODULE_ENABLED
    : }3 ?- f+ L& A
  20. // #define HAL_NOR_MODULE_ENABLED2 w7 k* a( I: F4 f% d! }. |
  21. // #define HAL_PCCARD_MODULE_ENABLED
    6 {; Y  B- l4 M' K
  22. // #define HAL_PCD_MODULE_ENABLED5 d8 O, P0 d3 E% Z. y
  23. #define HAL_PWR_MODULE_ENABLED* E: }% i! U8 w- ^' F
  24. #define HAL_RCC_MODULE_ENABLED
    , e; w( z- z3 w' t: |
  25. #define HAL_RTC_MODULE_ENABLED
    5 E, |; R4 e0 a
  26. // #define HAL_SD_MODULE_ENABLED
    ( S" g5 n4 p# i8 X0 Y; R0 f
  27. // #define HAL_SMARTCARD_MODULE_ENABLED
    * V- {4 W% k( R! W
  28. #define HAL_SPI_MODULE_ENABLED
    6 W& `# r5 B- _4 a' g% s& z% U! c
  29. // #define HAL_SRAM_MODULE_ENABLED
    # T3 n  u* y' {/ H1 p
  30. #define HAL_TIM_MODULE_ENABLED" n9 H0 d# U  N* L+ o/ B
  31. #define HAL_UART_MODULE_ENABLED, J- |6 R- y/ B+ T1 U/ c/ _8 X
  32. #define HAL_USART_MODULE_ENABLED* f( ]/ y. K3 c6 b4 k7 E  w: T4 P. C
  33. #define HAL_WWDG_MODULE_ENABLED
    ! J* U) `: ?- A* r
  34. // #define HAL_MMC_MODULE_ENABLED
复制代码
4. main.c与main.h
这两个文件大家肯定是很熟悉的,其中main.h不是必须的,不过我还是习惯加上了,这两个文件我们把他安排在Template\User和Template\User\include中。下面给出一个点灯的例子。
  1. // main.c. i3 c" @7 }4 G: }; I+ _" Q
  2. #include "main.h"
    4 b3 |( Z+ c8 T1 [, H5 g

  3. 1 K  B9 p+ n- F. _
  4. int main()
    & a( B( a& _; g: F  ~; C% s) |) I
  5. {4 \2 _/ A% w& L7 J* [1 [
  6.   HAL_Init();, R/ F9 p3 D( r, c6 j

  7.   j2 }$ x% T# ?
  8.   GPIO_InitTypeDef GPIO_InitStruct = {0};
    . j7 D+ @6 Z8 M; z- k3 p5 K
  9.   /* 使能PA时钟 */# D8 i; s+ L% U  w5 R$ A
  10.   __HAL_RCC_GPIOA_CLK_ENABLE();
    7 t& i/ k. q, g5 Z9 D; U( ~
  11.   /* 使能PA8 */! {4 u; T1 B/ l5 d) K! @
  12.   GPIO_InitStruct.Pin=GPIO_PIN_8;
    ; j8 m% b. _! q
  13.   GPIO_InitStruct.Mode=GPIO_MODE_OUTPUT_PP;0 [( i; V# a( |% }
  14.   GPIO_InitStruct.Pull=GPIO_PULLUP;3 P* H2 R! M3 p3 H4 X+ S- d
  15.   GPIO_InitStruct.Speed=GPIO_SPEED_FREQ_HIGH;
    % W1 M- G- E9 A7 L. B7 {
  16.   HAL_GPIO_Init(GPIOA,&GPIO_InitStruct);
      W& R" c2 c% p/ e- g2 H0 O
  17. . f9 n8 Q8 x5 k1 [: P# N) B9 C/ ?
  18.   while(1), ~  B+ B1 `, V2 e2 Q5 X
  19.   {3 r; h$ b# a1 G" u4 @( D' G$ _* [) x
  20.     HAL_Delay(500);& u: C  Z. _' p7 h0 u. C: D
  21.     HAL_GPIO_WritePin(GPIOA, GPIO_PIN_8, GPIO_PIN_RESET);' H& |, u9 \. M! j
  22.     HAL_Delay(500);
    5 X' y8 n; Z9 V. R
  23.     HAL_GPIO_WritePin(GPIOA, GPIO_PIN_8, GPIO_PIN_SET);  R) Y, p) X% ]) Q# Z5 }
  24.   }' S* a; B4 ^4 Q( ?
  25. }
复制代码
  1. // main.h
    " k# z7 ^  D  `. ]7 ]
  2. #ifndef __MAIN__H__7 \! P; h: e* G% [
  3. #define __MAIN__H__! Z* T8 p; R+ g, s1 S5 B, o  p
  4. #include "stm32f1xx_hal.h"3 C$ N0 E7 M& @7 o/ G1 i3 g
  5. ' B7 T' R; }0 k6 I. F+ d6 G
  6. #endif
复制代码

6 C2 I! I! B* p9 |/ t+ T; k
经过一顿操作后的文件结构如下图:

; D7 |& L; Y1 t6 e# c
微信图片_20230614160036.png

; Z) M3 t. Y3 Z$ y( Z. u
然后就可以打开KEIL5了,选择Project->New uVision Project在弹出的界面中找到Template\MDK-ARM文件夹,工程名为Template;然后选择在器件库里选择STM32F103RC 然后OK。
8 j+ ~" p4 ~- Q& S# K" ^; v  D
微信图片_20230614160033.png
! t% r+ f" k5 ^* G
在弹出的组件中选择CMSIS->CORE 点OK。

! @. h( _( `6 ^( x( u* v4 z
微信图片_20230614160031.png
8 \  T" N9 e( ]' f5 n: m
点击Project->Option for Target... 选项卡选择Target,编译器我们选择V6;

' q$ V0 o: c: u5 M2 ~
微信图片_20230614160027.png
' [$ ?! n0 C& }5 m/ ~
选项卡选择C/C++,添加宏USE_HAL_DRIVER,STM32F103xE;Warnings选择AC-5 like Warnings;
( h! x- K. h5 \( l0 V
微信图片_20230614160023.png

0 [9 `& W# m8 A7 [2 o5 f% ~

% d3 s9 s! s: n3 W
添加下列include path:
  • ..\Core\include
  • ..\Drivers\include
  • ..\..\lib\f1\STM32F1xx_HAL_Driver\Inc
  • ..\..\lib\f1\CMSIS\Device\ST\STM32F1xx\Include
  • ..\User\include

    $ l6 F7 P3 B) ?  Z. W' D0 y1 ]- }
- A  B0 W1 r# n( K4 \* w
点击OK退出设置,在左侧文件栏右键Manage Project Items:

0 o8 Y0 \1 G& X" n6 M/ ~2 d
微信图片_20230614160020.png
) {- p) d2 v& T% t8 ?5 f1 o# K
按如下结构安排文件:
' F0 _* z8 i: e
微信图片_20230614160017.png

+ Z/ Q* n+ k. V$ x+ _
其中CORE文件夹中除了我们之前准备好的stm32f1xx_hal_msp.c和stm32f1xx_it.c之外还需一个Cortex-M3的接口文件system_stm32f1xx.c和汇编写的启动文件startup_stm32f103xe.s,这两个文件都可用在库文件的CMSIS\Device\ST\STM32F1xx\Source\Templates和下面的arm路径找到,启动文件具体选择哪个可以参考stm32f1xx.h中的注释说明

, K5 G* g) @0 ~5 I0 H
微信图片_20230614160013.png

1 J9 V% n) m4 v
因为我们是F103RCT6所以选择startup_stm32f103xe.s选择汇编文件时需要将文件类型选为All files
% `( H' e; g" y2 A1 \" q" R
微信图片_20230614160007.png
% _: f% Z' O; [0 f$ M
HAL文件夹下我们将lib\f1\STM32F1xx_HAL_Driver\Src中带HAL但不带template的源文件全部加到工程里。USER中把我们的Template\User\main.c加进入就行。
接下来就到了激动人心的时刻了,我们点下Rebuild按键
' C% R( S( Y5 a6 I  F

4 N  h" P  c+ `2 l1 `1 E: G' y' e
微信图片_20230614160002.png

$ v  y4 X, Q% W$ H" M9 N
如果结果和下图一样,那我们的工程就算搭建完成了。
1 ]2 p& m' C- P2 o2 B( V$ f
微信图片_20230614155959.png

; c2 a# R  w+ _+ f+ v& C0 E* x
3、烧写
使用你的Jlink(或者你的仿真器)连接好你的板子,我们再次点击Option for Target...到Debug页面,选择好仿真器型号,然后点击Settings
% U5 h- o4 _" ~' E
1.png
  i+ b8 Q0 e  |+ i5 h
根据你的连接方式选择是JTAG还是SW

: P, U& D6 \1 L
微信图片_20230614155956.png
7 ^  a( V0 x/ \# `, P' a
如果你的连接正确,现在就可以在右侧看到你的设备了,这时我们再选择Flash Download选项卡,勾选上Reset and Run,这个选项可以让你每次下完程序后不用手动点一下复位。

, O* H4 \+ N9 |: P; B0 C
微信图片_20230614155953.png

0 z" K; C# f3 F0 h  b8 q5 J- c7 m$ U& C, L
然后我们一路确定,点击下载按键。

9 m& f2 f4 g  m9 }$ d
微信图片_20230614155950.png

1 V& s+ D* ]% \; Z2 B4 d; w
出现下面的提示就证明你的下载已经成功了
8 b( r7 j7 }; g1 y. p6 I* D
微信图片_20230614155943.png
6 m4 f; Q+ A+ I; r* H
不出意外,你的LED现在应该已经开始闪烁了起来,我们的任务也就大功告成了。

1 w7 i# Y5 p1 W- k4 J9 D# D2 J3 P7 E
微信图片_20230614155947.gif

, D$ O# @, k) L* d
4、总结
我们刚刚用一大堆的文字代码图片终于把最简单的搭建工程给做完了,在讲述基本的使用方法的同时还顺便点了个灯,希望大家能够从中有所收获。使用过的工程文件可以在下面链接中获取,我们下期讲讲如何让只会亮灭的灯变成更人性化的呼吸灯,扫一扫下方二维码关注我,我们下期再见。
' g9 G( z8 j( n+ {0 e
转载自: 嵌入式技术栈
4 O$ P$ N: [/ r8 O* y) c. _如有侵权请联系删除
! c, _& m& W4 s5 f% w2 z
0 q' w# f9 m/ I- f5 \
& \. t) ]4 ?+ H$ z1 w
收藏 评论0 发布时间:2023-6-14 16:00

举报

0个回答

所属标签

相似技术帖

官网相关资源

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
STM32N6 AI生态系统
STM32MCU,MPU高性能GUI
ST ACEPACK电源模块
意法半导体生物传感器
STM32Cube扩展软件包
关注我们
st-img 微信公众号
st-img 手机版