1 /* SPDX-License-Identifier: GPL-2.0 */
3 * Copyright (C) 2018 MediaTek Inc.
5 * Author: Sean Wang <sean.wang@mediatek.com>
9 #ifndef __PINCTRL_MTK_COMMON_V2_H
10 #define __PINCTRL_MTK_COMMON_V2_H
12 #include <linux/gpio/driver.h>
18 #define MTK_PULLDOWN 0
23 #define PIN_FIELD_CALC(_s_pin, _e_pin, _i_base, _s_addr, _x_addrs, \
24 _s_bit, _x_bits, _sz_reg, _fixed) { \
29 .x_addrs = _x_addrs, \
36 #define PIN_FIELD(_s_pin, _e_pin, _s_addr, _x_addrs, _s_bit, _x_bits) \
37 PIN_FIELD_CALC(_s_pin, _e_pin, 0, _s_addr, _x_addrs, _s_bit, \
40 #define PINS_FIELD(_s_pin, _e_pin, _s_addr, _x_addrs, _s_bit, _x_bits) \
41 PIN_FIELD_CALC(_s_pin, _e_pin, 0, _s_addr, _x_addrs, _s_bit, \
44 /* List these attributes which could be modified for the pin */
56 PINCTRL_PIN_REG_TDSEL,
57 PINCTRL_PIN_REG_RDSEL,
63 PINCTRL_PIN_REG_PULLEN,
64 PINCTRL_PIN_REG_PULLSEL,
68 /* Group the pins by the driving current */
79 static const char * const mtk_default_register_base_names[] = {
83 /* struct mtk_pin_field - the structure that holds the information of the field
84 * used to describe the attribute for the pin
85 * @base: the index pointing to the entry in base address list
86 * @offset: the register offset relative to the base address
87 * @mask: the mask used to filter out the field from the register
88 * @bitpos: the start bit relative to the register
89 * @next: the indication that the field would be extended to the
92 struct mtk_pin_field {
100 /* struct mtk_pin_field_calc - the structure that holds the range providing
101 * the guide used to look up the relevant field
102 * @s_pin: the start pin within the range
103 * @e_pin: the end pin within the range
104 * @i_base: the index pointing to the entry in base address list
105 * @s_addr: the start address for the range
106 * @x_addrs: the address distance between two consecutive registers
108 * @s_bit: the start bit for the first register within the range
109 * @x_bits: the bit distance between two consecutive pins within
111 * @sz_reg: the size of bits in a register
112 * @fixed: the consecutive pins share the same bits with the 1st
115 struct mtk_pin_field_calc {
127 /* struct mtk_pin_reg_calc - the structure that holds all ranges used to
128 * determine which register the pin would make use of
129 * for certain pin attribute.
130 * @range: the start address for the range
131 * @nranges: the number of items in the range
133 struct mtk_pin_reg_calc {
134 const struct mtk_pin_field_calc *range;
135 unsigned int nranges;
139 * struct mtk_func_desc - the structure that providing information
140 * all the funcs for this pin
141 * @name: the name of function
142 * @muxval: the mux to the function
144 struct mtk_func_desc {
150 * struct mtk_eint_desc - the structure that providing information
151 * for eint data per pin
152 * @eint_m: the eint mux for this pin
153 * @eitn_n: the eint number for this pin
155 struct mtk_eint_desc {
161 * struct mtk_pin_desc - the structure that providing information
162 * for each pin of chips
163 * @number: unique pin number from the global pin number space
164 * @name: name for this pin
165 * @eint: the eint data for this pin
166 * @drv_n: the index with the driving group
167 * @funcs: all available functions for this pins (only used in
168 * those drivers compatible to pinctrl-mtk-common.c-like
171 struct mtk_pin_desc {
174 struct mtk_eint_desc eint;
176 struct mtk_func_desc *funcs;
179 struct mtk_pinctrl_group {
181 unsigned long config;
187 /* struct mtk_pin_soc - the structure that holds SoC-specific data */
189 const struct mtk_pin_reg_calc *reg_cal;
190 const struct mtk_pin_desc *pins;
192 const struct group_desc *grps;
194 const struct function_desc *funcs;
196 const struct mtk_eint_regs *eint_regs;
197 const struct mtk_eint_hw *eint_hw;
199 /* Specific parameters per SoC */
202 const char * const *base_names;
203 unsigned int nbase_names;
205 /* Specific pinconfig operations */
206 int (*bias_disable_set)(struct mtk_pinctrl *hw,
207 const struct mtk_pin_desc *desc);
208 int (*bias_disable_get)(struct mtk_pinctrl *hw,
209 const struct mtk_pin_desc *desc, int *res);
210 int (*bias_set)(struct mtk_pinctrl *hw,
211 const struct mtk_pin_desc *desc, bool pullup);
212 int (*bias_get)(struct mtk_pinctrl *hw,
213 const struct mtk_pin_desc *desc, bool pullup, int *res);
215 int (*drive_set)(struct mtk_pinctrl *hw,
216 const struct mtk_pin_desc *desc, u32 arg);
217 int (*drive_get)(struct mtk_pinctrl *hw,
218 const struct mtk_pin_desc *desc, int *val);
220 int (*adv_pull_set)(struct mtk_pinctrl *hw,
221 const struct mtk_pin_desc *desc, bool pullup,
223 int (*adv_pull_get)(struct mtk_pinctrl *hw,
224 const struct mtk_pin_desc *desc, bool pullup,
227 /* Specific driver data */
232 struct pinctrl_dev *pctrl;
236 struct gpio_chip chip;
237 const struct mtk_pin_soc *soc;
238 struct mtk_eint *eint;
239 struct mtk_pinctrl_group *groups;
240 const char **grp_names;
243 void mtk_rmw(struct mtk_pinctrl *pctl, u8 i, u32 reg, u32 mask, u32 set);
245 int mtk_hw_set_value(struct mtk_pinctrl *hw, const struct mtk_pin_desc *desc,
246 int field, int value);
247 int mtk_hw_get_value(struct mtk_pinctrl *hw, const struct mtk_pin_desc *desc,
248 int field, int *value);
250 int mtk_build_eint(struct mtk_pinctrl *hw, struct platform_device *pdev);
252 int mtk_pinconf_bias_disable_set(struct mtk_pinctrl *hw,
253 const struct mtk_pin_desc *desc);
254 int mtk_pinconf_bias_disable_get(struct mtk_pinctrl *hw,
255 const struct mtk_pin_desc *desc, int *res);
256 int mtk_pinconf_bias_set(struct mtk_pinctrl *hw,
257 const struct mtk_pin_desc *desc, bool pullup);
258 int mtk_pinconf_bias_get(struct mtk_pinctrl *hw,
259 const struct mtk_pin_desc *desc, bool pullup,
262 int mtk_pinconf_bias_disable_set_rev1(struct mtk_pinctrl *hw,
263 const struct mtk_pin_desc *desc);
264 int mtk_pinconf_bias_disable_get_rev1(struct mtk_pinctrl *hw,
265 const struct mtk_pin_desc *desc,
267 int mtk_pinconf_bias_set_rev1(struct mtk_pinctrl *hw,
268 const struct mtk_pin_desc *desc, bool pullup);
269 int mtk_pinconf_bias_get_rev1(struct mtk_pinctrl *hw,
270 const struct mtk_pin_desc *desc, bool pullup,
273 int mtk_pinconf_drive_set(struct mtk_pinctrl *hw,
274 const struct mtk_pin_desc *desc, u32 arg);
275 int mtk_pinconf_drive_get(struct mtk_pinctrl *hw,
276 const struct mtk_pin_desc *desc, int *val);
278 int mtk_pinconf_drive_set_rev1(struct mtk_pinctrl *hw,
279 const struct mtk_pin_desc *desc, u32 arg);
280 int mtk_pinconf_drive_get_rev1(struct mtk_pinctrl *hw,
281 const struct mtk_pin_desc *desc, int *val);
283 int mtk_pinconf_adv_pull_set(struct mtk_pinctrl *hw,
284 const struct mtk_pin_desc *desc, bool pullup,
286 int mtk_pinconf_adv_pull_get(struct mtk_pinctrl *hw,
287 const struct mtk_pin_desc *desc, bool pullup,
290 #endif /* __PINCTRL_MTK_COMMON_V2_H */