xref: /freebsd/sys/contrib/device-tree/Bindings/misc/qemu,vcpu-stall-detector.yaml (revision b97ee269eae3cbaf35c18f51a459aea581c2a7dc)
1*b97ee269SEmmanuel Vadot# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*b97ee269SEmmanuel Vadot%YAML 1.2
3*b97ee269SEmmanuel Vadot---
4*b97ee269SEmmanuel Vadot$id: http://devicetree.org/schemas/misc/qemu,vcpu-stall-detector.yaml#
5*b97ee269SEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6*b97ee269SEmmanuel Vadot
7*b97ee269SEmmanuel Vadottitle: VCPU stall detector
8*b97ee269SEmmanuel Vadot
9*b97ee269SEmmanuel Vadotdescription:
10*b97ee269SEmmanuel Vadot  This binding describes a CPU stall detector mechanism for virtual CPUs
11*b97ee269SEmmanuel Vadot  which is accessed through MMIO.
12*b97ee269SEmmanuel Vadot
13*b97ee269SEmmanuel Vadotmaintainers:
14*b97ee269SEmmanuel Vadot  - Sebastian Ene <sebastianene@google.com>
15*b97ee269SEmmanuel Vadot
16*b97ee269SEmmanuel Vadotproperties:
17*b97ee269SEmmanuel Vadot  compatible:
18*b97ee269SEmmanuel Vadot    enum:
19*b97ee269SEmmanuel Vadot      - qemu,vcpu-stall-detector
20*b97ee269SEmmanuel Vadot
21*b97ee269SEmmanuel Vadot  reg:
22*b97ee269SEmmanuel Vadot    maxItems: 1
23*b97ee269SEmmanuel Vadot
24*b97ee269SEmmanuel Vadot  clock-frequency:
25*b97ee269SEmmanuel Vadot    $ref: /schemas/types.yaml#/definitions/uint32
26*b97ee269SEmmanuel Vadot    description: |
27*b97ee269SEmmanuel Vadot      The internal clock of the stall detector peripheral measure in Hz used
28*b97ee269SEmmanuel Vadot      to decrement its internal counter register on each tick.
29*b97ee269SEmmanuel Vadot      Defaults to 10 if unset.
30*b97ee269SEmmanuel Vadot    default: 10
31*b97ee269SEmmanuel Vadot
32*b97ee269SEmmanuel Vadot  timeout-sec:
33*b97ee269SEmmanuel Vadot    description: |
34*b97ee269SEmmanuel Vadot      The stall detector expiration timeout measured in seconds.
35*b97ee269SEmmanuel Vadot      Defaults to 8 if unset. Please note that it also takes into account the
36*b97ee269SEmmanuel Vadot      time spent while the VCPU is not running.
37*b97ee269SEmmanuel Vadot    default: 8
38*b97ee269SEmmanuel Vadot
39*b97ee269SEmmanuel Vadotrequired:
40*b97ee269SEmmanuel Vadot  - compatible
41*b97ee269SEmmanuel Vadot
42*b97ee269SEmmanuel VadotadditionalProperties: false
43*b97ee269SEmmanuel Vadot
44*b97ee269SEmmanuel Vadotexamples:
45*b97ee269SEmmanuel Vadot  - |
46*b97ee269SEmmanuel Vadot    vmwdt@9030000 {
47*b97ee269SEmmanuel Vadot      compatible = "qemu,vcpu-stall-detector";
48*b97ee269SEmmanuel Vadot      reg = <0x9030000 0x10000>;
49*b97ee269SEmmanuel Vadot      clock-frequency = <10>;
50*b97ee269SEmmanuel Vadot      timeout-sec = <8>;
51*b97ee269SEmmanuel Vadot    };
52