/* sysLn97xEnd.c - system configuration module for AMD 79C97x END driver */ /* Copyright 1984-2001 Wind River Systems, Inc. *//*modification history--------------------01d,11oct01,pai  Now using VM_STATE_MASK_FOR_ALL and VM_STATE_FOR_PCI in                 sysMmuMapAdd call.  Updated documentation and routines                 for new device discovery algorithm (SPR# 35716).01c,09oct01,pai  Corrected variable usage in sysLn97xEndLoad and                 sysLan97xPciInit.  Conditionally compile PCI_DEV_MMU_MSK                 and PCI_DEV_ADRS_SIZE.01b,05oct01,pai  Removed inaccurate commentary in sysLan97xPciInit().01a,02oct01,pai  Written from sysNetif.  Implemented a new BSP driver load                 routine that processes multiple physical devices and END                 units.  This replaces sysLan97xInitStrCook (SPR #35716).*//*DESCRIPTIONThis is the WRS-supplied configuration module for the VxWorksln97xEnd (lnPci) END driver.  It initializes device resources andprovides BSP-specific ln97xEnd driver routines for any Am79C970A,Am79C971, Am79C972, and Am79C973 PCnet-PCI ethernet devices found onthe system.The number of supported devices that can be configured for a particularsystem is finite and is specified by the LN97X_MAX_DEV configurationconstant in this file.  This value, and the internal data structuresusing it, can be modified in this file for specific implementations.*/#if defined(INCLUDE_LN_97X_END)/* namespace collisions */#undef CSR  /* redefined in ln97xEnd.h (temporary fix) *//* includes */#include "end.h"#include "drv/end/ln97xEnd.h"/* defines *//* specify the maximum number of physical devices to configure */#define LN97X_MAX_DEV           (8)/* AMD 79C97x 10/100Base-TX PCI Ethernet Board Types */#define AMD_PCI_VENDOR_ID       (0x1022)  /* AMD PCI vendor ID */#define LN97X_PCI_VENDOR_ID     (0x1022)  /* AMD PCI vendor ID */#define LN97X_PCI_DEVICE_ID     (0x2000)  /* Am79c97x device ID */#define LN970_PCI_REV_MASK      (0x10)    /* Am79c970A PCI rev mask */#define LN971_PCI_REV_MASK      (0x20)    /* Am79c971  PCI rev mask */#define LN972_PCI_REV_MASK      (0x30)    /* Am79c972  PCI rev mask */#define LN973_PCI_REV_MASK      (0x40)    /* Am79c973  PCI rev mask *//* LN_TYPE_97x values are equivalent to (LN97x_PCI_REV_MASK >> 4) */#define LN_TYPE_970             (1)       /* Am97c970A PCNet-PCI II */#define LN_TYPE_971             (2)       /* Am97c971  PCNet-Fast   */#define LN_TYPE_972             (3)       /* Am97c972  PCNet-Fast+  */#define LN_TYPE_973             (4)       /* Am97c973  PCNet-Fast III *//* driver configuration flags *//* The <offset> parameter specifies the offset from which a packet has * to be loaded from the beginning of a device buffer.  Normally, this * parameter is zero except for architectures which access long words * only on aligned addresses.  For these architectures, the value of * this <offset> should be 2. */#define LN97X_OFFS_VALUE        (0)       /* driver <offset> value */#define LN97X_CSR3_VALUE        (0)       /* CSR3 register value */#define LN97X_RSVD_FLAGS        (0)       /* driver <flags> value *//* imports */IMPORT STATUS    sysMmuMapAdd (void * address, UINT len,                               UINT initialStateMask,                               UINT initialState);IMPORT END_OBJ * ln97xEndLoad (char *);/* locals */ LOCAL int ln97XUnits = 0;  /* the number of physical units found *//* This string table stores English descriptions of supported devices. * LN_TYPE_97x values index the table to obtain board descriptions. */LOCAL const char * ln97xStrDesc [] =    {    "AMD 79C97x PCI Enhanced Network Driver",    "AMD Am79C970A PCnet-PCI II Enhanced Network Driver",    "AMD Am79C971 PCnet-FAST Enhanced Network Driver",    "AMD Am79C972 PCnet-FAST+ Enhanced Network Driver",    "AMD Am79C973 PCnet-FAST III Enhanced Network Driver"    };/* * This array defines the board-specific PCI resources.  There is one * unique END unit associated with one unique physical device recorded * in this table.  The END unit number is equivalent to an index into * this table. */ LOCAL PCI_BOARD_RESOURCE ln97xPciResources [LN97X_MAX_DEV] =    {    {NONE, NONE, NONE, AMD_PCI_VENDOR_ID, LN97X_PCI_DEVICE_ID,     LN970_PCI_REV_MASK, LN_TYPE_970, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, AMD_PCI_VENDOR_ID, LN97X_PCI_DEVICE_ID,     LN970_PCI_REV_MASK, LN_TYPE_970, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, AMD_PCI_VENDOR_ID, LN97X_PCI_DEVICE_ID,     LN970_PCI_REV_MASK, LN_TYPE_970, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, AMD_PCI_VENDOR_ID, LN97X_PCI_DEVICE_ID,     LN970_PCI_REV_MASK, LN_TYPE_970, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, AMD_PCI_VENDOR_ID, LN97X_PCI_DEVICE_ID,     LN970_PCI_REV_MASK, LN_TYPE_970, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, AMD_PCI_VENDOR_ID, LN97X_PCI_DEVICE_ID,     LN970_PCI_REV_MASK, LN_TYPE_970, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, AMD_PCI_VENDOR_ID, LN97X_PCI_DEVICE_ID,     LN970_PCI_REV_MASK, LN_TYPE_970, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    },    {NONE, NONE, NONE, AMD_PCI_VENDOR_ID, LN97X_PCI_DEVICE_ID,     LN970_PCI_REV_MASK, LN_TYPE_970, NONE, NONE,    {NONE, NONE, NONE, NONE, NONE, NONE}, NULL    }    };/* forward declarations */LOCAL UINT32 sysLn97xDev2Type (UINT32, UINT32, UINT8);/******************************************************************************** sysLn97xEndLoad - construct a load string and load an Am79C97x device** This routine will be invoked by the MUX for the purpose of loading* an Am79C97x (lnPci) device with initial parameters.  This routine is* constructed as an interface wrapper for the driver load routine.* Thus, the arguments and return values are consistent with any* xxxEndLoad() routine defined for an END driver and the MUX API.** INTERNAL* The muxDevLoad() operation calls this routine twice.  A zero length* <pParamStr> parameter string indicates that this is the first time* through this routine.  The driver load routine should return the* driver name in <pParamStr>.** On the second pass though this routine, the initialization parameter* string is constructed.  Note that on the second pass, the <pParamStr>* consists of a colon-delimeted END device unit number and rudimentary* initialization string (often empty) constructed from entries in the* BSP END Device Table such that:**     <pParamStr> = "<unit>:<default initialization string>"** In the process of building the rest of <pParamStr>, the prepended unit* number must be preserved and passed to the driver load routine.  The* <default initialization string> portion mentioned above is discarded,* but future versions of this routine may use it.** The complete ln97xEnd driver load string has format:**     <unit>:<devMemAddr>:<devIoAddr>:<pciMemBase:<vecNum>:<intLvl>:*     <memAdrs>:<memSize>:<memWidth>:<csr3b>:<offset>:<flags>** RETURNS: An END object pointer, or NULL on error, or 0 and the name of the* device if the <pParamStr> was NULL.** SEE ALSO: ln97xEndLoad()*/END_OBJ * sysLn97xEndLoad    (    char *      pParamStr,   /* pointer to initialization parameter string */    void *      unused       /* unused optional argument */    )    {    END_OBJ *   pEnd;    char        paramStr [END_INIT_STR_MAX];    static const char * const paramTemplate =         "%d:0x%x:0x%x:0x%x:%d:%d:-1:-1:-1:0x%x:%d:0x%x:%p";    /* alias local PCI and board resource table addresses */    PCI_BOARD_RESOURCE * const pciRsrc = ln97xPciResources;    if (strlen (pParamStr) == 0)        {        /* PASS (1)         * The driver load routine returns the driver name in <pParamStr>.         */        pEnd = ln97xEndLoad (pParamStr);        }    else        {        /* PASS (2)         * The END <unit> number is prepended to <pParamStr>.  Construct         * the rest of the driver load string based on physical devices         * discovered in sysLan97xPciInit().  When this routine is called         * to process a particular END <unit> number, use the END <unit>         * as an index into the PCI "resources" table to build the driver         * parameter string.         */        int    typeIdx;   /* index to the string resource table */        char * holder  = NULL;        int    endUnit = atoi (strtok_r (pParamStr, ":", &holder));        /* is there a PCI resource associated with this END unit ? */        if (endUnit >= ln97XUnits)            {            /* This is an error - no physical devs available to this unit */            return NULL;            }        /* construct an index into the string resource table */        typeIdx = (pciRsrc[endUnit].boardType);        /* construct the initialization parameter string */        sprintf (paramStr, paramTemplate,                 endUnit,                     /* END unit number */                 pciRsrc[endUnit].bar[1],     /* memory-mapped IO base */                 pciRsrc[endUnit].bar[0],     /* IO address space base */                 PCI2DRAM_BASE_ADRS,          /* host PCI mem. base */                 pciRsrc[endUnit].irqvec,     /* IRQ vector */                 pciRsrc[endUnit].irq,        /* IRQ number */                 LN97X_CSR3_VALUE,            /* csr3 register value */                 LN97X_OFFS_VALUE,            /* offset */                 LN97X_RSVD_FLAGS,            /* flags (reserved) */                 &ln97xStrDesc[typeIdx]       /* device description */                );        if ((pEnd = ln97xEndLoad (paramStr)) == (END_OBJ *) NULL)            {            printf ("Error sysLn97xEndLoad: device failed.\n");            }        }    return (pEnd);    }/********************************************************************************* sysLn97xDev2Type - convert a PCI Revision ID to a board type** Given <vendorId>, <deviceId>, and <revisionId> values read from PCI* configuration space, this routine will attempt to map the ID to a board