packages/devs/eth/mips/upd985xx/v2_0/cdl/upd985xx_eth_drivers.cdl

   1 # ====================================================================
   2 #
   3 #       upd985xx_eth_drivers.cdl
   4 #
   5 #       Ethernet drivers
   6 #       NEC uPD985xx device specific support
   7 #
   8 # ====================================================================
   9 #####ECOSGPLCOPYRIGHTBEGIN####
  10 ## -------------------------------------------
  11 ## This file is part of eCos, the Embedded Configurable Operating System.
  12 ## Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
  13 ##
  14 ## eCos is free software; you can redistribute it and/or modify it under
  15 ## the terms of the GNU General Public License as published by the Free
  16 ## Software Foundation; either version 2 or (at your option) any later version.
  17 ##
  18 ## eCos is distributed in the hope that it will be useful, but WITHOUT ANY
  19 ## WARRANTY; without even the implied warranty of MERCHANTABILITY or
  20 ## FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  21 ## for more details.
  22 ##
  23 ## You should have received a copy of the GNU General Public License along
  24 ## with eCos; if not, write to the Free Software Foundation, Inc.,
  25 ## 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
  26 ##
  27 ## As a special exception, if other files instantiate templates or use macros
  28 ## or inline functions from this file, or you compile this file and link it
  29 ## with other works to produce a work based on this file, this file does not
  30 ## by itself cause the resulting work to be covered by the GNU General Public
  31 ## License. However the source code for this file must still be made available
  32 ## in accordance with section (3) of the GNU General Public License.
  33 ##
  34 ## This exception does not invalidate any other reasons why a work based on
  35 ## this file might be covered by the GNU General Public License.
  36 ##
  37 ## Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
  38 ## at http://sources.redhat.com/ecos/ecos-license/
  39 ## -------------------------------------------
  40 #####ECOSGPLCOPYRIGHTEND####
  41 # ====================================================================
  42 ######DESCRIPTIONBEGIN####
  43 #
  44 # Author(s):      hmt
  45 # Original data:  hmt
  46 # Contributors:   gthomas
  47 # Date:           2001-06-28
  48 #
  49 #####DESCRIPTIONEND####
  50 #
  51 # ====================================================================
  52
  53 cdl_package CYGPKG_DEVS_ETH_MIPS_UPD985XX {
  54     display       "NEC uPD985xx ethernet driver"
  55
  56     parent        CYGPKG_IO_ETH_DRIVERS
  57     active_if     CYGPKG_IO_ETH_DRIVERS
  58     active_if     CYGPKG_HAL_MIPS_UPD985XX
  59
  60     implements    CYGHWR_NET_DRIVER_ETH0
  61
  62     implements    CYGHWR_NET_DRIVERS
  63     include_dir   cyg/devs/eth
  64
  65     description   "Ethernet driver for NEC uPD985xx devices."
  66     compile       -library=libextras.a if_upd985xx.c
  67
  68     cdl_option CYGDBG_DEVS_ETH_MIPS_UPD985XX_CHATTER {
  69         display "Prints ethernet device status info during startup"
  70         default_value 0
  71         description   "
  72             The ethernet device initialization code can print lots of info
  73             to confirm that it has booted correctly."
  74     }
  75
  76     cdl_option CYGNUM_DEVS_ETH_MIPS_UPD985XX_DEV_COUNT {
  77         display "Number of supported interfaces."
  78         #legal_values  1
  79         #default_value 1
  80         calculated 1
  81         flavor        data
  82         description   "
  83             This option selects the number of ethernet interfaces to
  84             be supported by the driver."
  85     }
  86
  87     cdl_component CYGPKG_DEVS_ETH_MIPS_UPD985XX_ETH0 {
  88         display       "Ethernet port 0 driver"
  89         flavor        bool
  90         calculated 1
  91         description   "
  92             This option includes the ethernet device driver for
  93             port 0 - that is the only connector
  94             depending on your particular hardware."
  95
  96
  97         cdl_option CYGDAT_DEVS_ETH_UPD985XX_ETH0_NAME {
  98             display       "Device name for the ethernet port 0 driver"
  99             flavor        data
 100             default_value {"\"eth0\""}
 101             description   "
 102                 This option sets the name of the ethernet device for the
 103                 ethernet port 0."
 104         }
 105
 106         cdl_component CYGSEM_DEVS_ETH_UPD985XX_ETH0_SET_ESA {
 107             display       "Set the ethernet station address"
 108             flavor        bool
 109             default_value false
 110             requires      !CYGSEM_DEVS_ETH_UPD985XX_ETH0_GET_EEPROM_ESA
 111             description   "Enabling this option will allow the ethernet
 112             station address to be forced to the value set by the
 113             configuration.  This may be required if the hardware does
 114             not include a serial EEPROM for the ESA."
 115
 116             cdl_option CYGDAT_DEVS_ETH_UPD985XX_ETH0_ESA {
 117                 display       "The ethernet station address"
 118                 flavor        data
 119                 default_value {"{0x00, 0xBA, 0xCA, 0xDD, 0x1E, 0xDD}"}
 120                 description   "The ethernet station address"
 121             }
 122         }
 123
 124         cdl_option CYGSEM_DEVS_ETH_UPD985XX_ETH0_GET_EEPROM_ESA {
 125             display       "Get the ethernet station address from EEPROM"
 126             flavor        bool
 127             default_value !CYGSEM_DEVS_ETH_UPD985XX_ETH0_SET_ESA
 128             requires      !CYGSEM_DEVS_ETH_UPD985XX_ETH0_SET_ESA
 129             description   "Enabling this option will allow the ethernet
 130             station address to be read from a serial EEPROM (such as 93C06,
 131             93C46...).  If this is not valid, your application must set the
 132             ESA manually via an ioctl() call or similar."
 133         }
 134     }
 135
 136     cdl_component CYGPKG_DEVS_ETH_MIPS_UPD985XX_OPTIONS {
 137         display "NEC uPD985xx ethernet driver build options"
 138         flavor  none
 139         no_define
 140
 141         cdl_option CYGPKG_DEVS_ETH_MIPS_UPD985XX_CFLAGS_ADD {
 142             display "Additional compiler flags"
 143             flavor  data
 144             no_define
 145             default_value { "-D_KERNEL -D__ECOS" }
 146             description   "
 147                 This option modifies the set of compiler flags for
 148                 building the NEC uPD985xx ethernet driver
 149                 package. These flags are used in addition to the set of
 150                 global flags."
 151         }
 152     }
 153
 154     cdl_component CYGPKG_DEVS_ETH_MIPS_UPD985XX_HARDWARE_BUGS {
 155         display       "Workarounds for Ethernet Hardware bugs "
 156         flavor        bool
 157         default_value 1
 158         description   "
 159         This component controls whether code workarounds for the numerous
 160         hardware bugs in the uPD98503 Ethernet device are included.
 161         These might not all be necessary depending on the speed and mode in
 162         which the interface is used.  Please refer to the manufacturer's
 163         Behaviour Analysis Report to make your decision about which of
 164         these options to enable or disable.
 165         The default is to enable all workarounds for best reliability."
 166
 167         cdl_option CYGOPT_DEVS_ETH_MIPS_UPD985XX_HARDWARE_BUGS_S1 {
 168             display       "S1 - CPU to IBUS write restriction"
 169             flavor        bool
 170             default_value 1
 171             description   "Enable a workaround for hardware bug S1"
 172         }
 173         cdl_component CYGOPT_DEVS_ETH_MIPS_UPD985XX_HARDWARE_BUGS_E1E2 {
 174             display       "E1,E2 - Status queue corruption and MAC filtering"
 175             flavor        bool
 176             default_value 1
 177             description   "Enable a workaround for hardware bugs E1 and/or E2."
 178
 179             cdl_option CYGOPT_DEVS_ETH_MIPS_UPD985XX_HARDWARE_BUGS_E1E2_E2ONLY {
 180                 display   "Do not set device in promisc mode - solve E2 only"
 181                 flavor    bool
 182                 default_value 1
 183                 description   "Work around bug E2 only - do not set the device
 184                                in promiscuous mode by default.
 185                                Setting this option prevents the work around
 186                                for bug E1."
 187             }
 188         }
 189         cdl_option CYGOPT_DEVS_ETH_MIPS_UPD985XX_HARDWARE_BUGS_E3 {
 190             display       "E3 - Transmit descriptor error"
 191             flavor        bool
 192             default_value 1
 193             description   "Enable a workaround for hardware bug E3"
 194
 195         }
 196         cdl_option CYGOPT_DEVS_ETH_MIPS_UPD985XX_HARDWARE_BUGS_E8 {
 197             display       "E8 - Transmission error under abnormal conditions"
 198             flavor        bool
 199             default_value 1
 200             description   "Enable a workaround for hardware bug E8"
 201         }
 202     }
 203 }
 204
 205 # EOF upd985xx_eth_drivers.cdl