About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Documentation / devicetree / bindings / net / stmmac.txt




Custom Search

Based on kernel version 4.8. Page generated on 2016-10-06 23:13 EST.

1	* STMicroelectronics 10/100/1000 Ethernet driver (GMAC)
2	
3	Required properties:
4	- compatible: Should be "snps,dwmac-<ip_version>" "snps,dwmac"
5		For backwards compatibility: "st,spear600-gmac" is also supported.
6	- reg: Address and length of the register set for the device
7	- interrupt-parent: Should be the phandle for the interrupt controller
8	  that services interrupts for this device
9	- interrupts: Should contain the STMMAC interrupts
10	- interrupt-names: Should contain the interrupt names "macirq"
11	  "eth_wake_irq" if this interrupt is supported in the "interrupts"
12	  property
13	- phy-mode: See ethernet.txt file in the same directory.
14	- snps,reset-gpio 	gpio number for phy reset.
15	- snps,reset-active-low boolean flag to indicate if phy reset is active low.
16	- snps,reset-delays-us  is triplet of delays
17		The 1st cell is reset pre-delay in micro seconds.
18		The 2nd cell is reset pulse in micro seconds.
19		The 3rd cell is reset post-delay in micro seconds.
20	
21	Optional properties:
22	- resets: Should contain a phandle to the STMMAC reset signal, if any
23	- reset-names: Should contain the reset signal name "stmmaceth", if a
24		reset phandle is given
25	- max-frame-size: See ethernet.txt file in the same directory
26	- clocks: If present, the first clock should be the GMAC main clock and
27	  the second clock should be peripheral's register interface clock. Further
28	  clocks may be specified in derived bindings.
29	- clock-names: One name for each entry in the clocks property, the
30	  first one should be "stmmaceth" and the second one should be "pclk".
31	- clk_ptp_ref: this is the PTP reference clock; in case of the PTP is
32	  available this clock is used for programming the Timestamp Addend Register.
33	  If not passed then the system clock will be used and this is fine on some
34	  platforms.
35	- tx-fifo-depth: See ethernet.txt file in the same directory
36	- rx-fifo-depth: See ethernet.txt file in the same directory
37	- snps,pbl		Programmable Burst Length
38	- snps,aal		Address-Aligned Beats
39	- snps,fixed-burst	Program the DMA to use the fixed burst mode
40	- snps,mixed-burst	Program the DMA to use the mixed burst mode
41	- snps,force_thresh_dma_mode	Force DMA to use the threshold mode for
42					both tx and rx
43	- snps,force_sf_dma_mode	Force DMA to use the Store and Forward
44					mode for both tx and rx. This flag is
45					ignored if force_thresh_dma_mode is set.
46	- snps,multicast-filter-bins:	Number of multicast filter hash bins
47					supported by this device instance
48	- snps,perfect-filter-entries:	Number of perfect filter entries supported
49					by this device instance
50	- snps,ps-speed: port selection speed that can be passed to the core when
51			 PCS is supported. For example, this is used in case of SGMII
52			 and MAC2MAC connection.
53	- AXI BUS Mode parameters: below the list of all the parameters to program the
54				   AXI register inside the DMA module:
55		- snps,lpi_en: enable Low Power Interface
56		- snps,xit_frm: unlock on WoL
57		- snps,wr_osr_lmt: max write outstanding req. limit
58		- snps,rd_osr_lmt: max read outstanding req. limit
59		- snps,kbbe: do not cross 1KiB boundary.
60		- snps,axi_all: align address
61		- snps,blen: this is a vector of supported burst length.
62		- snps,fb: fixed-burst
63		- snps,mb: mixed-burst
64		- snps,rb: rebuild INCRx Burst
65		- snps,tso: this enables the TSO feature otherwise it will be managed by
66		    MAC HW capability register.
67	- mdio: with compatible = "snps,dwmac-mdio", create and register mdio bus.
68	
69	Examples:
70	
71		stmmac_axi_setup: stmmac-axi-config {
72			snps,wr_osr_lmt = <0xf>;
73			snps,rd_osr_lmt = <0xf>;
74			snps,blen = <256 128 64 32 0 0 0>;
75		};
76	
77		gmac0: ethernet@e0800000 {
78			compatible = "st,spear600-gmac";
79			reg = <0xe0800000 0x8000>;
80			interrupt-parent = <&vic1>;
81			interrupts = <24 23>;
82			interrupt-names = "macirq", "eth_wake_irq";
83			mac-address = [000000000000]; /* Filled in by U-Boot */
84			max-frame-size = <3800>;
85			phy-mode = "gmii";
86			snps,multicast-filter-bins = <256>;
87			snps,perfect-filter-entries = <128>;
88			rx-fifo-depth = <16384>;
89			tx-fifo-depth = <16384>;
90			clocks = <&clock>;
91			clock-names = "stmmaceth";
92			snps,axi-config = <&stmmac_axi_setup>;
93			mdio0 {
94				#address-cells = <1>;
95				#size-cells = <0>;
96				compatible = "snps,dwmac-mdio";
97				phy1: ethernet-phy@0 {
98				};
99			};
100		};
Hide Line Numbers
About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Information is copyright its respective author. All material is available from the Linux Kernel Source distributed under a GPL License. This page is provided as a free service by mjmwired.net.