1. diag_obj_source.zip Driver
2. Readme.txt File Contents

Readme.txt Driver File Contents (diag_obj_source.zip)

National Semiconductor Corporation
DP83815/816 diagnostic program version 4.6


1. Running the diag.exe utility

To run the diag.exe utility, type ‘diag’ at the DOS prompt to invoke the
following menu or type a batch file command (see details below the menu) at the
DOS prompt to override the menu.


WELCOME to DIAG.EXE version: 4.6

USAGE: DIAG [B] <test> [option]

DIAG B <test> [option] - for use of DIAG in batch mode.
	G    Go to Next NIC.
	E    Initialize EEPROM with Default Values.
	C[M/V/D] [macAddress] Change MAC/subVendor/subDevice ID.
	M [# of packets]   Master mode.
	S    Slave mode.
	L[M/P/X]   Mac/Phy/eXternal loopback test
	T [# of packets]   Transmit test packet(s)
	R    Receive test packet(s)
	D[N/P/E] Display NIC/PCI/EEPROM Registers.
	P[M/L/S [macAddress]] Pwr Mgmt WakeOn MgkPkt/Link/Send MgkPkt.
	Q    QUIT utility.


Examples of batch file commands:

    C:\diag b cm 10 10 22 01 02 03
    The ‘c’ in this batch file command allows the user to
    re-program the MAC (Media Access Controller)
    address to any value - in this example it was changed
    to 10 10 22 01 02 03.

    C:\diag b cm 10 10 22 01 02 03 > outfile.txt
    This batch file command changes the MAC address as
    well as writes the results to the outfile.txt file.


2. Description of diag.exe utility menu choices (in interactive mode)

B: Entry made on the command line to signify Batch Mode (not used in
   Interactive mode).

G: Select the NIC to operate on.
   
E: Initializes the EEPROM with the following default values:
   * eeprom 0 d008 # subsystem vendor
   * eeprom 1 0400 # subsys id
   * eeprom 2 2cd0 # min gnt, max lat
   * eeprom 3 cf82 # config stuff
   * eeprom 4 0000 # secure on pw stuff
   * eeprom 5 0000 # secure on pw stuff
   * eeprom 6 000n # LSb is part of Ethernet ID
   * eeprom 7 nnnn # Ethernet ID
   * eeprom 8 nnnn # Ethernet ID
   * eeprom 9 nnnn # Ethernet ID
   * eeprom a a098
   * eeprom b xx55 # checksum
   
CM: Change MAC (Media Access Controller) address
   The command CM allows the user to program a MAC (Media Access Controller)
   address for the device to any 6-byte value.

   Note:    This address, in a ‘real’ network interface application would be
            factory programmed with a unique value within a range of addresses
            that would have been assigned to the manufacturer by the IEEE,
            Registration Authority Committee (RAC).

   Caution: Should this device be put on a LAN or WAN, there is the possibility,
            although remote, of address conflict.
            
CV: Change subsystem vendor ID
   The command CV allows the user to program a subsystem vendor ID for the
   device to any 2-byte value. Valid vendor IDs are allocated by the PCI SIG
   (Special Interest Group) to ensure uniqueness.
   
CD: Change subsystem device ID
   The command CD allows the user to program a subsystem device ID for the
   device to any 2-byte value. This ID is allocated by the vendor.
   
   Note: After the user has changed the subsystem vendor ID or device ID, they
         may find the EEPROM offset 0 & 1 values and the PCI configuration
         register offset 2C (CFGSID) value are different. This is because
         offset 0 & 1 value in EEPROM is not directly mapped into the subsystem
         ID value, and the diag progarm will handle the conversion for the user.

M: Master mode
   In Master mode, the device sends a user a chosen number of PING packets as
   well as receives (and prints to screen) the return message(s). The outputs
   may be redirected to a file using the DOS ‘>’ symbol and the resulting file
   analyzed for errors, etc.
   
   Note: A second device, running in Slave mode is required for this test, and
         is useful for testing two devices connected together.
         
S: Slave mode
   In Slave mode, the device responds to data received from the Master mode and
   prints to screen. The outputs may be redirected to a file using the DOS ‘>’
   symbol and the resulting file analyzed for errors, etc.
   
   Note: A second device, running in Master mode is required for this test, and
         is useful for testing two devices connected together.
   
LM: MAC loopback test
   The MAC (Media Access Controller) loopback test loops the signals from a
   transmit block back into a receive block.
   
LP: PHY loopback test
   The PHY (physical) loopback test internally connects the outputs of the
   transmitter and receiver sections while disconnecting these sections from
   the output pins. This allows testing of all internal data paths up to, but
   not including, the transmitter and receiver output sections (pins).
   
LX: External loopback test
   The External loopback is the most complete test. It tests all blocks
   including the connector by connecting the output and input paths of the MAC
   just before the physical layer (transmitter-receiver). A loopback fixture is
   used to conduct this test. The loopback fixture must be plugged into the
   Ethernet 10/100 BaseT connector prior to running this test.

T: Transmit
   The Transmit mode transmits packets until stopped by a control C, entered by
   the user. Since there is no data received in the Transmit mode, there is no
   data printed on the screen or redirected to a disk file.
   
R: Receive
   The Receive mode receives PING packets and displays them to the screen. The
   results of this command may be redirected to a disk file for later analysis.
   
DN: Display NIC Registers
   Allows the user to view the internal NIC registers.

DP: Display PCI Configuration Space
   Allows the user to view the PCI bus interface registers.

DE: Display EEPROM Contents
   If an external EEPROM is installed, the DE command allows the user to view
   the internal registers.
   
PM: Power Management Test Mode - Magic Packet
   This Power Management mode sets the DP83815 into a power-down mode until a
   ‘magic packet’ is seen. A magic packet is a frame that is addressed to the
   DP83815 controller and contains a data sequence anywhere in its data field
   made up of 16 consecutive copies of the device's MAC address.

PL: Power Management Test Mode - Link Change
   This Power Management mode sets the DP83815 into a power-down mode while
   waiting for activity on the Link.

PS: Power Management Test Mode - Send Magic Packet
   Allows the user to send magic packet to another device with the given MAC
   address.

Q: Quit Utility
   Returns to the DOS prompt.


3. The diag.exe program can be used as a EEPROM burning utility by running
   burn.bat. When E command is used in batch mode, diag.exe will read three
   files as input to program EEPROM - eeprom.txt, macaddr.txt and subsysid.txt.
   Just put the subsystem ID's in it's original form in subsysid.txt, you don't
   need to convert it to the format required by DP83815/816.