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 #include <linux/errno.h> 14 15 struct dentry; 16 struct device_node; 17 struct seq_file; 18 19 struct pinctrl_dev; 20 struct pinctrl_map; 21 struct pinctrl_setting; 22 23 #ifdef CONFIG_PINCONF 24 25 int pinconf_check_ops(struct pinctrl_dev *pctldev); 26 int pinconf_validate_map(const struct pinctrl_map *map, int i); 27 int pinconf_map_to_setting(const struct pinctrl_map *map, 28 struct pinctrl_setting *setting); 29 void pinconf_free_setting(const struct pinctrl_setting *setting); 30 int pinconf_apply_setting(const struct pinctrl_setting *setting); 31 32 int pinconf_set_config(struct pinctrl_dev *pctldev, unsigned int pin, 33 unsigned long *configs, size_t nconfigs); 34 35 /* 36 * You will only be interested in these if you're using PINCONF 37 * so don't supply any stubs for these. 38 */ 39 int pin_config_get_for_pin(struct pinctrl_dev *pctldev, unsigned int pin, 40 unsigned long *config); 41 int pin_config_group_get(const char *dev_name, const char *pin_group, 42 unsigned long *config); 43 44 #else 45 46 static inline int pinconf_check_ops(struct pinctrl_dev *pctldev) 47 { 48 return 0; 49 } 50 51 static inline int pinconf_validate_map(const struct pinctrl_map *map, int i) 52 { 53 return 0; 54 } 55 56 static inline int pinconf_map_to_setting(const struct pinctrl_map *map, 57 struct pinctrl_setting *setting) 58 { 59 return 0; 60 } 61 62 static inline void pinconf_free_setting(const struct pinctrl_setting *setting) 63 { 64 } 65 66 static inline int pinconf_apply_setting(const struct pinctrl_setting *setting) 67 { 68 return 0; 69 } 70 71 static inline int pinconf_set_config(struct pinctrl_dev *pctldev, unsigned int pin, 72 unsigned long *configs, size_t nconfigs) 73 { 74 return -ENOTSUPP; 75 } 76 77 static inline int pin_config_get_for_pin(struct pinctrl_dev *pctldev, unsigned int pin, 78 unsigned long *config) 79 { 80 return -ENOTSUPP; 81 } 82 83 #endif 84 85 #if defined(CONFIG_PINCONF) && defined(CONFIG_DEBUG_FS) 86 87 void pinconf_show_map(struct seq_file *s, const struct pinctrl_map *map); 88 void pinconf_show_setting(struct seq_file *s, 89 const struct pinctrl_setting *setting); 90 void pinconf_init_device_debugfs(struct dentry *devroot, 91 struct pinctrl_dev *pctldev); 92 93 #else 94 95 static inline void pinconf_show_map(struct seq_file *s, 96 const struct pinctrl_map *map) 97 { 98 } 99 100 static inline void pinconf_show_setting(struct seq_file *s, 101 const struct pinctrl_setting *setting) 102 { 103 } 104 105 static inline void pinconf_init_device_debugfs(struct dentry *devroot, 106 struct pinctrl_dev *pctldev) 107 { 108 } 109 110 #endif 111 112 /* 113 * The following functions are available if the driver uses the generic 114 * pin config. 115 */ 116 117 #if defined(CONFIG_GENERIC_PINCONF) && defined(CONFIG_DEBUG_FS) 118 119 void pinconf_generic_dump_pins(struct pinctrl_dev *pctldev, 120 struct seq_file *s, const char *gname, 121 unsigned int pin); 122 123 void pinconf_generic_dump_config(struct pinctrl_dev *pctldev, 124 struct seq_file *s, unsigned long config); 125 #else 126 127 static inline void pinconf_generic_dump_pins(struct pinctrl_dev *pctldev, 128 struct seq_file *s, 129 const char *gname, unsigned int pin) 130 { 131 return; 132 } 133 134 static inline void pinconf_generic_dump_config(struct pinctrl_dev *pctldev, 135 struct seq_file *s, 136 unsigned long config) 137 { 138 return; 139 } 140 #endif 141 142 #if defined(CONFIG_GENERIC_PINCONF) && defined(CONFIG_OF) 143 int pinconf_generic_parse_dt_config(struct device_node *np, 144 struct pinctrl_dev *pctldev, 145 unsigned long **configs, 146 unsigned int *nconfigs); 147 148 int pinconf_generic_parse_dt_pinmux(struct device_node *np, struct device *dev, 149 unsigned int **pid, unsigned int **pmux, 150 unsigned int *npins); 151 #else 152 static inline int 153 pinconf_generic_parse_dt_config(struct device_node *np, 154 struct pinctrl_dev *pctldev, 155 unsigned long **configs, 156 unsigned int *nconfigs) 157 { 158 return -ENOTSUPP; 159 } 160 161 static inline int 162 pinconf_generic_parse_dt_pinmux(struct device_node *np, struct device *dev, 163 unsigned int **pid, unsigned int **pmux, 164 unsigned int *npins) 165 { 166 return -ENOTSUPP; 167 } 168 #endif 169 170 #if defined(CONFIG_GENERIC_PINCTRL) && defined (CONFIG_OF) 171 int pinctrl_generic_pins_function_dt_node_to_map(struct pinctrl_dev *pctldev, 172 struct device_node *np, 173 struct pinctrl_map **maps, 174 unsigned int *num_maps); 175 #else 176 static inline int 177 pinctrl_generic_pins_function_dt_node_to_map(struct pinctrl_dev *pctldev, 178 struct device_node *np, 179 struct pinctrl_map **maps, 180 unsigned int *num_maps) 181 { 182 return -ENOTSUPP; 183 } 184 #endif 185