xref: /freebsd/sys/contrib/device-tree/Bindings/serial/mtk-uart.txt (revision cfd6422a5217410fbd66f7a7a8a64d9d85e61229)
1* MediaTek Universal Asynchronous Receiver/Transmitter (UART)
2
3Required properties:
4- compatible should contain:
5  * "mediatek,mt2701-uart" for MT2701 compatible UARTS
6  * "mediatek,mt2712-uart" for MT2712 compatible UARTS
7  * "mediatek,mt6580-uart" for MT6580 compatible UARTS
8  * "mediatek,mt6582-uart" for MT6582 compatible UARTS
9  * "mediatek,mt6589-uart" for MT6589 compatible UARTS
10  * "mediatek,mt6755-uart" for MT6755 compatible UARTS
11  * "mediatek,mt6765-uart" for MT6765 compatible UARTS
12  * "mediatek,mt6779-uart" for MT6779 compatible UARTS
13  * "mediatek,mt6795-uart" for MT6795 compatible UARTS
14  * "mediatek,mt6797-uart" for MT6797 compatible UARTS
15  * "mediatek,mt7622-uart" for MT7622 compatible UARTS
16  * "mediatek,mt7623-uart" for MT7623 compatible UARTS
17  * "mediatek,mt7629-uart" for MT7629 compatible UARTS
18  * "mediatek,mt8127-uart" for MT8127 compatible UARTS
19  * "mediatek,mt8135-uart" for MT8135 compatible UARTS
20  * "mediatek,mt8173-uart" for MT8173 compatible UARTS
21  * "mediatek,mt8183-uart", "mediatek,mt6577-uart" for MT8183 compatible UARTS
22  * "mediatek,mt8516-uart" for MT8516 compatible UARTS
23  * "mediatek,mt6577-uart" for MT6577 and all of the above
24
25- reg: The base address of the UART register bank.
26
27- interrupts:
28  index 0: an interrupt specifier for the UART controller itself
29  index 1: optional, an interrupt specifier with edge sensitivity on Rx pin to
30           support Rx in-band wake up. If one would like to use this feature,
31           one must create an addtional pinctrl to reconfigure Rx pin to normal
32           GPIO before suspend.
33
34- clocks : Must contain an entry for each entry in clock-names.
35  See ../clocks/clock-bindings.txt for details.
36- clock-names:
37  - "baud": The clock the baudrate is derived from
38  - "bus": The bus clock for register accesses (optional)
39
40For compatibility with older device trees an unnamed clock is used for the
41baud clock if the baudclk does not exist. Do not use this for new designs.
42
43Example:
44
45	uart0: serial@11006000 {
46		compatible = "mediatek,mt6589-uart", "mediatek,mt6577-uart";
47		reg = <0x11006000 0x400>;
48		interrupts = <GIC_SPI 51 IRQ_TYPE_LEVEL_LOW>,
49			     <GIC_SPI 52 IRQ_TYPE_EDGE_FALLING>;
50		clocks = <&uart_clk>, <&bus_clk>;
51		clock-names = "baud", "bus";
52		pinctrl-names = "default", "sleep";
53		pinctrl-0 = <&uart_pin>;
54		pinctrl-1 = <&uart_pin_sleep>;
55	};
56