LXR linux/include/linux/pinctrl/pinconf.h

   1/*
   2 * Interface the pinconfig portions of the pinctrl subsystem
   3 *
   4 * Copyright (C) 2011 ST-Ericsson SA
   5 * Written on behalf of Linaro for ST-Ericsson
   6 * This interface is used in the core to keep track of pins.
   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_PINCONF_H
  13#define __LINUX_PINCTRL_PINCONF_H
  14
  15#ifdef CONFIG_PINCONF
  16
  17#include <linux/pinctrl/machine.h>
  18
  19struct pinctrl_dev;
  20struct seq_file;
  21
  22/**
  23 * struct pinconf_ops - pin config operations, to be implemented by
  24 * pin configuration capable drivers.
  25 * @is_generic: for pin controllers that want to use the generic interface,
  26 *      this flag tells the framework that it's generic.
  27 * @pin_config_get: get the config of a certain pin, if the requested config
  28 *      is not available on this controller this should return -ENOTSUPP
  29 *      and if it is available but disabled it should return -EINVAL
  30 * @pin_config_set: configure an individual pin
  31 * @pin_config_group_get: get configurations for an entire pin group; should
  32 *      return -ENOTSUPP and -EINVAL using the same rules as pin_config_get.
  33 * @pin_config_group_set: configure all pins in a group
  34 * @pin_config_dbg_parse_modify: optional debugfs to modify a pin configuration
  35 * @pin_config_dbg_show: optional debugfs display hook that will provide
  36 *      per-device info for a certain pin in debugfs
  37 * @pin_config_group_dbg_show: optional debugfs display hook that will provide
  38 *      per-device info for a certain group in debugfs
  39 * @pin_config_config_dbg_show: optional debugfs display hook that will decode
  40 *      and display a driver's pin configuration parameter
  41 */
  42struct pinconf_ops {
  43#ifdef CONFIG_GENERIC_PINCONF
  44        bool is_generic;
  45#endif
  46        int (*pin_config_get) (struct pinctrl_dev *pctldev,
  47                               unsigned pin,
  48                               unsigned long *config);
  49        int (*pin_config_set) (struct pinctrl_dev *pctldev,
  50                               unsigned pin,
  51                               unsigned long *configs,
  52                               unsigned num_configs);
  53        int (*pin_config_group_get) (struct pinctrl_dev *pctldev,
  54                                     unsigned selector,
  55                                     unsigned long *config);
  56        int (*pin_config_group_set) (struct pinctrl_dev *pctldev,
  57                                     unsigned selector,
  58                                     unsigned long *configs,
  59                                     unsigned num_configs);
  60        int (*pin_config_dbg_parse_modify) (struct pinctrl_dev *pctldev,
  61                                           const char *arg,
  62                                           unsigned long *config);
  63        void (*pin_config_dbg_show) (struct pinctrl_dev *pctldev,
  64                                     struct seq_file *s,
  65                                     unsigned offset);
  66        void (*pin_config_group_dbg_show) (struct pinctrl_dev *pctldev,
  67                                           struct seq_file *s,
  68                                           unsigned selector);
  69        void (*pin_config_config_dbg_show) (struct pinctrl_dev *pctldev,
  70                                            struct seq_file *s,
  71                                            unsigned long config);
  72};
  73
  74#endif
  75
  76#endif /* __LINUX_PINCTRL_PINCONF_H */
  77