STMicroelectronics PWM | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

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. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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>;
};