pinctrl: enhance mapping table to support pin config operations
The pinctrl mapping table can now contain entries to: * Set the mux function of a pin group * Apply a set of pin config options to a pin or a group This allows pinctrl_select_state() to apply pin configs settings as well as mux settings. v3: Fix find_pinctrl() to iterate over the correct list. s/_MUX_CONFIGS_/_CONFIGS_/ in mapping table macros. Fix documentation to use correct mapping table macro. v2: Added numerous extra PIN_MAP_*() special-case macros. Fixed kerneldoc typo. Delete pinctrl_get_pin_id() and replace it with pin_get_from_name(). Various minor fixes. Updates due to rebase. Signed-off-by: Stephen Warren <swarren@nvidia.com> Acked-by: Dong Aisheng <dong.aisheng@linaro.org> Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
This commit is contained in:
Stephen Warren
committed by
Linus Walleij
Linus Walleij
parent
6e5e959dde
commit
1e2082b520
@@ -14,6 +14,41 @@
|
||||
|
||||
#include "pinctrl.h"
|
||||
|
||||
enum pinctrl_map_type {
|
||||
PIN_MAP_TYPE_INVALID,
|
||||
PIN_MAP_TYPE_DUMMY_STATE,
|
||||
PIN_MAP_TYPE_MUX_GROUP,
|
||||
PIN_MAP_TYPE_CONFIGS_PIN,
|
||||
PIN_MAP_TYPE_CONFIGS_GROUP,
|
||||
};
|
||||
|
||||
/**
|
||||
* struct pinctrl_map_mux - mapping table content for MAP_TYPE_MUX_GROUP
|
||||
* @group: the name of the group whose mux function is to be configured. This
|
||||
* field may be left NULL, and the first applicable group for the function
|
||||
* will be used.
|
||||
* @function: the mux function to select for the group
|
||||
*/
|
||||
struct pinctrl_map_mux {
|
||||
const char *group;
|
||||
const char *function;
|
||||
};
|
||||
|
||||
/**
|
||||
* struct pinctrl_map_configs - mapping table content for MAP_TYPE_CONFIGS_*
|
||||
* @group_or_pin: the name of the pin or group whose configuration parameters
|
||||
* are to be configured.
|
||||
* @configs: a pointer to an array of config parameters/values to program into
|
||||
* hardware. Each individual pin controller defines the format and meaning
|
||||
* of config parameters.
|
||||
* @num_configs: the number of entries in array @configs
|
||||
*/
|
||||
struct pinctrl_map_configs {
|
||||
const char *group_or_pin;
|
||||
unsigned long *configs;
|
||||
unsigned num_configs;
|
||||
};
|
||||
|
||||
/**
|
||||
* struct pinctrl_map - boards/machines shall provide this map for devices
|
||||
* @dev_name: the name of the device using this specific mapping, the name
|
||||
@@ -22,46 +57,96 @@
|
||||
* hogged by the driver itself upon registration
|
||||
* @name: the name of this specific map entry for the particular machine.
|
||||
* This is the parameter passed to pinmux_lookup_state()
|
||||
* @type: the type of mapping table entry
|
||||
* @ctrl_dev_name: the name of the device controlling this specific mapping,
|
||||
* the name must be the same as in your struct device*
|
||||
* @group: sometimes a function can map to different pin groups, so this
|
||||
* selects a certain specific pin group to activate for the function, if
|
||||
* left as NULL, the first applicable group will be used
|
||||
* @function: a function in the driver to use for this mapping, the driver
|
||||
* will lookup the function referenced by this ID on the specified
|
||||
* pin control device
|
||||
* the name must be the same as in your struct device*. This field is not
|
||||
* used for PIN_MAP_TYPE_DUMMY_STATE
|
||||
* @data: Data specific to the mapping type
|
||||
*/
|
||||
struct pinctrl_map {
|
||||
const char *dev_name;
|
||||
const char *name;
|
||||
enum pinctrl_map_type type;
|
||||
const char *ctrl_dev_name;
|
||||
const char *group;
|
||||
const char *function;
|
||||
union {
|
||||
struct pinctrl_map_mux mux;
|
||||
struct pinctrl_map_configs configs;
|
||||
} data;
|
||||
};
|
||||
|
||||
/*
|
||||
* Convenience macro to set a simple map from a certain pin controller and a
|
||||
* certain function to a named device
|
||||
*/
|
||||
#define PIN_MAP(a, b, c, d) \
|
||||
{ .name = a, .ctrl_dev_name = b, .function = c, .dev_name = d }
|
||||
/* Convenience macros to create mapping table entries */
|
||||
|
||||
/*
|
||||
* Convenience macro to map a system function onto a certain pinctrl device,
|
||||
* to be hogged by the pin control core until the system shuts down.
|
||||
*/
|
||||
#define PIN_MAP_SYS_HOG(a, b) \
|
||||
{ .name = PINCTRL_STATE_DEFAULT, .ctrl_dev_name = a, .dev_name = a, \
|
||||
.function = b, }
|
||||
#define PIN_MAP_DUMMY_STATE(dev, state) \
|
||||
{ \
|
||||
.dev_name = dev, \
|
||||
.name = state, \
|
||||
.type = PIN_MAP_TYPE_DUMMY_STATE, \
|
||||
}
|
||||
|
||||
/*
|
||||
* Convenience macro to map a system function onto a certain pinctrl device
|
||||
* using a specified group, to be hogged by the pin control core until the
|
||||
* system shuts down.
|
||||
*/
|
||||
#define PIN_MAP_SYS_HOG_GROUP(a, b, c) \
|
||||
{ .name = PINCTRL_STATE_DEFAULT, .ctrl_dev_name = a, .dev_name = a, \
|
||||
.function = b, .group = c, }
|
||||
#define PIN_MAP_MUX_GROUP(dev, state, pinctrl, grp, func) \
|
||||
{ \
|
||||
.dev_name = dev, \
|
||||
.name = state, \
|
||||
.type = PIN_MAP_TYPE_MUX_GROUP, \
|
||||
.ctrl_dev_name = pinctrl, \
|
||||
.data.mux = { \
|
||||
.group = grp, \
|
||||
.function = func, \
|
||||
}, \
|
||||
}
|
||||
|
||||
#define PIN_MAP_MUX_GROUP_DEFAULT(dev, pinctrl, grp, func) \
|
||||
PIN_MAP_MUX_GROUP(dev, PINCTRL_STATE_DEFAULT, pinctrl, grp, func)
|
||||
|
||||
#define PIN_MAP_MUX_GROUP_HOG(dev, state, grp, func) \
|
||||
PIN_MAP_MUX_GROUP(dev, state, dev, grp, func)
|
||||
|
||||
#define PIN_MAP_MUX_GROUP_HOG_DEFAULT(dev, grp, func) \
|
||||
PIN_MAP_MUX_GROUP(dev, PINCTRL_STATE_DEFAULT, dev, grp, func)
|
||||
|
||||
#define PIN_MAP_CONFIGS_PIN(dev, state, pinctrl, pin, cfgs) \
|
||||
{ \
|
||||
.dev_name = dev, \
|
||||
.name = state, \
|
||||
.type = PIN_MAP_TYPE_CONFIGS_PIN, \
|
||||
.ctrl_dev_name = pinctrl, \
|
||||
.data.configs = { \
|
||||
.group_or_pin = pin, \
|
||||
.configs = cfgs, \
|
||||
.num_configs = ARRAY_SIZE(cfgs), \
|
||||
}, \
|
||||
}
|
||||
|
||||
#define PIN_MAP_CONFIGS_PIN_DEFAULT(dev, pinctrl, pin, cfgs) \
|
||||
PIN_MAP_CONFIGS_PIN(dev, PINCTRL_STATE_DEFAULT, pinctrl, pin, cfgs)
|
||||
|
||||
#define PIN_MAP_CONFIGS_PIN_HOG(dev, state, pin, cfgs) \
|
||||
PIN_MAP_CONFIGS_PIN(dev, state, dev, pin, cfgs)
|
||||
|
||||
#define PIN_MAP_CONFIGS_PIN_HOG_DEFAULT(dev, pin, cfgs) \
|
||||
PIN_MAP_CONFIGS_PIN(dev, PINCTRL_STATE_DEFAULT, dev, pin, cfgs)
|
||||
|
||||
#define PIN_MAP_CONFIGS_GROUP(dev, state, pinctrl, grp, cfgs) \
|
||||
{ \
|
||||
.dev_name = dev, \
|
||||
.name = state, \
|
||||
.type = PIN_MAP_TYPE_CONFIGS_GROUP, \
|
||||
.ctrl_dev_name = pinctrl, \
|
||||
.data.configs = { \
|
||||
.group_or_pin = grp, \
|
||||
.configs = cfgs, \
|
||||
.num_configs = ARRAY_SIZE(cfgs), \
|
||||
}, \
|
||||
}
|
||||
|
||||
#define PIN_MAP_CONFIGS_GROUP_DEFAULT(dev, pinctrl, grp, cfgs) \
|
||||
PIN_MAP_CONFIGS_GROUP(dev, PINCTRL_STATE_DEFAULT, pinctrl, grp, cfgs)
|
||||
|
||||
#define PIN_MAP_CONFIGS_GROUP_HOG(dev, state, grp, cfgs) \
|
||||
PIN_MAP_CONFIGS_GROUP(dev, state, dev, grp, cfgs)
|
||||
|
||||
#define PIN_MAP_CONFIGS_GROUP_HOG_DEFAULT(dev, grp, cfgs) \
|
||||
PIN_MAP_CONFIGS_GROUP(dev, PINCTRL_STATE_DEFAULT, dev, grp, cfgs)
|
||||
|
||||
#ifdef CONFIG_PINMUX
|
||||
|
||||
|
||||
Reference in New Issue
Block a user