Administrator Guide

Tests
The pltool tests specified registers and values SDI identifies in the testable bits of the register. The tool reads the register
using SDI interfaces and compares the testable bits from those the SDI database provides. If a mismatch occurs, an error
displays.
CLI Options
Dell Diag - Programable Logic Tool
version 1.5, 1.10
build, 2014/11/10,
Syntax: pltool <option>
--h := show this help test
--test := test (RW) the scratchpad registers
--list <--lstype=devicetype> := list devices and registers (empty for all)
--listdevicenames := list device names with address
If multiple devices have the same device addr, pass the --devname additionally
--read <--devname=deviceName> <--dev=deviceaddr>
<--reg=reg> := read the specified register of the dev(--dev=0 for lpc access)
--write <--devname=deviceName> <--dev=deviceaddr>
<--reg=reg> <--val=value> := write at the specified register of the dev(--dev=0 for lpc access)
• list — Lists all the devices and registers within the device and the bit-level definitions.
• test — Asks SDI for the testable registers and values within a device and the testable bit mask. It reads the register, masks-
out the untestable bits and compares the result. It tests for all devices.
• listdevicenames — Lists all the devices with a name to avoid confusion between devices that share the same address.
• devname and dev — Reads and writes the address and name from the listdevicenames option for the specified device.
• read — Reads a register within a device. The device address and register offset are found by either documentation or the
list command.
• write — Writes the device’s register with the supplied value. The device address, register offset, and bit width of the register
are found by either documentation or the list command.
Output
list Output
root@dell-diag-os:/etc/dn/diag# pltool --list
CPLD1 0 cpld lpc 0 (U5)
0x100 CPLD_VERSION bits:8 RO val:0 mask:0xff test:0 ver:0x0
7:4 MAJOR_VER RO 0
3:0 MINOR_VER RO 0
0x101 BOARD_TYPE bits:8 RO val:0xff mask:0xff test:0 ver:0x0
7:0 BOARD_TYPE RO 0x1
0x102 SW_SCRATCH bits:8 RW val:0xde mask:0xff test:1 ver:0x0
7:0 SW_SCRATCH RW 0xde
0x103 CPLD_ID bits:8 RO val:0xff mask:0xff test:0 ver:0x0
7:0 CPLD_ID RO 0x1
Dell DiagOS Tools 67