[PATCH 1/2] dt-bindings: Add binding for gunyah watchdog
From: Hrishabh Rajput via B4 Relay <devnull+hrishabh.rajput.oss.qualcomm.com@kernel.org>
Date: 2025-09-03 19:34:27
Also in:
b4-sent, linux-arm-msm, linux-watchdog, lkml
Subsystem:
arm/qualcomm mailing list, open firmware and flattened device tree bindings, the rest, watchdog device drivers · Maintainers:
Rob Herring, Krzysztof Kozlowski, Conor Dooley, Linus Torvalds, Wim Van Sebroeck, Guenter Roeck
From: Hrishabh Rajput <redacted> The Gunyah Hypervisor applies a devicetree overlay providing the pretimeout interrupt for the Gunyah Watchdog that it will be using to notify watchdog's pretimeout event. Add the DT bindings that Gunyah adheres to for the hypervisor and watchdog. Signed-off-by: Hrishabh Rajput <redacted> --- .../bindings/watchdog/qcom,gh-watchdog.yaml | 76 ++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 77 insertions(+)
diff --git a/Documentation/devicetree/bindings/watchdog/qcom,gh-watchdog.yaml b/Documentation/devicetree/bindings/watchdog/qcom,gh-watchdog.yaml
new file mode 100644
index 000000000000..bde8438c6242
--- /dev/null
+++ b/Documentation/devicetree/bindings/watchdog/qcom,gh-watchdog.yaml@@ -0,0 +1,76 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/watchdog/qcom,gh-watchdog.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Qualcomm Gunyah Virtual Watchdog + +maintainers: + - Hrishabh Rajput <hrishabh.rajput@oss.qualcomm.com> + +description: |+ + The Gunyah Hypervisor provides an SMC-based watchdog interface for its virtual + machines. The virtual machines use this information to determine the + pretimeout IRQ which the hypervisor will be using to communicate pretimeout + event. + See also: [1] + + [1]: https://github.com/quic/gunyah-resource-manager/blob/1b23ceb0dfa010b3b6b5a5f7a4ec1e95b93ab99d/src/vm_creation/dto_construct.c#L519 + +properties: + compatible: + allOf: + - const: gunyah-hypervisor + - const: simple-bus + + "#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: + "^gh-watchdog": + type: object + description: + Watchdog node which provides information about the pretimeout IRQ which + will be used to communicate the pretimeout event. + + properties: + compatible: + const: qcom,gh-watchdog + + interrupts: + items: + description: Interrupt for the pretimeout. + + additionalProperties: false + + required: + - compatible + - interrupts + +additionalProperties: false + +required: + - compatible + - "#address-cells" + - "#size-cells" + +examples: + - | + #include <dt-bindings/interrupt-controller/arm-gic.h> + + hypervisor { + compatible = "gunyah-hypervisor", "simple-bus"; + #address-cells = <2>; + #size-cells = <0>; + + gh-watchdog { + compatible = "qcom,gh-watchdog"; + interrupts = <GIC_SPI 0 IRQ_TYPE_EDGE_RISING>; /* Pretimeout IRQ */ + };
diff --git a/MAINTAINERS b/MAINTAINERS
index c0b444e5fd5a..03b74513e4ac 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS@@ -3076,6 +3076,7 @@ F: Documentation/devicetree/bindings/cache/qcom,llcc.yaml F: Documentation/devicetree/bindings/firmware/qcom,scm.yaml F: Documentation/devicetree/bindings/reserved-memory/qcom* F: Documentation/devicetree/bindings/soc/qcom/ +F: Documentation/devicetree/bindings/watchdog/qcom,gh-watchdog.yaml F: arch/arm/boot/dts/qcom/ F: arch/arm/configs/qcom_defconfig F: arch/arm/mach-qcom/
--
2.43.0