# resourceschedule_qos_manager

#### Description
{**When you're done, you can delete the content in this README and update the file with details for others getting started with your repository**}

#### Software Architecture
Software architecture description

#### Installation

1.  xxxx
2.  xxxx
3.  xxxx

#### Instructions

1.  xxxx
2.  xxxx
3.  xxxx

#### Contribution

1.  Fork the repository
2.  Create Feat_xxx branch
3.  Commit your code
4.  Create Pull Request


#### Gitee Feature

1.  You can use Readme\_XXX.md to support different languages, such as Readme\_en.md, Readme\_zh.md
2.  Gitee blog [blog.gitee.com](https://blog.gitee.com)
3.  Explore open source project [https://gitee.com/explore](https://gitee.com/explore)
4.  The most valuable open source project [GVP](https://gitee.com/gvp)
5.  The manual of Gitee [https://gitee.com/help](https://gitee.com/help)
6.  The most popular members  [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)

# resourceschedule_qos_manager

#### 介绍
{**以下是 Gitee 平台说明，您可以替换此简介**
Gitee 是 OSCHINA 推出的基于 Git 的代码托管平台（同时支持 SVN）。专为开发者提供稳定、高效、安全的云端软件开发协作平台
无论是个人、团队、或是企业，都能够用 Gitee 实现代码托管、项目管理、协作开发。企业项目请看 [https://gitee.com/enterprises](https://gitee.com/enterprises)}

#### 软件架构
软件架构说明


#### 安装教程

1.  xxxx
2.  xxxx
3.  xxxx

#### 使用说明

1.  xxxx
2.  xxxx
3.  xxxx

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)

# resourceschedule_qos_manager

## 简介<a name="section_introduction"></a>

权限管控服务目前服务于并发编程框架FFRT，为特定的线程提供调用底层Qos和RTG接口的能力。服务接收全局资源调度管控子系统中的帧感知调度插件发送的场景信息，为系统服务uid与前台app的uid赋予调用底层对应接口的权限。同时将多级Qos的配置信息下发到内核，为而为并发编程框架FFRT提供支撑。

## 目录<a name="section_catalogue"></a>

```
//foundation/resourceschedule/qos_manager
├── etc
│   └── init                                # 权限管控服务配置文件
|
├── sa_profile                              # 权限管控服务xml
├── include                                 # 部件通用工具类
│   └── concurrent_task_log.h               # 封装hilog，用于日志打印
│
├── interfaces/inner_api
│   └── concurrent_task_client.h            # 部件间调用接口
|
├── frameworks
│   └── concurrent_task_client              # 服务client端
|
├── services                                # 服务service端
│
└── test                                    # 自测试用例目录
```


## 框架<a name="section_frameworks"></a>

权限管控服务根据其对接的内核功能模块，主要可以分为两个部分。即RTG权限管控与分组管理、多级QoS权限管控与信息下发。

- **RTG权限管控与分组管理**：主要分为基于uid的RTG权限管控模块、RTG分组管理模块。其中：

  基于uid的RTG权限管控模块，主要接收帧感知调度发送的场景信息，基于这些消息，将一些特权uid、以及切换到前台的app对应的uid赋予RTG操作权限，使拥有这些uid的线程可以对RTG分组执行特定操作。

  RTG分组管理模块，统一管理RTG分组，为并发编程框架目前对接的外部场景用到的RTG分组执行创建、销毁等操作。

- **多级QoS权限管控与信息下发**：主要分为基于uid的QoS权限管控模块、多级QoS信息下发模块。其中：

  基于uid的QoS权限管控模块，和RTG权限管控模块类似，主要接收帧感知调度发送的场景信息，基于这些消息，将一些特权uid、以及切换到前台的app对应的uid赋予设置QoS等级的权限。

  多级QoS信息下发模块，将不同场景下的不同QoS等级对应的nice、uclamp等参数下发到内核，为线程的QoS等级设置服务。

两个部分中的权限管控模块，统筹了权限管控服务所需要的外部事件，并根据事件类型下发对应的参数和权限，和并发编程框架相互合作，共同保障系统的性能供给。

## 使用说明<a name="section_instructions"></a>

系统开发者可以通过配置productdefine/common/products下的产品定义json文件，增加或移除本部件，来启用或停用本部件：

```
"qos_manager:concurrent_task_client":{}
```

## 相关仓<a name="section_related_repositories"></a>

- [resource_schedule_service](https://gitee.com/openharmony/resourceschedule_resource_schedule_service)
- [frame_aware_sched](https://gitee.com/openharmony/frame_aware_sched)
- **resourceschedule_qos_manager**