@@ -47,8 +47,11 @@ Required properties:
- device_type: Must be "ethernet-phy".
Optional properties:
+- mac-address: See ethernet.txt in the same directory.
- local-mac-address: See ethernet.txt in the same directory.
- max-frame-size: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Example:
@@ -13,6 +13,10 @@ Optional properties:
only if property "phy-reset-gpios" is available. Missing the property
will have the duration be 1 millisecond. Numbers greater than 1000 are
invalid and 1 millisecond will be used instead.
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Clock handling:
The clock frequency is needed to calculate and set polling period of EMAC.
@@ -18,6 +18,9 @@ Required properties:
Optional properties:
- mac-address: See ethernet.txt file in the same directory
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Examples:
@@ -30,6 +30,11 @@ Optional properties:
See Documentation/devicetree/bindings/net/fixed-link.txt for information on
the property specifics
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
+
Required child nodes:
- mdio bus node: this node should always be present regardless of the PHY
@@ -20,6 +20,10 @@ Optional properties:
- systemport,num-tier1-arb: number of tier 1 arbiters, an integer
- systemport,num-txq: number of HW transmit queues, an integer
- systemport,num-rxq: number of HW receive queues, an integer
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Example:
ethernet@f04a0000 {
@@ -18,7 +18,12 @@ Properties:
- interrupts: Two interrupt specifiers. The first is the MIX
interrupt routing and the second the routing for the AGL interrupts.
-- phy-handle: Optional, see ethernet.txt file in the same directory.
+Optional properties:
+- phy-handle: See ethernet.txt file in the same directory.
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Example:
ethernet@1070000100800 {
@@ -43,6 +43,11 @@ Properties for PIP port which is a child the PIP interface:
- tx-delay: Delay value for RGMII transmit clock. Optional. Disabled if 0.
Value range is 1-31, and mapping to the actual delay varies depending on HW.
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
+
Example:
pip@11800a0000000 {
@@ -50,6 +50,9 @@ Required properties:
Optional properties:
- dual_emac_res_vlan : Specifies VID to be used to segregate the ports
- mac-address : See ethernet.txt file in the same directory
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
- phy_id : Specifies slave phy id (deprecated, use phy-handle)
- phy-handle : See ethernet.txt file in the same directory
@@ -12,6 +12,10 @@ Optional properties:
- davicom,ext-phy : Use external PHY
- reset-gpios : phandle of gpio that will be used to reset chip during probe
- vcc-supply : phandle of regulator that will be used to enable power to chip
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Example:
@@ -20,6 +20,8 @@ Required properties:
Optional properties:
- phy-handle: See ethernet.txt file in the same directory.
If absent, davinci_emac driver defaults to 100/FULL.
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
- nvmem-cells: phandle, reference to an nvmem node for the MAC address
- nvmem-cell-names: string, should be "mac-address" if nvmem is to be used
- ti,davinci-rmii-en: 1 byte, 1 means use RMII
@@ -71,9 +71,10 @@ properties, described in binding documents:
Documentation/devicetree/bindings/net/fixed-link.txt
for details.
-- local-mac-address : See
- Documentation/devicetree/bindings/net/ethernet.txt
- for details.
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Example
@@ -14,6 +14,10 @@ Required properties:
Optional properties:
- phy-supply: phandle to a regulator if the PHY needs one
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Clock handling:
- clocks: Must contain an entry for each entry in clock-names.
@@ -10,6 +10,8 @@ Documentation/devicetree/bindings/phy/phy-bindings.txt.
the boot program; should be used in cases where the MAC address assigned to
the device by the boot program is different from the "local-mac-address"
property;
+- nvmem-cells: phandle, reference to an nvmem node for the MAC address
+- nvmem-cell-names: string, should be "mac-address" if nvmem is to be used
- max-speed: number, specifies maximum speed in Mbit/s supported by the device;
- max-frame-size: number, maximum transfer unit (IEEE defined MTU), rather than
the maximum frame size (there's contradiction in the Devicetree
@@ -5,6 +5,12 @@ Required properties:
- reg: Address and length of the register set for the device
- interrupts: Should contain the ENET interrupt
+Optional properties:
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
+
Examples:
ethernet@f0003000 {
@@ -46,6 +46,10 @@ Optional properties:
tx/rx queues 1 and 2. "int0" will be used for queue 0 and ENET_MII interrupts.
For imx6sx, "int0" handles all 3 queues and ENET_MII. "pps" is for the pulse
per second interrupt associated with 1588 precision time protocol(PTP).
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Optional subnodes:
@@ -71,6 +71,10 @@ Properties:
in the L2.
- rx-stash-idx : Denotes the index of the first byte from the received
buffer to stash in the L2.
+ - mac-address: See ethernet.txt in the same directory.
+ - local-mac-address: See ethernet.txt in the same directory.
+ - nvmem-cells: See ethernet.txt in the same directory.
+ - nvmem-cell-names: See ethernet.txt in the same directory.
Example:
ethernet@24000 {
@@ -15,6 +15,9 @@ Required properties:
- reset-names: should contain the reset signal name "mac"(required)
and "phy"(optional).
- mac-address: see ethernet.txt [1].
+- local-mac-address: see ethernet.txt [1].
+- nvmem-cells: see ethernet.txt [1].
+- nvmem-cell-names: see ethernet.txt [1].
- phy-mode: see ethernet.txt [1].
- phy-handle: see ethernet.txt [1].
- hisilicon,phy-reset-delays-us: triplet of delays if PHY reset signal given.
@@ -19,6 +19,9 @@ Required properties:
- phy-mode: see ethernet.txt [1].
- phy-handle: see ethernet.txt [1].
- mac-address: see ethernet.txt [1].
+- local-mac-address: see ethernet.txt [1].
+- nvmem-cells: see ethernet.txt [1].
+- nvmem-cell-names: see ethernet.txt [1].
- clocks: clock phandle and specifier pair.
- clock-names: contain the clock name "mac_core"(required) and "mac_ifc"(optional).
- resets: should contain the phandle to the MAC core reset signal(optional),
@@ -137,9 +137,12 @@ Optional properties:
when it obtains the mac address from efuse.
- local-mac-address: the driver is designed to use the of_get_mac_address api
only if efuse-mac is 0. When efuse-mac is 0, the MAC
- address is obtained from local-mac-address. If this
- attribute is not present, then the driver will use a
- random MAC address.
+ address is obtained from nvmem-cells, mac-address and
+ local-mac-address. If any of this attributes is not present,
+ then the driver will use a random MAC address.
+- mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
- "netcp-device label": phandle to the device specification for each of NetCP
sub-module attached to this interface.
@@ -26,15 +26,15 @@ Required properties:
Optional elements: 'tsu_clk'
- clocks: Phandles to input clocks.
-Optional properties:
-- nvmem-cells: phandle, reference to an nvmem node for the MAC address
-- nvmem-cell-names: string, should be "mac-address" if nvmem is to be used
-
Optional properties for PHY child node:
- reset-gpios : Should specify the gpio for phy reset
- magic-packet : If present, indicates that the hardware supports waking
up via magic packet.
- phy-handle : see ethernet.txt file in the same directory
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Examples:
@@ -37,6 +37,9 @@ Required port properties:
- reg: port number relative to ethernet controller, shall be 0, 1, or 2.
- interrupts: port interrupt.
- local-mac-address: See ethernet.txt file in the same directory.
+ - mac-address: See ethernet.txt in the same directory.
+ - nvmem-cells: See ethernet.txt in the same directory.
+ - nvmem-cell-names: See ethernet.txt in the same directory.
Optional port properties:
- marvell,tx-queue-size: size of the transmit ring buffer.
@@ -12,6 +12,9 @@ Optional properties:
- #size-cells: must be 0 when using sub-nodes.
- phy-handle: see ethernet.txt file in the same directory.
- local-mac-address: see ethernet.txt file in the same directory.
+- mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Sub-nodes:
Each PHY can be represented as a sub-node. This is not mandatory.
@@ -22,6 +22,9 @@ Optional properties:
According to the ENC28J80 datasheet, the chip allows a maximum of 20 MHz, however,
board designs may need to limit this value.
- local-mac-address: See ethernet.txt in the same directory.
+- mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Example (for NXP i.MX28 with pin control stuff for GPIO irq):
@@ -10,6 +10,8 @@ Required properties:
Optional properties:
- local-mac-address: see ethernet.txt
- mac-address: see ethernet.txt
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Optional properties of the embedded PHY:
- microchip,led-modes: a 0..4 element vector, with each element configuring
@@ -10,6 +10,10 @@ Required properties:
Optional properties:
- clocks: phandle to refer to the clk used as per
Documentation/devicetree/bindings/clock/clock-bindings.txt
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
Examples:
@@ -17,6 +17,12 @@ Required properties on all platforms:
- oxsemi,sys-ctrl: a phandle to the system controller syscon node
+Optional properties:
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
+
Example :
etha: ethernet@40400000 {
@@ -24,6 +24,9 @@ Optional properties:
are invalid. Missing the property will set the SPI
frequency to 8000000 Hertz.
- local-mac-address : see ./ethernet.txt
+- mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
- qca,legacy-mode : Set the SPI data transfer of the QCA7000 to legacy mode.
In this mode the SPI master must toggle the chip select
between each data word. In burst mode these gaps aren't
@@ -22,6 +22,9 @@ Required properties:
Optional properties:
- mac-address: 6 bytes, mac address
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
- max-frame-size: Maximum Transfer Unit (IEEE defined MTU), rather
than the maximum frame size.
@@ -105,6 +105,8 @@ Optional properties:
- dma-coherent: Present if dma operations are coherent
- mac-address: See ethernet.txt in the same directory
- local-mac-address: See ethernet.txt in the same directory
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
- phy-reset-gpios: Phandle and specifier for any GPIO used to reset the PHY.
See ../gpio/gpio.txt.
- snps,en-lpi: If present it enables use of the AXI low-power interface
@@ -19,6 +19,10 @@ altr,emac-splitter: Should be the phandle to the emac splitter soft IP node if
DWMAC controller is connected emac splitter.
phy-mode: The phy mode the ethernet operates in
altr,sgmii-to-sgmii-converter: phandle to the TSE SGMII converter
+mac-address: See ethernet.txt in the same directory.
+local-mac-address: See ethernet.txt in the same directory.
+nvmem-cells: See ethernet.txt in the same directory.
+nvmem-cell-names: See ethernet.txt in the same directory.
This device node has additional phandle dependency, the sgmii converter:
@@ -33,6 +33,9 @@ Required properties:
Optional properties:
- local-mac-address: See ethernet.txt in the same directory.
+ - mac-address: See ethernet.txt in the same directory.
+ - nvmem-cells: See ethernet.txt in the same directory.
+ - nvmem-cell-names: See ethernet.txt in the same directory.
Required subnode:
- mdio: A container for child nodes representing phy nodes.
@@ -28,6 +28,8 @@ Optional properties: (See ethernet.txt file in the same directory)
accesses performed by the device are cache coherent.
- local-mac-address: See ethernet.txt in the same directory.
- mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
- max-speed: See ethernet.txt in the same directory.
- max-frame-size: See ethernet.txt in the same directory.
@@ -21,6 +21,10 @@ Required properties:
The 3rd cell is reset post-delay in micro seconds.
Optional properties:
+- mac-address: See ethernet.txt in the same directory.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
- resets: Should contain a phandle to the STMMAC reset signal, if any
- reset-names: Should contain the reset signal name "stmmaceth", if a
reset phandle is given
@@ -15,6 +15,8 @@ Optional properties:
- mac-address: See ethernet.txt in the parent directory
- local-mac-address: See ethernet.txt in the parent directory
+- nvmem-cells: See ethernet.txt in the parent directory.
+- nvmem-cell-names: See ethernet.txt in the parent directory.
- ieee80211-freq-limit: See ieee80211.txt
- mediatek,mtd-eeprom: Specify a MTD partition + offset containing EEPROM data
@@ -36,6 +36,8 @@ Optional properties:
kernel firmware loader).
- mac-address: See ethernet.txt in the parent directory
- local-mac-address: See ethernet.txt in the parent directory
+- nvmem-cells: See ethernet.txt in the parent directory.
+- nvmem-cell-names: See ethernet.txt in the parent directory.
In this example, the node is defined as child node of the PCI controller:
@@ -43,6 +43,9 @@ to check for the new properties first.
Required properties for network device_type:
- mac-address : list of bytes representing the ethernet address.
+- local-mac-address: See ethernet.txt in the same directory.
+- nvmem-cells: See ethernet.txt in the same directory.
+- nvmem-cell-names: See ethernet.txt in the same directory.
- phy-handle : The phandle for the PHY connected to this controller.
Recommended properties:
As of_get_mac_address now supports NVMEM under the hood, we should update the bindings documentation with the new nvmem-cell* properties. While at it, fix also other missing properties supported by of_get_mac_address. Signed-off-by: Petr Štetiar <ynezz@true.cz> --- Documentation/devicetree/bindings/net/altera_tse.txt | 3 +++ Documentation/devicetree/bindings/net/arc_emac.txt | 4 ++++ Documentation/devicetree/bindings/net/brcm,amac.txt | 3 +++ Documentation/devicetree/bindings/net/brcm,bcmgenet.txt | 5 +++++ Documentation/devicetree/bindings/net/brcm,systemport.txt | 4 ++++ Documentation/devicetree/bindings/net/cavium-mix.txt | 7 ++++++- Documentation/devicetree/bindings/net/cavium-pip.txt | 5 +++++ Documentation/devicetree/bindings/net/cpsw.txt | 3 +++ Documentation/devicetree/bindings/net/davicom-dm9000.txt | 4 ++++ Documentation/devicetree/bindings/net/davinci_emac.txt | 2 ++ Documentation/devicetree/bindings/net/dsa/dsa.txt | 7 ++++--- Documentation/devicetree/bindings/net/emac_rockchip.txt | 4 ++++ Documentation/devicetree/bindings/net/ethernet.txt | 2 ++ Documentation/devicetree/bindings/net/ezchip_enet.txt | 6 ++++++ Documentation/devicetree/bindings/net/fsl-fec.txt | 4 ++++ Documentation/devicetree/bindings/net/fsl-tsec-phy.txt | 4 ++++ Documentation/devicetree/bindings/net/hisilicon-femac.txt | 3 +++ Documentation/devicetree/bindings/net/hisilicon-hix5hd2-gmac.txt | 3 +++ Documentation/devicetree/bindings/net/keystone-netcp.txt | 9 ++++++--- Documentation/devicetree/bindings/net/macb.txt | 8 ++++---- Documentation/devicetree/bindings/net/marvell-orion-net.txt | 3 +++ Documentation/devicetree/bindings/net/marvell-pxa168.txt | 3 +++ Documentation/devicetree/bindings/net/microchip,enc28j60.txt | 3 +++ Documentation/devicetree/bindings/net/microchip,lan78xx.txt | 2 ++ Documentation/devicetree/bindings/net/opencores-ethoc.txt | 4 ++++ Documentation/devicetree/bindings/net/oxnas-dwmac.txt | 6 ++++++ Documentation/devicetree/bindings/net/qca,qca7000.txt | 3 +++ Documentation/devicetree/bindings/net/samsung-sxgbe.txt | 3 +++ Documentation/devicetree/bindings/net/snps,dwc-qos-ethernet.txt | 2 ++ Documentation/devicetree/bindings/net/socfpga-dwmac.txt | 4 ++++ .../devicetree/bindings/net/socionext,uniphier-ave4.txt | 3 +++ Documentation/devicetree/bindings/net/socionext-netsec.txt | 2 ++ Documentation/devicetree/bindings/net/stmmac.txt | 4 ++++ Documentation/devicetree/bindings/net/wireless/mediatek,mt76.txt | 2 ++ Documentation/devicetree/bindings/net/wireless/qca,ath9k.txt | 2 ++ Documentation/devicetree/bindings/soc/fsl/cpm_qe/qe/ucc.txt | 3 +++ 36 files changed, 128 insertions(+), 11 deletions(-)