1 /*
2  * Interface the pinconfig portions of the pinctrl subsystem
3  *
4  * Copyright (C) 2011 ST-Ericsson SA
5  * Written on behalf of Linaro for ST-Ericsson
6  * This interface is used in the core to keep track of pins.
7  *
8  * Author: Linus Walleij <linus.walleij@linaro.org>
9  *
10  * License terms: GNU General Public License (GPL) version 2
11  */
12 #ifndef __LINUX_PINCTRL_PINCONF_H
13 #define __LINUX_PINCTRL_PINCONF_H
14 
15 #ifdef CONFIG_PINCONF
16 
17 #include <linux/pinctrl/machine.h>
18 
19 struct pinctrl_dev;
20 struct seq_file;
21 
22 /**
23  * struct pinconf_ops - pin config operations, to be implemented by
24  * pin configuration capable drivers.
25  * @is_generic: for pin controllers that want to use the generic interface,
26  *	this flag tells the framework that it's generic.
27  * @pin_config_get: get the config of a certain pin, if the requested config
28  *	is not available on this controller this should return -ENOTSUPP
29  *	and if it is available but disabled it should return -EINVAL
30  * @pin_config_set: configure an individual pin
31  * @pin_config_group_get: get configurations for an entire pin group; should
32  *	return -ENOTSUPP and -EINVAL using the same rules as pin_config_get.
33  * @pin_config_group_set: configure all pins in a group
34  * @pin_config_dbg_parse_modify: optional debugfs to modify a pin configuration
35  * @pin_config_dbg_show: optional debugfs display hook that will provide
36  *	per-device info for a certain pin in debugfs
37  * @pin_config_group_dbg_show: optional debugfs display hook that will provide
38  *	per-device info for a certain group in debugfs
39  * @pin_config_config_dbg_show: optional debugfs display hook that will decode
40  *	and display a driver's pin configuration parameter
41  */
42 struct pinconf_ops {
43 #ifdef CONFIG_GENERIC_PINCONF
44 	bool is_generic;
45 #endif
46 	int (*pin_config_get) (struct pinctrl_dev *pctldev,
47 			       unsigned pin,
48 			       unsigned long *config);
49 	int (*pin_config_set) (struct pinctrl_dev *pctldev,
50 			       unsigned pin,
51 			       unsigned long *configs,
52 			       unsigned num_configs);
53 	int (*pin_config_group_get) (struct pinctrl_dev *pctldev,
54 				     unsigned selector,
55 				     unsigned long *config);
56 	int (*pin_config_group_set) (struct pinctrl_dev *pctldev,
57 				     unsigned selector,
58 				     unsigned long *configs,
59 				     unsigned num_configs);
60 	int (*pin_config_dbg_parse_modify) (struct pinctrl_dev *pctldev,
61 					   const char *arg,
62 					   unsigned long *config);
63 	void (*pin_config_dbg_show) (struct pinctrl_dev *pctldev,
64 				     struct seq_file *s,
65 				     unsigned offset);
66 	void (*pin_config_group_dbg_show) (struct pinctrl_dev *pctldev,
67 					   struct seq_file *s,
68 					   unsigned selector);
69 	void (*pin_config_config_dbg_show) (struct pinctrl_dev *pctldev,
70 					    struct seq_file *s,
71 					    unsigned long config);
72 };
73 
74 #endif
75 
76 #endif /* __LINUX_PINCTRL_PINCONF_H */
77