xref: /openbmc/linux/drivers/pinctrl/pinconf.h (revision 7f6964c5)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Internal interface between the core pin control system and the
4  * pin config portions
5  *
6  * Copyright (C) 2011 ST-Ericsson SA
7  * Written on behalf of Linaro for ST-Ericsson
8  * Based on bits of regulator core, gpio core and clk core
9  *
10  * Author: Linus Walleij <linus.walleij@linaro.org>
11  */
12 
13 #ifdef CONFIG_PINCONF
14 
15 int pinconf_check_ops(struct pinctrl_dev *pctldev);
16 int pinconf_validate_map(const struct pinctrl_map *map, int i);
17 int pinconf_map_to_setting(const struct pinctrl_map *map,
18 			  struct pinctrl_setting *setting);
19 void pinconf_free_setting(const struct pinctrl_setting *setting);
20 int pinconf_apply_setting(const struct pinctrl_setting *setting);
21 
22 int pinconf_set_config(struct pinctrl_dev *pctldev, unsigned pin,
23 		       unsigned long *configs, size_t nconfigs);
24 
25 /*
26  * You will only be interested in these if you're using PINCONF
27  * so don't supply any stubs for these.
28  */
29 int pin_config_get_for_pin(struct pinctrl_dev *pctldev, unsigned pin,
30 			   unsigned long *config);
31 int pin_config_group_get(const char *dev_name, const char *pin_group,
32 			 unsigned long *config);
33 
34 #else
35 
36 static inline int pinconf_check_ops(struct pinctrl_dev *pctldev)
37 {
38 	return 0;
39 }
40 
41 static inline int pinconf_validate_map(const struct pinctrl_map *map, int i)
42 {
43 	return 0;
44 }
45 
46 static inline int pinconf_map_to_setting(const struct pinctrl_map *map,
47 			  struct pinctrl_setting *setting)
48 {
49 	return 0;
50 }
51 
52 static inline void pinconf_free_setting(const struct pinctrl_setting *setting)
53 {
54 }
55 
56 static inline int pinconf_apply_setting(const struct pinctrl_setting *setting)
57 {
58 	return 0;
59 }
60 
61 static inline int pinconf_set_config(struct pinctrl_dev *pctldev, unsigned pin,
62 				     unsigned long *configs, size_t nconfigs)
63 {
64 	return -ENOTSUPP;
65 }
66 
67 #endif
68 
69 #if defined(CONFIG_PINCONF) && defined(CONFIG_DEBUG_FS)
70 
71 void pinconf_show_map(struct seq_file *s, const struct pinctrl_map *map);
72 void pinconf_show_setting(struct seq_file *s,
73 			  const struct pinctrl_setting *setting);
74 void pinconf_init_device_debugfs(struct dentry *devroot,
75 				 struct pinctrl_dev *pctldev);
76 
77 #else
78 
79 static inline void pinconf_show_map(struct seq_file *s,
80 				    const struct pinctrl_map *map)
81 {
82 }
83 
84 static inline void pinconf_show_setting(struct seq_file *s,
85 					const struct pinctrl_setting *setting)
86 {
87 }
88 
89 static inline void pinconf_init_device_debugfs(struct dentry *devroot,
90 					       struct pinctrl_dev *pctldev)
91 {
92 }
93 
94 #endif
95 
96 /*
97  * The following functions are available if the driver uses the generic
98  * pin config.
99  */
100 
101 #if defined(CONFIG_GENERIC_PINCONF) && defined(CONFIG_DEBUG_FS)
102 
103 void pinconf_generic_dump_pins(struct pinctrl_dev *pctldev,
104 			       struct seq_file *s, const char *gname,
105 			       unsigned pin);
106 
107 void pinconf_generic_dump_config(struct pinctrl_dev *pctldev,
108 				 struct seq_file *s, unsigned long config);
109 #else
110 
111 static inline void pinconf_generic_dump_pins(struct pinctrl_dev *pctldev,
112 					     struct seq_file *s,
113 					     const char *gname, unsigned pin)
114 {
115 	return;
116 }
117 
118 static inline void pinconf_generic_dump_config(struct pinctrl_dev *pctldev,
119 					       struct seq_file *s,
120 					       unsigned long config)
121 {
122 	return;
123 }
124 #endif
125 
126 #if defined(CONFIG_GENERIC_PINCONF) && defined(CONFIG_OF)
127 int pinconf_generic_parse_dt_config(struct device_node *np,
128 				    struct pinctrl_dev *pctldev,
129 				    unsigned long **configs,
130 				    unsigned int *nconfigs);
131 #endif
132