MPC5121 PSC | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

mpc5121-psc.txt:1-78

PSC mode별 compatible, FIFO slice 크기, interrupt tuple과 clock property를 PSC0·PSC1 예제로 연결합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 MPC5121 PSC Device Tree Bindings

3 PSC in UART mode

4 ----------------

6 For PSC in UART mode the needed PSC serial devices

7 are specified by fsl,mpc5121-psc-uart nodes in the

8 fsl,mpc5121-immr SoC node. Additionally the PSC FIFO

9 Controller node fsl,mpc5121-psc-fifo is required there:

11 fsl,mpc512x-psc-uart nodes

12 --------------------------

14 Required properties :

15 - compatible : Should contain "fsl,<soc>-psc-uart" and "fsl,<soc>-psc"

16 Supported <soc>s: mpc5121, mpc5125

17 - reg : Offset and length of the register set for the PSC device

18 - interrupts : <a b> where a is the interrupt number of the

19 PSC FIFO Controller and b is a field that represents an

20 encoding of the sense and level information for the interrupt.

22 Recommended properties :

23 - fsl,rx-fifo-size : the size of the RX fifo slice (a multiple of 4)

24 - fsl,tx-fifo-size : the size of the TX fifo slice (a multiple of 4)

26 PSC in SPI mode

27 ---------------

29 Similar to the UART mode a PSC can be operated in SPI mode. The compatible used

30 for that is fsl,mpc5121-psc-spi. It requires a fsl,mpc5121-psc-fifo as well.

31 The required and recommended properties are identical to the

32 fsl,mpc5121-psc-uart nodes, just use spi instead of uart in the compatible

33 string.

35 fsl,mpc512x-psc-fifo node

36 -------------------------

38 Required properties :

39 - compatible : Should be "fsl,<soc>-psc-fifo"

40 Supported <soc>s: mpc5121, mpc5125

41 - reg : Offset and length of the register set for the PSC

42 FIFO Controller

43 - interrupts : <a b> where a is the interrupt number of the

44 PSC FIFO Controller and b is a field that represents an

45 encoding of the sense and level information for the interrupt.

47 Recommended properties :

48 - clocks : specifies the clock needed to operate the fifo controller

49 - clock-names : name(s) for the clock(s) listed in clocks

51 Example for a board using PSC0 and PSC1 devices in serial mode:

53 serial@11000 {

54 compatible = "fsl,mpc5121-psc-uart", "fsl,mpc5121-psc";

55 cell-index = <0>;

56 reg = <0x11000 0x100>;

57 interrupts = <40 0x8>;

58 interrupt-parent = < &ipic >;

59 fsl,rx-fifo-size = <16>;

60 fsl,tx-fifo-size = <16>;

61 };

63 serial@11100 {

64 compatible = "fsl,mpc5121-psc-uart", "fsl,mpc5121-psc";

65 cell-index = <1>;

66 reg = <0x11100 0x100>;

67 interrupts = <40 0x8>;

68 interrupt-parent = < &ipic >;

69 fsl,rx-fifo-size = <16>;

70 fsl,tx-fifo-size = <16>;

71 };

73 pscfifo@11f00 {

74 compatible = "fsl,mpc5121-psc-fifo";

75 reg = <0x11f00 0x100>;

76 interrupts = <40 0x8>;

77 interrupt-parent = < &ipic >;

78 };

3. 한국어 전문 번역

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

MPC5121 PSC와 UART mode

1-10

MPC5121 PSC를 UART mode로 사용할 때 필요한 PSC serial device는 `fsl,mpc5121-immr` SoC node 안의 `fsl,mpc5121-psc-uart` node로 지정합니다. 같은 SoC node 안에 `fsl,mpc5121-psc-fifo` PSC FIFO Controller node도 필요합니다.

PSC UART node

11-25

`fsl,mpc512x-psc-uart` node의 필수 `compatible`에는 `fsl,<soc>-psc-uart`와 `fsl,<soc>-psc`가 모두 들어가야 합니다. 지원하는 `<soc>`는 `mpc5121`과 `mpc5125`입니다. 필수 `reg`는 PSC device register set의 offset과 length를 지정합니다.

필수 `interrupts`는 `<a b>` 형식입니다. a는 PSC FIFO Controller의 interrupt 번호이고 b는 interrupt의 sense와 level 정보를 encode한 field입니다.

권장 `fsl,rx-fifo-size`는 RX FIFO slice 크기, `fsl,tx-fifo-size`는 TX FIFO slice 크기이며 둘 다 4의 배수여야 합니다.

PSC SPI mode

26-34

PSC는 UART mode와 비슷하게 SPI mode로도 동작할 수 있습니다. 이때 `compatible`은 `fsl,mpc5121-psc-spi`이며 `fsl,mpc5121-psc-fifo`도 필요합니다.

필수 property와 권장 property는 `fsl,mpc5121-psc-uart` node와 동일하되 compatible string에서 `uart` 대신 `spi`를 사용합니다.

PSC FIFO Controller node

35-50

`fsl,mpc512x-psc-fifo` node의 필수 `compatible`은 `fsl,<soc>-psc-fifo`이며 지원하는 `<soc>`는 `mpc5121`과 `mpc5125`입니다. 필수 `reg`는 PSC FIFO Controller register set의 offset과 length를 지정합니다.

필수 `interrupts`는 `<a b>` 형식입니다. a는 PSC FIFO Controller interrupt 번호, b는 sense와 level 정보를 encode한 field입니다.

권장 `clocks`는 FIFO controller 동작에 필요한 clock을 지정하고, `clock-names`는 `clocks`에 나열한 clock의 이름을 지정합니다.

PSC0·PSC1 serial mode 예제

51-78

예제는 PSC0과 PSC1을 UART serial device로 선언합니다. 두 node는 cell index와 register offset만 다르고 interrupt 40, IPIC parent, 16-byte RX·TX FIFO slice를 공유합니다. 별도의 `pscfifo@11f00` node가 같은 interrupt와 IPIC parent를 사용해 FIFO Controller를 제공합니다.

serial@11000 {
        compatible = "fsl,mpc5121-psc-uart", "fsl,mpc5121-psc";
        cell-index = <0>;
        reg = <0x11000 0x100>;
        interrupts = <40 0x8>;
        interrupt-parent = < &ipic >;
        fsl,rx-fifo-size = <16>;
        fsl,tx-fifo-size = <16>;
};

serial@11100 {
        compatible = "fsl,mpc5121-psc-uart", "fsl,mpc5121-psc";
        cell-index = <1>;
        reg = <0x11100 0x100>;
        interrupts = <40 0x8>;
        interrupt-parent = < &ipic >;
        fsl,rx-fifo-size = <16>;
        fsl,tx-fifo-size = <16>;
};

pscfifo@11f00 {
        compatible = "fsl,mpc5121-psc-fifo";
        reg = <0x11f00 0x100>;
        interrupts = <40 0x8>;
        interrupt-parent = < &ipic >;
};