요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
========================
4
Device Frequency Scaling
5
========================
7
Introduction
8
------------
10
This framework provides a standard kernel interface for Dynamic Voltage and
11
Frequency Switching on arbitrary devices.
13
It exposes controls for adjusting frequency through sysfs files which are
14
similar to the cpufreq subsystem.
16
Devices for which current usage can be measured can have their frequency
17
automatically adjusted by governors.
19
API
20
---
22
Device drivers need to initialize a :c:type:`devfreq_profile` and call the
23
:c:func:`devfreq_add_device` function to create a :c:type:`devfreq` instance.
25
.. kernel-doc:: include/linux/devfreq.h
26
.. kernel-doc:: include/linux/devfreq-event.h
27
.. kernel-doc:: drivers/devfreq/devfreq.c
28
:export:
29
.. kernel-doc:: drivers/devfreq/devfreq-event.c
30
:export:
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Device Frequency Scaling 소개
1-18.. SPDX-License-Identifier: GPL-2.0이 framework는 임의의 device에서 DVFS(Dynamic Voltage and Frequency Switching)를 수행하기 위한 표준 kernel interface를 제공합니다.
cpufreq subsystem과 비슷한 sysfs file을 통해 frequency 조정 control을 노출합니다.
현재 usage를 측정할 수 있는 device는 governors가 frequency를 자동으로 조정하도록 구성할 수 있습니다.
devfreq API
19-30device driver는 :c:type:`devfreq_profile`을 초기화하고 :c:func:`devfreq_add_device`를 호출해 :c:type:`devfreq` instance를 생성해야 합니다.
.. kernel-doc:: include/linux/devfreq.h
.. kernel-doc:: include/linux/devfreq-event.h
.. kernel-doc:: drivers/devfreq/devfreq.c
:export:
.. kernel-doc:: drivers/devfreq/devfreq-event.c
:export:SourceRoleDirective
include/linux/devfreq.hdevfreq core types and APIkernel-doc
include/linux/devfreq-event.hdevfreq event APIkernel-doc
drivers/devfreq/devfreq.cdevfreq implementationexport
drivers/devfreq/devfreq-event.cevent implementationexport
devfreq core, event interface와 exported implementation을 제공하는 source를 정리했습니다.
요약과 해설
devfreq.rst:1-30devfreq는 CPU 이외 device의 frequency와 voltage를 workload에 맞춰 조정하는 공통 framework입니다. driver는 `devfreq_profile`과 `devfreq_add_device()`로 instance를 만들고, core·event header와 implementation의 kernel-doc가 API를 제공합니다.