1.前言
6 u. g3 |( s: }! V一直没有正经从完全无知开始去接触了解一款新的stm型号芯片。趁着这次11月份的新项目的开端需要用到stm32L0系列的单片机,搭载lora模块进行项目开发。这里开个系列博客记录下学习过程和调试过程。
* k/ y4 G, \+ {
8 K Y+ ], f! p" q8 |! `2.开发工具
- j) o. a! x1 I以前做stm32的开发都是基本用的stm32F系列,代码结构也是套用的公司以前的模板。
$ g0 P" _. r1 n% k本次L0系列采用了st公司提供的一个新的(对笔者来说是新的,之前没用过,其实以前出来比较久了)开发代码生成工具-STMCubeMx。
+ P' f# G9 [1 `: y
6 o) E: b/ P$ F8 n9 y l0 ^5 K& Y$ a8 [% l
1 ^- M, T" l; ]3 f# n$ h
这个就是安装完后的工具图标。具体安装下载过程这里不做赘述,不了解的朋友可自行百度。" m y1 P: n" w% X6 _! T
3 p2 j9 H& R9 W( z3 y' C* _3.简述开发工具生成的代码结构' r0 F. L8 u; x6 g3 H
Stm32CubeMx自动用户所选的IC型号以及需要用到的mcu资源,外设等自动生成相应的代码,生成的代码使用HAL库。其代码结构基本不需要进行什么修改(用户所选所设置皆正确的情况下),仅仅需要对一些HAL中的回调进行重写(如果你需要)。
+ D7 Z# B C& |6 X/ ?) [. D1 n
9 l K6 v# ]1 ?
3 ?& m: x! G8 C" Y$ @1 V a2 }如图,代码编译工具还是使用keil软件,根据图中代码结构可以很清晰的看到整个代码分为
* Y5 ?/ a2 r: WApplication和Drivers(附加CMSIS)
% p0 t* E% N+ y. }: TApplication里分为MDK-ARM和User。
$ R9 s. j) m9 k& J/ oMDK-ARM是代码工程的一个目录(基于编译,比如编译生成文件,中间文件.o之类的): A; d$ n5 T3 F; l- {
User是用户程序的主入口,如main.c等。& s, _: Q; }: Z3 C; |
需要注意的是User中还包含除main.c之外的两个文件,其中一个msp文件是工具自动生成的,后面分析。ic文件则是和中断回调相关的,这个相比都比较清楚。1 A5 ?- z. n$ ]2 N5 l
/ L3 D4 u3 V! `7 b/ P% Y. U
C, T4 o& A0 U% U
0 R/ ] }" O0 c& m7 B. }在Drivers中包含HAL_Driver和CMSIS.
6 W; o {4 N* A5 i+ h3 z1 q8 ?CMSIS则是和内核相关的,如M0,M3等之类的内核。6 x8 ? m$ [" P
HAL_Driver则是st给用户提供一些接口,如flash,rtc等的操作接口。
' G1 T/ X6 X8 F5 v: ^) ?) [) r1 d& d% Y7 r" i/ J9 T
3.1 main.c简析
4 \/ ~4 f; n+ M6 n& Z8 \2 ^ ~最简单main.c里面的代码至少包括三部分:HAL_Init,SystemClock_Config,while(1);
0 {7 Z) Q' U* r. ?" p
# }* k# s" h+ }/ P! h: i" ~, e- int main(void)
( o1 `6 Z5 L/ f$ w0 x - {
l- v( N$ _9 x6 H8 Q - HAL_Init(); //HAL库的初始化" ^% @+ |9 ^- U' X
- SystemClock_Config();//系统时钟配置初始化3 x8 m2 D. y7 B* J, ?( e: e# a$ \
- while(1)//主程序的运行
6 \7 `3 x8 K' k- U' B8 |% I4 w - {6 F3 C9 d& o) Q i4 [- } U8 }/ O
- }8 P/ s. l5 W" [/ R' E$ W
- }
复制代码 " v' j$ D6 q' J/ D6 F, A! R
3.2 代码运行流程以及HAL库的调用结构
/ Z6 |- z) t" D6 O7 f3.2.1 HAL_Init()6 m+ E# u3 K2 W$ Z+ j* t
- /**
& x! J: M. g& q2 p7 y0 Y( H - * @brief This function configures the Flash prefetch, Flash preread and Buffer cache,
" ~8 f! V1 Q0 L+ f( S2 ? - * Configures time base source, NVIC and Low level hardware
3 b8 S5 p! Z6 N; m0 t6 _# s - * @note This function is called at the beginning of program after reset and before
) e7 l! w$ B+ k6 M - * the clock configuration( P) j+ M# E6 g K
- * @note The time base configuration is based on MSI clock when exiting from Reset.2 w7 `4 p |" l' L% |* y
- * Once done, time base tick start incrementing.
9 P9 `$ q1 @9 J - * In the default implementation,Systick is used as source of time base.+ Y+ _- j( m1 p: o4 r% q6 i
- * the tick variable is incremented each 1ms in its ISR.
x' ~! m- L: N+ `% i - * @retval HAL status1 p1 o9 \4 G6 |$ F x
- */5 o; z( M# V: t" u
- HAL_StatusTypeDef HAL_Init(void)& h: {$ W% I+ Q4 G2 h! p0 k
- {+ w5 V* N: D4 r
- HAL_StatusTypeDef status = HAL_OK;) h' ^% L. E ?/ W! Q* a. J6 m
. j; z; n: W6 F, ]6 h- /* Configure Buffer cache, Flash prefetch, Flash preread */4 x R: P8 s; [! o" W3 _+ C
- #if (BUFFER_CACHE_DISABLE != 0)5 o4 i' f* v2 C9 s6 ?7 ]: R) ^
- __HAL_FLASH_BUFFER_CACHE_DISABLE();( S/ w/ ]$ i8 p# ?0 a$ t
- #endif /* BUFFER_CACHE_DISABLE */# W% B8 G' J& s; z4 J. {
$ O. n. ~# U' {- O' H P7 B, [- #if (PREREAD_ENABLE != 0)
& S6 e- J5 a5 g! @$ b1 }1 g - __HAL_FLASH_PREREAD_BUFFER_ENABLE();. K8 D& N! w6 m7 U* E
- #endif /* PREREAD_ENABLE */
4 Z/ W: T" F1 _* S4 u. @2 _" @ - : a O$ ^. G: u1 A3 o6 M
- #if (PREFETCH_ENABLE != 0)/ ^* X2 y1 f4 J; i1 O
- __HAL_FLASH_PREFETCH_BUFFER_ENABLE();
- {3 @ Z, W6 J9 u2 J - #endif /* PREFETCH_ENABLE */, _+ S( V" Y) m
- * |4 Z: [4 f( o% P+ |9 |
- /* Use SysTick as time base source and configure 1ms tick (default clock after Reset is MSI) */
* ?8 I1 u( Y( T1 L9 w - if (HAL_InitTick(TICK_INT_PRIORITY) != HAL_OK)1 g# z( `/ R6 c* k) j
- {
) M; C6 c# W; }( p3 o - status = HAL_ERROR;
' e5 x; F- b) c7 e8 c - }5 U/ |! P) u0 l8 W$ }5 m
- else" q% i3 E. |+ U% {7 t- r1 @
- {( C5 ^! G, x/ a7 {: p
- /* Init the low level hardware */2 ^6 I2 g. S/ o6 V6 e
- HAL_MspInit();
- t _! X0 Z8 h8 \6 R - }* q% `+ X) d7 c. K2 o/ O+ O; G
- , h) Q9 {# E. H6 K w% {
- /* Return function status */2 ?; V. N) t5 i# n
- return status;" O. v5 q l0 M7 k2 Z8 g$ _
- }
复制代码 $ x H; k% N3 `
这里抽出2个关键函数:
, w" G9 z' C. n/ [; SHAL_InitTick,HAL_MspInit! ?) F! b7 s/ V* s
可以看到mcu一启动则调用HAL_InitTick,它的功能是使用SysTick作为时基源并配置1ms刻度(复位后的默认时钟为MSI)
$ W7 O8 R9 v# @9 I- v如果该函数出错,则调用HAL_MspInit。6 G- J9 y( I' ^6 `4 q
这里提下该函数HAL_MspInit是被__weak修饰,叫做弱函数。被这种修饰的函数,通常需要用户自己去实现。实现的位置在哪里?还记得前面提到msp文件吗,就在那里面,当然你也可以写到你想写的地方,msp这个文件只是为了方面管理整个代码工程中的需要重写的函数。4 d# @5 v& R# A- L2 G8 v5 w
( C/ O$ u- B: I, U- @
3.2.2 SystemClock_Config()9 E+ T! I$ y; l4 T
- /**
9 H3 z: b M4 D7 E& ~. K - * @brief System Clock Configuration2 |5 i. y% X% R5 K3 R2 l
- * @retval None7 M# E# @8 y# z. F4 z* h
- */
1 p- K4 ]/ z5 g8 v# a - void SystemClock_Config(void)
+ e$ J* c. v' a - {
- P2 \) G: b6 N, f' R - RCC_OscInitTypeDef RCC_OscInitStruct = {0};/ J" A3 J( |* R
- RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};4 a0 X; r. E+ s
+ \6 H# b. ]: d9 M- /** Configure the main internal regulator output voltage
7 k/ r, d2 I) g - */* m9 V5 d8 O( `- d. W
- __HAL_PWR_VOLTAGESCALING_CONFIG(PWR_REGULATOR_VOLTAGE_SCALE1);# R8 |1 B/ G* x
- /** Initializes the CPU, AHB and APB busses clocks
2 s8 @" x# P% O9 c0 @0 y - */, ?4 ^( J, m' w$ [6 C8 A* f
- RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_MSI;
2 ^$ s0 \& `- t+ Z3 p - RCC_OscInitStruct.MSIState = RCC_MSI_ON;
& `3 g$ O- p% c# P - RCC_OscInitStruct.MSICalibrationValue = 0;7 {9 f/ i3 ^& h( ~
- RCC_OscInitStruct.MSIClockRange = RCC_MSIRANGE_6; ?3 N/ D2 O7 S3 u3 Q* t
- RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE;
" b" o9 n: T- ]2 A/ P) [ - if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK): ^' p9 x5 I5 t h4 B$ ?
- {# d4 D. {. D* i3 U
- Error_Handler();6 p, l* K2 x# V0 e/ z, q9 U
- }
7 j3 P# ]* g* _4 h' R9 `, l - /** Initializes the CPU, AHB and APB busses clocks 2 j* c3 s3 g8 J+ c3 b- F
- */- @3 o' W1 C0 ~
- RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK) v; ^7 I9 g3 N" {$ U. U0 U
- |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
) V6 T' x" b9 O - RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_MSI;
" e" ~& ]3 J% w5 q' M. q- O6 U) w - RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;3 j ?$ {" G; M5 r8 J6 K$ M7 c
- RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV1;9 A0 s$ y9 e L+ R% h) c5 V
- RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; ]) [ W9 L# a0 y& f0 S
- 1 a) \( Y0 H7 B
- if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_0) != HAL_OK)% x( _0 z2 R5 c5 Z' D7 \) x/ K+ G" D
- {7 n9 A% O! K' Y5 Z
- Error_Handler();
2 u1 a. y( [) K' m* S2 [ - }
; z" v- H9 s2 y; A% K) g- s - }
复制代码 . i p8 z* X+ R
这里可以看到对于mcu的时钟选择配置,完全对上刚开始创建工程时的选择。先简单将这个函数分隔下:
8 U8 F( }, w! r/ H( P' o7 ^第一步:配置内部主稳压器的输出电压
7 A1 x& H5 |& t. c第二步:初始化RCC振荡器。HAL_RCC_OscConfig,这里选择了MSI时钟,频率是4.194Mhz/ ?3 i# G7 U. C+ a6 t* y& [
第三步:初始化CPU,AHB和APB总线时钟,HAL_RCC_ClockConfig, H" C5 \3 @% g. E0 c5 ^
如图;% Z- _; l4 c+ u' I& B' P
2 F2 A+ j" ^8 V% l' e" M' P4 s# F* P% o5 a" }$ m$ b! g
+ e0 a) W5 E( i$ _( ]
ps:关于STM32l0的时钟相关,可以参考datasheet。也可以往官网下载(英文版)
+ w" y2 u4 y/ l& K- W: h9 E1 n% m2 T. G( o' u0 d
4. 话说在前面系列" M9 l C: M" I6 ^, m+ `: P
在使用St’m32CubeMx生成代码的时候,后期单独修改代码的时候,需要注意:
+ k' O9 D& r# S, N- q1.stm32l0xx_hal_conf.h 头文件指定了哪些文件是否参与编译,文件内是按模块声明的。
0 F/ L9 {* q( \$ T% ~/ a) N2.第一次调试测试单独功能的时候,可以使用工具生成单独模块的代码进行单独测试。1 ?* M: T4 f4 u% |; h) _( b
2 `% j5 ~8 d& v& R% G6 m
0 K4 @# q( J, v- u9 u
* J+ r; T( k1 U' H" B: G |