一、RCC 实验 实验目的:掌握和熟悉时钟系统的配置,了解时钟树,时钟源,以及时钟输出。* V& ]$ p8 F) U# l2 x; k * S, Q4 p/ p9 f1 i% q3 R; ` 1、LSCO(使用 LSE)低频时钟输出实验 CubeMX 配置如下,保存后生成对应的配置代码:1 o' b- |2 ^) P! t2 r* w ▲ CubeMX 配置时钟输入 ▲ CubeMX 配置 LSCO 的时钟源 通过配置时钟树,使用外部低速时钟作为时钟输入,并且在引脚上输出时钟信号。本实验主要展示外部低频时钟的使用。9 f) J; |3 D+ t) D: P" N* o+ Y1 K0 [- ^% j1 l$ c( T- z% l1 y LSCO 的输出主要函数说明: void HAL_RCCEx_EnableLSCO(uint32_t LSCOSource) % J% _/ t# b+ d5 U0 y; ? 功能:开启 LSCO 时钟输出;" H# j& p" D+ { 参数 1:LSCO 时钟源,可选 RCC_LSCOSOURCE_LSI 和 RCC_LSCOSOURCE_LSE;4 n9 u, g( V# D, u5 ` 返回:无;使用举例:HAL_RCCEx_EnableLSCO ( RCC_LSCOSOURCE_LSE);//开启 LSCO 输出,时钟源为外部低速时钟 LSE;" A3 p6 v* y/ i9 P+ u 注 意 :此 函 数 在 CubeMX 配 置 时 钟 输 出 之 后 自 动 生 成 并 被 调 用 , 调 用 位 置 为SystemClock_Config 函数的最后。7 }$ _+ X4 K$ Z2 n* H( R) H 实验现象:! X0 [, D; V6 P% k ^1 |" ? 通过 CubeMX 配置之后,将代码直接编译烧录即可在 PA2 上观察到一个频率大约为32.768kHz 的时钟信号。9 j0 d- Y# Z. J! { : B+ N1 j6 W. n& I 6 o" l* A; a) X e- ~1 e 2、MCO(使用 HSE)系统时钟输出实验0 T3 p6 K% I4 t9 k" x' i7 E1 C" S* _1 l. l CubeMX 配置如下,保存后生成对应的配置代码: ▲ CubeMX 配置 HSE 输入以及 MCO 输出使能 ▲ CubeMX 配置 MCO 输出速度 ▲ CubeMX 配置锁相环与 MCO 源 通过配置时钟树,锁相环,实现倍频系统时钟,并通过 MCO 进行时钟信号输出。本实验主要展示外部时钟输入 HSE 的使用以及通过锁相环配置系统时钟。 MCO 的输出主要函数说明: void HAL_RCC_MCOConfig ( uint32_t RCC_MCOx, uint32_t RCC_MCOSource, uint32_tRCC_MCODiv ) 功能:开启 MCO 时钟输出; 参数 1:MCO 时钟源输出引脚,可选内容为:RCC_MCO_PA8、RCC_MCO_PG10;需要注意的是,对于 G4 系列该参数只能为 RCC_MCO_PA8; 参数 2:MCO 时钟源,可选内容为:RCC_MCO1SOURCE_NOCLOCK、RCC_MCO1SOURCE_SYSCLK、 RCC_MCO1SOURCE_HSI、RCC_MCO1SOURCE_HSE、RCC_MCO1SOURCE_PLLCLK、RCC_MCO1SOURCE_LSI、RCC_MCO1SOURCE_LSE、RCC_MCO1SOURCE_HSI48; 参数 3:MCO 时钟输出分频,可选内容为:RCC_MCODIV_1、RCC_MCODIV_2、RCC_MCODIV_4、RCC_MCODIV_8、RCC_MCODIV_16; 返回:无; 使用举例:HAL_RCC_MCOConfig ( RCC_MCO1, RCC_MCO1SOURCE_SYSCLK,RCC_MCODIV_1 ) ;//开启 MCO 输出,时钟源为外部低速时钟 SYSCLK,时钟分频为 1 分频(不分频); 注 意 :此 函 数 在 CubeMX 配 置 时 钟 输 出 之 后 自 动 生 成 并 被 调 用 , 调 用 位 置 为SystemClock_Config 函数的最后。 5 N3 L9 \: y2 b2 EJ, k( P- t, x& G- E 实验现象:/ D# H; A0 k+ ^, Q) ^. J. _& p 通过 CubeMX 配置之后,将代码直接编译烧录即可在 PA8 上观察到一个频率大约为 40MHz的时钟信号。 * V% J" [, i+ i, A. }% ~2 } 二、GPIO 实验- }& z' x4 }9 X, ]* } 实验目的:掌握和熟悉 GPIO 的基本输入与输出功能。% N; x1 P: ~6 T2 K, i! Z2 N & ^- X7 B0 o2 Y. s: j 1、GPIO 输出实验 CubeMX 配置如下,保存后生成对应的配置代码:0 q5 C, Y7 n( z$ c* N/ c ▲ 图 3.2.1 基本系统配置 ▲ 图 3.2.2 时钟树配置 ▲ 3.2.3 IO 配置 配置完成后,可以使用系统延时函数延时控制 LED 闪烁,来验证功能。注意上述系统时钟配置仅在此进行一次展示,下文中如果使用 170MHz 主频则不再进行时钟配置展示。1 P L7 ]5 o7 X4 ?& Q5 }0 e 系统延时函数说明:
功能:进行阻塞式系统延时;7 L H G. e8 K9 `& c, U 参数 1:延时时间,默认单位 ms,该阻塞时间是基于 HAL 时基产生的,默认情况下为滴答定时器,频率为 1kHz,如果该频率改变,那么延时时间单位也会随之改变;9 a7 ` v3 I4 a1 [/ C- v 返回:无;3 y4 n3 }" j) |. U 使用举例:HAL_Delay(500);//延时 500ms 注意:此函数使用滴答定时器中断来获得时基,从而使用 while 占用 cpu 进行延迟,在该main 中使用该函数进行延时能够被中断所打断。此函数一般不在中断中使用,如果在中断优先级高于滴答定时器的中断中使用会导致滴答定时器中断无法正常运行,从而使该函数彻底卡住无法退出。 GPIO 输出操作函数说明: void HAL_GPIO_WritePin ( GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState ) 0 V% v c8 v8 I7 B 功能:写入 GPIO 输出电平; 参数 1:GPIO 分组,可选 GPIOA,GPIOB,GPIOC 等,根据使用芯片类型进行选择; 参数 2:GPIO 引脚号,一般定义为 GPIO_PIN_x,其中 x 可选 0-15,根据使用芯片类型进行选择; 参数 3:输出电平,可选 GPIO_PIN_SET(输出高电平)和 GPIO_PIN_RESET(输出低电平); 返回:无;! F* ~: t3 g+ W* s 注意:CubeMX 支持自定义引脚标签,对标签进行过自定义之后会在 main.h 文件中生成响应的宏定义。比如上述例子中,定义 PD10 为 LED1,那么在 main.h 中则生成了#define LED1_Pin GPIO_PIN_10 和#define LED1_GPIO_Port GPIOD 两个宏定义,此时可以使用LED1_GPIO_Port 和 LED1_PIN 来代替函数中的参数 1 和参数 2.0 i4 l8 y% U% L 使用举例:HAL_GPIO_WritePin ( LED1_GPIO_Port,LED1_Pin,GPIO_PIN_RESET );//输出低电平,点亮 LED5 j6 w0 Z$ s4 A8 o0 U% z& Q3 m; b
功能:翻转 GPIO 输出电平;: a! {4 q5 [) k. ]8 _& W 参数 1:GPIO 分组,可选 GPIOA,GPIOB,GPIOC 等,根据使用芯片类型进行选择;0 a# c, f. |/ E- ?, R& y* ^0 | 参数 2:GPIO 引脚号,一般定义为 GPIO_PIN_x,其中 x 可选 0-15,根据使用芯片类型进行选择; 返回:无;# z+ B( ~ F3 {8 m 使用举例:HAL_GPIO_TogglePin ( LED1_GPIO_Port,LED1_Pin );//翻转 LED1 的输出电平。 ! ?* s4 ]$ C. N1 V ! {! P, K/ C5 \/ ^9 @ 核心代码:
本段代码为 main 函数中最后的 while(1)循环部分,进行 LED1 的输出电平翻转后延时500ms,不断循环。, z P* j' y. U% }; D/ x4 V 3 L& X- C7 p% _" D 实验现象: 下载烧录后可以观察到 LED1 以 1Hz 频率进行闪烁,即每 0.5s 进行一次亮灭变化。' O- ?1 U! E- m 5 ~+ [% U9 G; ?& ?, V8 W' o 2、GPIO 输入实验 CubeMX 配置如下,保存后生成对应的配置代码:0 M& `9 m- \, z8 t7 Y 图 3.2.4 输入模式 IO 配置 除 PA4 配置为输入模式,另外 PD10 配置为输出模式用于驱动 LED1,PD10 的配置与GPIO 输出示例相同,此处不再演示,时钟树配置同样与上例相同。GPIO 输入操作说明:
功能:读取 GPIO 输入电平; 参数 1:GPIO 分组,可选 GPIOA,GPIOB,GPIOC 等,根据使用芯片类型进行选择; 参数 2:GPIO 引脚号,一般定义为 GPIO_PIN_x,其中 x 可选 0-15,根据使用芯片类型进行选择;8 v+ y3 y) s# g: ~7 \ 返回:GPIO 电平状态,可以为 GPIO_PIN_SET(高电平)和 GPIO_PIN_RESET(低电平);4 S) T- m$ E2 c+ Y7 J 使用举例:value=HAL_GPIO_ReadPin ( GPIOA,GPIO_PIN_4);//检测 PA4 输入电平" c8 W' F. z* |9 u 3 d K; `) C* Y 核心代码: while (1) { if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_4)==0)//检测按下 PA4) |8 A! c& l# C8 G$ s; d4 Z) i( d {- [2 ^' ^* X6 }. W; u3 k HAL_Delay(5);//延时消抖( G% p, d8 S2 r; y Q% ` if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_4)==0)//再次检测按下 PA4 { HAL_GPIO_TogglePin(LED1_GPIO_Port,LED1_Pin);//翻转 LED1 输出电平 while(!HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_4));//等待松开 PA4 }6 o( N( I" M; X" g }- Z4 | }, S0 q/ o9 k, a } 本段代码为 main 函数中最后的 while(1)循环部分,不断进行 PA4 电平检测,检测到低电平,即按下,则进行 5ms 延时消抖之后再进行检测,以确认按下,则进行 LED1 的输出电平,然后等待松开按键。 + v% D$ u$ C- P T/ g7 j2 ^ 实验现象:: E9 [; m: X# w$ h2 |- V. P& J! G9 | 下载烧录后可以观察到按一下 KEY1,LED1 的亮灭状态进行一次翻转。6 H$ H; e) R. {' ?' v- o " y& B! U2 j' [ 三、中断系统实验& i' N# S: n ? 实验目的:掌握和熟悉外部中断和中断嵌套的使用方法。4 V, O) L9 x6 E& B2 H4 _7 P7 G 1、外部输入中断实验4 l+ @: _+ P T CubeMX 配置如下,保存后生成对应的配置代码: ▲ GPIO 外部输入中断配置 Z4 `. F. [# u1 y6 W ▲ GPIO 外部输入中断优先级配置 除 PA4 配置为下降沿触发外部中断模式,另外 PD10 配置为输出模式用于驱动 LED1,PD10的配置与 GPIO 输出示例相同。6 E: h$ t, K: F2 ?; ]. j) P: S GPIO 外部输入中断函数说明:; M: m, Z0 ~- ~; n void EXTI4_IRQHandler(void)" _. V4 c- T. ?- N. E {" P& w5 ~) M; x HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_4); } 功能:EXTI4 中断处理函数;! e f3 e+ J1 o7 A# E, l 参数:无; 返回:无;" l3 |3 p, ], O& R 说明:当满足 EXTI4 的中断触发条件,CPU 自动跳转到此函数进行执行,CubeMX 生成该函数在 stm32g4xx_it.c 文件中,该函数内为具体的中断处理,最后会跳转到中断回调函数中。* z _. r# ~+ I. F1 Z5 d2 v- m2 ^
功能:EXTI 中断回调处理函数; 参数:GPIO 号;. X- {4 l0 o4 S$ ]' F7 F) Z 返回:无;7 o7 F, j5 D# `1 h8 h3 d 说明:EXTI 中断回调函数,当触发 EXTI 中断之后,中断服务函数会自动调用此回调函数,并填写触发此次中断的 GPIO 号,需要注意的是,此回调函数为多个 EXTI 所共用的,所以进入之后需要对触发中断的 IO 进行判断,另外此函数在 CubeMX 中生成的代码为弱定义代码,可以在需要的地方进行重定义。 3 U' q4 ?" x: I0 j 核心代码: //外部中断处理 void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)( L& s! `7 x9 q1 g7 P6 w2 p {6 _5 u4 B$ f1 {8 C if(GPIO_Pin == GPIO_PIN_4)//PA4 中断; v3 y. L9 J9 ~4 G { for(uint16_t i=0;i<65500;i++)//等待一段时间" ^4 Y! |* x2 U+ w. X { __NOP(); }7 m9 t/ w! w% m3 W* i if(!HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_4)) //读取为低电平,确认按下# R2 T& A! @* L6 Y# A { HAL_GPIO_TogglePin(LED1_GPIO_Port,LED1_Pin);//翻转 LED1 电平. j9 Q' G# }+ |, p } } }! D& t/ @" M5 I! t) Q " w. `( _/ e5 d& b: r, c. \ 本段代码为 EXTI 的中断处理回调函数,进入此函数之后首先判断触发中断的 IO 为所设置的 GPIO,然后等待消抖,再次进行电平检测以防误触,最后进行 LED1 翻转。此函数可以放在任意位置,本例中放在了 main 函数之后。 实验现象: 下载烧录后可以观察到按一下 KEY1,LED1 的亮灭进行一次翻转。1 ?* k9 N6 |$ @6 o! u; x 2、中断嵌套实验- l# K2 i2 a! z: G6 T- | CubeMX 配置如下,保存后生成对应的配置代码: ▲ 外部中断以及输出 IO 配置 ▲ 中断优先级配置 PA4,PA5 配置为下降沿触发外部中断模式,另外 PD10,PD11 配置为输出模式用于驱动LED1 和 LED2,PD10 和 PD11 的配置与 GPIO 输出示例相同。本例主要演示中断嵌套过程,涉及嵌套的中断分别为滴答定时器中断,EXTI4 中断,EXTI[9:5]中断,这三者优先级依次降低。: j# w- `$ W5 M. b2 q核心代码: //外部中断处理 void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)( O! |! J3 X6 k# p6 F. E' ~ {- \1 H) s8 H" }2 h i3 m( G% o if(GPIO_Pin == GPIO_PIN_4)//PA4 中断 {0 Z8 h f, v2 x* R9 u$ J HAL_Delay(5);//延时消抖 if(!HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_4)) //读取为低电平,确认按下% E, T0 P' R- d+ ^ {- \& s8 b. T; b: [* O HAL_GPIO_TogglePin(LED1_GPIO_Port,LED1_Pin);//翻转 LED while(!HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_4));//等待松手,卡住函数' B3 G" [ t8 L2 E; ~2 s+ A3 N } b6 A6 {0 H% {( d }/ s4 E0 R; V8 Y5 [2 d0 v4 H else if(GPIO_Pin == GPIO_PIN_5)//PA5 中断. h* N0 Q+ K; b# y2 |2 ] { if(!HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_5)) //读取为低电平,确认按下' H/ V2 c9 u2 S$ d5 O' b2 l {5 {+ x( M c$ h: K: t( S HAL_Delay(5);//延时消抖/ r$ g( E3 ~" _" V2 @8 @ HAL_GPIO_TogglePin(LED2_GPIO_Port,LED2_Pin);//翻转 LED2/ c1 |6 r( g0 C3 N" b while(!HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_5));//等待松手,卡住函数执行8 k0 x8 c. t( I/ ` }5 b0 y$ H9 P% W& `3 t- s( I }5 j1 \. t& w5 B" F0 C0 a. @ } * u3 T7 L% d% Q& n, ?. q 本段代码为 EXTI 的中断处理回调函数,进入此函数之后首先判断触发中断的 IO 为所设置的 GPIO,然后等待消抖,再次进行电平检测以防误触,最后进行 LED 翻转。这里等待采用了 HAL_Delay 函数,该函数需要滴答定时器支持,因为滴答定时器配置优先级高于外部中断,因此能够打断外部中断的处理函数正常工作,而 EXTI4 中断优先级高于 EXTI[9:5],因此前者能够打断后者进行嵌套。) N0 x- a9 ?/ o 实验现象: 下载烧录后可以观察到按一下 KEY1,LED1 的亮灭进行一次翻转,按一下 KEY2,LED2亮灭进行一次翻转,当按住 KEY1 来按 KEY2 时,LED2 无法正常翻转,按住 KEY2 来按KEY1 时,LED1 可以正常翻转。, m9 S3 a, w, l4 ^3 S7 h! t% {) }3 \ 四、定时器实验 实验目的:掌握和熟悉定时器中断、PWM 输出以及输入捕获的使用和配置方法,以及掌握DMA 方式传输启动和级联定时器等高级操作。. O8 L% d3 w; k8 P0 R 7 }! u T6 W* i8 x 1、定时中断实验/ w; o5 s* }8 J. X5 b% X CubeMX 配置如下,保存后生成对应的配置代码: ▲ 定时器中断配置 ▲ 使能定时器中断 本实验使用 TIM1 作为中断定时器,使用 TIM1 的更新中断,配置系统时钟为 170MHz,同时将 PD12 配置为输出 IO,用于驱动开发板上的 RGB 灯闪烁。% ~- k$ a; |3 R6 f8 y+ a5 V& O定时器基本操作函数说明:
功能:以普通方式启动定时器;3 G' {( B9 D2 M: w 参数 1:定时器句柄,根据实际需要填写; 返回:操作结果,返回 HAL_OK 或者 HAL_ERROR; 注意:用这种方式启动定时器不会触发定时器中断,中断不会被使能- j8 P6 g6 ?: v" G
功能:以普通方式关闭定时器; 参数 1:定时器句柄,根据实际需要填写; 返回:操作结果,返回 HAL_OK 或者 HAL_ERROR;6 ^8 }" f* B0 T$ o( C7 e0 \
参数 1:定时器句柄,根据实际需要填写; 返回:操作结果,返回 HAL_OK 或者 HAL_ERROR; 注意:用这种方式启动定时器时,定时器中断会被使能;
参数 1:定时器句柄,根据实际需要填写; 返回:操作结果,返回 HAL_OK 或者 HAL_ERROR; 定时器中断函数说明:* n/ |5 A0 R* e void TIM1_UP_TIM16_IRQHandler(void)4 H$ p2 Z2 q1 M- t' l {" E" W b0 s+ M HAL_TIM_IRQHandler(&htim1); }, ~5 g, ]; N" J+ x( [0 Y' Y : N; ^8 y4 M; g( R) h* _% p; i 功能:TIM1 更新中断和 TIM16 全局中断的处理函数; 参数:无;4 W) x) w$ D* q+ e 返回:无;! k9 k, q6 L4 F* K8 E& K# M 说明:当 TIM1 产生更新中断或 TIM16 产生任何中断时会进入此中断处理函数,这个函数调用相关的中断服务,最后调用对应的回调函数进行处理。
参数:定时器句柄,由调用此回调函数的中断服务函数进行填写;1 |2 g4 i- J5 S$ `6 H/ ~ 返回:无;. c4 w" o6 c0 r2 [) j# a6 u3 _ 说明:所有定时器更新中断回调函数都会调用此函数,因此在进入函数后需要对具体哪个定时器触发的更新中断进行判断。 核心代码:/ ~& @ j* P& U% j" J
//定时器中断回调函数 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim==(&htim1))7 d5 i7 I, t# a) _+ ?- M7 g { HAL_GPIO_TogglePin(RGB_R_GPIO_Port, RGB_R_Pin);//TIM7 中断翻转红灯0 M f2 K4 u& z& o }% D0 ^) X+ d5 L- v }5 C# m! \, l# }: N- X 在定时器中断回调函数中判断是否是有 TIM1 更新中断触发的中断处理,然后翻转 RGB 灯的相应 IO。 3 G" t! |' O. @) ]9 b' M f 实验现象: 下载烧录后可以观察到 RGB 灯中的红灯以 1HZ 的频率闪烁,亮灭各 0.5s。 ' y9 R! W \/ }( ~6 k7 G( A 2、单路 PWM 输出实验 CubeMX 配置如下,保存后生成对应的配置代码: ▲ 定时器 PWM 输出配置 % l+ V% P( \0 a: j- j; i 本实验使用 TIM1 作为中断定时器,使用 TIM1 的 CH1 产生 PWM 输出,配置系统时钟为170MHz,具体配置见例 3.2.1,定时器设置计数周期为 1ms,即最后产生 PWM 周期为1ms,设置比较值为计数周期的一半,产生占空比为 50%的 PWM 波形。" ?! K; [7 T" ~|# {3 X0 w( Q; p: r2 R9 Y 定时器 PWM 输出操作函数说明:7 u1 H1 Z; c2 W. Q/ C. I
功能:以 PWM 输出方式启动定时器; 参数 1:定时器句柄,根据实际需要填写;) y2 Q3 X0 b2 ~( [" ^# L 参数 2:输出通道,该值为 TIM_CHANNEL_X,X 为 1-6,根据实际需要填写;4 q, ` s, ^, q 返回:操作结果,返回 HAL_OK 或者 HAL_ERROR;
功能:停止响应定时器的制定通道的 PWM 输出;# K7 Q0 |* \- f5 i6 l; P 参数 1:定时器句柄,根据实际需要填写; 参数 2:输出通道,该值为 TIM_CHANNEL_X,X 为 1-6,根据实际需要填写; 返回:操作结果,返回 HAL_OK 或者 HAL_ERROR; # m4 p; j1 O5 A5 D' ]( v9 U. X 核心代码:
在 main 函数完成外设的基本初始化之后需要开启定时器 PWM 输出才能正常工作。不需要单独开启定时器,直接调用此函数定时器自动开始运行。 / h& x: }6 ~0 ^3 p 实验现象: 下载烧录后可以观察到 PC0 产生频率为 1kHz,占空比为 50%的方波。5 G' k5 i4 t/ v ▲ 单 PWM 输出实验现象 3、带死区互补 PWM 输出实验 CubeMX 配置如下,保存后生成对应的配置代码:5 D+ ^: I+ W" \▲ 带死区互补 PWM 输出配置 本实验使用 TIM1 作为中断定时器,使用 TIM1 的 CH1 和 CH1N 产生互补 PWM 输出,配置系统时钟为 170MHz,具体配置见例 3.2.1,定时器设置计数周期为 1ms,即最后产生PWM 周期为 1ms,产生占空比为 50%的 PWM 波形,死区时间大概为 588us。, H9 d5 P' f0 }) U7 H; Q( v$ v1 i 相关操作函数说明:6 U0 a y- E0 O2 R
功能:开启反相通道的 PWM 输出;- K0 V6 f$ x8 g y* D 参数 1:定时器句柄,根据实际需要填写; 参数 2:输出通道,该值为 TIM_CHANNEL_X,X 为 1-4,根据实际需要填写; 返回:操作结果,返回 HAL_OK 或者 HAL_ERROR;3 f9 |! ]* q. `9 h; u3 e
功能:关闭相应反相通道的 PWM 输出;) p W2 @% p: N/ U. | 参数 1:定时器句柄,根据实际需要填写;. w: P4 u2 D6 e5 X0 T 参数 2:输出通道,该值为 TIM_CHANNEL_X,X 为 1-4,根据实际需要填写; 返回:操作结果,返回 HAL_OK 或者 HAL_ERROR;
功能:修改定时器的周期自动装填值;' D, I: n4 m/ Z1 U$ T1 h; g+ ~, Y. [ 参数 1:定时器句柄,根据实际需要填写; 参数 2:自动装填值;! |4 Y5 a. M$ X; l: Z; U 返回:无;: A/ h% G4 w! v3 W4 c1 t 示例:__HAL_TIM_SET_AUTORELOAD ( &htim1,499 );//设置 TIM1 的自动重装填值为499,即修改计数周期1 ^' Q( m0 M4 A, A6 Y9 W {$ Y 说明:该函数是一个宏定义,实质上是直接通过句柄修改相应自动预装填寄存器的值,用来在程序中修改定时器的计数周期;
功能:修改定时器的指定通道的比较寄存器值; 参数 1:定时器句柄,根据实际需要填写;0 G0 d4 y! t$ v( z9 y7 S9 g$ w 参数 2:定时器通道,该值为 TIM_CHANNEL_X,X 为 1-6,根据实际需要填写; 参数 3:要修改的比较寄存器值;/ M& s0 z0 J' z% o [ 返回:无;0 [5 y8 d9 O' a$ s' t& [: E 示例:__HAL_TIM_SET_COMPARE ( &htim1,TIM_CHANNEL_1,count_temp );//设置 TIM1的 CH1 的比较值 说明:该函数是一个宏定义,实质上是直接通过句柄修改相应比较寄存器的值,用来在程序中修改定时器的 PWM 输出占空比等;3 z' U u$ K: G! r! q; k & N$ U: f' D/ ]( X, `& y 核心代码:
在 main 函数完成外设的基本初始化之后需要开启定时器 PWM 输出才能正常工作。不需要单独开启定时器,直接调用此函数定时器自动开始运行。9 f' W; _9 q' D; v5 Z 实验现象:, y/ @1 a3 {- g3 n. ` 下载烧录后可以观察到 PC0 产生频率为 1kHz,占空比为 40%的方波,PC13 与 PC0 波形互补,即频率为 1kHz,占空比为 60%,两者之间有 588us 死区。 ▲ 互补 PWM ▲ 信号死区 7 R/ u4 h1 F9 c$ s1 Z7 x# n6 X) p, j. s$ N 4、定时器捕获测量频率占空比(中断方式) CubeMX 配置如下,保存后生成对应的配置代码:7 W" Y; B7 l' q3 j5 o8 n ▲ TIM2 输入捕获配置 ▲ TIM2 中断使能 TIM1 的 CH1(PC0)输出 1kHz 的方波,TIM2 的 CH1(PA0)配置为输入捕获,采用中断方式进行测量,上升沿和下降沿都触发中断,在上升沿进行计数器复位并记录周期,下降沿记录脉宽,PC0 和 PA0 短接可简单测试,测量结果每 500ms 通过串口打印至 PC,串口配置使能 USART1 即可,不需要进行修改,串口打印需要进行 printf 重定向,具体见串口实验相关章节。7 I/ L! R6 W$ _8 ^1 c( G$ k$ ]: J ; ~- S, m9 X9 a+ u: U: q5 r; C 相关操作函数说明:
功能:以中断方式开启指定通道的输入捕获; 参数 1:定时器句柄,根据实际需要填写;0 u; U) D& Q6 @ C' V3 H 参数 2:捕获通道,该值为 TIM_CHANNEL_X,X 为 1-4,根据实际需要填写;+ A+ _8 H H- G/ _+ \3 b8 e 返回:操作结果,返回 HAL_OK 或者 HAL_ERROR;, Z5 J% S0 n9 D8 K4 A3 M0 Q
功能:关闭指定通道的输入捕获,停止相关中断; 参数 1:定时器句柄,根据实际需要填写; 参数 2:捕获通道,该值为 TIM_CHANNEL_X,X 为 1-4,根据实际需要填写;' r# x3 l$ K( [* P, U 返回:操作结果,返回 HAL_OK 或者 HAL_ERROR;
功能:获取指定定时器的计数值; 参数 1:定时器句柄,根据实际需要填写; 返回:无;! E1 o5 M- ~: x; |9 {3 } 示例:Tim2_Count_rise = __HAL_TIM_GET_COUNTER ( &htim2 );//记录上升沿时的计数器数据,作为周期
参数 1:定时器句柄,根据实际需要填写; 参数 2:要设定的计数值; 返回:无; 示例:__HAL_TIM_SET_COUNTER ( &htim2,0 );//计数器复位清零& x9 `1 w/ V" a8 b# n! f + S; [6 h9 ~; ? 功能:TIM2 全局中断处理函数;8 ~3 `' S2 n3 w' s+ U 参数 1:无; |# N4 J- b3 j 返回:无;7 R+ F/ b, P3 {! H9 M1 [) L 说明:当 TIM2 产生中断会进入这个函数,这个函数对中断进行相应处理,最后调用相应的中断回调函数;
功能:定时器输入捕获回调函数;- L$ k8 \; R" C 参数 1:定时器句柄,由调用该回调函数的中断处理程序填写; 返回:无;说明:该函数为所有定时器捕获触发中断的中断回调函数,所以进入该函数首先需要判断是哪个定时器产生的捕获中断,然后需要判断是哪个边沿产生的中断,以便于进行相应的处理;) R) N3 ?! I: J ; M: u1 J7 o3 A% c4 ^ 核心代码: HAL_TIM_PWM_Start(&htim1,TIM_CHANNEL_1);//开启 CH1 的 PWM 输出) V! o! R: A' s- }* t) t0 w) a7 [ HAL_TIM_IC_Start_IT(&htim2,TIM_CHANNEL_1);//开启输入捕获$ K2 L) H: @1 W- x while (1) { HAL_Delay(500); Frq = (float)10000000/(Tim2_Count_rise+1);//计算频率 Duty = (float)(Tim2_Count_fall+1)/(Tim2_Count_rise+1)*100;//计算占空比" D/ ?. K' J* f2 F$ V1 L5 L+ U printf("Frq:%.1f Hz Duty:%2.1f %% \r\n",Frq,Duty);//打印结果6 k5 c) v9 w& a" u# k } , |1 `( o0 X8 i) E9 c ! x) ]- d( d0 J0 _2 J1 S* o 此部分为 main 函数中的启动部分以及进行相应的频率和占空比计算并进行打印操作。2 r( f, {( A" F 0 v2 |( O9 Q; H5 p% {; ` void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if(htim == &htim2) {6 J+ J2 }3 a! [2 u& ?9 u6 d if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0))//上升沿触发 { Tim2_Count_rise = __HAL_TIM_GetCounter(&htim2);//记录上升沿时的计数器数据,作为周期) D% _5 Q- N- `" P/ ? __HAL_TIM_SetCounter(&htim2,0);//计数器复位清零 }) C; M% H* W: N else//下降沿5 D% l& K" C! e { Tim2_Count_fall = __HAL_TIM_GetCounter(&htim2);//记录下降沿计数器数据,测量脉宽 } }4 v1 J4 X$ C) K; h* E+ Q }4 d$ y* P7 Z& f+ x' c n& S 6 u5 m5 Z; I X( \1 ^2 B; y2 _! A 此部分输入捕获的中断回调函数,在此函数中进行了中断来源判断,相应边沿捕获值记录的操作。 ; F' S) _3 I: Z+ ~& \5 P 7 j# p0 q5 `2 m, U* ~0 Y$ |+ s( o 实验现象: 下载烧录后短接 PA0 和 PC0,通过 USB 连接 DAP 和电脑,在电脑端使用串口助手连接,可以观察到每 500ms 打印一次采集到的频率和占空比数据。 五、串口实验 实验目的:掌握和熟悉串口发送、串口接收以及串口 DMA 的使用和配置方法,掌握串口重定向的操作。& n9 D1 w: H/ F( u 1、串口查询方式收发实验" w/ Z6 Q0 X) G# d: t2 X) a- N% W" ] CubeMX 配置如下,保存后生成对应的配置代码: ▲ 串口配置/ W" K" A2 u. e8 J 本实验使用 USART1 的异步模式进行串口收发,保持基本配置,只需使能串口即可,时钟仍为 170MHz,具体配置见前文。 3 w0 Y, J" ~2 Y/ }$ d" L. Q6 r' O( J9 K% b: ]. O3 i k5 M8 J) p/ J( S. H4 T, Y' x0 l& A 相关操作函数说明: 8 s9 m& O/ d1 @+ U& ~HAL_StatusTypeDef HAL_UART_Transmit(UART_HandleTypeDef *huart, const uint8_t *pData, uint16_t Size, uint32_t Timeout) $ y) U8 }: j9 p' J; e) v3 Q1 ~' p7 J+ j( W/ ?' ] + Y/ q+ V2 o: t4 h4 O1 q. e( x# z5 Y/ E1 l 功能:阻塞模式通过串口发送一定量数据; 参数 1:串口句柄,根据实际需要填写; 参数 2:要发送数据的首地址; 参数 3:发送数据长度,单位字节; 参数 4:超时时间,单位 ms;示例:HAL_UART_Transmit ( &huart1,&UART_temp,1,1 );//通过 UART1 发送一个字节数据,超时时间为 1ms; 返回:操作结果,返回 HAL_OK,HAL_ERROR,HAL_BUSY,HAL_TIMEOUT; 说明:此函数为阻塞模式发送,调用该函数之后 CPU 会被占用,开始发送数据,直到所有数据发送完成,或者达到超时时间仍未发送完成,才会退出该函数; 9 D0 V- P+ b) m& M$ Y: h5 hHAL_StatusTypeDef HAL_UART_Receive(UART_HandleTypeDef *huart, uint8_t *pData,uint16_t Size, uint32_t Timeout) 5 r" x( ?7 z- Z7 O0 U$ d4 X- p$ i 功能:查询模式通过串口接收一定量数据; 参数 1:串口句柄,根据实际需要填写; 参数 2:要接收数据存放位置的首地址; 参数 3:接收数据长度,单位字节; 参数 4:超时时间,单位 ms; 5 Z. \0 A! o& b0 j示例:HAL_UART_Receive ( &huart1,&UART_temp,1,1 );//通过 UART1 接收一个字节数据,超时时间为 1ms; 返回:操作结果,返回 HAL_OK,HAL_ERROR,HAL_BUSY,HAL_TIMEOUT; 2 z; d& y0 S# Z: L! k6 j说明:此函数为阻塞模式查询接收,调用该函数之后 CPU 会被占用,等待串口接收到数据,直到接收到所设长度的数据,或者达到超时时间仍未接收完成,才会退出该函数; # ^; [, U! v; V' c. l: C" Q) m0 ^! x, [! E$ t9 N 核心代码: 6 O, f! q- G/ C. t; ]while (1) { 6 G1 x& I% G2 Eif(HAL_UART_Receive(&huart1,&UART_temp,1,1) == HAL_OK)//查询接收到数据 * _& h" y" n* o2 r{ HAL_UART_Transmit(&huart1,&UART_temp,1,1);//将数据通过串口转发回去 } } 在 main 函数完成外设的基本初始化之后,在 while(1)中不断查询是否接收到数据,如果接收到数据就通过串口在转发回去。 - r# ~4 S0 J$ P 实验现象: 9 K& z* A% G$ X下载烧录后可以观察到上位机发送任何信息,串口都会直接转发回来。 ▲ 上位机收发数据 8 u6 b' d: u% J1 y6 L 2、串口中断方式收发实验 $ I$ [# ~0 D A( H0 v( h( FCubeMX 配置如下,保存后生成对应的配置代码: ▲ 中断配置 本实验使用 USART1 的异步模式进行串口收发,保持基本配置,基本配置与上面相同,这里开启 UART1 的全局中断以进行中断收发。 : T( A2 z% i( j; b, w! b( r. q9 U$ Y( u* g! T# F5 ` 相关操作函数说明: 1 q4 Q8 X7 y/ G l, s: KHAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, const uint8_t*pData, uint16_t Size) 功能:中断模式通过串口发送一定量数据; 6 S* X. c4 f3 S参数 1:串口句柄,根据实际需要填写; e0 Q/ W( P9 q4 e! e参数 2:要发送数据的首地址; ( }1 I1 O# R) @, F7 u参数 3:发送数据长度,单位字节;示例:HAL_UART_Transmit_IT ( &huart1,&UART_temp,1 );//通过 UART1 中断模式发送一个字节数据; 返回:操作结果,返回 HAL_OK,HAL_ERROR,HAL_BUSY; 说明:此函数为中断模式发送,调用该函数之后 CPU 不会被占用,开始发送数据,直到所有数据发送完成,发送过程中以及发送完成之后如果使能了相关中断将会产生中断信号,调用相应的中断回调函数; ( k3 T! x$ l! eHAL_StatusTypeDef HAL_UART_Receive_IT(UART_HandleTypeDef *huart, uint8_t *pData,uint16_t Size) 0 ?, S6 C) i( E, A& ?6 P; Z7 P$ ?; \7 K. X: c) J5 H 5 l# W, ^! F* D6 ~ 功能:中断模式通过串口接收一定量数据; 参数 1:串口句柄,根据实际需要填写; ; } _6 [# V; {" E; W参数 2:要接收数据存放位置的首地址; $ ]4 ?+ W2 N; p2 [1 X- Q, x& z: k参数 3:接收数据长度,单位字节; ! {9 o2 P, l/ O5 ]) f7 L示例:HAL_UART_Receive_IT ( &huart1,&UART_temp,1 );//通过 UART1 接收一个字节数据; 8 Y4 d, o$ W+ @返回:操作结果,返回 HAL_OK,HAL_ERROR,HAL_BUSY; k* n- t4 t- }" S+ n说明:此函数为中断模式查询接收,调用该函数之后 CPU 不会被占用,等待串口接收到数据,直到接收到所设长度的数据,或者其他相关事件会触发相应中断,调用相应中断回调函数; 6 a. P4 e" }" s ]8 f) p$ |$ J& i |$ a1 x9 Q) [ 核心代码: 4 z+ t: E) W( Q/ t( w* O9 VHAL_UART_Receive_IT(&huart1,&uart_temp,1);//中断模式开启 UART1 接收,接收 1 字节。 ' K7 x; |2 X& Y' w u ~3 D* \ c+ ~: J $ z) D3 i( w2 J; K7 d9 _% L( s: @ 在 main 函数完成外设的基本初始化之后,开启串口中断接收。 void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { ! o- j _& y1 \3 mif(huart == &huart1) 8 Q5 I8 U8 F5 L- {1 L{ $ I; A0 t w( f; }9 uHAL_UART_Transmit(&huart1,&uart_temp,1,1); HAL_UART_Receive_IT(&huart1,&uart_temp,1); 7 }8 \) L# ~& r) [} / W7 h G3 L# b} 3 q- E3 |1 h* W: L# P, b( q2 W' r+ ^# [, Z0 l1 |5 C 9 S: `- T4 _0 `: S! D 中断回调函数,在接收完成之后判断中断来源,中断中将接收到的数据转发出去并重启接收,注意如果不重启接收之后不会再收到数据。 - S1 X. w% f3 I7 }* p& T1 @- Q& {3 K 实验现象: 下载烧录后可以观察到上位机发送任何信息,串口都会直接转发回来。 ▲ 上位机收发数据 + s3 I# d0 U( Q! a8 M* O! l3、串口 printf 重定向打印实验 / B7 a3 c& y- C/ X# L0 [Keil 配置如下,保存后生成对应的配置代码: ▲ 配置 keil 使用微库 本实验使用 USART1 的异步模式进行串口收发,保持基本配置,这里需要对 keil 进行配置。 7 M# }2 @6 }3 i3 M+ e+ `, n' I) J E& N$ S8 u+ i 相关操作函数说明: 4 G: [8 o+ Q3 P: g L7 Yint printf ( const char * format, ... ) - t8 U/ C( J0 ?3 F3 }. N; ?, r; L" K% y2 n6 E; r R6 q 5 R. a, @1 Z/ A; H 8 G! T' x- v$ Q! M$ ~& ^+ W: d 功能:格式化并打印字符串; 9 Q' a- f$ a5 _1 b8 \示例:printf("this is uart1 test");//输出字符串; : R( h! S7 e4 r) V- c* s. M2 _$ f k说明:此函数为 C 语言标准库函数,具体详细用法参照 C 语言,使用时需包含头文件stdio.h; 3 [# o# V, k p* S7 X! I0 a0 w+ P 核心代码: ; W, u w6 P) [9 {& y& `( T//重定向 printf #include "stdio.h" / @+ @7 I R4 ~$ dint fputc(int ch,FILE *f) + s9 G3 i, T1 c{ 3 G f. j5 v1 {( _. i8 u s; Ouint32_t temp = ch; HAL_UART_Transmit(&huart1,(uint8_t *)&temp,1,1000); while(__HAL_UART_GET_FLAG(&huart1,UART_FLAG_TC)!=SET); //等待发送 R |+ ~0 ^" H" y- k y结束 return ch; } & B" z: x9 c+ A+ G I6 a3 J; PB l- I9 r% F/ ]3 [5 y8 s ! ^8 t' x; m3 i+ ?6 s1 d' u) Z + n7 z; |7 k5 H, N | 在 main 函数前对 fputc 进行重定向,使用串口进行相应的发送操作。 , F* l" ^4 l6 Z# V& B: i6 \! hwhile (1) { printf("this is uart1 test");//打印测试内容 HAL_Delay(1000);//延时 } / P; p7 P- C% Y, ` + D) G+ F5 \& C1 K main 函数中的循环函数,每 1s 发送一次字符串 this is uart1 test。 N) Z. c4 X) ~, V9 J# g& Z 实验现象: , F9 f4 P2 Q7 @9 q- k下载烧录后可以观察到上位机串口助手每秒收到一次信息。 ▲ 上位机每秒收到一次数据 + V5 O* f1 N0 r' I I* p 4、串口 DMA 收发不定长数据实验 6 }9 n' z1 A# o. hCubeMX 配置如下,保存后生成对应的配置代码: 3 S# o* m; m" V5 W6 \▲ DMA 配置 ▲ 中断配置 + b# X8 @, G' I/ b" ]; b本实验使用 USART1 的异步模式进行串口收发,保持基本配置这里开启 DMA 进行收发,使用普通模式即可。 7 [: s! o8 c U- G! k8 y. z* K" l- C1 L6 q 相关操作函数说明: HAL_StatusTypeDef HAL_UART_Transmit_DMA(UART_HandleTypeDef *huart, const uint8_t *pData, uint16_t Size) 功能:DMA 模式通过串口发送一定量数据; , M* S/ X6 p0 F/ f* O% u* w参数 1:串口句柄,根据实际需要填写; 参数 2:要发送数据的首地址; % S( Z9 Q* X5 x4 b" t3 m参数 3:发送数据长度,单位字节; 0 J }/ X* ~, H8 g示例:HAL_UART_Transmit_DMA ( &huart1,UART_temp,10 );//通过 UART1 中断模式发送 10个字节数据; 4 h4 W! c; G+ y; l返回:操作结果,返回 HAL_OK,HAL_ERROR,HAL_BUSY; 说明:此函数为 DMA 模式发送,调用该函数之后 CPU 不会被占用,由 DMA 进行相关数据发送搬运,发送过程中以及发送完成之后如果使能了相关中断将会产生中断信号,调用相应的中断回调函数; HAL_StatusTypeDef HAL_UART_Receive_DMA(UART_HandleTypeDef *huart, uint8_t*pData, uint16_t Size) 4 g2 G; N$ c9 o& J( G: P7 T S' {" D/ c6 F$ b ( _( T$ V5 _5 i$ V5 d 功能:DMA 模式通过串口接收一定量数据; ' {; `, L. C0 C参数 1:串口句柄,根据实际需要填写; 参数 2:要接收数据存放位置的首地址; $ t( i# Q* S, k# b8 S. f- O参数 3:接收数据长度,单位字节; 8 n, d+ U: t6 a* S W0 ^- m7 ]9 P示例:HAL_UART_Receive_DMA ( &huart1,UART_temp,10 );//通过 UART1 接收 10 个字节数据; 返回:操作结果,返回 HAL_OK,HAL_ERROR,HAL_BUSY; & G- v/ {: O; H1 a说明:此函数为 DMA 模式查询接收,调用该函数之后 CPU 不会被占用,接收到的数据由DMA 搬运到内存,不需要 CPU 参与,等待串口接收到数据,直到接收到所设长度的数据,或者其他相关事件会触发相应中断,调用相应中断回调函数; : T3 G4 `6 ~# b" q! _____HAL_UART_ENABLE_IT(__HANDLE__, __INTERRUPT__) 7 y s5 b' _. Y1 t功能:使能 UART 指定中断; 7 X3 b) M( `2 w参数 1:UART 句柄,根据实际需要填写; 参数 2:中断类型,可选:UART_IT_RXFF、UART_IT_TXFE、UART_IT_RXFT、UART_IT_TXFT、UART_IT_CM、UART_IT_WUF、UART_IT_CTS、UART_IT_LBD、UART_IT_TXE、UART_IT_TXFNF、UART_IT_TC、UART_IT_RXNE、UART_IT_RXFNE、UART_IT_RTO、UART_IT_IDLE、UART_IT_PE、UART_IT_ERR; . w8 B6 v/ h# l3 O' S. K3 l: d返回:无; 说明:有些中断,比如空闲中断,HAL 库没有直接提供以此中断方式启动的函数,因此需要手动开启这些中断。 + {8 Z$ ]: K$ y0 b& M" y; D% D2 i) a2 r5 G' n# v 核心代码: + f8 s: z6 A! w" [, J) t__HAL_UART_ENABLE_IT(&huart1, UART_IT_IDLE); // 使能串口空闲中断 HAL_UART_Receive_DMA(&huart1, (uint8_t*)receive_buff, 255);//开启 DMA 接收 在 main 函数完成外设的基本初始化之后,开启串口 DMA 接收,DMA 接收数组长度应长于预期接收最大数据数量,手动开启空闲中断。 & |: J' i, h$ _8 r6 N% i( j9 d" M! k void USART1_IRQHandler(void) - A! N- D% u) y{ * k' q+ b. e$ a/* USER CODE BEGIN USART1_IRQn 0 */ //串口空闲中断处理 if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_IDLE))//进入了空闲中断 { __HAL_UART_CLEAR_IDLEFLAG(&huart1); //清除空闲中断标志 HAL_UART_DMAStop(&huart1); //停止 DMA 接收 3 C1 H2 }' B5 E3 P }+ ?0 _2 Yuint8_t data_length = 255 - __HAL_DMA_GET_COUNTER(&hdma_usart1_rx); //计算接收到的数据长度 : N& e3 y4 n) sprintf("RX data len is %d \r\n",data_length); HAL_UART_Transmit_DMA(&huart1, receive_buff, data_length); //将收到的数据转发出去 4 f _+ y( Q. _/ i# hHAL_UART_Receive_DMA(&huart1, (uint8_t*)receive_buff, 255);//重启 DMA 接收 } HAL_UART_IRQHandler(&huart1); } & R* s" h# I9 p5 H' U: fStm32g4xx_it.c 文件中的 USART1 中断服务函数,由于空闲中断没有相应回调,所以需要在中断服务函数中添加代码,进入中断判断是否为空闲中断,如果是空闲中断则说明这次数据已经接收完成,此时关闭 DMA 接收,将接收到的数据进行处理,发送,最后重启新的一轮 DMA 接收。 ; E6 n" s4 H# @% [8 z7 } Z S" K( R3 _% a4 }- s: c' ` : W3 {+ h$ A# | 实验现象: 下载烧录后可以观察到上位机串口助手下发信息会转发回来,并且发送接收到数据的统计信息。 ▲ 上位机收发数据 ( @- A9 L% D, k4 r# V" P如有侵权请联系删除 转载自: AI电堂 5 M" v: ?# P! A% m' {+ F$ ~8 b+ v G: K" m- v! t 9 r1 o, g! y, S3 i i9 z ! j' p( Z% w( v 5 L- L5 f8 P5 m$ I & K/ R2 ]% V* ^8 s5 X% c$ L8 m |
STM32G系列RS485自动收发控制以及自适应波特率实战
【学习指南】基于STM32G474VET6 开发板实验经验分享(三)
【学习指南】基于STM32G474VET6 开发板实验经验分享(二)
【学习指南】基于STM32G474软件平台安装与使用教程
【学习指南】基于STM32G474VET6 开发板硬件资源解析
STM32 Explore | 基于STM32G474的STM32Cube生态系统线下培训
STM32固件库分享,超全系列整理
STM32G47x 双 Bank 模式下在线升级
基于STM32G473ZET6开发板设计经验分享
详细讲解STM32G4的软件工具和环境搭建