Texas Instruments WL1251

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

1. 요약·해설

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

요약과 해설

ti,wl1251.txt:1-64

두 bus 연결 방식의 전원·interrupt 차이를 비교합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 * Texas Instruments wl1251 wireless lan controller

3 The wl1251 chip can be connected via SPI or via SDIO. This

4 document describes the binding for the SPI connected chip.

6 Required properties:

7 - compatible : Should be "ti,wl1251"

8 - reg : Chip select address of device

9 - spi-max-frequency : Maximum SPI clocking speed of device in Hz

10 - interrupts : Should contain interrupt line

11 - vio-supply : phandle to regulator providing VIO

13 Optional properties:

14 - ti,wl1251-has-eeprom : boolean, the wl1251 has an eeprom connected, which

15 provides configuration data (calibration, MAC, ...)

16 - ti,power-gpio : GPIO connected to chip's PMEN pin if operated in

17 SPI mode

18 - Please consult Documentation/devicetree/bindings/spi/spi-bus.txt

19 for optional SPI connection related properties,

21 Examples:

23 &spi1 {

24 wl1251@0 {

25 compatible = "ti,wl1251";

27 reg = <0>;

28 spi-max-frequency = <48000000>;

29 spi-cpol;

30 spi-cpha;

32 interrupt-parent = <&gpio2>;

33 interrupts = <10 IRQ_TYPE_NONE>; /* gpio line 42 */

35 vio-supply = <&vio>;

36 ti,power-gpio = <&gpio3 23 GPIO_ACTIVE_HIGH>; /* 87 */

37 };

38 };

40 &mmc3 {

41 vmmc-supply = <&wlan_en>;

43 bus-width = <4>;

44 non-removable;

45 ti,non-removable;

46 cap-power-off-card;

48 pinctrl-names = "default";

49 pinctrl-0 = <&mmc3_pins>;

51 #address-cells = <1>;

52 #size-cells = <0>;

54 wlan: wifi@1 {

55 compatible = "ti,wl1251";

57 reg = <1>;

59 interrupt-parent = <&gpio1>;

60 interrupts = <21 IRQ_TYPE_LEVEL_HIGH>; /* GPIO_21 */

62 ti,wl1251-has-eeprom;

63 };

64 };

3. 한국어 전문 번역

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

1-5

WL1251 wireless LAN controller는 SPI 또는 SDIO로 연결할 수 있습니다. 이 문서는 주로 SPI 연결 chip의 binding을 설명합니다.

WL1251 속성

6-20

필수 `compatible`은 `ti,wl1251`, `reg`는 device chip select address, `spi-max-frequency`는 Hz 단위 최대 SPI clock, `interrupts`는 interrupt line입니다. `vio-supply`는 VIO를 공급하는 regulator phandle입니다.

선택 boolean `ti,wl1251-has-eeprom`은 calibration, MAC 같은 configuration data를 제공하는 EEPROM이 연결되었음을 뜻합니다. SPI mode에서 `ti,power-gpio`는 chip의 PMEN pin에 연결된 GPIO입니다.

그 밖의 선택 SPI connection 속성은 `Documentation/devicetree/bindings/spi/spi-bus.txt`를 참조합니다.

SPI 연결 예제

21-39

SPI 예제는 chip select 0, 48MHz, CPOL/CPHA mode, GPIO line 42의 interrupt와 VIO regulator를 사용합니다. PMEN은 active-high GPIO 87에 연결됩니다.

&spi1 {
        wl1251@0 {
                compatible = "ti,wl1251";

                reg = <0>;
                spi-max-frequency = <48000000>;
                spi-cpol;
                spi-cpha;

                interrupt-parent = <&gpio2>;
                interrupts = <10 IRQ_TYPE_NONE>; /* gpio line 42 */

                vio-supply = <&vio>;
                ti,power-gpio = <&gpio3 23 GPIO_ACTIVE_HIGH>; /* 87 */
        };
};

SDIO 연결 예제

40-64

SDIO 예제는 4-bit non-removable MMC 장치로 전원을 suspend 중 유지하지 않고 card power-off를 지원합니다. 주소 1의 WLAN은 GPIO 21 high-level interrupt와 연결 EEPROM을 사용합니다.

&mmc3 {
        vmmc-supply = <&wlan_en>;

        bus-width = <4>;
        non-removable;
        ti,non-removable;
        cap-power-off-card;

        pinctrl-names = "default";
        pinctrl-0 = <&mmc3_pins>;

        #address-cells = <1>;
        #size-cells = <0>;

        wlan: wifi@1 {
                compatible = "ti,wl1251";

                reg = <1>;

                interrupt-parent = <&gpio1>;
                interrupts = <21 IRQ_TYPE_LEVEL_HIGH>;        /* GPIO_21 */

                ti,wl1251-has-eeprom;
        };
};