1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/misc/qemu,v 4 $id: http://devicetree.org/schemas/misc/qemu,vcpu-stall-detector.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: VCPU stall detector 7 title: VCPU stall detector
8 8
9 description: 9 description:
10 This binding describes a CPU stall detector 10 This binding describes a CPU stall detector mechanism for virtual CPUs
11 which is accessed through MMIO. 11 which is accessed through MMIO.
12 12
13 maintainers: 13 maintainers:
14 - Sebastian Ene <sebastianene@google.com> 14 - Sebastian Ene <sebastianene@google.com>
15 15
16 properties: 16 properties:
17 compatible: 17 compatible:
18 enum: 18 enum:
19 - qemu,vcpu-stall-detector 19 - qemu,vcpu-stall-detector
20 20
21 reg: 21 reg:
22 maxItems: 1 22 maxItems: 1
23 23
24 clock-frequency: 24 clock-frequency:
25 $ref: /schemas/types.yaml#/definitions/uin 25 $ref: /schemas/types.yaml#/definitions/uint32
26 description: | 26 description: |
27 The internal clock of the stall detector 27 The internal clock of the stall detector peripheral measure in Hz used
28 to decrement its internal counter regist 28 to decrement its internal counter register on each tick.
29 Defaults to 10 if unset. 29 Defaults to 10 if unset.
30 default: 10 30 default: 10
31 31
32 interrupts: 32 interrupts:
33 maxItems: 1 33 maxItems: 1
34 34
35 timeout-sec: 35 timeout-sec:
36 description: | 36 description: |
37 The stall detector expiration timeout me 37 The stall detector expiration timeout measured in seconds.
38 Defaults to 8 if unset. Please note that 38 Defaults to 8 if unset. Please note that it also takes into account the
39 time spent while the VCPU is not running 39 time spent while the VCPU is not running.
40 default: 8 40 default: 8
41 41
42 required: 42 required:
43 - compatible 43 - compatible
44 44
45 additionalProperties: false 45 additionalProperties: false
46 46
47 examples: 47 examples:
48 - | 48 - |
49 #include <dt-bindings/interrupt-controller 49 #include <dt-bindings/interrupt-controller/arm-gic.h>
50 50
51 vmwdt@9030000 { 51 vmwdt@9030000 {
52 compatible = "qemu,vcpu-stall-detector"; 52 compatible = "qemu,vcpu-stall-detector";
53 reg = <0x9030000 0x10000>; 53 reg = <0x9030000 0x10000>;
54 clock-frequency = <10>; 54 clock-frequency = <10>;
55 timeout-sec = <8>; 55 timeout-sec = <8>;
56 interrupts = <GIC_PPI 15 IRQ_TYPE_EDGE_R 56 interrupts = <GIC_PPI 15 IRQ_TYPE_EDGE_RISING>;
57 }; 57 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.