drivers/pinctrl/pinmux.h

   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
  15 int pinmux_check_ops(struct pinctrl_dev *pctldev);
  16
  17 int pinmux_validate_map(const struct pinctrl_map *map, int i);
  18
  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);
  27
  28 int pinmux_map_to_setting(const struct pinctrl_map *map,
  29                           struct pinctrl_setting *setting);
  30 void pinmux_free_setting(const struct pinctrl_setting *setting);
  31 int pinmux_enable_setting(const struct pinctrl_setting *setting);
  32 void pinmux_disable_setting(const struct pinctrl_setting *setting);
  33
  34 #else
  35
  36 static inline int pinmux_check_ops(struct pinctrl_dev *pctldev)
  37 {
  38         return 0;
  39 }
  40
  41 static inline int pinmux_validate_map(const struct pinctrl_map *map, int i)
  42 {
  43         return 0;
  44 }
  45
  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
  66 static inline int pinmux_map_to_setting(const struct pinctrl_map *map,
  67                           struct pinctrl_setting *setting)
  68 {
  69         return 0;
  70 }
  71
  72 static inline void pinmux_free_setting(const struct pinctrl_setting *setting)
  73 {
  74 }
  75
  76 static inline int pinmux_enable_setting(const struct pinctrl_setting *setting)
  77 {
  78         return 0;
  79 }
  80
  81 static inline void pinmux_disable_setting(const struct pinctrl_setting *setting)
  82 {
  83 }
  84
  85 #endif
  86
  87 #if defined(CONFIG_PINMUX) && defined(CONFIG_DEBUG_FS)
  88
  89 void pinmux_show_map(struct seq_file *s, const struct pinctrl_map *map);
  90 void pinmux_show_setting(struct seq_file *s,
  91                          const struct pinctrl_setting *setting);
  92 void pinmux_init_device_debugfs(struct dentry *devroot,
  93                                 struct pinctrl_dev *pctldev);
  94
  95 #else
  96
  97 static inline void pinmux_show_map(struct seq_file *s,
  98                                    const struct pinctrl_map *map)
  99 {
 100 }
 101
 102 static inline void pinmux_show_setting(struct seq_file *s,
 103                                        const struct pinctrl_setting *setting)
 104 {
 105 }
 106
 107 static inline void pinmux_init_device_debugfs(struct dentry *devroot,
 108                                               struct pinctrl_dev *pctldev)
 109 {
 110 }
 111
 112 #endif
 113
 114 #ifdef CONFIG_GENERIC_PINMUX_FUNCTIONS
 115
 116 /**
 117  * struct function_desc - generic function descriptor
 118  * @name: name of the function
 119  * @group_names: array of pin group names
 120  * @num_group_names: number of pin group names
 121  * @data: pin controller driver specific data
 122  */
 123 struct function_desc {
 124         const char *name;
 125         const char **group_names;
 126         int num_group_names;
 127         void *data;
 128 };
 129
 130 int pinmux_generic_get_function_count(struct pinctrl_dev *pctldev);
 131
 132 const char *
 133 pinmux_generic_get_function_name(struct pinctrl_dev *pctldev,
 134                                  unsigned int selector);
 135
 136 int pinmux_generic_get_function_groups(struct pinctrl_dev *pctldev,
 137                                        unsigned int selector,
 138                                        const char * const **groups,
 139                                        unsigned * const num_groups);
 140
 141 struct function_desc *pinmux_generic_get_function(struct pinctrl_dev *pctldev,
 142                                                   unsigned int selector);
 143
 144 int pinmux_generic_add_function(struct pinctrl_dev *pctldev,
 145                                 const char *name,
 146                                 const char **groups,
 147                                 unsigned const num_groups,
 148                                 void *data);
 149
 150 int pinmux_generic_remove_function(struct pinctrl_dev *pctldev,
 151                                    unsigned int selector);
 152
 153 static inline int
 154 pinmux_generic_remove_last_function(struct pinctrl_dev *pctldev)
 155 {
 156         return pinmux_generic_remove_function(pctldev,
 157                                               pctldev->num_functions - 1);
 158 }
 159
 160 void pinmux_generic_free_functions(struct pinctrl_dev *pctldev);
 161
 162 #else
 163
 164 static inline void pinmux_generic_free_functions(struct pinctrl_dev *pctldev)
 165 {
 166 }
 167
 168 #endif /* CONFIG_GENERIC_PINMUX_FUNCTIONS */