STM32 HAL常用库函数(持续更新)

1.设置GPIO引脚函数
函数名称:void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);
第一个参数:GPIOA,B,C,D…(取决于单片机型号)
第二个参数:可以取GPIO_PIN_0~GPIO_PIN_15
第三个参数:GPIO_PIN_SET(置高电平),GPIO_PIN_RESET(置低电平)
例:

HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET);//将PA0置高电平
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET);//将PA0置低电平

2.读取GPIO引脚函数
函数名称:GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
第一个参数:GPIOA,B,C,D…(取决于单片机型号)
第二个参数:可以取GPIO_PIN_0~GPIO_PIN_15
返回值:返回"0",对应引脚为低电平,返回"1",对应引脚为高电平。
例:

uint8_t pinstate = 0;
pinstate = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0);

3.GPIO引脚翻转函数
函数名称:void HAL_GPIO_TogglePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
函数功能:若引脚为低电平,则变为高电平;若为高电平,则变为低电平。
第一个参数:GPIOA,B,C,D…(取决于单片机型号)
第二个参数:可以取GPIO_PIN_0~GPIO_PIN_15
4.串口发送函数
函数名称:HAL_StatusTypeDef HAL_UART_Transmit(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout);
函数功能:向串口发送数据(字符串)
第一个参数:哪一个串口
第二个参数:数据指针,指针类型为uint8_t *
第三个参数:数据长度
第四个参数:超时时间,单位是ms
返回值:HAL状态。有四种状态,分别是HAL_OK,HAL_ERROR,HAL_BUSY,HAL_TIMEOUT。
例:

HAL_UART_Transmit(&huart1, "Hello World!!", 13, 100);//向串口1发送Hello World!!

5.printf串口发送函数(重写fputc)
我用过两个版本的fputc,分别对应不同的stm32单片机型号,因为它们的USART寄存器不一样。
版本一:

int fputc(int ch, FILE *f)
{      
    while((USART1->SR&0X40)==0);//循环发送,直到发送完毕   
    USART1->DR = (uint8_t) ch;      
    return ch;
}

版本二:

int fputc(int ch,FILE *f)
{
	while(!((USART1->ISR)&(1<<7)));
	USART1->TDR = ch;
	return ch;
}

6.延时函数
函数名称:void HAL_Delay(uint32_t Delay);
函数功能:毫秒延时函数
参数:延时时间,单位ms
7.定时器中断函数
需要重写HAL_TIM_PeriodElapsedCallback函数,直接看例子:

void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
    static unsigned char ledState = 0;
    if (htim == (&htim2))//TIM2的中断服务函数
    {
        if (ledState == 0)
            HAL_GPIO_WritePin(GPIOE,GPIO_PIN_15,GPIO_PIN_RESET);
        else
            HAL_GPIO_WritePin(GPIOE,GPIO_PIN_15,GPIO_PIN_SET);
        ledState = !ledState;
    }
}

若使用定时器中断,还需先打开定时器中断,相关函数如下:

HAL_TIM_Base_Start_IT(&htim2);//开定时器中断函数
HAL_TIM_Base_Stop_IT(&htim2);//关闭时器中断函数

8.PWM相关函数
函数名称:HAL_StatusTypeDef HAL_TIM_PWM_Start(TIM_HandleTypeDef *htim, uint32_t Channel);
第一个参数:哪个定时器
第二个参数:哪个通道
返回值:HAL状态,与第四个串口发送函数返回只相同。
例:

HAL_TIM_PWM_Start(&htim5, TIM_CHANNEL_2);//开启定时器5,第二个通道的PWM

pwm修改占空比:__HAL_TIM_SetCompare

__HAL_TIM_SetCompare(&htim5, TIM_CHANNEL_2, 100);//即TIM5,第二个通道的比较值改为100,通过修改比较值修改占空比

也可以使用寄存器修改,同样很方便:

TIM5->CCR2 = 100;

你可能感兴趣的:(STM32)