STM32HAL库常用库函数说明

只看该作者 · 2024-3-31 15:49

系统函数
HAL_Delay（延时函数）
函数原型：
void HAL_Delay(uint32_t Delay);

GPIO
HAL_GPIO_WritePin（GPIO引脚电平设置）
函数原型：
void HAL_GPIO_WritePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);

应用举例
HAL_GPIO_WritePin(GPIOB,GPIO_PIN_15,GPIO_PIN_SET);//设置PB15引脚为高电平
HAL_Delay(500);//延时500ms
HAL_GPIO_WritePin(GPIOB,GPIO_PIN_15,GPIO_PIN_RESET);//设置PB15引脚为低电平
HAL_Delay(500);//延时500ms

只看该作者 · 2024-3-31 15:49

HAL_GPIO_TogglePin（GPIO电平翻转）
函数原型：
void HAL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

应用举例
HAL_GPIO_TogglePin(GPIOB,GPIO_PIN_15);//翻转GPIO引脚电平
HAL_Delay(500);//延时500ms

只看该作者 · 2024-3-31 15:50

HAL_GPIO_ReadPin（获取GPIO引脚状态）
函数原型：
GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

只看该作者 · 2024-3-31 15:50

应用举例
if(HAL_GPIO_ReadPin(GPIOB,KEY1_Pin)==GPIO_PIN_RESET){//判断PB15引脚是否为低电平
HAL_GPIO_WritePin(LED0_GPIO_Port,LED0_Pin,GPIO_PIN_SET);//设置PB14引脚为高电平
}else{
HAL_GPIO_WritePin(LED0_GPIO_Port,LED0_Pin,GPIO_PIN_RESET);//设置PB14引脚为低电平
}

只看该作者 · 2024-3-31 15:50

Timer
HAL_TIM_Base_Start_IT（打开定时器）
函数原型：
HAL_StatusTypeDef HAL_TIM_Base_Start_IT(TIM_HandleTypeDef *htim);

应用举例：
HAL_TIM_Base_Start_IT(&htim2);//开启定时器2中断

只看该作者 · 2024-3-31 15:51

HAL_TIM_Base_Stop_IT（关闭定时器中断）
函数原型：
HAL_StatusTypeDef HAL_TIM_Base_Stop_IT(TIM_HandleTypeDef *htim);

应用举例：
HAL_TIM_Base_Stop_IT(&htim2);//关闭定时器2中断

只看该作者 · 2024-3-31 15:51

USART（串口）
HAL_UART_Transmit（阻塞式发送函数）
函数原型：

HAL_StatusTypeDef HAL_UART_Transmit(UART_HandleTypeDef *huart,uint8_t *pData,uint16_t Size,uint32_t Timeout);

只看该作者 · 2024-3-31 15:51

应用举例
unsigned char str[]={"hello world"};//需要发送的数据

HAL_UART_Transmit(&huart1,str,sizeof(str)，100);//串口发送数据

只看该作者 · 2024-3-31 15:52

HAL_UART_Transmit_IT（非阻塞式发送函数）
函数原型：
HAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart,uint8_t *pData,uint16_t Size);

只看该作者 · 2024-3-31 15:52

应用举例：

unsigned char str[]={"hello world"};//需要发送的数据
HAL_UART_Transmit_IT(&huart1,str,sizeof(str)，100);//串口发送数据

//串口发送完毕回调函数
void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart){
if(huart->Instance==USART1){//判断是否是串口1产生的中断
HAL_GPIO_TogglePin(LED0_GPIO_Port,LED0_Pin);//翻转PB5电平
}
}

只看该作者 · 2024-3-31 15:52

HAL_UART_Receive（阻塞式接收函数）——不推荐使用
函数原型：
HAL_StatusTypeDef HAL_UART_Receive(UART_HandleTypeDef *huart,uint8_t *pData,uint16_t Size,uint32_t Timeout);

只看该作者 · 2024-3-31 15:53

应用举例：
unsigned char str[1];//接收数据存放位置
HAL_UART_Receive(&huart1,str,1);//串口接收数据
1
2
HAL_UART_Receive_IT（非阻塞式接收函数）
函数原型：

HAL_StatusTypeDef HAL_UART_Receive_IT(UART_HandleTypeDef *huart,uint8_t *pData,uint16_t Size);

只看该作者 · 2024-3-31 15:53

应用举例：
unsigned char str[1];//接收数据存放位置
HAL_UART_Receive_IT(&huart1,str,1);//串口接收数据

//串口接收完毕回调函数
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart){
  if(huart->Instance==USART1){//判断是否为串口1产生中断
if(str[0]==0x80){//判断接收的数据是否为0x80
   HAL_GPIO_TogglePin(LED0_GPIO_Port,LED0_Pin);//翻转PB5电平
}
  }
}

只看该作者 · 2024-3-31 15:53

printf重定向
在开始修改代码之前我们需要引用头文件：stdio.h
修该fputc函数
int fputc(int c,FILE *stream){
HAL_UART_Transmit(&huart1,(uint8_t *)&c,1,100);
return c;
}

只看该作者 · 2024-3-31 15:53

ADC
HAL_ADC_Start（阻塞式ADC转换开始）
函数原型：
HAL_StatusTypeDef HAL_ADC_Start(ADC_HandleTypeDef* hadc);

只看该作者 · 2024-3-31 15:54

HAL_ADC_Stop（阻塞式ADC转换停止）
函数原型：
HAL_StatusTypeDef HAL_ADC_Stop(ADC_HandleTypeDef* hadc);

只看该作者 · 2024-3-31 15:54

HAL_ADC_Start_IT（非阻塞式ADC转换开始）
函数原型：
HAL_StatusTypeDef HAL_ADC_Start_IT(ADC_HandleTypeDef* hadc);

只看该作者 · 2024-3-31 15:54

HAL_ADC_Stop_IT（非阻塞式ADC转换停止）
函数原型：
HAL_StatusTypeDef HAL_ADC_Stop_IT(ADC_HandleTypeDef* hadc);

只看该作者 · 2024-3-31 15:55

HAL_ADC_PollForConversion（等待常规组转换完成）
函数原型：
HAL_StatusTypeDef HAL_ADC_PollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout)

只看该作者 · 2024-3-31 15:55

HAL_ADC_GetValue（获取ADC转换结果）
函数原型：
uint32_t HAL_ADC_GetValue(ADC_HandleTypeDef* hadc);