Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: interrupt-controller: aspeed,ast2400-vic: Convert to DT schema

Squash warnings such as:

arch/arm/boot/dts/aspeed/aspeed-bmc-facebook-galaxy100.dtb: /ahb/interrupt-controller@1e6c0080: failed to match any schema with compatible: ['aspeed,ast2400-vic']

The YAML DT schema defines an optional property, valid-sources, which
was not previously described in the prose binding. It is added to
document existing practice in the Aspeed devicetrees. Unfortunately
the property seems to predate the requirement that vendor-specific
properties be prefixed.

Signed-off-by: Andrew Jeffery <andrew@codeconstruct.com.au>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20240808-dt-warnings-irq-aspeed-dt-schema-v2-1-c2531e02633d@codeconstruct.com.au
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>

authored by

Andrew Jeffery and committed by
Rob Herring (Arm)
b081414e 84252c1d

+62 -23
-23
Documentation/devicetree/bindings/interrupt-controller/aspeed,ast2400-vic.txt
··· 1 - Aspeed Vectored Interrupt Controller 2 - 3 - These bindings are for the Aspeed interrupt controller. The AST2400 and 4 - AST2500 SoC families include a legacy register layout before a re-designed 5 - layout, but the bindings do not prescribe the use of one or the other. 6 - 7 - Required properties: 8 - 9 - - compatible : "aspeed,ast2400-vic" 10 - "aspeed,ast2500-vic" 11 - 12 - - interrupt-controller : Identifies the node as an interrupt controller 13 - - #interrupt-cells : Specifies the number of cells needed to encode an 14 - interrupt source. The value shall be 1. 15 - 16 - Example: 17 - 18 - vic: interrupt-controller@1e6c0080 { 19 - compatible = "aspeed,ast2400-vic"; 20 - interrupt-controller; 21 - #interrupt-cells = <1>; 22 - reg = <0x1e6c0080 0x80>; 23 - };
+62
Documentation/devicetree/bindings/interrupt-controller/aspeed,ast2400-vic.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/interrupt-controller/aspeed,ast2400-vic.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Aspeed Vectored Interrupt Controller 8 + 9 + maintainers: 10 + - Andrew Jeffery <andrew@codeconstruct.com.au> 11 + 12 + description: 13 + The AST2400 and AST2500 SoC families include a legacy register layout before 14 + a redesigned layout, but the bindings do not prescribe the use of one or the 15 + other. 16 + 17 + properties: 18 + compatible: 19 + enum: 20 + - aspeed,ast2400-vic 21 + - aspeed,ast2500-vic 22 + 23 + reg: 24 + maxItems: 1 25 + 26 + interrupt-controller: true 27 + 28 + "#interrupt-cells": 29 + const: 1 30 + description: 31 + Specifies the number of cells needed to encode an interrupt source. It 32 + must be 1 as the VIC has no configuration options for interrupt sources. 33 + The single cell defines the interrupt number. 34 + 35 + valid-sources: 36 + $ref: /schemas/types.yaml#/definitions/uint32-array 37 + maxItems: 2 38 + description: 39 + A bitmap of supported sources for the implementation. 40 + 41 + required: 42 + - compatible 43 + - reg 44 + - interrupt-controller 45 + - "#interrupt-cells" 46 + 47 + allOf: 48 + - $ref: /schemas/interrupt-controller.yaml 49 + 50 + additionalProperties: false 51 + 52 + examples: 53 + - | 54 + interrupt-controller@1e6c0080 { 55 + compatible = "aspeed,ast2400-vic"; 56 + reg = <0x1e6c0080 0x80>; 57 + interrupt-controller; 58 + #interrupt-cells = <1>; 59 + valid-sources = <0xffffffff 0x0007ffff>; 60 + }; 61 + 62 + ...