[mirror_ubuntu-artful-kernel.git] / drivers / pinctrl / pinmux.h

/*
 * Internal interface between the core pin control system and the
 * pinmux portions
 *
 * Copyright (C) 2011 ST-Ericsson SA
 * Written on behalf of Linaro for ST-Ericsson
 * Based on bits of regulator core, gpio core and clk core
 *
 * Author: Linus Walleij <linus.walleij@linaro.org>
 *
 * License terms: GNU General Public License (GPL) version 2
 */
#ifdef CONFIG_PINMUX

int pinmux_check_ops(struct pinctrl_dev *pctldev);

int pinmux_validate_map(struct pinctrl_map const *map, int i);

int pinmux_request_gpio(struct pinctrl_dev *pctldev,
			struct pinctrl_gpio_range *range,
			unsigned pin, unsigned gpio);
void pinmux_free_gpio(struct pinctrl_dev *pctldev, unsigned pin,
		      struct pinctrl_gpio_range *range);
int pinmux_gpio_direction(struct pinctrl_dev *pctldev,
			  struct pinctrl_gpio_range *range,
			  unsigned pin, bool input);

int pinmux_map_to_setting(struct pinctrl_map const *map,
			  struct pinctrl_setting *setting);
void pinmux_free_setting(struct pinctrl_setting const *setting);
int pinmux_enable_setting(struct pinctrl_setting const *setting);
void pinmux_disable_setting(struct pinctrl_setting const *setting);

#else

static inline int pinmux_check_ops(struct pinctrl_dev *pctldev)
{
	return 0;
}

static inline int pinmux_validate_map(struct pinctrl_map const *map, int i)
{
	return 0;
}

static inline int pinmux_request_gpio(struct pinctrl_dev *pctldev,
			struct pinctrl_gpio_range *range,
			unsigned pin, unsigned gpio)
{
	return 0;
}

static inline void pinmux_free_gpio(struct pinctrl_dev *pctldev,
				    unsigned pin,
				    struct pinctrl_gpio_range *range)
{
}

static inline int pinmux_gpio_direction(struct pinctrl_dev *pctldev,
					struct pinctrl_gpio_range *range,
					unsigned pin, bool input)
{
	return 0;
}

static inline int pinmux_map_to_setting(struct pinctrl_map const *map,
			  struct pinctrl_setting *setting)
{
	return 0;
}

static inline void pinmux_free_setting(struct pinctrl_setting const *setting)
{
}

static inline int pinmux_enable_setting(struct pinctrl_setting const *setting)
{
	return 0;
}

static inline void pinmux_disable_setting(
			struct pinctrl_setting const *setting)
{
}

#endif

#if defined(CONFIG_PINMUX) && defined(CONFIG_DEBUG_FS)

void pinmux_show_map(struct seq_file *s, struct pinctrl_map const *map);
void pinmux_show_setting(struct seq_file *s,
			 struct pinctrl_setting const *setting);
void pinmux_init_device_debugfs(struct dentry *devroot,
				struct pinctrl_dev *pctldev);

#else

static inline void pinmux_show_map(struct seq_file *s,
				   struct pinctrl_map const *map)
{
}

static inline void pinmux_show_setting(struct seq_file *s,
				       struct pinctrl_setting const *setting)
{
}

static inline void pinmux_init_device_debugfs(struct dentry *devroot,
					      struct pinctrl_dev *pctldev)
{
}

#endif

#ifdef CONFIG_GENERIC_PINMUX_FUNCTIONS

/**
 * struct function_desc - generic function descriptor
 * @name: name of the function
 * @group_names: array of pin group names
 * @num_group_names: number of pin group names
 * @data: pin controller driver specific data
 */
struct function_desc {
	const char *name;
	const char **group_names;
	int num_group_names;
	void *data;
};

int pinmux_generic_get_function_count(struct pinctrl_dev *pctldev);

const char *
pinmux_generic_get_function_name(struct pinctrl_dev *pctldev,
				 unsigned int selector);

int pinmux_generic_get_function_groups(struct pinctrl_dev *pctldev,
				       unsigned int selector,
				       const char * const **groups,
				       unsigned * const num_groups);

struct function_desc *pinmux_generic_get_function(struct pinctrl_dev *pctldev,
						  unsigned int selector);

int pinmux_generic_add_function(struct pinctrl_dev *pctldev,
				const char *name,
				const char **groups,
				unsigned const num_groups,
				void *data);

int pinmux_generic_remove_function(struct pinctrl_dev *pctldev,
				   unsigned int selector);

static inline int
pinmux_generic_remove_last_function(struct pinctrl_dev *pctldev)
{
	return pinmux_generic_remove_function(pctldev,
					      pctldev->num_functions - 1);
}

void pinmux_generic_free_functions(struct pinctrl_dev *pctldev);

#else

static inline void pinmux_generic_free_functions(struct pinctrl_dev *pctldev)
{
}

#endif /* CONFIG_GENERIC_PINMUX_FUNCTIONS */
Commit	Line	Data
2744e8af LW	1	/*
	2	* Internal interface between the core pin control system and the
	3	* pinmux portions
	4	*
	5	* Copyright (C) 2011 ST-Ericsson SA
	6	* Written on behalf of Linaro for ST-Ericsson
	7	* Based on bits of regulator core, gpio core and clk core
	8	*
	9	* Author: Linus Walleij <linus.walleij@linaro.org>
	10	*
	11	* License terms: GNU General Public License (GPL) version 2
	12	*/
	13	#ifdef CONFIG_PINMUX
	14
b9130b77	15	int pinmux_check_ops(struct pinctrl_dev *pctldev);
7ecdb16f	16
1e2082b5 SW	17	int pinmux_validate_map(struct pinctrl_map const *map, int i);
1e2082b5 SW	18
befe5bdf LW	19	int pinmux_request_gpio(struct pinctrl_dev *pctldev,
	20	struct pinctrl_gpio_range *range,
	21	unsigned pin, unsigned gpio);
	22	void pinmux_free_gpio(struct pinctrl_dev *pctldev, unsigned pin,
	23	struct pinctrl_gpio_range *range);
	24	int pinmux_gpio_direction(struct pinctrl_dev *pctldev,
	25	struct pinctrl_gpio_range *range,
	26	unsigned pin, bool input);
7ecdb16f SW	27
	28	int pinmux_map_to_setting(struct pinctrl_map const *map,
	29	struct pinctrl_setting *setting);
	30	void pinmux_free_setting(struct pinctrl_setting const *setting);
	31	int pinmux_enable_setting(struct pinctrl_setting const *setting);
	32	void pinmux_disable_setting(struct pinctrl_setting const *setting);
	33
2744e8af LW	34	#else
2744e8af LW	35
b9130b77	36	static inline int pinmux_check_ops(struct pinctrl_dev *pctldev)
2744e8af LW	37	{
	38	return 0;
	39	}
	40
1e2082b5 SW	41	static inline int pinmux_validate_map(struct pinctrl_map const *map, int i)
	42	{
	43	return 0;
	44	}
	45
befe5bdf LW	46	static inline int pinmux_request_gpio(struct pinctrl_dev *pctldev,
	47	struct pinctrl_gpio_range *range,
	48	unsigned pin, unsigned gpio)
	49	{
	50	return 0;
	51	}
	52
	53	static inline void pinmux_free_gpio(struct pinctrl_dev *pctldev,
	54	unsigned pin,
	55	struct pinctrl_gpio_range *range)
	56	{
	57	}
	58
	59	static inline int pinmux_gpio_direction(struct pinctrl_dev *pctldev,
	60	struct pinctrl_gpio_range *range,
	61	unsigned pin, bool input)
	62	{
	63	return 0;
	64	}
	65
7ecdb16f SW	66	static inline int pinmux_map_to_setting(struct pinctrl_map const *map,
7ecdb16f SW	67	struct pinctrl_setting *setting)
2744e8af LW	68	{
	69	return 0;
	70	}
	71
7ecdb16f	72	static inline void pinmux_free_setting(struct pinctrl_setting const *setting)
befe5bdf LW	73	{
	74	}
	75
7ecdb16f	76	static inline int pinmux_enable_setting(struct pinctrl_setting const *setting)
befe5bdf	77	{
7ecdb16f	78	return 0;
befe5bdf LW	79	}
befe5bdf LW	80
7ecdb16f SW	81	static inline void pinmux_disable_setting(
7ecdb16f SW	82	struct pinctrl_setting const *setting)
befe5bdf LW	83	{
	84	}
	85
c736d73c SW	86	#endif
	87
	88	#if defined(CONFIG_PINMUX) && defined(CONFIG_DEBUG_FS)
	89
	90	void pinmux_show_map(struct seq_file s, struct pinctrl_map const map);
	91	void pinmux_show_setting(struct seq_file *s,
	92	struct pinctrl_setting const *setting);
	93	void pinmux_init_device_debugfs(struct dentry *devroot,
	94	struct pinctrl_dev *pctldev);
	95
	96	#else
	97
1e2082b5 SW	98	static inline void pinmux_show_map(struct seq_file *s,
	99	struct pinctrl_map const *map)
	100	{
	101	}
	102
	103	static inline void pinmux_show_setting(struct seq_file *s,
	104	struct pinctrl_setting const *setting)
03665e0f SW	105	{
	106	}
	107
1e2082b5 SW	108	static inline void pinmux_init_device_debugfs(struct dentry *devroot,
1e2082b5 SW	109	struct pinctrl_dev *pctldev)
2744e8af LW	110	{
	111	}
	112
	113	#endif
a76edc89 TL	114
	115	#ifdef CONFIG_GENERIC_PINMUX_FUNCTIONS
	116
	117	/**
	118	* struct function_desc - generic function descriptor
	119	* @name: name of the function
	120	* @group_names: array of pin group names
	121	* @num_group_names: number of pin group names
	122	* @data: pin controller driver specific data
	123	*/
	124	struct function_desc {
	125	const char *name;
	126	const char **group_names;
	127	int num_group_names;
	128	void *data;
	129	};
	130
	131	int pinmux_generic_get_function_count(struct pinctrl_dev *pctldev);
	132
	133	const char *
	134	pinmux_generic_get_function_name(struct pinctrl_dev *pctldev,
	135	unsigned int selector);
	136
	137	int pinmux_generic_get_function_groups(struct pinctrl_dev *pctldev,
	138	unsigned int selector,
	139	const char * const **groups,
	140	unsigned * const num_groups);
	141
	142	struct function_desc pinmux_generic_get_function(struct pinctrl_dev pctldev,
	143	unsigned int selector);
	144
	145	int pinmux_generic_add_function(struct pinctrl_dev *pctldev,
	146	const char *name,
	147	const char **groups,
	148	unsigned const num_groups,
	149	void *data);
	150
	151	int pinmux_generic_remove_function(struct pinctrl_dev *pctldev,
	152	unsigned int selector);
	153
	154	static inline int
	155	pinmux_generic_remove_last_function(struct pinctrl_dev *pctldev)
	156	{
	157	return pinmux_generic_remove_function(pctldev,
	158	pctldev->num_functions - 1);
	159	}
	160
	161	void pinmux_generic_free_functions(struct pinctrl_dev *pctldev);
	162
	163	#else
	164
	165	static inline void pinmux_generic_free_functions(struct pinctrl_dev *pctldev)
	166	{
	167	}
	168
	169	#endif /* CONFIG_GENERIC_PINMUX_FUNCTIONS */