NXP SC18IS I2C-to-SPI bridge | Linux 6.18.37

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

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 <[email protected]>

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. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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>;
    };
};