39bd2b6a37
The 'phandle-array' type is a bit ambiguous. It can be either just an
array of phandles or an array of phandles plus args. Many schemas for
phandle-array properties aren't clear in the schema which case applies
though the description usually describes it.
The array of phandles case boils down to needing:
items:
maxItems: 1
The phandle plus args cases should typically take this form:
items:
- items:
- description: A phandle
- description: 1st arg cell
- description: 2nd arg cell
With this change, some examples need updating so that the bracketing of
property values matches the schema.
Signed-off-by: Rob Herring <robh@kernel.org>
Acked-by: Viresh Kumar <viresh.kumar@linaro.org>
Acked-by: Vinod Koul <vkoul@kernel.org>
Acked-by: Ulf Hansson <ulf.hansson@linaro.org>
Acked-by: Georgi Djakov <djakov@kernel.org>
Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>
Acked-by: Mark Brown <broonie@kernel.org>
Acked-by: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
Acked-by: Stephen Boyd <sboyd@kernel.org>
Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Acked-by: Marc Kleine-Budde <mkl@pengutronix.de>
Link: https://lore.kernel.org/r/20220119015038.2433585-1-robh@kernel.org
55 lines
1.2 KiB
YAML
55 lines
1.2 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/dma/dma-router.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: DMA Router Generic Binding
|
|
|
|
maintainers:
|
|
- Vinod Koul <vkoul@kernel.org>
|
|
|
|
allOf:
|
|
- $ref: "dma-common.yaml#"
|
|
|
|
description:
|
|
DMA routers are transparent IP blocks used to route DMA request
|
|
lines from devices to the DMA controller. Some SoCs (like TI DRA7x)
|
|
have more peripherals integrated with DMA requests than what the DMA
|
|
controller can handle directly.
|
|
|
|
properties:
|
|
$nodename:
|
|
pattern: "^dma-router(@.*)?$"
|
|
|
|
dma-masters:
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
items:
|
|
maxItems: 1
|
|
description:
|
|
Array of phandles to the DMA controllers the router can direct
|
|
the signal to.
|
|
|
|
dma-requests:
|
|
description:
|
|
Number of incoming request lines the router can handle.
|
|
|
|
required:
|
|
- "#dma-cells"
|
|
- dma-masters
|
|
|
|
additionalProperties: true
|
|
|
|
examples:
|
|
- |
|
|
sdma_xbar: dma-router@4a002b78 {
|
|
compatible = "ti,dra7-dma-crossbar";
|
|
reg = <0x4a002b78 0xfc>;
|
|
#dma-cells = <1>;
|
|
dma-requests = <205>;
|
|
ti,dma-safe-map = <0>;
|
|
dma-masters = <&sdma>;
|
|
};
|
|
|
|
...
|