开发指导

接口说明

表 1 功能列表

功能分类

接口名

描述

获取系统CPU占用率

LOS_SysCpuUsage

获取当前系统CPU占用率

LOS_HistorySysCpuUsage

获取系统历史CPU占用率

获取任务CPU占用率

LOS_TaskCpuUsage

获取指定任务CPU占用率

LOS_HistoryTaskCpuUsage

获取指定任务历史CPU占用率

LOS_AllCpuUsage

获取所有任务CPU占用率

输出任务CPU占用率

LOS_CpupUsageMonitor

输出任务历史CPU占用率

开发流程

CPU占用率的典型开发流程:

  1. 调用获取系统CPU使用率函数LOS_SysCpuUsage。

  2. 调用获取系统历史CPU使用率函数LOS_HistorySysCpuUsage。

  3. 调用获取指定任务CPU使用率函数LOS_TaskCpuUsage。

    • 若任务已创建,则关中断,正常获取,恢复中断;
    • 若任务未创建,则返回错误码;
  4. 调用获取指定任务历史CPU使用率函数LOS_HistoryTaskCpuUsage。

    • 若任务已创建,则关中断,根据不同模式正常获取,恢复中断;
    • 若任务未创建,则返回错误码;
  5. 调用获取所有任务CPU使用率函数LOS_AllCpuUsage。

    • 若CPUP已初始化,则关中断,根据不同模式正常获取,恢复中断;
    • 若CPUP未初始化或有非法入参,则返回错误码;

编程实例

实例描述

本实例实现如下功能:

  1. 创建一个用于CPUP测试的任务。
  2. 获取当前系统CPUP。
  3. 以不同模式获取历史系统CPUP。
  4. 获取创建的测试任务的CPUP。
  5. 以不同模式获取创建的测试任务的CPUP

示例代码

前提条件:

在target_config.h中将LOSCFG_BASE_CORE_CPUP配置项打开。

代码实现如下:

#include "los_task.h"
#include "los_cpup.h" 
#define  MODE  4
UINT32 g_cpuTestTaskID;  
VOID ExampleCpup(VOID) 
{      
    printf("entry cpup test example\n");
    while(1) {
        usleep(100);
    }
}
UINT32 ItCpupTest(VOID) 
{     
    UINT32 ret;
    UINT32 cpupUse;
    TSK_INIT_PARAM_S cpupTestTask = { 0 };
    memset(&cpupTestTask, 0, sizeof(TSK_INIT_PARAM_S));
    cpupTestTask.pfnTaskEntry = (TSK_ENTRY_FUNC)ExampleCpup;
    cpupTestTask.pcName       = "TestCpupTsk"; 
    cpupTestTask.uwStackSize  = 0x800;
    cpupTestTask.usTaskPrio   = 5;
    ret = LOS_TaskCreate(&g_cpuTestTaskID, &cpupTestTask);
    if(ret != LOS_OK) {
        printf("cpupTestTask create failed .\n");
        return LOS_NOK;
    }

    usleep(100);

    /* 获取当前系统cpu占用率 */
    cpupUse = LOS_SysCpuUsage();
    printf("the current system cpu usage is: %u.%u\n",
            cpupUse / LOS_CPUP_PRECISION_MULT, cpupUse % LOS_CPUP_PRECISION_MULT); 

    cpupUse = LOS_HistorySysCpuUsage(CPU_LESS_THAN_1S);
    /* 获取指定任务的cpu占用率,该测试例程中指定的任务为以上创建的cpup测试任务 */    
    printf("the history system cpu usage in all time:%u.%u\n",
           cpupUse / LOS_CPUP_PRECISION_MULT, cpupUse % LOS_CPUP_PRECISION_MULT);
    cpupUse = LOS_TaskCpuUsage(g_cpuTestTaskID);    
    /* 获取指定历史任务在系统启动到现在的cpu占用率,该测试例程中指定的任务为以上创建的cpup测试任务 */    
    printf("cpu usage of the cpupTestTask:\n TaskID: %d\n usage: %u.%u\n",
           g_cpuTestTaskID, cpupUse / LOS_CPUP_PRECISION_MULT, cpupUse % LOS_CPUP_PRECISION_MULT); 
    cpupUse = LOS_HistoryTaskCpuUsage(g_cpuTestTaskID, CPU_LESS_THAN_1S);   
    printf("cpu usage of the cpupTestTask in all time:\n TaskID: %d\n usage: %u.%u\n",
           g_cpuTestTaskID, cpupUse / LOS_CPUP_PRECISION_MULT, cpupUse % LOS_CPUP_PRECISION_MULT);   
    return LOS_OK; 
}

结果验证

编译运行得到的结果为:

entry cpup test example 
the current system cpu usage is : 1.5
 the history system cpu usage in all time: 3.0
 cpu usage of the cpupTestTask: TaskID:10 usage: 0.0
 cpu usage of the cpupTestTask in all time: TaskID:10 usage: 0.0