Commit 952ae488 authored by Sebastian Ene's avatar Sebastian Ene Committed by Greg Kroah-Hartman
Browse files

dt-bindings: vcpu_stall_detector: Add qemu,vcpu-stall-detector compatible 



The VCPU stall detection mechanism allows to configure the expiration
duration and the internal counter clock frequency measured in Hz.
Add these properties in the schema.

While this is a memory mapped virtual device, it is expected to be loaded
when the DT contains the compatible: "qemu,vcpu-stall-detector" node.
In a protected VM we trust the generated DT nodes and we don't rely on
the host to present the hardware peripherals.

Reviewed-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarSebastian Ene <sebastianene@google.com>
Link: https://lore.kernel.org/r/20220711081720.2870509-2-sebastianene@google.com


Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 3a15b45b

Documentation/devicetree/bindings/misc/qemu,vcpu-stall-detector.yaml

0 → 100644
+51 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/misc/qemu,vcpu-stall-detector.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: VCPU stall detector



description:

  This binding describes a CPU stall detector mechanism for virtual CPUs

  which is accessed through MMIO.



maintainers:

  - Sebastian Ene <sebastianene@google.com>



properties:

  compatible:

    enum:

      - qemu,vcpu-stall-detector



  reg:

    maxItems: 1



  clock-frequency:

    $ref: /schemas/types.yaml#/definitions/uint32

    description: |

      The internal clock of the stall detector peripheral measure in Hz used

      to decrement its internal counter register on each tick.

      Defaults to 10 if unset.

    default: 10



  timeout-sec:

    description: |

      The stall detector expiration timeout measured in seconds.

      Defaults to 8 if unset. Please note that it also takes into account the

      time spent while the VCPU is not running.

    default: 8



required:

  - compatible



additionalProperties: false



examples:

  - |

    vmwdt@9030000 {

      compatible = "qemu,vcpu-stall-detector";

      reg = <0x9030000 0x10000>;

      clock-frequency = <10>;

      timeout-sec = <8>;

    };