183 lines · c
1/* SPDX-License-Identifier: GPL-2.0-only */2/*3 * Internal interface between the core pin control system and the4 * pinmux portions5 *6 * Copyright (C) 2011 ST-Ericsson SA7 * Written on behalf of Linaro for ST-Ericsson8 * Based on bits of regulator core, gpio core and clk core9 *10 * Author: Linus Walleij <linus.walleij@linaro.org>11 */12 13#include <linux/types.h>14 15struct dentry;16struct seq_file;17 18struct pinctrl_dev;19struct pinctrl_gpio_range;20struct pinctrl_map;21struct pinctrl_setting;22 23#ifdef CONFIG_PINMUX24 25int pinmux_check_ops(struct pinctrl_dev *pctldev);26 27int pinmux_validate_map(const struct pinctrl_map *map, int i);28 29bool pinmux_can_be_used_for_gpio(struct pinctrl_dev *pctldev, unsigned int pin);30 31int pinmux_request_gpio(struct pinctrl_dev *pctldev,32 struct pinctrl_gpio_range *range,33 unsigned int pin, unsigned int gpio);34void pinmux_free_gpio(struct pinctrl_dev *pctldev, unsigned int pin,35 struct pinctrl_gpio_range *range);36int pinmux_gpio_direction(struct pinctrl_dev *pctldev,37 struct pinctrl_gpio_range *range,38 unsigned int pin, bool input);39 40int pinmux_map_to_setting(const struct pinctrl_map *map,41 struct pinctrl_setting *setting);42void pinmux_free_setting(const struct pinctrl_setting *setting);43int pinmux_enable_setting(const struct pinctrl_setting *setting);44void pinmux_disable_setting(const struct pinctrl_setting *setting);45 46#else47 48static inline int pinmux_check_ops(struct pinctrl_dev *pctldev)49{50 return 0;51}52 53static inline int pinmux_validate_map(const struct pinctrl_map *map, int i)54{55 return 0;56}57 58static inline bool pinmux_can_be_used_for_gpio(struct pinctrl_dev *pctldev,59 unsigned int pin)60{61 return true;62}63 64static inline int pinmux_request_gpio(struct pinctrl_dev *pctldev,65 struct pinctrl_gpio_range *range,66 unsigned int pin, unsigned int gpio)67{68 return 0;69}70 71static inline void pinmux_free_gpio(struct pinctrl_dev *pctldev,72 unsigned int pin,73 struct pinctrl_gpio_range *range)74{75}76 77static inline int pinmux_gpio_direction(struct pinctrl_dev *pctldev,78 struct pinctrl_gpio_range *range,79 unsigned int pin, bool input)80{81 return 0;82}83 84static inline int pinmux_map_to_setting(const struct pinctrl_map *map,85 struct pinctrl_setting *setting)86{87 return 0;88}89 90static inline void pinmux_free_setting(const struct pinctrl_setting *setting)91{92}93 94static inline int pinmux_enable_setting(const struct pinctrl_setting *setting)95{96 return 0;97}98 99static inline void pinmux_disable_setting(const struct pinctrl_setting *setting)100{101}102 103#endif104 105#if defined(CONFIG_PINMUX) && defined(CONFIG_DEBUG_FS)106 107void pinmux_show_map(struct seq_file *s, const struct pinctrl_map *map);108void pinmux_show_setting(struct seq_file *s,109 const struct pinctrl_setting *setting);110void pinmux_init_device_debugfs(struct dentry *devroot,111 struct pinctrl_dev *pctldev);112 113#else114 115static inline void pinmux_show_map(struct seq_file *s,116 const struct pinctrl_map *map)117{118}119 120static inline void pinmux_show_setting(struct seq_file *s,121 const struct pinctrl_setting *setting)122{123}124 125static inline void pinmux_init_device_debugfs(struct dentry *devroot,126 struct pinctrl_dev *pctldev)127{128}129 130#endif131 132#ifdef CONFIG_GENERIC_PINMUX_FUNCTIONS133 134/**135 * struct function_desc - generic function descriptor136 * @func: generic data of the pin function (name and groups of pins)137 * @data: pin controller driver specific data138 */139struct function_desc {140 struct pinfunction func;141 void *data;142};143 144/* Convenient macro to define a generic pin function descriptor */145#define PINCTRL_FUNCTION_DESC(_name, _grps, _num_grps, _data) \146(struct function_desc) { \147 .func = PINCTRL_PINFUNCTION(_name, _grps, _num_grps), \148 .data = _data, \149}150 151int pinmux_generic_get_function_count(struct pinctrl_dev *pctldev);152 153const char *154pinmux_generic_get_function_name(struct pinctrl_dev *pctldev,155 unsigned int selector);156 157int pinmux_generic_get_function_groups(struct pinctrl_dev *pctldev,158 unsigned int selector,159 const char * const **groups,160 unsigned int * const ngroups);161 162struct function_desc *pinmux_generic_get_function(struct pinctrl_dev *pctldev,163 unsigned int selector);164 165int pinmux_generic_add_function(struct pinctrl_dev *pctldev,166 const char *name,167 const char * const *groups,168 unsigned int const ngroups,169 void *data);170 171int pinmux_generic_remove_function(struct pinctrl_dev *pctldev,172 unsigned int selector);173 174void pinmux_generic_free_functions(struct pinctrl_dev *pctldev);175 176#else177 178static inline void pinmux_generic_free_functions(struct pinctrl_dev *pctldev)179{180}181 182#endif /* CONFIG_GENERIC_PINMUX_FUNCTIONS */183