summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCarlo Caione <[email protected]>2026-08-08 15:39:58 +0200
committerMarek Vasut <[email protected]>2026-08-09 13:26:42 +0200
commit948c428ff7ea594bb6c90ccd7cfb4a9053339465 (patch)
tree9460387a99f2617c9ea11ff3acdd94276b22a5c1
parentd0615e4a67c8958fad4a8c39262074958f04c179 (diff)
doc: usb: remove obsolete MediaTek MTU3 bindings
The MediaTek MTU3 and xHCI text bindings describe legacy U-Boot layouts which have been superseded by the canonical Linux schemas. Those schemas are already synchronized into `dts/upstream/Bindings/usb`. Remove the duplicate text bindings so new devicetrees and driver changes use the maintained YAML definitions. Reviewed-by: Marek Vasut <[email protected]> Signed-off-by: Carlo Caione <[email protected]>
-rw-r--r--doc/device-tree-bindings/usb/mediatek,mtk-xhci.txt46
-rw-r--r--doc/device-tree-bindings/usb/mediatek,mtu3.txt79
2 files changed, 0 insertions, 125 deletions
diff --git a/doc/device-tree-bindings/usb/mediatek,mtk-xhci.txt b/doc/device-tree-bindings/usb/mediatek,mtk-xhci.txt
deleted file mode 100644
index e26e9618eb9..00000000000
--- a/doc/device-tree-bindings/usb/mediatek,mtk-xhci.txt
+++ /dev/null
@@ -1,46 +0,0 @@
-MediaTek xHCI
-
-The device node for USB3 host controller on MediaTek SoCs.
-
-Required properties:
- - compatible : should be one of
- "mediatek,mtk-xhci"
- "mediatek,mt8195-xhci"
- - reg : specifies physical base address and size of the registers
- - reg-names: should be "mac" for xHCI MAC and "ippc" for IP port control
- - power-domains : a phandle to USB power domain node to control USB's
- MTCMOS
- - vusb33-supply : regulator of USB avdd3.3v
-
- - clocks : a list of phandle + clock-specifier pairs, one for each
- entry in clock-names
- - clock-names : must contain
- "sys_ck": controller clock used by normal mode,
- the following ones are optional:
- "ref_ck": reference clock used by low power mode etc,
- "mcu_ck": mcu_bus clock for register access,
- "dma_ck": dma_bus clock for data transfer by DMA,
- "xhci_ck": controller clock
-
- - phys : list of all the USB PHYs on this HCD
- - phy-names: name specifier for the USB PHY
-
-Optional properties:
- - vbus-supply : reference to the VBUS regulator;
- - mediatek,u3p-dis-msk : mask to disable u3ports, bit0 for u3port0,
- bit1 for u3port1, ... etc;
- - mediatek,u2p-dis-msk : mask to disable u2ports, bit0 for u2port0,
- bit1 for u2port1, ... etc;
-
-Example:
-xhci: usb@1a0c0000 {
- compatible = "mediatek,mt7629-xhci", "mediatek,mtk-xhci";
- reg = <0x1a0c0000 0x1000>, <0x1a0c3e00 0x0100>;
- reg-names = "mac", "ippc";
- power-domains = <&scpsys MT7629_POWER_DOMAIN_HIF1>;
- clocks = <&ssusbsys CLK_SSUSB_SYS_EN>, <&ssusbsys CLK_SSUSB_REF_EN>,
- <&ssusbsys CLK_SSUSB_MCU_EN>, <&ssusbsys CLK_SSUSB_DMA_EN>;
- clock-names = "sys_ck", "ref_ck", "mcu_ck", "dma_ck";
- phys = <&u2port0 PHY_TYPE_USB2>, <&u3port0 PHY_TYPE_USB3>;
- status = "disabled";
-};
diff --git a/doc/device-tree-bindings/usb/mediatek,mtu3.txt b/doc/device-tree-bindings/usb/mediatek,mtu3.txt
deleted file mode 100644
index ab877bfa89f..00000000000
--- a/doc/device-tree-bindings/usb/mediatek,mtu3.txt
+++ /dev/null
@@ -1,79 +0,0 @@
-The device node for Mediatek USB3 DRD controller
-
-Required properties:
- - compatible : should be "mediatek,<soc-model>-mtu3", "mediatek,mtu3",
- soc-model is the name of SoC, such as mt8512 etc,
- when using "mediatek,mtu3" compatible string, you need SoC specific
- ones in addition, one of:
- - "mediatek,mt8512-mtu3"
- - reg : specifies physical base address and size of the registers
- - reg-names: should be
- - "ippc" : IP Port Control
- - power-domains : a phandle to USB power domain node to control USB's MTCMOS
- - clocks : a list of phandle + clock-specifier pairs, one for each
- entry in clock-names
- - clock-names : must contain "sys_ck" for clock of controller,
- the following clocks are optional:
- "ref_ck", "mcu_ck", "dma_ck" and "xhci_ck";
- - phys : list of all the USB PHYs on this HCD
- - #address-cells, #size-cells : used for sub-nodes with 'reg' property
- - ranges : allows valid 1:1 translation between child's address space and
- parent's address space
-
-Optional properties:
- - vusb33-supply : regulator of USB AVDD3.3v
- - vbus-supply : regulator of VBUS 5v, needed when supports host mode.
-
-Sub-nodes:
-Required properties:
- - compatible : should be "mediatek,ssusb"
- - reg : specifies physical base address and size of the registers
- - reg-names: should be
- - "mac" : SSUSB MAC, include xHCI and device
- - interrupts : interrupt used by xHCI or device
- - dr_mode : should be one of "host" or "peripheral",
- see : usb/generic.txt
-
-Optional properties:
- - pinctrl-names : a pinctrl state named "default" is optional
- - pinctrl-0 : pin control group
- See: pinctrl/pinctrl-bindings.txt
-
- - device mode:
- - maximum-speed : valid arguments are "full-speed", "high-speed",
- "super-speed" and "super-speed-plus",
- see: usb/generic.txt
- - mediatek,force-vbus : force vbus as valid by SW
-
- - host mode (dr_mode is "host"):
- - mediatek,u3p-dis-msk : mask to disable u3ports, bit0 for u3port0,
- bit1 for u3port1, ... etc;
-
-Example:
-usb3: usb@11213e00 {
- compatible = "mediatek,mt8512-mtu3", "mediatek,mtu3";
- reg = <0x11213e00 0x0100>;
- reg-names = "ippc";
- phys = <&u2port0 PHY_TYPE_USB2>, <&u2port1 PHY_TYPE_USB2>;
- power-domains = <&scpsys MT8512_POWER_DOMAIN_USB>;
- clocks = <&infracfg CLK_INFRA_USB_SYS>,
- <&topckgen CLK_TOP_SSUSB_TOP_CK_EN>,
- <&infracfg CLK_INFRA_ICUSB>;
- clock-names = "sys_ck", "ref_ck", "mcu_ck";
- vusb33-supply = <reg_3p3v>;
- vbus-supply = <&usb_p0_vbus>;
- #address-cells = <1>;
- #size-cells = <1>;
- ranges;
- status = "disabled";
-
- ssusb: usb@11210000 {
- compatible = "mediatek,ssusb";
- reg = <0x11210000 0x3e00>;
- interrupts = <GIC_SPI 16 IRQ_TYPE_LEVEL_LOW>;
- reg-names = "mac";
- dr_mode = "peripheral";
- maximum-speed = "high-speed";
- status = "disabled";
- };
-};