1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright (c) 2013, Sony Mobile Communications AB.
4  */
5 #ifndef __PINCTRL_MSM_H__
6 #define __PINCTRL_MSM_H__
7 
8 struct pinctrl_pin_desc;
9 
10 /**
11  * struct msm_function - a pinmux function
12  * @name:    Name of the pinmux function.
13  * @groups:  List of pingroups for this function.
14  * @ngroups: Number of entries in @groups.
15  */
16 struct msm_function {
17 	const char *name;
18 	const char * const *groups;
19 	unsigned ngroups;
20 };
21 
22 /**
23  * struct msm_pingroup - Qualcomm pingroup definition
24  * @name:                 Name of the pingroup.
25  * @pins:	          A list of pins assigned to this pingroup.
26  * @npins:	          Number of entries in @pins.
27  * @funcs:                A list of pinmux functions that can be selected for
28  *                        this group. The index of the selected function is used
29  *                        for programming the function selector.
30  *                        Entries should be indices into the groups list of the
31  *                        struct msm_pinctrl_soc_data.
32  * @ctl_reg:              Offset of the register holding control bits for this group.
33  * @io_reg:               Offset of the register holding input/output bits for this group.
34  * @intr_cfg_reg:         Offset of the register holding interrupt configuration bits.
35  * @intr_status_reg:      Offset of the register holding the status bits for this group.
36  * @intr_target_reg:      Offset of the register specifying routing of the interrupts
37  *                        from this group.
38  * @mux_bit:              Offset in @ctl_reg for the pinmux function selection.
39  * @pull_bit:             Offset in @ctl_reg for the bias configuration.
40  * @drv_bit:              Offset in @ctl_reg for the drive strength configuration.
41  * @oe_bit:               Offset in @ctl_reg for controlling output enable.
42  * @in_bit:               Offset in @io_reg for the input bit value.
43  * @out_bit:              Offset in @io_reg for the output bit value.
44  * @intr_enable_bit:      Offset in @intr_cfg_reg for enabling the interrupt for this group.
45  * @intr_status_bit:      Offset in @intr_status_reg for reading and acking the interrupt
46  *                        status.
47  * @intr_target_bit:      Offset in @intr_target_reg for configuring the interrupt routing.
48  * @intr_target_kpss_val: Value in @intr_target_bit for specifying that the interrupt from
49  *                        this gpio should get routed to the KPSS processor.
50  * @intr_raw_status_bit:  Offset in @intr_cfg_reg for the raw status bit.
51  * @intr_polarity_bit:    Offset in @intr_cfg_reg for specifying polarity of the interrupt.
52  * @intr_detection_bit:   Offset in @intr_cfg_reg for specifying interrupt type.
53  * @intr_detection_width: Number of bits used for specifying interrupt type,
54  *                        Should be 2 for SoCs that can detect both edges in hardware,
55  *                        otherwise 1.
56  */
57 struct msm_pingroup {
58 	const char *name;
59 	const unsigned *pins;
60 	unsigned npins;
61 
62 	unsigned *funcs;
63 	unsigned nfuncs;
64 
65 	u32 ctl_reg;
66 	u32 io_reg;
67 	u32 intr_cfg_reg;
68 	u32 intr_status_reg;
69 	u32 intr_target_reg;
70 
71 	unsigned int tile:2;
72 
73 	unsigned mux_bit:5;
74 
75 	unsigned pull_bit:5;
76 	unsigned drv_bit:5;
77 
78 	unsigned oe_bit:5;
79 	unsigned in_bit:5;
80 	unsigned out_bit:5;
81 
82 	unsigned intr_enable_bit:5;
83 	unsigned intr_status_bit:5;
84 	unsigned intr_ack_high:1;
85 
86 	unsigned intr_target_bit:5;
87 	unsigned intr_target_kpss_val:5;
88 	unsigned intr_raw_status_bit:5;
89 	unsigned intr_polarity_bit:5;
90 	unsigned intr_detection_bit:5;
91 	unsigned intr_detection_width:5;
92 };
93 
94 /**
95  * struct msm_gpio_wakeirq_map - Map of GPIOs and their wakeup pins
96  * @gpio:          The GPIOs that are wakeup capable
97  * @wakeirq:       The interrupt at the always-on interrupt controller
98  */
99 struct msm_gpio_wakeirq_map {
100 	unsigned int gpio;
101 	unsigned int wakeirq;
102 };
103 
104 /**
105  * struct msm_pinctrl_soc_data - Qualcomm pin controller driver configuration
106  * @pins:	    An array describing all pins the pin controller affects.
107  * @npins:	    The number of entries in @pins.
108  * @functions:	    An array describing all mux functions the SoC supports.
109  * @nfunctions:	    The number of entries in @functions.
110  * @groups:	    An array describing all pin groups the pin SoC supports.
111  * @ngroups:	    The numbmer of entries in @groups.
112  * @ngpio:	    The number of pingroups the driver should expose as GPIOs.
113  * @pull_no_keeper: The SoC does not support keeper bias.
114  * @wakeirq_map:    The map of wakeup capable GPIOs and the pin at PDC/MPM
115  * @nwakeirq_map:   The number of entries in @wakeirq_map
116  */
117 struct msm_pinctrl_soc_data {
118 	const struct pinctrl_pin_desc *pins;
119 	unsigned npins;
120 	const struct msm_function *functions;
121 	unsigned nfunctions;
122 	const struct msm_pingroup *groups;
123 	unsigned ngroups;
124 	unsigned ngpios;
125 	bool pull_no_keeper;
126 	const char *const *tiles;
127 	unsigned int ntiles;
128 	const int *reserved_gpios;
129 	const struct msm_gpio_wakeirq_map *wakeirq_map;
130 	unsigned int nwakeirq_map;
131 };
132 
133 extern const struct dev_pm_ops msm_pinctrl_dev_pm_ops;
134 
135 int msm_pinctrl_probe(struct platform_device *pdev,
136 		      const struct msm_pinctrl_soc_data *soc_data);
137 int msm_pinctrl_remove(struct platform_device *pdev);
138 
139 #endif
140