Re: [PATCH] dt-bindings: fpga: Consolidate bridge properties
From: Moritz Fischer
Date: Thu Feb 22 2018 - 12:34:58 EST
On Thu, Feb 22, 2018 at 08:12:19AM +0100, Michal Simek wrote:
> On 21.2.2018 18:33, Moritz Fischer wrote:
> > Consolidate bridge properties in a single file, instead of duplicating
> > the same optional property over and over again.
> >
> > Signed-off-by: Moritz Fischer <mdf@xxxxxxxxxx>
> > Cc: Alan Tull <atull@xxxxxxxxxx>
> > Cc: Rob Herring <robh+dt@xxxxxxxxxx>
> > ---
> > .../devicetree/bindings/fpga/altera-fpga2sdram-bridge.txt | 5 +----
> > .../devicetree/bindings/fpga/altera-freeze-bridge.txt | 5 +----
> > .../devicetree/bindings/fpga/altera-hps2fpga-bridge.txt | 5 +----
> > Documentation/devicetree/bindings/fpga/fpga-bridge.txt | 15 +++++++++++++++
> > .../devicetree/bindings/fpga/xilinx-pr-decoupler.txt | 8 ++------
> > 5 files changed, 20 insertions(+), 18 deletions(-)
> > create mode 100644 Documentation/devicetree/bindings/fpga/fpga-bridge.txt
> >
> > diff --git a/Documentation/devicetree/bindings/fpga/altera-fpga2sdram-bridge.txt b/Documentation/devicetree/bindings/fpga/altera-fpga2sdram-bridge.txt
> > index 817a8d4bf903..5dd0ff0f7b4e 100644
> > --- a/Documentation/devicetree/bindings/fpga/altera-fpga2sdram-bridge.txt
> > +++ b/Documentation/devicetree/bindings/fpga/altera-fpga2sdram-bridge.txt
> > @@ -3,10 +3,7 @@ Altera FPGA To SDRAM Bridge Driver
> > Required properties:
> > - compatible : Should contain "altr,socfpga-fpga2sdram-bridge"
> >
> > -Optional properties:
> > -- bridge-enable : 0 if driver should disable bridge at startup
> > - 1 if driver should enable bridge at startup
> > - Default is to leave bridge in current state.
> > +See Documentation/devicetree/bindings/fpga/fpga-bridge.txt for generic bindings.
> >
> > Example:
> > fpga_bridge3: fpga-bridge@ffc25080 {
> > diff --git a/Documentation/devicetree/bindings/fpga/altera-freeze-bridge.txt b/Documentation/devicetree/bindings/fpga/altera-freeze-bridge.txt
> > index f8e288c71b2d..8b26fbcff3c6 100644
> > --- a/Documentation/devicetree/bindings/fpga/altera-freeze-bridge.txt
> > +++ b/Documentation/devicetree/bindings/fpga/altera-freeze-bridge.txt
> > @@ -10,10 +10,7 @@ Required properties:
> > - compatible : Should contain "altr,freeze-bridge-controller"
> > - regs : base address and size for freeze bridge module
> >
> > -Optional properties:
> > -- bridge-enable : 0 if driver should disable bridge at startup
> > - 1 if driver should enable bridge at startup
> > - Default is to leave bridge in current state.
> > +See Documentation/devicetree/bindings/fpga/fpga-bridge.txt for generic bindings.
> >
> > Example:
> > freeze-controller@100000450 {
> > diff --git a/Documentation/devicetree/bindings/fpga/altera-hps2fpga-bridge.txt b/Documentation/devicetree/bindings/fpga/altera-hps2fpga-bridge.txt
> > index 6406f9337eeb..68cce3945b10 100644
> > --- a/Documentation/devicetree/bindings/fpga/altera-hps2fpga-bridge.txt
> > +++ b/Documentation/devicetree/bindings/fpga/altera-hps2fpga-bridge.txt
> > @@ -9,10 +9,7 @@ Required properties:
> > - resets : Phandle and reset specifier for this bridge's reset
> > - clocks : Clocks used by this module.
> >
> > -Optional properties:
> > -- bridge-enable : 0 if driver should disable bridge at startup.
> > - 1 if driver should enable bridge at startup.
> > - Default is to leave bridge in its current state.
> > +See Documentation/devicetree/bindings/fpga/fpga-bridge.txt for generic bindings.
> >
> > Example:
> > fpga_bridge0: fpga-bridge@ff400000 {
> > diff --git a/Documentation/devicetree/bindings/fpga/fpga-bridge.txt b/Documentation/devicetree/bindings/fpga/fpga-bridge.txt
> > new file mode 100644
> > index 000000000000..82607b23a287
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/fpga/fpga-bridge.txt
> > @@ -0,0 +1,15 @@
> > +FPGA Bridge Device Tree Binding
> > +
> > +Moritz Fischer 2018 (Consolidated from previous bindings)
>
> nit: I would remove your name and year - it is visible from git log.
Yeah can get rid of that, I copied from fpga-region.txt :)
>
> > +
> > +Optional properties:
> > +- bridge-enable : 0 if driver should disable bridge at startup
> > + 1 if driver should enable bridge at startup
> > + Default is to leave bridge in current state.
> > +
> > +Example:
> > + fpga_bridge3: fpga-bridge@ffc25080 {
> > + compatible = "altr,socfpga-fpga2sdram-bridge";
> > + reg = <0xffc25080 0x4>;
> > + bridge-enable = <0>;
> > + };
> > diff --git a/Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt b/Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt
> > index 8dcfba926bc7..4284d293fa61 100644
> > --- a/Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt
> > +++ b/Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt
> > @@ -18,12 +18,8 @@ Required properties:
> > - clocks : input clock to IP
> > - clock-names : should contain "aclk"
> >
> > -Optional properties:
> > -- bridge-enable : 0 if driver should disable bridge at startup
> > - 1 if driver should enable bridge at startup
> > - Default is to leave bridge in current state.
> > -
> > -See Documentation/devicetree/bindings/fpga/fpga-region.txt for generic bindings.
> > +See Documentation/devicetree/bindings/fpga/fpga-region.txt and
> > +Documentation/devicetree/bindings/fpga/fpga-bridge.txt for generic bindings.
> >
> > Example:
> > fpga-bridge@100000450 {
> >
>
> Acked-by: Michal Simek <michal.simek@xxxxxxxxxx>
>
> Thanks,
> Michal
> --
> To unsubscribe from this list: send the line "unsubscribe linux-fpga" in
> the body of a message to majordomo@xxxxxxxxxxxxxxx
> More majordomo info at http://vger.kernel.org/majordomo-info.html
- Moritz
Attachment:
signature.asc
Description: PGP signature