net, doc: How to setup MAC address correctly

As this seems unclear, document how the flow of setting up the MAC address is correct. Signed-off-by: Heiko Schocher <hs@denx.de> Text changed slightly, adding input from Mike Frysinger. Signed-off-by: Wolfgang Denk <wd@denx.de>

net, doc: How to setup MAC address correctly
As this seems unclear, document how the flow of setting up the MAC address is correct. Signed-off-by: Heiko Schocher <hs@denx.de> Text changed slightly, adding input from Mike Frysinger. Signed-off-by: Wolfgang Denk <wd@denx.de>
Heiko Schocher · Wolfgang Denk
1 parent b78b48c6a0
Showing 1 changed file with 11 additions and 0 deletions Side-by-side Diff
doc/README.enetaddr
@@ -28,6 +28,17 @@
 	      purpose of passing this information to an OS kernel we are about
 	      to boot
  
+Correct flow of setting up the MAC address (summarized):
+
+1. Read from hardware in initialize() function
+2. Read from environment in net/eth.c after initialize()
+3. Give priority to the value in the environment if a conflict
+4. Program hardware in the device's init() function.
+
+If somebody wants to subvert the design philosophy, this can be done
+in the board-specific board_eth_init() function by calling eth_init()
+after all the NICs have been registered.
+
 -------
  Usage
 -------
...	...	@@ -28,6 +28,17 @@
28	28	purpose of passing this information to an OS kernel we are about
29	29	to boot
30	30
	31	+Correct flow of setting up the MAC address (summarized):
	32	+
	33	+1. Read from hardware in initialize() function
	34	+2. Read from environment in net/eth.c after initialize()
	35	+3. Give priority to the value in the environment if a conflict
	36	+4. Program hardware in the device's init() function.
	37	+
	38	+If somebody wants to subvert the design philosophy, this can be done
	39	+in the board-specific board_eth_init() function by calling eth_init()
	40	+after all the NICs have been registered.
	41	+
31	42	-------
32	43	Usage
33	44	-------