mirror of
				https://github.com/Ysurac/openmptcprouter.git
				synced 2025-03-09 15:40:20 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			371 lines
		
	
	
	
		
			11 KiB
		
	
	
	
		
			Diff
		
	
	
	
	
	
			
		
		
	
	
			371 lines
		
	
	
	
		
			11 KiB
		
	
	
	
		
			Diff
		
	
	
	
	
	
| From 4e4c2d695a5daf6dc55b8713af720ef15b52c0e7 Mon Sep 17 00:00:00 2001
 | |
| From: Sean Wang <sean.wang@mediatek.com>
 | |
| Date: Tue, 12 Dec 2017 14:24:18 +0800
 | |
| Subject: [PATCH 169/224] dt-bindings: pinctrl: add bindings for MediaTek
 | |
|  MT7622 SoC
 | |
| 
 | |
| Add devicetree bindings for MediaTek MT7622 pinctrl driver.
 | |
| 
 | |
| Signed-off-by: Sean Wang <sean.wang@mediatek.com>
 | |
| Reviewed-by: Biao Huang <biao.huang@mediatek.com>
 | |
| Acked-by: Rob Herring <robh@kernel.org>
 | |
| Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
 | |
| ---
 | |
|  .../devicetree/bindings/pinctrl/pinctrl-mt7622.txt | 351 +++++++++++++++++++++
 | |
|  1 file changed, 351 insertions(+)
 | |
|  create mode 100644 Documentation/devicetree/bindings/pinctrl/pinctrl-mt7622.txt
 | |
| 
 | |
| --- /dev/null
 | |
| +++ b/Documentation/devicetree/bindings/pinctrl/pinctrl-mt7622.txt
 | |
| @@ -0,0 +1,351 @@
 | |
| +== MediaTek MT7622 pinctrl controller ==
 | |
| +
 | |
| +Required properties for the root node:
 | |
| + - compatible: Should be one of the following
 | |
| +	       "mediatek,mt7622-pinctrl" for MT7622 SoC
 | |
| + - reg: offset and length of the pinctrl space
 | |
| +
 | |
| + - gpio-controller: Marks the device node as a GPIO controller.
 | |
| + - #gpio-cells: Should be two. The first cell is the pin number and the
 | |
| +   second is the GPIO flags.
 | |
| +
 | |
| +Please refer to pinctrl-bindings.txt in this directory for details of the
 | |
| +common pinctrl bindings used by client devices, including the meaning of the
 | |
| +phrase "pin configuration node".
 | |
| +
 | |
| +MT7622 pin configuration nodes act as a container for an arbitrary number of
 | |
| +subnodes. Each of these subnodes represents some desired configuration for a
 | |
| +pin, a group, or a list of pins or groups. This configuration can include the
 | |
| +mux function to select on those pin(s)/group(s), and various pin configuration
 | |
| +parameters, such as pull-up, slew rate, etc.
 | |
| +
 | |
| +We support 2 types of configuration nodes. Those nodes can be either pinmux
 | |
| +nodes or pinconf nodes. Each configuration node can consist of multiple nodes
 | |
| +describing the pinmux and pinconf options.
 | |
| +
 | |
| +The name of each subnode doesn't matter as long as it is unique; all subnodes
 | |
| +should be enumerated and processed purely based on their content.
 | |
| +
 | |
| +== pinmux nodes content ==
 | |
| +
 | |
| +The following generic properties as defined in pinctrl-bindings.txt are valid
 | |
| +to specify in a pinmux subnode:
 | |
| +
 | |
| +Required properties are:
 | |
| + - groups: An array of strings. Each string contains the name of a group.
 | |
| +  Valid values for these names are listed below.
 | |
| + - function: A string containing the name of the function to mux to the
 | |
| +  group. Valid values for function names are listed below.
 | |
| +
 | |
| +== pinconf nodes content ==
 | |
| +
 | |
| +The following generic properties as defined in pinctrl-bindings.txt are valid
 | |
| +to specify in a pinconf subnode:
 | |
| +
 | |
| +Required properties are:
 | |
| + - pins: An array of strings. Each string contains the name of a pin.
 | |
| +  Valid values for these names are listed below.
 | |
| + - groups: An array of strings. Each string contains the name of a group.
 | |
| +  Valid values for these names are listed below.
 | |
| +
 | |
| +Optional properies are:
 | |
| + bias-disable, bias-pull, bias-pull-down, input-enable,
 | |
| + input-schmitt-enable, input-schmitt-disable, output-enable
 | |
| + output-low, output-high, drive-strength, slew-rate
 | |
| +
 | |
| + Valid arguments for 'slew-rate' are '0' for no slew rate controlled and '1' for
 | |
| + slower slew rate respectively.
 | |
| + Valid arguments for 'drive-strength', 4, 8, 12, or 16 in mA.
 | |
| +
 | |
| +The following specific properties as defined are valid to specify in a pinconf
 | |
| +subnode:
 | |
| +
 | |
| +Optional properties are:
 | |
| + - mediatek,tdsel: An integer describing the steps for output level shifter duty
 | |
| +   cycle when asserted (high pulse width adjustment). Valid arguments are from 0
 | |
| +   to 15.
 | |
| + - mediatek,rdsel: An integer describing the steps for input level shifter duty
 | |
| +   cycle when asserted (high pulse width adjustment). Valid arguments are from 0
 | |
| +   to 63.
 | |
| +
 | |
| +== Valid values for pins, function and groups on MT7622 ==
 | |
| +
 | |
| +Valid values for pins are:
 | |
| +pins can be referenced via the pin names as the below table shown and the
 | |
| +related physical number is also put ahead of those names which helps cross
 | |
| +references to pins between groups to know whether pins assignment conflict
 | |
| +happens among devices try to acquire those available pins.
 | |
| +
 | |
| +	Pin #:  Valid values for pins
 | |
| +	-----------------------------
 | |
| +	PIN 0: "GPIO_A"
 | |
| +	PIN 1: "I2S1_IN"
 | |
| +	PIN 2: "I2S1_OUT"
 | |
| +	PIN 3: "I2S_BCLK"
 | |
| +	PIN 4: "I2S_WS"
 | |
| +	PIN 5: "I2S_MCLK"
 | |
| +	PIN 6: "TXD0"
 | |
| +	PIN 7: "RXD0"
 | |
| +	PIN 8: "SPI_WP"
 | |
| +	PIN 9: "SPI_HOLD"
 | |
| +	PIN 10: "SPI_CLK"
 | |
| +	PIN 11: "SPI_MOSI"
 | |
| +	PIN 12: "SPI_MISO"
 | |
| +	PIN 13: "SPI_CS"
 | |
| +	PIN 14: "I2C_SDA"
 | |
| +	PIN 15: "I2C_SCL"
 | |
| +	PIN 16: "I2S2_IN"
 | |
| +	PIN 17: "I2S3_IN"
 | |
| +	PIN 18: "I2S4_IN"
 | |
| +	PIN 19: "I2S2_OUT"
 | |
| +	PIN 20: "I2S3_OUT"
 | |
| +	PIN 21: "I2S4_OUT"
 | |
| +	PIN 22: "GPIO_B"
 | |
| +	PIN 23: "MDC"
 | |
| +	PIN 24: "MDIO"
 | |
| +	PIN 25: "G2_TXD0"
 | |
| +	PIN 26: "G2_TXD1"
 | |
| +	PIN 27: "G2_TXD2"
 | |
| +	PIN 28: "G2_TXD3"
 | |
| +	PIN 29: "G2_TXEN"
 | |
| +	PIN 30: "G2_TXC"
 | |
| +	PIN 31: "G2_RXD0"
 | |
| +	PIN 32: "G2_RXD1"
 | |
| +	PIN 33: "G2_RXD2"
 | |
| +	PIN 34: "G2_RXD3"
 | |
| +	PIN 35: "G2_RXDV"
 | |
| +	PIN 36: "G2_RXC"
 | |
| +	PIN 37: "NCEB"
 | |
| +	PIN 38: "NWEB"
 | |
| +	PIN 39: "NREB"
 | |
| +	PIN 40: "NDL4"
 | |
| +	PIN 41: "NDL5"
 | |
| +	PIN 42: "NDL6"
 | |
| +	PIN 43: "NDL7"
 | |
| +	PIN 44: "NRB"
 | |
| +	PIN 45: "NCLE"
 | |
| +	PIN 46: "NALE"
 | |
| +	PIN 47: "NDL0"
 | |
| +	PIN 48: "NDL1"
 | |
| +	PIN 49: "NDL2"
 | |
| +	PIN 50: "NDL3"
 | |
| +	PIN 51: "MDI_TP_P0"
 | |
| +	PIN 52: "MDI_TN_P0"
 | |
| +	PIN 53: "MDI_RP_P0"
 | |
| +	PIN 54: "MDI_RN_P0"
 | |
| +	PIN 55: "MDI_TP_P1"
 | |
| +	PIN 56: "MDI_TN_P1"
 | |
| +	PIN 57: "MDI_RP_P1"
 | |
| +	PIN 58: "MDI_RN_P1"
 | |
| +	PIN 59: "MDI_RP_P2"
 | |
| +	PIN 60: "MDI_RN_P2"
 | |
| +	PIN 61: "MDI_TP_P2"
 | |
| +	PIN 62: "MDI_TN_P2"
 | |
| +	PIN 63: "MDI_TP_P3"
 | |
| +	PIN 64: "MDI_TN_P3"
 | |
| +	PIN 65: "MDI_RP_P3"
 | |
| +	PIN 66: "MDI_RN_P3"
 | |
| +	PIN 67: "MDI_RP_P4"
 | |
| +	PIN 68: "MDI_RN_P4"
 | |
| +	PIN 69: "MDI_TP_P4"
 | |
| +	PIN 70: "MDI_TN_P4"
 | |
| +	PIN 71: "PMIC_SCL"
 | |
| +	PIN 72: "PMIC_SDA"
 | |
| +	PIN 73: "SPIC1_CLK"
 | |
| +	PIN 74: "SPIC1_MOSI"
 | |
| +	PIN 75: "SPIC1_MISO"
 | |
| +	PIN 76: "SPIC1_CS"
 | |
| +	PIN 77: "GPIO_D"
 | |
| +	PIN 78: "WATCHDOG"
 | |
| +	PIN 79: "RTS3_N"
 | |
| +	PIN 80: "CTS3_N"
 | |
| +	PIN 81: "TXD3"
 | |
| +	PIN 82: "RXD3"
 | |
| +	PIN 83: "PERST0_N"
 | |
| +	PIN 84: "PERST1_N"
 | |
| +	PIN 85: "WLED_N"
 | |
| +	PIN 86: "EPHY_LED0_N"
 | |
| +	PIN 87: "AUXIN0"
 | |
| +	PIN 88: "AUXIN1"
 | |
| +	PIN 89: "AUXIN2"
 | |
| +	PIN 90: "AUXIN3"
 | |
| +	PIN 91: "TXD4"
 | |
| +	PIN 92: "RXD4"
 | |
| +	PIN 93: "RTS4_N"
 | |
| +	PIN 94: "CST4_N"
 | |
| +	PIN 95: "PWM1"
 | |
| +	PIN 96: "PWM2"
 | |
| +	PIN 97: "PWM3"
 | |
| +	PIN 98: "PWM4"
 | |
| +	PIN 99: "PWM5"
 | |
| +	PIN 100: "PWM6"
 | |
| +	PIN 101: "PWM7"
 | |
| +	PIN 102: "GPIO_E"
 | |
| +
 | |
| +Valid values for function are:
 | |
| +	"emmc", "eth", "i2c", "i2s", "ir", "led", "flash", "pcie",
 | |
| +	"pmic", "pwm", "sd", "spi", "tdm", "uart", "watchdog"
 | |
| +
 | |
| +Valid values for groups are:
 | |
| +additional data is put followingly with valid value allowing us to know which
 | |
| +applicable function and which relevant pins (in pin#) are able applied for that
 | |
| +group.
 | |
| +
 | |
| +	Valid value			function	pins (in pin#)
 | |
| +	-------------------------------------------------------------------------
 | |
| +	"emmc"				"emmc"		40, 41, 42, 43, 44, 45,
 | |
| +							47, 48, 49, 50
 | |
| +	"emmc_rst"			"emmc"		37
 | |
| +	"esw"				"eth"		51, 52, 53, 54, 55, 56,
 | |
| +							57, 58, 59, 60, 61, 62,
 | |
| +							63, 64, 65, 66, 67, 68,
 | |
| +							69, 70
 | |
| +	"esw_p0_p1"			"eth"		51, 52, 53, 54, 55, 56,
 | |
| +							57, 58
 | |
| +	"esw_p2_p3_p4"			"eth"		59, 60, 61, 62, 63, 64,
 | |
| +							65, 66, 67, 68, 69, 70
 | |
| +	"rgmii_via_esw"			"eth"		59, 60, 61, 62, 63, 64,
 | |
| +							65, 66, 67, 68, 69, 70
 | |
| +	"rgmii_via_gmac1"		"eth"		59, 60, 61, 62, 63, 64,
 | |
| +							65, 66, 67, 68, 69, 70
 | |
| +	"rgmii_via_gmac2"		"eth"		25, 26, 27, 28, 29, 30,
 | |
| +							31, 32, 33, 34, 35, 36
 | |
| +	"mdc_mdio"			"eth"		23, 24
 | |
| +	"i2c0"				"i2c"		14, 15
 | |
| +	"i2c1_0"			"i2c"		55, 56
 | |
| +	"i2c1_1"			"i2c"		73, 74
 | |
| +	"i2c1_2"			"i2c"		87, 88
 | |
| +	"i2c2_0"			"i2c"		57, 58
 | |
| +	"i2c2_1"			"i2c"		75, 76
 | |
| +	"i2c2_2"			"i2c"		89, 90
 | |
| +	"i2s_in_mclk_bclk_ws"		"i2s"		3, 4, 5
 | |
| +	"i2s1_in_data"			"i2s"		1
 | |
| +	"i2s2_in_data"			"i2s"		16
 | |
| +	"i2s3_in_data"			"i2s"		17
 | |
| +	"i2s4_in_data"			"i2s"		18
 | |
| +	"i2s_out_mclk_bclk_ws"		"i2s"		3, 4, 5
 | |
| +	"i2s1_out_data"			"i2s"		2
 | |
| +	"i2s2_out_data"			"i2s"		19
 | |
| +	"i2s3_out_data"			"i2s"		20
 | |
| +	"i2s4_out_data"			"i2s"		21
 | |
| +	"ir_0_tx"			"ir"		16
 | |
| +	"ir_1_tx"			"ir"		59
 | |
| +	"ir_2_tx"			"ir"		99
 | |
| +	"ir_0_rx"			"ir"		17
 | |
| +	"ir_1_rx"			"ir"		60
 | |
| +	"ir_2_rx"			"ir"		100
 | |
| +	"ephy_leds"			"led"		86, 91, 92, 93, 94
 | |
| +	"ephy0_led"			"led"		86
 | |
| +	"ephy1_led"			"led"		91
 | |
| +	"ephy2_led"			"led"		92
 | |
| +	"ephy3_led"			"led"		93
 | |
| +	"ephy4_led"			"led"		94
 | |
| +	"wled"				"led"		85
 | |
| +	"par_nand"			"flash"		37, 38, 39, 40, 41, 42,
 | |
| +							43, 44, 45, 46, 47, 48,
 | |
| +							49, 50
 | |
| +	"snfi"				"flash"		8, 9, 10, 11, 12, 13
 | |
| +	"spi_nor"			"flash"		8, 9, 10, 11, 12, 13
 | |
| +	"pcie0_0_waken"			"pcie"		14
 | |
| +	"pcie0_1_waken"			"pcie"		79
 | |
| +	"pcie1_0_waken"			"pcie"		14
 | |
| +	"pcie0_0_clkreq"		"pcie"		15
 | |
| +	"pcie0_1_clkreq"		"pcie"		80
 | |
| +	"pcie1_0_clkreq"		"pcie"		15
 | |
| +	"pcie0_pad_perst"		"pcie"		83
 | |
| +	"pcie1_pad_perst"		"pcie"		84
 | |
| +	"pmic_bus"			"pmic"		71, 72
 | |
| +	"pwm_ch1_0"			"pwm"		51
 | |
| +	"pwm_ch1_1"			"pwm"		73
 | |
| +	"pwm_ch1_2"			"pwm"		95
 | |
| +	"pwm_ch2_0"			"pwm"		52
 | |
| +	"pwm_ch2_1"			"pwm"		74
 | |
| +	"pwm_ch2_2"			"pwm"		96
 | |
| +	"pwm_ch3_0"			"pwm"		53
 | |
| +	"pwm_ch3_1"			"pwm"		75
 | |
| +	"pwm_ch3_2"			"pwm"		97
 | |
| +	"pwm_ch4_0"			"pwm"		54
 | |
| +	"pwm_ch4_1"			"pwm"		67
 | |
| +	"pwm_ch4_2"			"pwm"		76
 | |
| +	"pwm_ch4_3"			"pwm"		98
 | |
| +	"pwm_ch5_0"			"pwm"		68
 | |
| +	"pwm_ch5_1"			"pwm"		77
 | |
| +	"pwm_ch5_2"			"pwm"		99
 | |
| +	"pwm_ch6_0"			"pwm"		69
 | |
| +	"pwm_ch6_1"			"pwm"		78
 | |
| +	"pwm_ch6_2"			"pwm"		81
 | |
| +	"pwm_ch6_3"			"pwm"		100
 | |
| +	"pwm_ch7_0"			"pwm"		70
 | |
| +	"pwm_ch7_1"			"pwm"		82
 | |
| +	"pwm_ch7_2"			"pwm"		101
 | |
| +	"sd_0"				"sd"		16, 17, 18, 19, 20, 21
 | |
| +	"sd_1"				"sd"		25, 26, 27, 28, 29, 30
 | |
| +	"spic0_0"			"spi"		63, 64, 65, 66
 | |
| +	"spic0_1"			"spi"		79, 80, 81, 82
 | |
| +	"spic1_0"			"spi"		67, 68, 69, 70
 | |
| +	"spic1_1"			"spi"		73, 74, 75, 76
 | |
| +	"spic2_0_wp_hold"		"spi"		8, 9
 | |
| +	"spic2_0"			"spi"		10, 11, 12, 13
 | |
| +	"tdm_0_out_mclk_bclk_ws"	"tdm"		8, 9, 10
 | |
| +	"tdm_0_in_mclk_bclk_ws"		"tdm"		11, 12, 13
 | |
| +	"tdm_0_out_data"		"tdm"		20
 | |
| +	"tdm_0_in_data"			"tdm"		21
 | |
| +	"tdm_1_out_mclk_bclk_ws"	"tdm"		57, 58, 59
 | |
| +	"tdm_1_in_mclk_bclk_ws"		"tdm"		60, 61, 62
 | |
| +	"tdm_1_out_data"		"tdm"		55
 | |
| +	"tdm_1_in_data"			"tdm"		56
 | |
| +	"uart0_0_tx_rx"			"uart"		6, 7
 | |
| +	"uart1_0_tx_rx"			"uart"		55, 56
 | |
| +	"uart1_0_rts_cts"		"uart"		57, 58
 | |
| +	"uart1_1_tx_rx"			"uart"		73, 74
 | |
| +	"uart1_1_rts_cts"		"uart"		75, 76
 | |
| +	"uart2_0_tx_rx"			"uart"		3, 4
 | |
| +	"uart2_0_rts_cts"		"uart"		1, 2
 | |
| +	"uart2_1_tx_rx"			"uart"		51, 52
 | |
| +	"uart2_1_rts_cts"		"uart"		53, 54
 | |
| +	"uart2_2_tx_rx"			"uart"		59, 60
 | |
| +	"uart2_2_rts_cts"		"uart"		61, 62
 | |
| +	"uart2_3_tx_rx"			"uart"		95, 96
 | |
| +	"uart3_0_tx_rx"			"uart"		57, 58
 | |
| +	"uart3_1_tx_rx"			"uart"		81, 82
 | |
| +	"uart3_1_rts_cts"		"uart"		79, 80
 | |
| +	"uart4_0_tx_rx"			"uart"		61, 62
 | |
| +	"uart4_1_tx_rx"			"uart"		91, 92
 | |
| +	"uart4_1_rts_cts"		"uart"		93, 94
 | |
| +	"uart4_2_tx_rx"			"uart"		97, 98
 | |
| +	"uart4_2_rts_cts"		"uart"		95, 96
 | |
| +	"watchdog"			"watchdog"	78
 | |
| +
 | |
| +Example:
 | |
| +
 | |
| +	pio: pinctrl@10211000 {
 | |
| +		compatible = "mediatek,mt7622-pinctrl";
 | |
| +		reg = <0 0x10211000 0 0x1000>;
 | |
| +		gpio-controller;
 | |
| +		#gpio-cells = <2>;
 | |
| +
 | |
| +		pinctrl_eth_default: eth-default {
 | |
| +			mux-mdio {
 | |
| +				groups = "mdc_mdio";
 | |
| +				function = "eth";
 | |
| +				drive-strength = <12>;
 | |
| +			};
 | |
| +
 | |
| +			mux-gmac2 {
 | |
| +				groups = "gmac2";
 | |
| +				function = "eth";
 | |
| +				drive-strength = <12>;
 | |
| +			};
 | |
| +
 | |
| +			mux-esw {
 | |
| +				groups = "esw";
 | |
| +				function = "eth";
 | |
| +				drive-strength = <8>;
 | |
| +			};
 | |
| +
 | |
| +			conf-mdio {
 | |
| +				pins = "MDC";
 | |
| +				bias-pull-up;
 | |
| +			};
 | |
| +		};
 | |
| +	};
 |