LXR linux/include/linux/pinctrl/consumer.h

   1/*
   2 * Consumer interface the pin control subsystem
   3 *
   4 * Copyright (C) 2012 ST-Ericsson SA
   5 * Written on behalf of Linaro for ST-Ericsson
   6 * Based on bits of regulator core, gpio core and clk core
   7 *
   8 * Author: Linus Walleij <linus.walleij@linaro.org>
   9 *
  10 * License terms: GNU General Public License (GPL) version 2
  11 */
  12#ifndef __LINUX_PINCTRL_CONSUMER_H
  13#define __LINUX_PINCTRL_CONSUMER_H
  14
  15#include <linux/err.h>
  16#include <linux/list.h>
  17#include <linux/seq_file.h>
  18#include <linux/pinctrl/pinctrl-state.h>
  19
  20/* This struct is private to the core and should be regarded as a cookie */
  21struct pinctrl;
  22struct pinctrl_state;
  23struct device;
  24
  25#ifdef CONFIG_PINCTRL
  26
  27/* External interface to pin control */
  28extern int pinctrl_request_gpio(unsigned gpio);
  29extern void pinctrl_free_gpio(unsigned gpio);
  30extern int pinctrl_gpio_direction_input(unsigned gpio);
  31extern int pinctrl_gpio_direction_output(unsigned gpio);
  32
  33extern struct pinctrl * __must_check pinctrl_get(struct device *dev);
  34extern void pinctrl_put(struct pinctrl *p);
  35extern struct pinctrl_state * __must_check pinctrl_lookup_state(
  36                                                        struct pinctrl *p,
  37                                                        const char *name);
  38extern int pinctrl_select_state(struct pinctrl *p, struct pinctrl_state *s);
  39
  40extern struct pinctrl * __must_check devm_pinctrl_get(struct device *dev);
  41extern void devm_pinctrl_put(struct pinctrl *p);
  42
  43#ifdef CONFIG_PM
  44extern int pinctrl_pm_select_default_state(struct device *dev);
  45extern int pinctrl_pm_select_sleep_state(struct device *dev);
  46extern int pinctrl_pm_select_idle_state(struct device *dev);
  47#else
  48static inline int pinctrl_pm_select_default_state(struct device *dev)
  49{
  50        return 0;
  51}
  52static inline int pinctrl_pm_select_sleep_state(struct device *dev)
  53{
  54        return 0;
  55}
  56static inline int pinctrl_pm_select_idle_state(struct device *dev)
  57{
  58        return 0;
  59}
  60#endif
  61
  62#else /* !CONFIG_PINCTRL */
  63
  64static inline int pinctrl_request_gpio(unsigned gpio)
  65{
  66        return 0;
  67}
  68
  69static inline void pinctrl_free_gpio(unsigned gpio)
  70{
  71}
  72
  73static inline int pinctrl_gpio_direction_input(unsigned gpio)
  74{
  75        return 0;
  76}
  77
  78static inline int pinctrl_gpio_direction_output(unsigned gpio)
  79{
  80        return 0;
  81}
  82
  83static inline struct pinctrl * __must_check pinctrl_get(struct device *dev)
  84{
  85        return NULL;
  86}
  87
  88static inline void pinctrl_put(struct pinctrl *p)
  89{
  90}
  91
  92static inline struct pinctrl_state * __must_check pinctrl_lookup_state(
  93                                                        struct pinctrl *p,
  94                                                        const char *name)
  95{
  96        return NULL;
  97}
  98
  99static inline int pinctrl_select_state(struct pinctrl *p,
 100                                       struct pinctrl_state *s)
 101{
 102        return 0;
 103}
 104
 105static inline struct pinctrl * __must_check devm_pinctrl_get(struct device *dev)
 106{
 107        return NULL;
 108}
 109
 110static inline void devm_pinctrl_put(struct pinctrl *p)
 111{
 112}
 113
 114static inline int pinctrl_pm_select_default_state(struct device *dev)
 115{
 116        return 0;
 117}
 118
 119static inline int pinctrl_pm_select_sleep_state(struct device *dev)
 120{
 121        return 0;
 122}
 123
 124static inline int pinctrl_pm_select_idle_state(struct device *dev)
 125{
 126        return 0;
 127}
 128
 129#endif /* CONFIG_PINCTRL */
 130
 131static inline struct pinctrl * __must_check pinctrl_get_select(
 132                                        struct device *dev, const char *name)
 133{
 134        struct pinctrl *p;
 135        struct pinctrl_state *s;
 136        int ret;
 137
 138        p = pinctrl_get(dev);
 139        if (IS_ERR(p))
 140                return p;
 141
 142        s = pinctrl_lookup_state(p, name);
 143        if (IS_ERR(s)) {
 144                pinctrl_put(p);
 145                return ERR_CAST(s);
 146        }
 147
 148        ret = pinctrl_select_state(p, s);
 149        if (ret < 0) {
 150                pinctrl_put(p);
 151                return ERR_PTR(ret);
 152        }
 153
 154        return p;
 155}
 156
 157static inline struct pinctrl * __must_check pinctrl_get_select_default(
 158                                        struct device *dev)
 159{
 160        return pinctrl_get_select(dev, PINCTRL_STATE_DEFAULT);
 161}
 162
 163static inline struct pinctrl * __must_check devm_pinctrl_get_select(
 164                                        struct device *dev, const char *name)
 165{
 166        struct pinctrl *p;
 167        struct pinctrl_state *s;
 168        int ret;
 169
 170        p = devm_pinctrl_get(dev);
 171        if (IS_ERR(p))
 172                return p;
 173
 174        s = pinctrl_lookup_state(p, name);
 175        if (IS_ERR(s)) {
 176                devm_pinctrl_put(p);
 177                return ERR_CAST(s);
 178        }
 179
 180        ret = pinctrl_select_state(p, s);
 181        if (ret < 0) {
 182                devm_pinctrl_put(p);
 183                return ERR_PTR(ret);
 184        }
 185
 186        return p;
 187}
 188
 189static inline struct pinctrl * __must_check devm_pinctrl_get_select_default(
 190                                        struct device *dev)
 191{
 192        return devm_pinctrl_get_select(dev, PINCTRL_STATE_DEFAULT);
 193}
 194
 195#endif /* __LINUX_PINCTRL_CONSUMER_H */
 196