开发指导

使用场景

通过系统CPU占用率，判断当前系统负载是否超出设计规格。

通过系统中各个任务的CPU占用率，判断各个任务的CPU占用率是否符合设计的预期。

功能

Huawei LiteOS的CPU占用率模块为用户提供下面几种功能，接口详细信息可以查看API参考。

1. 通过上述接口获取到的CPU占用率是千分比，所以CPU占用率的有效表示范围为0～1000。系统CPU占用率为1000，表示系统满负荷运转。任务CPU占用率为1000，表示在一段时间内系统一直在运行该任务。
2. 获取任务CPU占用率有三种模式，通过入参mode设置：
   • CPUP_LAST_TEN_SECONDS（值为0）：表示获取最近10s内的CPU占用率。
   • CPUP_LAST_ONE_SECONDS（值为1）： 表示获取最近1s的CPU占用率。
   • CPUP_ALL_TIME（值为0xffff），或除0和1之外的其他值：表示获取自系统启动以来的CPU占用率。

CPUP错误码

错误码定义见错误码简介。8~15位的所属模块为CPUP模块，值为0x1e。

开发流程

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

1. 执行make menuconfig命令，进入Kernel ---> Enable Extend Kernel ---> Enable Cpup菜单，完成CPU占用率模块的配置。

   配置项	含义	取值范围	默认值	依赖
   LOSCFG_KERNEL_CPUP	CPUP模块的裁剪开关	YES/NO	YES	LOSCFG_KERNEL_EXTKERNEL
   LOSCFG_CPUP_INCLUDE_IRQ	使能该配置项后，可以在LOS_HistoryTaskCpuUsage和LOS_AllCpuUsage接口中获取中断的CPU占用率。关闭该配置项后，只能获取任务的CPU占用率。	YES/NO	YES	LOSCFG_KERNEL_CPUP

2. 获取系统CPU使用率LOS_HistorySysCpuUsage。
3. 获取指定任务或中断的CPU使用率LOS_HistoryTaskCpuUsage。
4. 获取所有任务或所有中断的CPU使用率LOS_AllCpuUsage。

平台差异性

无。