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