Octeon TWSI/I2C Controller | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

i2c-octeon.txt:1-40

cn3XXX부터 cn78XX까지의 TWSI controller를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 * Two Wire Serial Interface (TWSI) / I2C

3 - compatible: "cavium,octeon-3860-twsi"

5 Compatibility with all cn3XXX, cn5XXX and cn6XXX SOCs.

7 or

9 compatible: "cavium,octeon-7890-twsi"

11 Compatibility with cn78XX SOCs.

13 - reg: The base address of the TWSI/I2C bus controller register bank.

15 - #address-cells: Must be <1>.

17 - #size-cells: Must be <0>. I2C addresses have no size component.

19 - interrupts: A single interrupt specifier.

21 - clock-frequency: The I2C bus clock rate in Hz.

23 Example:

24 twsi0: i2c@1180000001000 {

25 #address-cells = <1>;

26 #size-cells = <0>;

27 compatible = "cavium,octeon-3860-twsi";

28 reg = <0x11800 0x00001000 0x0 0x200>;

29 interrupts = <0 45>;

30 clock-frequency = <100000>;

32 rtc@68 {

33 compatible = "dallas,ds1337";

34 reg = <0x68>;

35 };

36 tmp@4c {

37 compatible = "ti,tmp421";

38 reg = <0x4c>;

39 };

40 };

3. 한국어 전문 번역

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

Octeon TWSI/I2C 속성

1-22

Two Wire Serial Interface(TWSI)/I2C controller에서 `cavium,octeon-3860-twsi`는 cn3XXX, cn5XXX, cn6XXX SoC와 호환되고, `cavium,octeon-7890-twsi`는 cn78XX SoC와 호환됩니다.

`reg`는 TWSI/I2C controller register bank의 base address입니다. `#address-cells`는 1, I2C address에는 size component가 없으므로 `#size-cells`는 0이어야 합니다. `interrupts`는 단일 interrupt specifier이고 `clock-frequency`는 Hz 단위 I2C bus clock rate입니다.

Octeon TWSI compatible

SoCCompatible

cn3XXX, cn5XXX, cn6XXXcavium,octeon-3860-twsi

cn78XXcavium,octeon-7890-twsi

SoC 세대와 compatible string을 대응시킵니다.

Octeon RTC와 온도 sensor 예제

23-40

예제 controller는 register bank `0x1180000001000`, interrupt 45와 100 kHz bus를 사용합니다. Child에는 address `0x68`의 Dallas DS1337 RTC와 address `0x4c`의 TI TMP421 temperature sensor가 있습니다.

twsi0: i2c@1180000001000 {
        #address-cells = <1>;
        #size-cells = <0>;
        compatible = "cavium,octeon-3860-twsi";
        reg = <0x11800 0x00001000 0x0 0x200>;
        interrupts = <0 45>;
        clock-frequency = <100000>;

        rtc@68 {
                compatible = "dallas,ds1337";
                reg = <0x68>;
        };
        tmp@4c {
                compatible = "ti,tmp421";
                reg = <0x4c>;
        };
};