Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756634Ab3FLMsj (ORCPT ); Wed, 12 Jun 2013 08:48:39 -0400 Received: from mail-wi0-f180.google.com ([209.85.212.180]:55665 "EHLO mail-wi0-f180.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751402Ab3FLMsh (ORCPT ); Wed, 12 Jun 2013 08:48:37 -0400 From: Grant Likely Subject: Re: [RFC] pinctrl: generic: Add DT bindings To: Laurent Pinchart , linux-kernel@vger.kernel.org Cc: devicetree-discuss@lists.ozlabs.org, Linus Walleij , James Hogan , linux-sh@vger.kernel.org In-Reply-To: <1370988237-30593-1-git-send-email-laurent.pinchart+renesas@ideasonboard.com> References: <1370988237-30593-1-git-send-email-laurent.pinchart+renesas@ideasonboard.com> Date: Wed, 12 Jun 2013 13:48:33 +0100 Message-Id: <20130612124833.A3ADB3E0A56@localhost> Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 5039 Lines: 128 On Wed, 12 Jun 2013 00:03:57 +0200, Laurent Pinchart wrote: > Document DT properties for the generic pinctrl parameters and add a > parser function. > > Signed-off-by: Laurent Pinchart > --- > .../bindings/pinctrl/pinctrl-bindings.txt | 29 +++++++ > drivers/pinctrl/pinconf-generic.c | 94 ++++++++++++++++++++++ > drivers/pinctrl/pinconf.h | 17 ++++ > 3 files changed, 140 insertions(+) > > I've successfully tested this patch (or more accurately only the pull-up and > pull-down properties) with the Renesas sh-pfc pinctrl device driver. I will > resent the sh-pfc DT bindings patch series rebased on the generic pinconf > bindings. > > Not all generic pinconf properties are currently implemented, but I don't > think that should be a showstopper. We can add them later as needed. > > The code is based on both the sh-pfc pinconf DT parser and James Hogan's > tz1090 DT parser ("[PATCH v2 6/9] pinctrl-tz1090: add TZ1090 pinctrl driver"). > > diff --git a/Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt b/Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt > index c95ea82..e499ff0 100644 > --- a/Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt > +++ b/Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt > @@ -126,3 +126,32 @@ device; they may be grandchildren, for example. Whether this is legal, and > whether there is any interaction between the child and intermediate parent > nodes, is again defined entirely by the binding for the individual pin > controller device. > + > +== Generic pinconf parameters == > + > +Pin configuration parameters are expressed by DT properties in the pin > +controller device state nodes and child nodes. For devices that use the generic > +pinconf parameters the following properties are defined. > + > +- tristate: A boolean, put the pin into high impedance state when set. > + > +- pull-up: An integer representing the pull-up strength. 0 disables the pull-up, > + non-zero values enable it. > + > +- pull-down: An integer representing the pull-down strength. 0 disables the > + pull-down, non-zero values enables it. > + > +- schmitt: An integer, enable or disable Schmitt trigger mode for the pins. > + Valid values are > + 0: Schmitt trigger disabled (no hysteresis) > + 1: Schmitt trigger enabled > + > +- slew-rate: An integer controlling the pin slew rate. Values are device- > + dependent. > + > +- drive-strength: An integer representing the drive strength of pins in mA. > + Valid values are device-dependent. > + > +The pinctrl device DT bindings documentation must list the properties that > +apply to the device, and define the valid range for all device-dependent > +values. I don't see any problem with the above properties, but I would like to see an example. How verbose will a pinctrl node using the generic properties tend to be? > diff --git a/drivers/pinctrl/pinconf-generic.c b/drivers/pinctrl/pinconf-generic.c > index 2ad5a8d..bd0e41d 100644 > --- a/drivers/pinctrl/pinconf-generic.c > +++ b/drivers/pinctrl/pinconf-generic.c > @@ -15,6 +15,7 @@ > #include > #include > #include > +#include > #include > #include > #include > @@ -135,3 +136,96 @@ void pinconf_generic_dump_config(struct pinctrl_dev *pctldev, > } > EXPORT_SYMBOL_GPL(pinconf_generic_dump_config); > #endif > + > +struct pinconf_generic_param { > + const char *property; > + enum pin_config_param param; > + bool flag; > +}; > + > +static const struct pinconf_generic_param pinconf_generic_params[] = { > + { "tristate", PIN_CONFIG_BIAS_HIGH_IMPEDANCE, true }, > + { "pull-up", PIN_CONFIG_BIAS_PULL_UP, false }, > + { "pull-down", PIN_CONFIG_BIAS_PULL_DOWN, false }, > + { "schmitt", PIN_CONFIG_INPUT_SCHMITT_ENABLE, true }, > + { "slew-rate", PIN_CONFIG_SLEW_RATE, false }, > + { "drive-strength", PIN_CONFIG_DRIVE_STRENGTH, false }, > +}; > + > +static int pinconf_generic_add_config(unsigned long **configs, > + unsigned int *num_configs, > + unsigned long config) > +{ > + unsigned int count = *num_configs + 1; > + unsigned long *cfgs; > + > + cfgs = krealloc(*configs, sizeof(*cfgs) * count, GFP_KERNEL); > + if (cfgs == NULL) > + return -ENOMEM; > + > + cfgs[count - 1] = config; > + > + *configs = cfgs; > + *num_configs = count; > + > + return 0; > +} Hmmm. We really need a better method of parsing multiple properties. I've been toying around with a few ideas, but haven't been able to draft something I'm happy with yeat. Regardless, the code in this patch looks fine to me. g. -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/