STMicroelectronics PWM | Linux 6.18.37

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

pwm-st.txt:1-43

Controller별 필수 property와 실제 device-tree 예제를 함께 설명합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기

1 STMicroelectronics PWM driver bindings

2 --------------------------------------

4 Required parameters:

5 - compatible : "st,pwm"

6 - #pwm-cells : Number of cells used to specify a PWM. First cell

7 specifies the per-chip index of the PWM to use and the

8 second cell is the period in nanoseconds - fixed to 2

9 for STiH41x.

10 - reg : Physical base address and length of the controller's

11 registers.

12 - pinctrl-names: Set to "default".

13 - pinctrl-0: List of phandles pointing to pin configuration nodes

14 for PWM module.

15 For Pinctrl properties, please refer to [1].

16 - clock-names: Valid entries are "pwm" and/or "capture".

17 - clocks: phandle of the clock used by the PWM module.

18 For Clk properties, please refer to [2].

19 - interrupts: IRQ for the Capture device

21 Optional properties:

22 - st,pwm-num-chan: Number of available PWM channels. Default is 0.

23 - st,capture-num-chan: Number of available Capture channels. Default is 0.

25 [1] Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt

26 [2] Documentation/devicetree/bindings/clock/clock-bindings.txt

28 Example:

30 pwm1: pwm@fe510000 {

31 compatible = "st,pwm";

32 reg = <0xfe510000 0x68>;

33 #pwm-cells = <2>;

34 pinctrl-names = "default";

35 pinctrl-0 = <&pinctrl_pwm1_chan0_default

36 &pinctrl_pwm1_chan1_default

37 &pinctrl_pwm1_chan2_default

38 &pinctrl_pwm1_chan3_default>;

39 clocks = <&clk_sysin>;

40 clock-names = "pwm";

41 st,pwm-num-chan = <4>;

42 st,capture-num-chan = <2>;

43 };

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

필수·선택 property

1-27

ST PWM controller의 필수 `compatible`은 `st,pwm`입니다. `#pwm-cells` 첫 cell은 per-chip PWM index, 두 번째는 ns 단위 period이며 STiH41x에서는 cell 수가 2로 고정됩니다. `reg`, 기본 pinctrl, PWM module clock과 이름 `pwm` 또는 `capture`, capture IRQ가 필요합니다. 선택 `st,pwm-num-chan`과 `st,capture-num-chan`은 사용 가능한 channel 수이며 기본값은 0입니다. Pinctrl은 `Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt`, clock은 `Documentation/devicetree/bindings/clock/clock-bindings.txt`의 형식을 참조합니다.

Device-tree 예제

28-43

예제는 네 PWM channel과 두 capture channel, 네 pin configuration과 system-input clock을 지정합니다.

pwm1: pwm@fe510000 {
        compatible = "st,pwm";
        reg = <0xfe510000 0x68>;
        #pwm-cells = <2>;
        pinctrl-names = "default";
        pinctrl-0 = <&pinctrl_pwm1_chan0_default
                     &pinctrl_pwm1_chan1_default
                     &pinctrl_pwm1_chan2_default
                     &pinctrl_pwm1_chan3_default>;
        clocks = <&clk_sysin>;
        clock-names = "pwm";
        st,pwm-num-chan = <4>;
        st,capture-num-chan = <2>;
};