NXP SC18IS I2C-to-SPI bridge | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

nxp,sc18is.yaml:1-51

SC18IS602/603 bridge의 compatible과 external oscillator 조건을 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·phandle·clock/DMA 순서·수치·예제 코드를 원형대로 유지합니다.

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/spi/nxp,sc18is.yaml#

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

7 title: NXP SC18IS602/SC18IS603 I2C to SPI bridge

9 maintainers:

10 - Frank Li <Frank.Li@nxp.com>

12 properties:

13 compatible:

14 enum:

15 - nxp,sc18is602

16 - nxp,sc18is602b

17 - nxp,sc18is603

19 reg:

20 maxItems: 1

22 clock-frequency:

23 $ref: /schemas/types.yaml#/definitions/uint32

24 default: 7372000

25 description:

26 external oscillator clock frequency. The clock-frequency property is

27 relevant and needed only if the chip has an external oscillator

28 (SC18IS603).

30 allOf:

31 - $ref: spi-controller.yaml#

33 unevaluatedProperties: false

35 required:

36 - compatible

37 - reg

39 examples:

40 - |

41 i2c {

42 #address-cells = <1>;

43 #size-cells = <0>;

45 spi@28 {

46 compatible = "nxp,sc18is603";

47 reg = <0x28>;

48 clock-frequency = <14744000>;

49 };

50 };

3. 한국어 전문 번역

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

SC18IS I2C-to-SPI bridge schema

1-11

이 GPL-2.0-only 또는 BSD-2-Clause YAML schema는 NXP SC18IS602/SC18IS603 I2C-to-SPI bridge를 정의합니다. Schema ID는 `http://devicetree.org/schemas/spi/nxp,sc18is.yaml#`, maintainer는 Frank Li입니다.

Compatible과 external oscillator

12-29

허용 compatible은 `nxp,sc18is602`, `nxp,sc18is602b`, `nxp,sc18is603`입니다. `reg`는 최대 한 항목입니다.

`clock-frequency`는 external oscillator 주파수를 지정하는 `uint32`이고 기본값은 `7372000`Hz입니다. 이 속성은 external oscillator를 갖는 SC18IS603에서만 관련되고 필요합니다.

공통 schema와 필수 속성

30-38

`spi-controller.yaml#`을 상속하고 `unevaluatedProperties: false`로 평가되지 않은 추가 속성을 금지합니다. 필수 속성은 `compatible`, `reg`입니다.

SC18IS603 bridge 예제

39-51

예제는 I2C address `0x28`의 SC18IS603 bridge에 14.744MHz external oscillator를 지정합니다.

i2c {
    #address-cells = <1>;
    #size-cells = <0>;

    spi@28 {
        compatible = "nxp,sc18is603";
        reg = <0x28>;
        clock-frequency = <14744000>;
    };
};