3d21a46093
json-schema versions draft7 and earlier have a weird behavior in that any keywords combined with a '$ref' are ignored (silently). The correct form was to put a '$ref' under an 'allOf'. This behavior is now changed in the 2019-09 json-schema spec and '$ref' can be mixed with other keywords. The json-schema library doesn't yet support this, but the tooling now does a fixup for this and either way works. This has been a constant source of review comments, so let's change this treewide so everyone copies the simpler syntax. Scripted with ruamel.yaml with some manual fixups. Some minor whitespace changes from the script. Signed-off-by: Rob Herring <robh@kernel.org> Acked-by: Maxime Ripard <mripard@kernel.org> Acked-by: Lee Jones <lee.jones@linaro.org> Acked-By: Vinod Koul <vkoul@kernel.org> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com> Acked-by: Wolfram Sang <wsa@the-dreams.de> # for I2C Reviewed-by: Linus Walleij <linus.walleij@linaro.org> Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for-iio Reviewed-by: Stephen Boyd <sboyd@kernel.org> # clock Signed-off-by: Rob Herring <robh@kernel.org>
52 lines
1.3 KiB
YAML
52 lines
1.3 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/dma/dma-common.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: DMA Engine Generic Binding
|
|
|
|
maintainers:
|
|
- Vinod Koul <vkoul@kernel.org>
|
|
|
|
description:
|
|
Generic binding to provide a way for a driver using DMA Engine to
|
|
retrieve the DMA request or channel information that goes from a
|
|
hardware device to a DMA controller.
|
|
|
|
select: false
|
|
|
|
properties:
|
|
"#dma-cells":
|
|
minimum: 1
|
|
# Should be enough
|
|
maximum: 255
|
|
description:
|
|
Used to provide DMA controller specific information.
|
|
|
|
dma-channel-mask:
|
|
description:
|
|
Bitmask of available DMA channels in ascending order that are
|
|
not reserved by firmware and are available to the
|
|
kernel. i.e. first channel corresponds to LSB.
|
|
The first item in the array is for channels 0-31, the second is for
|
|
channels 32-63, etc.
|
|
$ref: /schemas/types.yaml#/definitions/uint32-array
|
|
items:
|
|
minItems: 1
|
|
# Should be enough
|
|
maxItems: 255
|
|
|
|
dma-channels:
|
|
$ref: /schemas/types.yaml#definitions/uint32
|
|
description:
|
|
Number of DMA channels supported by the controller.
|
|
|
|
dma-requests:
|
|
$ref: /schemas/types.yaml#definitions/uint32
|
|
description:
|
|
Number of DMA request signals supported by the controller.
|
|
|
|
required:
|
|
- "#dma-cells"
|