Commit f3ce2e12 authored by Rob Herring (Arm)'s avatar Rob Herring (Arm)
Browse files

dt-bindings: interrupt-controller: Convert qca,ar7100-cpu-intc to DT schema

Convert the Qualcomm Atheros ath79 CPU interrupt controller binding to
schema format.

Link: https://lore.kernel.org/r/20250505144817.1291980-1-robh@kernel.org


Signed-off-by: default avatarRob Herring (Arm) <robh@kernel.org>
parent bbb1999a
Loading
Loading
Loading
Loading
+61 −0
Original line number Diff line number Diff line
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/interrupt-controller/qca,ar7100-cpu-intc.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Qualcomm Atheros ath79 CPU interrupt controller

maintainers:
  - Alban Bedel <albeu@free.fr>

description:
  On most SoC the IRQ controller need to flush the DDR FIFO before running the
  interrupt handler of some devices. This is configured using the
  qca,ddr-wb-channels and qca,ddr-wb-channel-interrupts properties.

properties:
  compatible:
    oneOf:
      - items:
          - const: qca,ar9132-cpu-intc
          - const: qca,ar7100-cpu-intc
      - items:
          - const: qca,ar7100-cpu-intc

  interrupt-controller: true

  '#interrupt-cells':
    const: 1

  qca,ddr-wb-channel-interrupts:
    description: List of interrupts needing a write buffer flush
    $ref: /schemas/types.yaml#/definitions/uint32-array

  qca,ddr-wb-channels:
    description: List of write buffer channel phandles for each interrupt
    $ref: /schemas/types.yaml#/definitions/phandle-array

required:
  - compatible
  - interrupt-controller
  - '#interrupt-cells'

additionalProperties: false

examples:
  - |
      interrupt-controller {
          compatible = "qca,ar9132-cpu-intc", "qca,ar7100-cpu-intc";

          interrupt-controller;
          #interrupt-cells = <1>;

          qca,ddr-wb-channel-interrupts = <2>, <3>, <4>, <5>;
          qca,ddr-wb-channels = <&ddr_ctrl 3>, <&ddr_ctrl 2>,
                                <&ddr_ctrl 0>, <&ddr_ctrl 1>;
      };

      ddr_ctrl: memory-controller {
          #qca,ddr-wb-channel-cells = <1>;
      };
+0 −44
Original line number Diff line number Diff line
Binding for Qualcomm Atheros AR7xxx/AR9XXX CPU interrupt controller

On most SoC the IRQ controller need to flush the DDR FIFO before running
the interrupt handler of some devices. This is configured using the
qca,ddr-wb-channels and qca,ddr-wb-channel-interrupts properties.

Required Properties:

- compatible: has to be "qca,<soctype>-cpu-intc", "qca,ar7100-cpu-intc"
  as fallback
- interrupt-controller : Identifies the node as an interrupt controller
- #interrupt-cells : Specifies the number of cells needed to encode interrupt
		     source, should be 1 for intc

Please refer to interrupts.txt in this directory for details of the common
Interrupt Controllers bindings used by client devices.

Optional Properties:

- qca,ddr-wb-channel-interrupts: List of the interrupts needing a write
  buffer flush
- qca,ddr-wb-channels: List of phandles to the write buffer channels for
  each interrupt. If qca,ddr-wb-channel-interrupts is not present the interrupt
  default to the entry's index.

Example:

	interrupt-controller {
		compatible = "qca,ar9132-cpu-intc", "qca,ar7100-cpu-intc";

		interrupt-controller;
		#interrupt-cells = <1>;

		qca,ddr-wb-channel-interrupts = <2>, <3>, <4>, <5>;
		qca,ddr-wb-channels = <&ddr_ctrl 3>, <&ddr_ctrl 2>,
					<&ddr_ctrl 0>, <&ddr_ctrl 1>;
	};

	...

	ddr_ctrl: memory-controller@18000000 {
		...
		#qca,ddr-wb-channel-cells = <1>;
	};