当前位置：首页 > news >正文

【鸿蒙开发】Hi3861学习笔记- 定时器中断

news 来源：原创 2025/5/25 8:00:20

00. 目录

文章目录

- 00. 目录
- 01. 概述
- 02. 定时器相关API
- - 2.1 hi_timer_create
  - 2.2 hi_timer_start
  - 2.3 hi_timer_stop
  - 2.4 hi_timer_delete
- 03. 硬件设计
- 04. 软件设计
- 05. 实验现象
- 06. 附录

01. 概述

定时器，顾名思义就是用来计时的，我们常常会设定计时或闹钟，然后时间到了就告诉我们要做什么。Hi3861 也是这样，通过定时器可

以完成各种预设好的任务。定时器到达指定时间后也会产生中断，然后在回调函数内执行所需功能，这个和外部中断类似。

02. 定时器相关API

2.1 hi_timer_create

/**
* @ingroup  iot_systimer
* @brief  Creates the system timer.CNcomment:获取定时器句柄。CNend
*
* @par 描述:
*           Creates the system timer.CNcomment:获取高精定时器句柄。CNend
*
* @attention None
* @param  timer_handle [OUT] type #hi_u32*，handle.CNcomment:获取到的句柄。CNend
*
* @retval #0           Success.
* @retval #Other       Failure. For details, see hi_errno.h.
*
* @par 依赖:
*          @li hi_timer.h：Describes the timer APIs.CNcomment:文件用于描述定时器相关接口。CNend
* @see  hi_timer_delete。
*/
hi_u32 hi_timer_create(hi_u32 *timer_handle);
功能:
	创建系统定时器
参数:
	timer_handle:获取创建好的定时器句柄
返回值:
	0 成功，1 失败；

2.2 hi_timer_start

/**
* @ingroup  iot_systimer
* @brief  Starts the system timer.CNcomment:启动系统定时器。CNend
*
* @par 描述:
*            This API is used in the following scenarios:CNcomment:本API接口使用分为以下几个场景：CNend
*            @li If no timer is created, create and start a timer.
CNcomment:如果未启动定时器，则直接启动。CNend
*            @li If the timer expires and is called again, start the timer directly.
CNcomment:如果该定时器到期后调用，则直接启动定时器。CNend
*            @li If the timer does not expire, stop and restart the timer.
CNcomment:如果定时器没有到期，则停止该定时器，重新启动定时器。CNend
*
* @attention This timer callback function is executed in the interrupt context. Therefore, the callback function should
*            be as simple as possible and the functions such as sleep and wait semaphores that trigger scheduling
*            cannot be used.CNcomment:本定时器回调函数执行于中断上下文，回调函数尽量简单，不能使用睡眠、
等待信号量等引起调度的函数。CNend
*
* @param  timer_handle  [IN]  type #hi_u32，handle.CNcomment:句柄。CNend
* @param  type          [IN]   type #hi_timer_type，timer type.CNcomment:定时器类型。CNend
* @param  expire        [IN]   type #hi_u32，timeout period of the timer (unit: ms). If this parameter is set to 0,
*                       the default value is 10 ms.CNcomment:定时器超时时间（单位：ms）。配置为0时，默认为10ms。CNend
* @param  timer_func    [IN]   type #timer_proc_func，timer callback function.CNcomment:定时器回调函数。CNend
* @param  data          [IN]   type #hi_u32，callback input parameter.CNcomment:回调函数传参。CNend
*
* @retval #0           Success.
* @retval #Other       Failure. For details, see hi_errno.h.
*
* @par 依赖:
*          @li hi_timer.h：Describes the timer APIs.CNcomment:文件用于描述定时器相关接口。CNend
* @see hi_timer_stop
*/
hi_u32 hi_timer_start(hi_u32 timer_handle, hi_timer_type type, hi_u32 expire,
                      hi_timer_callback_f timer_func, hi_u32 data);
功能:
	启动系统定时器
参数:
	timer_handle:定时器句柄
	Type：用于设置所创建的定时器类型
	expire：定时时间，单位 ms。如果参数设置值为 0，则默认为 10ms。
	timer_func：定时器定时时间到达，回调函数。
	data：回调函数参数。不传递参数则为 NULL。
返回值:
	0 成功，1 失败；

2.3 hi_timer_stop

/**
* @ingroup  iot_systimer
* @brief  Stops the system timer.CNcomment:停止系统定时器。CNend
*
* @par 描述:
*          Stops the system timer.CNcomment:停止系统定时器。CNend
*
* @attention This API only stops the timer and does not delete the timer.CNcomment:本接口仅停止定时器，
并不删除该定时器。CNend
* @param  timer_handle [IN] type #hi_u32，handle.CNcomment:句柄。CNend
*
* @retval #0           Success.
* @retval #Other       Failure. For details, see hi_errno.h.
*
* @par 依赖:
*          @li hi_timer.h：Describes the timer APIs.CNcomment:文件用于描述定时器相关接口。CNend
* @see hi_timer_start | hi_timer_delete
*/
hi_u32 hi_timer_stop(hi_u32 timer_handle)
功能:
	停止系统定时器
参数:
	timer_handle:定时器句柄
返回值:
	0 成功 1 失败

2.4 hi_timer_delete

/**
* @ingroup  iot_systimer
* @brief  Deletes the timer.CNcomment:删除定时器。CNend
*
* @par 描述:
*           Deletes the timer.CNcomment:删除定时器。CNend
*
* @attention
*            @li If the timer does not expire, stop the timer before deleting it.
CNcomment:如果定时器未到期，则先停止该定时器再删除。CNend
*
* @param  timer_handle [IN] type #hi_u32，handle.CNcomment:句柄。CNend
*
* @retval #0           Success.
* @retval #Other       Failure. For details, see hi_errno.h.
*
* @par 依赖:
*          @li hi_timer.h：Describes the timer APIs.CNcomment:文件用于描述定时器相关接口。CNend
* @see hi_timer_start | hi_timer_stop
*/
hi_u32 hi_timer_delete(hi_u32 timer_handle)
功能:
	删除系统定时器。如果定时器未到期，则先停止该定时器再删除
参数:
	timer_handle:定时器句柄
返回值:
	0 成功，1 失败

03. 硬件设计

在这里插入图片描述

从网络标号可知，LED 与芯片的 IO2 管脚连接，当该引脚输出高电平时，LED点亮，输出低电平时，LED 熄灭。

04. 软件设计

bsp_time.h

#ifndef BSP_TIME_H
#define BSP_TIME_H

#include "cmsis_os2.h"
#include "hi_io.h"
#include "hi_gpio.h"



//函数声明
void time_init(uint16_t times);
void time_onoff(uint8_t sta);

#endif

bsp_time.c

#include "bsp_time.h"
#include <unistd.h>
#include "bsp_led.h"
#include "hi_timer.h"


hi_u32 timer_handle;
uint16_t g_times=0;

//定时器回调函数
void time_isr_fun(void)
{
    static uint8_t i=0;
    i=!i; 
    LED(i);
}

//定时器初始化
//times：定时时间，ms
void time_init(uint16_t times)
{
    hi_u32 ret;
    g_times=times; 
    ret = hi_timer_create(&timer_handle);
    if(ret!=HI_ERR_SUCCESS)
    {
        printf("Timer_Create failed\r\n");
    }
    hi_timer_start(timer_handle,HI_TIMER_TYPE_PERIOD,times,(hi_timer_callback_f)time_isr_fun,NULL);
}

//定时器开关
void time_onoff(uint8_t sta)
{
    if(sta==0)hi_timer_stop(timer_handle);
    else hi_timer_start(timer_handle,HI_TIMER_TYPE_PERIOD,g_times,(hi_timer_callback_f)time_isr_fun,NULL);
}

template.c

/**
 ****************************************************************************************************
 * @file        template.c
 ****************************************************************************************************
 * 实验现象：间隔1S，LED指示灯亮灭
 *
 ****************************************************************************************************
 */

#include <stdio.h>
#include <unistd.h>

#include "ohos_init.h"
#include "cmsis_os2.h"

#include "bsp_time.h"
#include "bsp_led.h"



//控制任务
osThreadId_t TIME_Task_ID; //任务ID

void TIME_Task(void)
{
    led_init();//LED初始化
    time_init(500);//定时器初始化，定时时间500ms
    
    while (1) 
    {
        usleep(10*1000);
    }
}
//任务创建
void time_task_create(void)
{
    osThreadAttr_t taskOptions;
    taskOptions.name = "timeTask";       // 任务的名字
    taskOptions.attr_bits = 0;               // 属性位
    taskOptions.cb_mem = NULL;               // 堆空间地址
    taskOptions.cb_size = 0;                 // 堆空间大小
    taskOptions.stack_mem = NULL;            // 栈空间地址
    taskOptions.stack_size = 1024;           // 栈空间大小 单位:字节
    taskOptions.priority = osPriorityNormal; // 任务的优先级

    TIME_Task_ID = osThreadNew((osThreadFunc_t)TIME_Task, NULL, &taskOptions); // 创建任务
    if (TIME_Task_ID != NULL)
    {
        printf("ID = %d, Task Create OK!\n", TIME_Task_ID);
    }
}

/**
 * @description: 初始化并创建任务
 * @param {*}
 * @return {*}
 */
static void template_demo(void)
{
    printf("-Hi3861开发板--定时器中断实验\r\n");
    time_task_create();//任务创建
}
SYS_RUN(template_demo);