Back to Contents

BCM570x Diagnostic User's Guide

This chapter provides the following information:

Introduction

Prerequisites

Diagnostic Tests

Command Line Option Parameters

EEPROM.txt Format

User Interface Commands

Special Instructions

Test and Functions Description

Introduction

This program runs in two modes: Manufacturing mode and Engineering mode. The mode is determined with the command line option or the configuration file. When the program is running in manufacturing mode, it starts to run all tests in the configuration. If it detects an error, it displays an error and exits the program. When the program is in engineering mode, it prompts user to enter commands. The commands are explained in the later chapters. This document provides the information on configuration file specification, command line options and engineering diagnostic commands on Broadcom NetXtreme™ Gigabit Ethernet adapter, in particular to check out the functionality of the BCM5700 and its related components.

In general, this program has a set of default configuration. It is overwritten by configuration file. The command line option overwrites both default and the configuration files.

Back to Top

Prerequisites

The engineering diagnostic is executed under DOS protected mode, this requires dos4gw.exe to be placed in the same directory of the b57diag.exe.

OS: Dos 6.22

Software: b57diag.exe, dos4gw.exe, and cpu.bin.

Input File List: The following files should be found in the same location of the b57diag.exe.

ctrlreg.txt (mac registers test input file)

ctrlreg.reg (mac registers input file for engineering mode)

mac_pref.txt (mac address prefix number input file)

miireg.txt (mii registers test input file)

miireg.reg (mii registers input file for engineering mode)

pcicfg.reg (PCI configuration registers input file for engineering mode)

vpdwrite.txt (write vpd input file)

seprg.txt (program SEEPROM input file)

physcript.txt (Phy speed select)

wol.txt (Power Down MAC pattern input file)

firmware.bin (TX & RX CPUs Firmware file)

eeprom.bin (Serial EEPROM config input file)

cpu.bin (CPU test)

Output File List:

The following files will be generated in run time.

diagcfg.bin

b57diag.log

Back to Top

Diagnostic Tests

The tests are divided into four groups: Register Tests, Memory Tests, Miscellaneous Tests, and Data Tests. They numbered as group ‘A’, ‘B’, ‘C’, and ‘D’.

Test Names

Group A.

A1. Indirect Register Test
A2. Control Register Test
A3. BIST
A4. Interrupt Test

Groupt B.

B1. Scratch Pad Test
B2. BD SRAM Test
B3. DMA SRAM Test
B4. MBUF SRAM Test
B5. External SRAM Test
B6. MBUF SRAM via DMA Test
B7. MBUF Special Test

Group C.

C1. EEPROM Test
C2. CPU Test
C3. DMA Test
C4. MII Test
C5. VPD Test
C6. ASF Test

Group D.

D1. Mac Loopback Test
D2. Phy Loopback Test
D3. RJ45 Loopback Test

 

Error Codes

Code	Message
1.		Got 0x%08x @ 0x%08x. Expected 0x%08x
2.		Cannot run test while chip is running
3. 		Invalid NIC device
4. 		Read only bit %s got changed after writing zero at offset 0x%X
5. 		Read only bit %s got changed after writing 1's at offset 0x%X
6. 		Read/Write bit %s did not get cleared after writing zero at offset 0x%X
7. 		Read/Write bit %s did not get set after writing 1's at offset 0x%X
8. 		BIST failed
9. 		Could not generate interrupt
10.  	Test aborted by user
11. 	Tx DMA:Got 0x%08x @ 0x%08x. Expected 0x%08x    
12. 	Rx DMA:Got 0x%08x @ 0x%08x. Expected 0x%08x    
13.		Tx DMA failed
14. 	Rx DMA failed
15.		Data error, got 0x%08X at 0x%08X, expected 0x%08X
16. 	Second read error, got 0x%08X at 0x%08X, expected 0x%08X
17.		Failed writing EEPROM at 0x%04X
18. 	Failed reading EEPROM at 0x%04X
19. 	EEPROM data error, got 0x08X at 0x04X, expected 0x%08X
20. 	Cannot open file %s
21. 	Invalid CPU image file %s
22. 	Invalid CPU image size %d
23. 	Cannot allocate memory
24. 	Cannot reset CPU   
25. 	Cannot release CPU 
26. 	CPU test failed       
27. 	Invalid Test Address Range	
		Valid NIC address is 0x%08x-0x%08x and exclude 0x%08x-0x%08x
28. 	DMA:Got 0x%08x @ 0x%08x. Expected 0x%08x 
29. 	Unsupported PhyId %04X:%04X
30. 	Too many registers specified in the file, max is %d
31. 	Cannot write to VPD memory
32. 	VPD data error, got %08X @ 0x04X, expected %08X
33. 	No good link! Check Loopback plug
34. 	Cannot TX Packet!
35. 	Requested to Tx %d. Only %d is transmitted       
36. 	Expected %d packets. Only %d good packets are received
		%d unknown packets have been received.
		%d bad packets have been received.
37. 	%c%d is an invalid Test
38 		EEPROM checksum error
39 		Error in reading WOL/PXE
40 		Error in writing WOL/PXE
41 		No external memory detected
42 		DMA buffer %04X is large, size must be less than %04X
43 		File size %d is too big, max is %d
44 		Invalid %s
45 		Failed writing 0x%x to 0x%x
46 		*1
47 		*1
48 		*1
49 		*1
50 		Cannot perform task while chip is not running. (need driver)
51 		Cannot open register define file or content is bad
52 		ASF Reset bit did not self-cleared
53 		ATTN_LOC %d cannot be mapped to %cX CPU event bit %d
54 		%s Regsiter is not cleared to zero after reset
55 		Cannot start poll_ASF Timer
56 		poll_ASF bit did not get reset after acknowleged
57 		Timestamp Counter is not counding
58 		%s Timer is not working
59 		Cannot clear bit %s in %cX CPU event register
60 		Invalid "EEPROM_FILENAME" file size, expected %d but only can read %d bytes
61 		Invalid magic value in %s, expected %08x but found %08x
62 		Invalid manufature revision, expected %c but found %c
63 		Invalid Boot Code revision, expected %d.%d but found %d.%d
64 		Cannot write to EEPROM
65 		Cannot read from EEPROM
66 		Invalid Checksum
67 		Invalid Magic Value
68 		Invalid MAC address, expected %02X-%02X-%02X-%02X-%02X-%02X
69 		Slot error, expected an UUT to be found at location %02X:%02X:00
70 		Adjacent memory has been corrupted while testing block 0x%08x-0x%08x 
		Got 0x%08x @ address 0x%08x. Expected 0x%08x

*1 Internal Use. Program will not generate this error. 

Test Descriptions

A1. Indirect Register Test

Command: regtest -i

Function: Using indirect addressing method, writing increment data into MAC hash Register table and read back for verification. The memory read/write is done 100 times while increment test data.

Default: Test Enabled

A2. Control Register Test

Command: regtest

Function: Each Register specified in the configuration contents read only bit and read/write bit defines. The test writing zero and one into the test bits to insure the read only bits are not changed, and read/write bits are changed accordingly.

Default: Test Enabled.

Default Register table

The test will try to read the register configuration file ‘ctrlreg.txt’ for the register defines. If the file does not exist a default register offset and mask bits will be used.

Offset     R/O Mask   R/W Mask
0x00000400 0x00000000 0x007fff8c
0x00000404 0x03800107 0x00000000
0x00000408 0x00000000 0x07c01400
0x0000040c 0x00000000 0xc000007f
0x00000410 0x00000000 0x0000ffff
0x00000414 0x00000000 0xffffffff
0x00000418 0x00000000 0x0000ffff
0x0000041c 0x00000000 0xffffffff
0x00000420 0x00000000 0x0000ffff
0x00000424 0x00000000 0xffffffff
0x00000428 0x00000000 0x0000ffff
0x0000042c 0x00000000 0xffffffff
0x00000430 0x00000000 0xffffffff
0x00000434 0x00000000 0x0fffffff
0x0000043c 0x00000000 0x0000ffff
0x00000440 0x00000000 0x001fffff
0x00000444 0x00000000 0x0000ffff
0x00000448 0x0000ffff 0x00000000
0x0000044c 0x00000000 0x0fffffff
0x00000450 0x00000000 0x00000001
0x00000454 0x00000000 0x00008013
0x00000458 0x00000000 0x00000000
0x0000045c 0x00000000 0x00000070
0x00000460 0x00000009 0x00000000
0x00000464 0x00000000 0x00003fff
0x00000468 0x00000000 0x000007fc
0x0000046c 0x00000001 0x00000000
0x00000470 0x00000000 0xffffffff
0x00000474 0x00000000 0xffffffff
0x00000478 0x00000000 0xffffffff
0x0000047c 0x00000000 0xffffffff
0x00000480 0x00000000 0xffffffff
0x00000484 0x00000000 0xffffffff
0x00000488 0x00000000 0xffffffff
0x0000048c 0x00000000 0xffffffff
0x00000490 0x00000000 0xffffffff
0x00000494 0x00000000 0xffffffff
0x00000498 0x00000000 0xffffffff
0x0000049c 0x00000000 0xffffffff
0x000004a0 0x00000000 0xffffffff
0x000004a4 0x00000000 0xffffffff
0x000004a8 0x00000000 0xffffffff
0x000004ac 0x00000000 0xffffffff
0x000004b0 0x00000000 0xffffffff
0x000004b4 0x00000000 0xffffffff
0x000004b8 0x00000000 0xffffffff
0x000004bc 0x00000000 0xffffffff
0x000004c0 0x00000000 0xffffffff
0x000004c4 0x00000000 0xffffffff
0x000004c8 0x00000000 0xffffffff
0x000004cc 0x00000000 0xffffffff
0x000004d0 0x00000000 0xffffffff
0x000004d4 0x00000000 0xffffffff
0x000004d8 0x00000000 0xffffffff
0x000004dc 0x00000000 0xffffffff
0x000004e0 0x00000000 0xffffffff
0x000004e4 0x00000000 0xffffffff
0x000004e8 0x00000000 0xffffffff
0x000004ec 0x00000000 0xffffffff
0x000004f0 0x00000000 0xffffffff
0x000004f4 0x00000000 0xffffffff
0x000004f8 0x00000000 0xffffffff
0x000004fc 0x00000000 0xffffffff
0x00000500 0x00000000 0x000000f8
0x00000c00 0x00000000 0x00000006
0x00000c04 0x00000004 0x00000000
0x00000c08 0x00000000 0x00000003
0x00000c0c 0x00000000 0x00ffffff
0x00000c80 0xffffffff 0x00000000
0x00000c84 0xffffffff 0x00000000
0x00000c88 0xffffffff 0x00000000
0x00000c8c 0xffffffff 0x00000000
0x00000c90 0xffffffff 0x00000000
0x00000c94 0xffffffff 0x00000000
0x00000c98 0xffffffff 0x00000000
0x00000c9c 0xffffffff 0x00000000
0x00000ca0 0xffffffff 0x00000000
0x00000ca4 0xffffffff 0x00000000
0x00000ca8 0xffffffff 0x00000000
0x00000cac 0xffffffff 0x00000000
0x00000cb0 0xffffffff 0x00000000
0x00000cb4 0xffffffff 0x00000000
0x00000cb8 0xffffffff 0x00000000
0x00000cbc 0xffffffff 0x00000000
0x00000cc0 0xffffffff 0x00000000
0x00000cc4 0xffffffff 0x00000000
0x00000cc8 0xffffffff 0x00000000
0x00000ccc 0xffffffff 0x00000000
0x00000cd0 0xffffffff 0x00000000
0x00000cd4 0xffffffff 0x00000000
0x00000cd8 0xffffffff 0x00000000
0x00000cdc 0xffffffff 0x00000000
0x00001000 0x00000000 0x00000002
0x00001400 0x00000000 0x00000006
0x00001404 0x00000004 0x00000000
0x00001408 0x0000ffff 0x00000000
0x00001440 0x0000000f 0x00000000
0x00001444 0x0000000f 0x00000000
0x00001448 0x0000000f 0x00000000
0x0000144c 0x0000000f 0x00000000
0x00001450 0x0000000f 0x00000000
0x00001454 0x0000000f 0x00000000
0x00001458 0x0000000f 0x00000000
0x0000145c 0x0000000f 0x00000000
0x00001460 0x0000000f 0x00000000
0x00001464 0x0000000f 0x00000000
0x00001468 0x0000000f 0x00000000
0x0000146c 0x0000000f 0x00000000
0x00001470 0x0000000f 0x00000000
0x00001474 0x0000000f 0x00000000
0x00001478 0x0000000f 0x00000000
0x0000147c 0x0000000f 0x00000000
0x00001800 0x00000000 0x00000006
0x00001804 0x00000004 0x00000000
0x00001808 0xffffffff 0x00000000
0x0000180c 0xffffffff 0x00000000
0x00001810 0xffffffff 0x00000000
0x00001814 0xffffffff 0x00000000
0x00001818 0xffffffff 0x00000000
0x0000181c 0xffffffff 0x00000000
0x00001820 0xffffffff 0x00000000
0x00001824 0xffffffff 0x00000000
0x00001828 0xffffffff 0x00000000
0x0000182c 0xffffffff 0x00000000
0x00001830 0xffffffff 0x00000000
0x00001834 0xffffffff 0x00000000
0x00001838 0xffffffff 0x00000000
0x0000183c 0xffffffff 0x00000000
0x00001840 0xffffffff 0x00000000
0x00001844 0xffffffff 0x00000000
0x00001c00 0x00000000 0x00000002
0x00002000 0x00000000 0x0000001e
0x00002004 0x0000001c 0x00000000
0x0000200c 0xffffffff 0x00000000
0x00002010 0x00000000 0x00003fff
0x00002014 0x00000000 0x00000003
0x00002100 0xffffffff 0x00000000
0x00002104 0xffffffff 0x00000000
0x00002108 0xffffffff 0x00000000
0x00002110 0xffffffff 0x00000000
0x00002114 0xffffffff 0x00000000
0x00002118 0xffffffff 0x00000000
0x00002120 0xffffffff 0x00000000
0x00002124 0xffffffff 0x00000000
0x00002128 0xffffffff 0x00000000
0x00002130 0xffffffff 0x00000000
0x00002134 0xffffffff 0x00000000
0x00002138 0xffffffff 0x00000000
0x00002140 0xffffffff 0x00000000
0x00002144 0xffffffff 0x00000000
0x00002148 0xffffffff 0x00000000
0x00002150 0xffffffff 0x00000000
0x00002154 0xffffffff 0x00000000
0x00002158 0xffffffff 0x00000000
0x00002160 0xffffffff 0x00000000
0x00002164 0xffffffff 0x00000000
0x00002168 0xffffffff 0x00000000
0x00002170 0xffffffff 0x00000000
0x00002174 0xffffffff 0x00000000
0x00002178 0xffffffff 0x00000000
0x00002180 0xffffffff 0x00000000
0x00002184 0xffffffff 0x00000000
0x00002188 0xffffffff 0x00000000
0x00002190 0xffffffff 0x00000000
0x00002194 0xffffffff 0x00000000
0x00002198 0xffffffff 0x00000000
0x000021a0 0xffffffff 0x00000000
0x000021a4 0xffffffff 0x00000000
0x000021a8 0xffffffff 0x00000000
0x000021b0 0xffffffff 0x00000000
0x000021b4 0xffffffff 0x00000000
0x000021b8 0xffffffff 0x00000000
0x000021c0 0xffffffff 0x00000000
0x000021c4 0xffffffff 0x00000000
0x000021c8 0xffffffff 0x00000000
0x000021d0 0xffffffff 0x00000000
0x000021d4 0xffffffff 0x00000000
0x000021d8 0xffffffff 0x00000000
0x000021e0 0xffffffff 0x00000000
0x000021e4 0xffffffff 0x00000000
0x000021e8 0xffffffff 0x00000000
0x000021f0 0xffffffff 0x00000000
0x000021f4 0xffffffff 0x00000000
0x000021f8 0xffffffff 0x00000000
0x00002200 0x000003ff 0x00000000
0x00002204 0x000003ff 0x00000000
0x00002208 0x000003ff 0x00000000
0x0000220c 0x000003ff 0x00000000
0x00002210 0x000003ff 0x00000000
0x00002214 0x000003ff 0x00000000
0x00002218 0x000003ff 0x00000000
0x0000221c 0x000003ff 0x00000000
0x00002220 0x000003ff 0x00000000
0x00002224 0x000003ff 0x00000000
0x00002228 0x000003ff 0x00000000
0x0000222c 0x000003ff 0x00000000
0x00002230 0x000003ff 0x00000000
0x00002234 0x000003ff 0x00000000
0x00002238 0x000003ff 0x00000000
0x0000223c 0x000003ff 0x00000000
0x00002240 0x000003ff 0x00000000
0x00002244 0x000003ff 0x00000000
0x00002248 0x000003ff 0x00000000
0x0000224c 0x000003ff 0x00000000
0x00002250 0x000003ff 0x00000000
0x00002254 0x000003ff 0x00000000
0x00002258 0x000003ff 0x00000000
0x00002400 0x00000000 0x0000001e
0x00002404 0x0000001c 0x00000000
0x00002408 0x00000000 0x0000ffff
0x00002440 0x00000000 0xffffffff
0x00002444 0x00000000 0xffffffff
0x0000244c 0x00000000 0xffffffff
0x00002450 0x00000000 0xffffffff
0x00002454 0x00000000 0xffffffff
0x0000245c 0x00000000 0xffffffff
0x00002460 0x00000000 0xffffffff
0x00002464 0x00000000 0xffffffff
0x0000246c 0x00000000 0xffffffff
0x00002470 0xffffffff 0x00000000
0x00002474 0xffffffff 0x00000000
0x00002478 0xffffffff 0x00000000
0x00002480 0xffffffff 0x00000000
0x00002484 0xffffffff 0x00000000
0x00002488 0xffffffff 0x00000000
0x0000248c 0xffffffff 0x00000000
0x00002490 0xffffffff 0x00000000
0x00002494 0xffffffff 0x00000000
0x00002498 0xffffffff 0x00000000
0x0000249c 0xffffffff 0x00000000
0x000024a0 0xffffffff 0x00000000
0x000024a4 0xffffffff 0x00000000
0x000024a8 0xffffffff 0x00000000
0x000024ac 0xffffffff 0x00000000
0x000024b0 0xffffffff 0x00000000
0x000024b4 0xffffffff 0x00000000
0x000024b8 0xffffffff 0x00000000
0x000024bc 0xffffffff 0x00000000
0x000024c0 0xffffffff 0x00000000
0x00002800 0x00000000 0x00000002
0x00002c00 0x00000000 0x00000004
0x00002c04 0x00000004 0x00000000
0x00002c14 0x00000000 0xffffffff
0x00002c18 0x00000000 0xffffffff
0x00002c1c 0x00000000 0xffffffff
0x00003000 0x00000000 0x00000006
0x00003004 0x00000004 0x00000000
0x00003008 0x00000000 0x0000000f
0x0000300c 0x00000000 0x0000001f
0x00003010 0x00000000 0x0000003f
0x00003400 0x00000000 0x00000004
0x00003404 0x00000004 0x00000000
0x00003800 0x00000000 0x00000006
0x00003804 0x00000004 0x00000000
0x00003c00 0x00000000 0x00000002
0x00003c04 0x00000004 0x00000000
0x00003c08 0x00000000 0xffffffff
0x00003c0c 0x00000000 0xffffffff
0x00003c10 0x00000000 0xffffffff
0x00003c14 0x00000000 0xffffffff
0x00003c18 0x00000000 0xffffffff
0x00003c1c 0x00000000 0xffffffff
0x00003c20 0x00000000 0xffffffff
0x00003c24 0x00000000 0xffffffff
0x00003c28 0x00000000 0xffffffff
0x00003c30 0x00000000 0xffffffff
0x00003c34 0x00000000 0xffffffff
0x00003c38 0x00000000 0xffffffff
0x00003c3c 0x00000000 0xffffffff
0x00003c40 0xffffffff 0x00000000
0x00003c44 0xffffffff 0x00000000
0x00003c80 0x00000000 0x000007ff
0x00003c84 0x00000000 0x000007ff
0x00003c88 0x00000000 0x000007ff
0x00003c8c 0x00000000 0x000007ff
0x00003c90 0x00000000 0x000007ff
0x00003c94 0x00000000 0x000007ff
0x00003c98 0x00000000 0x000007ff
0x00003c9c 0x00000000 0x000007ff
0x00003ca0 0x00000000 0x000007ff
0x00003ca4 0x00000000 0x000007ff
0x00003ca8 0x00000000 0x000007ff
0x00003cac 0x00000000 0x000007ff
0x00003cb0 0x00000000 0x000007ff
0x00003cb4 0x00000000 0x000007ff
0x00003cb8 0x00000000 0x000007ff
0x00003cbc 0x00000000 0x000007ff
0x00003cc0 0x00000000 0x000001ff
0x00003cc4 0x00000000 0x000001ff
0x00003cc8 0x00000000 0x000001ff
0x00003ccc 0x00000000 0x000001ff
0x00003cd0 0x00000000 0x000001ff
0x00003cd4 0x00000000 0x000001ff
0x00003cd8 0x00000000 0x000001ff
0x00003cdc 0x00000000 0x000001ff
0x00003ce0 0x00000000 0x000001ff
0x00003ce4 0x00000000 0x000001ff
0x00003ce8 0x00000000 0x000001ff
0x00003cec 0x00000000 0x000001ff
0x00003cf0 0x00000000 0x000001ff
0x00003cf4 0x00000000 0x000001ff
0x00003cf8 0x00000000 0x000001ff
0x00003cfc 0x00000000 0x000001ff
0x00004000 0x00000000 0x03fffffe
0x00004004 0x00000000 0x00000000
0x00004008 0x00000000 0x001fffff
0x0000400c 0x00000000 0x001fffff
0x00004400 0x00000000 0x00000000
0x00004404 0x00000014 0x00000000
0x00004408 0x00000000 0x007fffff
0x0000440c 0x00000000 0x007fffff
0x00004410 0x00000000 0x0000ffff
0x00004414 0x00000000 0x0000ffff
0x00004418 0x00000000 0x0000ffff
0x0000441c 0x00000000 0x0000ffff
0x00004420 0xffffffff 0x00000000
0x00004424 0x00000000 0x0000ffff
0x00004428 0xffffffff 0x00000000
0x0000442c 0xffffffff 0x00000000
0x00004430 0xffffffff 0x00000000
0x00004434 0x00000000 0x000001ff
0x00004438 0x00000000 0x000001ff
0x00004440 0xffffffff 0x00000000
0x00004448 0xffffffff 0x00000000
0x0000444c 0xffffffff 0x00000000
0x00004450 0xffffffff 0x00000000
0x00004454 0xffffffff 0x00000000
0x00004800 0x00000000 0x000003fc
0x00004804 0x00000000 0x00000000
0x00004c00 0x00000000 0x000003fc
0x00004c04 0x000003fc 0x00000000
0x00005800 0x00000000 0xffffffff
0x00005804 0x00000000 0xffffffff
0x00005808 0x00000000 0xffffffff
0x0000580c 0x00000000 0xffffffff
0x00005810 0x00000000 0xffffffff
0x00005814 0x00000000 0xffffffff
0x00005818 0x00000000 0xffffffff
0x0000581c 0x00000000 0xffffffff
0x00005820 0x00000000 0xffffffff
0x00005824 0x00000000 0xffffffff
0x00005828 0x00000000 0xffffffff
0x0000582c 0x00000000 0xffffffff
0x00005830 0x00000000 0xffffffff
0x00005834 0x00000000 0xffffffff
0x00005838 0x00000000 0xffffffff
0x0000583c 0x00000000 0xffffffff
0x00005840 0x00000000 0xffffffff
0x00005844 0x00000000 0xffffffff
0x00005848 0x00000000 0xffffffff
0x0000584c 0x00000000 0xffffffff
0x00005850 0x00000000 0xffffffff
0x00005854 0x00000000 0xffffffff
0x00005858 0x00000000 0xffffffff
0x0000585c 0x00000000 0xffffffff
0x00005860 0x00000000 0xffffffff
0x00005864 0x00000000 0xffffffff
0x00005868 0x00000000 0xffffffff
0x0000586c 0x00000000 0xffffffff
0x00005870 0x00000000 0xffffffff
0x00005874 0x00000000 0xffffffff
0x00005878 0x00000000 0xffffffff
0x0000587c 0x00000000 0xffffffff
0x00005880 0x00000000 0xffffffff
0x00005884 0x00000000 0xffffffff
0x00005888 0x00000000 0xffffffff
0x0000588c 0x00000000 0xffffffff
0x00005890 0x00000000 0xffffffff
0x00005894 0x00000000 0xffffffff
0x00005898 0x00000000 0xffffffff
0x0000589c 0x00000000 0xffffffff
0x000058a0 0x00000000 0xffffffff
0x000058a4 0x00000000 0xffffffff
0x000058a8 0x00000000 0xffffffff
0x000058ac 0x00000000 0xffffffff
0x000058b0 0x00000000 0xffffffff
0x000058b4 0x00000000 0xffffffff
0x000058b8 0x00000000 0xffffffff
0x000058bc 0x00000000 0xffffffff
0x000058c0 0x00000000 0xffffffff
0x000058c4 0x00000000 0xffffffff
0x000058c8 0x00000000 0xffffffff
0x000058cc 0x00000000 0xffffffff
0x000058d0 0x00000000 0xffffffff
0x000058d4 0x00000000 0xffffffff
0x000058d8 0x00000000 0xffffffff
0x000058dc 0x00000000 0xffffffff
0x000058e0 0x00000000 0xffffffff
0x000058e4 0x00000000 0xffffffff
0x000058e8 0x00000000 0xffffffff
0x000058ec 0x00000000 0xffffffff
0x000058f0 0x00000000 0xffffffff
0x000058f4 0x00000000 0xffffffff
0x000058f8 0x00000000 0xffffffff
0x000058fc 0x00000000 0xffffffff
0x00005900 0x00000000 0xffffffff
0x00005904 0x00000000 0xffffffff
0x00005908 0x00000000 0xffffffff
0x0000590c 0x00000000 0xffffffff
0x00005910 0x00000000 0xffffffff
0x00005914 0x00000000 0xffffffff
0x00005918 0x00000000 0xffffffff
0x0000591c 0x00000000 0xffffffff
0x00005920 0x00000000 0xffffffff
0x00005924 0x00000000 0xffffffff
0x00005928 0x00000000 0xffffffff
0x0000592c 0x00000000 0xffffffff
0x00005930 0x00000000 0xffffffff
0x00005934 0x00000000 0xffffffff
0x00005938 0x00000000 0xffffffff
0x0000593c 0x00000000 0xffffffff
0x00005940 0x00000000 0xffffffff
0x00005944 0x00000000 0xffffffff
0x00005948 0x00000000 0xffffffff
0x0000594c 0x00000000 0xffffffff
0x00005950 0x00000000 0xffffffff
0x00005954 0x00000000 0xffffffff
0x00005958 0x00000000 0xffffffff
0x0000595c 0x00000000 0xffffffff
0x00005960 0x00000000 0xffffffff
0x00005964 0x00000000 0xffffffff
0x00005968 0x00000000 0xffffffff
0x0000596c 0x00000000 0xffffffff
0x00005970 0x00000000 0xffffffff
0x00005974 0x00000000 0xffffffff
0x00005978 0x00000000 0xffffffff
0x0000597c 0x00000000 0xffffffff
0x00005980 0x00000000 0xffffffff
0x00005984 0x00000000 0xffffffff
0x00005988 0x00000000 0xffffffff
0x0000598c 0x00000000 0xffffffff
0x00005990 0x00000000 0xffffffff
0x00005994 0x00000000 0xffffffff
0x00005998 0x00000000 0xffffffff
0x0000599c 0x00000000 0xffffffff
0x000059a0 0x00000000 0xffffffff
0x000059a4 0x00000000 0xffffffff
0x000059a8 0x00000000 0xffffffff
0x000059ac 0x00000000 0xffffffff
0x000059b0 0x00000000 0xffffffff
0x000059b4 0x00000000 0xffffffff
0x000059b8 0x00000000 0xffffffff
0x000059bc 0x00000000 0xffffffff
0x000059c0 0x00000000 0xffffffff
0x000059c4 0x00000000 0xffffffff
0x000059c8 0x00000000 0xffffffff
0x000059cc 0x00000000 0xffffffff
0x000059d0 0x00000000 0xffffffff
0x000059d4 0x00000000 0xffffffff
0x000059d8 0x00000000 0xffffffff
0x000059dc 0x00000000 0xffffffff
0x000059e0 0x00000000 0xffffffff
0x000059e4 0x00000000 0xffffffff
0x000059e8 0x00000000 0xffffffff
0x000059ec 0x00000000 0xffffffff
0x000059f0 0x00000000 0xffffffff
0x000059f4 0x00000000 0xffffffff
0x000059f8 0x00000000 0xffffffff
0x000059fc 0x00000000 0xffffffff
0x00005a04 0x00000000 0xffffffff
0x00005a0c 0x00000000 0xffffffff
0x00005c10 0x00000000 0x00000005
0x00005c14 0xffffffff 0x00000000
0x00005c24 0xffffffff 0x00000000
0x00005c34 0xffffffff 0x00000000
0x00005c44 0xffffffff 0x00000000
0x00005c54 0xffffffff 0x00000000
0x00005c64 0xffffffff 0x00000000
0x00005c74 0xffffffff 0x00000000
0x00005c84 0xffffffff 0x00000000
0x00005c94 0xffffffff 0x00000000
0x00005ca4 0xffffffff 0x00000000
0x00005cb4 0xffffffff 0x00000000
0x00005cc4 0xffffffff 0x00000000
0x00005cd4 0xffffffff 0x00000000
0x00005ce4 0xffffffff 0x00000000
0x00005cf4 0xffffffff 0x00000000
0x00005d04 0xffffffff 0x00000000
0x00005d14 0xffffffff 0x00000000
0x00006000 0x00000000 0x0000007e
0x00006400 0x00000000 0x00000002
0x00006800 0x00000000 0xfffffff7
0x00006804 0x0001e000 0x00000ffe
0x00006808 0x00000000 0x03ffc008

A3. BIST

Command: bist

Function: Hardware Built-In-Self-Test (BIST). This test initiates BIST, and wait for the test result returned by hardware.

Default: Due to the intermittent failure, this test is currently disabled by default

A4. Interrupt Test

Command: intrtest

Function: This test verifies the interrupt functionality. It enables interrupt and waits for interrupt to occur. It waits for 500ms and reports error if could not generate interrupts.

Default: Enabled

B1. Scratch Pad Test

Command: memtest -s

Function: This test tests the scratch pad SRAM on board. The following tests are performed:

Data Pattern Test: Write test data into SRAM, read back to ensure data is correct. The test data used is 0x00000000, 0xffffffff, 0xaa55aa55, and 0x55aa55aa.

Alternate Data Pattern Test: Write test data into SRAM. Write complement test data into next address. Read back both data to insure the data is correct. After the test, the program reads back data one more time to insure the data stays correct. The test data used is 0x00000000, 0xffffffff, 0xaa55aa55, and 0x55aa55aa.

Address Test: Write each address with unique increment data. Read back data to insure data is correct. After fill the entire data with the unique data, the program reads back data again to insure data stays the same.

WalkingOne bit Test: For each address. Data one is written and read back for testing. Then shift the data left one bit, so the data becomes two and do the same test again. It repeats for 32 times until the test bit is shifted out of test data. The same is test is repeated for entire test range.

Pseudo Random Data Test: A pre-calculated pseudo random data is used to write a unique data into each test RAM. After the first pass the test, the program reads back one more time to insure data stays correct.

Default: Enabled

B2. BD SRAM Test

Command: memtest -b

Function: This test tests the BD SRAM. This performs exact the same way of testing as described in B1. Scratch Pad Test.

Default: Enabled

B3. DMA SRAM Test

Command: memtest -d

Function: It tests DMA SRAM by performing the tests described in test B1. The Scratch Pad Test.

Default: Enabled

B4. MBUF SRAM Test

Command: memtest -m

Function: It tests DMA SRAM by performing the tests described in test B1. The Scratch Pad Test.

Default: Enabled

B5. External SRAM Test

Command: memtest -e

Function: It tests DMA SRAM by performing the tests described in test B1. The Scratch Pad Test.

Default: Disabled

B6. MBUF SRAM via DMA Test

Command: memtest -x

Function: Eight test pattern data are used in the test. They are described below. A 0x1000 sized data buffer is used for this test. Before each pattern test, the buffer is initialized and filled with the test pattern. It then, performs size 0x1000 transmit DMA from host buffer to NIC MBUF memory. Verify the data integrity in MBUF against host memory and repeat the DMA for the entire MBUF buffer. Then it performs receive DMA from NIC to host. The 0x1000-byte test buffer is cleared to zero before each receive-DMA. Verify the data integrity and test is repeated for the entire MBUF SRAM range.

Test Pattern	Description
"16 00's 16 FF's"	Full the entire host DMA buffer with 16 bytes of 00’s and then 16 bytes of FF’s.
"16 FF's 16 0's"	Full the entire host DMA buffer with 16 bytes of 00’s and then 16 bytes of FF’s.
"32 00's 32 FF's"	Full the entire host DMA buffer with 32 bytes of 00’s and then 32 bytes of FF’s.
"32 FF's 32 00's"	Full the entire host DMA buffer with 32 bytes of FF’s and then 32 bytes of 00’s.
"00000000's"	Full the entire host DMA buffer with all zeros.
"FFFFFFFF's"	Full the entire host DMA buffer with all FF’s.
"AA55AA55's"	Full the entire host DMA buffer with data 0xAA55AA55.
"55AA55AA's"	Full the entire host DMA buffer with data 0xAA55AA55.

Default: Enabled

B7. MBUF Special Test

Command: memtest –c

Function: Initially, full up the entire test block with the inverted test pattern. Then, for every 128-byte boundary, rewrite the test pattern. Verify all test memories contains the correct test data, as it should be.

Default: Disabled

C1. EEPROM Test

Command: setest

Function: An increment test data is used in EEPROM test. It fills the test data into the test range and read back to verity the content. After the test, it fills data with zero to clear the memory.

Default: Enabled

C2. CPU Test

Command: cputest

Function: This test opens the file cpu.bin. If file exists and content is good, it loads code to rx and tx CPU and verifies CPU execution.

Default: Enabled

C3. DMA Test

Command: dmatest

Function: Both high and low priorities DMA are tested. It moves data from host memory to NIC SRAM, verifies data, and then moves data back to host memory again to verify data.

Default: Enabled

C4. MII Test

Command: miitest

Function: The function is identical to A2. Control Register Test. Each Register specified in the configuration contents read only bit and read/write bit defines. The test writing zero and one into the test bits to insure the read only bits value are not changed, and read/write bits are changed accordingly.

Default: Test Enabled.

Default Register table

The test will try to read the register configuration file ‘miireg.txt’ for the register defines. If the file does not exists, the following table is used:

Offset 		R/O Mask	R/W Mask
0x00 		0x0000 		0x7180 
0x02 		0xffff 		0x0000 
0x03 		0xffff 		0x0000 
0x04 		0x0000 		0xffff 
0x05 		0xefff 		0x0000 
0x06 		0x0001 		0x0000 
0x07 		0x0800 		0xb7ff 
0x08 		0xffff 		0x0000 
0x09 		0x0000 		0xff00 
0x0a 		0x7c00 		0x0000 
0x10 		0x0000 		0xffbf 
0x11 		0x3300 		0x0000 
0x19 		0x001f 		0x0000 
0x1e 		0x0000 		0xffff 
0x1f 		0x0000 		0xffff 

C5. VPD Test

Command: vpdtest

Function: It saves the content of VPD first before perform the test. Once it is done, it writes one of the five pattern test data, 0xff, 0xaa, 0x55, increment data, or decrement data, into VPD memory. By default, increment data pattern is used. It writes and reads back the data for the entire test range, and then restores the original content.

Default: Disabled

C6. ASF Test

1. Reset test.

   Setting reset bit, poll for self-clearing. Verify reset value of registers.

2. Event Mapping Test

   Setting SMB_ATTN bit. By changing ASF_ATTN LOC bits, verify the mapping bits in TX_CPU or RX_CPU event bits.

3. Counter Test

D1. Mac Loopback Test

Command: pkttest -m

Function: This is internal loopback data transmit/receive test. It initializes MAC into internal loopback mode, and transmits 100 packets. The data should be routed back to receive channel and receive by the receive routine, which verifies the integrity of data. One Giga bit rate is used for this test.

Default: Enabled

D2. Phy Loopback Test

Command: pkttest -p

Function: This test is same as D1. Mac Loopback Test except, the data is routed back via physical layer device. One Giga bit rate is used for this test.

Default: Enabled

D3. RJ45 Loopback Test

Back to Top

Command Line Option Parameters

When user invoke this program, a set of option parameter can be used to overwrite the configuration file or the default configuration. This section summarizes the options. The options are case sensitive.

-c <num> specify UUT device number

When more than one device is in the system, the devices are number starting from zero. For example, if there is three devices detected, the device is numbered as 0,1,and 2. In this case, by entered the parameter –c 2 will select the last found device as default UUT.

In manufacture testing mode, by default, all devices are tested; however, if this option is used, only that selected device is tested.

Example: -c 2

-coe Continue on error

Enter this option will allow the test to continue even if with error. The software will reset the iteration value as well as the error code.

Example: -coe

-l <file> log file

All diagnostic output can be saved in a log file. Type log file name is specified by this option. The default is no log file.

Example: -l mylogfile.txt

-w enable WOL programming in manufacture mode

After a successful manufacturing testing, the program will program WOL to either enable or disable mode. By default, the WOL is programmed as disable. By entering this option will enable WOL.

When –f is entered, software uses eeprom.bin’s content for WOL setting.

When –w is entered with –f, software forces WOL enabled.

Example: -w

-x enable PXE in manufacture mode

After a successful manufacturing testing, the program will program PXE to either enable or disable mode. By default, the PXE is programmed as disable. By entering this option will enable PXE.

When –f is entered, software uses eeprom.bin’s content for PXE setting.

When –x is entered with –f, software forces PXE enabled.

Example: -x

-t <id> disable test

-T <id> enable test

A certain test is enabled or disabled by default. User can overwrite the enabling status by those options. The test id must start with a letter ‘A’, ‘B’, ‘C’, or ‘D’ to indication the group and followed by test numbers. Each digit of number represents the sub-test number. For example, if the user wants to disable test A1 and A3. The option –t A13 should be entered. If no test numbers entered, all tests in that group are selected. For the tests not specified, the default setting will be used.

Example -t A15BC1 -T C4 -t D2

This disables A1, A5, B1, B2, B3, B4, B5, B6, C1, D2 and enables C4

Default Setting:

Enabled Tests:

A1. Indirect Register Test
A2. Control Register Test
A4. Interrupt Test
B1. Scratch Pad Test
B2. BD SRAM Test
B3. DMA SRAM Test
B4. MBUF SRAM Test
B6. MBUF SRAM via DMA Test
C1. EEPROM Test
C1. CPU Test
C2. DMA Test
C3. MII Test
D1. Mac Loopback Test
D2. Phy Loopback Test

Disabled Tests:

A3. BIST
B5. External SRAM Test
C4. VPD Test
C6. ASF Test
D3. RJ45 Loopback Test

-I <num> iteration number

Use this option to specify the number of times the tests to be run. The default is run one time. A number zero indicates loop forever. A control-C or control-break key can be used to break the loop. Any error detected will also stop testing after reporting the error.

Example: -I 5

Run tests five times.

-ver display current version number

If this option is entered, it displays the software version number/silkscreen revision and then exits the program.

-srev display internal silicon version number

If this option is entered, it displays the software version number/silicon version and then exits the program.

-e <code> Encryption Code

This option is required to use option -geneep, –f, -m, –n, and -s.

-geneep Generate eeprom.bin file from eeprom.txt

A password is needed to run this option. With this option, it updates eeprom.bin with the specifications defined in eeprom.txt.

Keywords	Argument
MAC_PREFIX	Three 8-bit hex numbers separated by column
POWER_DISSIPATED	Four decimal number ranges 0 to 255 separated by column
POWER_CONSUMED	Four decimal number ranges 0 to 255 separated by column
SUBSYSTEM_VENDOR_ID	A 16-bit hex number
SUBSYSTEM_DEVICE_ID	A 16-bit hex number
PXE	Disable or Enable
PXE_SPEED	Auto, 10hd, 10fd, 100hd, 100fd, 1000hd or 1000fd
WOL	Disable or Enable
PRODUCT_NAME	Max. 64-byte string
PART_NUMBER	Max. 11-byte string
ENGINEERING_CHANGE	Max. 10-byte string
MANUFACTURING_ID	A 16-bit hex number
ASSET_TAG	Max. 16-byte string
VOLTAGE_SOURCE	1.3 or 1.8
FORCE_PCI	Disable or Enable

Example of eeprom.txt

MAC_PREFIX	= 00:10:18
POWER_DISSIPATED	= 10:0:0:100
POWER_CONSUMED	= 10:0:0:100
SUBSYSTEM_VENDOR_ID	= 14e4
SUBSYSTEM_DEVICE_ID	= 1644
PXE	= Disable
PXE_SPEED	= Auto
WOL	= Disable
PRODUCT_NAME	= Broadcom Gigabit Ethernet Controller
PART_NUMBER	= BCM95700A6
ENGINEERING_CHANGE	= 107070-16
MANUFACTURING_ID	= 14e4
ASSET_TAG	= XYZ01234567
VOLTAGE_SOURCE	= 1.3
FORCE_PCI	= Disabled

 

-bus bb:dd Test UUT location

If this option is specified, the program will only test the UUT at the specified bus number and device number. This option is ignored if –c option is entered.

-dpmi Use DPMI memory allocation

Use DPMI memory allocation method to allocate memory instead of malloc() or free()

-f Program eeprom.bin

This option requires the file eeprom.bin in the same working directory. The program programs the content into EEPROM before testing.

-m Program MAC address

If this option is entered, the program will prompt user for a new MAC address before starts testing. Prompt user for the MAC address. With this option, user must enter/scan the MAC address before testing. The program also checks for the file "mac_pref.txt" This is a text file should contain six digits of ASCII MAC three-byte-prefix address. Any of the following formats are supported:

Example:

001018

00 10 18

00

10

18

If this file exists, user has option to enter/scan 7 digit hex number. The first digit will be ignored and the last 6 digits will be used for the lower part of MAC address. Combine with the prefix, it creates 6 byte (12 digit) hex number. If this file does not exist, the whole 12-digit number must be entered for the MAC address. For readability, when entering MAC address, a space character is allowed between each byte. For example, any of the following examples are valid.

001018010203

00 10 18 01 02 03

1010203 (currently, the scanner uses this format)

-n Run program in Manufacturing Loop mode.

With this option, the –I, iteration number option, is ignored. The program will run in manufacturing loop mode. Power on/off is supported. After each test, the program will prompt user to exchange the UUT before starts another testing.

-s Skip eeprom programming process.

With this option, the program will skip the eeprom programming process. However, it will check for the eeprom content and print a warning message if the content is not valid.

The -m and -f combination will create the following behavior:

With both -f and -m:

Program will not validate the eeprom content and go ahead to prompt user for the MAC address. It programs MAC address and EEPROM content and then checks the validity of eeprom content at the end of programming.

Loading EEPROM content from eeprom.bin: passed

Programming EEPROM from eeprom.bin....: passed

Checking EEPROM content...............: passed

-f only:

Program will check the validity of eeprom. If it is not valid, it will act as a), -f -m option. If it is good, it saves the MAC address from eeprom, program new eeprom.bin content into EEPROM and then restores the original MAC address. It checks the validity of eeprom content once more at the end of programming.

Checking EEPROM content...............: passed

Loading EEPROM content from eeprom.bin: passed

Programming EEPROM from eeprom.bin....: passed

Checking EEPROM content...............: passed

or

Checking EEPROM content...............: invalid

Loading EEPROM content from eeprom.bin: passed

Programming EEPROM from eeprom.bin....: passed

Checking EEPROM content...............: passed

-m only:

Program will check the validity of EEPROM. If it is not valid, it will act as a), -f -m option. If it is good, the program will prompt the user for a new MAC address and program the MAC address only. It checks the validity of EEPROM content once more at the end of programming.

Checking EEPROM content...............: passed

Programming MAC address...............: passed

Checking EEPROM content...............: passed

or

Checking EEPROM content...............: invalid

Loading EEPROM content from eeprom.bin: passed

Programming EEPROM from eeprom.bin....: passed

Checking EEPROM content...............: passed

d) no -m and -f options

Program will check the validity of EEPROM. If it is not valid, it will act as a), -f -m option. If it is good, it proceeds to normal diagnostics.

Checking EEPROM content...............: passed

or

Checking EEPROM content...............: invalid

Loading EEPROM content from eeprom.bin: passed

Programming EEPROM from eeprom.bin....: passed

Checking EEPROM content...............: passed

Back to Top

EEPROM.TXT Format

A set of commands is defined to allow user to change EEPROM.BIN content. To update EEPROM.BIN, user must enter –e <code> -geneep options at the command prompt. A password must be entered to run this option.

MAC_PREFIX = xx:xx:xx
POWER_DISSIPATCHED = d:d:d:d
POWER_CONSUMED = d:d:d:d
SUBSYSTEM_VENDOR_ID = xxxx
SUBSYSTEM_DEVICE_ID = xxxx
PXE = {enable, disable}
PXE_SPEED = {auto, 10hd, 10fd, 100hd, 100fd, 1000hd, 1000fd}
WOL = {enable, disable}
PRODUCT_NAME = string
PART_NUMBER = string
ENGINEERING_CHANGE = string
MANUFACTURING_ID = string
ASSET_TAG = string

All reserved words are not case sensitive. A ‘;’, ‘//’ can be used at the beginning of line as comment.

Example:

; This comment line
// This also can be used as comment line

// Blank line is also allowed

// This is Broadcom’s MAC prefix
MAC_PREFIX = 00:10:18

POWER_DISSIPATCHED = 10:0:0:100
POWER_CONSUMED = 10:0:0:100
SUBSYSTEM_VENDOR_ID = 14e4
SUBSYSTEM_DEVICE_ID = 1644
pxe = disable
PXE_Speed = 100fd
WOL = enable
Product_name = Broadcom Gigabit Ethernet Controller
PART_NUMBER = BCM95700A6
ENGINEERING_CHANGE = 106679-15
MANUFACTURING_ID = 14e4
Asset_Tag = XYZ1234567

Back to Top

User Interface Commands

The commands are summarized in twelve groups: vpd, seeprom, cpu, dma, packet, mii, mem, test, power, irq, mac, and misc.

Command Group vpd
	vpdwrite		Write VPD Memory
	vpdread 		Read VPD Memory

Command Group seeprom
  	semode			Set SEEPROM Mode to Manual or Auto Mode
	seread			Read SEPPROM
	sewrite	 		Write SEPPROM
	secfg			Configure SEEPROM
	seprg			Program SEPPROM
	sever			Display Serial EEPROM Version
	sechksum		Check/Update Serial EEPROM checksum

Command Group cpu
 	cpudtt			Dump Debuging Trace of TX CPU
	cpudrt			Dump Debuggin Trace of RX CPU

Command Group dma
 			dmaw		 	DMA from NIC to Host Memory
	dmar			DMA from Host to NIC Memory
	dma_h			Dump DMA Entries
	dma_d			Dump DMA Entries with Decode

Command Group packet
	maclpk			Configure MAC loopback
	nicstats		Display NIC statistics
	ringindex 		Dump Ring Index
	blast			Blast Packts in Poll Mode
	tprot 		    Blast with TPROT packets
	txpkt			Transmit Packet
	phyctrl			Configure Speeds/Duplex Mode
	statusblk	 	Dump Statistics Block
	reset			Reset Chip
	txcfg			Configure protocal packets for transmission
	rxcfg			Configure Rx parameters

Command Group mii
	mread 			Read PHY register via MII
	mwrite			Write PHY registers via MII
	mdev			Select current PHY to be accessed
	miimode 		Select Mode of MII Access
	lbertram		Load data to PHY BIST RAM
	dbertram		Dump PHY BIST RAM
	bertstats		Dump PHY BIST Statistics
 	rm				Scan/List for phy devices

Command Group mem
	memsearch 		Search a Data Pattern in Memory
	read 			Read Memory
	write 			Write Memory

Command Group test
	vpdtest			Run VPD Memory Test
	regtest			Run Register Tests
	miitest			Run MII Register Test
	msi				Run MSI Test
	memtest			Run Memory Tests
	setest			Run SEEPROM Test
	bist			Run BIST
	nictest 		Run a set of NIC Tests
	intrtest		Run Interrput Test
	pktest			Run Packets Tests
	cputest			Run CPU Test
	dmatest			Run DMA Test
	bustest			Run PCI Bus Test

Command Group power
 	pmdcfg			Dump Power Management Info
	pmpcfg			Add/Del Pattern
	pmpd			Power Down MAC

Command Group irq
  	intrctrl		Mask/Unmask Current Interrupt
	intr			Dump Interrupt Info

Command Group mac
  	loadfw			Load Firmware to Tx & Rx CPUs
	mbuf 			Dump Content of MBUFs
	loaddrv			Load Driver
	unloaddrv		Unload Driver
	machalt			Halt MAC Controller
	ftq				Dump FTQ
	addmc			Add Multicast MAC
	delmc			Delete Multicast MAC

Command Group misc
	quit, exit		Exit the System
	debug			Debug Functions
	gpiowrite		Write a Value into GPIO pin
	gpioread		Read GPIO Value
	pxecpy			Load PXE code to MBUF Memory
	upgfrm			Upgrade PXE or Boot code from a File
	device 			Show or Switch Device
	version 		Display Program Version
	help, ? 		Displays the Commands Available
	radix 			Change System Radix
	nolog			Close the Current Logfile
	log				Open Logfile
	pciinit			Initialize PCI Configuration Registers
	pciscan			Scan for All PCI Devices
	dos				Enter DOS Shell
	diagcfg			Configure Diagnostics

Special Instructions

1. Mac register test:
   Unload MAC driver before running test.
   

2. Memory test:
   Unload MAC driver before running test.
   

3. DMA test:
   Unload MAC driver before running test.
   

4. TX RX packets:
   TX sides need to be configured (txcfg).
   RX sides need to be configured (rxcfg).
   Configure MAC and PHY loop back.
   Call txpkt to transmit packets.
   

5. The following tests need to setup test configuration before running.
   To setup test configuration, run "diagcfg". Diag config can be saved in system for future use.
   Test:
        Memory test
        NIC test
   

6. Unload driver before power down NIC card.
   

7. Load driver after power up NIC card.
   

8. Blast Test:
   Load MAC driver before running test.

Back to Top

Test and Functions Description

vpdwrite

cmd: vpdwrite

Description: Write data to VPD storage.

Syntax: vpdwrite <start[-end | len] value> | <filename>

File format:

Address range: 0x00 – 0xFF

num_bytes: 256 (max)

If only one argument is entered, filename is assumed. Otherwise, 'start [len] value' format must be used.

Example:

vpdread

cmd: vpread (Not support in A0)

Description: Read data from VPD storage

Syntax: vpdread <begin_addr> [- end_addr | num_bytes]

Address range : 0x00 – 0xFF

num_byte : 256 (max)

Example:

vpdtest

cmd: vpdtest (Not support in A0, A1)

Description: Write designed pattern toVPD storage. Then read back and compare with designed pattern.

Syntax: vpdtest [iteration]

Options:

-b<n> : Pattern to test.

0 - Increment (def);

1 - Decrement ;1 - 0's

2 - FF's

3 - AA55

4 - 55AA

-d : Force Destructive Test

Example:

semode

cmd: semode

Description: Configure Serial EEPROM to either Auto (I²C) or Manual (Bit-Bang) Mode.

Syntax: semode <auto> | <man> | <> for help

Example:

1. Set Serial EEPROM mode to Auto (I²C).

0:> semode auto

2. Set Serial EEPROM mode to Manual (Bit-Bang).

0:> semode man

3. Display Current mode

0:> semode

Current semode is auto

seread

cmd: seread

Description: Read content of designated block of Serial EEPROM.

Syntax: seread <begin_addr> [- end_addr | num_bytes]

Address range: 0x00 – 0x1000

Num_bytes: 4097

Example:

1. Set number base to hex, then read and display serial eeprom locations from 0x00 to 0x20

0:> radix 16
0:> seread 0-20
*** Dump Serial EEPROM (Auto Mode) ***
000000: 669955aa 08000000 00000069 00000200 d97b07d0 00000000 00000000 00000000
000020: 00000000

2. Set number base to hex then read location 0x18 of serial eeprom.

0:> radix 16
0:> seread 18 1
*** Dump Serial EEPROM (Auto Mode) ***
000018: 000000ff

sewrite

1. Set number base to hex, write 0x55AA to serial eeprom from locations 0x30 to 0x35

   0:> radix 16
   0:> sewrite 30-35 55AA
   *** Write Serial EEPROM (Auto Mode) ***

2. Set number base to hex, write 0x2 to serial eeprom location 0x

0:> mread 0-10
00: 1100 7949 0020 6051 01e1 0000 0004 2001
08: 0000 0300 0000 0000 0000 0000 0000 3000
10: 0002

/* 0 */		"PASS",
/* 1 */		"Got 0x%08X @ 0x%08X. Expected 0x%08X",
/* 2 */		"Cannot perform task while chip is running",
/* 3 */ 	"Invalid NIC device",
/* 4 */		"Read only bit %s got changed after writing zero at offset 0x%X",
/* 5 */ 	"Read only bit %s got changed after writing one at offset 0x%X",
/* 6 */ 	"Read/Write bit %s did not get cleared after writing zero at offset 0x%X",
/* 7 */		"Read/Write bit %s did not get set after writing one at offset 0x%X",
/* 8 */ 	"BIST failed",
/* 9 */ 	"Could not generate interrupt",
/* 10 */ 	"Aborted by user",
/* 11 */ 	"Tx DMA:Got 0x%08X @ 0x%08X. Expected 0x%08X",    
/* 12 */ 	"Rx DMA:Got 0x%08X @ 0x%08X. Expected 0x%08X",    
/* 13 */ 	"Tx DMA failed",
/* 14 */ 	"Rx DMA failed",
/* 15 */ 	"Data error, got 0x%08X at 0x%08X, expected 0x%08X",
/* 16 */ 	"Second read error, got 0x%08X at 0x%08X, expected 0x%08X",
/* 17 */ 	"Failed writing EEPROM at 0x%04X",
/* 18 */ 	"Failed reading EEPROM at 0x%04X",
/* 19 */ 	"EEPROM data error, got 0x08X at 0x04X, expected 0x%08X",
/* 20 */ 	"Cannot open file %s",
/* 21 */ 	"Invalid CPU image file %s",
/* 22 */ 	"Invalid CPU image size %d",
/* 23 */ 	"Cannot allocate memory",
/* 24 */ 	"Cannot reset CPU",    
/* 25 */ 	"Cannot release CPU", 
/* 26 */ 	"CPU test failed",       
/* 27 */ 	"Invalid Test Address Range\nValid NIC address is 0x%08X-0x%08X and exclude 0x%08X-0x%08X",
/* 28 */    "DMA:Got 0x%08X @ 0x%08X. Expected 0x%08X", 
/* 29 */   	"Unsupported PhyId %04X:%04X",
/* 30 */   	"Too many registers specified in the file, max is %d",
/* 31 */ 	"Cannot write to VPD memory",
/* 32 */ 	"VPD data error, got %08X @ 0x04X, expected %08X",
/* 33 */ 	"No good link! Check Loopback plug",
/* 34 */ 	"Cannot TX Packet!", 
/* 35 */ 	"Requested to Tx %d. Only %d is transmitted",       
/*36*/		"Expected %d packets. Only %d good packet(s) have been received\n%d unknown packets have been received.\n%d bad packets have been received.",
/* 37 */ 	"%c%d is an invalid Test",
/* 38 */ 	"EEPROM checksum error",
/* 39 */ 	"Error in reading WOL/PXE",
/* 40 */ 	"Error in writing WOL/PXE",
/* 41 */ 	"No external memory detected",
/* 42 */ 	"DMA buffer %04X is large, size must be less than %04X",  
/* 43 */ 	"File size %d is too big, max is %d",
/* 44 */ 	"Invalid %s",
/* 45 */ 	"Failed writing 0x%x to 0x%x",
/* 46 */ 	"",
/* 47 */ 	"Ambiguous command",
/* 48 */ 	"Unknown command",
/* 49 */ 	"Invalid option",
/* 50 */ 	"Cannot perform task while chip is not running. (need driver)",
/* 51 */ 	"Cannot open register define file or content is bad",
/* 52 */ 	"ASF Reset bit did not self-cleared",
/* 53 */ 	"ATTN_LOC %d cannot be mapped to %cX CPU event bit %d",
/* 54 */ 	"%s Regsiter is not cleared to zero after reset",
/* 55 */ 	"Cannot start poll_ASF Timer",
/* 56 */ 	"poll_ASF bit did not get reset after acknowleged",
/* 57 */ 	"Timestamp Counter is not counding",
/* 58 */ 	"%s Timer is not working",
/* 59 */ 	"Cannot clear bit %s in %cX CPU event register",
/* 60 */ 	"Invalid "EEPROM_FILENAME" file size, expected %d but only can read %d bytes",
/* 61 */ 	"Invalid magic value in %s, expected %08x but found %08x",
/* 62 */ 	"Invalid manufature revision, expected %c but found %c",
/* 63 */ 	"Invalid Boot Code revision, expected %d.%d but found %d.%d",
/* 64 */ 	"Cannot write to EEPROM",
/* 65 */ 	"Cannot read from EEPROM",
/* 66 */ 	"Invalid Checksum",
/* 67 */ 	"Invalid Magic Value",
/* 68 */ 	"Invalid MAC address, expected %02X-%02X-%02X-%02X-%02X-%02X",
/* 69 */ 	"Slot error, expected an UUT to be found at location %02X:%02X:00",
/* 70 */ 	"Adjacent memory has been corrupted while testing block 0x%08x-0x%08x\nGot 0x%08x @ address 0x%08x. Expected 0x%08x",
/* 71 */ 	"The function is not Supported in this chip",
/* 72 */ 	"Packets received with CRC error",
/* 73 */ 	"MII error bits set: %04x",
/* 74 */ 	"CPU does not initialize MAC address register correctly",
/* 75 */ 	"Invalid firmware file format",
/* 76 */ 	"Resetting TX CPU Failed",
/* 77 */ 	"Resetting RX CPU Failed",
/* 78 */ 	"Invalid MAC address",
/* 79 */ 	"Mac address registers are not initialized correctly",
/* 80 */ 	"EEPROM Bootstrap checksum error",