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);
05. 实验现象
实验现象： LED 周期性每秒闪烁 1 次。
