mirror of
https://github.com/edk2-porting/linux-next.git
synced 2025-01-10 06:34:17 +08:00
6fdc6e23a7
This doesn't yet do anything in the tools, but make it explicit so we can check either 'unevaluatedProperties' or 'additionalProperties' is present in schemas. 'unevaluatedProperties' is appropriate when including another schema (via '$ref') and all possible properties and/or child nodes are not explicitly listed in the schema with the '$ref'. This is in preparation to add a meta-schema to check for missing 'unevaluatedProperties' or 'additionalProperties'. This has been a constant source of review issues. Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Wolfram Sang <wsa@kernel.org> Acked-by: Krzysztof Kozlowski <krzk@kernel.org> Acked-By: Vinod Koul <vkoul@kernel.org> Acked-by: Geert Uytterhoeven <geert+renesas@glider.be> Acked-by: Ulf Hansson <ulf.hansson@linaro.org> Acked-by: Guenter Roeck <linux@roeck-us.net> Acked-by: Mathieu Poirier <mathieu.poirier@linaro.org> Acked-by: Dmitry Torokhov <dmitry.torokhov@gmail.com> Link: https://lore.kernel.org/r/20201005183830.486085-2-robh@kernel.org Signed-off-by: Rob Herring <robh@kernel.org>
161 lines
3.9 KiB
YAML
161 lines
3.9 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/spi/spi-pl022.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: ARM PL022 SPI controller
|
|
|
|
maintainers:
|
|
- Linus Walleij <linus.walleij@linaro.org>
|
|
|
|
allOf:
|
|
- $ref: "spi-controller.yaml#"
|
|
|
|
# We need a select here so we don't match all nodes with 'arm,primecell'
|
|
select:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: arm,pl022
|
|
required:
|
|
- compatible
|
|
|
|
properties:
|
|
compatible:
|
|
items:
|
|
- const: arm,pl022
|
|
- const: arm,primecell
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
maxItems: 2
|
|
|
|
clock-names:
|
|
items:
|
|
- enum:
|
|
- SSPCLK
|
|
- sspclk
|
|
- const: apb_pclk
|
|
|
|
pl022,autosuspend-delay:
|
|
description: delay in ms following transfer completion before the
|
|
runtime power management system suspends the device. A setting of 0
|
|
indicates no delay and the device will be suspended immediately.
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
|
|
pl022,rt:
|
|
description: indicates the controller should run the message pump with realtime
|
|
priority to minimise the transfer latency on the bus (boolean)
|
|
type: boolean
|
|
|
|
dmas:
|
|
description:
|
|
Two or more DMA channel specifiers following the convention outlined
|
|
in bindings/dma/dma.txt
|
|
minItems: 2
|
|
maxItems: 32
|
|
|
|
dma-names:
|
|
description:
|
|
There must be at least one channel named "tx" for transmit and named "rx"
|
|
for receive.
|
|
minItems: 2
|
|
maxItems: 32
|
|
additionalItems: true
|
|
items:
|
|
- const: rx
|
|
- const: tx
|
|
|
|
patternProperties:
|
|
"^[a-zA-Z][a-zA-Z0-9,+\\-._]{0,63}@[0-9a-f]+$":
|
|
type: object
|
|
# SPI slave nodes must be children of the SPI master node and can
|
|
# contain the following properties.
|
|
properties:
|
|
pl022,interface:
|
|
description: SPI interface type
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
enum:
|
|
- 0 # SPI
|
|
- 1 # Texas Instruments Synchronous Serial Frame Format
|
|
- 2 # Microwire (Half Duplex)
|
|
|
|
pl022,com-mode:
|
|
description: Specifies the transfer mode
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
enum:
|
|
- 0 # interrupt mode
|
|
- 1 # polling mode
|
|
- 2 # DMA mode
|
|
default: 1
|
|
|
|
pl022,rx-level-trig:
|
|
description: Rx FIFO watermark level
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 4
|
|
|
|
pl022,tx-level-trig:
|
|
description: Tx FIFO watermark level
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 4
|
|
|
|
pl022,ctrl-len:
|
|
description: Microwire interface - Control length
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0x03
|
|
maximum: 0x1f
|
|
|
|
pl022,wait-state:
|
|
description: Microwire interface - Wait state
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
enum: [0, 1]
|
|
|
|
pl022,duplex:
|
|
description: Microwire interface - Full/Half duplex
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
enum: [0, 1]
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- interrupts
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
spi@e0100000 {
|
|
compatible = "arm,pl022", "arm,primecell";
|
|
reg = <0xe0100000 0x1000>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
interrupts = <0 31 0x4>;
|
|
dmas = <&dma_controller 23 1>,
|
|
<&dma_controller 24 0>;
|
|
dma-names = "rx", "tx";
|
|
|
|
m25p80@1 {
|
|
compatible = "st,m25p80";
|
|
reg = <1>;
|
|
spi-max-frequency = <12000000>;
|
|
spi-cpol;
|
|
spi-cpha;
|
|
pl022,interface = <0>;
|
|
pl022,com-mode = <0x2>;
|
|
pl022,rx-level-trig = <0>;
|
|
pl022,tx-level-trig = <0>;
|
|
pl022,ctrl-len = <0x11>;
|
|
pl022,wait-state = <0>;
|
|
pl022,duplex = <0>;
|
|
};
|
|
};
|
|
...
|