dt-bindings: interrupt-controller: Convert nvidia,tegra20-ictlr to DT schema

Convert the NVIDIA Legacy interrupt controller binding to schema
format. It's a straight-forward conversion of the typical interrupt
controller.

All the possible compatibles were not documented, so add the ones in
use.

Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://lore.kernel.org/r/20250505144759.1291261-1-robh@kernel.org
Signed-off-by: Thierry Reding <treding@nvidia.com>
This commit is contained in:
Rob Herring (Arm) 2025-05-05 09:47:58 -05:00 committed by Thierry Reding
parent d2c9d35480
commit c4cd2aa6a3
2 changed files with 82 additions and 41 deletions

View file

@ -1,41 +0,0 @@
NVIDIA Legacy Interrupt Controller
All Tegra SoCs contain a legacy interrupt controller that routes
interrupts to the GIC, and also serves as a wakeup source. It is also
referred to as "ictlr", hence the name of the binding.
The HW block exposes a number of interrupt controllers, each
implementing a set of 32 interrupts.
Required properties:
- compatible : should be: "nvidia,tegra<chip>-ictlr". The LIC on
subsequent SoCs remained backwards-compatible with Tegra30, so on
Tegra generations later than Tegra30 the compatible value should
include "nvidia,tegra30-ictlr".
- reg : Specifies base physical address and size of the registers.
Each controller must be described separately (Tegra20 has 4 of them,
whereas Tegra30 and later have 5).
- interrupt-controller : Identifies the node as an interrupt controller.
- #interrupt-cells : Specifies the number of cells needed to encode an
interrupt source. The value must be 3.
Notes:
- Because this HW ultimately routes interrupts to the GIC, the
interrupt specifier must be that of the GIC.
- Only SPIs can use the ictlr as an interrupt parent. SGIs and PPIs
are explicitly forbidden.
Example:
ictlr: interrupt-controller@60004000 {
compatible = "nvidia,tegra20-ictlr", "nvidia,tegra-ictlr";
reg = <0x60004000 64>,
<0x60004100 64>,
<0x60004200 64>,
<0x60004300 64>;
interrupt-controller;
#interrupt-cells = <3>;
interrupt-parent = <&intc>;
};

View file

@ -0,0 +1,82 @@
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/interrupt-controller/nvidia,tegra20-ictlr.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: NVIDIA Tegra20 Legacy Interrupt Controller
maintainers:
- Thierry Reding <treding@nvidia.com>
- Jonathan Hunter <jonathanh@nvidia.com>
description: >
All Tegra SoCs contain a legacy interrupt controller that routes interrupts to
the GIC, and also serves as a wakeup source. It is also referred to as
"ictlr", hence the name of the binding.
The HW block exposes a number of interrupt controllers, each implementing a
set of 32 interrupts.
Notes:
- Because this HW ultimately routes interrupts to the GIC, the
interrupt specifier must be that of the GIC.
- Only SPIs can use the ictlr as an interrupt parent. SGIs and PPIs
are explicitly forbidden.
properties:
compatible:
oneOf:
- items:
- enum:
- nvidia,tegra114-ictlr
- nvidia,tegra124-ictlr
- const: nvidia,tegra30-ictlr
- enum:
- nvidia,tegra20-ictlr
- nvidia,tegra30-ictlr
reg:
description: Each entry is a block of 32 interrupts
minItems: 4
maxItems: 5
interrupt-controller: true
'#interrupt-cells':
const: 3
required:
- compatible
- reg
- interrupt-controller
- '#interrupt-cells'
additionalProperties: false
allOf:
- if:
properties:
compatible:
contains:
const: nvidia,tegra20-ictlr
then:
properties:
reg:
maxItems: 4
else:
properties:
reg:
minItems: 5
examples:
- |
interrupt-controller@60004000 {
compatible = "nvidia,tegra20-ictlr";
reg = <0x60004000 64>,
<0x60004100 64>,
<0x60004200 64>,
<0x60004300 64>;
interrupt-controller;
#interrupt-cells = <3>;
};