Re: [PATCH net-next 2/2] net: nixge: Update device-tree bindings with v3.00

From: Rob Herring
Date: Mon Nov 12 2018 - 19:26:30 EST


On Mon, Nov 12, 2018 at 5:41 PM Alex Williams <alex.williams@xxxxxxxxx> wrote:
>
> On Mon, Nov 12, 2018 at 3:36 PM Rob Herring <robh@xxxxxxxxxx> wrote:
> >
> > On Mon, Oct 29, 2018 at 04:14:47PM -0700, alex.williams@xxxxxxxxx wrote:
> > > From: Alex Williams <alex.williams@xxxxxx>
> > >
> > > Now the DMA engine is free to float elsewhere in the system map.
> > >
> > > Signed-off-by: Alex Williams <alex.williams@xxxxxx>
> > > ---
> > > Documentation/devicetree/bindings/net/nixge.txt | 14 +++++++++++---
> > > 1 file changed, 11 insertions(+), 3 deletions(-)
> > >
> > > diff --git a/Documentation/devicetree/bindings/net/nixge.txt b/Documentation/devicetree/bindings/net/nixge.txt
> > > index e55af7f0881a..d0f9fb520578 100644
> > > --- a/Documentation/devicetree/bindings/net/nixge.txt
> > > +++ b/Documentation/devicetree/bindings/net/nixge.txt
> > > @@ -1,8 +1,14 @@
> > > * NI XGE Ethernet controller
> > >
> > > Required properties:
> > > -- compatible: Should be "ni,xge-enet-2.00"
> > > -- reg: Address and length of the register set for the device
> > > +- compatible: Should be "ni,xge-enet-3.00", but can be "ni,xge-enet-2.00" for
> > > + older device trees with DMA engines co-located in the address map,
> > > + with the one reg entry to describe the whole device.
> > > +- reg: Address and length of the register set for the device. It contains the
> > > + information of registers in the same order as described by reg-names.
> > > +- reg-names: Should contain the reg names
> > > + "dma": DMA engine control and status region
> > > + "ctrl": MDIO and PHY control and status region
> > > - interrupts: Should contain tx and rx interrupt
> > > - interrupt-names: Should be "rx" and "tx"
> > > - phy-mode: See ethernet.txt file in the same directory.
> > > @@ -13,7 +19,9 @@ Required properties:
> > > Examples (10G generic PHY):
> > > nixge0: ethernet@40000000 {
> > > compatible = "ni,xge-enet-2.00";
> >
> > Shouldn't the compatible change here?
> >
> That's an oops... Will fix.
>
> Should I leave the old example for the version 2.00 format and create
> another for 3.00?

No, we don't need every permutation for examples.

Rob