sysln97xend.c

VMware上运行vxWorks的BSP

/* 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).
*/

/*
DESCRIPTION
This is the WRS-supplied configuration module for the VxWorks
ln97xEnd (lnPci) END driver.  It initializes device resources and
provides BSP-specific ln97xEnd driver routines for any Am79C970A,
Am79C971, Am79C972, and Am79C973 PCnet-PCI ethernet devices found on
the system.

The number of supported devices that can be configured for a particular
system is finite and is specified by the LN97X_MAX_DEV configuration
constant in this file.  This value, and the internal data structures
using 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 "ln97xEnd.h"			/* modify by frank */


/* 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 */
                 NONE, /* pciRsrc[endUnit].bar[1],   modify by frank */  /* 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
* type value defined in this file.
*
* INTERNAL
* The PCI Vendor and Device IDs are the same for all driver supported
* Am79c97x devices.  When an instance is located, the PCI Revision ID is