Merge tag 'samsung-pinctrl-5.18-2' of https://git.kernel.org/pub/scm/linux/kernel...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / pinctrl / qcom,msm8953-pinctrl.yaml
1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/pinctrl/qcom,msm8953-pinctrl.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Qualcomm Technologies, Inc. MSM8953 TLMM block
8
9 maintainers:
10   - Bjorn Andersson <bjorn.andersson@linaro.org>
11
12 description: |
13   This binding describes the Top Level Mode Multiplexer block found in the
14   MSM8953 platform.
15
16 properties:
17   compatible:
18     const: qcom,msm8953-pinctrl
19
20   reg:
21     maxItems: 1
22
23   interrupts:
24     description: Specifies the TLMM summary IRQ
25     maxItems: 1
26
27   interrupt-controller: true
28
29   '#interrupt-cells':
30     description:
31       Specifies the PIN numbers and Flags, as defined in defined in
32       include/dt-bindings/interrupt-controller/irq.h
33     const: 2
34
35   gpio-controller: true
36
37   gpio-reserved-ranges: true
38
39   '#gpio-cells':
40     description: Specifying the pin number and flags, as defined in
41       include/dt-bindings/gpio/gpio.h
42     const: 2
43
44   gpio-ranges:
45     maxItems: 1
46
47 #PIN CONFIGURATION NODES
48 patternProperties:
49   '-pins$':
50     type: object
51     description:
52       Pinctrl node's client devices use subnodes for desired pin configuration.
53       Client device subnodes use below standard properties.
54     $ref: "/schemas/pinctrl/pincfg-node.yaml"
55
56     properties:
57       pins:
58         description:
59           List of gpio pins affected by the properties specified in this
60           subnode.
61         items:
62           oneOf:
63             - pattern: "^gpio([0-9]|[1-9][0-9]|1[0-7][0-9])$"
64             - enum: [ sdc1_clk, sdc1_cmd, sdc1_data, sdc1_rclk, sdc2_clk,
65                       sdc2_cmd, sdc2_data, qdsd_clk, qdsd_cmd, qdsd_data0,
66                       qdsd_data1, qdsd_data2, qdsd_data3 ]
67         minItems: 1
68         maxItems: 16
69
70       function:
71         description:
72           Specify the alternative function to be configured for the specified
73           pins.
74
75         enum: [ accel_int, adsp_ext, alsp_int, atest_bbrx0, atest_bbrx1,
76                 atest_char, atest_char0, atest_char1, atest_char2, atest_char3,
77                 atest_gpsadc_dtest0_native, atest_gpsadc_dtest1_native, atest_tsens,
78                 atest_wlan0, atest_wlan1, bimc_dte0, bimc_dte1, blsp1_spi,
79                 blsp3_spi, blsp6_spi, blsp7_spi, blsp_i2c1, blsp_i2c2, blsp_i2c3,
80                 blsp_i2c4, blsp_i2c5, blsp_i2c6, blsp_i2c7, blsp_i2c8, blsp_spi1,
81                 blsp_spi2, blsp_spi3, blsp_spi4, blsp_spi5, blsp_spi6, blsp_spi7,
82                 blsp_spi8, blsp_uart2, blsp_uart4, blsp_uart5, blsp_uart6, cam0_ldo,
83                 cam1_ldo, cam1_rst, cam1_standby, cam2_rst, cam2_standby, cam3_rst,
84                 cam3_standby, cam_irq, cam_mclk, cap_int, cci_async, cci_i2c,
85                 cci_timer0, cci_timer1, cci_timer2, cci_timer3, cci_timer4,
86                 cdc_pdm0, codec_int1, codec_int2, codec_reset, cri_trng, cri_trng0,
87                 cri_trng1, dac_calib0, dac_calib1, dac_calib10, dac_calib11,
88                 dac_calib12, dac_calib13, dac_calib14, dac_calib15, dac_calib16,
89                 dac_calib17, dac_calib18, dac_calib19, dac_calib2, dac_calib20,
90                 dac_calib21, dac_calib22, dac_calib23, dac_calib24, dac_calib25,
91                 dac_calib3, dac_calib4, dac_calib5, dac_calib6, dac_calib7,
92                 dac_calib8, dac_calib9, dbg_out, ddr_bist, dmic0_clk, dmic0_data,
93                 ebi_cdc, ebi_ch0, ext_lpass, flash_strobe, fp_int, gcc_gp1_clk_a,
94                 gcc_gp1_clk_b, gcc_gp2_clk_a, gcc_gp2_clk_b, gcc_gp3_clk_a,
95                 gcc_gp3_clk_b, gcc_plltest, gcc_tlmm, gpio, gsm0_tx, gsm1_tx,
96                 gyro_int, hall_int, hdmi_int, key_focus, key_home, key_snapshot,
97                 key_volp, ldo_en, ldo_update, lpass_slimbus, lpass_slimbus0,
98                 lpass_slimbus1, m_voc, mag_int, mdp_vsync, mipi_dsi0, modem_tsync,
99                 mss_lte, nav_pps, nav_pps_in_a, nav_pps_in_b, nav_tsync,
100                 nfc_disable, nfc_dwl, nfc_irq, ois_sync, pa_indicator, pbs0, pbs1,
101                 pbs2, pressure_int, pri_mi2s, pri_mi2s_mclk_a, pri_mi2s_mclk_b,
102                 pri_mi2s_ws, prng_rosc, pwr_crypto_enabled_a, pwr_crypto_enabled_b,
103                 pwr_down, pwr_modem_enabled_a, pwr_modem_enabled_b,
104                 pwr_nav_enabled_a, pwr_nav_enabled_b, qdss_cti_trig_in_a0,
105                 qdss_cti_trig_in_a1, qdss_cti_trig_in_b0, qdss_cti_trig_in_b1,
106                 qdss_cti_trig_out_a0, qdss_cti_trig_out_a1, qdss_cti_trig_out_b0,
107                 qdss_cti_trig_out_b1, qdss_traceclk_a, qdss_traceclk_b,
108                 qdss_tracectl_a, qdss_tracectl_b, qdss_tracedata_a,
109                 qdss_tracedata_b, sd_write, sdcard_det, sec_mi2s, sec_mi2s_mclk_a,
110                 sec_mi2s_mclk_b, smb_int, ss_switch, ssbi_wtr1, ts_resout,
111                 ts_sample, ts_xvdd, tsens_max, uim1_clk, uim1_data, uim1_present,
112                 uim1_reset, uim2_clk, uim2_data, uim2_present, uim2_reset,
113                 uim_batt, us_emitter, us_euro, wcss_bt, wcss_fm, wcss_wlan,
114                 wcss_wlan0, wcss_wlan1, wcss_wlan2, wsa_en, wsa_io, wsa_irq ]
115
116       drive-strength:
117         enum: [2, 4, 6, 8, 10, 12, 14, 16]
118         default: 2
119         description:
120           Selects the drive strength for the specified pins, in mA.
121
122       bias-pull-down: true
123
124       bias-pull-up: true
125
126       bias-disable: true
127
128       output-high: true
129
130       output-low: true
131
132     required:
133       - pins
134       - function
135
136     additionalProperties: false
137
138 allOf:
139   - $ref: "pinctrl.yaml#"
140
141 required:
142   - compatible
143   - reg
144   - interrupts
145   - interrupt-controller
146   - '#interrupt-cells'
147   - gpio-controller
148   - '#gpio-cells'
149   - gpio-ranges
150
151 additionalProperties: false
152
153 examples:
154   - |
155         #include <dt-bindings/interrupt-controller/arm-gic.h>
156         tlmm: pinctrl@1000000 {
157               compatible = "qcom,msm8953-pinctrl";
158               reg = <0x01000000 0x300000>;
159               interrupts = <GIC_SPI 208 IRQ_TYPE_LEVEL_HIGH>;
160               interrupt-controller;
161               #interrupt-cells = <2>;
162               gpio-controller;
163               #gpio-cells = <2>;
164               gpio-ranges = <&tlmm 0 0 142>;
165
166               serial_default: serial-pins {
167                     pins = "gpio4", "gpio5";
168                     function = "blsp_uart2";
169                     drive-strength = <2>;
170                     bias-disable;
171               };
172         };