요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Micrel PHY properties.
These properties cover the base properties Micrel PHYs.
Optional properties:
- micrel,led-mode : LED mode value to set for PHYs with configurable LEDs.
Configure the LED mode with single value. The list of PHYs and the
bits that are currently supported:
KSZ8001: register 0x1e, bits 15..14
KSZ8041: register 0x1e, bits 15..14
KSZ8021: register 0x1f, bits 5..4
KSZ8031: register 0x1f, bits 5..4
KSZ8051: register 0x1f, bits 5..4
KSZ8081: register 0x1f, bits 5..4
KSZ8091: register 0x1f, bits 5..4
LAN8814: register EP5.0, bit 6
See the respective PHY datasheet for the mode values.
- micrel,rmii-reference-clock-select-25-mhz: RMII Reference Clock Select
bit selects 25 MHz mode
Setting the RMII Reference Clock Select bit enables 25 MHz rather
than 50 MHz clock mode.
Note that this option is only needed for certain PHY revisions with a
non-standard, inverted function of this configuration bit.
Specifically, a clock reference ("rmii-ref" below) is always needed to
actually select a mode.
- clocks, clock-names: contains clocks according to the common clock bindings.
supported clocks:
- KSZ8021, KSZ8031, KSZ8081, KSZ8091: "rmii-ref": The RMII reference
input clock. Used to determine the XI input clock.
- micrel,fiber-mode: If present the PHY is configured to operate in fiber mode
Some PHYs, such as the KSZ8041FTL variant, support fiber mode, enabled
by the FXEN boot strapping pin. It can't be determined from the PHY
registers whether the PHY is in fiber mode, so this boolean device tree
property can be used to describe it.
In fiber mode, auto-negotiation is disabled and the PHY can only work in
100base-fx (full and half duplex) modes.
- coma-mode-gpios: If present the given gpio will be deasserted when the
PHY is probed.
Some PHYs have a COMA mode input pin which puts the PHY into
isolate and power-down mode. On some boards this input is connected
to a GPIO of the SoC.
Supported on the LAN8814.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Micrel PHY LED mode
1-21이 문서는 Micrel PHY의 공통 속성을 설명합니다. 선택 `micrel,led-mode`는 configurable LED를 가진 PHY에 단일 LED mode 값을 설정합니다. Mode 값은 각 PHY datasheet를 참조합니다.
원문이 지원하는 PHY별 register와 bit field를 구조화했습니다.
RMII reference clock 선택
22-39선택 `micrel,rmii-reference-clock-select-25-mhz`는 RMII Reference Clock Select bit를 설정해 50MHz 대신 25MHz clock mode를 enable합니다.
이 속성은 configuration bit 기능이 비표준으로 반전된 일부 PHY revision에만 필요합니다. 실제 mode를 선택하려면 언제나 `rmii-ref` clock reference가 있어야 합니다.
`clocks`와 `clock-names`는 common clock binding에 따른 clock을 담습니다. KSZ8021, KSZ8031, KSZ8081, KSZ8091은 XI input clock 판단에 사용하는 RMII reference input clock 이름 `rmii-ref`를 지원합니다.
Fiber mode
40-49Boolean `micrel,fiber-mode`가 있으면 PHY를 fiber mode로 구성합니다. KSZ8041FTL 같은 PHY는 FXEN boot strapping pin으로 fiber mode를 enable하지만 PHY register만으로는 이 mode인지 판단할 수 없으므로 Device Tree 속성으로 기술합니다.
Fiber mode에서는 auto-negotiation이 disable되며 PHY는 100base-fx full-duplex 또는 half-duplex mode로만 동작할 수 있습니다.
COMA mode GPIO
50-57`coma-mode-gpios`가 있으면 PHY probe 때 지정 GPIO를 deassert합니다. 일부 PHY의 COMA input pin은 PHY를 isolate 및 power-down mode로 전환하며 board에 따라 SoC GPIO에 연결됩니다. 이 속성은 LAN8814에서 지원합니다.
요약과 해설
micrel.txt:1-57PHY별 LED field와 board가 명시해야 하는 mode 정보를 정리합니다.