806d314325
The lookup key in struct pinctrl_map is (.dev_name, .name). Re-order the struct definition to put the lookup key fields first, and the result values afterwards. To me at least, this slightly better reflects the lookup process. Update the documentation in a similar fashion. Note: PIN_MAP*() macros aren't updated; I plan to update this once later when enhancing the mapping table format to support pin config to reduce churn. Signed-off-by: Stephen Warren <swarren@nvidia.com> Acked-by: Dong Aisheng <dong.aisheng@linaro.org> [Rebased for cherry-picking] Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
79 lines
2.6 KiB
C
79 lines
2.6 KiB
C
/*
|
|
* Machine interface for the pinctrl subsystem.
|
|
*
|
|
* Copyright (C) 2011 ST-Ericsson SA
|
|
* Written on behalf of Linaro for ST-Ericsson
|
|
* Based on bits of regulator core, gpio core and clk core
|
|
*
|
|
* Author: Linus Walleij <linus.walleij@linaro.org>
|
|
*
|
|
* License terms: GNU General Public License (GPL) version 2
|
|
*/
|
|
#ifndef __LINUX_PINCTRL_MACHINE_H
|
|
#define __LINUX_PINCTRL_MACHINE_H
|
|
|
|
/**
|
|
* struct pinctrl_map - boards/machines shall provide this map for devices
|
|
* @dev_name: the name of the device using this specific mapping, the name
|
|
* must be the same as in your struct device*. If this name is set to the
|
|
* same name as the pin controllers own dev_name(), the map entry will be
|
|
* hogged by the driver itself upon registration
|
|
* @name: the name of this specific map entry for the particular machine.
|
|
* This is the second parameter passed to pinmux_get() when you want
|
|
* to have several mappings to the same device
|
|
* @ctrl_dev_name: the name of the device controlling this specific mapping,
|
|
* the name must be the same as in your struct device*
|
|
* @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
|
|
* @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
|
|
*/
|
|
struct pinctrl_map {
|
|
const char *dev_name;
|
|
const char *name;
|
|
const char *ctrl_dev_name;
|
|
const char *function;
|
|
const char *group;
|
|
};
|
|
|
|
/*
|
|
* 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 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, c) \
|
|
{ .name = a, .ctrl_dev_name = b, .dev_name = b, .function = c, }
|
|
|
|
/*
|
|
* 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, d) \
|
|
{ .name = a, .ctrl_dev_name = b, .dev_name = b, .function = c, \
|
|
.group = d, }
|
|
|
|
#ifdef CONFIG_PINMUX
|
|
|
|
extern int pinctrl_register_mappings(struct pinctrl_map const *map,
|
|
unsigned num_maps);
|
|
|
|
#else
|
|
|
|
static inline int pinctrl_register_mappings(struct pinctrl_map const *map,
|
|
unsigned num_maps)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
#endif /* !CONFIG_PINMUX */
|
|
#endif
|