OpenRISC Generic SoC

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

1. 요약·해설

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

요약과 해설

or1ksim.txt:1-39

CPS topology probe와 r3 Device Tree 전달 규약을 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 OpenRISC Generic SoC

2 ====================

4 Boards and FPGA SoC's which support the OpenRISC standard platform. The

5 platform essentially follows the conventions of the OpenRISC architecture

6 specification, however some aspects, such as the boot protocol have been defined

7 by the Linux port.

9 Required properties

10 -------------------

11 - compatible: Must include "opencores,or1ksim"

13 CPU nodes:

14 ----------

15 A "cpus" node is required. Required properties:

16 - #address-cells: Must be 1.

17 - #size-cells: Must be 0.

18 A CPU sub-node is also required for at least CPU 0. Since the topology may

19 be probed via CPS, it is not necessary to specify secondary CPUs. Required

20 properties:

21 - compatible: Must be "opencores,or1200-rtlsvn481".

22 - reg: CPU number.

23 - clock-frequency: The CPU clock frequency in Hz.

24 Example:

25 cpus {

26 #address-cells = <1>;

27 #size-cells = <0>;

28 cpu@0 {

29 compatible = "opencores,or1200-rtlsvn481";

30 reg = <0>;

31 clock-frequency = <20000000>;

32 };

33 };

36 Boot protocol

37 -------------

38 The bootloader may pass the following arguments to the kernel:

39 - r3: address of a flattened device-tree blob or 0x0.

3. 한국어 전문 번역

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

1-12

OpenRISC standard platform을 지원하는 board와 FPGA SoC를 위한 binding입니다. Platform은 대체로 OpenRISC architecture specification 관례를 따르지만 boot protocol 같은 일부 사항은 Linux port가 정의합니다.

필수 `compatible`에는 `opencores,or1ksim`이 포함되어야 합니다.

OpenRISC CPU node

13-23

`cpus` node가 필수이며 `#address-cells`는 1, `#size-cells`는 0입니다. 최소 CPU 0의 CPU subnode도 필요합니다. CPS로 topology를 probe할 수 있으므로 secondary CPU를 명시할 필요는 없습니다.

CPU subnode의 필수 `compatible`은 `opencores,or1200-rtlsvn481`, `reg`는 CPU number, `clock-frequency`는 Hz 단위 CPU clock입니다.

OpenRISC CPU 예제

24-34

예제는 20MHz로 동작하는 CPU 0 하나를 정의합니다.

cpus {
        #address-cells = <1>;
        #size-cells = <0>;
        cpu@0 {
                compatible = "opencores,or1200-rtlsvn481";
                reg = <0>;
                clock-frequency = <20000000>;
        };
};

OpenRISC boot protocol

35-39

Bootloader는 register `r3`에 flattened Device Tree blob의 주소를 전달할 수 있으며 blob이 없으면 `0x0`을 전달합니다.