128 lines · yaml
1# SPDX-License-Identifier: GPL-2.02%YAML 1.23---4$id: http://devicetree.org/schemas/serial/pl011.yaml#5$schema: http://devicetree.org/meta-schemas/core.yaml#6 7title: ARM AMBA Primecell PL011 serial UART8 9maintainers:10 - Rob Herring <robh@kernel.org>11 12allOf:13 - $ref: /schemas/arm/primecell.yaml#14 - $ref: serial.yaml#15 16# Need a custom select here or 'arm,primecell' will match on lots of nodes17select:18 properties:19 compatible:20 contains:21 enum:22 - arm,pl01123 required:24 - compatible25 26properties:27 compatible:28 items:29 - const: arm,pl01130 - const: arm,primecell31 32 reg:33 maxItems: 134 35 interrupts:36 maxItems: 137 38 pinctrl-0: true39 pinctrl-1: true40 41 pinctrl-names:42 description:43 When present, must have one state named "default",44 and may contain a second name named "sleep". The former45 state sets up pins for ordinary operation whereas46 the latter state will put the associated pins to sleep47 when the UART is unused48 minItems: 149 items:50 - const: default51 - const: sleep52 53 clocks:54 description:55 When present, the first clock listed must correspond to56 the clock named UARTCLK on the IP block, i.e. the clock57 to the external serial line, whereas the second clock58 must correspond to the PCLK clocking the internal logic59 of the block. Just listing one clock (the first one) is60 deprecated.61 maxItems: 262 63 clock-names:64 items:65 - const: uartclk66 - const: apb_pclk67 68 dmas:69 minItems: 170 maxItems: 271 72 dma-names:73 minItems: 174 items:75 - const: rx76 - const: tx77 78 auto-poll:79 description:80 Enables polling when using RX DMA.81 type: boolean82 83 poll-rate-ms:84 description:85 Rate at which poll occurs when auto-poll is set.86 default 100ms.87 default: 10088 89 poll-timeout-ms:90 description:91 Poll timeout when auto-poll is set, default92 3000ms.93 default: 300094 95 resets:96 maxItems: 197 98 reg-io-width:99 description:100 The size (in bytes) of the IO accesses that should be performed101 on the device.102 enum: [1, 4]103 104required:105 - compatible106 - reg107 - interrupts108 109dependencies:110 poll-rate-ms: [ auto-poll ]111 poll-timeout-ms: [ auto-poll ]112 113unevaluatedProperties: false114 115examples:116 - |117 serial@80120000 {118 compatible = "arm,pl011", "arm,primecell";119 reg = <0x80120000 0x1000>;120 interrupts = <0 11 4>;121 dmas = <&dma 13 0 0x2>, <&dma 13 0 0x0>;122 dma-names = "rx", "tx";123 clocks = <&foo_clk>, <&bar_clk>;124 clock-names = "uartclk", "apb_pclk";125 };126 127...128