* EMAC device-tree binding (#2)
@ 2007-01-30 0:58 Benjamin Herrenschmidt
2007-02-02 1:12 ` David Gibson
` (2 more replies)
0 siblings, 3 replies; 6+ messages in thread
From: Benjamin Herrenschmidt @ 2007-01-30 0:58 UTC (permalink / raw)
To: linuxppc-dev list
According to the various comments I got, here's the latest binding for
EMAC:
* The OPB node needs a "clock-frequency" property
* In the EMAC node itself (plb5/plb4/opb/ethernet)
- name : "ethernet"
- device_type : "network"
- compatible : compatible list, contains 2 entries, first is "ibm,emac-CHIP" where
CHIP is the host ASIC (440gx, 405gp, axon) and second is either
"ibm,emac" or "ibm,emac4".
For axon, thus, we have: "ibm,emac-axon","ibm,emac4"
- model : optional model string
- interrupts : <interrupt mapping for EMAC IRQ and WOL IRQ>
- interrupt-parent : optional, if needed for interrupt mapping
- reg : <registers mapping>
- local-mac-address : 6 bytes, MAC address
- mal-device : 1 cell, phandle of the associated McMAL node
- mal-tx-channel : 1 cell, index of the tx channel on McMAL associated with this EMAC
- mal-rx-channel : 1 cell, index of the rx channel on McMAL associated with this EMAC
- cell-index : 1 cell, hardware index of the EMAC cell on a given ASIC (typically
0x00000000 and 0x00000001 for EMAC-0 and EMAC-1 on each Axon chip)
- max-frame-size : 1 cell, maximum frame size supported in bytes
- rx-fifo-size : 1 cell, Rx fifo size in bytes for 10 and 100 Mb/sec operations.
For axon, 2048
- rx-fifo-size-gige : 1 cell, optional, Rx fifo size in bytes for 1000 Mb/sec operations
(if absent the value is the same as rx-fifo-size).
For axon, either absent or 2048.
- tx-fifo-size : 1 cell, Tx fifo size in bytes for 10 and 100 Mb/sec operations. For axon
- tx-fifo-size-gige : 1 cell, optional, Tx fifo size in bytes for 1000 Mb/sec operations
(if absent the value is the same as tx-fifo-size)
For axon, either absent or 2048.
- fifo-entry-size : 1 cell, size of a fifo entry (used to calculate thresholds)
For axon, 0x00000010
- mal-burst-size : 1 cell, MAL burst size (used to calculate thresholds) in bytes
For axon, 0x00000100 (I think ...)
- phy-mode : 1 cell, Mode of operations of the PHY interface:
#define PHY_MODE_NA 0
#define PHY_MODE_MII 1
#define PHY_MODE_RMII 2
#define PHY_MODE_SMII 3
#define PHY_MODE_RGMII 4
#define PHY_MODE_TBI 5
#define PHY_MODE_GMII 6
#define PHY_MODE_RTBI 7
#define PHY_MODE_SGMII 8
For axon, it is PHY_MODE_RGMII
- phy-address : 1 cell, optional, MDIO address of the PHY. If absent, a search
is performed
For axon: please fill with approriate value, I don't have it at
hand, it depends on the board and the EMAC of course.
- phy-map : 1 cell, optional, bitmap of addresses to probe the PHY for, used
if phy-address is absent. bit 0x00000001 is MDIO address 0. For axon
it can be absent, thouugh my current driver doesn't handle phy-address
yet so for now, keep 0x00ffffff in it.
- mdio-device : 1 cell, optional. If shared MDIO registers (440EP), phandle of the EMAC
to use to drive the MDIO lines for the PHY used by this EMAC.
For axon: absent
- zmii-device : 1 cell, optional. If connected to a ZMII, phandle of the ZMII device node
For axon: absent
- zmii-channel : 1 cell, optional. If connected to a ZMII, which channel or 0xffffffff if
ZMII is only used for MDIO
- rgmii-device : 1 cell, optional. If connected to a RGMII, phandle of the RGMII device node
For axon: phandle of plb5/plb4/opb/rgmii
- rgmii-channel : 1 cell, optional. If connected to a RGMII, which channel
Fox axon: present, whatever value is appropriate for each EMAC, that is
the content of the current (bogus) "phy-port" property
- tah-device : 1 cell, optional. If connected to a TAH engine for offload, phandle of
the TAH device node
- tah-channel : 1 cell, optional. If appropriate, channel used on the TAH engine
* In the McMAL node
- name : "mcmal"
- device_type : "mcmal-dma"
- compatible : compatible list, containing 2 entries, first is "ibm,mcmal-CHIP" where
CHIP is the hose ASIC (like emac) and the second is either "ibm,mcmal"
or "ibm,mcmal2".
: For axon, "ibm,mcmal-axon","ibm,mcmal2"
- model : optional model string
- interrupts : <interrupt mapping for the MAL interrupts sources:
5 sources: tx_eob, rx_eob, serr, txde, rxde>.
For axon: This is _different_ from the current firmware. We use
the "delayed" interrupts for txeob and rxeob. Thus we end up with
mapping those 5 MPIC interrupts, all level positive sensitive:
10, 11, 32, 33, 34 (in decimal)
- dcr-reg : < DCR registers range >
- dcr-parent : if needed for dcr-reg
- num-tx-chans : 1 cell, number of Tx channels
- num-rx-chans : 1 cell, number of Rx channels
* In the ZMII node
- name : "emac-zmii"
- device_type : "emac-zmii"
- compatible : compatible list, containing 2 entries, first is "ibm,zmii-CHIP" where
CHIP is the hose ASIC (like emac) and the second is "zmii"
: For axon, there is no ZMII node
- model : optional model string
- reg : <registers mapping>
* In the RGMII node
- name : "emac-rgmii"
- device_type : "emac-rgmii"
- compatible : compatible list, containing 2 entries, first is "ibm,rgmii-CHIP" where
CHIP is the hose ASIC (like emac) and the second is "rgmii"
: For axon, "ibm,rgmii-axon","ibm,rgmii"
- model : optional model string
- reg : <registers mapping>
- revision : as provided by the RGMII new version register if available
For axon: 0x0000012a
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: EMAC device-tree binding (#2)
2007-01-30 0:58 EMAC device-tree binding (#2) Benjamin Herrenschmidt
@ 2007-02-02 1:12 ` David Gibson
2007-02-04 4:40 ` Benjamin Herrenschmidt
2007-02-02 6:50 ` Segher Boessenkool
2007-02-05 6:00 ` EMAC device-tree binding #3 (& driver) Benjamin Herrenschmidt
2 siblings, 1 reply; 6+ messages in thread
From: David Gibson @ 2007-02-02 1:12 UTC (permalink / raw)
To: Benjamin Herrenschmidt; +Cc: linuxppc-dev list
On Tue, Jan 30, 2007 at 11:58:27AM +1100, Benjamin Herrenschmidt wrote:
> According to the various comments I got, here's the latest binding for
> EMAC:
[snip]
> - cell-index : 1 cell, hardware index of the EMAC cell on a given ASIC (typically
> 0x00000000 and 0x00000001 for EMAC-0 and EMAC-1 on each Axon chip)
I noticed that some of the Freescale device trees used a property
called 'device-id' for what appears to be the same thing as this on
their UCC. Maybe we should use that name for EMAC and the other 4xx
devices as well?
--
David Gibson | I'll have my music baroque, and my code
david AT gibson.dropbear.id.au | minimalist, thank you. NOT _the_ _other_
| _way_ _around_!
http://www.ozlabs.org/~dgibson
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: EMAC device-tree binding (#2)
2007-01-30 0:58 EMAC device-tree binding (#2) Benjamin Herrenschmidt
2007-02-02 1:12 ` David Gibson
@ 2007-02-02 6:50 ` Segher Boessenkool
2007-02-04 4:41 ` Benjamin Herrenschmidt
2007-02-05 6:00 ` EMAC device-tree binding #3 (& driver) Benjamin Herrenschmidt
2 siblings, 1 reply; 6+ messages in thread
From: Segher Boessenkool @ 2007-02-02 6:50 UTC (permalink / raw)
To: Benjamin Herrenschmidt; +Cc: linuxppc-dev list
> - phy-mode : 1 cell, Mode of operations of the PHY
> interface:
> #define PHY_MODE_NA 0
> #define PHY_MODE_MII 1
> #define PHY_MODE_RMII 2
> #define PHY_MODE_SMII 3
> #define PHY_MODE_RGMII 4
> #define PHY_MODE_TBI 5
> #define PHY_MODE_GMII 6
> #define PHY_MODE_RTBI 7
> #define PHY_MODE_SGMII 8
> For axon, it is PHY_MODE_RGMII
Just use a string here... phy-mode = "rgmii" etc.
> * In the McMAL node
>
> - name : "mcmal"
> - device_type : "mcmal-dma"
"dma-controller" instead?
> - device_type : "emac-zmii"
Similar.
Segher
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: EMAC device-tree binding (#2)
2007-02-02 1:12 ` David Gibson
@ 2007-02-04 4:40 ` Benjamin Herrenschmidt
0 siblings, 0 replies; 6+ messages in thread
From: Benjamin Herrenschmidt @ 2007-02-04 4:40 UTC (permalink / raw)
To: David Gibson; +Cc: linuxppc-dev list
On Fri, 2007-02-02 at 12:12 +1100, David Gibson wrote:
> On Tue, Jan 30, 2007 at 11:58:27AM +1100, Benjamin Herrenschmidt wrote:
> > According to the various comments I got, here's the latest binding for
> > EMAC:
>
> [snip]
> > - cell-index : 1 cell, hardware index of the EMAC cell on a given ASIC (typically
> > 0x00000000 and 0x00000001 for EMAC-0 and EMAC-1 on each Axon chip)
>
> I noticed that some of the Freescale device trees used a property
> called 'device-id' for what appears to be the same thing as this on
> their UCC. Maybe we should use that name for EMAC and the other 4xx
> devices as well?
Hrm... I don't like that much... device-id is a standard property for
PCI devices and has a totally different meaning.
Ben.
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: EMAC device-tree binding (#2)
2007-02-02 6:50 ` Segher Boessenkool
@ 2007-02-04 4:41 ` Benjamin Herrenschmidt
0 siblings, 0 replies; 6+ messages in thread
From: Benjamin Herrenschmidt @ 2007-02-04 4:41 UTC (permalink / raw)
To: Segher Boessenkool; +Cc: linuxppc-dev list
On Fri, 2007-02-02 at 07:50 +0100, Segher Boessenkool wrote:
> > - phy-mode : 1 cell, Mode of operations of the PHY
> > interface:
> > #define PHY_MODE_NA 0
> > #define PHY_MODE_MII 1
> > #define PHY_MODE_RMII 2
> > #define PHY_MODE_SMII 3
> > #define PHY_MODE_RGMII 4
> > #define PHY_MODE_TBI 5
> > #define PHY_MODE_GMII 6
> > #define PHY_MODE_RTBI 7
> > #define PHY_MODE_SGMII 8
> > For axon, it is PHY_MODE_RGMII
>
> Just use a string here... phy-mode = "rgmii" etc.
Good point. I'll change that.
> > * In the McMAL node
> >
> > - name : "mcmal"
> > - device_type : "mcmal-dma"
>
> "dma-controller" instead?
Yeah, good idea.
> > - device_type : "emac-zmii"
>
> Similar.
rgmii and zmii are "weird"... they aren't DMA controllers. They are EMAC
specific link interfaces, I'm not sure how to call them.
Ben.
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: EMAC device-tree binding #3 (& driver)
2007-01-30 0:58 EMAC device-tree binding (#2) Benjamin Herrenschmidt
2007-02-02 1:12 ` David Gibson
2007-02-02 6:50 ` Segher Boessenkool
@ 2007-02-05 6:00 ` Benjamin Herrenschmidt
2 siblings, 0 replies; 6+ messages in thread
From: Benjamin Herrenschmidt @ 2007-02-05 6:00 UTC (permalink / raw)
To: linuxppc-dev list
Cc: Michael Ellerman, Christian Rund, Mark Yadlosky, Murali N Iyer,
Hartmut Penner, David Gibson
Ok, here's the "final" binding for now and a driver at:
http://gate.crashing.org/~benh/powerpc-emac-new-20070205.diff
The driver isn't much different than the previous ones I posted for
Axon, mostly changes to adapt to binding updates & axon related bug
fixes.
Hopefully, David will have enough of the 440 port up soon to start
testing it on 4xx hardware as well at which point I'll think about
submitting it for upstream.
* The OPB node needs a "clock-frequency" property
* In the EMAC node itself (plb5/plb4/opb/ethernet)
- name : "ethernet"
- device_type : "network"
- compatible : compatible list, contains 2 entries, first is "ibm,emac-CHIP" where
CHIP is the host ASIC (440gx, 405gp, axon) and second is either
"ibm,emac" or "ibm,emac4".
For axon, thus, we have: "ibm,emac-axon","ibm,emac4"
- model : optional model string
- interrupts : <interrupt mapping for EMAC IRQ and WOL IRQ>
- interrupt-parent : optional, if needed for interrupt mapping
- reg : <registers mapping>
- local-mac-address : 6 bytes, MAC address
- mal-device : 1 cell, phandle of the associated McMAL node
- mal-tx-channel : 1 cell, index of the tx channel on McMAL associated with this EMAC
- mal-rx-channel : 1 cell, index of the rx channel on McMAL associated with this EMAC
- cell-index : 1 cell, hardware index of the EMAC cell on a given ASIC (typically
0x00000000 and 0x00000001 for EMAC-0 and EMAC-1 on each Axon chip)
- max-frame-size : 1 cell, maximum frame size supported in bytes
- rx-fifo-size : 1 cell, Rx fifo size in bytes for 10 and 100 Mb/sec operations.
For axon, 2048
- rx-fifo-size-gige : 1 cell, optional, Rx fifo size in bytes for 1000 Mb/sec operations
(if absent the value is the same as rx-fifo-size).
For axon, either absent or 2048.
- tx-fifo-size : 1 cell, Tx fifo size in bytes for 10 and 100 Mb/sec operations. For axon
- tx-fifo-size-gige : 1 cell, optional, Tx fifo size in bytes for 1000 Mb/sec operations
(if absent the value is the same as tx-fifo-size)
For axon, either absent or 2048.
- fifo-entry-size : 1 cell, size of a fifo entry (used to calculate thresholds)
For axon, 0x00000010
- mal-burst-size : 1 cell, MAL burst size (used to calculate thresholds) in bytes
For axon, 0x00000100 (I think ...)
- phy-mode : string, mode of operations of the PHY interface. Supported values are:
"mii", "rmii", "smii", "rgmii", "tbi", "gmii", rtbi", "sgmii"
For axon on CAB, it is "rgmii"
- phy-address : 1 cell, optional, MDIO address of the PHY. If absent, a search
is performed
For axon: please fill with approriate value, I don't have it at
hand, it depends on the board and the EMAC of course.
- phy-map : 1 cell, optional, bitmap of addresses to probe the PHY for, used
if phy-address is absent. bit 0x00000001 is MDIO address 0. For axon
it can be absent, thouugh my current driver doesn't handle phy-address
yet so for now, keep 0x00ffffff in it.
- mdio-device : 1 cell, optional. If shared MDIO registers (440EP), phandle of the EMAC
to use to drive the MDIO lines for the PHY used by this EMAC.
For axon: absent
- zmii-device : 1 cell, optional. If connected to a ZMII, phandle of the ZMII device node
For axon: absent
- zmii-channel : 1 cell, optional. If connected to a ZMII, which channel or 0xffffffff if
ZMII is only used for MDIO
- rgmii-device : 1 cell, optional. If connected to a RGMII, phandle of the RGMII device node
For axon: phandle of plb5/plb4/opb/rgmii
- rgmii-channel : 1 cell, optional. If connected to a RGMII, which channel
Fox axon: present, whatever value is appropriate for each EMAC, that is
the content of the current (bogus) "phy-port" property
- tah-device : 1 cell, optional. If connected to a TAH engine for offload, phandle of
the TAH device node
- tah-channel : 1 cell, optional. If appropriate, channel used on the TAH engine
* In the McMAL node
- name : "mcmal"
- device_type : "dma-controller"
- compatible : compatible list, containing 2 entries, first is "ibm,mcmal-CHIP" where
CHIP is the hose ASIC (like emac) and the second is either "ibm,mcmal"
or "ibm,mcmal2".
: For axon, "ibm,mcmal-axon","ibm,mcmal2"
- model : optional model string
- interrupts : <interrupt mapping for the MAL interrupts sources:
5 sources: tx_eob, rx_eob, serr, txde, rxde>.
For axon: This is _different_ from the current firmware. We use
the "delayed" interrupts for txeob and rxeob. Thus we end up with
mapping those 5 MPIC interrupts, all level positive sensitive:
10, 11, 32, 33, 34 (in decimal)
- dcr-reg : < DCR registers range >
- dcr-parent : if needed for dcr-reg
- num-tx-chans : 1 cell, number of Tx channels
- num-rx-chans : 1 cell, number of Rx channels
* In the ZMII node
- name : "zmii"
- device_type : "zmii-interface"
- compatible : compatible list, containing 2 entries, first is "ibm,zmii-CHIP" where
CHIP is the hose ASIC (like emac) and the second is "zmii"
: For axon, there is no ZMII node
- model : optional model string
- reg : <registers mapping>
* In the RGMII node
- name : "rgmii"
- device_type : "rgmii-interface"
- compatible : compatible list, containing 2 entries, first is "ibm,rgmii-CHIP" where
CHIP is the hose ASIC (like emac) and the second is "rgmii"
: For axon, "ibm,rgmii-axon","ibm,rgmii"
- model : optional model string
- reg : <registers mapping>
- revision : as provided by the RGMII new version register if available
For axon: 0x0000012a
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2007-02-05 6:00 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2007-01-30 0:58 EMAC device-tree binding (#2) Benjamin Herrenschmidt
2007-02-02 1:12 ` David Gibson
2007-02-04 4:40 ` Benjamin Herrenschmidt
2007-02-02 6:50 ` Segher Boessenkool
2007-02-04 4:41 ` Benjamin Herrenschmidt
2007-02-05 6:00 ` EMAC device-tree binding #3 (& driver) Benjamin Herrenschmidt
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).