[PATCH v3 5/9] dt-bindings: clock: xilinx: add description of user monitor interrupt

From: Harry Austen
Date: Mon Aug 26 2024 - 08:39:58 EST


This Xilinx clocking wizard IP core outputs this interrupt signal to
indicate when one of the four optional user clock inputs is either
stopped, overruns, underruns or glitches.

This functionality was only added from version 6.0 onwards, so restrict
it to particular compatible strings.

Signed-off-by: Harry Austen <hpausten@xxxxxxxxxxxxxx>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@xxxxxxxxxx>
---
.../bindings/clock/xlnx,clocking-wizard.yaml | 24 ++++++++++++++++++-
1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/Documentation/devicetree/bindings/clock/xlnx,clocking-wizard.yaml b/Documentation/devicetree/bindings/clock/xlnx,clocking-wizard.yaml
index 9d5324dc1027a..2b9903f05ef34 100644
--- a/Documentation/devicetree/bindings/clock/xlnx,clocking-wizard.yaml
+++ b/Documentation/devicetree/bindings/clock/xlnx,clocking-wizard.yaml
@@ -39,6 +39,13 @@ properties:
- const: clk_in1
- const: s_axi_aclk

+ interrupts:
+ items:
+ - description: user clock monitor interrupt
+
+ interrupt-names:
+ items:
+ - const: monitor

xlnx,speed-grade:
$ref: /schemas/types.yaml#/definitions/uint32
@@ -62,17 +69,32 @@ required:
- xlnx,speed-grade
- xlnx,nr-outputs

+allOf:
+ - if:
+ properties:
+ compatible:
+ enum:
+ - xlnx,clocking-wizard
+ - xlnx,clocking-wizard-v5.2
+ then:
+ properties:
+ interrupts: false
+ interrupt-names: false
+
additionalProperties: false

examples:
- |
+ #include <dt-bindings/interrupt-controller/irq.h>
clock-controller@b0000000 {
- compatible = "xlnx,clocking-wizard";
+ compatible = "xlnx,clocking-wizard-v6.0";
reg = <0xb0000000 0x10000>;
#clock-cells = <1>;
xlnx,speed-grade = <1>;
xlnx,nr-outputs = <6>;
clock-names = "clk_in1", "s_axi_aclk";
clocks = <&clkc 15>, <&clkc 15>;
+ interrupts-extended = <&intc 52 IRQ_TYPE_EDGE_RISING>;
+ interrupt-names = "monitor";
};
...
--
2.46.0