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