Hi Sergei, On Wed, Aug 30, 2017 at 02:15:32PM +0300, Sergei Shtylyov wrote: > On 8/30/2017 2:11 PM, Baruch Siach wrote: > > > On Wed, Aug 30, 2017 at 02:04:11PM +0300, Sergei Shtylyov wrote: > > > On 8/30/2017 12:51 PM, Baruch Siach wrote: > > > > > > > Add device-tree binding documentation SFP transceivers. Support for SFP > > > > transceivers has been recently introduced (drivers/net/phy/sfp.c). > > > > > > > > Signed-off-by: Baruch Siach <baruch@xxxxxxxxxx> > > > > --- > > > > v2: > > > > Rename -gpio properties to -gpios > > > > Rename the rate-select-gpio property to rate-select0-gpios > > > > Add the rate-select1-gpios property > > > > Add examples > > > > --- > > > > Documentation/devicetree/bindings/net/sff,sfp.txt | 74 +++++++++++++++++++++++ > > > > 1 file changed, 74 insertions(+) > > > > create mode 100644 Documentation/devicetree/bindings/net/sff,sfp.txt > > > > > > > > diff --git a/Documentation/devicetree/bindings/net/sff,sfp.txt b/Documentation/devicetree/bindings/net/sff,sfp.txt > > > > new file mode 100644 > > > > index 000000000000..1d9c786d6287 > > > > --- /dev/null > > > > +++ b/Documentation/devicetree/bindings/net/sff,sfp.txt > > > > @@ -0,0 +1,74 @@ > > > > +Small Form Factor (SFF) Committee Small Form-factor Pluggable (SFP) > > > > +Transceiver > > > > + > > > > +Required properties: > > > > + > > > > +- compatible : must be "sff,sfp" > > > > + > > > > +Optional Properties: > > > > + > > > > +- i2c-bus : phandle of an I2C bus controller for the SFP two wire serial > > > > + interface > > > > + > > > > +- moddef0-gpios : phandle of the MOD-DEF0 (AKA Mod_ABS) module presence input > > > > + gpio signal > > > > > > Your example shows there's GPIO phandle *and* specifier. > > > > Would "GPIO specifier" be enough here? > > No, specifier is the cells following GPIO (or any other) phandle. So this should be "GPIO phandle and specifier of ...", is that correct? I have found very few (< 4) occurrences of this language in (lots of) '-gpios' property descriptions under Documentation/devicetree/bindings/. Is this a new requirement? baruch -- http://baruch.siach.name/blog/ ~. .~ Tk Open Systems =}------------------------------------------------ooO--U--Ooo------------{= - baruch@xxxxxxxxxx - tel: +972.52.368.4656, 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