From: Alex Elder <elder@linaro.org> To: Elliot Berman <quic_eberman@quicinc.com>, Bjorn Andersson <quic_bjorande@quicinc.com>, Rob Herring <robh+dt@kernel.org>, Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>, Murali Nalajala <quic_mnalajal@quicinc.com> Cc: Trilok Soni <quic_tsoni@quicinc.com>, Srivatsa Vaddagiri <quic_svaddagi@quicinc.com>, Carl van Schaik <quic_cvanscha@quicinc.com>, Prakruthi Deepak Heragu <quic_pheragu@quicinc.com>, Arnd Bergmann <arnd@arndb.de>, Greg Kroah-Hartman <gregkh@linuxfoundation.org>, Jonathan Corbet <corbet@lwn.net>, Bagas Sanjaya <bagasdotme@gmail.com>, Catalin Marinas <catalin.marinas@arm.com>, Will Deacon <will@kernel.org>, Jassi Brar <jassisinghbrar@gmail.com>, Sudeep Holla <sudeep.holla@arm.com>, Mark Rutland <mark.rutland@arm.com>, Lorenzo Pieralisi <lpieralisi@kernel.org>, Dmitry Baryshkov <dmitry.baryshkov@linaro.org>, linux-arm-msm@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-acpi@vger.kernel.org, Rob Herring <robh@kernel.org> Subject: Re: [PATCH v8 02/28] dt-bindings: Add binding for gunyah hypervisor Date: Mon, 9 Jan 2023 15:34:10 -0600 [thread overview] Message-ID: <10c02ba3-96cb-3c7e-3b19-04871276b24f@linaro.org> (raw) In-Reply-To: <20221219225850.2397345-3-quic_eberman@quicinc.com> On 12/19/22 4:58 PM, Elliot Berman wrote: > When Linux is booted as a guest under the Gunyah hypervisor, the Gunyah > Resource Manager applies a devicetree overlay describing the virtual > platform configuration of the guest VM, such as the message queue > capability IDs for communicating with the Resource Manager. This > information is not otherwise discoverable by a VM: the Gunyah hypervisor > core does not provide a direct interface to discover capability IDs nor > a way to communicate with RM without having already known the > corresponding message queue capability ID. Add the DT bindings that > Gunyah adheres for the hypervisor node and message queues. > > Reviewed-by: Rob Herring <robh@kernel.org> > Signed-off-by: Elliot Berman <quic_eberman@quicinc.com> At this point I have no input on this patch; if Rob's happy with the bindings, that's good enough for me. -Alex > --- > .../bindings/firmware/gunyah-hypervisor.yaml | 82 +++++++++++++++++++ > MAINTAINERS | 1 + > 2 files changed, 83 insertions(+) > create mode 100644 Documentation/devicetree/bindings/firmware/gunyah-hypervisor.yaml > > diff --git a/Documentation/devicetree/bindings/firmware/gunyah-hypervisor.yaml b/Documentation/devicetree/bindings/firmware/gunyah-hypervisor.yaml > new file mode 100644 > index 000000000000..9fd1d254b156 > --- /dev/null > +++ b/Documentation/devicetree/bindings/firmware/gunyah-hypervisor.yaml > @@ -0,0 +1,82 @@ > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/firmware/gunyah-hypervisor.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Gunyah Hypervisor > + > +maintainers: > + - Murali Nalajala <quic_mnalajal@quicinc.com> > + - Elliot Berman <quic_eberman@quicinc.com> > + > +description: |+ > + Gunyah virtual machines use this information to determine the capability IDs > + of the message queues used to communicate with the Gunyah Resource Manager. > + See also: https://github.com/quic/gunyah-resource-manager/blob/develop/src/vm_creation/dto_construct.c > + > +properties: > + compatible: > + const: gunyah-hypervisor > + > + "#address-cells": > + description: Number of cells needed to represent 64-bit capability IDs. > + const: 2 > + > + "#size-cells": > + description: must be 0, because capability IDs are not memory address > + ranges and do not have a size. > + const: 0 > + > +patternProperties: > + "^gunyah-resource-mgr(@.*)?": > + type: object > + description: > + Resource Manager node which is required to communicate to Resource > + Manager VM using Gunyah Message Queues. > + > + properties: > + compatible: > + const: gunyah-resource-manager > + > + reg: > + items: > + - description: Gunyah capability ID of the TX message queue > + - description: Gunyah capability ID of the RX message queue > + > + interrupts: > + items: > + - description: Interrupt for the TX message queue > + - description: Interrupt for the RX message queue > + > + additionalProperties: false > + > + required: > + - compatible > + - reg > + - interrupts > + > +additionalProperties: false > + > +required: > + - compatible > + - "#address-cells" > + - "#size-cells" > + > +examples: > + - | > + #include <dt-bindings/interrupt-controller/arm-gic.h> > + > + hypervisor { > + #address-cells = <2>; > + #size-cells = <0>; > + compatible = "gunyah-hypervisor"; > + > + gunyah-resource-mgr@0 { > + compatible = "gunyah-resource-manager"; > + interrupts = <GIC_SPI 3 IRQ_TYPE_EDGE_RISING>, /* TX full IRQ */ > + <GIC_SPI 4 IRQ_TYPE_EDGE_RISING>; /* RX empty IRQ */ > + reg = <0x00000000 0x00000000>, <0x00000000 0x00000001>; > + /* TX, RX cap ids */ > + }; > + }; > diff --git a/MAINTAINERS b/MAINTAINERS > index 1dd8f58d6e01..f32320a9efa4 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -8939,6 +8939,7 @@ M: Elliot Berman <quic_eberman@quicinc.com> > M: Murali Nalajala <quic_mnalajal@quicinc.com> > L: linux-arm-msm@vger.kernel.org > S: Supported > +F: Documentation/devicetree/bindings/firmware/gunyah-hypervisor.yaml > F: Documentation/virt/gunyah/ > > HABANALABS PCI DRIVER
WARNING: multiple messages have this Message-ID (diff)
From: Alex Elder <elder@linaro.org> To: Elliot Berman <quic_eberman@quicinc.com>, Bjorn Andersson <quic_bjorande@quicinc.com>, Rob Herring <robh+dt@kernel.org>, Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>, Murali Nalajala <quic_mnalajal@quicinc.com> Cc: Trilok Soni <quic_tsoni@quicinc.com>, Srivatsa Vaddagiri <quic_svaddagi@quicinc.com>, Carl van Schaik <quic_cvanscha@quicinc.com>, Prakruthi Deepak Heragu <quic_pheragu@quicinc.com>, Arnd Bergmann <arnd@arndb.de>, Greg Kroah-Hartman <gregkh@linuxfoundation.org>, Jonathan Corbet <corbet@lwn.net>, Bagas Sanjaya <bagasdotme@gmail.com>, Catalin Marinas <catalin.marinas@arm.com>, Will Deacon <will@kernel.org>, Jassi Brar <jassisinghbrar@gmail.com>, Sudeep Holla <sudeep.holla@arm.com>, Mark Rutland <mark.rutland@arm.com>, Lorenzo Pieralisi <lpieralisi@kernel.org>, Dmitry Baryshkov <dmitry.baryshkov@linaro.org>, linux-arm-msm@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-acpi@vger.kernel.org, Rob Herring <robh@kernel.org> Subject: Re: [PATCH v8 02/28] dt-bindings: Add binding for gunyah hypervisor Date: Mon, 9 Jan 2023 15:34:10 -0600 [thread overview] Message-ID: <10c02ba3-96cb-3c7e-3b19-04871276b24f@linaro.org> (raw) In-Reply-To: <20221219225850.2397345-3-quic_eberman@quicinc.com> On 12/19/22 4:58 PM, Elliot Berman wrote: > When Linux is booted as a guest under the Gunyah hypervisor, the Gunyah > Resource Manager applies a devicetree overlay describing the virtual > platform configuration of the guest VM, such as the message queue > capability IDs for communicating with the Resource Manager. This > information is not otherwise discoverable by a VM: the Gunyah hypervisor > core does not provide a direct interface to discover capability IDs nor > a way to communicate with RM without having already known the > corresponding message queue capability ID. Add the DT bindings that > Gunyah adheres for the hypervisor node and message queues. > > Reviewed-by: Rob Herring <robh@kernel.org> > Signed-off-by: Elliot Berman <quic_eberman@quicinc.com> At this point I have no input on this patch; if Rob's happy with the bindings, that's good enough for me. -Alex > --- > .../bindings/firmware/gunyah-hypervisor.yaml | 82 +++++++++++++++++++ > MAINTAINERS | 1 + > 2 files changed, 83 insertions(+) > create mode 100644 Documentation/devicetree/bindings/firmware/gunyah-hypervisor.yaml > > diff --git a/Documentation/devicetree/bindings/firmware/gunyah-hypervisor.yaml b/Documentation/devicetree/bindings/firmware/gunyah-hypervisor.yaml > new file mode 100644 > index 000000000000..9fd1d254b156 > --- /dev/null > +++ b/Documentation/devicetree/bindings/firmware/gunyah-hypervisor.yaml > @@ -0,0 +1,82 @@ > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/firmware/gunyah-hypervisor.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Gunyah Hypervisor > + > +maintainers: > + - Murali Nalajala <quic_mnalajal@quicinc.com> > + - Elliot Berman <quic_eberman@quicinc.com> > + > +description: |+ > + Gunyah virtual machines use this information to determine the capability IDs > + of the message queues used to communicate with the Gunyah Resource Manager. > + See also: https://github.com/quic/gunyah-resource-manager/blob/develop/src/vm_creation/dto_construct.c > + > +properties: > + compatible: > + const: gunyah-hypervisor > + > + "#address-cells": > + description: Number of cells needed to represent 64-bit capability IDs. > + const: 2 > + > + "#size-cells": > + description: must be 0, because capability IDs are not memory address > + ranges and do not have a size. > + const: 0 > + > +patternProperties: > + "^gunyah-resource-mgr(@.*)?": > + type: object > + description: > + Resource Manager node which is required to communicate to Resource > + Manager VM using Gunyah Message Queues. > + > + properties: > + compatible: > + const: gunyah-resource-manager > + > + reg: > + items: > + - description: Gunyah capability ID of the TX message queue > + - description: Gunyah capability ID of the RX message queue > + > + interrupts: > + items: > + - description: Interrupt for the TX message queue > + - description: Interrupt for the RX message queue > + > + additionalProperties: false > + > + required: > + - compatible > + - reg > + - interrupts > + > +additionalProperties: false > + > +required: > + - compatible > + - "#address-cells" > + - "#size-cells" > + > +examples: > + - | > + #include <dt-bindings/interrupt-controller/arm-gic.h> > + > + hypervisor { > + #address-cells = <2>; > + #size-cells = <0>; > + compatible = "gunyah-hypervisor"; > + > + gunyah-resource-mgr@0 { > + compatible = "gunyah-resource-manager"; > + interrupts = <GIC_SPI 3 IRQ_TYPE_EDGE_RISING>, /* TX full IRQ */ > + <GIC_SPI 4 IRQ_TYPE_EDGE_RISING>; /* RX empty IRQ */ > + reg = <0x00000000 0x00000000>, <0x00000000 0x00000001>; > + /* TX, RX cap ids */ > + }; > + }; > diff --git a/MAINTAINERS b/MAINTAINERS > index 1dd8f58d6e01..f32320a9efa4 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -8939,6 +8939,7 @@ M: Elliot Berman <quic_eberman@quicinc.com> > M: Murali Nalajala <quic_mnalajal@quicinc.com> > L: linux-arm-msm@vger.kernel.org > S: Supported > +F: Documentation/devicetree/bindings/firmware/gunyah-hypervisor.yaml > F: Documentation/virt/gunyah/ > > HABANALABS PCI DRIVER _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
next prev parent reply other threads:[~2023-01-09 21:35 UTC|newest] Thread overview: 137+ messages / expand[flat|nested] mbox.gz Atom feed top 2022-12-19 22:58 [PATCH v8 00/28] Drivers for gunyah hypervisor Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 01/28] docs: gunyah: Introduce Gunyah Hypervisor Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-09 21:34 ` Alex Elder 2023-01-09 21:34 ` Alex Elder 2023-01-10 17:54 ` Elliot Berman 2023-01-10 17:54 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 02/28] dt-bindings: Add binding for gunyah hypervisor Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-09 21:34 ` Alex Elder [this message] 2023-01-09 21:34 ` Alex Elder 2022-12-19 22:58 ` [PATCH v8 03/28] gunyah: Common types and error codes for Gunyah hypercalls Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-09 21:34 ` Alex Elder 2023-01-09 21:34 ` Alex Elder 2023-01-10 17:55 ` Elliot Berman 2023-01-10 17:55 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 04/28] arm64: smccc: Include alternative-macros.h Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-09 21:34 ` Alex Elder 2023-01-09 21:34 ` Alex Elder 2023-01-10 22:55 ` Elliot Berman 2023-01-10 22:55 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 05/28] virt: gunyah: Add hypercalls to identify Gunyah Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-09 21:34 ` Alex Elder 2023-01-09 21:34 ` Alex Elder 2023-01-10 17:56 ` Elliot Berman 2023-01-10 17:56 ` Elliot Berman 2023-01-17 19:20 ` Alex Elder 2023-01-17 19:20 ` Alex Elder 2023-01-17 19:20 ` Alex Elder 2023-01-17 19:20 ` Alex Elder 2023-01-17 22:29 ` Elliot Berman 2023-01-17 22:29 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 06/28] virt: gunyah: Identify hypervisor version Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-09 21:34 ` Alex Elder 2023-01-09 21:34 ` Alex Elder 2023-01-10 17:56 ` Elliot Berman 2023-01-10 17:56 ` Elliot Berman 2023-01-17 19:21 ` Alex Elder 2023-01-17 19:21 ` Alex Elder 2023-01-17 22:29 ` Elliot Berman 2023-01-17 22:29 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 07/28] mailbox: Allow direct registration to a channel Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-09 21:34 ` Alex Elder 2023-01-09 21:34 ` Alex Elder 2023-01-10 17:57 ` Elliot Berman 2023-01-10 17:57 ` Elliot Berman 2023-01-17 19:21 ` Alex Elder 2023-01-17 19:21 ` Alex Elder 2022-12-19 22:58 ` [PATCH v8 08/28] virt: gunyah: msgq: Add hypercalls to send and receive messages Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 09/28] mailbox: Add Gunyah message queue mailbox Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-02 6:13 ` Srivatsa Vaddagiri 2023-01-02 6:13 ` Srivatsa Vaddagiri 2023-01-04 0:32 ` Elliot Berman 2023-01-04 0:32 ` Elliot Berman 2023-01-09 21:34 ` Alex Elder 2023-01-09 21:34 ` Alex Elder 2023-01-10 18:16 ` Elliot Berman 2023-01-10 18:16 ` Elliot Berman 2023-01-17 19:21 ` Alex Elder 2023-01-17 19:21 ` Alex Elder 2022-12-19 22:58 ` [PATCH v8 10/28] gunyah: rsc_mgr: Add resource manager RPC core Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-17 22:33 ` Alex Elder 2023-01-17 22:33 ` Alex Elder 2023-01-20 23:18 ` Elliot Berman 2023-01-20 23:18 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 11/28] gunyah: rsc_mgr: Add VM lifecycle RPC Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-09 7:13 ` Srivatsa Vaddagiri 2023-01-09 7:13 ` Srivatsa Vaddagiri 2023-01-09 18:51 ` Elliot Berman 2023-01-09 18:51 ` Elliot Berman 2023-01-18 18:26 ` Alex Elder 2023-01-18 18:26 ` Alex Elder 2023-01-20 1:31 ` Elliot Berman 2023-01-20 1:31 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 12/28] gunyah: vm_mgr: Introduce basic VM Manager Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-09 9:05 ` Srivatsa Vaddagiri 2023-01-09 9:05 ` Srivatsa Vaddagiri 2023-01-09 19:38 ` Elliot Berman 2023-01-09 19:38 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 13/28] gunyah: rsc_mgr: Add RPC for sharing memory Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-16 8:45 ` Srivatsa Vaddagiri 2023-01-16 8:45 ` Srivatsa Vaddagiri 2022-12-19 22:58 ` [PATCH v8 14/28] gunyah: vm_mgr: Add/remove user memory regions Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-20 5:34 ` Srivatsa Vaddagiri 2023-01-20 5:34 ` Srivatsa Vaddagiri 2022-12-19 22:58 ` [PATCH v8 15/28] gunyah: vm_mgr: Add ioctls to support basic non-proxy VM boot Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 16/28] samples: Add sample userspace Gunyah VM Manager Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 17/28] gunyah: rsc_mgr: Add platform ops on mem_lend/mem_reclaim Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 18/28] firmware: qcom_scm: Use fixed width src vm bitmap Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 19/28] firmware: qcom_scm: Register Gunyah platform ops Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-23 17:21 ` kernel test robot 2022-12-19 22:58 ` [PATCH v8 20/28] docs: gunyah: Document Gunyah VM Manager Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 21/28] virt: gunyah: Translate gh_rm_hyp_resource into gunyah_resource Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 22/28] gunyah: vm_mgr: Add framework to add VM Functions Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 23/28] virt: gunyah: Add resource tickets Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 24/28] virt: gunyah: Add IO handlers Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 25/28] virt: gunyah: Add proxy-scheduled vCPUs Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 26/28] virt: gunyah: Add hypercalls for sending doorbell Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-19 22:58 ` [PATCH v8 27/28] virt: gunyah: Add irqfd interface Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2022-12-21 17:00 ` kernel test robot 2022-12-19 22:58 ` [PATCH v8 28/28] virt: gunyah: Add ioeventfd Elliot Berman 2022-12-19 22:58 ` Elliot Berman 2023-01-09 21:34 ` [PATCH v8 00/28] Drivers for gunyah hypervisor Alex Elder 2023-01-09 21:34 ` Alex Elder 2023-01-10 17:54 ` Elliot Berman 2023-01-10 17:54 ` Elliot Berman 2023-01-10 21:47 ` Elliot Berman 2023-01-10 21:47 ` Elliot Berman 2023-01-17 19:20 ` Alex Elder 2023-01-17 19:20 ` Alex Elder
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=10c02ba3-96cb-3c7e-3b19-04871276b24f@linaro.org \ --to=elder@linaro.org \ --cc=arnd@arndb.de \ --cc=bagasdotme@gmail.com \ --cc=catalin.marinas@arm.com \ --cc=corbet@lwn.net \ --cc=devicetree@vger.kernel.org \ --cc=dmitry.baryshkov@linaro.org \ --cc=gregkh@linuxfoundation.org \ --cc=jassisinghbrar@gmail.com \ --cc=krzysztof.kozlowski+dt@linaro.org \ --cc=linux-acpi@vger.kernel.org \ --cc=linux-arm-kernel@lists.infradead.org \ --cc=linux-arm-msm@vger.kernel.org \ --cc=linux-doc@vger.kernel.org \ --cc=linux-kernel@vger.kernel.org \ --cc=lpieralisi@kernel.org \ --cc=mark.rutland@arm.com \ --cc=quic_bjorande@quicinc.com \ --cc=quic_cvanscha@quicinc.com \ --cc=quic_eberman@quicinc.com \ --cc=quic_mnalajal@quicinc.com \ --cc=quic_pheragu@quicinc.com \ --cc=quic_svaddagi@quicinc.com \ --cc=quic_tsoni@quicinc.com \ --cc=robh+dt@kernel.org \ --cc=robh@kernel.org \ --cc=sudeep.holla@arm.com \ --cc=will@kernel.org \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.