mirror of
https://github.com/torvalds/linux.git
synced 2026-04-18 06:44:00 -04:00
The correct syntax for JSON pointers begins with a '/' after the '#'. Without a '/', the string should be interpreted as a subschema identifier. The jsonschema module currently doesn't handle subschema identifiers and incorrectly allows JSON pointers to begin without a '/'. Let's fix this before it becomes a problem when jsonschema module is fixed. Converted with: perl -p -i -e 's/yaml#definitions/yaml#\/definitions/g' `find Documentation/devicetree/bindings/ -name "*.yaml"` Cc: Maxime Ripard <mripard@kernel.org> Cc: Jonathan Cameron <jic23@kernel.org> Cc: Lars-Peter Clausen <lars@metafoo.de> Cc: Daniel Thompson <daniel.thompson@linaro.org> Cc: Jingoo Han <jingoohan1@gmail.com> Cc: Pavel Machek <pavel@ucw.cz> Cc: "David S. Miller" <davem@davemloft.net> Cc: Jakub Kicinski <kuba@kernel.org> Cc: Andrew Lunn <andrew@lunn.ch> Cc: Florian Fainelli <f.fainelli@gmail.com> Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Cc: Mark Brown <broonie@kernel.org> Cc: netdev@vger.kernel.org Acked-By: Vinod Koul <vkoul@kernel.org> Acked-by: Lee Jones <lee.jones@linaro.org> Acked-by: Guenter Roeck <linux@roeck-us.net> Acked-by: Sebastian Reichel <sre@kernel.org> Acked-by: Florian Fainelli <f.fainelli@gmail.com> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Jakub Kicinski <kuba@kernel.org> Link: https://lore.kernel.org/r/20201217223429.354283-1-robh@kernel.org Signed-off-by: Rob Herring <robh@kernel.org>
83 lines
2.1 KiB
YAML
83 lines
2.1 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/dma/ingenic,dma.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Ingenic SoCs DMA Controller DT bindings
|
|
|
|
maintainers:
|
|
- Paul Cercueil <paul@crapouillou.net>
|
|
|
|
allOf:
|
|
- $ref: "dma-controller.yaml#"
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- ingenic,jz4740-dma
|
|
- ingenic,jz4725b-dma
|
|
- ingenic,jz4770-dma
|
|
- ingenic,jz4780-dma
|
|
- ingenic,x1000-dma
|
|
- ingenic,x1830-dma
|
|
|
|
reg:
|
|
items:
|
|
- description: Channel-specific registers
|
|
- description: System control registers
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
maxItems: 1
|
|
|
|
"#dma-cells":
|
|
const: 2
|
|
description: >
|
|
DMA clients must use the format described in dma.txt, giving a phandle
|
|
to the DMA controller plus the following 2 integer cells:
|
|
|
|
- Request type: The DMA request type for transfers to/from the
|
|
device on the allocated channel, as defined in the SoC documentation.
|
|
|
|
- Channel: If set to 0xffffffff, any available channel will be allocated
|
|
for the client. Otherwise, the exact channel specified will be used.
|
|
The channel should be reserved on the DMA controller using the
|
|
ingenic,reserved-channels property.
|
|
|
|
ingenic,reserved-channels:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: >
|
|
Bitmask of channels to reserve for devices that need a specific
|
|
channel. These channels will only be assigned when explicitely
|
|
requested by a client. The primary use for this is channels 0 and
|
|
1, which can be configured to have special behaviour for NAND/BCH
|
|
when using programmable firmware.
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- interrupts
|
|
- clocks
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/clock/jz4780-cgu.h>
|
|
dma: dma-controller@13420000 {
|
|
compatible = "ingenic,jz4780-dma";
|
|
reg = <0x13420000 0x400>, <0x13421000 0x40>;
|
|
|
|
interrupt-parent = <&intc>;
|
|
interrupts = <10>;
|
|
|
|
clocks = <&cgu JZ4780_CLK_PDMA>;
|
|
|
|
#dma-cells = <2>;
|
|
|
|
ingenic,reserved-channels = <0x3>;
|
|
};
|