Skip to contentSkip to conversation

dt-bindings: fpga: Consolidate bridge properties

PATCH In review Moritz Fischer 4 participants 5 messages Feb 21, 2018 – Mar 1, 2018

Subsystems (3)
lore
Share & tools
lore

Moritz Fischer

author maintainer
#0 lore raw

PATCH 1/1 dt-bindings: fpga: Consolidate bridge properties

Consolidate bridge properties in a single file, instead of duplicating the same optional property over and over again.

---
 .../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
Documentation/devicetree/bindings/fpga/altera-fpga2sdram-bridge.txt +1 -4
index 817a8d4bf903..5dd0ff0f7b4e 100644
@@ -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 {
Documentation/devicetree/bindings/fpga/altera-freeze-bridge.txt +1 -4
index f8e288c71b2d..8b26fbcff3c6 100644
@@ -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 {
Documentation/devicetree/bindings/fpga/altera-hps2fpga-bridge.txt +1 -4
index 6406f9337eeb..68cce3945b10 100644
@@ -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 {
Documentation/devicetree/bindings/fpga/fpga-bridge.txt new file +15 -0
new file mode 100644
index 000000000000..82607b23a287
@@ -0,0 +1,15 @@
+FPGA Bridge Device Tree Binding
+
+Moritz Fischer 2018 (Consolidated from previous bindings)
+
+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>;
+	};
Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt +2 -6
index 8dcfba926bc7..4284d293fa61 100644
@@ -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 {
Signature · 1 line
2.16.1
Acked-by on v1 1/1
#1 lore raw

On Wed, Feb 21, 2018 at 11:33 AM, Moritz Fischer <[email protected]> wrote:

Hi Moritz,

Thanks!

Quoted 4 lines

Consolidate bridge properties in a single file, instead of duplicating the same optional property over and over again.

Quoted 102 lines
Cc Alan Tull <[email protected]>
Cc Rob Herring <[email protected]>
---
 .../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
Documentation/devicetree/bindings/fpga/altera-fpga2sdram-bridge.txt +1 -4
index 817a8d4bf903..5dd0ff0f7b4e 100644
@@ -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 {
Documentation/devicetree/bindings/fpga/altera-freeze-bridge.txt +1 -4
index f8e288c71b2d..8b26fbcff3c6 100644
@@ -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 {
Documentation/devicetree/bindings/fpga/altera-hps2fpga-bridge.txt +1 -4
index 6406f9337eeb..68cce3945b10 100644
@@ -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 {
Documentation/devicetree/bindings/fpga/fpga-bridge.txt new file +15 -0
new file mode 100644
index 000000000000..82607b23a287
@@ -0,0 +1,15 @@
+FPGA Bridge Device Tree Binding
+
+Moritz Fischer 2018 (Consolidated from previous bindings)
+
+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>;
+       };
Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt +2 -7
index 8dcfba926bc7..4284d293fa61 100644
@@ -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 {
--

2.16.1

Acked-by on v1 1/1
#2 lore raw
In reply to Moritz Fischer
Quoted 69 lines · Moritz Fischer

Consolidate bridge properties in a single file, instead of duplicating the same optional property over and over again.

---
 .../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
Documentation/devicetree/bindings/fpga/altera-fpga2sdram-bridge.txt +1 -4
index 817a8d4bf903..5dd0ff0f7b4e 100644
@@ -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 {
Documentation/devicetree/bindings/fpga/altera-freeze-bridge.txt +1 -4
index f8e288c71b2d..8b26fbcff3c6 100644
@@ -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 {
Documentation/devicetree/bindings/fpga/altera-hps2fpga-bridge.txt +1 -4
index 6406f9337eeb..68cce3945b10 100644
@@ -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 {
Documentation/devicetree/bindings/fpga/fpga-bridge.txt new file +0 -0
new file mode 100644
index 000000000000..82607b23a287

Documentation/devicetree/bindings/fpga/fpga-bridge.txt line 3

Quoted 3 lines
Documentation/devicetree/bindings/fpga/fpga-bridge.txt new file +3 -0
@@ -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.

Quoted 22 lines
Documentation/devicetree/bindings/fpga/fpga-bridge.txt new file +12 -0
+
+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>;
+	};
Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt +0 -1
index 8dcfba926bc7..4284d293fa61 100644
@@ -18,12 +18,8 @@ Required properties:
 - clocks		: input clock to IP
 - clock-names		: should contain "aclk"
 
-Optional properties:

Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt Required properties: · line 25

Quoted 10 lines
Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt +2 -5
-- 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 {

Thanks,
Michal

author maintainer
#3 lore raw
Quoted 62 lines · Michal Simek
Quoted 61 lines · Moritz Fischer

Consolidate bridge properties in a single file, instead of duplicating the same optional property over and over again.

---
 .../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
Documentation/devicetree/bindings/fpga/altera-fpga2sdram-bridge.txt +1 -4
index 817a8d4bf903..5dd0ff0f7b4e 100644
@@ -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 {
Documentation/devicetree/bindings/fpga/altera-freeze-bridge.txt +1 -4
index f8e288c71b2d..8b26fbcff3c6 100644
@@ -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 {
Documentation/devicetree/bindings/fpga/altera-hps2fpga-bridge.txt +1 -4
index 6406f9337eeb..68cce3945b10 100644
@@ -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.
 
Quoted 13 lines

Documentation/devicetree/bindings/fpga/fpga-bridge.txt line 3

Quoted 11 lines
Documentation/devicetree/bindings/fpga/altera-hps2fpga-bridge.txt +0 -0
 Example:
 	fpga_bridge0: fpga-bridge@ff400000 {
Documentation/devicetree/bindings/fpga/fpga-bridge.txt new file +3 -0
new file mode 100644
index 000000000000..82607b23a287
@@ -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 :)

Quoted 36 lines
Quoted 23 lines
Documentation/devicetree/bindings/fpga/fpga-bridge.txt new file +12 -0
+
+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>;
+	};
Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt +0 -1
index 8dcfba926bc7..4284d293fa61 100644
@@ -18,12 +18,8 @@ Required properties:
 - clocks		: input clock to IP
 - clock-names		: should contain "aclk"
 
-Optional properties:

Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt Required properties: · line 25

Quoted 10 lines
Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt +2 -5
-- 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 {
Quoted 6 lines

Thanks,
Michal
--
To unsubscribe from this list: send the line "unsubscribe linux-fpga" in the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html

- Moritz

maintainer Reviewed-by on v1 1/1
#4 lore raw
In reply to Moritz Fischer
Quoted 6 lines · Moritz Fischer

Consolidate bridge properties in a single file, instead of duplicating the same optional property over and over again.

Quoted 8 lines
---
 .../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