1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
4 $id: http://devicetree.org/schemas/serial/serial.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Serial Interface Generic
10 - Rob Herring <robh@kernel.org>
11 - Greg Kroah-Hartman <gregkh@linuxfoundation.org>
14 This document lists a set of generic properties for describing UARTs in a
15 device tree. Whether these properties apply to a particular device depends
16 on the DT bindings for the actual device.
18 Each enabled UART may have an optional "serialN" alias in the "aliases" node,
19 where N is the port number (non-negative decimal integer) as printed on the
20 label next to the physical port.
24 pattern: "^serial(@.*)?$"
31 Must contain a GPIO specifier, referring to the GPIO pin to be used as
37 Must contain a GPIO specifier, referring to the GPIO pin to be used as
43 Must contain a GPIO specifier, referring to the GPIO pin to be used as
49 Must contain a GPIO specifier, referring to the GPIO pin to be used as
55 Must contain a GPIO specifier, referring to the GPIO pin to be used as
61 Must contain a GPIO specifier, referring to the GPIO pin to be used as
65 $ref: /schemas/types.yaml#/definitions/flag
67 The presence of this property indicates that the UART has dedicated lines
68 for RTS/CTS hardware flow control, and that they are available for use
69 (wired and enabled by pinmux configuration). This depends on both the
70 UART hardware and the board wiring.
74 description: RX and TX pins are swapped.
78 description: CTS and RTS pins are swapped.
81 $ref: /schemas/types.yaml#/definitions/uint32
83 RX FIFO threshold configuration (in bytes).
86 $ref: /schemas/types.yaml#/definitions/uint32
88 TX FIFO threshold configuration (in bytes).
91 "^(bluetooth|bluetooth-gnss|gnss|gps|mcu)$":
96 Serial attached devices shall be a child node of the host UART device
97 the slave device is attached to. It is expected that the attached
98 device is the only child node of the UART device. The slave device node
99 name shall reflect the generic type of device for the node.
104 Compatible of the device connected to the serial port.
107 $ref: /schemas/types.yaml#/definitions/uint32
109 The maximum baud rate the device operates at.
110 This should only be present if the maximum is less than the slave
111 device can support. For example, a particular board has some
112 signal quality issue or the host processor can't support higher
116 $ref: /schemas/types.yaml#/definitions/uint32
118 The current baud rate the device operates at.
119 This should only be present in case a driver has no chance to know
120 the baud rate of the slave device.
122 * device supports auto-baud
123 * the rate is setup by a bootloader and there is no way to reset
125 * device baud rate is configured by its firmware but there is no
126 way to request the actual settings
139 additionalProperties: true
144 compatible = "ns16550a";
149 compatible = "brcm,bcm4330-bt";
150 interrupt-parent = <&gpio>;