2012-09-07 05:07:19 +08:00
|
|
|
/*
|
|
|
|
* pin-controller/pin-mux/pin-config/gpio-driver for Samsung's SoC's.
|
|
|
|
*
|
|
|
|
* Copyright (c) 2012 Samsung Electronics Co., Ltd.
|
|
|
|
* http://www.samsung.com
|
|
|
|
* Copyright (c) 2012 Linaro Ltd
|
|
|
|
* http://www.linaro.org
|
|
|
|
*
|
|
|
|
* Author: Thomas Abraham <thomas.ab@samsung.com>
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
|
|
* (at your option) any later version.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __PINCTRL_SAMSUNG_H
|
|
|
|
#define __PINCTRL_SAMSUNG_H
|
|
|
|
|
|
|
|
#include <linux/pinctrl/pinctrl.h>
|
|
|
|
#include <linux/pinctrl/pinmux.h>
|
|
|
|
#include <linux/pinctrl/pinconf.h>
|
|
|
|
#include <linux/pinctrl/consumer.h>
|
|
|
|
#include <linux/pinctrl/machine.h>
|
|
|
|
|
2012-10-11 16:11:17 +08:00
|
|
|
#include <linux/gpio.h>
|
|
|
|
|
2012-09-07 05:07:19 +08:00
|
|
|
/* pinmux function number for pin as gpio output line */
|
2014-08-09 07:48:05 +08:00
|
|
|
#define FUNC_INPUT 0x0
|
2012-09-07 05:07:19 +08:00
|
|
|
#define FUNC_OUTPUT 0x1
|
|
|
|
|
|
|
|
/**
|
|
|
|
* enum pincfg_type - possible pin configuration types supported.
|
2013-03-19 05:31:52 +08:00
|
|
|
* @PINCFG_TYPE_FUNC: Function configuration.
|
|
|
|
* @PINCFG_TYPE_DAT: Pin value configuration.
|
2012-09-07 05:07:19 +08:00
|
|
|
* @PINCFG_TYPE_PUD: Pull up/down configuration.
|
|
|
|
* @PINCFG_TYPE_DRV: Drive strength configuration.
|
|
|
|
* @PINCFG_TYPE_CON_PDN: Pin function in power down mode.
|
|
|
|
* @PINCFG_TYPE_PUD_PDN: Pull up/down configuration in power down mode.
|
|
|
|
*/
|
|
|
|
enum pincfg_type {
|
2013-03-19 05:31:52 +08:00
|
|
|
PINCFG_TYPE_FUNC,
|
|
|
|
PINCFG_TYPE_DAT,
|
2012-09-07 05:07:19 +08:00
|
|
|
PINCFG_TYPE_PUD,
|
|
|
|
PINCFG_TYPE_DRV,
|
|
|
|
PINCFG_TYPE_CON_PDN,
|
|
|
|
PINCFG_TYPE_PUD_PDN,
|
2013-03-19 05:31:52 +08:00
|
|
|
|
|
|
|
PINCFG_TYPE_NUM
|
2012-09-07 05:07:19 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
|
|
* pin configuration (pull up/down and drive strength) type and its value are
|
|
|
|
* packed together into a 16-bits. The upper 8-bits represent the configuration
|
|
|
|
* type and the lower 8-bits hold the value of the configuration type.
|
|
|
|
*/
|
|
|
|
#define PINCFG_TYPE_MASK 0xFF
|
|
|
|
#define PINCFG_VALUE_SHIFT 8
|
|
|
|
#define PINCFG_VALUE_MASK (0xFF << PINCFG_VALUE_SHIFT)
|
|
|
|
#define PINCFG_PACK(type, value) (((value) << PINCFG_VALUE_SHIFT) | type)
|
|
|
|
#define PINCFG_UNPACK_TYPE(cfg) ((cfg) & PINCFG_TYPE_MASK)
|
|
|
|
#define PINCFG_UNPACK_VALUE(cfg) (((cfg) & PINCFG_VALUE_MASK) >> \
|
|
|
|
PINCFG_VALUE_SHIFT)
|
|
|
|
/**
|
|
|
|
* enum eint_type - possible external interrupt types.
|
|
|
|
* @EINT_TYPE_NONE: bank does not support external interrupts
|
|
|
|
* @EINT_TYPE_GPIO: bank supportes external gpio interrupts
|
|
|
|
* @EINT_TYPE_WKUP: bank supportes external wakeup interrupts
|
2012-10-11 16:11:18 +08:00
|
|
|
* @EINT_TYPE_WKUP_MUX: bank supports multiplexed external wakeup interrupts
|
2012-09-07 05:07:19 +08:00
|
|
|
*
|
|
|
|
* Samsung GPIO controller groups all the available pins into banks. The pins
|
|
|
|
* in a pin bank can support external gpio interrupts or external wakeup
|
|
|
|
* interrupts or no interrupts at all. From a software perspective, the only
|
|
|
|
* difference between external gpio and external wakeup interrupts is that
|
|
|
|
* the wakeup interrupts can additionally wakeup the system if it is in
|
|
|
|
* suspended state.
|
|
|
|
*/
|
|
|
|
enum eint_type {
|
|
|
|
EINT_TYPE_NONE,
|
|
|
|
EINT_TYPE_GPIO,
|
|
|
|
EINT_TYPE_WKUP,
|
2012-10-11 16:11:18 +08:00
|
|
|
EINT_TYPE_WKUP_MUX,
|
2012-09-07 05:07:19 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
/* maximum length of a pin in pin descriptor (example: "gpa0-0") */
|
|
|
|
#define PIN_NAME_LENGTH 10
|
|
|
|
|
|
|
|
#define PIN_GROUP(n, p, f) \
|
|
|
|
{ \
|
|
|
|
.name = n, \
|
|
|
|
.pins = p, \
|
|
|
|
.num_pins = ARRAY_SIZE(p), \
|
|
|
|
.func = f \
|
|
|
|
}
|
|
|
|
|
|
|
|
#define PMX_FUNC(n, g) \
|
|
|
|
{ \
|
|
|
|
.name = n, \
|
|
|
|
.groups = g, \
|
|
|
|
.num_groups = ARRAY_SIZE(g), \
|
|
|
|
}
|
|
|
|
|
|
|
|
struct samsung_pinctrl_drv_data;
|
|
|
|
|
2013-03-19 05:31:52 +08:00
|
|
|
/**
|
|
|
|
* struct samsung_pin_bank_type: pin bank type description
|
|
|
|
* @fld_width: widths of configuration bitfields (0 if unavailable)
|
2013-03-19 05:31:53 +08:00
|
|
|
* @reg_offset: offsets of configuration registers (don't care of width is 0)
|
2013-03-19 05:31:52 +08:00
|
|
|
*/
|
|
|
|
struct samsung_pin_bank_type {
|
|
|
|
u8 fld_width[PINCFG_TYPE_NUM];
|
2013-03-19 05:31:53 +08:00
|
|
|
u8 reg_offset[PINCFG_TYPE_NUM];
|
2013-03-19 05:31:52 +08:00
|
|
|
};
|
|
|
|
|
2014-09-24 03:05:41 +08:00
|
|
|
/**
|
|
|
|
* struct samsung_pin_bank_data: represent a controller pin-bank (init data).
|
|
|
|
* @type: type of the bank (register offsets and bitfield widths)
|
|
|
|
* @pctl_offset: starting offset of the pin-bank registers.
|
|
|
|
* @nr_pins: number of pins included in this bank.
|
|
|
|
* @eint_func: function to set in CON register to configure pin as EINT.
|
|
|
|
* @eint_type: type of the external interrupt supported by the bank.
|
|
|
|
* @eint_mask: bit mask of pins which support EINT function.
|
|
|
|
* @eint_offset: SoC-specific EINT register or interrupt offset of bank.
|
|
|
|
* @name: name to be prefixed for each pin in this pin bank.
|
|
|
|
*/
|
|
|
|
struct samsung_pin_bank_data {
|
|
|
|
const struct samsung_pin_bank_type *type;
|
|
|
|
u32 pctl_offset;
|
|
|
|
u8 nr_pins;
|
|
|
|
u8 eint_func;
|
|
|
|
enum eint_type eint_type;
|
|
|
|
u32 eint_mask;
|
|
|
|
u32 eint_offset;
|
|
|
|
const char *name;
|
|
|
|
};
|
|
|
|
|
2012-09-07 05:07:19 +08:00
|
|
|
/**
|
|
|
|
* struct samsung_pin_bank: represent a controller pin-bank.
|
2013-03-19 05:31:52 +08:00
|
|
|
* @type: type of the bank (register offsets and bitfield widths)
|
2012-12-10 08:45:55 +08:00
|
|
|
* @pctl_offset: starting offset of the pin-bank registers.
|
2012-09-07 05:07:19 +08:00
|
|
|
* @nr_pins: number of pins included in this bank.
|
2013-03-19 05:31:55 +08:00
|
|
|
* @eint_func: function to set in CON register to configure pin as EINT.
|
2012-09-07 05:07:19 +08:00
|
|
|
* @eint_type: type of the external interrupt supported by the bank.
|
2013-03-19 05:31:55 +08:00
|
|
|
* @eint_mask: bit mask of pins which support EINT function.
|
2014-09-24 03:05:41 +08:00
|
|
|
* @eint_offset: SoC-specific EINT register or interrupt offset of bank.
|
2012-09-07 05:07:19 +08:00
|
|
|
* @name: name to be prefixed for each pin in this pin bank.
|
2014-09-24 03:05:41 +08:00
|
|
|
* @pin_base: starting pin number of the bank.
|
|
|
|
* @soc_priv: per-bank private data for SoC-specific code.
|
2012-10-11 16:11:13 +08:00
|
|
|
* @of_node: OF node of the bank.
|
2012-10-11 16:11:14 +08:00
|
|
|
* @drvdata: link to controller driver data
|
2012-10-11 16:11:16 +08:00
|
|
|
* @irq_domain: IRQ domain of the bank.
|
2012-10-11 16:11:17 +08:00
|
|
|
* @gpio_chip: GPIO chip of the bank.
|
|
|
|
* @grange: linux gpio pin range supported by this bank.
|
2013-03-19 05:31:50 +08:00
|
|
|
* @slock: spinlock protecting bank registers
|
2013-05-17 12:33:18 +08:00
|
|
|
* @pm_save: saved register values during suspend
|
2012-09-07 05:07:19 +08:00
|
|
|
*/
|
|
|
|
struct samsung_pin_bank {
|
2014-09-24 03:05:39 +08:00
|
|
|
const struct samsung_pin_bank_type *type;
|
2012-09-07 05:07:19 +08:00
|
|
|
u32 pctl_offset;
|
|
|
|
u8 nr_pins;
|
2013-03-19 05:31:55 +08:00
|
|
|
u8 eint_func;
|
2012-09-07 05:07:19 +08:00
|
|
|
enum eint_type eint_type;
|
2013-03-19 05:31:55 +08:00
|
|
|
u32 eint_mask;
|
2012-10-11 16:11:15 +08:00
|
|
|
u32 eint_offset;
|
2014-09-24 03:05:41 +08:00
|
|
|
const char *name;
|
|
|
|
|
|
|
|
u32 pin_base;
|
2013-05-18 00:24:31 +08:00
|
|
|
void *soc_priv;
|
2012-10-11 16:11:13 +08:00
|
|
|
struct device_node *of_node;
|
2012-10-11 16:11:14 +08:00
|
|
|
struct samsung_pinctrl_drv_data *drvdata;
|
2012-10-11 16:11:16 +08:00
|
|
|
struct irq_domain *irq_domain;
|
2012-10-11 16:11:17 +08:00
|
|
|
struct gpio_chip gpio_chip;
|
|
|
|
struct pinctrl_gpio_range grange;
|
2013-03-19 05:31:50 +08:00
|
|
|
spinlock_t slock;
|
2013-05-17 12:33:18 +08:00
|
|
|
|
|
|
|
u32 pm_save[PINCFG_TYPE_NUM + 1]; /* +1 to handle double CON registers*/
|
2012-09-07 05:07:19 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* struct samsung_pin_ctrl: represent a pin controller.
|
|
|
|
* @pin_banks: list of pin banks included in this controller.
|
|
|
|
* @nr_banks: number of pin banks.
|
|
|
|
* @eint_gpio_init: platform specific callback to setup the external gpio
|
|
|
|
* interrupts for the controller.
|
|
|
|
* @eint_wkup_init: platform specific callback to setup the external wakeup
|
|
|
|
* interrupts for the controller.
|
|
|
|
*/
|
|
|
|
struct samsung_pin_ctrl {
|
2014-09-24 03:05:41 +08:00
|
|
|
const struct samsung_pin_bank_data *pin_banks;
|
2012-09-07 05:07:19 +08:00
|
|
|
u32 nr_banks;
|
|
|
|
|
|
|
|
int (*eint_gpio_init)(struct samsung_pinctrl_drv_data *);
|
|
|
|
int (*eint_wkup_init)(struct samsung_pinctrl_drv_data *);
|
2013-05-18 00:24:30 +08:00
|
|
|
void (*suspend)(struct samsung_pinctrl_drv_data *);
|
|
|
|
void (*resume)(struct samsung_pinctrl_drv_data *);
|
2012-09-07 05:07:19 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* struct samsung_pinctrl_drv_data: wrapper for holding driver data together.
|
2013-05-17 12:33:18 +08:00
|
|
|
* @node: global list node
|
2012-09-07 05:07:19 +08:00
|
|
|
* @virt_base: register base address of the controller.
|
|
|
|
* @dev: device instance representing the controller.
|
|
|
|
* @irq: interrpt number used by the controller to notify gpio interrupts.
|
|
|
|
* @ctrl: pin controller instance managed by the driver.
|
|
|
|
* @pctl: pin controller descriptor registered with the pinctrl subsystem.
|
|
|
|
* @pctl_dev: cookie representing pinctrl device instance.
|
|
|
|
* @pin_groups: list of pin groups available to the driver.
|
|
|
|
* @nr_groups: number of such pin groups.
|
|
|
|
* @pmx_functions: list of pin functions available to the driver.
|
|
|
|
* @nr_function: number of such pin functions.
|
2014-09-24 03:05:40 +08:00
|
|
|
* @pin_base: starting system wide pin number.
|
|
|
|
* @nr_pins: number of pins supported by the controller.
|
2012-09-07 05:07:19 +08:00
|
|
|
*/
|
|
|
|
struct samsung_pinctrl_drv_data {
|
2013-05-17 12:33:18 +08:00
|
|
|
struct list_head node;
|
2012-09-07 05:07:19 +08:00
|
|
|
void __iomem *virt_base;
|
|
|
|
struct device *dev;
|
|
|
|
int irq;
|
|
|
|
|
|
|
|
struct pinctrl_desc pctl;
|
|
|
|
struct pinctrl_dev *pctl_dev;
|
|
|
|
|
|
|
|
const struct samsung_pin_group *pin_groups;
|
|
|
|
unsigned int nr_groups;
|
|
|
|
const struct samsung_pmx_func *pmx_functions;
|
|
|
|
unsigned int nr_functions;
|
2014-09-24 03:05:40 +08:00
|
|
|
|
|
|
|
struct samsung_pin_bank *pin_banks;
|
|
|
|
u32 nr_banks;
|
|
|
|
unsigned int pin_base;
|
|
|
|
unsigned int nr_pins;
|
|
|
|
|
|
|
|
void (*suspend)(struct samsung_pinctrl_drv_data *);
|
|
|
|
void (*resume)(struct samsung_pinctrl_drv_data *);
|
2012-09-07 05:07:19 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* struct samsung_pin_group: represent group of pins of a pinmux function.
|
|
|
|
* @name: name of the pin group, used to lookup the group.
|
|
|
|
* @pins: the pins included in this group.
|
|
|
|
* @num_pins: number of pins included in this group.
|
|
|
|
* @func: the function number to be programmed when selected.
|
|
|
|
*/
|
|
|
|
struct samsung_pin_group {
|
|
|
|
const char *name;
|
|
|
|
const unsigned int *pins;
|
|
|
|
u8 num_pins;
|
|
|
|
u8 func;
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* struct samsung_pmx_func: represent a pin function.
|
|
|
|
* @name: name of the pin function, used to lookup the function.
|
|
|
|
* @groups: one or more names of pin groups that provide this function.
|
|
|
|
* @num_groups: number of groups included in @groups.
|
|
|
|
*/
|
|
|
|
struct samsung_pmx_func {
|
|
|
|
const char *name;
|
|
|
|
const char **groups;
|
|
|
|
u8 num_groups;
|
pinctrl: samsung: Allow grouping multiple pinmux/pinconf nodes
One of remaining limitations of current pinctrl-samsung driver was
the inability to parse multiple pinmux/pinconf group nodes grouped
inside a single device tree node. It made defining groups of pins for
single purpose, but with different parameters very inconvenient.
This patch implements Tegra-like support for grouping multiple pinctrl
groups inside one device tree node, by completely changing the way
pin groups and functions are parsed from device tree. The code creating
pinctrl maps from DT nodes has been borrowed from pinctrl-tegra, while
the initial creation of groups and functions has been completely
rewritten with following assumptions:
- each group consists of just one pin and does not depend on data
from device tree,
- each function is represented by a device tree child node of the
pin controller, which in turn can contain multiple child nodes
for pins that need to have different configuration values.
Device Tree bindings are fully backwards compatible. New functionality
can be used by defining a new pinctrl group consisting of several child
nodes, as on following example:
sd4_bus8: sd4-bus-width8 {
part-1 {
samsung,pins = "gpk0-3", "gpk0-4",
"gpk0-5", "gpk0-6";
samsung,pin-function = <3>;
samsung,pin-pud = <3>;
samsung,pin-drv = <3>;
};
part-2 {
samsung,pins = "gpk1-3", "gpk1-4",
"gpk1-5", "gpk1-6";
samsung,pin-function = <4>;
samsung,pin-pud = <4>;
samsung,pin-drv = <3>;
};
};
Tested on Exynos4210-Trats board and a custom Exynos4212-based one.
Signed-off-by: Tomasz Figa <t.figa@samsung.com>
Acked-by: Kyungmin Park <kyungmin.park@samsung.com>
Reviewed-by: Stephen Warren <swarren@nvidia.com>
Cc: devicetree@vger.kernel.org
Cc: Rob Herring <robh+dt@kernel.org>
Cc: Mark Rutland <mark.rutland@arm.com>
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
2014-07-02 23:41:03 +08:00
|
|
|
u32 val;
|
2012-09-07 05:07:19 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
/* list of all exported SoC specific data */
|
2014-09-24 03:05:40 +08:00
|
|
|
extern const struct samsung_pin_ctrl exynos3250_pin_ctrl[];
|
|
|
|
extern const struct samsung_pin_ctrl exynos4210_pin_ctrl[];
|
|
|
|
extern const struct samsung_pin_ctrl exynos4x12_pin_ctrl[];
|
|
|
|
extern const struct samsung_pin_ctrl exynos5250_pin_ctrl[];
|
|
|
|
extern const struct samsung_pin_ctrl exynos5260_pin_ctrl[];
|
|
|
|
extern const struct samsung_pin_ctrl exynos5420_pin_ctrl[];
|
|
|
|
extern const struct samsung_pin_ctrl s3c64xx_pin_ctrl[];
|
|
|
|
extern const struct samsung_pin_ctrl s3c2412_pin_ctrl[];
|
|
|
|
extern const struct samsung_pin_ctrl s3c2416_pin_ctrl[];
|
|
|
|
extern const struct samsung_pin_ctrl s3c2440_pin_ctrl[];
|
|
|
|
extern const struct samsung_pin_ctrl s3c2450_pin_ctrl[];
|
|
|
|
extern const struct samsung_pin_ctrl s5pv210_pin_ctrl[];
|
2012-09-07 05:07:19 +08:00
|
|
|
|
|
|
|
#endif /* __PINCTRL_SAMSUNG_H */
|