xref: /freebsd/sys/contrib/device-tree/Bindings/net/hisilicon-femac.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel VadotHisilicon Fast Ethernet MAC controller
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotRequired properties:
4*c66ec88fSEmmanuel Vadot- compatible: should contain one of the following version strings:
5*c66ec88fSEmmanuel Vadot	* "hisilicon,hisi-femac-v1"
6*c66ec88fSEmmanuel Vadot	* "hisilicon,hisi-femac-v2"
7*c66ec88fSEmmanuel Vadot	and the soc string "hisilicon,hi3516cv300-femac".
8*c66ec88fSEmmanuel Vadot- reg: specifies base physical address(s) and size of the device registers.
9*c66ec88fSEmmanuel Vadot  The first region is the MAC core register base and size.
10*c66ec88fSEmmanuel Vadot  The second region is the global MAC control register.
11*c66ec88fSEmmanuel Vadot- interrupts: should contain the MAC interrupt.
12*c66ec88fSEmmanuel Vadot- clocks: A phandle to the MAC main clock.
13*c66ec88fSEmmanuel Vadot- resets: should contain the phandle to the MAC reset signal(required) and
14*c66ec88fSEmmanuel Vadot	the PHY reset signal(optional).
15*c66ec88fSEmmanuel Vadot- reset-names: should contain the reset signal name "mac"(required)
16*c66ec88fSEmmanuel Vadot	and "phy"(optional).
17*c66ec88fSEmmanuel Vadot- phy-mode: see ethernet.txt [1].
18*c66ec88fSEmmanuel Vadot- phy-handle: see ethernet.txt [1].
19*c66ec88fSEmmanuel Vadot- hisilicon,phy-reset-delays-us: triplet of delays if PHY reset signal given.
20*c66ec88fSEmmanuel Vadot	The 1st cell is reset pre-delay in micro seconds.
21*c66ec88fSEmmanuel Vadot	The 2nd cell is reset pulse in micro seconds.
22*c66ec88fSEmmanuel Vadot	The 3rd cell is reset post-delay in micro seconds.
23*c66ec88fSEmmanuel Vadot
24*c66ec88fSEmmanuel VadotThe MAC address will be determined using the optional properties
25*c66ec88fSEmmanuel Vadotdefined in ethernet.txt[1].
26*c66ec88fSEmmanuel Vadot
27*c66ec88fSEmmanuel Vadot[1] Documentation/devicetree/bindings/net/ethernet.txt
28*c66ec88fSEmmanuel Vadot
29*c66ec88fSEmmanuel VadotExample:
30*c66ec88fSEmmanuel Vadot	hisi_femac: ethernet@10090000 {
31*c66ec88fSEmmanuel Vadot		compatible = "hisilicon,hi3516cv300-femac","hisilicon,hisi-femac-v2";
32*c66ec88fSEmmanuel Vadot		reg = <0x10090000 0x1000>,<0x10091300 0x200>;
33*c66ec88fSEmmanuel Vadot		interrupts = <12>;
34*c66ec88fSEmmanuel Vadot		clocks = <&crg HI3518EV200_ETH_CLK>;
35*c66ec88fSEmmanuel Vadot		resets = <&crg 0xec 0>,<&crg 0xec 3>;
36*c66ec88fSEmmanuel Vadot		reset-names = "mac","phy";
37*c66ec88fSEmmanuel Vadot		mac-address = [00 00 00 00 00 00];
38*c66ec88fSEmmanuel Vadot		phy-mode = "mii";
39*c66ec88fSEmmanuel Vadot		phy-handle = <&phy0>;
40*c66ec88fSEmmanuel Vadot		hisilicon,phy-reset-delays-us = <10000 20000 20000>;
41*c66ec88fSEmmanuel Vadot	};
42