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

STM32外设驱动库如何实现

[复制链接]
STMCU小助手 发布时间:2023-3-4 19:00
一、如何控制单片机?单片机的内存映射图解析
这里以STM32F429芯片为例,讲解下单片机芯片内存映射图。从此图中可以看到芯片的外设被分配了512M的空间,然而真正的外设其实没有使用到512M的内存空间。
然后我们操作外设时,只需要操作它对应的内存地址即可。更加详细的外设内存地址,可以参考芯片的用户手册(不是数据手册)的Memory map章节。
# I4 y6 _$ z7 `; _
微信图片_20230302200036.png
; V! |6 e# ^/ G1 X6 Y+ F) q/ d. v8 P

2 \$ R: [% l  w( a$ j! [& B
3 V' |, g$ Y( F& D, I% d
因为单片机是将外设映射到内存地址上,所以我们可以像操作内存一样来操作外设(写/读)。
我们在操作内存时是通过地址来进行操作的,由于单片机已经将外设与内存进行了映射,所以我们在操作单片机外设时只需要操作外设映射的内存地址就行。
5 q5 B- J  G. ]3 R
内存如何操作?
在C语言中操作内存,我们可以用指针来进行操作。在汇编语言中由于没有指针这个概念,所以我们在操作地址时只能用一些内存读写指令来完成。比如:LDR,STR
. D. w, r7 ?5 M2 u0 w. @
结构体操作与宏定义操作的对比9 N4 ]5 u* j! ^' i2 P" ~
C语言——宏定义形式
+ j# x# x7 L3 H, h1 q
  1. #define GPIOA (*(volatile uint32_t *)(0x000800E0))
    ( T2 w/ f5 Q: B/ n* c
  2. #define GPIOA_DR (*(volatile uint32_t *)(0x000800E4))! Y: j, o( k  d% {# `% @. N
  3. #define GPIOA_MR (*(volatile uint32_t *)(0x00080108))
    - _' n; _0 T; j, o8 x; |9 ~
  4. #define GPIOA_TR (*(volatile uint32_t *)(0x00080108))
复制代码
; ?7 B9 _0 _5 d4 M' m- `8 B3 T

8 c8 F, s6 C* r9 @# y4 ~
9 `& K3 t, Y/ u! l( W
C语言——结构体操作
. d4 |2 R3 R& E  b: R* @
  1. struct GPIOA_Reg{
    + y. }; j, z9 ^  a; y  E
  2.     volatile uint32_t dr;) V0 W: @! M( U0 }$ q
  3.     volatile uint32_t mr;# N: d( Y' K2 O* c3 K& T
  4.     volatile uint32_t tr;
    6 r3 n: `' w* D5 A
  5. }GPIOA_REG
复制代码

% S9 Q1 }* b6 q! P$ @$ y; Z( c- O+ N0 _, r- I* Q5 L
: \+ P& R, P0 H, f3 R
汇编语言操作内存
4 I6 X; m/ c) q/ {! s7 t3 ]6 @1 Q
  1. LDR r0, =0x00800010
    ) o4 j6 G/ X; U6 Y: C- }5 ^
  2. MOV r1, #2
    4 A7 p" f% c' b/ U2 \2 i5 q
  3. STR r1, [r0]
复制代码

- T. T5 r1 I0 Z' E  Z1 |4 F3 _5 X* R) Y" @
二、寄存器方式操作单片机
- i# Y$ p# H. E0 a$ ~, T代码结构框架:) G4 {7 ]$ Y" e0 }% u( s

, g) l6 C6 @% c  M8 s

( R1 e0 a/ I; e8 n0 y) M! r 微信图片_20230302200033.png
2 s/ e, |" o, e* I+ H- \- }0 F" i2 N4 |/ P' d) g
6 S% C. }) a  J. q
文件结构
一个芯片头文件:外设的地址宏定义以及外设相关的结构体定义
查看芯片的用户手册(注意:不是数据手册)中寄存器对应的相应地址。然后使用宏定义来将它们定义好,同时定义好结构体来更加方便的管理外设寄存器组。这里以STM32F1系列为例
  • • 一个启动文件:汇编编写的、中断向量表等
  • • 用户代码文件:剩余就是用户代码文件了
  • • 各个芯片的外设驱动函数编写(读/写、控制)、以及用户逻辑部分代码。

    3 Q/ t& W2 i/ ^. }
三、使用HAL库方式操作单片机
' z+ C0 o, [) k) d" {HAL库与固件库的区别
HAL全称Hardware abstract layer(硬件抽象层),这是一个大家公认并且遵守的一种函数名称命名、资源定义。因为是统一的命名规范,所以当用户更换芯片平台后由于函数命名与所使用的资源都与具体硬件没有关系,这样就不需要修改用户层代码了。
而所谓的标准库其实就是芯片厂商公司内部自己命名与实现的库并且各个厂商的命名规则不一样,这样就会导致可移植性变差。当用户更换了芯片平台后由于它们各自的API函数不一样就会导致用户需要修改应用层代码。

, p/ J1 c& e1 Y% I
HAL库设计) Y) _6 a  r) W' E
1. HAL框架设计: r; v: `- g' |; S4 s* y" i
9 q7 Y; s7 i2 `0 |( p

6 y6 y3 F* E" v" a; K0 P0 s  C 微信图片_20230302200029.png
2 y. b' v7 H0 q# O$ R
: ^, ]7 R( O8 W+ W( D2 ^" ~

1 {* G5 d0 L) ^2. HAL资源命名规则
HAL函数命名规则:
5 T1 a! A5 h8 c9 M  ~' M' v
微信图片_20230302200026.png 3 L# h& j) X9 b3 Y$ I
# t7 @- H4 U2 ]6 K" i5 Q
中断与时钟设置宏:

4 n' H3 T5 f0 I  S3 L2 L* V 微信图片_20230302200023.png
* m5 D( u* s; A4 X8 H
4 J- Y7 v5 D8 \4 l( a3 e
回调函数命名规则:

; ]6 r' i4 ~7 }  j7 k

* I" k) \/ Y7 |. b4 A3 X& T5 a1 H9 t3 o
. I- z- f  B1 n& K2 |: Z

$ h9 P) ^- h" t8 B3 l/ |' P, W3. 文件结构:
一个芯片头文件:外设的地址宏定义以及外设相关的结构体定义
查看芯片的用户手册(注意:不是数据手册)中寄存器对应的相应地址。然后使用宏定义来将它们定义好,同时定义好结构体来更加方便的管理外设寄存器组。这里以STM32F1系列为例
一个启动文件:汇编编写的、中断向量表等。
一个HAL库全局头文件:一些全局的宏定义以及包含其他外设头文件
HAL库文件:芯片外设的驱动函数
四、HAL库组成说明5 g. Q3 T3 Q: d% A& `9 Y/ P! S2 q* j
8 Q4 V! U) g3 g0 N
8 }7 k# @' a) S
微信图片_20230302200017.png 2 w7 K  j; x5 x8 w# Y

1 ]% z" }% r4 c2 S( q! I, ^$ A
+ |) v3 `0 T/ b  Q: ~. \
1. HAL库的数据结构体
  • • 外设句柄结构体
  • • 初始化和配置结构体
  • • 特定的处理结构体(读写/控制)
    7 b6 n# l& \" ]( ?/ |
** 外设句柄结构体(跟硬件不相关):**
比如:下面这个串口结构体
  1. typedef struct8 e# j* |' {* o- M2 n: `* V
  2. {
    ; L% F7 w# }$ L% o% r6 W
  3.     USART_TypeDef *Instance; /* USART registers base address */
    # G& X1 V7 `+ N: Z# u8 n
  4.     USART_InitTypeDef Init; /* Usart communication parameters */
    # G# f9 H' f% C& T' ]1 V
  5.     uint8_t *pTxBuffPtr;/* Pointer to Usart Tx transfer Buffer */
    8 Q% b, a$ x  }( }3 m& j
  6.     uint16_t TxXferSize; /* Usart Tx Transfer size */& I# n$ P0 @  g( L
  7.     __IO uint16_t TxXferCount;/* Usart Tx Transfer Counter */
    4 m/ p& Q' g, X; ?% z
  8.     uint8_t *pRxBuffPtr;/* Pointer to Usart Rx transfer Buffer */
    1 e) ^9 G" M! w% E8 P! S
  9.     uint16_t RxXferSize; /* Usart Rx Transfer size */
    2 W1 T" w/ I3 {
  10.     __IO uint16_t RxXferCount; /* Usart Rx Transfer Counter */
    - {- o3 b* |; t7 i  T' U
  11.     DMA_HandleTypeDef *hdmatx; /* Usart Tx DMA Handle parameters *// B# N5 f, W2 B! U; x6 r
  12.     DMA_HandleTypeDef *hdmarx; /* Usart Rx DMA Handle parameters */4 r  o; H7 a; X( f7 F
  13.     HAL_LockTypeDef Lock; /* Locking object */
    8 |3 J, l/ }4 [) v, @* x
  14.     __IO HAL_USART_StateTypeDef State; /* Usart communication state */2 [3 S/ \* U, e+ g/ j9 o+ P# K
  15.     __IO HAL_USART_ErrorTypeDef ErrorCode;/* USART Error code */! C9 X, I- {6 X7 D7 F* t
  16. }USART_HandleTypeDef;
复制代码

5 A( J9 p- v% T: ]" r
初始化结构体(跟硬件相关):
比如:下面这个串口硬件相关的结构体
  1. typedef struct
    8 c! N+ Q( E4 l
  2. {
    9 ^7 W# e; C1 [. n
  3.     uint32_t BaudRate; /*!< This member configures the UART communication baudrate.*/1 j2 G$ L! K/ X' [, f
  4.     uint32_t WordLength; /*!< Specifies the number of data bits transmitted or received
    - m6 M) }# p  }1 C
  5.     in a frame.*/1 N/ C' X' f6 `, R5 F* E4 r) r
  6.     uint32_t StopBits; /*!< Specifies the number of stop bits transmitted.*/- H( n9 N: H0 k" V
  7.     uint32_t Parity; /*!< Specifies the parity mode. */
    * T$ P) Q1 H( T
  8.     uint32_t Mode; /*!< Specifies wether the Receive or Transmit mode is enabled or$ B, u4 S. X2 o& h# x3 O- u# w7 F
  9.     disabled.*/
    2 z: `# a( ?% {! n6 B; f: o, t
  10.     uint32_t HwFlowCtl; /*!< Specifies wether the hardware flow control mode is enabled
    2 ~( f8 N: j8 V8 F7 A; `; W
  11.     or disabled.*/
    2 j! A1 S$ f. a4 g8 d3 ~
  12.     uint32_t OverSampling; /*!< Specifies wether the Over sampling 8 is enabled or
    3 j) |# Q$ n+ B: [$ F
  13.     disabled,0 X7 w3 h) {- p  E( S
  14.     to achieve higher speed (up to fPCLK/8).*/
    ) P' ^, j. s+ q3 i8 N; z
  15. }UART_InitTypeDef;
复制代码

, K4 _& _2 C; M, \" M8 A( J
! L5 c0 ]1 K* Y, K4 f8 J# v
特定的处理结构体(跟硬件有关):
比如:下面这个ADC处理处理结构体
  1. typedef struct
    ; r" ?) y! _$ j
  2. {
    4 f+ o2 Q0 _5 ?3 U! Z9 s
  3.   uint32_t Channel;                /*!< Specifies the channel to configure into ADC regular group.6 I* S0 ^7 v% H! n
  4.                                         This parameter can be a value of @ref ADC_channels */
    / o% m% K+ I3 I8 l) }& m8 Q, L; l
  5.   uint32_t Rank;                   /*!< Specifies the rank in the regular group sequencer.  z) l: n. c9 C4 o! z. N" ~2 h
  6.                                         This parameter must be a number between Min_Data = 1 and Max_Data = 16 */5 x, g' b$ \: _% A( z6 K/ A+ e
  7.   uint32_t SamplingTime;           /*!< Sampling time value to be set for the selected channel.
      \  E$ Z! l. f* n8 M
  8.                                         Unit: ADC clock cycles
    ' s+ i; @2 C, t5 O/ E
  9.                                         Conversion time is the addition of sampling time and processing time (12 ADC clock cycles at ADC resolution 12 bits, 11 cycles at 10 bits, 9 cycles at 8 bits, 7 cycles at 6 bits).9 }  L. w" }) p% z- p4 T8 Z
  10.                                         This parameter can be a value of @ref ADC_sampling_times% M4 f) _% U1 h9 _8 F
  11.                                         Caution: This parameter updates the parameter property of the channel, that can be used into regular and/or injected groups.+ R- d% {3 b, B2 D/ T6 X8 L
  12.                                                  If this same channel has been previously configured in the other group (regular/injected), it will be updated to last setting.* J7 J& b8 O% [' P' L- n  ?2 P
  13.                                         Note: In case of usage of internal measurement channels (VrefInt/Vbat/TempSensor),
    . b$ P( N5 F3 }, I  V6 N
  14.                                               sampling time constraints must be respected (sampling time can be adjusted in function of ADC clock frequency and sampling time setting)
    " C6 U, a$ Y* Y: {8 {9 [
  15.                                               Refer to device datasheet for timings values, parameters TS_vrefint, TS_temp (values rough order: 4us min). *// ]. g" j2 Y: C1 d& u7 f  Z: _+ L
  16.   uint32_t Offset;                 /*!< Reserved for future use, can be set to 0 */4 B7 b3 h5 t8 }. Z! `
  17. }ADC_ChannelConfTypeDef;
复制代码

1 z$ A# H9 X" K! l5 D
- b+ @8 {2 G9 ^6 I" o8 ]
2. HAL库公共资源
HAL Status:状态枚举
  1. Typedef enum9 [4 w4 a/ h( Y+ e: l& z" |
  2. {2 [4 f. h! ^+ s2 }; `2 r* _1 o
  3. HAL_OK = 0x00,; ^9 g8 V% l8 u) l/ t! {/ c
  4. HAL_ERROR = 0x01,# }, h; U/ q$ I
  5. HAL_BUSY = 0x02,3 y9 ]: R4 B1 \  l
  6. HAL_TIMEOUT = 0x037 g+ Q% l- \6 o* D
  7. } HAL_StatusTypeDef;
复制代码
% F8 i9 k7 y$ [5 K% H, h3 a( Y
HAL Locked:用于防止共享资源被意外访问
  1. typedef enum1 {5 u  `" F5 M% E$ ~2 p
  2. {
    ) \" _0 [. V6 }) G
  3. HAL_UNLOCKED = 0x00, /*!<Resources unlocked */+ R, x' v& D7 E6 i9 C
  4. HAL_LOCKED = 0x01 /*!< Resources locked */: d2 j6 x- `) A' n. M% S
  5. } HAL_LockTypeDef;
复制代码
- S( f- W) y/ V6 [9 o( V0 P! Y
公共的宏定义:NULL 和 HAL_MAX_DELAY
  1. #ifndef NULL/ Y/ J2 W- P, a+ a& T9 g5 ^
  2. #define NULL (void *) 0
    ) A) V6 k1 D, @  B. S& j5 X
  3. #endif
    : C! D- j1 D: s$ j; T$ t
  4. #define HAL_MAX_DELAY 0xFFFFFFFF
复制代码

! W; ~: Y! ^' ]
3. HAL库中断回调函数实现说明
(1)使用 __ weak 定义好回调函数。如果用户自己重写了回调函数,那么编译器就会使用用户重写的这个回调函数。其中__ weak这个关键字是编译器定义的。
(2)使用函数指针。定义一个全局的函数指针变量,在初始化函数时将我们自定义的回调函数赋值给这个全局的函数指针变量(这一步也叫做:注册)。然后再中断函数中通过这个全局的函数指针变量来调用我们自定义的回调函数。
% o! @# h) P" g& O
转载自:嵌入式大杂烩
  o( }+ M+ c8 U/ v) _( i) S) B' y

7 s1 B( B' ?; a( D
微信图片_20230302200021.png
收藏 评论0 发布时间:2023-3-4 19:00

举报

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