Subversion Repositories openrisc_me

# ====================================================================

#

#       intel_i82559_eth_drivers.cdl

#

#       Intel 82559 ethernet driver

#

# ====================================================================

#####ECOSGPLCOPYRIGHTBEGIN####

## -------------------------------------------

## This file is part of eCos, the Embedded Configurable Operating System.

## Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.

## Copyright (C) 2003 Gary Thomas

##

## 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####

# ====================================================================

######DESCRIPTIONBEGIN####

#

# Author(s):      hmt

# Original data:  hmt

# Contributors:   hmt, gthomas, jskov

# Date:           2000-02-01

#

#####DESCRIPTIONEND####

#

# ====================================================================

cdl_package CYGPKG_DEVS_ETH_INTEL_I82559 {

    display       "Intel 82559 ethernet driver"

    description   "Ethernet driver for Intel 82559 controller."

    parent        CYGPKG_IO_ETH_DRIVERS

    active_if     CYGPKG_IO_ETH_DRIVERS

    active_if     CYGINT_DEVS_ETH_INTEL_I82559_REQUIRED

    implements    CYGINT_IO_ETH_MULTICAST

    include_dir   cyg/devs/eth

    # SNMP demands to know stuff; this sadly makes us break the neat

    # abstraction of the device having nothing exported.

    include_files include/i82559_info.h

    # and tell them that it is available

    define_proc {

        puts $::cdl_system_header \

       "#define CYGBLD_DEVS_ETH_DEVICE_H "

        puts $::cdl_header "#include CYGDAT_DEVS_ETH_INTEL_I82559_CFG";

    }

    compile       -library=libextras.a if_i82559.c

    cdl_option CYGDBG_DEVS_ETH_INTEL_I82559_CHATTER {

        display "Prints ethernet device status info during startup"

        flavor        booldata

        default_value 0

        description   "

            Definining this will cause the ethernet device initialization code

            to print lots of info

            to confirm that it has found the devices on the PCI bus, read

            the MAC address from EEPROM correctly, and so on, and also

            displays the mode (10/100MHz, half/full duplex) of the

            connection.  If the value is set higher than one then

            additional information about each packet sent will be printed."

    }

    cdl_option CYGNUM_DEVS_ETH_INTEL_I82559_DEV_COUNT {

        display "Number of supported interfaces."

        calculated    { CYGINT_DEVS_ETH_INTEL_I82559_REQUIRED }

        flavor        data

        description   "

            This option selects the number of PCI ethernet interfaces to

            be supported by the driver."

    }

    cdl_component CYGDBG_DEVS_ETH_INTEL_I82559_KEEP_STATISTICS {

        display "Keep Ethernet statistics"

        default_value 1

        description   "

            The ethernet device can maintain statistics about the network,

            specifically a great variety of error rates which are useful

            for network management.  SNMP for example uses this

            information.  There is some performance cost in maintaining

            this information; disable this option to recoup that."

        cdl_option CYGDBG_DEVS_ETH_INTEL_I82559_KEEP_82559_STATISTICS {

            display "Keep i82559 Internal statistics"

            default_value 1

            description   "

                The i82559 keeps internal counters, and it is possible to

                acquire these.  But the i82559 (reputedly) does not service

                the network whilst uploading the data to RAM from its

                internal registers.  If throughput is a problem, disable

                this option to acquire only those statistics gathered by

                software, so that the i82559 never sleeps."

        }

    }

    cdl_component CYGPKG_DEVS_ETH_INTEL_I82559_WRITE_EEPROM {

        display "SIOCSIFHWADDR records MAC address in EEPROM"

        default_value 0

        description   "

            The ioctl() socket call with operand SIOCSIFHWADDR sets the

            interface hardware address - the MAC address or ethernet

            address.  This option causes the new MAC address to be written

            into the EEPROM associated with the interface, so that the new

            MAC address is permanently recorded.  Doing this should be a

            carefully chosen decision, hence this option."

    }

    cdl_option CYGNUM_DEVS_ETH_INTEL_I82559_MAX_RX_DESCRIPTORS {

        display       "Maximum number of RX descriptors"

        flavor  data

        default_value { CYGPKG_REDBOOT ? 4 : 128 }

        define        MAX_RX_DESCRIPTORS

        description   "

                An RX descriptor is used for each ethernet frame required

                to be passed to the upper networking layers. This option

                sets the maximum number of these. Higher numbers use more

                memory, lower numbers will reduce performance. The system

                appears to work OK with as few as 8 descriptors but limps

                painfully with only 4. Performance is better with more than

                8, but assuming the size of non-cached (so useless for anything

                else) memory window is 1Mb, we might as well use it all.

                128 RX and TX descriptors uses the whole 1Mb, near enough."

    }

    cdl_option CYGNUM_DEVS_ETH_INTEL_I82559_MAX_TX_DESCRIPTORS {

        display       "Maximum number of TX descriptors"

        flavor  data

        default_value { CYGPKG_REDBOOT ? 4 : 128 }

        define        MAX_TX_DESCRIPTORS

        description   "

                A TX descriptor is used for each ethernet frame passed down

                from upper networking layers for transmission. This option

                sets the maximum number of these. Higher numbers use more

                memory, lower numbers will reduce performance. The system

                appears to work OK with as few as 8 descriptors but limps

                painfully with only 4. Performance is better with more than

                8, but assuming the size of non-cached (so useless for anything

                else) memory window is 1Mb, we might as well use it all.

                128 RX and TX descriptors uses the whole 1Mb, near enough."

    }

    cdl_component CYGPKG_DEVS_ETH_INTEL_I82559_OPTIONS {

        display "Intel 82559 ethernet driver build options"

        flavor  none

        no_define

        cdl_option CYGPKG_DEVS_ETH_INTEL_I82559_CFLAGS_ADD {

            display "Additional compiler flags"

            flavor  data

            no_define

            default_value { "-D_KERNEL -D__ECOS" }

            description   "

                This option modifies the set of compiler flags for

                building the Intel 82559 ethernet driver

                package. These flags are used in addition to the set of

                global flags."

        }

    }

}

# EOF intel_i82559_eth_drivers.cdl