tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1STMicroelectronics STM32 / MCU DWMAC glue layer controller
2
3This file documents platform glue layer for stmmac.
4Please see stmmac.txt for the other unchanged properties.
5
6The device node has following properties.
7
8Required 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
25Optional 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
30Example:
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 };