Documentation/devicetree/bindings/serial/pl011.yaml

   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 required:
  95   - compatible
  96   - reg
  97   - interrupts
  98
  99 dependencies:
 100   poll-rate-ms: [ auto-poll ]
 101   poll-timeout-ms: [ auto-poll ]
 102
 103 unevaluatedProperties: false
 104
 105 examples:
 106   - |
 107     serial@80120000 {
 108       compatible = "arm,pl011", "arm,primecell";
 109       reg = <0x80120000 0x1000>;
 110       interrupts = <0 11 4>;
 111       dmas = <&dma 13 0 0x2>, <&dma 13 0 0x0>;
 112       dma-names = "rx", "tx";
 113       clocks = <&foo_clk>, <&bar_clk>;
 114       clock-names = "uartclk", "apb_pclk";
 115     };
 116
 117 ...