1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/serial/pl011.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: ARM AMBA Primecell PL011 serial UART
8
9 maintainers:
10 - Rob Herring <robh@kernel.org>
11
12 allOf:
13 - $ref: serial.yaml#
14
15 # Need a custom select here or 'arm,primecell' will match on lots of nodes
16 select:
17 properties:
18 compatible:
19 contains:
20 enum:
21 - arm,pl011
22 required:
23 - compatible
24
25 properties:
26 compatible:
27 items:
28 - const: arm,pl011
29 - const: arm,primecell
30
31 reg:
32 maxItems: 1
33
34 interrupts:
35 maxItems: 1
36
37 pinctrl-0: true
38 pinctrl-1: true
39
40 pinctrl-names:
41 description:
42 When present, must have one state named "default",
43 and may contain a second name named "sleep". The former
44 state sets up pins for ordinary operation whereas
45 the latter state will put the associated pins to sleep
46 when the UART is unused
47 minItems: 1
48 items:
49 - const: default
50 - const: sleep
51
52 clocks:
53 description:
54 When present, the first clock listed must correspond to
55 the clock named UARTCLK on the IP block, i.e. the clock
56 to the external serial line, whereas the second clock
57 must correspond to the PCLK clocking the internal logic
58 of the block. Just listing one clock (the first one) is
59 deprecated.
60 maxItems: 2
61
62 clock-names:
63 items:
64 - const: uartclk
65 - const: apb_pclk
66
67 dmas:
68 minItems: 1
69 maxItems: 2
70
71 dma-names:
72 minItems: 1
73 items:
74 - const: rx
75 - const: tx
76
77 auto-poll:
78 description:
79 Enables polling when using RX DMA.
80 type: boolean
81
82 poll-rate-ms:
83 description:
84 Rate at which poll occurs when auto-poll is set.
85 default 100ms.
86 default: 100
87
88 poll-timeout-ms:
89 description:
90 Poll timeout when auto-poll is set, default
91 3000ms.
92 default: 3000
93
94 resets:
95 maxItems: 1
96
97 required:
98 - compatible
99 - reg
100 - interrupts
101
102 dependencies:
103 poll-rate-ms: [ auto-poll ]
104 poll-timeout-ms: [ auto-poll ]
105
106 unevaluatedProperties: false
107
108 examples:
109 - |
110 serial@80120000 {
111 compatible = "arm,pl011", "arm,primecell";
112 reg = <0x80120000 0x1000>;
113 interrupts = <0 11 4>;
114 dmas = <&dma 13 0 0x2>, <&dma 13 0 0x0>;
115 dma-names = "rx", "tx";
116 clocks = <&foo_clk>, <&bar_clk>;
117 clock-names = "uartclk", "apb_pclk";
118 };
119
120 ...
Cache object: 7dcdd3f639f73a66fb6ea48aed430f98
|