Re: [PATCH v3] DT: net: document Ethernet bindings in one place
From: Geert Uytterhoeven <geert@linux-m68k.org>
Date: 2014-01-28 08:26:58
On Tue, Jan 28, 2014 at 1:16 AM, Sergei Shtylyov [off-list ref] wrote:
quoted hunk ↗ jump to hunk
--- /dev/null +++ net-next/Documentation/devicetree/bindings/net/ethernet.txt@@ -0,0 +1,23 @@ +The following properties are common to the Ethernet controllers: + +- local-mac-address: array of 6 bytes, specifies the MAC address that was + assigned to the network device; +- mac-address: array of 6 bytes, specifies the MAC address that was last used by + 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; +- 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 ePAPR). +- phy-mode: string, operation mode of the PHY interface; supported values are + "mii", "gmii", "sgmii", "tbi", "rev-mii", "rmii", "rgmii", "rgmii-id", + "rgmii-rxid", "rgmii-txid", "rtbi", "smii", "xgmii"; not recommended for new + bindings; +- phy-connection-type: the same as "phy-mode" property but described in ePAPR; +- phy-handle: phandle, specifies a reference to a node representing a PHY + device; this property is described in ePAPR and so preferred; +- phy: the same as "phy-handle" property, not recommended for new bindings.
I think it would be more clear to move the not recommended ones to a new
paragraph, with a preamble stating they're not recommended for new bindings.
Gr{oetje,eeting}s,
Geert
--
Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- geert@linux-m68k.org
In personal conversations with technical people, I call myself a hacker. But
when I'm talking to journalists I just say "programmer" or something like that.
-- Linus Torvalds