LSI Axxia I2C | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

i2c-axxia.txt:1-30

Clock provider와 100/400 kHz bus mode를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 LSI Axxia I2C

3 Required properties :

4 - compatible : Must be "lsi,api2c"

5 - reg : Offset and length of the register set for the device

6 - interrupts : the interrupt specifier

7 - #address-cells : Must be <1>;

8 - #size-cells : Must be <0>;

9 - clock-names : Must contain "i2c".

10 - clocks: Must contain an entry for each name in clock-names. See the common

11 clock bindings.

13 Optional properties :

14 - clock-frequency : Desired I2C bus clock frequency in Hz. If not specified,

15 the default 100 kHz frequency will be used. As only Normal and Fast modes

16 are supported, possible values are 100000 and 400000.

18 Example :

20 i2c@2010084000 {

21 compatible = "lsi,api2c";

22 device_type = "i2c";

23 #address-cells = <1>;

24 #size-cells = <0>;

25 reg = <0x20 0x10084000 0x00 0x1000>;

26 interrupts = <0 19 4>;

27 clocks = <&clk_per>;

28 clock-names = "i2c";

29 clock-frequency = <400000>;

30 };

3. 한국어 전문 번역

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

LSI Axxia I2C 속성

1-17

LSI Axxia I2C controller의 필수 `compatible`은 `lsi,api2c`, `reg`는 register set의 offset과 length, `interrupts`는 interrupt specifier입니다. `#address-cells`는 1, `#size-cells`는 0입니다.

`clock-names`에는 `i2c`가 있어야 하고 `clocks`는 common clock binding에 따라 각 이름의 clock entry를 제공해야 합니다. 선택 `clock-frequency`는 Hz 단위 bus frequency입니다. 생략하면 100 kHz를 사용하며 Normal/Fast mode만 지원하므로 가능한 값은 100000 또는 400000입니다.

Axxia I2C clock mode

ModeFrequency

Normal100000 Hz (default)

Fast400000 Hz

지원 bus mode와 `clock-frequency` 값을 정리합니다.

Axxia Fast-mode 예제

18-30

예제는 peripheral clock `clk_per`, interrupt 19와 400 kHz Fast-mode bus를 사용합니다.

i2c@2010084000 {
        compatible = "lsi,api2c";
        device_type = "i2c";
        #address-cells = <1>;
        #size-cells = <0>;
        reg = <0x20 0x10084000 0x00 0x1000>;
        interrupts = <0 19 4>;
        clocks = <&clk_per>;
        clock-names = "i2c";
        clock-frequency = <400000>;
};