Freescale Global Utilities Block | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

guts.txt:1-44

SoC control과 DMA subsystem의 역할 및 device tree 속성을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 * Global Utilities Block

3 The global utilities block controls power management, I/O device

4 enabling, power-on-reset configuration monitoring, general-purpose

5 I/O signal configuration, alternate function selection for multiplexed

6 signals, and clock control.

8 Required properties:

10 - compatible : Should define the compatible device type for

11 global-utilities.

12 Possible compatibles:

13 "fsl,qoriq-device-config-1.0"

14 "fsl,qoriq-device-config-2.0"

15 "fsl,<chip>-device-config"

16 "fsl,<chip>-guts"

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

19 Recommended properties:

21 - fsl,has-rstcr : Indicates that the global utilities register set

22 contains a functioning "reset control register" (i.e. the board

23 is wired to reset upon setting the HRESET_REQ bit in this register).

25 - fsl,liodn-bits : Indicates the number of defined bits in the LIODN

26 registers, for those SOCs that have a PAMU device.

28 - little-endian : Indicates that the global utilities block is little

29 endian. The default is big endian.

31 Examples:

32 global-utilities@e0000 { /* global utilities block */

33 compatible = "fsl,mpc8548-guts";

34 reg = <e0000 1000>;

35 fsl,has-rstcr;

36 };

38 guts: global-utilities@e0000 {

39 compatible = "fsl,qoriq-device-config-1.0";

40 reg = <0xe0000 0xe00>;

41 fsl,has-rstcr;

42 #sleep-cells = <1>;

43 fsl,liodn-bits = <12>;

44 };

3. 한국어 전문 번역

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

Global Utilities Block 개요

1-7

Global Utilities Block은 power management, I/O device 활성화, power-on-reset configuration 감시, 범용 I/O signal 구성, multiplexed signal의 alternate function 선택, clock control을 담당합니다.

필수 속성

8-18

`compatible`은 global utilities의 장치 형식을 정의하며 `fsl,qoriq-device-config-1.0`, `fsl,qoriq-device-config-2.0`, `fsl,<chip>-device-config`, `fsl,<chip>-guts` 가운데 해당 값을 사용합니다.

`reg`는 장치 register set의 offset과 길이입니다.

권장 속성

19-30

`fsl,has-rstcr`는 Global Utilities register set에 동작하는 reset control register가 있음을 뜻합니다. 즉 이 register의 `HRESET_REQ` bit를 설정하면 board가 reset되도록 배선되어 있습니다.

`fsl,liodn-bits`는 PAMU 장치가 있는 SoC에서 LIODN register에 정의된 bit 수를 나타냅니다. `little-endian`은 block이 little-endian임을 표시하며 기본값은 big-endian입니다.

MPC8548와 QorIQ 예제

31-44

첫 예제는 MPC8548 GUTS의 reset control을, 둘째 예제는 QorIQ device configuration 1.0의 sleep cell과 12개 LIODN bit를 정의합니다.

global-utilities@e0000 {        /* global utilities block */
        compatible = "fsl,mpc8548-guts";
        reg = <e0000 1000>;
        fsl,has-rstcr;
};

guts: global-utilities@e0000 {
        compatible = "fsl,qoriq-device-config-1.0";
        reg = <0xe0000 0xe00>;
        fsl,has-rstcr;
        #sleep-cells = <1>;
        fsl,liodn-bits = <12>;
};