Merge tag 'acpi-5.1-rc1-2' of git://git.kernel.org/pub/scm/linux/kernel/git/rafael...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / serial / 8250.txt
1 * UART (Universal Asynchronous Receiver/Transmitter)
2
3 Required properties:
4 - compatible : one of:
5         - "ns8250"
6         - "ns16450"
7         - "ns16550a"
8         - "ns16550"
9         - "ns16750"
10         - "ns16850"
11         - For Tegra20, must contain "nvidia,tegra20-uart"
12         - For other Tegra, must contain '"nvidia,<chip>-uart",
13           "nvidia,tegra20-uart"' where <chip> is tegra30, tegra114, tegra124,
14           tegra132, or tegra210.
15         - "nxp,lpc3220-uart"
16         - "ralink,rt2880-uart"
17         - For MediaTek BTIF, must contain '"mediatek,<chip>-btif",
18           "mediatek,mtk-btif"' where <chip> is mt7622, mt7623.
19         - "altr,16550-FIFO32"
20         - "altr,16550-FIFO64"
21         - "altr,16550-FIFO128"
22         - "fsl,16550-FIFO64"
23         - "fsl,ns16550"
24         - "intel,xscale-uart"
25         - "ti,da830-uart"
26         - "aspeed,ast2400-vuart"
27         - "aspeed,ast2500-vuart"
28         - "nuvoton,npcm750-uart"
29         - "serial" if the port type is unknown.
30 - reg : offset and length of the register set for the device.
31 - interrupts : should contain uart interrupt.
32 - clock-frequency : the input clock frequency for the UART
33          or
34   clocks phandle to refer to the clk used as per Documentation/devicetree
35   /bindings/clock/clock-bindings.txt
36
37 Optional properties:
38 - current-speed : the current active speed of the UART.
39 - reg-offset : offset to apply to the mapbase from the start of the registers.
40 - reg-shift : quantity to shift the register offsets by.
41 - reg-io-width : the size (in bytes) of the IO accesses that should be
42   performed on the device.  There are some systems that require 32-bit
43   accesses to the UART (e.g. TI davinci).
44 - used-by-rtas : set to indicate that the port is in use by the OpenFirmware
45   RTAS and should not be registered.
46 - no-loopback-test: set to indicate that the port does not implements loopback
47   test mode
48 - fifo-size: the fifo size of the UART.
49 - auto-flow-control: one way to enable automatic flow control support. The
50   driver is allowed to detect support for the capability even without this
51   property.
52 - tx-threshold: Specify the TX FIFO low water indication for parts with
53   programmable TX FIFO thresholds.
54 - resets : phandle + reset specifier pairs
55 - overrun-throttle-ms : how long to pause uart rx when input overrun is encountered.
56
57 Note:
58 * fsl,ns16550:
59   ------------
60   Freescale DUART is very similar to the PC16552D (and to a
61   pair of NS16550A), albeit with some nonstandard behavior such as
62   erratum A-004737 (relating to incorrect BRK handling).
63
64   Represents a single port that is compatible with the DUART found
65   on many Freescale chips (examples include mpc8349, mpc8548,
66   mpc8641d, p4080 and ls2085a).
67
68 Example:
69
70         uart@80230000 {
71                 compatible = "ns8250";
72                 reg = <0x80230000 0x100>;
73                 clock-frequency = <3686400>;
74                 interrupts = <10>;
75                 reg-shift = <2>;
76         };