| Message ID | 20240412065718.29105-4-yi-de.wu@mediatek.com |
|---|---|
| State | Needs Review / ACK |
| Headers | show |
| Series | GenieZone hypervisor drivers | expand |
| Context | Check | Description |
|---|---|---|
| robh/dt-meta-schema | success | |
| robh/checkpatch | success | |
| robh/patch-applied | success | |
| robh/dtbs-check | warning | build log |
On Fri, Apr 12, 2024 at 02:57:00PM +0800, Yi-De Wu wrote: > From: "Yingshiuan Pan" <yingshiuan.pan@mediatek.com> > > Add documentation for GenieZone(gzvm) node. This node informs gzvm > driver to start probing if geniezone hypervisor is available and > able to do virtual machine operations. > > [Reason to use dt solution] > - The GenieZone hypervisor serves as a vendor model for facilitating > platform virtualization, with an implementation that is independent > from Linuxism. > - In contrast to the dt solution, our previous approach involved probing > via hypercall to determine the existence of our hypervisor. However, this > method raised concerns about potentially impacting all systems, including > those without the GenieZone hypervisor embedded[ref]. > > Link: https://lore.kernel.org/all/2fe0c7f9-55fc-ae63-3631-8526a0212ccd@linaro.org/ > +properties: > + compatible: > + const: mediatek,geniezone-hyp Been avoiding this binding every time it shows up because Rob had already told you no and hasn't revisited it since, but I feel this should be s/-hyp// since that's redundant information. > +description: > + This interface is designed for integrating GenieZone hypervisor into Android > + Virtualization Framework(AVF) along with Crosvm as a VMM. > + It acts like a wrapper for every hypercall to GenieZone hypervisor in > + order to control guest VM lifecycles and virtual interrupt injections. The description however doesn't really make sense. The binding claims to be for geniezone but the description talks about something else entirely that "acts like a wrapper" between the OS and geniezone. What is the binding actually for?
diff --git a/Documentation/devicetree/bindings/hypervisor/mediatek,geniezone-hyp.yaml b/Documentation/devicetree/bindings/hypervisor/mediatek,geniezone-hyp.yaml new file mode 100644 index 000000000000..ab89a4c310cb --- /dev/null +++ b/Documentation/devicetree/bindings/hypervisor/mediatek,geniezone-hyp.yaml @@ -0,0 +1,31 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/hypervisor/mediatek,geniezone-hyp.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: MediaTek GenieZone hypervisor + +maintainers: + - Yingshiuan Pan <yingshiuan.pan@mediatek.com> + +description: + This interface is designed for integrating GenieZone hypervisor into Android + Virtualization Framework(AVF) along with Crosvm as a VMM. + It acts like a wrapper for every hypercall to GenieZone hypervisor in + order to control guest VM lifecycles and virtual interrupt injections. + +properties: + compatible: + const: mediatek,geniezone-hyp + +required: + - compatible + +additionalProperties: false + +examples: + - | + hypervisor { + compatible = "mediatek,geniezone-hyp"; + }; diff --git a/MAINTAINERS b/MAINTAINERS index 0cda103140b4..0d1e5d127929 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -9180,6 +9180,7 @@ GENIEZONE HYPERVISOR DRIVER M: Yingshiuan Pan <yingshiuan.pan@mediatek.com> M: Ze-Yu Wang <ze-yu.wang@mediatek.com> M: Yi-De Wu <yi-de.wu@mediatek.com> +F: Documentation/devicetree/bindings/hypervisor/mediatek,geniezone-hyp.yaml F: Documentation/virt/geniezone/ GENWQE (IBM Generic Workqueue Card)