©Copyright 1998-2012 Marvell®. All rights reserved.
yukondg.htm created 20-Mar-2012
Readme File for YUKONDG.EXE v6.61.3.3
Diagnostics Utility for the
Marvell Yukon Ethernet Adapter Family
This file contains
This README file explains how to use the program YUKONDG.EXE to test
your network adapter or to maintain the Flash PROM contents of the adapter.
Section 2 contains a list of all network adapters that are supported by
the diagnostics program.
Section 3 describes the command line options that can be used when
starting the diagnostics program.
Section 4 explains how to use the diagnostics program to test your network
adapter.
Section 5 explains how to use the repeater mode.
Section 6 describes the test result messages.
The program YUKONDG.EXE supports the Marvell Yukon Ethernet Adapter Family.
The following two lists show the optional parameters supported by YUKONDG.EXE.
To obtain a list of all available command line options, type:
YUKONDG -?
OPTIONS THAT SPECIFY THE NETWORK ADAPTER TO BE TESTED
-----------------------------------------------------
-b <bus> PCI bus number
-d <dev> PCI device number of the network adapter
-y <YYYY> Additional PCI vendor ID to search for
-z <ZZZZ> Additional PCI device ID to search for
OPTION THAT CHECKS THE ADAPTER'S CHIP ID AND REVISION
-----------------------------------------------------
-v <ID:<id>&R:<rev>[-<rev>][+ID:<id>&R:<rev>[-<rev>]]>
OPTIONS THAT SPECIFY THE TESTS TO BE PERFORMED
----------------------------------------------
-? Display this help screen.
-l List all network adapters installed.
-t <seconds> Set a time limit (in seconds).
-o <file> Generate an output file with the specified name.
-x Use an output file with the name based on the MAC address.
CAUTION: Use the following options only if instructed by service personnel!
-a Change into advanced operation mode.
-f Suspend advanced tests on error (script file is mandatory).
-r Perform tests for all found adapters in advanced mode
(script and output file parameters are mandatory).
-c <file> Use script file (LOM/NIC, -m overwrites -c for NIC).
-m <file> Use script file (NIC only, tests on LOM are skipped).
-p <file> Use parameter file.
-i Invoke Boot Code Patch Tool.
NOTE: The file name <file> is limited to 13 characters.
In order to increase test coverage the program tries to use more memory for
DMA purposes (it can be instructed to do so with the command line option -Mx).
The program uses XMS to allocate such memory, which is located above 1 MB. For
this to work it needs a rather current version of an XMS 3.0 memory manager.
Combinations that work:
- MS-DOS v6.22 + HIMEM.SYS v3.95 (from Windows 98)
- MS-DOS v6.22 + HimemX.exe v3.24 (from FreeDOS)
EMM386 should not be loaded.
To test your adapter, proceed as follows:
1. Start the DOS-based utility program YUKONDG.EXE using any of
the available options to correctly specify the network adapter,
if required.
NOTE: The options '-b', and '-d' may be combined as required to
exactly specify the network adapter which is to be tested.
All specified options are checked against the list of network adapters.
To display a list of all installed Marvell Yukon Ethernet
adapters, use the '-l' option.
2. Select the test you want to perform.
There are four (three) test modes available:
- "Diagnostics"
- "Loopb. Wrap Plug"
- "Loopb. ext. Repeater"
- "Loopb. Port to Port" (available for dual-port adapters only)
"Diagnostics":
Select this option if no wrap plug or port-to-port loopback
cable is available.
"Loopb. Wrap Plug":
To run tests in this mode, wrap plug(s) must be installed
before the test is started.
NOTE: Wrap plugs are not available for all copper-based adapters.
Instead, use another station in repeater mode.
For further information on the repeater mode, refer to the
next section.
"Loopb. ext. Repeater":
To run tests in this mode, another station must be connected
back-to-back to the test station with diagnostics software started
and running in repeater mode before the test is started.
NOTE: Ensure the adapter in the repeater station meets the
speed requirement (10/100/1000 Mbps) of the device under test.
NOTE: To run this test on a dual-port adapter, both ports must be
connected to the different test stations in repeater mode
before the test is started.
"Loopb. Port to Port":
To run tests in this mode, both ports of one dual-port adapter
must be connected through a cable before this test is started.
NOTE: Single-port adapters cannot be tested in this mode.
To display additional information about the network adapter,
two options are available:
- "Show Configuration"
- "Show Sensors"
"Show Configuration":
Displays the configuration of the network adapter.
"Show Sensors":
Displays the sensor values of the network adapter.
3. To maintain your flash PROM contents, select the menu item
"Flash PROM ...".
The flash PROM menu will be displayed. Here, you can
- save your flash PROM contents to a file
("Save Flash PROM to File")
- write a file into the flash PROM (max. size 124 kB)
("Load Flash PROM from File")
- display the boot code version
("Display Boot Code Version")
- erase the first sector of the flash PROM to delete the boot code,
if existent ("Clear Boot Code")
4. To maintain the Vital Product Data (VPD) contents, select the menu item
"VPD Data ...".
The VPD menu will be displayed. Here, you can
- display the adapter's VPD
("Display VPD Data")
- clear error log entries
("Clear Error Logs")
- modify the adapter's VPD
("Add/Modify VPD Data")
- remove VPD keywords
("Delete VPD Keywords")
NOTE: During the adapter tests, the diagnostics program must have
exclusive rights to use the network adapter to be tested.
All drivers running on the adapter will be stopped!
The repeater mode is intended to simulate a 'wrap plug' when
1000BASE-T adapters without 'wrap plug' support are tested.
To run a "Loopb. Wrap Plug" test, the device under test
must be connected to an adapter running in repeater mode before
the test is started.
Although the repeater mode is also available for fiber adapters, it is
not recommended to perform loopback tests with a repeater station,
because the link establishment for fiber adapters is different
and not fully implemented in the diagnostics loopback tests.
To enable repeater mode, proceed as follows:
1. From the main menu, select "Repeater Mode".
2. Select a port number.
The repeater window is displayed. All incoming frames except pause frames
are looped on the transmit side without modifications.
The following table shows the configuration parameters and
statistics counters displayed in the repeater mode window.
Parameter/Counter Start Value Description
---------------------------------------------------------------------------
Link State Down Indicates the link state (down
or up). If up, frames can be
received and transmitted.
---------------------------------------------------------------------------
Link Master/Slave Slave Indicates if the adapter is
Config working as master or slave.
This parameter is only supported
for 1000BASE-T adapters.
---------------------------------------------------------------------------
Link Estimate 1E-15 Indicates the estimated link
error rate.
The parameter is only supported
for 1000BASE-T adapters.
---------------------------------------------------------------------------
Link Changes 0 Counts the number of link
status changes since the
repeater mode started.
---------------------------------------------------------------------------
False Carrier 0 Counts the number of false
Sense Counter carrier sense signals occurred
since the repeater mode started.
This counter is only valid for
1000BASE-T adapters.
---------------------------------------------------------------------------
FCS Errors 0 Counts the number of Frame Check
Sequence (FCS) errors occurred
since the last link status
change.
---------------------------------------------------------------------------
Frames Received 0 Counts the number of received
frames. Received pause frames
are ignored.
---------------------------------------------------------------------------
Frames Transmitted 0 Counts the number of transmitted
frames. Transmitted pause frames
are ignored.
---------------------------------------------------------------------------
Pause Frames Received 0 Counts the number of received
pause frames.
---------------------------------------------------------------------------
Pause Frames 0 Counts the number of transmitted
Transmitted pause frames.
---------------------------------------------------------------------------
Received Overflows 0 Counts the number of received
overflow events.
---------------------------------------------------------------------------
If no error occurs, the diagnostics program exits with code 0 and displays
the DOS screen message "Test Result: PASSED". In case of an error, the exit
code is not 0, the message displayed is "Test Result: FAILED", and a short
description of the last error is given.
*** End of Readme File ***