Skip to contentSkip to conversation

dt-bindings: misc: aspeed-p2a-ctrl: add support

PATCH Superseded Patrick Venture 2 participants 8 messages Mar 27, 2019 – Mar 29, 2019

Subsystems (2)

v8 of 10 Superseded Latest is v10 →

lore
Share & tools
lore
#0 lore raw

PATCH v8 1/2 dt-bindings: misc: aspeed-p2a-ctrl: add support

Document the ast2400, ast2500 PCI-to-AHB bridge control driver bindings.

---
Changes for v8:
- None
Changes for v7:
- Moved node under the syscon node it requires
Changes for v6:
- None
Changes for v5:
- None
Changes for v4:
- None
Changes for v3:
- None
Changes for v2:
- Added comment about syscon required parameter.

---
 .../bindings/misc/aspeed-p2a-ctrl.txt         | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt
Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt new file +48 -0
new file mode 100644
index 0000000000000..088cc4e3dc54b
@@ -0,0 +1,48 @@
+======================================================================
+Device tree bindings for Aspeed AST2400/AST2500 PCI-to-AHB Bridge Control Driver
+======================================================================
+
+The bridge is available on platforms with the VGA enabled on the Aspeed device.
+In this case, the host has access to a 64KiB window into all of the BMC's
+memory.  The BMC can disable this bridge.  If the bridge is enabled, the host
+has read access to all the regions of memory, however the host only has read
+and write access depending on a register controlled by the BMC.
+
+Required properties:
+===================
+
+ - compatible: must be one of:
+	- "aspeed,ast2400-p2a-ctrl"
+	- "aspeed,ast2500-p2a-ctrl"
+
+ - syscon: handle to syscon device node controlling PCI.
+
+Optional properties:
+===================
+
+- memory-region: A phandle to a reserved_memory region to be used for the PCI
+		to AHB mapping
+
+The p2a-control node should be the child of a syscon node with the required
+property:
+
+- compatible : Should be one of the following:
+		"aspeed,ast2400-scu", "syscon", "simple-mfd"
+		"aspeed,g4-scu", "syscon", "simple-mfd"
+		"aspeed,ast2500-scu", "syscon", "simple-mfd"
+		"aspeed,g5-scu", "syscon", "simple-mfd"
+
+Example:
+
+g4 Example
+----------
+
+syscon: scu at 1e6e2000 {
+	compatible = "aspeed,ast2400-scu", "syscon", "simple-mfd";
+	reg = <0x1e6e2000 0x1a8>;
+
+	p2a: p2a-control {
+		compatible = "aspeed,ast2400-p2a-ctrl";
+		memory-region = <&reserved_memory>;
+	};
+};
Signature · 1 line
2.21.0.392.gf8f6787159e-goog
maintainer
#1 lore raw
Quoted 18 lines · Patrick Venture

Document the ast2400, ast2500 PCI-to-AHB bridge control driver bindings.

---
Changes for v8:
- None
Changes for v7:
- Moved node under the syscon node it requires
Changes for v6:
- None
Changes for v5:
- None
Changes for v4:
- None
Changes for v3:
- None
Changes for v2:
- Added comment about syscon required parameter.

Quoted 5 lines
---
 .../bindings/misc/aspeed-p2a-ctrl.txt         | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt

Please add Acked-by/Reviewed-by tags when posting new versions. However, there's no need to repost patches *only* to add the tags. The upstream maintainer will do that for acks received on the version they apply.

If a tag was not added on purpose, please state why and what changed.

#2 lore raw
Quoted 26 lines · Rob Herring
Quoted 18 lines · Patrick Venture

Document the ast2400, ast2500 PCI-to-AHB bridge control driver bindings.

---
Changes for v8:
- None
Changes for v7:
- Moved node under the syscon node it requires
Changes for v6:
- None
Changes for v5:
- None
Changes for v4:
- None
Changes for v3:
- None
Changes for v2:
- Added comment about syscon required parameter.

Quoted 5 lines
---
 .../bindings/misc/aspeed-p2a-ctrl.txt         | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt
Quoted 5 lines

Please add Acked-by/Reviewed-by tags when posting new versions. However, there's no need to repost patches *only* to add the tags. The upstream maintainer will do that for acks received on the version they apply.

If a tag was not added on purpose, please state why and what changed.

Adding tags in this case is adding a change version? I was doing this to keep the two patches version-synced. I thought that was required. There was a version change in the other patch in this set.

maintainer
#3 lore raw
Quoted 32 lines · Patrick Venture
Quoted 30 lines · Rob Herring
Quoted 18 lines · Patrick Venture

Document the ast2400, ast2500 PCI-to-AHB bridge control driver bindings.

---
Changes for v8:
- None
Changes for v7:
- Moved node under the syscon node it requires
Changes for v6:
- None
Changes for v5:
- None
Changes for v4:
- None
Changes for v3:
- None
Changes for v2:
- Added comment about syscon required parameter.

Quoted 5 lines
---
 .../bindings/misc/aspeed-p2a-ctrl.txt         | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt

Please add Acked-by/Reviewed-by tags when posting new versions. However, there's no need to repost patches *only* to add the tags. The upstream maintainer will do that for acks received on the version they apply.

Quoted 5 lines
Quoted 1 line

If a tag was not added on purpose, please state why and what changed.

Adding tags in this case is adding a change version? I was doing this to keep the two patches version-synced. I thought that was required. There was a version change in the other patch in this set.

Adding tags is not considered a change. I gave a Reviewed-by in v7. Subsequent versions should carry that tag if there's no change (or only minor changes) in this patch. What happens in the other patches is not really important. Maintainers are not going to go searching thru the versions to find all the ack/review tags. And if I've already reviewed this, I don't want to look at it again.

Rob

#4 lore raw
Quoted 40 lines · Rob Herring
Quoted 32 lines · Patrick Venture
Quoted 30 lines · Rob Herring
Quoted 18 lines · Patrick Venture

Document the ast2400, ast2500 PCI-to-AHB bridge control driver bindings.

---
Changes for v8:
- None
Changes for v7:
- Moved node under the syscon node it requires
Changes for v6:
- None
Changes for v5:
- None
Changes for v4:
- None
Changes for v3:
- None
Changes for v2:
- Added comment about syscon required parameter.

Quoted 5 lines
---
 .../bindings/misc/aspeed-p2a-ctrl.txt         | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt

Please add Acked-by/Reviewed-by tags when posting new versions. However, there's no need to repost patches *only* to add the tags. The upstream maintainer will do that for acks received on the version they apply.

Quoted 5 lines
Quoted 1 line

If a tag was not added on purpose, please state why and what changed.

Adding tags in this case is adding a change version? I was doing this to keep the two patches version-synced. I thought that was required. There was a version change in the other patch in this set.

Quoted 6 lines

Adding tags is not considered a change. I gave a Reviewed-by in v7. Subsequent versions should carry that tag if there's no change (or only minor changes) in this patch. What happens in the other patches is not really important. Maintainers are not going to go searching thru the versions to find all the ack/review tags. And if I've already reviewed this, I don't want to look at it again.

Thank you, I didn't realize that had happened.

Quoted 2 lines

Rob

#5 lore raw
Quoted 42 lines · Patrick Venture
Quoted 40 lines · Rob Herring
Quoted 37 lines · Patrick Venture
Quoted 26 lines · Rob Herring
Quoted 18 lines · Patrick Venture

Document the ast2400, ast2500 PCI-to-AHB bridge control driver bindings.

---
Changes for v8:
- None
Changes for v7:
- Moved node under the syscon node it requires
Changes for v6:
- None
Changes for v5:
- None
Changes for v4:
- None
Changes for v3:
- None
Changes for v2:
- Added comment about syscon required parameter.

Quoted 5 lines
---
 .../bindings/misc/aspeed-p2a-ctrl.txt         | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt
Quoted 5 lines

Please add Acked-by/Reviewed-by tags when posting new versions. However, there's no need to repost patches *only* to add the tags. The upstream maintainer will do that for acks received on the version they apply.

If a tag was not added on purpose, please state why and what changed.

Adding tags in this case is adding a change version? I was doing this to keep the two patches version-synced. I thought that was required. There was a version change in the other patch in this set.

Quoted 8 lines
Quoted 6 lines

Adding tags is not considered a change. I gave a Reviewed-by in v7. Subsequent versions should carry that tag if there's no change (or only minor changes) in this patch. What happens in the other patches is not really important. Maintainers are not going to go searching thru the versions to find all the ack/review tags. And if I've already reviewed this, I don't want to look at it again.

Thank you, I didn't realize that had happened.

I went back through my email and found the line of your email that included it. I apologize.

So, before I send the updated patch with your ack -- do I need to send a v9? or is this just me sending v8 again?

Quoted 3 lines
Quoted 3 lines

Rob

#6 lore raw
Quoted 51 lines · Patrick Venture
Quoted 49 lines · Patrick Venture
Quoted 46 lines · Rob Herring
Quoted 32 lines · Patrick Venture
Quoted 30 lines · Rob Herring
Quoted 18 lines · Patrick Venture

Document the ast2400, ast2500 PCI-to-AHB bridge control driver bindings.

---
Changes for v8:
- None
Changes for v7:
- Moved node under the syscon node it requires
Changes for v6:
- None
Changes for v5:
- None
Changes for v4:
- None
Changes for v3:
- None
Changes for v2:
- Added comment about syscon required parameter.

Quoted 5 lines
---
 .../bindings/misc/aspeed-p2a-ctrl.txt         | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt

Please add Acked-by/Reviewed-by tags when posting new versions. However, there's no need to repost patches *only* to add the tags. The upstream maintainer will do that for acks received on the version they apply.

Quoted 5 lines
Quoted 1 line

If a tag was not added on purpose, please state why and what changed.

Adding tags in this case is adding a change version? I was doing this to keep the two patches version-synced. I thought that was required. There was a version change in the other patch in this set.

Adding tags is not considered a change. I gave a Reviewed-by in v7. Subsequent versions should carry that tag if there's no change (or only minor changes) in this patch. What happens in the other patches is not really important. Maintainers are not going to go searching thru the versions to find all the ack/review tags. And if I've already reviewed this, I don't want to look at it again.

Quoted 7 lines
Quoted 1 line

Thank you, I didn't realize that had happened.

I went back through my email and found the line of your email that included it. I apologize.

So, before I send the updated patch with your ack -- do I need to send a v9? or is this just me sending v8 again?

Sorry. I see you already answered that when you said that adding a tag isn't considered a change. I have therefore re-sent v8 of this patch with your tag added.

Quoted 4 lines
Quoted 4 lines
Quoted 4 lines

Rob

maintainer
#7 lore raw
Quoted 58 lines · Patrick Venture
Quoted 56 lines · Patrick Venture
Quoted 42 lines · Patrick Venture
Quoted 40 lines · Rob Herring
Quoted 37 lines · Patrick Venture
Quoted 26 lines · Rob Herring
Quoted 18 lines · Patrick Venture

Document the ast2400, ast2500 PCI-to-AHB bridge control driver bindings.

---
Changes for v8:
- None
Changes for v7:
- Moved node under the syscon node it requires
Changes for v6:
- None
Changes for v5:
- None
Changes for v4:
- None
Changes for v3:
- None
Changes for v2:
- Added comment about syscon required parameter.

Quoted 5 lines
---
 .../bindings/misc/aspeed-p2a-ctrl.txt         | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt
Quoted 5 lines

Please add Acked-by/Reviewed-by tags when posting new versions. However, there's no need to repost patches *only* to add the tags. The upstream maintainer will do that for acks received on the version they apply.

If a tag was not added on purpose, please state why and what changed.

Adding tags in this case is adding a change version? I was doing this to keep the two patches version-synced. I thought that was required. There was a version change in the other patch in this set.

Quoted 8 lines
Quoted 6 lines

Adding tags is not considered a change. I gave a Reviewed-by in v7. Subsequent versions should carry that tag if there's no change (or only minor changes) in this patch. What happens in the other patches is not really important. Maintainers are not going to go searching thru the versions to find all the ack/review tags. And if I've already reviewed this, I don't want to look at it again.

Thank you, I didn't realize that had happened.

I went back through my email and found the line of your email that included it. I apologize.

Quoted 6 lines
Quoted 2 lines

So, before I send the updated patch with your ack -- do I need to send a v9? or is this just me sending v8 again?

Sorry. I see you already answered that when you said that adding a tag isn't considered a change. I have therefore re-sent v8 of this patch with your tag added.

To repeat my form letter again, you don't need to send a series again just to add tags. IOW, if you send a v9, then add the tags. If v8 is what a maintainer applies, the maintain will take care of adding them (or patchwork does it for us):

Quoted 3 lines

Please add Acked-by/Reviewed-by tags when posting new versions. However, there's no need to repost patches *only* to add the tags. The upstream maintainer will do that for acks received on the version they apply.