Qualcomm IMEM memory region

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

1. 요약·해설

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

요약과 해설

qcom,imem.yaml:1-99

Qualcomm IMEM의 SoC compatible, reboot mode, PIL relocation region을 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·symbol·source path·수치·예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause

2 %YAML 1.2

3 ---

4 $id: http://devicetree.org/schemas/sram/qcom,imem.yaml#

5 $schema: http://devicetree.org/meta-schemas/core.yaml#

7 title: Qualcomm IMEM memory region

9 maintainers:

10 - Bjorn Andersson <bjorn.andersson@linaro.org>

12 description:

13 Qualcomm IMEM is dedicated memory region for various debug features and DMA

14 transactions.

16 properties:

17 compatible:

18 items:

19 - enum:

20 - qcom,apq8064-imem

21 - qcom,ipq5424-imem

22 - qcom,msm8226-imem

23 - qcom,msm8974-imem

24 - qcom,msm8976-imem

25 - qcom,qcs404-imem

26 - qcom,qcs615-imem

27 - qcom,qcs8300-imem

28 - qcom,qdu1000-imem

29 - qcom,sa8775p-imem

30 - qcom,sar2130p-imem

31 - qcom,sc7180-imem

32 - qcom,sc7280-imem

33 - qcom,sc8280xp-imem

34 - qcom,sdm630-imem

35 - qcom,sdm845-imem

36 - qcom,sdx55-imem

37 - qcom,sdx65-imem

38 - qcom,sdx75-imem

39 - qcom,sm6115-imem

40 - qcom,sm6125-imem

41 - qcom,sm6350-imem

42 - qcom,sm6375-imem

43 - qcom,sm7150-imem

44 - qcom,sm8150-imem

45 - qcom,sm8250-imem

46 - qcom,sm8350-imem

47 - qcom,sm8450-imem

48 - qcom,sm8550-imem

49 - qcom,sm8650-imem

50 - qcom,sm8750-imem

51 - qcom,x1e80100-imem

52 - const: syscon

53 - const: simple-mfd

55 reg:

56 maxItems: 1

58 ranges: true

60 '#address-cells':

61 const: 1

63 '#size-cells':

64 const: 1

66 reboot-mode:

67 $ref: /schemas/power/reset/syscon-reboot-mode.yaml#

69 patternProperties:

70 "^pil-reloc@[0-9a-f]+$":

71 $ref: /schemas/remoteproc/qcom,pil-info.yaml#

72 description: Peripheral image loader relocation region

74 required:

75 - compatible

76 - reg

78 additionalProperties: false

80 examples:

81 - |

82 soc {

83 #address-cells = <2>;

84 #size-cells = <2>;

86 sram@146bf000 {

87 compatible = "qcom,sdm845-imem", "syscon", "simple-mfd";

88 reg = <0 0x146bf000 0 0x1000>;

89 ranges = <0 0 0x146bf000 0x1000>;

91 #address-cells = <1>;

92 #size-cells = <1>;

94 pil-reloc@94c {

95 compatible = "qcom,pil-reloc-info";

96 reg = <0x94c 0xc8>;

97 };

98 };

99 };

100

3. 한국어 전문 번역

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

1-15

이 GPL-2.0-only 또는 BSD-2-Clause YAML schema는 Qualcomm IMEM memory region을 정의합니다. Maintainer는 Bjorn Andersson입니다. IMEM은 여러 debug feature와 DMA transaction을 위한 전용 memory region입니다.

SoC compatible 목록

16-54

SoC compatible은 `qcom,apq8064-imem`, `qcom,ipq5424-imem`, `qcom,msm8226-imem`, `qcom,msm8974-imem`, `qcom,msm8976-imem`, `qcom,qcs404-imem`, `qcom,qcs615-imem`, `qcom,qcs8300-imem`, `qcom,qdu1000-imem`, `qcom,sa8775p-imem`, `qcom,sar2130p-imem`, `qcom,sc7180-imem`, `qcom,sc7280-imem`, `qcom,sc8280xp-imem`입니다.

또한 `qcom,sdm630-imem`, `qcom,sdm845-imem`, `qcom,sdx55-imem`, `qcom,sdx65-imem`, `qcom,sdx75-imem`, `qcom,sm6115-imem`, `qcom,sm6125-imem`, `qcom,sm6350-imem`, `qcom,sm6375-imem`, `qcom,sm7150-imem`, `qcom,sm8150-imem`, `qcom,sm8250-imem`, `qcom,sm8350-imem`, `qcom,sm8450-imem`, `qcom,sm8550-imem`, `qcom,sm8650-imem`, `qcom,sm8750-imem`, `qcom,x1e80100-imem`을 지원합니다. 뒤에는 `syscon`, `simple-mfd`를 차례로 함께 지정합니다.

주소 공간과 PIL relocation child

55-73

`reg`는 최대 한 항목이고 `ranges`를 사용합니다. `#address-cells`와 `#size-cells`는 모두 1입니다. `reboot-mode`는 `/schemas/power/reset/syscon-reboot-mode.yaml#`을 따릅니다.

`^pil-reloc@[0-9a-f]+$` child는 `/schemas/remoteproc/qcom,pil-info.yaml#`을 따르며 Peripheral Image Loader relocation region을 나타냅니다.

필수 속성과 추가 속성 제한

74-79

필수 속성은 `compatible`, `reg`이며 `additionalProperties: false`로 정의하지 않은 추가 속성을 금지합니다.

SDM845 IMEM과 PIL relocation 예제

80-99

예제는 SDM845 IMEM을 `syscon`, `simple-mfd`로 구성하고 0x146bf000의 0x1000-byte 영역을 매핑합니다. Child `pil-reloc@94c`는 `qcom,pil-reloc-info` compatible과 0x94c부터 0xc8 크기의 region을 사용합니다.

soc {
    #address-cells = <2>;
    #size-cells = <2>;

    sram@146bf000 {
        compatible = "qcom,sdm845-imem", "syscon", "simple-mfd";
        reg = <0 0x146bf000 0 0x1000>;
        ranges = <0 0 0x146bf000 0x1000>;

        #address-cells = <1>;
        #size-cells = <1>;

        pil-reloc@94c {
            compatible = "qcom,pil-reloc-info";
            reg = <0x94c 0xc8>;
        };
    };
};