| b.liu | e958203 | 2025-04-17 19:18:16 +0800 | [diff] [blame] | 1 | STMicroelectronics STM32 / MCU DWMAC glue layer controller |
| 2 | |
| 3 | This file documents platform glue layer for stmmac. |
| 4 | Please see stmmac.txt for the other unchanged properties. |
| 5 | |
| 6 | The device node has following properties. |
| 7 | |
| 8 | Required properties: |
| 9 | - compatible: For MCU family should be "st,stm32-dwmac" to select glue, and |
| 10 | "snps,dwmac-3.50a" to select IP version. |
| 11 | For MPU family should be "st,stm32mp1-dwmac" to select |
| 12 | glue, and "snps,dwmac-4.20a" to select IP version. |
| 13 | - clocks: Must contain a phandle for each entry in clock-names. |
| 14 | - clock-names: Should be "stmmaceth" for the host clock. |
| 15 | Should be "mac-clk-tx" for the MAC TX clock. |
| 16 | Should be "mac-clk-rx" for the MAC RX clock. |
| 17 | For MPU family need to add also "ethstp" for power mode clock |
| 18 | - interrupt-names: Should contain a list of interrupt names corresponding to |
| 19 | the interrupts in the interrupts property, if available. |
| 20 | Should be "macirq" for the main MAC IRQ |
| 21 | Should be "eth_wake_irq" for the IT which wake up system |
| 22 | - st,syscon : Should be phandle/offset pair. The phandle to the syscon node which |
| 23 | encompases the glue register, and the offset of the control register. |
| 24 | |
| 25 | Optional properties: |
| 26 | - clock-names: For MPU family "eth-ck" for PHY without quartz |
| 27 | - st,eth-clk-sel (boolean) : set this property in RGMII PHY when you want to select RCC clock instead of ETH_CLK125. |
| 28 | - st,eth-ref-clk-sel (boolean) : set this property in RMII mode when you have PHY without crystal 50MHz and want to select RCC clock instead of ETH_REF_CLK. |
| 29 | |
| 30 | Example: |
| 31 | |
| 32 | ethernet@40028000 { |
| 33 | compatible = "st,stm32-dwmac", "snps,dwmac-3.50a"; |
| 34 | reg = <0x40028000 0x8000>; |
| 35 | reg-names = "stmmaceth"; |
| 36 | interrupts = <0 61 0>, <0 62 0>; |
| 37 | interrupt-names = "macirq", "eth_wake_irq"; |
| 38 | clock-names = "stmmaceth", "mac-clk-tx", "mac-clk-rx"; |
| 39 | clocks = <&rcc 0 25>, <&rcc 0 26>, <&rcc 0 27>; |
| 40 | st,syscon = <&syscfg 0x4>; |
| 41 | snps,pbl = <8>; |
| 42 | snps,mixed-burst; |
| 43 | dma-ranges; |
| 44 | }; |