huxi
82 lines
2.4 KiB
C
82 lines
2.4 KiB
C
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @file time_count.h
|
||
*
|
||
* @brief 时间探针，用于粗略记录程序执行时间
|
||
*
|
||
* 使用方法：
|
||
* 1. 在程序开始执行的位置调用 time_count_start；
|
||
* 2. 在程序结束执行的位置调用 time_count_end；
|
||
* 3. 保证 start 和 end 时传入的 id 一致、模块会自动在程序结束位置打印出执行时间，单位 us；
|
||
* 4. 若打印出 Error 信息，说明 start 和 end 时传入的 id 不一致；
|
||
* 5. 此方法仅用于粗略统计程序执行时间，非精确时间。可用于性能调试参考。
|
||
* 注意：
|
||
* 本模块接口仅应用层可以调用，库里调用会导致宏开关无法关闭，造成资源浪费。
|
||
* 每start一个时间，会malloc 20byte空间占用，end时会释放
|
||
*
|
||
* @author
|
||
*
|
||
* @version V1.0.0
|
||
*
|
||
* @date 2025-03-18
|
||
*
|
||
* Copyright(C) 2010- , JIELI TECHNOLOGY, Inc.
|
||
* All right reserved.
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
|
||
#ifndef __TIME_COUNT_H__
|
||
#define __TIME_COUNT_H__
|
||
|
||
// 程序计数功能使能
|
||
#define TIME_COUNT_ENABLE 0
|
||
|
||
|
||
#if (defined TIME_COUNT_ENABLE && TIME_COUNT_ENABLE)
|
||
|
||
#define time_count_start(id) \
|
||
time_count_pushing(id)
|
||
|
||
#define time_count_end(id) \
|
||
{ \
|
||
printf("%s(), %d, time count id: %d, time: %llu us\n", __func__, __LINE__, id, time_count_popping(id)); \
|
||
}
|
||
|
||
#else
|
||
|
||
#define time_count_start(id)
|
||
|
||
#define time_count_end(id)
|
||
|
||
#endif
|
||
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief time_count_pushing 将当前时间压入计时栈中
|
||
*
|
||
* @Params id 为当前时间命名的id，用于计时出栈时计算运行时间
|
||
*
|
||
* @return 当前时间
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
u64 time_count_pushing(u32 id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief time_count_popping 统计指定ID的程序段运行时间，并将该时间出栈
|
||
*
|
||
* @Params id 需要统计时间的ID号，与计时入栈时传入的ID一致
|
||
*
|
||
* @return 指定ID的程序段运行时间，如果指定ID没有入栈，则返回当前时间，并打印错误提示
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
u64 time_count_popping(u32 id);
|
||
|
||
|
||
#endif // !__TIME_COUNT_H__
|
||
|
||
|