요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Binding for dual-GPIO LED found on Network Space v2 (and parents).
Required properties:
- compatible: "lacie,ns2-leds".
Each LED is represented as a sub-node of the ns2-leds device.
Required sub-node properties:
- cmd-gpio: Command LED GPIO. See OF device-tree GPIO specification.
- slow-gpio: Slow LED GPIO. See OF device-tree GPIO specification.
- modes-map: A mapping between LED modes (off, on or SATA activity blinking) and
the corresponding cmd-gpio/slow-gpio values. All the GPIO values combinations
should be given in order to avoid having an unknown mode at driver probe time.
Optional sub-node properties:
- label: Name for this LED. If omitted, the label is taken from the node name.
- linux,default-trigger: Trigger assigned to the LED.
Example:
#include <dt-bindings/leds/leds-ns2.h>
ns2-leds {
compatible = "lacie,ns2-leds";
blue-sata {
label = "ns2:blue:sata";
slow-gpio = <&gpio0 29 0>;
cmd-gpio = <&gpio0 30 0>;
modes-map = <NS_V2_LED_OFF 0 1
NS_V2_LED_ON 1 0
NS_V2_LED_ON 0 0
NS_V2_LED_SATA 1 1>;
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Network Space v2 이중 GPIO LED
1-18이 바인딩은 Network Space v2와 그 상위 제품군에서 볼 수 있는 이중 GPIO LED를 정의합니다. 장치의 필수 `compatible` 값은 `lacie,ns2-leds`이며, 각 LED는 `ns2-leds` 장치 아래의 하위 노드 하나로 표현합니다.
각 LED 하위 노드에는 OF device-tree GPIO 명세를 따르는 command LED GPIO인 `cmd-gpio`와 slow LED GPIO인 `slow-gpio`가 필요합니다. `modes-map`은 LED 모드인 off, on, SATA activity blinking과 그에 대응하는 `cmd-gpio`/`slow-gpio` 값의 조합을 연결합니다. 드라이버 probe 시 알 수 없는 모드가 생기지 않도록 가능한 GPIO 값 조합을 모두 제공해야 합니다.
선택적인 `label`은 LED 이름이며 생략하면 node 이름을 사용합니다. `linux,default-trigger`는 이 LED에 할당할 trigger입니다.
두 GPIO의 모든 조합을 명시해 probe 시 각 상태를 확정합니다.
Blue SATA LED 예제
19-35예제는 `dt-bindings/leds/leds-ns2.h`를 포함하고 `blue-sata` LED를 `ns2:blue:sata`로 표시합니다. GPIO0의 29번은 slow, 30번은 command 신호이며, 네 GPIO 조합을 OFF, 두 ON 표현, SATA activity 모드에 모두 대응시킵니다.
#include <dt-bindings/leds/leds-ns2.h>
ns2-leds {
compatible = "lacie,ns2-leds";
blue-sata {
label = "ns2:blue:sata";
slow-gpio = <&gpio0 29 0>;
cmd-gpio = <&gpio0 30 0>;
modes-map = <NS_V2_LED_OFF 0 1
NS_V2_LED_ON 1 0
NS_V2_LED_ON 0 0
NS_V2_LED_SATA 1 1>;
};
};
요약과 해설
leds-ns2.txt:1-35네 GPIO 조합을 OFF, ON, SATA activity 상태에 빠짐없이 대응시키는 바인딩입니다.