Broadcom Cygnus IOMUX

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

1. 요약·해설

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

요약과 해설

brcm,cygnus-pinmux.txt:1-132

지원 peripheral function과 group의 전체 대응을 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Broadcom Cygnus IOMUX Controller

3 The Cygnus IOMUX controller supports group based mux configuration. In

4 addition, certain pins can be muxed to GPIO function individually.

6 Required properties:

8 - compatible:

9 Must be "brcm,cygnus-pinmux"

11 - reg:

12 Define the base and range of the I/O address space that contains the Cygnus

13 IOMUX registers

15 Properties in subnodes:

17 - function:

18 The mux function to select

20 - groups:

21 The list of groups to select with a given function

23 For more details, refer to

24 Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt

26 For example:

28 pinmux: pinmux@0301d0c8 {

29 compatible = "brcm,cygnus-pinmux";

30 reg = <0x0301d0c8 0x1b0>;

32 pinctrl-names = "default";

33 pinctrl-0 = <&i2s0_default>;

35 i2s0_default: i2s0_default {

36 mux {

37 function = "i2s0";

38 groups = "i2s0_0_grp", "i2s0_1_grp";

39 };

40 };

41 };

43 List of supported functions and groups in Cygnus:

45 "i2s0": "i2s0_0_grp", "i2s0_1_grp"

47 "i2s1": "i2s1_0_grp", "i2s1_1_grp"

49 "i2s2": "i2s2_0_grp", "i2s2_1_grp", "i2s2_2_grp", "i2s2_3_grp", "i2s2_4_grp"

51 "spdif": "spdif_grp"

53 "pwm0": "pwm0_grp"

55 "pwm1": "pwm1_grp"

57 "pwm2": "pwm2_grp"

59 "pwm3": "pwm3_grp"

61 "pwm4": "pwm4_grp"

63 "pwm5": "pwm5_grp"

65 "key": "key0_grp", "key1_grp", "key2_grp", "key3_grp", "key4_grp", "key5_grp",

66 "key6_grp", "key7_grp", "key8_grp", "key9_grp", "key10_grp", "key11_grp",

67 "key12_grp", "key13_grp", "key14_grp", "key15_grp"

69 "audio_dte": "audio_dte0_grp", "audio_dte1_grp", "audio_dte2_grp", "audio_dte3_grp"

71 "smart_card0": "smart_card0_grp", "smart_card0_fcb_grp"

73 "smart_card1": "smart_card1_grp", "smart_card1_fcb_grp"

75 "spi0": "spi0_grp"

77 "spi1": "spi1_grp"

79 "spi2": "spi2_grp"

81 "spi3": "spi3_grp"

83 "spi4": "spi4_0_grp", "spi4_1_grp"

85 "spi5": "spi5_grp"

87 "sw_led0": "sw_led0_0_grp", "sw_led0_1_grp"

89 "sw_led1": "sw_led1_grp"

91 "sw_led2": "sw_led2_0_grp", "sw_led2_1_grp"

93 "d1w": "d1w_grp"

95 "lcd": "lcd_grp"

97 "sram": "sram_0_grp", "sram_1_grp"

99 "uart0": "uart0_grp"

100

101 "uart1": "uart1_grp", "uart1_dte_grp"

102

103 "uart2": "uart2_grp"

104

105 "uart3": "uart3_grp"

106

107 "uart4": "uart4_grp"

108

109 "qspi": "qspi_0_grp", "qspi_1_grp"

110

111 "nand": "nand_grp"

112

113 "sdio0": "sdio0_grp", "sdio0_cd_grp", "sdio0_mmc_grp"

114

115 "sdio1": "sdio1_data_0_grp", "sdio1_data_1_grp", "sdio1_cd_grp",

116 "sdio1_led_grp", "sdio1_mmc_grp"

117

118 "can0": "can0_grp"

119

120 "can1": "can1_grp"

121

122 "cam": "cam_led_grp", "cam_0_grp", "cam_1_grp"

123

124 "bsc1": "bsc1_grp"

125

126 "pcie_clkreq": "pcie_clkreq_grp"

127

128 "usb0_oc": "usb0_oc_grp"

129

130 "usb1_oc": "usb1_oc_grp"

131

132 "usb2_oc": "usb2_oc_grp"

133

3. 한국어 전문 번역

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

1-25

Cygnus IOMUX controller는 group 기반 mux 구성을 지원하며 일부 pin은 개별적으로 GPIO function으로 mux할 수 있습니다.

`compatible`은 `brcm,cygnus-pinmux`여야 합니다. `reg`는 Cygnus IOMUX register가 들어 있는 I/O 주소 공간의 base와 range를 정의합니다.

하위 노드의 `function`은 선택할 mux function이고 `groups`는 해당 function으로 선택할 group 목록입니다. 자세한 내용은 `Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt`를 참조하십시오.

Cygnus I2S0 예제

26-42

예제는 IOMUX의 default 상태에서 `i2s0_0_grp`와 `i2s0_1_grp`를 `i2s0` function으로 선택합니다.

pinmux: pinmux@0301d0c8 {
        compatible = "brcm,cygnus-pinmux";
        reg = <0x0301d0c8 0x1b0>;

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

        i2s0_default: i2s0_default {
                mux {
                        function = "i2s0";
                        groups = "i2s0_0_grp", "i2s0_1_grp";
                };
        };
};

Cygnus 지원 function과 group

43-132

Cygnus가 지원하는 I2S, SPDIF, PWM, keypad, audio DTE, smart card, SPI, switch LED, LCD, SRAM, UART, QSPI, NAND, SDIO, CAN, camera, BSC, PCIe clock request, USB overcurrent function과 대응 group 전체는 다음과 같습니다.

"i2s0": "i2s0_0_grp", "i2s0_1_grp"

"i2s1": "i2s1_0_grp", "i2s1_1_grp"

"i2s2": "i2s2_0_grp", "i2s2_1_grp", "i2s2_2_grp", "i2s2_3_grp", "i2s2_4_grp"

"spdif": "spdif_grp"

"pwm0": "pwm0_grp"

"pwm1": "pwm1_grp"

"pwm2": "pwm2_grp"

"pwm3": "pwm3_grp"

"pwm4": "pwm4_grp"

"pwm5": "pwm5_grp"

"key": "key0_grp", "key1_grp", "key2_grp", "key3_grp", "key4_grp", "key5_grp",
"key6_grp", "key7_grp", "key8_grp", "key9_grp", "key10_grp", "key11_grp",
"key12_grp", "key13_grp", "key14_grp", "key15_grp"

"audio_dte": "audio_dte0_grp", "audio_dte1_grp", "audio_dte2_grp", "audio_dte3_grp"

"smart_card0": "smart_card0_grp", "smart_card0_fcb_grp"

"smart_card1": "smart_card1_grp", "smart_card1_fcb_grp"

"spi0": "spi0_grp"

"spi1": "spi1_grp"

"spi2": "spi2_grp"

"spi3": "spi3_grp"

"spi4": "spi4_0_grp", "spi4_1_grp"

"spi5": "spi5_grp"

"sw_led0": "sw_led0_0_grp", "sw_led0_1_grp"

"sw_led1": "sw_led1_grp"

"sw_led2": "sw_led2_0_grp", "sw_led2_1_grp"

"d1w": "d1w_grp"

"lcd": "lcd_grp"

"sram": "sram_0_grp", "sram_1_grp"

"uart0": "uart0_grp"

"uart1": "uart1_grp", "uart1_dte_grp"

"uart2": "uart2_grp"

"uart3": "uart3_grp"

"uart4": "uart4_grp"

"qspi": "qspi_0_grp", "qspi_1_grp"

"nand": "nand_grp"

"sdio0": "sdio0_grp", "sdio0_cd_grp", "sdio0_mmc_grp"

"sdio1": "sdio1_data_0_grp", "sdio1_data_1_grp", "sdio1_cd_grp",
"sdio1_led_grp", "sdio1_mmc_grp"

"can0": "can0_grp"

"can1": "can1_grp"

"cam": "cam_led_grp", "cam_0_grp", "cam_1_grp"

"bsc1": "bsc1_grp"

"pcie_clkreq": "pcie_clkreq_grp"

"usb0_oc": "usb0_oc_grp"

"usb1_oc": "usb1_oc_grp"

"usb2_oc": "usb2_oc_grp"