Dell S5148F-ON Open Networking Hardware Diagnostic Guide September 2017 - Page 63

pcitool, Tests, CLI options, and reports any devices that it cannot

Get Dell S5148F-ON PDF manuals and user guides View all Dell S5148F-ON manuals
Add to My Manuals
Save this manual to your list of manuals

Page 63 highlights

pcitool To scan and access devices on the PCI bus, use the pcitool. The pcitool checks for missing devices and that the present devices are the proper type. The pcitool scans the PCI bus for present devices and displays them and the BAR information it decodes. The tool does not handle endianess. The pcitool reads the configuration file and then iterates across all devices in the configuration file. It checks the vendor/product ID to see that the correct device is at the correct address. The tool does not compare all the configuration space. The tool reads all 256 bytes of the configuration file. Tests The pcitool reads from the configuration file the devices it expects to find and reports any devices that it cannot find or if the device is not correct. The tool supports second-source parts; therefore, they are not flagged as false errors. If a mismatch occurs, the device lists with the expected value and the read value. Populate the configuration file with -u numbers so the device can quickly identify the failing device. CLI options DellEmc Diag - PCI Tool version 1.5, x.xx.x.x-x build, 2017/05/23, Usage: To scan all PCI drivers and optionally show all config data := pcitool -- scan[=all] (or) pcitool -S[=all] To test using default PCI config-file := pcitool -- test (or) pcitool -t Show confic data for specific bus:dev.func:= pcitool --show {--bus=# --dev=# -- func=#} (or) pcitool -x {-B # -D # -F #} Read 8-bit config register for bus:dev.func:= pcitool --read {--bus=# --dev=# --func=# --offset= -- count=} (or) pcitool -r {-B # -D # -F # -O -C } Write 8-bit config register for bus:dev.func:= pcitool --write {--bus=# --dev=# --func=# --offset= -- val=} (or) pcitool -w {-B # -D # -F # -O -V } Execute repeatedly command by count:= pcitool --iteration=max/ [option1] [option2]... (or) pcitool -I max/ [option1] [option2]... Syntax: pcitool -h, --h Show the help text -S, --scan Scan operation -t, --test Test using the pre-programmed configuration or use supplied config -x, --show Show operation -r, --read Read operation -w, --write Write operation -I, --iteration= Iteration command execution Dell EMC DiagOS tools 63

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
pcitool
To scan and access devices on the PCI bus, use the
pcitool
. The
pcitool
checks for missing devices and that the present devices are
the proper type.
The
pcitool
scans the PCI bus for present devices and displays them and the BAR information it decodes. The tool does not handle
endianess.
The
pcitool
reads the
configuration
file
and then iterates across all devices in the
configuration
file.
It checks the vendor/product ID to
see that the correct device is at the correct address. The tool does not compare all the
configuration
space. The tool reads all 256 bytes of
the
configuration
file.
Tests
The
pcitool
reads from the
configuration
file
the devices it expects to
find
and reports any devices that it cannot
find
or if the device is
not correct. The tool supports second-source parts; therefore, they are not
flagged
as false errors. If a mismatch occurs, the device lists
with the expected value and the read value. Populate the
configuration
file
with
-u
numbers so the device can quickly identify the failing
device.
CLI options
DellEmc Diag - PCI Tool
version 1.5, x.xx.x.x-x
build, 2017/05/23,
Usage:
To scan all PCI drivers and optionally show all config data :=
pcitool --
scan[=all]
(or)
pcitool -S[=all]
To test using default PCI config-file :=
pcitool --
test
(or)
pcitool -t
Show confic data for specific bus:dev.func:=
pcitool --show {--bus=<bus># --dev=<dev># --
func=<func>#}
(or)
pcitool -x {-B <bus># -D <dev># -F <func>#}
Read 8-bit config register for bus:dev.func:=
pcitool --read {--bus=<bus># --dev=<dev># --func=<func># --offset=<offset> --
count=<count>} (or)
pcitool -r {-B <bus># -D <dev># -F <func># -O <offset> -C <count>}
Write 8-bit config register for bus:dev.func:=
pcitool --write {--bus=<bus># --dev=<dev># --func=<func># --offset=<offset> --
val=<value>}
(or)
pcitool -w {-B <bus># -D <dev># -F <func># -O <offset> -V <value>}
Execute repeatedly command by count:=
pcitool --iteration=max/<count> [option1]
[option2]...
(or)
pcitool -I max/<count> [option1] [option2]...
Syntax: pcitool <option>
-h, --h
Show the help text
-S, --scan
Scan operation
-t, --test
Test using the pre-programmed configuration or use supplied config
-x, --show
Show operation
-r, --read
Read operation
-w, --write
Write operation
-I, --iteration=
Iteration command execution
Dell EMC DiagOS tools
63