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

dt-bindings: misc: aspeed,ast2400-cvic: Convert to DT schema

Address warnings such as:

arch/arm/boot/dts/aspeed/aspeed-bmc-facebook-galaxy100.dtb: interrupt-controller@1e6c0080: 'valid-sources' does not match any of the regexes: 'pinctrl-[0-9]+'

and

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

Note that the conversion to DT schema causes some further warnings to
be emitted, because the Aspeed devicetrees are not in great shape. These
new warnings are resolved in a separate series:

https://lore.kernel.org/lkml/20240802-dt-warnings-bmc-dts-cleanups-v1-0-1cb1378e5fcd@codeconstruct.com.au/

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-2-c2531e02633d@codeconstruct.com.au
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>

authored by

Andrew Jeffery and committed by
Rob Herring (Arm)
7c43f89b b081414e

+60 -35
+60
Documentation/devicetree/bindings/misc/aspeed,ast2400-cvic.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/misc/aspeed,ast2400-cvic.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Aspeed Coprocessor Vectored Interrupt Controller 8 + 9 + maintainers: 10 + - Andrew Jeffery <andrew@codeconstruct.com.au> 11 + 12 + description: 13 + The Aspeed AST2400 and AST2500 SoCs have a controller that provides interrupts 14 + to the ColdFire coprocessor. It's not a normal interrupt controller and it 15 + would be rather inconvenient to create an interrupt tree for it, as it 16 + somewhat shares some of the same sources as the main ARM interrupt controller 17 + but with different numbers. 18 + 19 + The AST2500 also supports a software generated interrupt. 20 + 21 + properties: 22 + compatible: 23 + items: 24 + - enum: 25 + - aspeed,ast2400-cvic 26 + - aspeed,ast2500-cvic 27 + - const: aspeed,cvic 28 + 29 + reg: 30 + maxItems: 1 31 + 32 + valid-sources: 33 + $ref: /schemas/types.yaml#/definitions/uint32-array 34 + maxItems: 1 35 + description: 36 + A bitmap of supported sources for the implementation. 37 + 38 + copro-sw-interrupts: 39 + $ref: /schemas/types.yaml#/definitions/uint32-array 40 + minItems: 1 41 + maxItems: 32 42 + description: 43 + A list of interrupt numbers that can be used as software interrupts from 44 + the ARM to the coprocessor. 45 + 46 + required: 47 + - compatible 48 + - reg 49 + - valid-sources 50 + 51 + additionalProperties: false 52 + 53 + examples: 54 + - | 55 + interrupt-controller@1e6c2000 { 56 + compatible = "aspeed,ast2500-cvic", "aspeed,cvic"; 57 + reg = <0x1e6c2000 0x80>; 58 + valid-sources = <0xffffffff>; 59 + copro-sw-interrupts = <1>; 60 + };
-35
Documentation/devicetree/bindings/misc/aspeed,cvic.txt
··· 1 - * ASPEED AST2400 and AST2500 coprocessor interrupt controller 2 - 3 - This file describes the bindings for the interrupt controller present 4 - in the AST2400 and AST2500 BMC SoCs which provides interrupt to the 5 - ColdFire coprocessor. 6 - 7 - It is not a normal interrupt controller and it would be rather 8 - inconvenient to create an interrupt tree for it as it somewhat shares 9 - some of the same sources as the main ARM interrupt controller but with 10 - different numbers. 11 - 12 - The AST2500 supports a SW generated interrupt 13 - 14 - Required properties: 15 - - reg: address and length of the register for the device. 16 - - compatible: "aspeed,cvic" and one of: 17 - "aspeed,ast2400-cvic" 18 - or 19 - "aspeed,ast2500-cvic" 20 - 21 - - valid-sources: One cell, bitmap of supported sources for the implementation 22 - 23 - Optional properties; 24 - - copro-sw-interrupts: List of interrupt numbers that can be used as 25 - SW interrupts from the ARM to the coprocessor. 26 - (AST2500 only) 27 - 28 - Example: 29 - 30 - cvic: copro-interrupt-controller@1e6c2000 { 31 - compatible = "aspeed,ast2500-cvic"; 32 - valid-sources = <0xffffffff>; 33 - copro-sw-interrupts = <1>; 34 - reg = <0x1e6c2000 0x80>; 35 - };