요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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을 노출합니다.
현재 사용량을 측정할 수 있는 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를 제공합니다.