STM32定时器输入捕获功能应用——超声波模块

一、工作原理

输入捕获是STM32单片机定时器的一项重要的功能，应用很广泛，常用于测量脉冲宽度，周期等。

超声波模块测距的原理是：单片机给超声波模块（我用到的超声波模块型号是HC-SR04，下面简称HC-SR04）发送一个大于10us的高电平，触发HC-SR04发出8个40kHz的方波，并自动检测是否有信号返回，如果有信号返回，就会通过Echo对单片机输出一个高电平，高电平的持续时间就是超声波从发射到返回的时间。

换而言之，单片机的工作就是给HC-SR04的Trig端发送一个一个大于10us的高电平，触发HC-SR04工作，然后利用输入捕获功能计算出HC-SR04的Echo端输入的高电平持续时间就可以测出超声波发出到返回的时间，声音在空气中的传播速度是340m/s，因此利用公式：测试距离=(高电平时间 * 声速)/2，就可以算出超声波模块与前方的物体之间的距离是多少。原理图如下：

用一个简图来说明输入捕获测量高电平延续时间的实现原理：

 

二、利用CubeMX生成驱动代码

HC-SR04上有4个引脚：VCC（5V）、GND、Trig（控制端）、Echo（接收端），所以需要配置一个GPIO作为控制HC-SR04的引脚，Echo这个引脚在配置定时器的时候就会自动配置好，不需要单独配置。另外还需要配置一个串口作为打印口方便调试。

1、时钟源配置：

 2、定时器

 3、控制引脚的配置

 4、开启串口

 

 配置完成后生成代码。

三、修改代码

1、写一个us级别的延时：

/********************************************
*函数名称：void delay_us(__IO uint32_t delay)
*函数形参：__IO uint32_t delay--延时时间
*函数返回值：无
*函数功能：微秒级别延时
*********************************************/
void delay_us(__IO uint32_t delay)
{
    int last, curr, val;
    int temp;

    while (delay != 0)
    {
        temp = delay > 900 ? 900 : delay;
        last = SysTick->VAL;
        curr = last - CPU_FREQUENCY_MHZ * temp;
        if (curr >= 0)
        {
            do
            {
                val = SysTick->VAL;
            }
            while ((val < last) && (val >= curr));
        }
        else
        {
            curr += CPU_FREQUENCY_MHZ * 1000; 
            do
            {
                val = SysTick->VAL;
            }
            while ((val <= last) || (val > curr));
        }
        delay -= temp;
    }
}

2、重定向

/********************************************
*函数名称：int fputc(int ch, FILE* stream)
*函数功能：重定向
*********************************************/
int fputc(int ch, FILE* stream)
{
    
   HAL_UART_Transmit(&huart1,(uint8_t *)&ch,1,0xffff);
    return ch;
}

3、触发信号

/********************************************
*函数名称：void Trigger_Signal(__IO uint32_t us)
*函数形参：__IO uint32_t us--触发信号保持时间
*函数返回值：无
*函数功能：触发信号
*********************************************/
void Trigger_Signal(__IO uint32_t us)
{
	HAL_GPIO_WritePin(Trigger_GPIO_Port,Trigger_Pin,GPIO_PIN_SET);
	delay_us(us);
	HAL_GPIO_WritePin(Trigger_GPIO_Port,Trigger_Pin,GPIO_PIN_RESET);
	printf("发送触发信号
");
}

4、　输入捕获中断回调函数：

/********************************************
*函数名称：void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim)
*函数形参：TIM_HandleTypeDef *htim--定时器句柄
*函数返回值：无
*函数功能：捕获到高电平后，计数器清零，配置为低电平捕获，
	当捕获到低电平时，读出CCR的值
*备注：TIM2_CH2_CAPTURE_STA这个是uint8_t数据类型的全局变量，
　　　它的每一位数据可以自定义为某些状态，在这里，第7位为1表示捕获完成，为0表示未完成，
　　　第6位为1表示捕获到上升沿，为0表示未捕获到高电平，0~5bit保留；
　　　TIM2_CH2_ELAPSED_CNT也是一个全局变量，表示从捕获到高电平起，计数器溢出的次数，
　　　TIM2_CH2_CAPTURE_VAL也是一个全局变量，当捕获到下降沿后把CCR2的值读取到这个变量里
*
*********************************************/
void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim)
{
	if((TIM2_CH2_CAPTURE_STA&0x80) != 0x80)//还未完成捕获
	{
		if((TIM2_CH2_CAPTURE_STA&0x40) == 0)　　//此前尚未捕获到上升沿，那么这次捕获到的就是上升沿
		{
			TIM2_CH2_CAPTURE_VAL = 0;　　　　//清零，防止干扰
			TIM2_CH2_ELAPSED_CNT = 0;　　　　//清零，捕获到上升沿后重新计算周期溢出次数
			TIM2_CH2_CAPTURE_STA |= 0x40;　　//捕获到一个上升沿	
			__HAL_TIM_DISABLE(&htim2);　　　　//停止TIM2
			__HAL_TIM_SET_COUNTER(&htim2,0);　　//把TIM2的计数器清零
			TIM_RESET_CAPTUREPOLARITY(&htim2,TIM_CHANNEL_2);　　//清除原来的设置
			TIM_SET_CAPTUREPOLARITY(&htim2,TIM_CHANNEL_2,TIM_ICPOLARITY_FALLING);　　//将TIM2的通道2输入捕获设置为下降沿捕获
			__HAL_TIM_ENABLE(&htim2);　　//使能TIM2
			
		}
		else
		{
			TIM2_CH2_CAPTURE_STA |= 0x80;　　//捕获到一个下降沿，代表捕获完成
			TIM2_CH2_CAPTURE_VAL = HAL_TIM_ReadCapturedValue(&htim2,TIM_CHANNEL_2);　　//把此时CCR2的值读到变量TIM2_CH2_CAPTURE_VAL
			TIM_RESET_CAPTUREPOLARITY(&htim2,TIM_CHANNEL_2);　　//清除原来的设置
			TIM_SET_CAPTUREPOLARITY(&htim2,TIM_CHANNEL_2,TIM_ICPOLARITY_RISING);　　//设置为上升沿捕获
		}
	}
}

5、计数周期溢出中断回调函数：

/********************************************
*函数名称：void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
*函数形参：TIM_HandleTypeDef *htim--定时器句柄
*函数返回值：无
*函数功能：定时器溢出次数计算
*********************************************/
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
	TIM2_CH2_ELAPSED_CNT++;    //每次溢出，该变量增加1
}

6、计算高电平的持续时间：

/********************************************
*函数名称：uint32_t CalculatePulseWide(void)
*函数形参：无
*函数返回值：无
*函数功能：计算出高电平的宽度
*********************************************/
uint32_t CalculatePulseWide(void)
{
	uint32_t PulseWide = 0;
	if((TIM2_CH2_CAPTURE_STA&0x80) == 0x80)
	{
		PulseWide = 0xffff*TIM2_CH2_ELAPSED_CNT+TIM2_CH2_CAPTURE_VAL;
		TIM2_CH2_CAPTURE_STA = 0; 　　//计算完将该变量清零，其实即使不清零应该也没关系，每次捕获到上升沿也会清零
		TIM2_CH2_ELAPSED_CNT = 0;　　 //计算完将该变量清零，其实即使不清零应该也没关系，每次捕获到上升沿也会清零

　　　　　} 
　　　　　return PulseWide; 
}

7、计算距离：

/********************************************
*函数名称：void GetDistance(void)
*函数形参：无
*函数返回值：无
*函数功能：获取距离
*********************************************/
void GetDistance(void)
{
	float temp = 0;
	float distance = 0;
	Trigger_Signal(20);　　//发送触发信号，因为要大于10us，这里就设置为20us
	while(!temp)　　　　　　//等待计算出高电平的时间，如果temp为0，说明还未计算出来，继续等待
	{
		temp = CalculatePulseWide();		
	}
	printf("temp:%f
",temp);　　
	distance = (float)(temp*0.034)/2;　　//计算出距离
	printf("distant:%.2f CM
",distance);

	HAL_Delay(100);　　　　//手册中说明两次测量的时间间距最好大于60ms,避免引起干扰，这里取100ms

}

　8、主函数　

int main(void)
{
  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_TIM2_Init();
  MX_USART1_UART_Init();
  /* USER CODE BEGIN 2 */
	printf("********** HC-RS04 *********
");
	HAL_TIM_IC_Start_IT(&htim2,TIM_CHANNEL_2);　　//开启输入捕获中断
  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */
		GetDistance();　　//计算出距离
    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */
}

　　

　完成代码修改后，烧录到单片机上，进行了测量，发现测得的距离跟实际距离之间的误差不大，当实际距离等于1米的时候，误差大概在1~5cm左右波动。