This document contains information proprietary to Kontron. It may not be copied or transmitted by any means,
disclosed to others, or stored in any retrieval system or media without the prior written consent of Kontron or one
of its authorized agents.
The information contained in this document is, to the best of our knowledge, entirely correct. However, Kontron
cannot accept liability for any inaccuracies or the consequences thereof, or for any liability arising from the use
or application of any circuit, product, or example shown in this document.
Kontron reserves the right to change, modify, or improve this document or the product described herein, as seen
fit by Kontron without further notice.
Trademarks
This document may include names, company logos and trademarks, which are registered trademarks and,
therefore, proprietary to their respective owners.
Environmental Protection Statement
This product has been manufactured to satisfy environmental protection requirements where possible. Many
of the components used (structural parts, printed circuit boards, connectors, batteries, etc.) are capable of being
recycled.
Final disposition of this product after its service life must be accomplished in accordance with applicable country,
state, or local laws or regulations.
The Waste Electrical and Electronic Equipment (WEEE) Directive aims to:
> reduce waste arising from electrical and electronic equipment (EEE)
> make producers of EEE responsible for the environmental impact of their products, especially when they
become waste
> encourage separate collection and subsequent treatment, reuse, recovery, recycling and sound
environmental disposal of EEE
> improve the environmental performance of all those involved during the lifecycle of EEE
SD.DT.G35-0e Page ii
Preface
VM6052/VM6054 PBIT User's Guide
Conventions
This guide uses several types of notice: Note, Caution, ESD.
Note: this notice calls attention to important features or instructions.
Caution: this notice alert you to system damage, loss of data, or risk of personal injury.
ESD: This banner indicates an Electrostatic Sensitive Device.
All numbers are expressed in decimal, except addresses and memory or register data, which are expressed in
hexadecimal. The prefix `0x' shows a hexadecimal number, following the `C' programming language convention.
The multipliers `k', `M' and `G' have their conventional scientific and engineering meanings of *103, *106 and *10
respectively. The only exception to this is in the description of the size of memory areas, when `K', `M' and `G'
mean *210, *220 and *230 respectively.
9
When describing transfer rates, `k' `M' and `G' mean *103, *106 and *109 not *210 *220 and *230.
In PowerPC terminology, multiple bit fields are numbered from 0 to n, where 0 is the MSB and n is the LSB. PCI
and CompactPCI terminology follows the more familiar convention that bit 0 is the LSB and n is the MSB.
Signal names ending with an asterisk (*) or a hash (#) denote active low signals; all other signals are active high.
Signal names follow the PICMG 2.0 R3.0 CompactPCI Specification and the PCI Local Bus 2.3 Specification.
For Your Safety
Your new Kontron product was developed and tested carefully to provide all features necessary to ensure its
compliance with electrical safety requirements. It was also designed for a long fault-free life. However, the life
expectancy of your product can be drastically reduced by improper treatment during unpacking and installation.
Therefore, in the interest of your own safety and of the correct operation of your new Kontron product, you are
requested to conform with the following guidelines.
High Voltage Safety Instructions
Warning!
All operations on this device must be carried out by sufficiently skilled personnel only.
Caution, Electric Shock!
Before installing a not hot-swappable Kontron product into a system always ensure that your mains power
is switched off. This applies also to the installation of piggybacks. Serious electrical shock hazards can
exist during all installation, repair and maintenance operations with this product. Therefore, always unplug
the power cable and any other cables which provide external voltages before performing work.
Page iii SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
Preface
Special Handling and Unpacking Instructions
ESD Sensitive Device!
Electronic boards and their components are sensitive to static electricity. Therefore, care must be taken
during all handling operations and inspections of this product, in order to ensure product integrity at all
times
Do not handle this product out of its protective enclosure while it is not used for operational purposes unless it
is otherwise protected.
Whenever possible, unpack or pack this product only at EOS/ESD safe work stations. Where a safe work station
is not guaranteed, it is important for the user to be electrically discharged before touching the product with his/her
hands or tools. This is most easily done by touching a metal part of your system housing.
It is particularly important to observe standard anti-static precautions when changing piggybacks, ROM devices,
jumper settings etc. If the product contains batteries for RTC or memory backup, ensure that the board is not
placed on conductive surfaces, including anti-static plastics or sponges. They can cause short circuits and
damage the batteries or conductive circuits on the board.
General Instructions on Usage
In order to maintain Kontron’s product warranty, this product must not be altered or modified in any way. Changes
or modifications to the device, which are not explicitly approved by Kontron and described in this manual or
received from Kontron’s Technical Support as a special handling instruction, will void your warranty.
This device should only be installed in or connected to systems that fulfill all necessary technical and specific
environmental requirements. This applies also to the operational temperature range of the specific board
version, which must not be exceeded. If batteries are present, their temperature restrictions must be taken into
account.
In performing all necessary installation and application operations, please follow only the instructions supplied
by the present manual.
Keep all the original packaging material for future storage or warranty shipments. If it is necessary to store or
ship the board, please re-pack it as nearly as possible in the manner in which it was delivered.
Special care is necessary when handling or unpacking the product. Please consult the special handling and
unpacking instruction.
Appendix A - List of Abbreviations51...................................................
SD.DT.G35-0e Page vi
VM6052/VM6054 PBIT User's Guide
PBIT Overview
Chapter 1 -PBIT Overview
This document describes the PowerOn Built In Test (PBIT) for Kontron VM6052/VM6054 boards.
The PBIT is an optional product available under the VM6052/VM6054 EFI BIOS shell environment. It is
implemented as a binary executable located in the system Flash and included in the BIOS shell application. The
PBIT configuration such as tests list and tests result is stored in the VM6052/VM6054 system EEPROM.
The PBIT includes among others the following services:
> It offers a list of tests that can be added or removed from a run list by command according to the desired
trade-off between time to boot, coverage rate and system dependent configuration.
> It also offers a system test that can quickly spot any configuration change.
> It can be run automatically (when booting firmware) or in an interactive mode (at EFI BIOS Shell firmware
prompt).
> Tests configuration and results are stored in the system EEPROM and can also be accessed and
reconfigured under Operating System such as Linux or VxWorks . See Chapter 3 page 46.
> Simplified test result is also available in a 8-bit PLD register (register 0x2).
1.1Related Documents
Hardware:
> VM6052/VM6054 6U VME Single Board Computer User’s GuideCA.DT.B16.........................
By default the test named “system” is not “ready”. The end user should record the system configuration when
the system is ready for this. All hardware needed for the system must be connected before running the test: CPU
VME boards, XMC/PMC, Ethernet cables, USB devices, SATA devices, and also setup in BIOS has to be
configured accordingly. See section 2.10 page 34 “PBIT System Learn Test” for more details.
To record and then activate this test , run the following:
The PBIT uses BIOS environment variables to run automatically at the end of the BIOS boot and before the Ope
rating System boot:
> Configure the PBIT to be launched at boot time:
The automatic start is activated using the environment variable “bootcmd”.
VM6054> set bootcmd ”kdiag run”
The delay before executing the bootcmd is given by the variable bootdelay which is expressed in seconds.
Default value is “1”. Value “0” is possible.
VM6054> set bootdelay 1
> Verify:
VM6054> set
bootcmd : kdiag run
bootdelay : 1
> Then reset the system:
VM6054> reset
The PBIT will be launched automatically. When finished, the BIOS boots from the next valid device in the boot
list.
To stop under the EFI shell after the PBIT execution, define the variable named “stopEfiShell”:
VM6054> set stopEfiShell 1
Page 6 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
PBIT Overview
1.4Synthetic PBIT Result
A 8-bit synthetic PBIT result can be read in the CPLD register 0x2.
This register is accessible under the Operating System using the CPLD OS facility or a direct memory I/O access
at address 0x802.
Under the BIOS EFI shell use the following command:
VM6054> kpld -r 2
READ : @0x2 = 0x1
The 8-bit register 0x2 content is the following (reset value=0):
Test Fail Number 1.. 128run
76543210
Bit 0: 0 = NOT RUN1 = ALL RUN
Bit 1..7: if All 0 => No FAILED test, if NOT 0 then indicates ID number of first failing test
> Examples:
0x00 => PBIT not run
0x03 => ALL Tests run and Test 1 FAILED
0x61 => ALL Tests run and Test 48 FAILED (48 = 0x30, 0x30 << 1 = 0x60)
0x01 => ALL Tests run and PASSED
To identify a PBIT test by its number , use the command “kdiag [PBITnumber]”
Example:
VM6054> kdiag 16
serial (16) - Checks the serial line COM2
capabilities : fast,simple/complex
run mode 1 : fast,simple
This register is set to 0 at each hardware reset. It can safely be written to 0 at any time.
SD.DT.G35-0e Page 7
PBIT Overview
VM6052/VM6054 PBIT User's Guide
1.5PBIT Tests List
The PBIT tests list comes in two parts: a default list of selected tests and a list of additional not selected tests.
This can be changed by the user to fulfill his specific coverage and execution time requirements. The “kdiag”
command displays the 2 lists. Note: the initial default tests list can be restored with the “kdiag default” com
mand
1.5.1Selected Tests List
The default selected tests list contains all the diagnostics that can be run without any specific equipment. All the
tests have been designed to be safe for the system containing a VM6052/VM6054. No signal on any connector
will be modified during the default tes t execution.
The command “kdiag” displays the default tests list to run:
VM6054> kdiag
PBITs configured to run from command line :
mem_data (1) - Checks Memory/ECC data lines
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
mem_addr (2) - Checks Memory/ECC address lines
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
mem_pattern1 (6) - Checks Memory/ECC using pattern 0xFFFFFFFF
capabilities : slow/fast,simple,allresets
run mode 1 : slow,simple,allresets
mem_pattern2 (7) - Checks Memory/ECC using pattern 0x55555555
capabilities : slow/fast,simple,allresets
run mode 1 : slow,simple,allresets
mem_pattern3 (8) - Checks Memory/ECC using pattern 0xAAAAAAAA
capabilities : slow/fast,simple,allresets
run mode 1 : slow,simple,allresets
mem_pattern4 (9) - Checks Memory/ECC using pattern 0x00000000
capabilities : slow/fast,simple,allresets
run mode 1 : slow,simple,allresets
core_dmi (10) - Checks Core & DMI bus
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
tpm (11) - Checks TPM access
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
serial (16) - Checks the serial line COM2
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
rtc (20) - Checks the RTC time
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
sysflash (22) - Checks the BIOS rescue in system flash
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
Page 8 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
cpld (24) - Checks PLD, GeoAddress, watchdog
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
temp_sensors (31) - Checks if all temperature sensors are detected.
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
temperature (32) - Checks if temperatures are OK.
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
fnvram (40) - Checks F-NVRAM device.
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
ether_loop0 (55) - Checks 82580 Gigabit FrontPanel Interface 0 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
ether_loop1 (56) - Checks 82580 Gigabit FrontPanel Interface 1 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
ether_loop2 (57) - Checks 82580 Gigabit Rear Interface 2 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
ether_loop3 (58) - Checks 82580 Gigabit Rear Interface 3 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
voltage (60) - Checks the voltage sensors & value
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
hwmon (61) - Checks hardware monitoring, temperature and voltage sensors
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
sata0_controler (68) - Checks sata0 controller
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
sata1_controler (69) - Check sata1 controller
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
vpd (70) - Checks VPD data required for board operation.
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
eeprom (71) - Checks User EEPROM (0xA2)
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
pmcA_xmc_check (76) - Checks PMCA 64bits/XMC path & slot
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
pmcB_xmc_check (78) - Checks PMCB 32bits/XMC path & slot
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
usb1_controller (86) - Check first PCH usb controller
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
PBIT Overview
SD.DT.G35-0e Page 9
PBIT Overview
usb2_controller (87) - Check second PCH usb controller
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
system (89) - Checks system configuration SETUP,PCIe,SATA,USB,ETH stability
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
Other PBITs available but not yet configured :
mem_bitflip (3) - Checks Mem/ECC using bit-flip pattern ((1 << (offset % 64))
capabilities : slow/fast,simple,allresets
mem_addrpat (4) - Checks Memory/ECC using address pattern (offset)
capabilities : slow/fast,simple,allresets
mem_addrpat2 (5) - Checks Memory/ECC using address pattern (~offset)
capabilities : slow/fast,simple,allresets
therm (12) - Print temperatures and power consumption
capabilities : fast,simple,allresets
ether_link0 (50) - Checks the link status is ”UP” on 82580 Gigabit FrontPanel Interface 0
capabilities : fast,simple/complex,allresets
ether_link1 (51) - Checks the link status is ”UP” on 82580 Gigabit FrontPanel Interface 1
capabilities : fast,simple/complex,allresets
ether_link2 (52) - Checks the link status is ”UP” on 82580 Gigabit Rear Interface 2
capabilities : fast,simple/complex,allresets
ether_link3 (53) - Checks the link status is ”UP” on 82580 Gigabit Rear Interface 3
capabilities : fast,simple/complex,allresets
sata0_dev_see (63) - Checks if a SATA0 disk on rear P0 is present
capabilities : fast,simple/complex,allresets
sata1_dev_see (64) - Checks if a SATA1 disk on rear P0 is present
capabilities : fast,simple/complex,allresets
sata2_dev_see (65) - Checks if a SATA2 HDD disk on board is present
capabilities : fast,simple/complex,allresets
sata3_dev_see (66) - Checks if a SATA3 mezzanine device is present
capabilities : fast,simple/complex,allresets
sata4_dev_see (67) - Checks if a SATA4 SDD on Board device is present
capabilities : fast,simple/complex,allresets
vme_check (73) - Checks ALMA VME device access
capabilities : fast,simple/complex,allresets
pmcA_xmc_see (77) - Checks if device is present on PMCA 64bits/XMC slot
capabilities : fast,simple/complex,allresets
pmcB_xmc_see (79) - Checks if device is present on PMCB 32bits/XMC slot
capabilities : fast,simple/complex,allresets
usb0_dev_see (80) - Check if a USB0 device on front panel is present
capabilities : fast,simple/complex,allresets
usb1_dev_see (81) - Check if a FDM-USB device on mezzanine is present
capabilities : fast,simple/complex,allresets
usb2_dev_see (82) - Check if a USB2 device on Rear P0 is present
capabilities : fast,simple/complex,allresets
usb3_dev_see (83) - Check if a USB3 device on rear P0 is present
capabilities : fast,simple/complex,allresets
usb4_dev_see (84) - Check if a USB4 device on FPIO is present
capabilities : fast,simple/complex,allresets
VM6052/VM6054 PBIT User's Guide
Page 10 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
usb5_dev_see (85) - Check if a USB5 device on FPIO is present
capabilities : fast,simple/complex,allresets
v2pmc2_check (90) - Checks V2PMC2 paths & slots
capabilities : fast,simple/complex,allresets
v2pmc2_pmc_see (91) - Checks a PMC is present on V2PMC
capabilities : fast,simple/complex,allresets
faultytest (98) - A dummy test that returns FAIL
capabilities : fast,simple,allresets
hangtest (99) - A dummy test that will hang
capabilities : fast,simple,allresets
Use 'help kdiag' to get more info.
VM6054>
To run the default PBIT, enter the command:
VM6054> kdiag run
PBIT Overview
1.5.2Not Selected Tests List
The second part of the list includes all the tests not currently selected for execution. These tests appear at the
end of the “kdiag” command after the message “Other PBITs available but not yet configured”:
Other PBITs available but not yet configured :
mem_bitflip (3) - Checks Mem/ECC using bit-flip pattern ((1 << (offset % 64))
capabilities : slow/fast,simple,allresets
mem_addrpat (4) - Checks Memory/ECC using address pattern (offset)
capabilities : slow/fast,simple,allresets
mem_addrpat2 (5) - Checks Memory/ECC using address pattern (~offset)
capabilities : slow/fast,simple,allresets
therm (12) - Print temperatures and power consumption
capabilities : fast,simple,allresets
ether_link0 (50) - Checks the link status is ”UP” on 82580 Gigabit FrontPanel Interface 0
capabilities : fast,simple/complex,allresets
ether_link1 (51) - Checks the link status is ”UP” on 82580 Gigabit FrontPanel Interface 1
capabilities : fast,simple/complex,allresets
ether_link2 (52) - Checks the link status is ”UP” on 82580 Gigabit Rear Interface 2
capabilities : fast,simple/complex,allresets
ether_link3 (53) - Checks the link status is ”UP” on 82580 Gigabit Rear Interface 3
capabilities : fast,simple/complex,allresets
sata0_dev_see (63) - Checks if a SATA0 disk on rear P0 is present
capabilities : fast,simple/complex,allresets
sata1_dev_see (64) - Checks if a SATA1 disk on rear P0 is present
capabilities : fast,simple/complex,allresets
sata2_dev_see (65) - Checks if a SATA2 HDD disk on board is present
capabilities : fast,simple/complex,allresets
sata3_dev_see (66) - Checks if a SATA3 mezzanine device is present
capabilities : fast,simple/complex,allresets
SD.DT.G35-0e Page 11
PBIT Overview
sata4_dev_see (67) - Checks if a SATA4 SDD on Board device is present
capabilities : fast,simple/complex,allresets
vme_check (73) - Checks ALMA VME device access
capabilities : fast,simple/complex,allresets
pmcA_xmc_see (77) - Checks if device is present on PMCA 64bits/XMC slot
capabilities : fast,simple/complex,allresets
pmcB_xmc_see (79) - Checks if device is present on PMCB 32bits/XMC slot
capabilities : fast,simple/complex,allresets
usb0_dev_see (80) - Check if a USB0 device on front panel is present
capabilities : fast,simple/complex,allresets
usb1_dev_see (81) - Check if a FDM-USB device on mezzanine is present
capabilities : fast,simple/complex,allresets
usb2_dev_see (82) - Check if a USB2 device on Rear P0 is present
capabilities : fast,simple/complex,allresets
usb3_dev_see (83) - Check if a USB3 device on rear P0 is present
capabilities : fast,simple/complex,allresets
usb4_dev_see (84) - Check if a USB4 device on FPIO is present
capabilities : fast,simple/complex,allresets
usb5_dev_see (85) - Check if a USB5 device on FPIO is present
capabilities : fast,simple/complex,allresets
v2pmc2_check (90) - Checks V2PMC2 paths & slots
capabilities : fast,simple/complex,allresets
v2pmc2_pmc_see (91) - Checks a PMC is present on V2PMC
capabilities : fast,simple/complex,allresets
faultytest (98) - A dummy test that returns FAIL
capabilities : fast,simple,allresets
hangtest (99) - A dummy test that will hang
capabilities : fast,simple,allresets
VM6052/VM6054 PBIT User's Guide
Use 'help kdiag' to get more info.
VM6054>
The unselected tests list contains:
> Memory tests to complete the default memory tests. Long execution time.
> SMBus tests: I2C tests on the backplane, reserved for complex test with specific external equipment.
Do not use it.
> External equipment dependent tests to check Ethernet link, XMC presence, connected SATA and USB
Devices. Only use them when it is necessary to verify a device presence.
> Utility tests: “faultytest” helps you to test the error reporting mechanism. “hangtest” is useful for watchdog
recovery checking.
All the USB device detection tests are limited to USB Mass storage devices. They will not detect USB
keyboard or mouse. Use system test number 89 if you want to check USB mouse or keyboard presence.
Page 12 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
PBIT Overview
1.6PBIT Execution Time
The default PBIT (see section 1.5.1 page 8) runs in about -30 seconds for an 8 GB DRAM board without the
system test configured.
Below is the execution time for each test and for a board with 8 GB DRAM.
Tests with a significant duration compared to the other tests appear in red.
Test nameTest ID numberExecution Time
mem_data (fast,simple)1500 ms
mem_addr (fast,simple)2700 ms
mem_pattern1 (slow,simple)64.5s
mem_pattern2 (slow,simple)74.5s
mem_pattern3 (slow,simple)84.5s
mem_pattern4 (slow,simple)94.5s
core_dmi (fast,simple)10<300 ms
tpm (fast,simple)11Not Available
serial (fast,simple)16400 ms
rtc (fast,simple)20<300 ms
sysflash (fast,simple)22<300 ms
cpld (fast,simple)241.8 s
temp_sensors (fast,simple)31<300 ms
temperature (fast,simple)32<300 ms
fnvram (fast,simple)402.8s
ether_loop0 (fast,simple)551.6s
ether_loop1 (fast,simple)561.6s
ether_loop2 (fast,simple)571.6s
ether_loop3 (fast,simple)581.6s
voltage (fast,simple)60<300 ms
hwmon (fast,simple)61350 ms
sata0_controler (fast,simple)68<300 ms
sata1_controler (fast,simple)69<300 ms
vpd (fast,simple)70<300 ms
eeprom (fast,simple)71550 ms
pmcA_xmc_check (fast,simple)
pmcB_xmc_check (fast,simple)
(2)
(2)
76<300 ms
78<300 ms
usb1_controller (fast,simple)86<300 ms
usb2_controller (fast,simple)87<300 ms
system (fast,simple)
(3)
891s to 12s. Configurable.
About 1s if all tested Ethernet links are connected.
3s must be added for each Ethernet link unconnected.
(1)
(1)
TPM Not equipped
(2)
Tests done with PMC PMC-676RCTX or XMC XMC-401 plugged on PMC / XMC connector
(3)
The execution time for the system test depends on the configuration and if the test is successful or
not. In case of Ethernet Link not present on all interfaces the execution time may reach 12s (3s per
Ethernet link not connected). To save execution time it is advised to remove test on unconnected
Ethernet link with command “kdiag system_edit” .
SD.DT.G35-0e Page 13
PBIT Command Line Reference Guide
VM6052/VM6054 PBIT User's Guide
Chapter 2 -PBIT Command Line Reference Guide
The PBIT are configured and executed using the EFI Shell command «kdiag».
The following section describes the various “kdiag” command parameters.
2.1On-line Help
At EFI Shell prompt enter the command “help kdiag” to display the usage messages.
Note: the command formats are
4 [ ] meaning optional parameters
4 | meaning a OR choice between possible parameters
4 ... meaning an undetermined number of repeated previous parameters
VM6054> help kdiag
kdiag perform board diagnostics
----- Usage ----Print list of PBITs and infos about them :
kdiag [<PBITname>|<PBITnum> ...]
<PBITname>|<PBITnum> ...
list of PBIT(s) to display. All if the list is empty.
PBIT(s) are referenced using their name or their number.
Run PBIT(s) from command line :
kdiag run [loop <count>] [<PBITname>|<PBITnum> ...]
loop <count>
run PBIT(s) <count> times instead of once
<PBITname>|<PBITnum> ...
list of PBIT(s) to run. All if the list is empty.
PBIT(s) are referenced using their name or their number.
Print PBIT(s) status :
kdiag stat [oside] [<PBITname>|<PBITnum> ...]
<PBITname>|<PBITnum> ...
list of PBIT(s) to display. All if the list is empty.
PBIT(s) are referenced using their name or their number.
oside (VX6060 board only): clear PBIT status of peer CPU side
- ”delete” to delete PBIT(s) from the list of configured PBITs
- ”default” to configure PBIT(s) with a default run mode
- a comma separated list of runflags defining a PBIT
run mode; for example : fast,complex.
valid runflags are :
- ”SPEED” flags (can NOT be mixed)
slow : run in slow mode (full testing)
fast : run in fast mode (fast testing)
- ”CONFIG” flags (can NOT be mixed)
simple : run in simple mode (no external hardware)
complex : run in complex mode (needs external hardware)
- ”HALT” flags (can NOT be mixed)
haltonfail : halt immediately (hang) if test fails
promptonfail : halt at Firmware prompt (no OS boot) if test fails
- ”RESET” flags (can be mixed together)
normalreset : run after a normal reset
poweronreset : run after a power-on reset
allresets : run after all resets listed above
SD.DT.G35-0e Page 15
PBIT Command Line Reference Guide
[<PBITname>|<PBITnum>] ...
list of PBIT(s) to configure.
PBIT(s) are referenced using their name or their number.
All configured tests if the list is empty
oside (VX6060 board only): Configure PBIT(s) for peer CPU side
Toggle PBIT running log information:
kdiag silent
Record System Configuration for system Test:
kdiag system_learn or kdiag learn system
Edit System Configuration for system Test:
(cf documentation for details)
kdiag system_edit or kdiag edit system
VM6052/VM6054 PBIT User's Guide
Clear System Configuration for system Test:
kdiag system_clear or kdiag clear system
Display PBIT version :
kdiag version
Page 16 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
PBIT Command Line Reference Guide
2.2Display the List of Selected Tests
To display the selected tests list and their configuration use the command:
“kdiag [<PBITname>|<PBITnum> ...]”.
Running the command “
mand “kdiag run” and also the other tests not selected by default.
VM6054> kdiag
PBITs configured to run from command line :
mem_data (1) - Checks Memory/ECC data lines
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
mem_addr (2) - Checks Memory/ECC address lines
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
mem_pattern1 (6) - Checks Memory/ECC using pattern 0xFFFFFFFF
capabilities : slow/fast,simple,allresets
run mode 1 : slow,simple,allresets
mem_pattern2 (7) - Checks Memory/ECC using pattern 0x55555555
capabilities : slow/fast,simple,allresets
run mode 1 : slow,simple,allresets
mem_pattern3 (8) - Checks Memory/ECC using pattern 0xAAAAAAAA
capabilities : slow/fast,simple,allresets
run mode 1 : slow,simple,allresets
mem_pattern4 (9) - Checks Memory/ECC using pattern 0x00000000
capabilities : slow/fast,simple,allresets
run mode 1 : slow,simple,allresets
core_dmi (10) - Checks Core & DMI bus
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
tpm (11) - Checks TPM access
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
serial (16) - Checks the serial line COM2
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
rtc (20) - Checks the RTC time
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
sysflash (22) - Checks the BIOS rescue in system flash
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
cpld (24) - Checks PLD, GeoAddress, watchdog
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
temp_sensors (31) - Checks if all temperature sensors are detected.
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
temperature (32) - Checks if temperatures are OK.
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
kdiag” with no argument prints the list of the tests that are selected to run with the com
SD.DT.G35-0e Page 17
PBIT Command Line Reference Guide
fnvram (40) - Checks F-NVRAM device.
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
ether_loop0 (55) - Checks 82580 Gigabit FrontPanel Interface 0 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
ether_loop1 (56) - Checks 82580 Gigabit FrontPanel Interface 1 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
ether_loop2 (57) - Checks 82580 Gigabit Rear Interface 2 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
ether_loop3 (58) - Checks 82580 Gigabit Rear Interface 3 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
voltage (60) - Checks the voltage sensors & value
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
hwmon (61) - Checks hardware monitoring, temperature and voltage sensors
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
sata0_controler (68) - Checks sata0 controller
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
sata1_controler (69) - Check sata1 controller
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
vpd (70) - Checks VPD data required for board operation.
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
eeprom (71) - Checks User EEPROM (0xA2)
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
pmcA_xmc_check (76) - Checks PMCA 64bits/XMC path & slot
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
pmcB_xmc_check (78) - Checks PMCB 32bits/XMC path & slot
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
usb1_controller (86) - Check first PCH usb controller
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
usb2_controller (87) - Check second PCH usb controller
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
xHCI_controller (88) - Check xHCI PCH usb 3.0 controller
capabilities : fast,simple,allresets
run mode 1 : fast,simple,allresets
system (89) - Checks system configuration SETUP,PCIe,SATA,USB,ETH stability
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,allresets
VM6052/VM6054 PBIT User's Guide
Page 18 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
Other PBITs available but not yet configured :
mem_bitflip (3) - Checks Mem/ECC using bit-flip pattern ((1 << (offset % 64))
capabilities : slow/fast,simple,allresets
mem_addrpat (4) - Checks Memory/ECC using address pattern (offset)
capabilities : slow/fast,simple,allresets
mem_addrpat2 (5) - Checks Memory/ECC using address pattern (~offset)
capabilities : slow/fast,simple,allresets
therm (12) - Print temperatures and power consumption
capabilities : fast,simple,allresets
ether_link0 (50) - Checks the link status is ”UP” on 82580 Gigabit FrontPanel Interface 0
capabilities : fast,simple/complex,allresets
ether_link1 (51) - Checks the link status is ”UP” on 82580 Gigabit FrontPanel Interface 1
capabilities : fast,simple/complex,allresets
ether_link2 (52) - Checks the link status is ”UP” on 82580 Gigabit Rear Interface 2
capabilities : fast,simple/complex,allresets
ether_link3 (53) - Checks the link status is ”UP” on 82580 Gigabit Rear Interface 3
capabilities : fast,simple/complex,allresets
sata0_dev_see (63) - Checks if a SATA0 disk on rear P0 is present
capabilities : fast,simple/complex,allresets
sata1_dev_see (64) - Checks if a SATA1 disk on rear P0 is present
capabilities : fast,simple/complex,allresets
sata2_dev_see (65) - Checks if a SATA2 HDD disk on board is present
capabilities : fast,simple/complex,allresets
sata3_dev_see (66) - Checks if a SATA3 mezzanine device is present
capabilities : fast,simple/complex,allresets
sata4_dev_see (67) - Checks if a SATA4 SDD on Board device is present
capabilities : fast,simple/complex,allresets
vme_check (73) - Checks ALMA VME device access
capabilities : fast,simple/complex,allresets
pmcA_xmc_see (77) - Checks if device is present on PMCA 64bits/XMC slot
capabilities : fast,simple/complex,allresets
pmcB_xmc_see (79) - Checks if device is present on PMCB 32bits/XMC slot
capabilities : fast,simple/complex,allresets
usb0_dev_see (80) - Check if a USB0 device on front panel is present
capabilities : fast,simple/complex,allresets
usb1_dev_see (81) - Check if a FDM-USB device on mezzanine is present
capabilities : fast,simple/complex,allresets
usb2_dev_see (82) - Check if a USB2 device on Rear P0 is present
capabilities : fast,simple/complex,allresets
usb3_dev_see (83) - Check if a USB3 device on rear P0 is present
capabilities : fast,simple/complex,allresets
usb4_dev_see (84) - Check if a USB4 device on FPIO is present
capabilities : fast,simple/complex,allresets
usb5_dev_see (85) - Check if a USB5 device on FPIO is present
capabilities : fast,simple/complex,allresets
v2pmc2_check (90) - Checks V2PMC2 paths & slots
capabilities : fast,simple/complex,allresets
v2pmc2_pmc_see (91) - Checks a PMC is present on V2PMC
capabilities : fast,simple/complex,allresets
PBIT Command Line Reference Guide
SD.DT.G35-0e Page 19
PBIT Command Line Reference Guide
faultytest (98) - A dummy test that returns FAIL
capabilities : fast,simple,allresets
hangtest (99) - A dummy test that will hang
capabilities : fast,simple,allresets
Use 'help kdiag' to get more info.
VM6054>
VM6052/VM6054 PBIT User's Guide
Page 20 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
PBIT Command Line Reference Guide
2.3Execute the PBIT from the Command Line
To run the PBIT selected tests list from the command line, enter:
Upon failure of any test, a specific “FAILED ONCE” flag is set. This flag is kept even if this test is successfully
PASSED later. This feature has been designed to keep track of intermittent failures.
> To clear the PBIT results enter:
VM6054> kdiag clrstat
> To clear all the PBIT history including the “FAILED ONCE” flags, enter:
VM6054> kdiag clrallstat
Page 24 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
PBIT Command Line Reference Guide
2.7Configure the PBIT Tests List to Execute
The list of tests to execute can be modified with the “kdiag” command.
Each test can be added, removed and configured with a specific run mode. If no run mode is specified then the
default run mode (fast,simple) is applied.
2.7.1Run mode parameters
The possible specific run modes are defined with the following test flags:
> HALT flag (can NOT be mixed):
haltonfail: halt immediately (hang) if test fails
promptonfail: halt at BIOS prompt (no OS boot) if test fails
This flag offers the possibility to halt all test execution when an error is detected.
> SPEED flag (can NOT be mixed)
slow: run in slow mode (full testing)
fast: run in fast mode (fast testing)
In the current PBIT version, no test implements a difference between fast and slow modes.
> CONFIG flag (can NOT be mixed)
simple: run in simple mode (no external hardware)
complex: run in complex mode (needs external hardware)
Complex mode requires external devices to the VM6052/VM6054 and is reserved for the factory tests.
> RESET flag
normalreset: run after a normal reset (means a board warm boot).
poweronreset: run after a power-on reset (PBIT with this flag will run only when board is
--> usb1_controller (86) - Check first PCH usb controller
--> usb2_controller (87) - Check second PCH usb controller
--> system (89) - Checks system configuration SETUP,PCIe,SATA,USB,ETH stability
SD.DT.G35-0e Page 27
PBIT Command Line Reference Guide
For example to set promptonfail, poweronreset run mode for all tests of current run list:
VM6054> kdiag cfg promptonfail,poweronreset
Configuration of current tests in asked mode:
command,fast,simple,promptonfail,poweronreset
List of test to configure
--> usb1_controller (86) - Check first PCH usb controller
--> usb2_controller (87) - Check second PCH usb controller
VM6052/VM6054 PBIT User's Guide
Page 28 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
Verify with kdiag command, the run mode is promptonfail, poweronreset for all tests in the run list:
VM6054> kdiag
PBITs configured to run from command line :
mem_data (1) - Checks Memory/ECC data lines
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
mem_addr (2) - Checks Memory/ECC address lines
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
mem_pattern1 (6) - Checks Memory/ECC using pattern 0xFFFFFFFF
capabilities : slow/fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
mem_pattern2 (7) - Checks Memory/ECC using pattern 0x55555555
capabilities : slow/fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
mem_pattern3 (8) - Checks Memory/ECC using pattern 0xAAAAAAAA
capabilities : slow/fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
mem_pattern4 (9) - Checks Memory/ECC using pattern 0x00000000
capabilities : slow/fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
core_dmi (10) - Checks Core & DMI bus
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
tpm (11) - Checks TPM access
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
serial (16) - Checks the serial line COM2
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
rtc (20) - Checks the RTC time
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
sysflash (22) - Checks the BIOS rescue in system flash
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
cpld (24) - Checks PLD, GeoAddress, watchdog
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
temp_sensors (31) - Checks if all temperature sensors are detected.
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
temperature (32) - Checks if temperatures are OK.
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
fnvram (40) - Checks F-NVRAM device.
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
ether_loop0 (55) - Checks 82580 Gigabit FrontPanel Interface 0 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
PBIT Command Line Reference Guide
SD.DT.G35-0e Page 29
PBIT Command Line Reference Guide
ether_loop1 (56) - Checks 82580 Gigabit FrontPanel Interface 1 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
ether_loop2 (57) - Checks 82580 Gigabit Rear Interface 2 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
ether_loop3 (58) - Checks 82580 Gigabit Rear Interface 3 in Loopback mode
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
voltage (60) - Checks the voltage sensors & value
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
hwmon (61) - Checks hardware monitoring, temperature and voltage sensors
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
sata0_controler (68) - Checks sata0 controller
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
sata1_controler (69) - Check sata1 controller
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
vpd (70) - Checks VPD data required for board operation.
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
eeprom (71) - Checks User EEPROM (0xA2)
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
pmcA_xmc_check (76) - Checks PMCA 64bits/XMC path & slot
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
pmcB_xmc_check (78) - Checks PMCB 32bits/XMC path & slot
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
usb1_controller (86) - Check first PCH usb controller
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
usb2_controller (87) - Check second PCH usb controller
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
system (89) - Checks system configuration SETUP,PCIe,SATA,USB,ETH stability
capabilities : fast,simple/complex,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
VM6052/VM6054 PBIT User's Guide
Verify for test 1:
VM6054> kdiag 1
mem_data (1) - Checks Memory/ECC data lines
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
The command will not include the test numbers greater than 95 (hangtest, faulty) because these tests are
tool tests for PBIT validation.
Page 30 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
PBIT Command Line Reference Guide
2.7.5Quickly configure all tests in specific mode
The fastest method to configure all PBIT in a specific mode (like promptonfail, poweronreset …) is to:
1. delete all tests with kdiag deleteall
2. add all default tests with kdiag default
3. Configure tests with kdiag cfg <mode1, mode2>
Example to configure all tests in poweronreset and promptonfail mode
VM6054> kdiag deleteall
VM6054> kdiag default
VM6054> kdiag cfg promptonfail,poweronreset
Configuration of current tests in asked mode:
command,fast,simple,promptonfail,poweronreset
List of test to configure
--> usb1_controller (86) - Check first PCH usb controller
--> usb2_controller (87) - Check second PCH usb controller
--> system (89) - Checks system configuration SETUP,PCIe,SATA,USB,ETH stability
SD.DT.G35-0e Page 31
PBIT Command Line Reference Guide
Verify for test 1:
VM6054> kdiag 1
mem_data (1) - Checks Memory/ECC data lines
capabilities : fast,simple,allresets
run mode 1 : fast,simple,promptonfail,poweronreset
Then don't forget to remove unwanted test with command kdiag cfg delete <test_name> or <test_number>
VM6052/VM6054 PBIT User's Guide
2.7.6Restore the Default Run List
To restore the default run tests list, enter:
VM6054> kdiag default
Page 32 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
PBIT Command Line Reference Guide
2.8Run the PBIT in Silent Mode
To avoid the PBIT to display test messages during execution, use the toggle command:
VM6054> kdiag silent
PBIT set in silent mode
To disable the silent mode, re-execute the same command:
VM6054> kdiag silent
PBIT silent mode removed
1: In this mode error messages are displayed anyway.
2: To prevent any output messages to the serial line, use the BIOS setup configuration (Serial Line
Console Redirection).
2.9Display the PBIT Version
To display the PBIT version, enter:
VM6054> kdiag version
PBIT VERSION 1.3 ID14105
SD.DT.G35-0e Page 33
PBIT Command Line Reference Guide
VM6052/VM6054 PBIT User's Guide
2.10PBIT System Test
2.10.1Recording the system configuration:
The command “kdiag system_learn” or "kdiag learn system" is used to record the current system
configuration. It must be run for each configuration of a new system.
It records:
4 All the detected PCI devices (the list is visible with the BIOS shell command “
00 02 00 01 ==> Network Controller - Ethernet controller
Vendor 8086 Device 150E Prog Interface 0
00 02 00 02 ==> Network Controller - Ethernet controller
Vendor 8086 Device 150E Prog Interface 0
00 02 00 03 ==> Network Controller - Ethernet controller
Vendor 8086 Device 150E Prog Interface 0
00 04 00 00 ==> Bridge Device - PCI/PCI bridge
Vendor 10B5 Device 8112 Prog Interface 0
00 05 09 00 ==> Bridge Device - Other bridge type
Vendor 1059 Device 9035 Prog Interface 0
CPLD Version 0x2
DRAM size 8 GB
System Controller
Geographical Address 3
XMC not present
SATA PORT 1 WDC WD2502ABYS (251.0GB)
SATA PORT 4 GLS85LS1032A C (32.0GB)
Device detected on SMBUS0, address = 0x34
BIOS Setup Checksum : 87179
BIOS Version : ID14112
1 Drive, 2 Hubs
MassStorage Device name (0) : KingstonDataTravele
USB Port 0 connected
PBIT Command Line Reference Guide
Number of System Test Elements detected : 92
DRAM area [ 0x1548BC0 0x1549820 ] will be stored in EEPROM
Storing system infos...
Storing system configuration...
2.10.2Testing the current system configuration:
The test named “system” is used to read the current system configuration and check it against the recorded
configuration. The command used is “kdiag run system” (equivalent to “kdiag system_run”). By default, the
system test prints errors only, and details level is NORMAL.
The following is an example showing several detected failures:
4 1st Error: a BIOS settings have been changed in setup
4 2nd Error: an Ethernet cable on front panel has been plugged
4 3rd,4th and 5th Errors: an USB drive key on front panel has been removed
SD.DT.G35-0e Page 35
PBIT Command Line Reference Guide
VM6052/VM6054 PBIT User's Guide
2.10.3Editing the system configuration:
A menu is available to edit the system configuration. This menu allows to IGNORE specific items.
For example it is possible to ignore checking SATA disk size or USB keyboard connected ...
The menu also allows configuring a specific level of debug when the system test is executed. To enter system
edit menu enter:
VM6054>kdiag edit system
Equivalent to:
VM6054>kdiag system_edit
The menu is displayed only if a system configuration has been previously recorded with the “kdiag learn sys‐
” (or kdiag system_learn) command. To the contrary a message informs that no configuration has been
tem
recorded yet:
SYSTEM INFOS NOT SAVED
Once edited the system edition gives you a prompt and is organized with sublevel menus. Help is available from
any submenu by typing ‘?’.
Two mains features can be distinguished:
4 the Ignore menu to bypass specific item verification
4 the print debug setting menu to modify the debug level and manage the scroll limit for it.
Page 36 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
PBIT Command Line Reference Guide
2.10.3.1 Edit system items (to ignore specific test)
By default, all the items of the system test are checked. The system edit menu allows user to choose which items
will be ignored during the next system test executions.
It is possible to ignore all or part of specific elements of the system test structures. For example an USB port,
a SATA port, an Ethernet interface, SMBUS devices, information from the CPLD as the System Controller Status
etc.
The following shows a
SATA port 1, all the devices on SMBUS1, all information for the Bridge PCI/VME (PCI device 05), all bios
information and the Ethernet interfaces 2 and 3:
VM6054>kdiag system_edit
<< KONTRON SYSTEM PBIT : EDIT MODE >>
Edit by feature, choose:PCI CPLD SATA ETH USB SMBUS BIOS
Other available cmds: `s' for settings, `?' for help, `q' to quit edit mode
--SystemEdit>>cpld
--SystemEdit-CPLD>>?
p : print Recorded values
0,..,4 : edit CPLD element
ignoreall : ignore all CPLD infos
default : restore default CPLD config (remove flags)
? : help
q : go back to main menu
--SystemEdit-CPLD>>p
0. CPLD Version 0x2
1. CPLD Dram Size 8GB
2. CPLD SysCon System Controller
3. CPLD Geo Address 3
4. CPLD XMC Presence XMC not present
--SystemEdit-CPLD>>2
--SystemEdit-CPLD-SysCon>>?
p : print Recorded value
i : set ignore flag
r : remove flag
? : help
q : go back to CPLD menu
--SystemEdit-CPLD-SysCon>>i
Ignore flag has been set
*-SystemEdit-CPLD-SysCon>>q
*-SystemEdit-CPLD>>p
0. CPLD Version 0x2
1. CPLD Dram Size 8GB
2. CPLD SysCon System Controller (i)
3. CPLD Geo Address 3
4. CPLD XMC Presence XMC not present
*-SystemEdit-CPLD>> << KONTRON SYSTEM PBIT : EDIT MODE >>
Edit by feature, choose:PCI CPLD (*) SATA ETH USB SMBUS BIOS
Other available cmds: `s' for settings, `?' for help, `q' to quit edit mode
*-SystemEdit>>sata
*-SystemEdit-SATA>>p
system_edit session ignoring the System Controller status information from CPLD, the
SD.DT.G35-0e Page 37
PBIT Command Line Reference Guide
0. SATA Port 0 Not Connected (0.0GB)
1. SATA Port 1 WDC WD2502ABYS (251.0GB
2. SATA Port 2 Not Connected (0.0GB)
3. SATA Port 3 Not Connected (0.0GB)
4. SATA Port 4 GLS85LS1032A C (32.0GB)
*-SystemEdit-SATA>>1
*-SystemEdit-SATA-Port 1>>i
Ignore flag has been set
*-SystemEdit-SATA-Port 1>>p
WDC WD2502ABYS (251.0GB(i)
*-SystemEdit-SATA-Port 1>>
*-SystemEdit-SATA>>p
0. SATA Port 0 Not Connected (0.0GB)
1. SATA Port 1 WDC WD2502ABYS (251.0GB(i)
2. SATA Port 2 Not Connected (0.0GB)
3. SATA Port 3 Not Connected (0.0GB)
4. SATA Port 4 GLS85LS1032A C (32.0GB)
*-SystemEdit-SATA>> << KONTRON SYSTEM PBIT : EDIT MODE >>
Edit by feature, choose:PCI CPLD (*) SATA (*) ETH USB SMBUS BIOS
Other available cmds: `s' for settings, `?' for help, `q' to quit edit mode
*-SystemEdit>>smbus
*-SystemEdit-SMBUS>>?
p : print Recorded values
0,..,1 : edit SMBUS element
ignoreall : ignore all SMBUS infos
default : restore default SMBUS config (remove flags)
? : help
q : go back to main menu
*-SystemEdit-SMBUS>>p
0. SMBUS0
SMBUS0 Device 0 0x34
SMBUS0 Device 1 No Device
SMBUS0 Device 2 No Device
SMBUS0 Device 3 No Device
SMBUS0 Device 4 No Device
SMBUS0 Device 5 No Device
SMBUS0 Device 6 No Device
SMBUS0 Device 7 No Device
SMBUS0 Device 8 No Device
SMBUS0 Device 9 No Device
1. SMBUS1
SMBUS1 Device 0 No Device
SMBUS1 Device 1 No Device
SMBUS1 Device 2 No Device
SMBUS1 Device 3 No Device
SMBUS1 Device 4 No Device
SMBUS1 Device 5 No Device
SMBUS1 Device 6 No Device
SMBUS1 Device 7 No Device
SMBUS1 Device 8 No Device
SMBUS1 Device 9 No Device
VM6052/VM6054 PBIT User's Guide
Page 38 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
*-SystemEdit-SMBUS>>1
*-SystemEdit-SMBUS-SMBUS1>>?
p : print Recorded values
0,..,9 : edit SMBUS1 element
ignoreall : ignore all SMBUS1 infos
default : restore default SMBUS1 config (remove flags)
? : help
q : go back to SMBUS menu
*-SystemEdit-SMBUS-SMBUS1>>ignoreall
SMBUS1 entirely ignored
*-SystemEdit-SMBUS-SMBUS1>>p
0. No Device (i)
1. No Device (i)
2. No Device (i)
3. No Device (i)
4. No Device (i)
5. No Device (i)
6. No Device (i)
7. No Device (i)
8. No Device (i)
9. No Device (i)
*-SystemEdit-SMBUS-SMBUS1>>
*-SystemEdit-SMBUS>> << KONTRON SYSTEM PBIT : EDIT MODE >>
PBIT Command Line Reference Guide
Edit by feature, choose:PCI CPLD (*) SATA (*) ETH USB SMBUS (*) BIOS
Other available cmds: `s' for settings, `?' for help, `q' to quit edit mode
*-SystemEdit>>pci
*-SystemEdit-PCI>>?
pa : print all Recorded PCI device infos
p1 : print Recorded VendorID only
p2 : print Recorded DeviceID only
p3 : print Recorded ClassCode only
p4 : print Recorded Linkstatus only (only for PCI/PCI bridge)
p5 : print Recorded Link Speed/Width only (only for PCI/PCI bridge)
p : print Recorded values
0,..,39 : edit PCI element
ignoreall : ignore all PCI infos
default : restore default PCI config (remove flags)
? : help
q : go back to main menu
*-SystemEdit-PCI>>p
20. PCI No Device No Device/No Device [FAILED ONCE] [LAST FAILED]
21. PCI No Device No Device/No Device
22. PCI No Device No Device/No Device [FAILED ONCE] [LAST FAILED]
23. PCI No Device No Device/No Device
24. PCI No Device No Device/No Device
25. PCI No Device No Device/No Device
26. PCI No Device No Device/No Device [FAILED ONCE] [LAST FAILED]
27. PCI No Device No Device/No Device
28. PCI No Device No Device/No Device
29. PCI No Device No Device/No Device
30. PCI No Device No Device/No Device
31. PCI No Device No Device/No Device
32. PCI No Device No Device/No Device [FAILED ONCE] [LAST FAILED]
33. PCI No Device No Device/No Device
34. PCI No Device No Device/No Device
35. PCI No Device No Device/No Device
36. PCI No Device No Device/No Device [FAILED ONCE] [LAST FAILED]
37. PCI No Device No Device/No Device
38. PCI No Device No Device/No Device
39. PCI No Device No Device/No Device
*-SystemEdit-PCI>>17
*-SystemEdit-PCI-05:09:00>>ignoreall
PCI 05:09:00 entirely ignored
*-SystemEdit-PCI-05:09:00>>p
0. VendorId 0x1059 (i)
1. DeviceId 0x9035 (i)
2. ClassCode 068000 (i)
Prog Interface 0
BaseClass Bridge Device
SubClass Other bridge type
*-SystemEdit-PCI-05:09:00>>
*-SystemEdit-PCI>> << KONTRON SYSTEM PBIT : EDIT MODE >>
Edit by feature, choose:PCI (*) CPLD (*) SATA (*) ETH USB SMBUS (*) BIOS
Other available cmds: `s' for settings, `?' for help, `q' to quit edit mode
VM6052/VM6054 PBIT User's Guide
*-SystemEdit>> bios
*-SystemEdit-BIOS>>?
p : print Recorded values
0,..,1 : edit BIOS element
ignoreall : ignore all BIOS infos
default : restore default BIOS config (remove flags)
Page 40 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
? : help
q : go back to main menu
*-SystemEdit-BIOS>>p
1. BIOS Version ID14112
*-SystemEdit-BIOS>> << KONTRON SYSTEM PBIT : EDIT MODE >>
Edit by feature, choose:PCI (*) CPLD (*) SATA (*) ETH USB SMBUS (*) BIOS (*)
Other available cmds: `s' for settings, `?' for help, `q' to quit edit mode
*-SystemEdit>>eth
*-SystemEdit-ETH>>p
0. ETH Port 0 Not Connected [FAILED ONCE] [LAST FAILED]
1. ETH Port 1 Not Connected
2. ETH Port 2 Not Connected
3. ETH Port 3 Not Connected
*-SystemEdit-ETH>>0
*-SystemEdit-ETH-Port 0>>i
Ignore flag has been set
*-SystemEdit-ETH-Port 0>>
*-SystemEdit-ETH>>p
0. ETH Port 0 Not Connected (i) [FAILED ONCE] [LAST FAILED]
1. ETH Port 1 Not Connected
2. ETH Port 2 Not Connected
3. ETH Port 3 Not Connected
*-SystemEdit-ETH>> << KONTRON SYSTEM PBIT : EDIT MODE >>
PBIT Command Line Reference Guide
Edit by feature, choose:PCI (*) CPLD (*) SATA (*) ETH (*) USB SMBUS (*) BIOS (*)
Other available cmds: `s' for settings, `?' for help, `q' to quit edit mode
*-SystemEdit>>q
Modifications have been made.
Do you want to save your configuration before leaving? (y/n)
*-SystemEdit-Save>>y
VM6054>
System stats are displayed when we print recorded values with command ‘p’ ([LAST FAILED] and/or [FAILED
ONCE
] labels).
SD.DT.G35-0e Page 41
PBIT Command Line Reference Guide
VM6052/VM6054 PBIT User's Guide
2.10.3.2 Print debug settings
By default, the system test prints errors only, and detail level is normal. It is possible to modify these general
parameters in this menu.
> 3 print levels are available:
Errors only, Errors and Infos only, Debug lvl (print all).
Each printed message in system test corresponds to one of these levels and is easily identifiable thanks to 3
labels:
Error: ERR) Info: INF) Debug: DBG)
> Scroll limit for Debug lvl mode ONLY:
If Debug mode is selected, a scroll limit can be set in order to stop scrolling during system test, depending on
the chosen limit: 0 is no limit (do not stop scrolling by default), max for scroll limit is 30 lines. WARNING: WATCH
DOG WILL BE STOPPED during “system” test execution IF SCROLL LIMIT IS NOT 0. Then, at the next system
run, use space (scroll to the limit) or Enter (scroll line by line) to make test results scroll.
> 3 detail levels are available (for experts because not very useful for user): synthetic mode, normal mode and
Detailed mode.
4 Synthetic mode does not display errors and information results but gives the number of errors found by
type and the total.
Example with SYNTHETIC MODE:
VM6054> kdiag run system
PBIT ”system” (fast,simple,promptonfail)
PCI (*) CPLD (*) SATA (*) SMBUS (*) BIOS (*) ETH (*) USB...
ERR)USB Drive's Count (R)1 Drive (D)0 Drive
ERR)USB MassStorage(0) (R)KingstonDataTravele (D)No Device
ERR)USB Port 0 (R)Connected (D)Not Connected
FAILED
****** PBIT error detected. STOP ******
4 Normal mode displays system test results depending on the print level. The classcode value will be printed
for PCI devices.
4 Detailed mode allows to print more details for PCI devices:
It prints classcode value but also, prog interface nb, BaseClass string, SubClass string which are deducted
from classcode value.
> Clear System Stats: used to clear system stats.
1. User has to type the return key to move up to the previous menu in "system_edit" command.
2. User has to type the return key to display one line or on the space key to display several lines if the
bottom of the screen on the serial console has been reached.
Page 42 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
The following shows a system_edit session setting print level to Debug Level, a scroll limit of 10 lines and detail
level to Detailed mode:
Edit by feature, choose:PCI (*) CPLD (*) SATA (*) ETH (*) USB SMBUS (i) BIOS (*)
Other available cmds: `s' for settings, `?' for help, `q' to quit edit mode
--SystemEdit>>s
p : Set Print Level
Current Print Lvl is: ERRORS ONLY
d : Set Detail Level
Current Details Lvl is: SYNTHETHIC
c : Clear System Stats
--SystemEdit-generalSettings>>p
--SystemEdit-generalSettings-printLvl>>?
p : print current print Level
e : ERRORS ONLY mode
i : ERRORS & INFOS ONLY mode
d : DEBUG LVL mode (print all)
q : return to general settings menu
--SystemEdit-generalSettings-printLvl>>d
Print Lvl DEBUG PRINT ALL set, scroll limit is 24 by default
Set Scroll limit (0= no limit , max= 30)
*-SystemEdit-generalSettings-printLvl-Scroll>>10
Scroll Limit set to 10 line(s)
*-SystemEdit-generalSettings-printLvl>>q
p : Set Print Level
Current Print Lvl is: DEBUG PRINT ALL
d : Set Detail Level
Current Details Lvl is: SYNTHETHIC
c : Clear System Stats
*-SystemEdit-generalSettings>>d
*-SystemEdit-generalSettings-detailsLvl>>?
p : print Current Details Lvl
s : synthethic results
n : normal infos
d : detailed
q : return to general settings menu
*-SystemEdit-generalSettings-detailsLvl>>d
Details Lvl DETAILED set
*-SystemEdit-generalSettings-detailsLvl>>q
p : Set Print Level
Current Print Lvl is: DEBUG PRINT ALL
d : Set Detail Level
Current Details Lvl is: DETAILED
c : Clear System Stats
*-SystemEdit-generalSettings>>q << KONTRON SYSTEM PBIT : EDIT MODE >>
Edit by feature, choose:PCI (*) CPLD (*) SATA (*) ETH (*) USB SMBUS (i) BIOS (*)
Other available cmds: `s' for settings, `?' for help, `q' to quit edit mode
PBIT Command Line Reference Guide
*-SystemEdit>>q
Modifications have been made.
Do you want to save your configuration before leaving? (y/n)
*-SystemEdit-Save>>y
SD.DT.G35-0e Page 43
PBIT Command Line Reference Guide
Use important commands ‘ ?’ and ‘p’ to get help and to see recorded values respectively. Note that return (just
VM6052/VM6054 PBIT User's Guide
Enter) is equivalent to ‘q’ (go back to previous menu). Ignored elements are marked with the (i) label. Stats
are shown through [LAST FAILED] and/or [FAILED ONCE] labels.
If the system configuration is edited again, then the excluded information will be marked IGNORED and will not
participate to the test. If IGNORED items changed after the system_learn phase, the system test will not fail
because the tests corresponding to the items are bypassed.
Now, it is possible to remove IGNORED flags one by one (browse menu and type ‘r’ to remove ignore flag of
an element) or remove all flags at once of an object or type (be placed in the right place in the menu and type
‘default’ for a group of elements) in order to test items again.
2.10.4Clearing system stats
To clear [LAST FAILED] and [FAILED ONCE] labels of system test items, enter the kdiag system menu section
general settings and use the following command:
VM6054>kdiag system_edit
<< KONTRON SYSTEM PBIT : EDIT MODE >>
Edit by feature, choose:PCI (*) CPLD (*) SATA (*) ETH (*) USB SMBUS (i) BIOS (*)
Other available cmds: `s' for settings, `?' for help, `q' to quit edit mode
--SystemEdit>>s
p : Set Print Level
Current Print Lvl is: DEBUG PRINT ALL
d : Set Detail Level
Current Details Lvl is: DETAILED
c : Clear System Stats
--SystemEdit-generalSettings>>c
System stats have been cleared
p : Set Print Level
Current Print Lvl is: DEBUG PRINT ALL
d : Set Detail Level
Current Details Lvl is: DETAILED
c : Clear System Stats
--SystemEdit-generalSettings>>
You must exit the menu so that these changes are taken into account.
2.10.5Clearing the system configuration
A command is avavailable to clear the system configuration entirely.To clear the entire configuration, enter:
VM6054>kdiag clear system
Equivalent to:
VM6054>kdiag system_clear
Page 44 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
Then, if a system test is run, no test will be performed and the following will be displayed:
SYSTEM INFOS NOT SAVED
The system test result will be PASSED.
1. To summarize, before running the system test, the specific commands must be performed in this
order: “kdiag learn system” (or “kdiag system_learn”), “kdiag edit system” (or “kdiag
system_edit
system_run
Clearing the entire system configuration will completely bypass the system test.
Learning a system configuration will overwrite a previous recorded configuration.
2. After updating the PBIT or BIOS release, it is recommended to clear and learn the system
configuration again.
”) depending the chosen test granularity then “kdiag run system” (or “kdiag
”).
PBIT Command Line Reference Guide
SD.DT.G35-0e Page 45
PBIT and OS Interfaces
VM6052/VM6054 PBIT User's Guide
Chapter 3 -PBIT and OS Interfaces
The PBIT synthetic result and the PBIT detailed results are accessible under the Operating System delivered
with the VM6052/VM6054 board.
The following gives you an overview of the facilities available under Linux, VxWorks and Windows OS Board
Support Packages.
Please refer to the appropriate OS Release Notes document for more details.
3.1Linux
3.1.1Linux Synthetic PBIT Result
The synthetic PBIT result stored in the CPLD register 0x2 is accessible under Linux with the “cpldtool” facility.
Use the “-a” option and check the register 0x2 value.
> DEPLOY (system production at the factory and DEPLOYment in the field)
> MAINTAIN (specific use case to MAINTAIN the system once deployed or to help repairing it)
> MANUFACTURING (used mostly by Kontron)
4.1PBIT Features and Benefits
The following describes the PBIT features and benefits according to targeted Use Cases.
4.1.1EVAL
Use Cases
PBIT can easily be evaluated from the BIOS, thanks to its interactive mode. Access to the PBIT operator inter
face and to the results can be done through the console serial line or through the VGA or DP (Display Port) screen
associated with a USB mouse and keyboard.
Following the detailed sections of this manual, all the PBIT commands can be experimented.
4.1.2DEVEL
The PBIT tests list can be modified in order to try various coverage/execution time trade-offs.
The “system” test can be used at the end of the development, to capture a complex peripheral configuration
(PCIe, USB, SATA, CPLD infos, BIOS SETUP) which becomes the validated final system configuration for the
deployment.
According to the complete system test policy, various PBIT results collection methods can be selected at ap
plication design time. The Operating System access to the PBIT results gives most of the information needed
by a control and monitoring application to take a decision on the system following the boot steps.
The PBIT synthetic result register featured by the board control unit (cPLD) can be used from a management
unit such as Kontron CMB or from other boards linked to the same SMB bus on the backplane. From this result,
the Control Unit can alter the control registers to modify the behaviour of the board under control.
4.1.3DEPLOY
PBIT software implements unrivalled features which make Kontron product deployment easier and cheaper. The
PBIT code is located in the same device as the BIOS code. It is deployed along with the BIOS (see Appendix
A of the BIOS User’s Guide). The PBIT settings (and results) are located in their dedicated non volatile EEPROM
device. To copy these settings, boot the Operating System and record the VPD EEPROM content from the offset
address 0x1000 up to 0x3FFF and store it in a file. Then use this file to copy back data to the new board VPD
EEPROM to configure.
One of the most useful features of PBIT for deployments is implemented in the “system” test (see section 2.10
page 34). As this test scans all the possible I/O ports and devices to compare with a pre-recorded system refe
rence, it can signal any change in the expected I/O devices availability. This can cover I/O device failures, or
more subtle system alterations (for example a storage device left unconnected). The “system” test results are
organized to pinpoint the faulty I/O port easily, before attempting a complete system boot and having to manage
the corresponding cascading failures due to this incorrect peripheral configuration.
SD.DT.G35-0e Page 49
Use Cases
VM6052/VM6054 PBIT User's Guide
4.1.4MAINTAIN
The following PBIT features can be very useful in the context of long term maintenance and troubleshooting.
The PBIT results record the behaviour of the last PBIT run (see section 2.5 page 23). In addition to these results,
each test implements a dedicated “FAILED ONCE” flag which has to be reset separately (see section 2.6 page
24). In situations where a system is regularly re-started, possibly under the control of a higher level control device,
this long term flag can be used by maintenance teams to search for the root cause of previously aborted boots.
Updating the BIOS and the PBIT code is done at the same time, using binary images containing both software,
thanks to the same storage device being used by both.
PBIT extension: Thanks to its modular approach, and to the EFI execution environment. PBIT can easily be
modified and expanded to match very specific application use case. Please contact GSS-MAR-Toulon@kon
tron.com to open a feature request discussion with Kontron.
4.1.5MANUFACTURING
Thanks to the wide range of services the PBIT software can offer, PBIT is a powerful tool used during the
manufacturing process of the boards.
Specific features have been implemented for that purpose.
Page 50 SD.DT.G35-0e
VM6052/VM6054 PBIT User's Guide
Appendix A - List of Abbreviations
CPLD Complex Programmable Logic Device
OS Operating System
PBIT Power on Built In Test
PMC PCI Mezzanine Card
XMC PCI Express Mezzanine Card
List of Abbreviations
SD.DT.G35-0e Page 51
MAILING ADDRESS TELEPHONE AND E-MAIL
Kontron Modular Computers S.A.S. +33 (0) 4 98 16 34 00
150 rue Marcelin Berthelot - BP 244 Sales: Order-ATD-Toulon@Kontron.com
ZI TOULON ESTSupport: GSS-ATD-Toulon@Kontron.com
83078 TOULON CEDEX - France
For further information about other Kontron products, please visit our Internet web site:
www.kontron.com.
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.