2002-07-26  Gary Thomas  <gary@chez-thomas.org>
2002-07-26  Ken Cox <jkc@redhat.com>

	* src/net/eth_drv.c (eth_drv_start): Force multicast address
	setup any time chip is reset/reconfigured.

2002-05-30  Jonathan Larmour  <jlarmour@redhat.com>

	* cdl/eth_drivers.cdl: Provide CYGINT_IO_ETH_INT_SUPPORT_REQUIRED
	interface to indicate if interrupt support is required.

2002-05-28  Jonathan Larmour  <jlarmour@redhat.com>

	* src/lwip/lw.diff: Remove. Obsolete.

2002-05-13  Jesper Skov  <jskov@redhat.com>

	* cdl/eth_drivers.cdl: Moved the package's header files to
	cyg/io/eth to clean up the include root directory.

2002-04-30  Jonathan Larmour  <jlarmour@redhat.com>

	* src/lwip/eth_drv.c: Update from Jani Monoses.

	* cdl/eth_drivers.cdl: Move CYGINT_ISO_STRING_STRFUNCS requirement
	into CYGPKG_IO_ETH_DRIVERS_NET where it belongs.
	Move CYGINT_ISO_STRING_MEMFUNCS requirement into
	CYGPKG_IO_ETH_DRIVERS_STAND_ALONE where it belongs.

2002-04-10   Gary Thomas <gthomas@redhat.com>

	* src/net/eth_drv.c: Only pass mutlicast addresses down to drivers.	

2002-04-05   Jani Monoses  <jani@iv.ro>

	* src/lwip/eth_drv.c: New file. Add eth driver support for lwip.
	* src/lwip/lw.diff: New file. diff against lwip sources.
	* src/lwip/README: New file.
	* cdl/eth_drivers.cdl: Add lwip driver support.

2002-03-09  Gary Thomas  <gthomas@redhat.com>

	* src/net/eth_drv.c: Select 'multicast_all' if too many addresses
	are required.  Also, ignore any non-multicast addresses.

2002-02-22  Hugo Tyson  <hmt@redhat.com>

	* doc/ethdrv.sgml: New file.  SGML-ized the existing driver-doc
	file and brought the information up to date with deliver functions
	and all that.

2002-02-18  Gary Thomas  <gthomas@redhat.com>

	* cdl/eth_drivers.cdl: 
	Add new interface CYGINT_IO_ETH_MULTICAST which is used to
	insure that drivers support multicast addresses if IPv6 is used.

2002-02-15  Gary Thomas  <gthomas@redhat.com>

	* src/net/eth_drv.c: 
	* include/eth_drv.h: Add framework for multicast address support.

2002-01-30  Hugo Tyson  <hmt@redhat.com>

	* cdl/eth_drivers.cdl (CYGPKG_IO_ETH_DRIVERS_WARN_FORCE_CONSOLE):
	CDL options removed; control is now from RedBoot.

	* src/net/eth_drv.c (START_CONSOLE): Changed to use RedBoot
	fconfig items for deciding what console to use for special debug
	messages such as "out of MBUFs" and the like.

	* src/stand_alone/eth_drv.c (LOCK_APPLICATION_SCHEDULER): New
	macro to do what it says, before passing packets to the app.
	Used in two places: when passing a received packet, and when
	passing a tx completion status back.

2002-01-28  Gary Thomas  <gthomas@redhat.com>

	* src/net/eth_drv.c (eth_drv_init): Changes for supporting new
	FreeBSD based stack (minor API changes internal to that stack).

2001-12-12  Hugo Tyson  <hmt@redhat.com>

	* src/net/eth_drv.c (START_CONSOLE,END_CONSOLE): New macros akin
	to those within RedBoot's internal net_io.c, for directing warning
	messages to a serial line if required.  All printf's wrapped in
	them for safety.

	* cdl/eth_drivers.cdl (CYGPKG_IO_ETH_DRIVERS_WARN_FORCE_CONSOLE):
	and ..._NUMBER, new options to direct application warning output
	somewhere useful (less harmful) for when you are debugging over
	the net.  Trying to print within a call which occurred from within
	RedBoot itself is such a recursive situation as to be fatal.
	Defaults are disabled, you must choose to set these up if
	you want to debug your app safely over the network.

2001-12-12  Hugo Tyson  <hmt@redhat.com>

	* src/stand_alone/eth_drv.c (DIAG_DUMP_BUF_HDR,DIAG_DUMP_BUF_BDY):
	Separate macros for debug dumps of ethernet header and body.
	(eth_drv_write): Use them.
	(eth_drv_copy_recv): Do not corrupt the static data pointer, so
	that if we are erroneously called twice, at least what we pass is
	a packet, rather than random memory; do not escape to SEGV.  Guard
	against NULL sg_list[].buf pointers, in case caller out of MBUFs.
	(eth_drv_recv): Only dump packet if we actually have a buffer.
	Only forward the packet if actually have a buffer.

2001-12-04  Richard Sandiford  <rsandifo@redhat.com>

	* src/stand_alone/eth_drv.c (eth_drv_read): Check that the return
	buffer is big enough to hold the packet.

2001-11-28  Jonathan Larmour  <jlarmour@redhat.com>

	* doc/driver_doc: Mention preferences on how the ESA should be set.

2001-10-30  Jonathan Larmour  <jlarmour@redhat.com>

	* doc/driver_doc: Add description of poll, deliver and int_vector
	driver functions.

2001-10-29  Hugo Tyson  <hmt@redhat.com>

	* src/net/eth_drv.c (eth_drv_tickle_devices): [CASE 106613] Rather
	than calling can_send() in the device driver directly, call our
	own eth_drv_send() function which will also dequeue a waiting
	packet if we find we indeed can_send().  This helps to recover
	from queue full situations within the if_ethersubr layer above.
	This change is belt & braces with a similar call in the code which
	drops a packet if the queue is full, in the main network code in
	net/tcpip/.../src/sys/net/if_ethersubr.c (ether_output); this
	change will recover the situation shortly even if the application
	gives up trying to send because of ENOBUFS.

2001-10-18  Jonathan Larmour  <jlarmour@redhat.com>

	* cdl/eth_drivers.cdl: Rename CYGSEM_IO_ETH_DRIVERS_DEBUG to
	CYGDBG_IO_ETH_DRIVERS_DEBUG and make it a common option.
	Add separate CYGDBG_IO_ETH_DRIVERS_DEBUG_VERBOSITY config.

	* include/eth_drv.h: Don't claim BSD if it isn't.
	* include/eth_drv_stats.h: Ditto.
	* include/netdev.h: Ditto.
	* src/net/eth_drv.c: Ditto.
	Also use above CDL options to conditionalize debugging (and the
	verbosity level).
	* src/stand_alone/eth_drv.c: Use above renamed CDL options.

2001-10-11  Gary Thomas  <gthomas@redhat.com>

	* src/stand_alone/eth_drv.c (eth_drv_recv): 
	Defensive programming - insure valid packet size.

2001-10-05  Jonathan Larmour  <jlarmour@redhat.com>

	* src/net/eth_drv.c: Add default implementation of min().

2001-09-26  Jesper Skov  <jskov@redhat.com>

	* cdl/eth_drivers.cdl: Require the string functions.

	* src/stand_alone/eth_drv.c: Fix warnings.

2001-09-25  Hugo Tyson  <hmt@redhat.com>

	* src/net/eth_drv.c (eth_drv_dsr): Assert that the "sc" given to
	eth_drv_dsr() really is a sc from the valid list.  This can save a
	few hours debug time of a typo.

2001-09-13  Hugo Tyson  <hmt@redhat.com>

	* src/net/eth_drv.c (eth_drv_tickle_devices): New function to call
	can_send() on all devices to allow them to unstick from a lost
	interrupt or other wedge - it's up to the device to detect this,
	of course, can_send() does not explicitly do this, it's just used
	as an opportunity harmlessly to get control into the device so it
	can examine its world.

2001-09-05  Gary Thomas  <gthomas@redhat.com>

	* src/stand_alone/eth_drv.c (eth_drv_init): Don't initialize
	structures if ESA is zero.  This is used by low level drivers
	to indicate that a device is present, but can't currently be
	used.  The eCos driver handles this case as well.

2001-08-31  Hugo Tyson  <hmt@redhat.com>
2001-08-31  Andrew Lunn <Andrew.Lunn@ascom.ch>

	* src/net/eth_drv.c (eth_drv_tx_done): Guard against a NULL key
	return - which can be caused by race conditions in the driver,
	this is the neatest fixup.  It's good defensive programming
	anyway and ASCOM's tests indicate a benefit for CASE 106059.

2001-08-22  Gary Thomas  <gthomas@redhat.com>

	* src/stand_alone/eth_drv.c: 
	printf() is no longer a part of RedBoot.  Thus all programs
	must use diag_printf() and related functions instead.

	* cdl/eth_drivers.cdl: Only enable warning/debug modes if RedBoot
	is present as the debug environment (since there are implicit
	dependencies on RedBoot functions).

2001-08-20  Jonathan Larmour  <jlarmour@redhat.com>

	* src/net/eth_drv.c (eth_drv_send): Move endif location to fix build
	error.

2001-08-17  Jonathan Larmour  <jlarmour@redhat.com>

	* cdl/eth_drivers.cdl (CYGSEM_IO_ETH_DRIVERS_DEBUG): Now booldata.
	* src/stand_along/eth_drv.c (eth_drv_tx_done): Use different
	value of CYGSEM_IO_ETH_DRIVERS_DEBUG for verbosity.

2001-08-14  Gary Thomas  <gthomas@redhat.com>

	* src/stand_alone/eth_drv.c (eth_drv_write): 
	(eth_drv_tx_done): 
	(eth_drv_read): Better handling of stacking (layering) of drivers.
	RedBoot (stand alone code) is designed to call into the eCos 
	stack and these changes make sure that this is done properly
	nested/stacked.  These changes also affect the behaviour positively
	for CR 902745-CR.

	* src/net/eth_drv.c (eth_drv_send): Add locking of driver while
	actual hardware routines are involved.  Since the same driver
	can be shared by both eCos and RedBoot, it is imperative that
	additional locking (in the form of locking the scheduler) be
	employed during this window to make sure that the hardware is
	handled in complete, consistent steps.  This helps with known
	bug CR 902745-CR.

2001-08-09  Hugo Tyson  <hmt@redhat.com>

	* src/net/eth_drv.c (eth_drv_recv): Add a pair of
	CYGARC_HAL_SAVE_GP()/CYGARC_HAL_RESTORE_GP() on entry and exit;
	this function is intercalled between RedBoot and the application.
	A minor re-org at the ending to accommodate these macros' nesting.
	(eth_drv_tx_done): CYGARC_HAL_SAVE_GP()/CYGARC_HAL_RESTORE_GP().

	* src/stand_alone/eth_drv.c (eth_drv_tx_done): Add a pair of
	CYGARC_HAL_SAVE_GP()/CYGARC_HAL_RESTORE_GP() on entry and exit;
	this function is intercalled between RedBoot and the application.
	Also make printing message about "tx_done for other key" also
	conditional on net_debug variable - it's commonplace.
	(eth_drv_recv): CYGARC_HAL_SAVE_GP()/CYGARC_HAL_RESTORE_GP().
	(eth_drv_copy_recv): CYGARC_HAL_SAVE_GP()/CYGARC_HAL_RESTORE_GP().

2001-07-03  Gary Thomas  <gthomas@redhat.com>

	* src/net/eth_drv.c (eth_drv_recv): Better cleanup when running
	out of mbufs - could have lost mbufs before.

2001-06-21  David Woodhouse <dwmw2@redhat.com>

	* src/stand_alone/eth_drv.c: Timeout when waiting for Ethernet
	driver to finish sending packet.
	* src/stand_alone/eth_drv.c: Don't delay if it's ready immediately.

2001-06-11  Gary Thomas  <gthomas@redhat.com>

	* cdl/eth_drivers.cdl: Make debug default for RedBoot.

2001-05-22  Jonathan Larmour  <jlarmour@redhat.com>

	* cdl/eth_drivers.cdl: New option: CYGSEM_IO_ETH_DRIVERS_PASS_PACKETS
	which replaces the static define in...
	* src/stand_alone_eth_drv.c: Rename ETH_DRV_PASS_PACKETS to
	new CDL option above.
	Also, ensure references to start_console/end_console are conditional
	on CYGSEM_IO_ETH_DRIVERS_DEBUG.

2001-05-22  Hugo Tyson  <hmt@redhat.com>
2001-05-22  Sanjay Bisen <Sanjay.Bisen@ascom.ch>

	* src/net/eth_drv.c (eth_drv_recv): Patch from Sanjay at Ascom; it
	leaked one mbuf if you run out of clusters.  Fix is simply to
	free m in addition to top.

	* src/net/eth_drv.c (eth_drv_run_deliveries): Fixed a warning with
	an int cast in HAL_CTRLC_CHECK().

2001-03-21  Gary Thomas  <gthomas@redhat.com>

	* cdl/eth_drivers.cdl: Fewer buffers needed in stand-alone mode.

2001-03-12  Hugo Tyson  <hmt@redhat.com>

	* cdl/eth_drivers.cdl: Permit defines for
	CYGPKG_IO_ETH_DRIVERS_STAND_ALONE and CYGPKG_IO_ETH_DRIVERS_NET.
	The generic i82559 driver needs to know, unfortunately; it calls
	its own DSR directly to unblock after a lost interrupt.  And you
	mustn't call the DSR under RedBoot == ....STAND_ALONE.

2001-01-15  Jesper Skov  <jskov@redhat.com>

	* src/net/eth_drv.c (eth_drv_init): Do not use enaddr if NULL.

2001-01-07  Gary Thomas  <gthomas@redhat.com>

	* cdl/eth_drivers.cdl: Add interface 'CYGPKG_NET_DRIVER_FRAMEWORK'
	to describe interdependencies between network stack and driver
	framework packages.

2001-01-04  Gary Thomas  <gthomas@redhat.com>

	* src/net/eth_drv.c (eth_drv_tx_done): Update count of Tx packets.

2000-12-11  Gary Thomas  <gthomas@redhat.com>

	* src/net/eth_drv.c (eth_drv_run_deliveries): Support ^C when
	using network based debug channel.

2000-12-02  Gary Thomas  <gthomas@redhat.com>

	* src/stand_alone/eth_drv.c (eth_drv_write): Debug: dump packet
	before calling hardware routine for improved usability.

2000-10-30  Gary Thomas  <gthomas@redhat.com>

	* include/eth_drv.h: Fix compile error in stand-alone mode.

2000-10-17  Hugo Tyson  <hmt@redhat.com>
2000-10-10  Andrew Lunn <Andrew.Lunn@ascom.ch>
	* cdl/eth_drivers.cdl: Add configury to disable the warnings about
	out of mbufs for receives.

	* src/net/eth_drv.c: The changes required for the above.

2000-09-28  Hugo Tyson  <hmt@redhat.com>

	* src/net/eth_drv.c (eth_drv_run_deliveries): Remove race
	condition; a chance to deliver could be delayed until "next time"
	if the DSR snuck in just right.

2000-09-14  Hugo Tyson  <hmt@redhat.com>

	* cdl/eth_drivers.cdl: Add configury to control new features.  All
	is controlled globally by CYGPKG_IO_ETH_DRIVERS_SIMULATED_FAILURES
	which is by default off, natch.

	* src/net/eth_drv.c (simulate_fail): Implement simulated failures
	in ethernet packet delivery - independent tx and rx dropping and
	rx packet corruption.  Also a "line break" drop-all feature.

2000-09-13  Gary Thomas  <gthomas@redhat.com>

	* src/stand_alone/eth_drv.c: Take out noisy dump when out of buffers.

2000-09-11  Hugo Tyson  <hmt@cygnus.co.uk>

	* src/stand_alone/eth_drv.c (eth_drv_write): If we timeout waiting
	for the write to complete, do reset the vectors to point to the
	application, rather just a bald "return".

2000-09-08  Hugo Tyson  <hmt@cygnus.co.uk>

	* include/netdev.h (NETDEVTAB_ENTRY): Work around feature of new
	version of CYG_HAL_TABLE_ENTRY() whereby no spaces are allowed.

2000-09-07  Jonathan Larmour  <jlarmour@redhat.com>

	* include/netdev.h (cyg_netdevtab_entry_t): Correct syntax for
	CYG_HAL_TABLE_TYPE

2000-09-04  Jonathan Larmour  <jlarmour@redhat.com>

	* include/netdev.h (cyg_netdevtab_entry_t): Apply CYG_HAL_TABLE_TYPE

2000-09-01  Hugo Tyson  <hmt@cygnus.co.uk>

	* src/stand_alone/eth_drv.c (eth_drv_dsr): New function, never
	called but maybe referenced in stand_alone context, which lets
	redboot work in the new world.

2000-09-01  Hugo Tyson  <hmt@cygnus.co.uk>

	* OVERVIEW: This is part of the change to the network stack to
	greatly reduce latencies both of (other) DSRs and of thread
	scheduling.  All the work that the network stack *and* individual
	ether drivers used to do in DSRs (including alarm callbacks and
	data copies to/from the device memory) is moved into a "fast
	network thread" instead.  It calls a device's "deliver" function
	to do the work that was previously in the DSR.  This is a separate
	thread so that it can be set higher priority than application
	threads in order to minimize packet loss (depending on the
	driver), if required (the application threads presumed to be
	higher priority in turn than the network thread).  A crucial
	consequence of this is that we are no longer locking against DSRs,
	so a plain mutex can be used rather than the global scheduler
	lock, thus simplifying all the splfoo/splx() style functions.

	These changes WILL BREAK individual device drivers until they are
	updated AND the standalone logical ether driver in this component,
	until it is updated also.

	* include/eth_drv.h (ETH_DRV_SC): Add "deliver" entry to struct
	eth_hwr_funs interface record; declare available DSR and flag for
	"needs delivery" in SC status field.

	* src/net/eth_drv.c (eth_drv_run_deliveries): New function,
	performs callbacks to deliver funcs for all devs that want it.
	(eth_drv_dsr): New function, sets flag in sc and calls up to net
	stack to schedule the fast network thread.
	(eth_drv_send): No need to lock scheduler here.

2000-08-29  Gary Thomas  <gthomas@redhat.com>

	* src/stand_alone/eth_drv.c: Use null buffer, (char *)0,
	instead of wasting memory - low level drivers must be designed
	to handle this case.

2000-08-28  Gary Thomas  <gthomas@redhat.com>

	* src/stand_alone/eth_drv.c: Use new configuration parameters.

	* cdl/eth_drivers.cdl: Add new configury to control number of
	internal buffers used by this layer.  Also exposed some of the
	debug flags here.

2000-08-25  Hugo Tyson  <hmt@cygnus.co.uk>

	* include/eth_drv_stats.h (ether_drv_stats): A little further
	diddling; have a bool to say whether the dot3 info is filled in.

2000-08-24  Hugo Tyson  <hmt@cygnus.co.uk>

	* src/net/eth_drv.c (eth_drv_ioctl): Implement ioctl() calls.
	sockio.h numbers SIOCGIFSTATS and SIOCGIFSTATSUD map to
	ETH_DRV_GET_IF_STATS and ETH_DRV_GET_IF_STATS_UD respectively.

	* include/eth_drv.h (ETH_DRV_GET_IF_STATS_UD): Add new device
	interface ioctl() numbers, to get the struct below filled in.
	Also pull in the definition include file (below).

	* include/eth_drv_stats.h (ether_drv_stats): New file: Define
	common structure for ether devices to return stats info to higher
	up, via an ioctl() call.  SNMP uses this.

2000-08-23  Gary Thomas  <gthomas@redhat.com>

	* src/stand_alone/eth_drv.c: 
	* include/eth_drv.h: Low level drivers now need to export a 
	function which returns the interrupt vector used by that interface.
	This allows outside code to determine this in a portable fashion.

2000-08-16  Gary Thomas  <gthomas@redhat.com>

	* src/stand_alone/eth_drv.c: 
	* include/eth_drv.h: Clean up warnings (better protyping).

	* src/stand_alone/eth_drv.c (eth_drv_write): Abandon sending
	packet if device goes not ready for a long time (in some cases,
	this is the only indication that the link is down).

2000-08-07  Gary Thomas  <gthomas@redhat.com>

	* src/net/eth_drv.c (eth_drv_recv): Add safety in case this gets
	called [from stand-alone code] while interface is not up.
	
	* src/stand_alone/eth_drv.c: 
	* include/eth_drv.h: Rework to more fully support mixed stand-alone
	and system (eCos) stacks.

2000-08-03  Gary Thomas  <gthomas@redhat.com>

	* cdl/eth_drivers.cdl: Reparent within I/O, not NET.  This allows
	for stand-alone use as well as support for other stack implementations.

2000-07-28  Hugo Tyson  <hmt@cygnus.co.uk>

	* src/eth_drv.c (eth_drv_recv): Assert that the length we're asked
	to deal with is at least an ether header, and also be defensive in
	any case; discard small packets.  [CASE 104206]

2000-07-26  Gary Thomas  <gthomas@redhat.com>

	* src/eth_drv.c: 
	* include/eth_drv.h: Change interfaces used by hardware layer to
	be "soft" (pointers to functions).  This will allow those drivers
	to be shared by applications and the ROM/debug environment.

2000-07-15  Gary Thomas  <gthomas@redhat.com>

	* include/eth_drv.h: Add [initial] extensions to let this
	layer work either in an eCos environment or stand-alone.

2000-07-11  Gary Thomas  <gthomas@redhat.com>

	* include/eth_drv.h: Add minimal PCMCIA support.

	* src/eth_drv.c (eth_drv_netdev): New function - used to find the
	ethernet device info for PCMCIA devices.

2000-06-23  Hugo Tyson  <hmt@cygnus.co.uk>

	* src/eth_drv.c (eth_drv_send): Do not consume an SG entry for
	zero length data; tolerate overflow of the SG.  Before this, pings
	of 6000 bytes crashed the system!

	You can now set net_debug to 2 to get quieter output; 1 gives the
	whole packet dump as before.

	* include/eth_drv.h (MAX_ETH_DRV_SG): Make this 16 so that an MTU
	made of all mbufs will not overflow.

2000-03-28  Gary Thomas  <gthomas@redhat.com>

	* src/eth_drv.c (eth_drv_recv): Tolerate running out of MBUFs
	instead of "panic"ing.

2000-03-08  Gary Thomas  <gthomas@redhat.com>

	* src/eth_drv.c: Add some function [block] comments.
	(eth_drv_send): Use eCos scheduler lock instead of interrupt lock.

2000-03-08  Hugo Tyson  <hmt@cygnus.co.uk>

	* doc/driver_doc: Add some clarification about what's called when,
	proofreading results, shorter lines so I can print it nicely.

2000-03-06  Gary Thomas  <gthomas@redhat.com>

	* src/eth_drv.c: 
	* include/eth_drv.h: 
	* doc/driver_doc: Remove generic "priv"ate references.

2000-02-29  Gary Thomas  <gthomas@cygnus.co.uk>

	* src/eth_drv.c: 
	* include/eth_drv.h: New expanded API for hardware drivers.

2000-02-18  Gary Thomas  <gthomas@cygnus.co.uk>

	* src/eth_drv.c (eth_drv_send): Disable interrupts while initiating
	the buffer send - avoid a possible race.

2000-02-08  John Dallaway  <jld@cygnus.co.uk>

	* cdl/eth_drivers.cdl:
	Reparent under CYGPKG_NET and tidy display strings.

//===========================================================================
//####ECOSGPLCOPYRIGHTBEGIN####
// -------------------------------------------
// This file is part of eCos, the Embedded Configurable Operating System.
// Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
//
// eCos is free software; you can redistribute it and/or modify it under
// the terms of the GNU General Public License as published by the Free
// Software Foundation; either version 2 or (at your option) any later version.
//
// eCos is distributed in the hope that it will be useful, but WITHOUT ANY
// WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
// for more details.
//
// You should have received a copy of the GNU General Public License along
// with eCos; if not, write to the Free Software Foundation, Inc.,
// 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
//
// As a special exception, if other files instantiate templates or use macros
// or inline functions from this file, or you compile this file and link it
// with other works to produce a work based on this file, this file does not
// by itself cause the resulting work to be covered by the GNU General Public
// License. However the source code for this file must still be made available
// in accordance with section (3) of the GNU General Public License.
//
// This exception does not invalidate any other reasons why a work based on
// this file might be covered by the GNU General Public License.
//
// Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
// at http://sources.redhat.com/ecos/ecos-license/
// -------------------------------------------
//####ECOSGPLCOPYRIGHTEND####
//===========================================================================
	
	

