Re: [PATCH] spi: dt-binding: clarify gpio chipselect language

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 




Hi Jean-Christophe,

On Thu, Dec 05, 2013 at 05:44:00PM +0100, Jean-Christophe PLAGNIOL-VILLARD wrote:
> On 13:39 Thu 05 Dec     , Baruch Siach wrote:
> > Commit 743179849015 (of_spi: add generic binding support to specify cs gpio)
> > introduced generic binding for gpio chip-select. The cs_gpio struct field,
> > however, is an internal implementation detail of the Linux SPI subsystem, and
> > should not be mentioned in the device tree binding documentation. Mention the
> > previously defined cs-gpios master node property instead.
> > 
> > Cc: Jean-Christophe PLAGNIOL-VILLARD <plagnioj@xxxxxxxxxxxx>
> > Cc: Grant Likely <grant.likely@xxxxxxxxxxxx>
> > Signed-off-by: Baruch Siach <baruch@xxxxxxxxxx>
> > ---
> >  Documentation/devicetree/bindings/spi/spi-bus.txt | 2 +-
> >  1 file changed, 1 insertion(+), 1 deletion(-)
> > 
> > diff --git a/Documentation/devicetree/bindings/spi/spi-bus.txt b/Documentation/devicetree/bindings/spi/spi-bus.txt
> > index 800dafe..e5a4d1b 100644
> > --- a/Documentation/devicetree/bindings/spi/spi-bus.txt
> > +++ b/Documentation/devicetree/bindings/spi/spi-bus.txt
> > @@ -67,7 +67,7 @@ only 1(SINGLE), 2(DUAL) and 4(QUAD).
> >  Dual/Quad mode is not allowed when 3-wire mode is used.
> >  
> >  If a gpio chipselect is used for the SPI slave the gpio number will be passed
> > -via the cs_gpio
> > +via the SPI master node cs-gpios property.
> 
> here it's an information about the c structure

Is binding documentation the place for implementation notes? Especially since 
cs_gpio struct member is never mentioned in this document, and its name is 
confusingly similar to the cs-gpios property name.

baruch

-- 
     http://baruch.siach.name/blog/                  ~. .~   Tk Open Systems
=}------------------------------------------------ooO--U--Ooo------------{=
   - baruch@xxxxxxxxxx - tel: +972.2.679.5364, http://www.tkos.co.il -
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Device Tree Compilter]     [Device Tree Spec]     [Linux Driver Backports]     [Video for Linux]     [Linux USB Devel]     [Linux PCI Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [XFree86]     [Yosemite Backpacking]
  Powered by Linux