HAL庫常用函數匯總

1，系統函數

HAL_Delay

原型：void HAL_Delay(uint32_t Delay);

作用：利用滴答定時器生成的系統延遲函數

參數：

Delay：延遲時間，單位是ms

返回值：無

示例代碼：

HAL_Delay(50);//延遲50ms

2，GPIO函數

HAL_GPIO_WritePin

原型：void HAL_GPIO_WritePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);

作用：使得某一個GPIO的Pin的狀態變成高電平或者低電平

參數：

GPIOx：引腳選擇

GPIO_Pin：引腳編號選擇

PinState：引腳狀態設置

返回值：無

示例代碼：

HAL_GPIO_WritePin(GPIOB,GPIO_PIN_15,GPIO_PIN_SET);//設置PB15引腳為高電平HAL_Delay(500);//延時500msHAL_GPIO_WritePin(GPIOB,GPIO_PIN_15,GPIO_PIN_RESET);//設置PB15引腳為低電平HAL_Delay(500);//延時500ms

HAL_GPIO_TogglePin

原型：void HAL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

作用：使得某一個GPIO的Pin的狀態翻轉

參數：

GPIOx：引腳選擇

GPIO_Pin：引腳編號選擇

返回值：無

示例代碼：

HAL_GPIO_TogglePin(GPIOB,GPIO_PIN_15);//設置PB15引腳翻轉，如果原先是低電平，現在就是高電平；如果原先是高電平，現在就是低電平。

HAL_GPIO_ReadPin

原型：GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

作用：讀取某一個GPIO的Pin的狀態翻轉

參數：

GPIOx：引腳選擇

GPIO_Pin：引腳編號選擇

返回值：某一個GPIO的Pin的狀態。

GPIO_PIN_SET：當前狀態為高電平

GPIO_PIN_RESET：當前狀態為低電平

示例代碼：

if(HAL_GPIO_ReadPin(GPIOB,GPIO_PIN_15)==GPIO_PIN_RESET)//判斷PB15為低電平HAL_GPIO_WritePin(GPIOB,GPIO_PIN_14,GPIO_PIN_SET);//設置PB14引腳為高電平

3，UART函數

printf重定向

原型：int fputc(int c,FILE *stream);

作用：printf重定向

參數:系統參數，無需關心

返回值：系統參數，無需關心

示例代碼：

int fputc(int c,FILE *stream)//需要引用頭文件：stdio.h{ HAL_UART_Transmit(&huart1,(uint8_t *)&c,1,100);//注意，這里重定向是串口1 return c;}

HAL_UART_Transmit

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

作用：串口以阻塞式發送數據

參數:

huart：串口號選擇

pData：發送的數據

Size：發送數據的長度

Timeout：超時時間，代表執行函數時，最多占用串口的時間，單位是毫秒

返回值：無

示例代碼：

unsigned char str[]={"hello world"};//需要發送的數據HAL_UART_Transmit(&huart1,str,sizeof(str)，100);//串口1在100ms以內發送數據

HAL_UART_Receive_IT

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

作用：串口以中斷方式接收數據

參數:

huart：串口號選擇

pData：發送的數據

Size：發送數據的長度

返回值：無

示例代碼：

unsigned char str[1];//接收數據存放位置HAL_UART_Receive_IT(&huart1,str,1);//串口接收數據 //串口接收完成的中斷回調函數void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart){ if(str[0]==0x80)//判斷接收的數據是否為0x80 HAL_GPIO_TogglePin(LED0_GPIO_Port,LED0_Pin);//翻轉PB5電平}

HAL_UART_RxCpltCallback

原型：__weak void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart);

作用：串口接收完成的中斷回調函數

參數:系統參數，無需關心

返回值：無

示例代碼：

unsigned char str[1];//接收數據存放位置HAL_UART_Receive_IT(&huart1,str,1);//串口接收一個數據 //串口接收完成的中斷回調函數void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart){ if(str[0]==0x80)//判斷接收的數據是否為0x80 HAL_GPIO_TogglePin(LED0_GPIO_Port,LED0_Pin);//翻轉PB5電平}

3，IIC函數

HAL_I2C_Master_Transmit

原型：HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout);

作用：IIC以主機模式發送數據

參數:

hi2c：IIC編號

DevAddress：寫入的地址

pData：寫入的數據

Size：寫入數據的字節數

Timeout 最大傳輸時間，超過傳輸時間將自動退出傳輸函數

返回值：無

示例代碼：

uint16_t Address=0x1234;uint8_t TxData[2]={0x11,0x22}; //在100ms以內，使用IIC1，采用主機模式，向地址0x1234寫入數據0x11和0x22 HAL_I2C_Master_Transmit(&hi2c1,I2C1_WRITE_ADDRESS,(uint8_t*)TxData,2,100);

4，SPI函數

HAL_SPI_TransmitReceive

原型：HAL_SPI_TransmitReceive(SPI_HandleTypeDef *hspi, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size, uint32_t Timeout);

作用：SPI以阻塞模式發送數據并接收返回值

參數:

hspi：SPI編號

pTxData：寫入的數據

pRxData：讀取的數據

Size：寫入數據的字節數

Timeout：最大傳輸時間，超過傳輸時間將自動退出函數

返回值：無

示例代碼：

uint8_t TxData[2]={0x11,0x22};uint8_t RxData[2]; //在100ms以內，使用SPI1，寫入0x11和0x22，并等待接收的返回值HAL_SPI_TransmitReceive(&spi1,(uint8_t*)TxData,(uint8_t*)TxData,2,100);