Microchip LAN78xx

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

1. 요약·해설

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

요약과 해설

microchip,lan78xx.txt:1-53

Raspberry Pi 3 B+의 USB hub 계층과 LED mode 구성을 해설합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Microchip LAN78xx Gigabit Ethernet controller

3 The LAN78XX devices are usually configured by programming their OTP or with

4 an external EEPROM, but some platforms (e.g. Raspberry Pi 3 B+) have neither.

5 The Device Tree properties, if present, override the OTP and EEPROM.

7 Required properties:

8 - compatible: Should be one of "usb424,7800", "usb424,7801" or "usb424,7850".

10 The MAC address will be determined using the optional properties

11 defined in ethernet.txt.

13 Optional properties of the embedded PHY:

14 - microchip,led-modes: a 0..4 element vector, with each element configuring

15 the operating mode of an LED. Omitted LEDs are turned off. Allowed values

16 are defined in "include/dt-bindings/net/microchip-lan78xx.h".

18 Example:

20 /* Based on the configuration for a Raspberry Pi 3 B+ */

21 &usb {

22 usb-port@1 {

23 compatible = "usb424,2514";

24 reg = <1>;

25 #address-cells = <1>;

26 #size-cells = <0>;

28 usb-port@1 {

29 compatible = "usb424,2514";

30 reg = <1>;

31 #address-cells = <1>;

32 #size-cells = <0>;

34 ethernet: ethernet@1 {

35 compatible = "usb424,7800";

36 reg = <1>;

37 local-mac-address = [ 00 11 22 33 44 55 ];

39 mdio {

40 #address-cells = <0x1>;

41 #size-cells = <0x0>;

42 eth_phy: ethernet-phy@1 {

43 reg = <1>;

44 microchip,led-modes = <

45 LAN78XX_LINK_1000_ACTIVITY

46 LAN78XX_LINK_10_100_ACTIVITY

47 >;

48 };

49 };

50 };

51 };

52 };

53 };

3. 한국어 전문 번역

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

1-12

LAN78xx Gigabit Ethernet controller는 보통 OTP programming 또는 external EEPROM으로 구성하지만 Raspberry Pi 3 B+ 같은 일부 platform에는 둘 다 없습니다. Device Tree 속성이 있으면 OTP와 EEPROM 값을 override합니다.

필수 `compatible`은 `usb424,7800`, `usb424,7801`, `usb424,7850` 중 하나입니다. MAC address는 `ethernet.txt`가 정의한 선택 속성으로 결정합니다.

내장 PHY LED mode

13-17

내장 PHY의 선택 `microchip,led-modes`는 0개부터 4개 원소를 가진 vector이며 각 원소가 LED operating mode를 구성합니다. 생략한 LED는 꺼집니다. 허용값은 `include/dt-bindings/net/microchip-lan78xx.h`에 정의되어 있습니다.

Raspberry Pi 3 B+ 예제

18-53

예제는 두 단계 USB hub port 아래 주소 1의 LAN7800과 local MAC address를 두고, MDIO 주소 1의 내장 PHY LED 두 개를 각각 1000M activity와 10/100M activity mode로 설정합니다.

/* Based on the configuration for a Raspberry Pi 3 B+ */
&usb {
        usb-port@1 {
                compatible = "usb424,2514";
                reg = <1>;
                #address-cells = <1>;
                #size-cells = <0>;

                usb-port@1 {
                        compatible = "usb424,2514";
                        reg = <1>;
                        #address-cells = <1>;
                        #size-cells = <0>;

                        ethernet: ethernet@1 {
                                compatible = "usb424,7800";
                                reg = <1>;
                                local-mac-address = [ 00 11 22 33 44 55 ];

                                mdio {
                                        #address-cells = <0x1>;
                                        #size-cells = <0x0>;
                                        eth_phy: ethernet-phy@1 {
                                                reg = <1>;
                                                microchip,led-modes = <
                                                        LAN78XX_LINK_1000_ACTIVITY
                                                        LAN78XX_LINK_10_100_ACTIVITY
                                                >;
                                        };
                                };
                        };
                };
        };
};