Documentation/devicetree/bindings/net/stm32-dwmac.txt

   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 and,
  18                                                "syscfg-clk" for SYSCFG clock.
  19 - interrupt-names: Should contain a list of interrupt names corresponding to
  20            the interrupts in the interrupts property, if available.
  21                    Should be "macirq" for the main MAC IRQ
  22                    Should be "eth_wake_irq" for the IT which wake up system
  23 - st,syscon : Should be phandle/offset pair. The phandle to the syscon node which
  24                encompases the glue register, and the offset of the control register.
  25
  26 Optional properties:
  27 - clock-names:     For MPU family "mac-clk-ck" for PHY without quartz
  28 - st,int-phyclk (boolean) :  valid only where PHY do not have quartz and need to be clock
  29                    by RCC
  30
  31 Example:
  32
  33         ethernet@40028000 {
  34                 compatible = "st,stm32-dwmac", "snps,dwmac-3.50a";
  35                 reg = <0x40028000 0x8000>;
  36                 reg-names = "stmmaceth";
  37                 interrupts = <0 61 0>, <0 62 0>;
  38                 interrupt-names = "macirq", "eth_wake_irq";
  39                 clock-names = "stmmaceth", "mac-clk-tx", "mac-clk-rx";
  40                 clocks = <&rcc 0 25>, <&rcc 0 26>, <&rcc 0 27>;
  41                 st,syscon = <&syscfg 0x4>;
  42                 snps,pbl = <8>;
  43                 snps,mixed-burst;
  44                 dma-ranges;
  45         };