373 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			373 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* SPDX-License-Identifier: GPL-2.0 */
 | 
						|
/*
 | 
						|
 * Copyright (C) 2018 MediaTek Inc.
 | 
						|
 *
 | 
						|
 * Author: Sean Wang <sean.wang@mediatek.com>
 | 
						|
 *
 | 
						|
 */
 | 
						|
 | 
						|
#ifndef __PINCTRL_MTK_COMMON_V2_H
 | 
						|
#define __PINCTRL_MTK_COMMON_V2_H
 | 
						|
 | 
						|
#include <linux/gpio/driver.h>
 | 
						|
 | 
						|
#define MTK_INPUT      0
 | 
						|
#define MTK_OUTPUT     1
 | 
						|
#define MTK_DISABLE    0
 | 
						|
#define MTK_ENABLE     1
 | 
						|
#define MTK_PULLDOWN   0
 | 
						|
#define MTK_PULLUP     1
 | 
						|
#define MTK_PULL_PU_PD_TYPE		BIT(0)
 | 
						|
#define MTK_PULL_PULLSEL_TYPE		BIT(1)
 | 
						|
#define MTK_PULL_PUPD_R1R0_TYPE		BIT(2)
 | 
						|
/* MTK_PULL_RSEL_TYPE can select resistance and can be
 | 
						|
 * turned on/off itself. But it can't be selected pull up/down
 | 
						|
 */
 | 
						|
#define MTK_PULL_RSEL_TYPE		BIT(3)
 | 
						|
/* MTK_PULL_PU_PD_RSEL_TYPE is a type which is controlled by
 | 
						|
 * MTK_PULL_PU_PD_TYPE and MTK_PULL_RSEL_TYPE.
 | 
						|
 */
 | 
						|
#define MTK_PULL_PU_PD_RSEL_TYPE	(MTK_PULL_PU_PD_TYPE \
 | 
						|
					| MTK_PULL_RSEL_TYPE)
 | 
						|
#define MTK_PULL_TYPE_MASK	(MTK_PULL_PU_PD_TYPE |\
 | 
						|
				 MTK_PULL_PULLSEL_TYPE |\
 | 
						|
				 MTK_PULL_PUPD_R1R0_TYPE |\
 | 
						|
				 MTK_PULL_RSEL_TYPE)
 | 
						|
 | 
						|
#define EINT_NA	U16_MAX
 | 
						|
#define NO_EINT_SUPPORT	EINT_NA
 | 
						|
 | 
						|
#define PIN_FIELD_CALC(_s_pin, _e_pin, _i_base, _s_addr, _x_addrs,      \
 | 
						|
		       _s_bit, _x_bits, _sz_reg, _fixed) {		\
 | 
						|
		.s_pin = _s_pin,					\
 | 
						|
		.e_pin = _e_pin,					\
 | 
						|
		.i_base = _i_base,					\
 | 
						|
		.s_addr = _s_addr,					\
 | 
						|
		.x_addrs = _x_addrs,					\
 | 
						|
		.s_bit = _s_bit,					\
 | 
						|
		.x_bits = _x_bits,					\
 | 
						|
		.sz_reg = _sz_reg,					\
 | 
						|
		.fixed = _fixed,					\
 | 
						|
	}
 | 
						|
 | 
						|
#define PIN_FIELD(_s_pin, _e_pin, _s_addr, _x_addrs, _s_bit, _x_bits)	\
 | 
						|
	PIN_FIELD_CALC(_s_pin, _e_pin, 0, _s_addr, _x_addrs, _s_bit,	\
 | 
						|
		       _x_bits, 32, 0)
 | 
						|
 | 
						|
#define PINS_FIELD(_s_pin, _e_pin, _s_addr, _x_addrs, _s_bit, _x_bits)	\
 | 
						|
	PIN_FIELD_CALC(_s_pin, _e_pin, 0, _s_addr, _x_addrs, _s_bit,	\
 | 
						|
		       _x_bits, 32, 1)
 | 
						|
 | 
						|
#define PIN_RSEL(_s_pin, _e_pin, _rsel_index, _up_resl, _down_rsel) {	\
 | 
						|
		.s_pin = _s_pin,					\
 | 
						|
		.e_pin = _e_pin,					\
 | 
						|
		.rsel_index = _rsel_index,				\
 | 
						|
		.up_rsel = _up_resl,					\
 | 
						|
		.down_rsel = _down_rsel,				\
 | 
						|
	}
 | 
						|
 | 
						|
/* List these attributes which could be modified for the pin */
 | 
						|
enum {
 | 
						|
	PINCTRL_PIN_REG_MODE,
 | 
						|
	PINCTRL_PIN_REG_DIR,
 | 
						|
	PINCTRL_PIN_REG_DI,
 | 
						|
	PINCTRL_PIN_REG_DO,
 | 
						|
	PINCTRL_PIN_REG_SR,
 | 
						|
	PINCTRL_PIN_REG_SMT,
 | 
						|
	PINCTRL_PIN_REG_PD,
 | 
						|
	PINCTRL_PIN_REG_PU,
 | 
						|
	PINCTRL_PIN_REG_E4,
 | 
						|
	PINCTRL_PIN_REG_E8,
 | 
						|
	PINCTRL_PIN_REG_TDSEL,
 | 
						|
	PINCTRL_PIN_REG_RDSEL,
 | 
						|
	PINCTRL_PIN_REG_DRV,
 | 
						|
	PINCTRL_PIN_REG_PUPD,
 | 
						|
	PINCTRL_PIN_REG_R0,
 | 
						|
	PINCTRL_PIN_REG_R1,
 | 
						|
	PINCTRL_PIN_REG_IES,
 | 
						|
	PINCTRL_PIN_REG_PULLEN,
 | 
						|
	PINCTRL_PIN_REG_PULLSEL,
 | 
						|
	PINCTRL_PIN_REG_DRV_EN,
 | 
						|
	PINCTRL_PIN_REG_DRV_E0,
 | 
						|
	PINCTRL_PIN_REG_DRV_E1,
 | 
						|
	PINCTRL_PIN_REG_DRV_ADV,
 | 
						|
	PINCTRL_PIN_REG_RSEL,
 | 
						|
	PINCTRL_PIN_REG_MAX,
 | 
						|
};
 | 
						|
 | 
						|
/* Group the pins by the driving current */
 | 
						|
enum {
 | 
						|
	DRV_FIXED,
 | 
						|
	DRV_GRP0,
 | 
						|
	DRV_GRP1,
 | 
						|
	DRV_GRP2,
 | 
						|
	DRV_GRP3,
 | 
						|
	DRV_GRP4,
 | 
						|
	DRV_GRP_MAX,
 | 
						|
};
 | 
						|
 | 
						|
static const char * const mtk_default_register_base_names[] __maybe_unused = {
 | 
						|
	"base",
 | 
						|
};
 | 
						|
 | 
						|
/* struct mtk_pin_field - the structure that holds the information of the field
 | 
						|
 *			  used to describe the attribute for the pin
 | 
						|
 * @base:		the index pointing to the entry in base address list
 | 
						|
 * @offset:		the register offset relative to the base address
 | 
						|
 * @mask:		the mask used to filter out the field from the register
 | 
						|
 * @bitpos:		the start bit relative to the register
 | 
						|
 * @next:		the indication that the field would be extended to the
 | 
						|
			next register
 | 
						|
 */
 | 
						|
struct mtk_pin_field {
 | 
						|
	u8  index;
 | 
						|
	u32 offset;
 | 
						|
	u32 mask;
 | 
						|
	u8  bitpos;
 | 
						|
	u8  next;
 | 
						|
};
 | 
						|
 | 
						|
/* struct mtk_pin_field_calc - the structure that holds the range providing
 | 
						|
 *			       the guide used to look up the relevant field
 | 
						|
 * @s_pin:		the start pin within the range
 | 
						|
 * @e_pin:		the end pin within the range
 | 
						|
 * @i_base:		the index pointing to the entry in base address list
 | 
						|
 * @s_addr:		the start address for the range
 | 
						|
 * @x_addrs:		the address distance between two consecutive registers
 | 
						|
 *			within the range
 | 
						|
 * @s_bit:		the start bit for the first register within the range
 | 
						|
 * @x_bits:		the bit distance between two consecutive pins within
 | 
						|
 *			the range
 | 
						|
 * @sz_reg:		the size of bits in a register
 | 
						|
 * @fixed:		the consecutive pins share the same bits with the 1st
 | 
						|
 *			pin
 | 
						|
 */
 | 
						|
struct mtk_pin_field_calc {
 | 
						|
	u16 s_pin;
 | 
						|
	u16 e_pin;
 | 
						|
	u8  i_base;
 | 
						|
	u32 s_addr;
 | 
						|
	u8  x_addrs;
 | 
						|
	u8  s_bit;
 | 
						|
	u8  x_bits;
 | 
						|
	u8  sz_reg;
 | 
						|
	u8  fixed;
 | 
						|
};
 | 
						|
 | 
						|
/**
 | 
						|
 * struct mtk_pin_rsel - the structure that provides bias resistance selection.
 | 
						|
 * @s_pin:		the start pin within the rsel range
 | 
						|
 * @e_pin:		the end pin within the rsel range
 | 
						|
 * @rsel_index:	the rsel bias resistance index
 | 
						|
 * @up_rsel:	the pullup rsel bias resistance value
 | 
						|
 * @down_rsel:	the pulldown rsel bias resistance value
 | 
						|
 */
 | 
						|
struct mtk_pin_rsel {
 | 
						|
	u16 s_pin;
 | 
						|
	u16 e_pin;
 | 
						|
	u16 rsel_index;
 | 
						|
	u32 up_rsel;
 | 
						|
	u32 down_rsel;
 | 
						|
};
 | 
						|
 | 
						|
/* struct mtk_pin_reg_calc - the structure that holds all ranges used to
 | 
						|
 *			     determine which register the pin would make use of
 | 
						|
 *			     for certain pin attribute.
 | 
						|
 * @range:		     the start address for the range
 | 
						|
 * @nranges:		     the number of items in the range
 | 
						|
 */
 | 
						|
struct mtk_pin_reg_calc {
 | 
						|
	const struct mtk_pin_field_calc *range;
 | 
						|
	unsigned int nranges;
 | 
						|
};
 | 
						|
 | 
						|
/**
 | 
						|
 * struct mtk_func_desc - the structure that providing information
 | 
						|
 *			  all the funcs for this pin
 | 
						|
 * @name:		the name of function
 | 
						|
 * @muxval:		the mux to the function
 | 
						|
 */
 | 
						|
struct mtk_func_desc {
 | 
						|
	const char *name;
 | 
						|
	u8 muxval;
 | 
						|
};
 | 
						|
 | 
						|
/**
 | 
						|
 * struct mtk_eint_desc - the structure that providing information
 | 
						|
 *			       for eint data per pin
 | 
						|
 * @eint_m:		the eint mux for this pin
 | 
						|
 * @eitn_n:		the eint number for this pin
 | 
						|
 */
 | 
						|
struct mtk_eint_desc {
 | 
						|
	u16 eint_m;
 | 
						|
	u16 eint_n;
 | 
						|
};
 | 
						|
 | 
						|
/**
 | 
						|
 * struct mtk_pin_desc - the structure that providing information
 | 
						|
 *			       for each pin of chips
 | 
						|
 * @number:		unique pin number from the global pin number space
 | 
						|
 * @name:		name for this pin
 | 
						|
 * @eint:		the eint data for this pin
 | 
						|
 * @drv_n:		the index with the driving group
 | 
						|
 * @funcs:		all available functions for this pins (only used in
 | 
						|
 *			those drivers compatible to pinctrl-mtk-common.c-like
 | 
						|
 *			ones)
 | 
						|
 */
 | 
						|
struct mtk_pin_desc {
 | 
						|
	unsigned int number;
 | 
						|
	const char *name;
 | 
						|
	struct mtk_eint_desc eint;
 | 
						|
	u8 drv_n;
 | 
						|
	struct mtk_func_desc *funcs;
 | 
						|
};
 | 
						|
 | 
						|
struct mtk_pinctrl_group {
 | 
						|
	const char	*name;
 | 
						|
	unsigned long	config;
 | 
						|
	unsigned	pin;
 | 
						|
};
 | 
						|
 | 
						|
struct mtk_pinctrl;
 | 
						|
 | 
						|
/* struct mtk_pin_soc - the structure that holds SoC-specific data */
 | 
						|
struct mtk_pin_soc {
 | 
						|
	const struct mtk_pin_reg_calc	*reg_cal;
 | 
						|
	const struct mtk_pin_desc	*pins;
 | 
						|
	unsigned int			npins;
 | 
						|
	const struct group_desc		*grps;
 | 
						|
	unsigned int			ngrps;
 | 
						|
	const struct function_desc	*funcs;
 | 
						|
	unsigned int			nfuncs;
 | 
						|
	const struct mtk_eint_regs	*eint_regs;
 | 
						|
	const struct mtk_eint_hw	*eint_hw;
 | 
						|
 | 
						|
	/* Specific parameters per SoC */
 | 
						|
	u8				gpio_m;
 | 
						|
	bool				ies_present;
 | 
						|
	const char * const		*base_names;
 | 
						|
	unsigned int			nbase_names;
 | 
						|
	const unsigned int		*pull_type;
 | 
						|
	const struct mtk_pin_rsel	*pin_rsel;
 | 
						|
	unsigned int			npin_rsel;
 | 
						|
 | 
						|
	/* Specific pinconfig operations */
 | 
						|
	int (*bias_disable_set)(struct mtk_pinctrl *hw,
 | 
						|
				const struct mtk_pin_desc *desc);
 | 
						|
	int (*bias_disable_get)(struct mtk_pinctrl *hw,
 | 
						|
				const struct mtk_pin_desc *desc, int *res);
 | 
						|
	int (*bias_set)(struct mtk_pinctrl *hw,
 | 
						|
			const struct mtk_pin_desc *desc, bool pullup);
 | 
						|
	int (*bias_get)(struct mtk_pinctrl *hw,
 | 
						|
			const struct mtk_pin_desc *desc, bool pullup, int *res);
 | 
						|
 | 
						|
	int (*bias_set_combo)(struct mtk_pinctrl *hw,
 | 
						|
			const struct mtk_pin_desc *desc, u32 pullup, u32 arg);
 | 
						|
	int (*bias_get_combo)(struct mtk_pinctrl *hw,
 | 
						|
			const struct mtk_pin_desc *desc, u32 *pullup, u32 *arg);
 | 
						|
 | 
						|
	int (*drive_set)(struct mtk_pinctrl *hw,
 | 
						|
			 const struct mtk_pin_desc *desc, u32 arg);
 | 
						|
	int (*drive_get)(struct mtk_pinctrl *hw,
 | 
						|
			 const struct mtk_pin_desc *desc, int *val);
 | 
						|
 | 
						|
	int (*adv_pull_set)(struct mtk_pinctrl *hw,
 | 
						|
			    const struct mtk_pin_desc *desc, bool pullup,
 | 
						|
			    u32 arg);
 | 
						|
	int (*adv_pull_get)(struct mtk_pinctrl *hw,
 | 
						|
			    const struct mtk_pin_desc *desc, bool pullup,
 | 
						|
			    u32 *val);
 | 
						|
	int (*adv_drive_set)(struct mtk_pinctrl *hw,
 | 
						|
			     const struct mtk_pin_desc *desc, u32 arg);
 | 
						|
	int (*adv_drive_get)(struct mtk_pinctrl *hw,
 | 
						|
			     const struct mtk_pin_desc *desc, u32 *val);
 | 
						|
 | 
						|
	/* Specific driver data */
 | 
						|
	void				*driver_data;
 | 
						|
};
 | 
						|
 | 
						|
struct mtk_pinctrl {
 | 
						|
	struct pinctrl_dev		*pctrl;
 | 
						|
	void __iomem			**base;
 | 
						|
	u8				nbase;
 | 
						|
	struct device			*dev;
 | 
						|
	struct gpio_chip		chip;
 | 
						|
	const struct mtk_pin_soc        *soc;
 | 
						|
	struct mtk_eint			*eint;
 | 
						|
	struct mtk_pinctrl_group	*groups;
 | 
						|
	const char          **grp_names;
 | 
						|
	/* lock pin's register resource to avoid multiple threads issue*/
 | 
						|
	spinlock_t lock;
 | 
						|
	/* identify rsel setting by si unit or rsel define in dts node */
 | 
						|
	bool rsel_si_unit;
 | 
						|
};
 | 
						|
 | 
						|
void mtk_rmw(struct mtk_pinctrl *pctl, u8 i, u32 reg, u32 mask, u32 set);
 | 
						|
 | 
						|
int mtk_hw_set_value(struct mtk_pinctrl *hw, const struct mtk_pin_desc *desc,
 | 
						|
		     int field, int value);
 | 
						|
int mtk_hw_get_value(struct mtk_pinctrl *hw, const struct mtk_pin_desc *desc,
 | 
						|
		     int field, int *value);
 | 
						|
 | 
						|
int mtk_build_eint(struct mtk_pinctrl *hw, struct platform_device *pdev);
 | 
						|
 | 
						|
int mtk_pinconf_bias_disable_set(struct mtk_pinctrl *hw,
 | 
						|
				 const struct mtk_pin_desc *desc);
 | 
						|
int mtk_pinconf_bias_disable_get(struct mtk_pinctrl *hw,
 | 
						|
				 const struct mtk_pin_desc *desc, int *res);
 | 
						|
int mtk_pinconf_bias_set(struct mtk_pinctrl *hw,
 | 
						|
			 const struct mtk_pin_desc *desc, bool pullup);
 | 
						|
int mtk_pinconf_bias_get(struct mtk_pinctrl *hw,
 | 
						|
			 const struct mtk_pin_desc *desc, bool pullup,
 | 
						|
			 int *res);
 | 
						|
 | 
						|
int mtk_pinconf_bias_disable_set_rev1(struct mtk_pinctrl *hw,
 | 
						|
				      const struct mtk_pin_desc *desc);
 | 
						|
int mtk_pinconf_bias_disable_get_rev1(struct mtk_pinctrl *hw,
 | 
						|
				      const struct mtk_pin_desc *desc,
 | 
						|
				      int *res);
 | 
						|
int mtk_pinconf_bias_set_rev1(struct mtk_pinctrl *hw,
 | 
						|
			      const struct mtk_pin_desc *desc, bool pullup);
 | 
						|
int mtk_pinconf_bias_get_rev1(struct mtk_pinctrl *hw,
 | 
						|
			      const struct mtk_pin_desc *desc, bool pullup,
 | 
						|
			      int *res);
 | 
						|
int mtk_pinconf_bias_set_combo(struct mtk_pinctrl *hw,
 | 
						|
				const struct mtk_pin_desc *desc,
 | 
						|
				u32 pullup, u32 enable);
 | 
						|
int mtk_pinconf_bias_get_combo(struct mtk_pinctrl *hw,
 | 
						|
			      const struct mtk_pin_desc *desc,
 | 
						|
			      u32 *pullup, u32 *enable);
 | 
						|
 | 
						|
int mtk_pinconf_drive_set(struct mtk_pinctrl *hw,
 | 
						|
			  const struct mtk_pin_desc *desc, u32 arg);
 | 
						|
int mtk_pinconf_drive_get(struct mtk_pinctrl *hw,
 | 
						|
			  const struct mtk_pin_desc *desc, int *val);
 | 
						|
 | 
						|
int mtk_pinconf_drive_set_rev1(struct mtk_pinctrl *hw,
 | 
						|
			       const struct mtk_pin_desc *desc, u32 arg);
 | 
						|
int mtk_pinconf_drive_get_rev1(struct mtk_pinctrl *hw,
 | 
						|
			       const struct mtk_pin_desc *desc, int *val);
 | 
						|
 | 
						|
int mtk_pinconf_drive_set_raw(struct mtk_pinctrl *hw,
 | 
						|
			       const struct mtk_pin_desc *desc, u32 arg);
 | 
						|
int mtk_pinconf_drive_get_raw(struct mtk_pinctrl *hw,
 | 
						|
			       const struct mtk_pin_desc *desc, int *val);
 | 
						|
 | 
						|
int mtk_pinconf_adv_pull_set(struct mtk_pinctrl *hw,
 | 
						|
			     const struct mtk_pin_desc *desc, bool pullup,
 | 
						|
			     u32 arg);
 | 
						|
int mtk_pinconf_adv_pull_get(struct mtk_pinctrl *hw,
 | 
						|
			     const struct mtk_pin_desc *desc, bool pullup,
 | 
						|
			     u32 *val);
 | 
						|
int mtk_pinconf_adv_drive_set(struct mtk_pinctrl *hw,
 | 
						|
			      const struct mtk_pin_desc *desc, u32 arg);
 | 
						|
int mtk_pinconf_adv_drive_get(struct mtk_pinctrl *hw,
 | 
						|
			      const struct mtk_pin_desc *desc, u32 *val);
 | 
						|
int mtk_pinconf_adv_drive_set_raw(struct mtk_pinctrl *hw,
 | 
						|
				  const struct mtk_pin_desc *desc, u32 arg);
 | 
						|
int mtk_pinconf_adv_drive_get_raw(struct mtk_pinctrl *hw,
 | 
						|
				  const struct mtk_pin_desc *desc, u32 *val);
 | 
						|
 | 
						|
bool mtk_is_virt_gpio(struct mtk_pinctrl *hw, unsigned int gpio_n);
 | 
						|
#endif /* __PINCTRL_MTK_COMMON_V2_H */
 |