Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Sign In Create an Account Dell Financial Services Premier Sign In Partner Program Sign In
Contact Us

Your Dell.com Carts

Open Networking Hardware Diagnostic Guide November 2022

PDF

nputool

The nputool allows for configuring and testing the switch ASICs.

Tests

The nputool tests the NPU in the system. The nputool verifies that ports are up and traffic between the ports is working either using the CPU-generated packet or using IXIA connected to port-1 and port-2 based on the configuration.

Tests are shown in the following sections.

CLI options

The nputool shows the available options with the nputool -h or nputool command. 

DellEmc Diag ---- NPU Tool
version 1.0, x.xx.x.x-x
build, 2022/05/20,

Syntax: nputool 
   -h, --help             := Show this help
   -i, --init             := Initialize NPU chip
   -t, --test
              all         := Run All NPU tests
              id          := Run test based on test ID
   -s, --show
              counter     := Dump packet counters
              temp        := Display NPU temperature

   -l, --lpbk [phy/mac/ext]:= Specify Loopback type for traffic test
   -T, --traffic [ixia_self,ixia_adj,cpu_self,cpu_adj]
                          := Send IXIA or CPU traffic based on specified cfg
                                self->timbercon lpbk, adj->fiber lpbk
   -I, --iteration [count]:= Execute repeatedly command by count
   -v, --version          := Display version

Usage:
   nputool -i -t [all/0/1,2,3/4/../7] -T [ixia_self/ixia_adj/cpu_self/cpu_adj]
           -l [phy/mac/ext]  := Run NPU tests based on user input

   nputool -I [count] -i -t 1 -T cpu_self   := Run NPU test repeatedly by count
   nputool -i -s temp        := Display NPU temperature

For the nputool -i -t [all/0/1,2,3/4/../7] usage:

  • 0 = Test link status
  • 1 = Test snake traffic
  • 2 = Test prbs mac test
  • 3 = Test prbs ext
  • 4 = Test uplink link status
  • 5 = Test uplink snake traffic
  • 6 = Test uplink prbs mac
  • 7 = Test uplink prbs ext

nputool version 

root@dell-diag-os:/etc/dn/diag# nputool --v
Dell Diag nputool - version 1.0 sdk-6.5.3 package x.xx.x.x.xx 2022/05/20
root@dell-diag-os:/etc/dn/diag#

root@dell-diag-os:/etc/dn/diag# nputool --version
Dell Diag nputool - version 1.0 sdk-6.5.3 package x.xx.x.x.xx 2022/05/20
root@dell-diag-os:/etc/dn/diag#

Port link status test

  • nputool -i -t 0
  • nputool --i --test 0 
root@dell-diag-os:~# root@dell-diag-os:/etc/dn/diag# nputool -i -t 0
8375_B0
-bash: root@dell-diag-os:/etc/dn/diag#: No such file or directory
sysconf_probe successful
global_sal_config successful
***  1 BCM devices are detected
Diag NPU initialization over
         Test link_status_test for NPU 0 .......... Passed
       Test snake_traffic_test for NPU 0 .......... SKIPPED <<<---
            Test prbs_mac_test for NPU 0 .......... SKIPPED <<<---
            Test prbs_ext_test for NPU 0 .......... SKIPPED <<<---
  Test uplink_link_status_test for NPU 0 .......... SKIPPED <<<---
Test uplink_snake_traffic_test for NPU 0 .......... SKIPPED <<<---
     Test uplink_prbs_mac_test for NPU 0 .......... SKIPPED <<<---
     Test uplink_prbs_ext_test for NPU 0 .......... SKIPPED <<<---
NPU tests ........................................  Passed

root@dell-diag-os:/etc/dn/diag# nputool -init -test 0
DMA pool size: 16777216
PCI unit 0: Dev 0x8375, Rev 0x11, Chip BCM88375_B0, Driver BCM88375_B0
sysconf_probe successful
global_sal_config successful
***  1 BCM devices are detected
Diag NPU initialization over
         Test link_status_test for NPU 0 .......... Passed
       Test snake_traffic_test for NPU 0 .......... SKIPPED <<<---
            Test prbs_mac_test for NPU 0 .......... SKIPPED <<<---
            Test prbs_ext_test for NPU 0 .......... SKIPPED <<<---
  Test uplink_link_status_test for NPU 0 .......... SKIPPED <<<---
Test uplink_snake_traffic_test for NPU 0 .......... SKIPPED <<<---
     Test uplink_prbs_mac_test for NPU 0 .......... SKIPPED <<<---
     Test uplink_prbs_ext_test for NPU 0 .......... SKIPPED <<<---
NPU tests ........................................  Passed

CPU traffic with external loopback

Tests the traffic that is sent from the CPU internally generated packet to the front-end ports that are connected with external Loopback optics.

Connect all the ports with QSFP28 Loopback optics.

  • nputool -i -t 1 -T cpu_self
  • nputool --init --test 1 --traffic cpu_self 
root@dell-diag-os:/opt/dellemc/diag/bin# nputool -i -t 1 -T cpu_self
DMA pool size: 16777216 PCI unit 0: Dev 0x8375, Rev 0x11, Chip BCM88375_B0, 
  Driver BCM88375_B0 sysconf_probe successful global_sal_config successful *** 
  1 BCM devices are detected Diag NPU initialization over 
Test link_status_test for NPU 0 ............. SKIPPED <<<--- 
Test snake_traffic_test for NPU 0 ........... Passed
Test prbs_mac_test for NPU 0 ................ SKIPPED <<<--- 
Test prbs_ext_test for NPU 0 ................ SKIPPED <<<--- 
Test uplink_link_status_test for NPU   0 .... SKIPPED <<<--- 
Test uplink_snake_traffic_test for NPU 0 .... SKIPPED <<<--- 
Test uplink_prbs_mac_test for NPU      0 .... SKIPPED <<<--- 
Test uplink_prbs_ext_test for NPU 0 ......... SKIPPED <<<--- 
NPU tests ................................... Passed

root@dell-diag-os:~# nputool --init --test 1 --traffic cpu_self 
  DMA pool size: 16777216 PCI unit 0: Dev 0x8375, Rev 0x11, Chip BCM88375_B0, 
  Driver BCM88375_B0 sysconf_probe successful global_sal_config successful *** 
  1 BCM devices are detected Diag NPU initialization over 
Test link_status_test for NPU 0 ............. SKIPPED <<<--- 
Test snake_traffic_test for NPU 0 ........... Passed 
Test prbs_mac_test for NPU 0 ................ SKIPPED <<<--- 
Test prbs_ext_test for NPU 0 ................ SKIPPED <<<--- 
Test uplink_link_status_test for NPU 0 ...... SKIPPED <<<--- 
Test uplink_snake_traffic_test for NPU 0 .... SKIPPED <<<--- 
Test uplink_prbs_mac_test for NPU 0 ......... SKIPPED <<<--- 
Test uplink_prbs_ext_test for NPU 0 ......... SKIPPED <<<--- 
NPU tests ................................... Passed

CPU traffic with adjacent loopback

Tests the traffic that is sent from the CPU internally generated packet to the front-end ports which are connected with direct attach cables (DACs) or optics with cables connected top-to-bottom.

Connect all the ports with DACs or 40G/100G optics with cables.

  • nputool -i -t 1 -T cpu_adj
  • nputool --init --test 1 --traffic cpu_adj 
root@dell-diag-os:~# nputool -i -t 1 -T cpu_adj
DMA pool size: 16777216
PCI unit 0: Dev 0x8375, Rev 0x11, Chip BCM88375_B0, Driver BCM88375_B0
sysconf_probe successful
global_sal_config successful
***  1 BCM devices are detected
Diag NPU initialization over
         Test link_status_test for NPU 0 ............ SKIPPED <<<---
       Test snake_traffic_test for NPU 0 ............ Passed
            Test prbs_mac_test for NPU 0 ............ SKIPPED <<<---
            Test prbs_ext_test for NPU 0 ............ SKIPPED <<<---
  Test uplink_link_status_test for NPU 0 ............ SKIPPED <<<---
Test uplink_snake_traffic_test for NPU 0 ............ SKIPPED <<<---
     Test uplink_prbs_mac_test for NPU 0 ............ SKIPPED <<<---
     Test uplink_prbs_ext_test for NPU 0 ............ SKIPPED <<<---
NPU tests ..........................................  Passed
root@dell-diag-os:~#

root@dell-diag-os:~# nputool -init -test  1 -traffic  cpu_adj
DMA pool size: 16777216
PCI unit 0: Dev 0x8375, Rev 0x11, Chip BCM88375_B0, Driver BCM88375_B0
sysconf_probe successful
global_sal_config successful
***  1 BCM devices are detected
Diag NPU initialization over
         Test link_status_test for NPU 0 ............. SKIPPED <<<---
       Test snake_traffic_test for NPU 0 ............. Passed
            Test prbs_mac_test for NPU 0 ............. SKIPPED <<<---
            Test prbs_ext_test for NPU 0 ............. SKIPPED <<<---
  Test uplink_link_status_test for NPU 0 ............. SKIPPED <<<---
Test uplink_snake_traffic_test for NPU 0 ............. SKIPPED <<<---
     Test uplink_prbs_mac_test for NPU 0 ............. SKIPPED <<<---
     Test uplink_prbs_ext_test for NPU 0 ............. SKIPPED <<<---
NPU tests ...........................................  Passed
root@dell-diag-os:~#

IXIA traffic with external loopback

Tests the traffic that is sent from IXIA to port-1 and to the front-end ports which are connected with external Loopback optics.

Connect the first port to IXIA and all other ports with QSFP28 Loopback optics.

  • nputool -i -t 1 -T ixia_self -d
  • nputool --init --test 1 --traffic ixia_self -d

These commands configure the virtual local area network (VLAN) and after the BCM.0> shell displays, send the traffic from IXIA. To verify the counters, run the show c command in the BCM shell. For the S5148F-ON switch, to verify the counters, run the show c command in the XP Shell.

IXIA traffic with adjacent loopback

Tests the traffic that is sent from IXIA to the front-end ports which are connected with DACs or optics with cables connected top-to-bottom.

Connect the first two ports to IXIA and all the remaining ports with DACs or 40G/100G optics with cables.

  • nputool –i –t 1 –T ixia_adj
  • nputool --init --test 1 --traffic ixia_adj

The previous commands configure the VLAN and after the BCM.0> shell displays. To verify the counters, run the show c command in the BCM shell. For the S5148F-ON switch, to verify the counters, run the show c command in the XP Shell.

CPU traffic with external loopback for uplink ports (SFP+)

Traffic is sent from the CPU to the SFP+ ports.

Connect all the ports with the SFP+ optics with TX and RX shorted.

  • nputool -i -t 5 -T cpu_self
  • nputool --init --test 5 --traffic cpu_self

CPU traffic for uplink ports connected between adjacent ports

Traffic is sent from the CPU internally generated packet to the front-end Dell SFP+ ports which are connected with SFP+ optics using a cable.

Connect the SFP+ ports with the Dell SFP+ optics using cables.

  • nputool -i -t 5 -T cpu_adj
  • nputool --i --test 5 --traffic cpu_adj

IXIA traffic with external loopback

Traffic is sent from the CPU internally generated packet to the front-end SFP+ ports which are connected with the Dell SFP+ optics using a cable.

Connect the first port to IXIA and all other ports with Loopback optics.

  • nputool -i -t 5 -T ixia_self -d
  • nputool --init --test 5 --traffic ixia_self -d

Configure the VLAN and display the BCM.0> shell. To verify the counters, use the show c command in the BCM shell. For the S5148F-ON switch, to verify the counters, run the show c command in the XP Shell.

IXIA traffic with adjacent ports connected to IXIA

Traffic is sent from the CPU internally generated packet to the front-end ports which are connected with DACs or optics using cables connected top-to-bottom.

Connect two ports to IXIA with SFP+ optics and cables.

  • nputool -i -t 5 -T ixia_adj
  • nputool --init --test 5 --traffic ixia_adj

Configure the VLAN and display the BCM.0> shell. To verify the counters, use the show c command in the BCM shell. For the S5148F-ON switch, to verify the counters, run the show c command in the XP Shell.

PRBS for QSFP ports

Connect ports with Loopback cables and run the PRBS MAC and EXT Loopback tests.

  • PRBS MAC level test nputool –i –t 2 or nputool --init --test 2
  • PRBS EXT level test nputool –i –t 3 or nputool --init --test 3

For example: 

root@dell-diag-os:~# nputool --init --test 2 
DMA pool size: 16777216 PCI unit 0: Dev 0x8375, Rev 0x11, Chip BCM88375_B0, 
  Driver BCM88375_B0 sysconf_probe successful global_sal_config successful *** 
  1 BCM devices are detected Diag NPU initialization over 
Test link_status_test for NPU 0 ................ SKIPPED <<<--- 
Test snake_traffic_test for NPU 0 .............. SKIPPED <<<--- 
Test prbs_mac_test for NPU 0 ................... Passed 
Test prbs_ext_test for NPU 0 ................... SKIPPED <<<--- 
Test uplink_link_status_test for NPU 0 ......... SKIPPED <<<--- 
Test uplink_snake_traffic_test for NPU 0 ....... SKIPPED <<<--- 
Test uplink_prbs_mac_test for NPU 0 ............ SKIPPED <<<--- 
Test uplink_prbs_ext_test for NPU 0 ............ SKIPPED <<<--- 
NPU tests ...................................... Passed 

root@dell-diag-os:~# nputool --init --test 3 
DMA pool size: 16777216 PCI unit 0: Dev 0x8375, Rev 0x11, Chip BCM88375_B0, 
  Driver BCM88375_B0 sysconf_probe successful global_sal_config successful *** 
  1 BCM devices are detected Diag NPU initialization over 
Test link_status_test for NPU 0 ................ SKIPPED <<<--- 
Test snake_traffic_test for NPU 0 .............. SKIPPED <<<--- 
Test prbs_mac_test for NPU 0 ................... SKIPPED <<<--- 
Test prbs_ext_test for NPU 0 ................... Passed 
Test uplink_link_status_test for NPU 0 ......... SKIPPED <<<--- 
Test uplink_snake_traffic_test for NPU 0 ....... SKIPPED <<<--- 
Test uplink_prbs_mac_test for NPU 0 ............ SKIPPED <<<---
 Test uplink_prbs_ext_test for NPU 0 ........... SKIPPED <<<--- 
NPU tests ...................................... Passed

PRBS for uplink ports

Connect the SFP+ ports with an external Loopback cable.

  • PRBS MAC level test ./nputool –i –t 6
  • PRBS EXT level test “./nputool –i –t 7

NPU temperature

Show the current NPU temperature.

  • nputool –i –s temp
  • nputool --init --show temp 
root@dell-diag-os:~# nputool -i -s temp
DMA pool size: 16777216
PCI unit 0: Dev 0x8375, Rev 0x11, Chip BCM88375_B0, Driver BCM88375_B0
sysconf_probe successful
global_sal_config successful
***  1 BCM devices are detected
Diag NPU initialization over
NPU 0 Temperature
----------------------------
monitor   current    peak
----------------------------
0         41.8       44.2
1         41.3       44.7
2         36.4       38.8
3         39.8       43.2
----------------------------
Average  39.8, maximum peak 44.7

root@dell-diag-os:~# nputool -init -show  temp
DMA pool size: 16777216
PCI unit 0: Dev 0x8375, Rev 0x11, Chip BCM88375_B0, Driver BCM88375_B0
sysconf_probe successful
global_sal_config successful
***  1 BCM devices are detected
Diag NPU initialization over
NPU 0 Temperature
----------------------------
monitor   current    peak
----------------------------
0         42.3       44.2
1         40.8       44.2
2         35.9       38.8
3         40.8       43.2
----------------------------
Average  39.9, maximum peak 44.2
root@dell-diag-os:~#

Debugging

With traffic commands, use the –d option, which displays the BCM.0> shell. To check counters and if the link is up, use the ps and show c commands.

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\