← Documents Documentation/ABI/testing/sysfs-class-pwm GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Generic PWM class sysfs ABI

Generic PWM chip과 channel export, period·duty cycle·polarity·enable configuration 및 signal capture 형식을 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-class-pwm
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

PWM class and controller

sysfs-class-pwm:1-24

Generic PWM Framework class, probed chip instance와 supported channel 수를 제공합니다.

PWM channel export lifecycle

sysfs-class-pwm:26-48

0부터 npwm-1까지 channel을 export·unexport하고 pwmX control directory를 생성합니다.

PWM signal configuration

sysfs-class-pwm:50-79

Nanosecond period·duty cycle, normal·inversed polarity와 binary enable을 설정합니다.

PWM signal capture

sysfs-class-pwm:81-88

Captured period와 duty cycle을 single space로 구분한 unsigned integer pair로 반환합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/class/pwm/
2 Date: May 2013
3 KernelVersion: 3.11
4 Contact: H Hartley Sweeten <hsweeten@visionengravers.com>
5 Description:
6 The pwm/ class sub-directory belongs to the Generic PWM
7 Framework and provides a sysfs interface for using PWM
8 channels.
9
10 What: /sys/class/pwm/pwmchip<N>/
11 Date: May 2013
12 KernelVersion: 3.11
13 Contact: H Hartley Sweeten <hsweeten@visionengravers.com>
14 Description:
15 A /sys/class/pwm/pwmchipN directory is created for each
16 probed PWM controller/chip where N is the base of the
17 PWM chip.
18
19 What: /sys/class/pwm/pwmchip<N>/npwm
20 Date: May 2013
21 KernelVersion: 3.11
22 Contact: H Hartley Sweeten <hsweeten@visionengravers.com>
23 Description:
24 The number of PWM channels supported by the PWM chip.
25
26 What: /sys/class/pwm/pwmchip<N>/export
27 Date: May 2013
28 KernelVersion: 3.11
29 Contact: H Hartley Sweeten <hsweeten@visionengravers.com>
30 Description:
31 Exports a PWM channel from the PWM chip for sysfs control.
32 Value is between 0 and /sys/class/pwm/pwmchipN/npwm - 1.
33
34 What: /sys/class/pwm/pwmchip<N>/unexport
35 Date: May 2013
36 KernelVersion: 3.11
37 Contact: H Hartley Sweeten <hsweeten@visionengravers.com>
38 Description:
39 Unexports a PWM channel.
40
41 What: /sys/class/pwm/pwmchip<N>/pwmX
42 Date: May 2013
43 KernelVersion: 3.11
44 Contact: H Hartley Sweeten <hsweeten@visionengravers.com>
45 Description:
46 A /sys/class/pwm/pwmchipN/pwmX directory is created for
47 each exported PWM channel where X is the exported PWM
48 channel number.
49
50 What: /sys/class/pwm/pwmchip<N>/pwmX/period
51 Date: May 2013
52 KernelVersion: 3.11
53 Contact: H Hartley Sweeten <hsweeten@visionengravers.com>
54 Description:
55 Sets the PWM signal period in nanoseconds.
56
57 What: /sys/class/pwm/pwmchip<N>/pwmX/duty_cycle
58 Date: May 2013
59 KernelVersion: 3.11
60 Contact: H Hartley Sweeten <hsweeten@visionengravers.com>
61 Description:
62 Sets the PWM signal duty cycle in nanoseconds.
63
64 What: /sys/class/pwm/pwmchip<N>/pwmX/polarity
65 Date: May 2013
66 KernelVersion: 3.11
67 Contact: H Hartley Sweeten <hsweeten@visionengravers.com>
68 Description:
69 Sets the output polarity of the PWM signal to "normal" or
70 "inversed".
71
72 What: /sys/class/pwm/pwmchip<N>/pwmX/enable
73 Date: May 2013
74 KernelVersion: 3.11
75 Contact: H Hartley Sweeten <hsweeten@visionengravers.com>
76 Description:
77 Enable/disable the PWM signal.
78 0 is disabled
79 1 is enabled
80
81 What: /sys/class/pwm/pwmchip<N>/pwmX/capture
82 Date: June 2016
83 KernelVersion: 4.8
84 Contact: Lee Jones <lee@kernel.org>
85 Description:
86 Capture information about a PWM signal. The output format is a
87 pair unsigned integers (period and duty cycle), separated by a
88 single space.
89

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Generic PWM Framework class

1-8
항목한국어 전문 번역
What/sys/class/pwm/
Date2013년 5월
KernelVersion3.11
ContactH Hartley Sweeten <hsweeten@visionengravers.com>
Descriptionpwm/ class subdirectory는 Generic PWM Framework에 속하며 PWM channel 사용을 위한 sysfs interface를 제공합니다.

Probed PWM controller

10-17
항목한국어 전문 번역
What/sys/class/pwm/pwmchip<N>/
Date2013년 5월
KernelVersion3.11
ContactH Hartley Sweeten <hsweeten@visionengravers.com>
DescriptionProbe된 각 PWM controller 또는 chip마다 /sys/class/pwm/pwmchipN directory를 생성합니다. N은 PWM chip의 base입니다.

Supported PWM channel count

19-24
항목한국어 전문 번역
What/sys/class/pwm/pwmchip<N>/npwm
Date2013년 5월
KernelVersion3.11
ContactH Hartley Sweeten <hsweeten@visionengravers.com>
DescriptionPWM chip이 지원하는 PWM channel 수입니다.

Export a PWM channel

26-32
항목한국어 전문 번역
What/sys/class/pwm/pwmchip<N>/export
Date2013년 5월
KernelVersion3.11
ContactH Hartley Sweeten <hsweeten@visionengravers.com>
DescriptionPWM chip의 channel을 sysfs control 대상으로 export합니다. 값은 0부터 /sys/class/pwm/pwmchipN/npwm - 1 사이입니다.

Unexport a PWM channel

34-39
항목한국어 전문 번역
What/sys/class/pwm/pwmchip<N>/unexport
Date2013년 5월
KernelVersion3.11
ContactH Hartley Sweeten <hsweeten@visionengravers.com>
DescriptionPWM channel의 export를 해제합니다.

Exported PWM channel directory

41-48
항목한국어 전문 번역
What/sys/class/pwm/pwmchip<N>/pwmX
Date2013년 5월
KernelVersion3.11
ContactH Hartley Sweeten <hsweeten@visionengravers.com>
DescriptionExport한 각 PWM channel마다 /sys/class/pwm/pwmchipN/pwmX directory를 생성합니다. X는 export한 PWM channel 번호입니다.
PWM channel export lifecycle
pwmchip<N>/npwm에서 channel count 확인export에 0~npwm-1 channel index 기록pwmchip<N>/pwmX directory 생성unexport에 X를 기록해 제거

Chip channel index를 export하면 pwmX control directory가 나타납니다.

PWM signal period

50-55
항목한국어 전문 번역
What/sys/class/pwm/pwmchip<N>/pwmX/period
Date2013년 5월
KernelVersion3.11
ContactH Hartley Sweeten <hsweeten@visionengravers.com>
DescriptionPWM signal period를 nanosecond 단위로 설정합니다.

PWM signal duty cycle

57-62
항목한국어 전문 번역
What/sys/class/pwm/pwmchip<N>/pwmX/duty_cycle
Date2013년 5월
KernelVersion3.11
ContactH Hartley Sweeten <hsweeten@visionengravers.com>
DescriptionPWM signal duty cycle을 nanosecond 단위로 설정합니다.

PWM output polarity

64-70
항목한국어 전문 번역
What/sys/class/pwm/pwmchip<N>/pwmX/polarity
Date2013년 5월
KernelVersion3.11
ContactH Hartley Sweeten <hsweeten@visionengravers.com>
DescriptionPWM signal output polarity를 "normal" 또는 "inversed"로 설정합니다.

PWM signal enable

72-79
항목한국어 전문 번역
What/sys/class/pwm/pwmchip<N>/pwmX/enable
Date2013년 5월
KernelVersion3.11
ContactH Hartley Sweeten <hsweeten@visionengravers.com>
DescriptionPWM signal을 enable 또는 disable합니다. 0은 disabled, 1은 enabled입니다.
PWM signal controls
속성값 또는 단위
periodNanoseconds
duty_cycleNanoseconds
polaritynormal 또는 inversed
enable0 disabled, 1 enabled

Exported pwmX channel의 waveform configuration입니다.

Captured PWM period and duty cycle

81-88
항목한국어 전문 번역
What/sys/class/pwm/pwmchip<N>/pwmX/capture
Date2016년 6월
KernelVersion4.8
ContactLee Jones <lee@kernel.org>
DescriptionPWM signal 정보를 capture합니다. Output은 period와 duty cycle의 unsigned integer pair이며 single space로 구분합니다.
<period> <duty_cycle>
PWM capture output
순서Field형식
1periodUnsigned integer
2duty cycleUnsigned integer

Single-space-separated pair의 field 순서입니다.