/* sysEl3c90xEnd.c - system configuration module for el3c90xEnd driver *//* Copyright 1984-2001 Wind River Systems, Inc. *//*modification history--------------------01h,07mar02,pai  Specify pciIntConnect() as the default driver interrupt                 connect routine (SPR# 73501).01g,28nov01,pai  Added code to determine whether 32-bit NPF memory decoder is                 implemented.01f,18oct01,pai  Updated documentation and routines for new device discovery                 algorithm (SPR# 35716).01e,11oct01,bur  Added more device ids to el3c90xBrds[] for different 		 versions of 3COM 3c90x network cards.01d,01oct01,pai  Removed INCLUDE_MMU_BASIC conditional-compilation block.                 Fixed function comment-headers.01c,11sep01,hdn  replaced "irq + EXT_INTERRUPT_BASE" with INT_NUM_GET(irq)01b,12mar99, jkf renamed boardResource and pciResources to dev specific.01a,12mar99, cn  created.*//*DESCRIPTIONThis is the WRS-supplied configuration module for the VxWorksel3c90xEnd (elPci) END driver.  It has routines for initializingdevice resources and provides BSP-specific el3c90xEnd driver routinesfor 3Com EtherLink and Fast EtherLink PCI network interface cards. The number of supported devices that can be configured for a particularsystem is finite and is specified by the EL_3C90X_MAX_DEV configurationconstant found is this file.  This configuration constant, and the datastructures using it, can be modified in this file for specificimplementations.*/#if defined(INCLUDE_EL_3C90X_END)/* includes */#include "end.h"#include "drv/end/el3c90xEnd.h"/* defines *//* specify the maximum number of physical devices to configure */#define EL_3C90X_MAX_DEV        (8)#define THREECOM_PCI_VENDOR_ID   (0x10b7)   /* 3COM PCI vendor ID *//* BSP specific 3Com ethernet device type constants */#define TYPE_BOOMERANG_10BT           (1)   /* 3COM 3c900-TPO */#define TYPE_BOOMERANG_10BT_COMBO     (2)   /* 3COM 3c900-COMBO */#define TYPE_BOOMERANG_10_100BT       (3)   /* 3COM 3c905-TX */#define TYPE_BOOMERANG_100BT4         (4)   /* 3COM 3c905-T4 */#define TYPE_CYCLONE_10BT             (5)   /* 3COM 3c900B-TPO */#define TYPE_CYCLONE_10BT_COMBO       (6)   /* 3COM 3c900B-COMBO */#define TYPE_CYCLONE_10_100BT         (7)   /* 3COM 3c905B-TX */#define TYPE_CYCLONE_10_100BT4        (8)   /* 3COM 3c905B-T4 */#define TYPE_CYCLONE_10_100FX         (9)   /* 3COM 3c980-TX */#define TYPE_CYCLONE_10_100BT_SERV   (10)   /* 3COM 3c980-TX */#define TYPE_CYCLONE_10FL            (11)   /* 3COM 3c900B-FL */#define TYPE_CYCLONE_10_100_COMBO    (12)   /* 3COM 3c905B-COMBO */#define TYPE_KRAKATOA_10BT_TPC       (13)   /* 3COM 3c900B-TPC */#define TYPE_TORNADO_10_100BT        (14)   /* 3COM 3c920-TX */#define TYPE_TORNADO_10_100BT_SERV   (15)   /* 3COM 3c980-TX */#define TYPE_TORNADO_HOMECONNECT     (16)   /* 3COM Home Connect */#define TYPE_HURRICANE_SOHO100TX     (17)   /* 3COM Soho */#define EL_3C90X_END_FLAGS      (0)#define EL_3C90X_BUFF_MTPLR     (NONE)/* imports */IMPORT STATUS     sysMmuMapAdd (void * address, UINT len,                                UINT initialStateMask,                                UINT initialState);IMPORT END_OBJ *  el3c90xEndLoad (char *);IMPORT FUNCPTR    el3c90xIntConnectRtn;/* locals */LOCAL UINT32 etherLinkUnits = 0;     /* the number of physical units found *//* This string table stores English descriptions of supported devices. * TYPE_XXX device type constants index the table to get descriptions. */LOCAL const char * elDescription [] =    {    "3COM 3c90X Fast Etherlink Endhanced Network Driver."    "3COM 3c900-TPO Etherlink Endhanced Network Driver."    "3COM 3c900-COMBO Etherlink Endhanced Network Driver."    "3COM 3c905-TX Etherlink Endhanced Network Driver."    "3COM 3c905-T4 Etherlink Endhanced Network Driver."    "3COM 3c900B-TPO Etherlink Endhanced Network Driver."    "3COM 3c900B-COMBO Etherlink Endhanced Network Driver."    "3COM 3c905B-TX Etherlink Endhanced Network Driver."    "3COM 3c905B-T4 Etherlink Endhanced Network Driver."    "3COM 3c980-TX Etherlink Endhanced Network Driver."    "3COM 3c980-TX Etherlink Endhanced Network Driver."    "3COM 3c900B-FL Etherlink Endhanced Network Driver."    "3COM 3c905B-COMBO Etherlink Endhanced Network Driver."    "3COM 3c900B-TPC Etherlink Endhanced Network Driver."    "3COM 3c920-TX Etherlink Endhanced Network Driver."    "3COM 3c980-TX Etherlink Endhanced Network Driver."    "3COM 3c90X Home Connect Etherlink Endhanced Network Driver."    "3COM 3c90X Soho Etherlink Endhanced Network Driver."    };/* * This array defines the board-specific PCI resources.  Each table entry * stores this information for specific physical devices found on the system * bus.  There is a unique END unit associated with each unique physical * device recorded in this table.  The END unit number is equivalent to an * index into this table. */LOCAL PCI_BOARD_RESOURCE elPciResources [EL_3C90X_MAX_DEV] =    {    {NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    }    };/* forward declarations */LOCAL UINT32 sys3comDevToType (UINT32, UINT32, UINT8);LOCAL UINT32 sys3comMmioGet (UINT32, UINT32, UINT32);/********************************************************************************* sysEl3c90xPciInit - initialize a 3c90x PCI ethernet device** This routine performs basic PCI initialization for 3c90x PCI ethernet* devices supported by the el3c90xEnd END driver.  Parameters to this* routine specify a PCI function, including PCI ID registers, to* initialize.  If supported, the device memory and I/O addresses are* mapped into the local CPU address space and an internal board-specific* PCI resources table is updated with information on the board type,* memory address, and IO address.** CAVEATS* This routine must be performed prior to MMU initialization, usrMmuInit().* If the number of supported 3c90x physical device instances installed* on the PCI bus exceeds EL_3C90X_MAX_DEV, then the extra devices will not be* initialized in this routine.** RETURNS:* OK, or ERROR if the specified device is not supported, or if* the device could not be mapped into the local CPU memory space.*/STATUS sysEl3c90xPciInit    (    UINT32  pciBus,      /* store a PCI bus number */    UINT32  pciDevice,   /* store a PCI device number */    UINT32  pciFunc,     /* store a PCI function number */    UINT32  vendorId,    /* store a PCI vendor ID */    UINT32  deviceId,    /* store a PCI device ID */    UINT8   revisionId   /* store a PCI revision ID */    )    {    UINT32  boardType;   /* store a BSP-specific board type constant */    UINT32  ioBase;      /* IO base address (BAR 0) */    UINT32  memIo32;     /* memory-mapped IO address (BAR 1) */    UINT8   irq;         /* interrupt line number (IRQ) for device */    /* number of physical units exceeded the number supported ? */    if (etherLinkUnits >= EL_3C90X_MAX_DEV)        {        return (ERROR);        }    if ((boardType = sys3comDevToType (vendorId, deviceId, revisionId))        == BOARD_TYPE_UNKNOWN)        {        return (ERROR);        }    pciConfigInLong  (pciBus, pciDevice, pciFunc,                      PCI_CFG_BASE_ADDRESS_0, &ioBase);    ioBase &= PCI_IOBASE_MASK;    /* supported 3Com devices may or may not implement memory mapped IO */    if ((memIo32 = sys3comMmioGet (pciBus, pciDevice, pciFunc)) != NONE)        {        memIo32 &= PCI_MEMBASE_MASK;        /* map a 4Kb 32-bit non-prefetchable memory address decoder */        if (sysMmuMapAdd ((void *)(memIo32 & PCI_DEV_MMU_MSK),           PCI_DEV_ADRS_SIZE, VM_STATE_MASK_FOR_ALL, VM_STATE_FOR_PCI) == ERROR)            {            return (ERROR);            }        }    /* get the interrupt line number (IRQ) for the device */    pciConfigInByte (pciBus, pciDevice, pciFunc,                     PCI_CFG_DEV_INT_LINE, &irq);    /* update the board-specific resource table */    elPciResources[etherLinkUnits].bar[0]     = ioBase;    elPciResources[etherLinkUnits].bar[1]     = memIo32;    elPciResources[etherLinkUnits].irq        = irq;    elPciResources[etherLinkUnits].irqvec     = INT_NUM_GET (irq);    elPciResources[etherLinkUnits].vendorID   = vendorId;    elPciResources[etherLinkUnits].deviceID   = deviceId;    elPciResources[etherLinkUnits].revisionID = revisionId;    elPciResources[etherLinkUnits].boardType  = boardType;    /* enable mapped memory and IO decoders */    pciConfigOutWord (pciBus, pciDevice, pciFunc, PCI_CFG_COMMAND,                      PCI_CMD_MEM_ENABLE | PCI_CMD_IO_ENABLE |                      PCI_CMD_MASTER_ENABLE);    /* disable sleep mode */    pciConfigOutByte (pciBus, pciDevice, pciFunc, PCI_CFG_MODE,                      SLEEP_MODE_DIS);    ++etherLinkUnits;  /* increment number of units initialized */    /* Bind the driver-specific PCI interrupt connection routine. */    el3c90xIntConnectRtn = (FUNCPTR) pciIntConnect;    return (OK);    }/********************************************************************************* sysEl3c90xIntEnable - enable 3c90x ethernet device interrupts** This routine enables el3c90x interrupts.  This may involve operations on* interrupt control hardware.** RETURNS: OK or ERROR for invalid arguments.*/STATUS sysEl3c90xIntEnable    (    int    level        /* level number */    )    {    return (sysIntEnablePIC (level));    }/********************************************************************************* sysEl3c90xIntDisable - disable 3c90x ethernet device interrupts** This routine disables el3c90x interrupts.  This may involve operations on* interrupt control hardware.** RETURNS: OK or ERROR for invalid arguments.*/STATUS sysEl3c90xIntDisable    (    int    level        /* level number */    )    {    return (sysIntDisablePIC (level));    }