URL https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [usbseth-netdev.html] - Blame information for rev 28

Go to most recent revision | Details | Compare with Previous | View Log


<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
<!-- This material may be distributed only subject to the terms      -->
<!-- and conditions set forth in the Open Publication License, v1.0  -->
<!-- or later (the latest version is presently available at          -->
<!-- http://www.opencontent.org/openpub/).                           -->
<!-- Distribution of the work or derivative of the work in any       -->
<!-- standard (paper) book form is prohibited unless prior           -->
<!-- permission is obtained from the copyright holder.               -->
<HTML
><HEAD
><TITLE
>Network Device for the eCos TCP/IP Stack</TITLE
><meta name="MSSmartTagsPreventParsing" content="TRUE">
<META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="eCos Reference Manual"
HREF="ecos-ref.html"><LINK
REL="UP"
TITLE="eCos Support for Developing USB-ethernet Peripherals"
HREF="io-usb-slave-eth.html"><LINK
REL="PREVIOUS"
TITLE="USB-ethernet State Handling"
HREF="usbseth-control.html"><LINK
REL="NEXT"
TITLE="Example Host-side Device Driver"
HREF="usbseth-host.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>eCos Reference Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="usbseth-control.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="usbseth-host.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="USBSETH-NETDEV">Network Device for the eCos TCP/IP Stack</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN17572"
></A
><H2
>Name</H2
>Network Device&nbsp;--&nbsp;USB-ethernet support for the eCos TCP/IP Stack</DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17575"
></A
><H2
>Description</H2
><P
>If the USB peripheral involves running the eCos TCP/IP stack and that
stack needs to use USB-ethernet as a transport layer (or as one of the
transports), then the USB-ethernet package can provide a suitable
network device driver. It is still necessary for higher-level code to
perform appropriate initialization by calling <A
HREF="usbseth-init.html"
><TT
CLASS="FUNCTION"
>usbs_eth_init</TT
></A
>, but
after that it will be the TCP/IP stack rather than application code
that transmits or receives ethernet frames.</P
><P
>Not all peripherals involving the USB-ethernet package will require a
TCP/IP stack. Hence the provision of the network device is controlled
by a configuration option <TT
CLASS="LITERAL"
>CYGPKG_USBS_ETHDRV</TT
>. By
default this will be enabled if the TCP/IP package
<TT
CLASS="LITERAL"
>CYGPKG_NET</TT
> is loaded, and disabled otherwise. </P
><P
>There are a number of other configuration options related to the
network device. <TT
CLASS="LITERAL"
>CYGFUN_USBS_ETHDRV_STATISTICS</TT
>
determines whether or not the package will maintain statistics, mainly
intended for SNMP: by default this will be enabled if the SNMP support
package <TT
CLASS="LITERAL"
>CYGPKG_SNMPAGENT</TT
> is loaded, and disabled
otherwise. The name of the ethernet device is controlled by
<TT
CLASS="LITERAL"
>CYGDATA_USBS_ETHDRV_NAME</TT
>, and has a default value
of either <TT
CLASS="LITERAL"
>eth0</TT
> or <TT
CLASS="LITERAL"
>eth1</TT
>
depending on whether or not there is another network device driver
present in the configuration.</P
><P
>Usually eCos network device drivers default to using DHCP for
obtaining necessary information such as IP addresses. This is not
appropriate for USB-ethernet devices. On the host-side the
USB-ethernet network device will not exist until the USB peripheral
has been plugged in and communication has been established. Therefore
any DHCP daemon on the host would not be listening on that network
device at the point that eCos requests its IP and other information. A
related issue is that the use of DHCP would imply the presence of a
DHCP daemon on every affected host machine, as opposed to a single
daemon (plus backups) for the network as a whole. For these reasons
the USB-ethernet package precludes the use of DHCP as a way of setting
the IP address, instead requiring alternatives such as manual
configuration.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="usbseth-control.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ecos-ref.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="usbseth-host.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>USB-ethernet State Handling</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="io-usb-slave-eth.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Example Host-side Device Driver</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Line No.	Rev	Author	Line
1	28	unneback	`<!-- Copyright (C) 2003 Red Hat, Inc. -->`
2			`<!-- This material may be distributed only subject to the terms -->`
3			`<!-- and conditions set forth in the Open Publication License, v1.0 -->`
4			`<!-- or later (the latest version is presently available at -->`
5			`<!-- http://www.opencontent.org/openpub/). -->`
6			`<!-- Distribution of the work or derivative of the work in any -->`
7			`<!-- standard (paper) book form is prohibited unless prior -->`
8			`<!-- permission is obtained from the copyright holder. -->`
9			`<HTML`
10			`><HEAD`
11			`><TITLE`
12			`>Network Device for the eCos TCP/IP Stack</TITLE`
13			`><meta name="MSSmartTagsPreventParsing" content="TRUE">`
14			`<META`
15			`NAME="GENERATOR"`
16			`CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+`
17			`"><LINK`
18			`REL="HOME"`
19			`TITLE="eCos Reference Manual"`
20			`HREF="ecos-ref.html"><LINK`
21			`REL="UP"`
22			`TITLE="eCos Support for Developing USB-ethernet Peripherals"`
23			`HREF="io-usb-slave-eth.html"><LINK`
24			`REL="PREVIOUS"`
25			`TITLE="USB-ethernet State Handling"`
26			`HREF="usbseth-control.html"><LINK`
27			`REL="NEXT"`
28			`TITLE="Example Host-side Device Driver"`
29			`HREF="usbseth-host.html"></HEAD`
30			`><BODY`
31			`CLASS="REFENTRY"`
32			`BGCOLOR="#FFFFFF"`
33			`TEXT="#000000"`
34			`LINK="#0000FF"`
35			`VLINK="#840084"`
36			`ALINK="#0000FF"`
37			`><DIV`
38			`CLASS="NAVHEADER"`
39			`><TABLE`
40			`SUMMARY="Header navigation table"`
41			`WIDTH="100%"`
42			`BORDER="0"`
43			`CELLPADDING="0"`
44			`CELLSPACING="0"`
45			`><TR`
46			`><TH`
47			`COLSPAN="3"`
48			`ALIGN="center"`
49			`>eCos Reference Manual</TH`
50			`></TR`
51			`><TR`
52			`><TD`
53			`WIDTH="10%"`
54			`ALIGN="left"`
55			`VALIGN="bottom"`
56			`><A`
57			`HREF="usbseth-control.html"`
58			`ACCESSKEY="P"`
59			`>Prev</A`
60			`></TD`
61			`><TD`
62			`WIDTH="80%"`
63			`ALIGN="center"`
64			`VALIGN="bottom"`
65			`></TD`
66			`><TD`
67			`WIDTH="10%"`
68			`ALIGN="right"`
69			`VALIGN="bottom"`
70			`><A`
71			`HREF="usbseth-host.html"`
72			`ACCESSKEY="N"`
73			`>Next</A`
74			`></TD`
75			`></TR`
76			`></TABLE`
77			`><HR`
78			`ALIGN="LEFT"`
79			`WIDTH="100%"></DIV`
80			`><H1`
81			`><A`
82			`NAME="USBSETH-NETDEV">Network Device for the eCos TCP/IP Stack</H1`
83			`><DIV`
84			`CLASS="REFNAMEDIV"`
85			`><A`
86			`NAME="AEN17572"`
87			`></A`
88			`><H2`
89			`>Name</H2`
90			`>Network Device -- USB-ethernet support for the eCos TCP/IP Stack</DIV`
91			`><DIV`
92			`CLASS="REFSECT1"`
93			`><A`
94			`NAME="AEN17575"`
95			`></A`
96			`><H2`
97			`>Description</H2`
98			`><P`
99			`>If the USB peripheral involves running the eCos TCP/IP stack and that`
100			`stack needs to use USB-ethernet as a transport layer (or as one of the`
101			`transports), then the USB-ethernet package can provide a suitable`
102			`network device driver. It is still necessary for higher-level code to`
103			`perform appropriate initialization by calling <A`
104			`HREF="usbseth-init.html"`
105			`><TT`
106			`CLASS="FUNCTION"`
107			`>usbs_eth_init</TT`
108			`></A`
109			`>, but`
110			`after that it will be the TCP/IP stack rather than application code`
111			`that transmits or receives ethernet frames.</P`
112			`><P`
113			`>Not all peripherals involving the USB-ethernet package will require a`
114			`TCP/IP stack. Hence the provision of the network device is controlled`
115			`by a configuration option <TT`
116			`CLASS="LITERAL"`
117			`>CYGPKG_USBS_ETHDRV</TT`
118			`>. By`
119			`default this will be enabled if the TCP/IP package`
120			`<TT`
121			`CLASS="LITERAL"`
122			`>CYGPKG_NET</TT`
123			`> is loaded, and disabled otherwise. </P`
124			`><P`
125			`>There are a number of other configuration options related to the`
126			`network device. <TT`
127			`CLASS="LITERAL"`
128			`>CYGFUN_USBS_ETHDRV_STATISTICS</TT`
129			`>`
130			`determines whether or not the package will maintain statistics, mainly`
131			`intended for SNMP: by default this will be enabled if the SNMP support`
132			`package <TT`
133			`CLASS="LITERAL"`
134			`>CYGPKG_SNMPAGENT</TT`
135			`> is loaded, and disabled`
136			`otherwise. The name of the ethernet device is controlled by`
137			`<TT`
138			`CLASS="LITERAL"`
139			`>CYGDATA_USBS_ETHDRV_NAME</TT`
140			`>, and has a default value`
141			`of either <TT`
142			`CLASS="LITERAL"`
143			`>eth0</TT`
144			`> or <TT`
145			`CLASS="LITERAL"`
146			`>eth1</TT`
147			`>`
148			`depending on whether or not there is another network device driver`
149			`present in the configuration.</P`
150			`><P`
151			`>Usually eCos network device drivers default to using DHCP for`
152			`obtaining necessary information such as IP addresses. This is not`
153			`appropriate for USB-ethernet devices. On the host-side the`
154			`USB-ethernet network device will not exist until the USB peripheral`
155			`has been plugged in and communication has been established. Therefore`
156			`any DHCP daemon on the host would not be listening on that network`
157			`device at the point that eCos requests its IP and other information. A`
158			`related issue is that the use of DHCP would imply the presence of a`
159			`DHCP daemon on every affected host machine, as opposed to a single`
160			`daemon (plus backups) for the network as a whole. For these reasons`
161			`the USB-ethernet package precludes the use of DHCP as a way of setting`
162			`the IP address, instead requiring alternatives such as manual`
163			`configuration.</P`
164			`></DIV`
165			`><DIV`
166			`CLASS="NAVFOOTER"`
167			`><HR`
168			`ALIGN="LEFT"`
169			`WIDTH="100%"><TABLE`
170			`SUMMARY="Footer navigation table"`
171			`WIDTH="100%"`
172			`BORDER="0"`
173			`CELLPADDING="0"`
174			`CELLSPACING="0"`
175			`><TR`
176			`><TD`
177			`WIDTH="33%"`
178			`ALIGN="left"`
179			`VALIGN="top"`
180			`><A`
181			`HREF="usbseth-control.html"`
182			`ACCESSKEY="P"`
183			`>Prev</A`
184			`></TD`
185			`><TD`
186			`WIDTH="34%"`
187			`ALIGN="center"`
188			`VALIGN="top"`
189			`><A`
190			`HREF="ecos-ref.html"`
191			`ACCESSKEY="H"`
192			`>Home</A`
193			`></TD`
194			`><TD`
195			`WIDTH="33%"`
196			`ALIGN="right"`
197			`VALIGN="top"`
198			`><A`
199			`HREF="usbseth-host.html"`
200			`ACCESSKEY="N"`
201			`>Next</A`
202			`></TD`
203			`></TR`
204			`><TR`
205			`><TD`
206			`WIDTH="33%"`
207			`ALIGN="left"`
208			`VALIGN="top"`
209			`>USB-ethernet State Handling</TD`
210			`><TD`
211			`WIDTH="34%"`
212			`ALIGN="center"`
213			`VALIGN="top"`
214			`><A`
215			`HREF="io-usb-slave-eth.html"`
216			`ACCESSKEY="U"`
217			`>Up</A`
218			`></TD`
219			`><TD`
220			`WIDTH="33%"`
221			`ALIGN="right"`
222			`VALIGN="top"`
223			`>Example Host-side Device Driver</TD`
224			`></TR`
225			`></TABLE`
226			`></DIV`
227			`></BODY`
228			`></HTML`
229			`>`

Browse

Tools

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [usbseth-netdev.html] - Blame information for rev 28