mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2025-01-12 00:00:00 +00:00
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>
125 lines
2.6 KiB
YAML
125 lines
2.6 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/serial/pl011.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: ARM AMBA Primecell PL011 serial UART
|
|
|
|
maintainers:
|
|
- Rob Herring <robh@kernel.org>
|
|
|
|
allOf:
|
|
- $ref: /schemas/serial.yaml#
|
|
|
|
# Need a custom select here or 'arm,primecell' will match on lots of nodes
|
|
select:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- arm,pl011
|
|
- zte,zx296702-uart
|
|
required:
|
|
- compatible
|
|
|
|
properties:
|
|
compatible:
|
|
oneOf:
|
|
- items:
|
|
- const: arm,pl011
|
|
- const: arm,primecell
|
|
- items:
|
|
- const: zte,zx296702-uart
|
|
- const: arm,primecell
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
|
|
pinctrl-0: true
|
|
pinctrl-1: true
|
|
|
|
pinctrl-names:
|
|
description:
|
|
When present, must have one state named "default",
|
|
and may contain a second name named "sleep". The former
|
|
state sets up pins for ordinary operation whereas
|
|
the latter state will put the associated pins to sleep
|
|
when the UART is unused
|
|
minItems: 1
|
|
items:
|
|
- const: default
|
|
- const: sleep
|
|
|
|
clocks:
|
|
description:
|
|
When present, the first clock listed must correspond to
|
|
the clock named UARTCLK on the IP block, i.e. the clock
|
|
to the external serial line, whereas the second clock
|
|
must correspond to the PCLK clocking the internal logic
|
|
of the block. Just listing one clock (the first one) is
|
|
deprecated.
|
|
maxItems: 2
|
|
|
|
clock-names:
|
|
items:
|
|
- const: uartclk
|
|
- const: apb_pclk
|
|
|
|
dmas:
|
|
minItems: 1
|
|
maxItems: 2
|
|
|
|
dma-names:
|
|
minItems: 1
|
|
items:
|
|
- const: rx
|
|
- const: tx
|
|
|
|
auto-poll:
|
|
description:
|
|
Enables polling when using RX DMA.
|
|
type: boolean
|
|
|
|
poll-rate-ms:
|
|
description:
|
|
Rate at which poll occurs when auto-poll is set.
|
|
default 100ms.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
default: 100
|
|
|
|
poll-timeout-ms:
|
|
description:
|
|
Poll timeout when auto-poll is set, default
|
|
3000ms.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
default: 3000
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- interrupts
|
|
|
|
dependencies:
|
|
poll-rate-ms: [ auto-poll ]
|
|
poll-timeout-ms: [ auto-poll ]
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
serial@80120000 {
|
|
compatible = "arm,pl011", "arm,primecell";
|
|
reg = <0x80120000 0x1000>;
|
|
interrupts = <0 11 4>;
|
|
dmas = <&dma 13 0 0x2>, <&dma 13 0 0x0>;
|
|
dma-names = "rx", "tx";
|
|
clocks = <&foo_clk>, <&bar_clk>;
|
|
clock-names = "uartclk", "apb_pclk";
|
|
};
|
|
|
|
...
|