[v9,4/5] dt-bindings: bus: VMBus

Message ID 1679298460-11855-5-git-send-email-ssengar@linux.microsoft.com
State New
Headers
Series Device tree support for Hyper-V VMBus driver |

Commit Message

Saurabh Singh Sengar March 20, 2023, 7:47 a.m. UTC
  Add dt-bindings for Hyper-V VMBus.

Signed-off-by: Saurabh Sengar <ssengar@linux.microsoft.com>
Reviewed-by: Rob Herring <robh@kernel.org>
---
 .../bindings/bus/microsoft,vmbus.yaml         | 54 +++++++++++++++++++
 MAINTAINERS                                   |  1 +
 2 files changed, 55 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/bus/microsoft,vmbus.yaml
  

Comments

Wei Liu April 5, 2023, 11:10 p.m. UTC | #1
On Mon, Mar 20, 2023 at 12:47:39AM -0700, Saurabh Sengar wrote:
> Add dt-bindings for Hyper-V VMBus.

Do you perhaps want to use this as the commit subject line? The original
one looks to be cut off half way.

I can change this patch on my end. Just let me know.

Thanks,
Wei.
  
Saurabh Singh Sengar April 6, 2023, 3:03 a.m. UTC | #2
On Wed, Apr 05, 2023 at 11:10:17PM +0000, Wei Liu wrote:
> On Mon, Mar 20, 2023 at 12:47:39AM -0700, Saurabh Sengar wrote:
> > Add dt-bindings for Hyper-V VMBus.
> 
> Do you perhaps want to use this as the commit subject line? The original
> one looks to be cut off half way.

In the first version of this patch series, I had this as subject line, however
'dt-bindings' was repetetive in subject line hence asked to be dropped by
device-tree maintainers.

Ref: https://lore.kernel.org/lkml/f74fe561-dc20-0681-12af-4a4782a060be@linaro.org/

If this subject line looks cut in half, may be we can modify it to:
dt-bindings: bus: Add Hyper-V VMBus

Regards,
Saurabh

> 
> I can change this patch on my end. Just let me know.
> 
> Thanks,
> Wei.
  
Wei Liu April 6, 2023, 8:36 p.m. UTC | #3
On Wed, Apr 05, 2023 at 08:03:16PM -0700, Saurabh Singh Sengar wrote:
> On Wed, Apr 05, 2023 at 11:10:17PM +0000, Wei Liu wrote:
> > On Mon, Mar 20, 2023 at 12:47:39AM -0700, Saurabh Sengar wrote:
> > > Add dt-bindings for Hyper-V VMBus.
> > 
> > Do you perhaps want to use this as the commit subject line? The original
> > one looks to be cut off half way.
> 
> In the first version of this patch series, I had this as subject line, however
> 'dt-bindings' was repetetive in subject line hence asked to be dropped by
> device-tree maintainers.
> 
> Ref: https://lore.kernel.org/lkml/f74fe561-dc20-0681-12af-4a4782a060be@linaro.org/
> 
> If this subject line looks cut in half, may be we can modify it to:
> dt-bindings: bus: Add Hyper-V VMBus

Okay. Let change the title to this.

Thanks,
Wei.
  

Patch

diff --git a/Documentation/devicetree/bindings/bus/microsoft,vmbus.yaml b/Documentation/devicetree/bindings/bus/microsoft,vmbus.yaml
new file mode 100644
index 000000000000..a8d40c766dcd
--- /dev/null
+++ b/Documentation/devicetree/bindings/bus/microsoft,vmbus.yaml
@@ -0,0 +1,54 @@ 
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/bus/microsoft,vmbus.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Microsoft Hyper-V VMBus
+
+maintainers:
+  - Saurabh Sengar <ssengar@linux.microsoft.com>
+
+description:
+  VMBus is a software bus that implement the protocols for communication
+  between the root or host OS and guest OSs (virtual machines).
+
+properties:
+  compatible:
+    const: microsoft,vmbus
+
+  ranges: true
+
+  '#address-cells':
+    const: 2
+
+  '#size-cells':
+    const: 1
+
+required:
+  - compatible
+  - ranges
+  - '#address-cells'
+  - '#size-cells'
+
+additionalProperties: false
+
+examples:
+  - |
+    soc {
+        #address-cells = <2>;
+        #size-cells = <1>;
+        bus {
+            compatible = "simple-bus";
+            #address-cells = <2>;
+            #size-cells = <1>;
+            ranges;
+
+            vmbus@ff0000000 {
+                compatible = "microsoft,vmbus";
+                #address-cells = <2>;
+                #size-cells = <1>;
+                ranges = <0x0f 0xf0000000 0x0f 0xf0000000 0x10000000>;
+            };
+        };
+    };
diff --git a/MAINTAINERS b/MAINTAINERS
index 216a61805c93..3cfe67af51f1 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -9540,6 +9540,7 @@  S:	Supported
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/hyperv/linux.git
 F:	Documentation/ABI/stable/sysfs-bus-vmbus
 F:	Documentation/ABI/testing/debugfs-hyperv
+F:	Documentation/devicetree/bindings/bus/microsoft,vmbus.yaml
 F:	Documentation/virt/hyperv
 F:	Documentation/networking/device_drivers/ethernet/microsoft/netvsc.rst
 F:	arch/arm64/hyperv