Package Content

The hl_qual tools package contains the applications (plugins) listed in the below table:

Module

Description

Type

Device

hl_qual

Glue logic application that runs all test plugins located in /opt/habanalabs/qual/gaudi. See hl_qual Design.

Application

All devices

runner

A generic test plugin loader and runner application. The runner image is loaded by hl_qual and is responsible for loading the test plugins and running the selected plugin on the tested device (one instance of a runner process per tested device). The application is located in /opt/habanalabs/qual/gaudi. See hl_qual Design.

Application

All devices

monitor

A standalone monitoring application to monitor multiple device execution metric measurement (device power usage, Device clock and Device temperature). See hl_qual Monitor Textual UI.

Application

All devices

libfunctional2_test_plugin.so

Dynamically linked library implementing the functional test 2 plugin. See Functional Test 2 Plugin Design Consideration and Responsibilities.

Dynamically linked lib

All devices

libNIC_basetest _plugin.so

Dynamically linked library implementing the NIC base tests plugin. See Serdes Base Test Design Consideration and Responsibilities.

Dynamically linked lib

All devices

libpci_bw_plugin.so

Dynamically linked library implementing the PCI bandwidth test plugin. See PCI Bandwidth Design.

Dynamically linked lib

All devices

libpower_stress_plugin.so

Dynamically linked library implementing the Power stress and EDP test plugin. See First-gen Gaudi Power Stress Plugin Design Consideration and Responsibilities.

Dynamically linked lib

First-gen Gaudi

libconcurrency_powertest.so

Dynamically linked library implementing the Power stress. See Gaudi 3/2 Power Stress Plugin Design Consideration and Responsibilities.

Dynamically linked lib

Gaudi 2/3

libmemory_bw_plugin.so

Dynamically linked library implementing the Memory bandwidth plugin. See Gaudi 2/First-gen Gaudi Memory Bandwidth Plugin Design Consideration and Responsibilities.

Dynamically linked lib

All devices

libhbm_stress_plugin.so

Dynamically linked library implementing a HBM stress plugin. See First-gen Gaudi HBM Stress Plugin Design Consideration and Responsibilities.

Dynamically linked lib

First-gen Gaudi

  • libhbm_plugin_gaudi2.so

  • libhbm_plugin_gaudi3.so

Dynamically linked library implementing a HBM stress plugin. the plugin supports 3 sub tests HBM_DMA_STRESS, HBM_TPC_STRESS and HBM_FULL_DATA_CHECK See Gaudi 3/2 HBM Stress Plugin Design Consideration and Responsibilities.

Dynamically linked lib

Gaudi 2/3

libe2e_hlthunk_based.so

Dynamically linked library implementing the E2E serdes test. See First-gen Gaudi E2E Serdes Test Plugin Design Consideration and Responsibilities.

Dynamically linked lib

First-gen Gaudi

libe2e_concurrency.so

Dynamically linked library implementing the E2E concurrency test. See Gaudi 3/2 E2E Concurrency Test Plugin Design Consideration and Responsibilities.

Dynamically linked lib

Gaudi 2/3

libber_plugin.so

Dynamically linked library implementing the Ber test. See Gaudi 3/2 SER Test Plugin Design Consideration and Responsibilities.

Dynamically linked lib

Gaudi 2

E2E_create_configuration_files.py

E2E test Python ports and link configuration scripts.

Python configuration file

First-gen Gaudi

lspci_parser.py

PCI tree reader and BW estimator.

Python configuration

All devices

hard_reset.sh

Reset control bash script.

bash script

All devices

prepare.sh

ImageNet images preprocessing script.

bash script

First-gen Gaudi/ Gaudi 2

nic_information.sh

Gaudi device NIC information reader.

bash script

All devices

pcie_aer_detector

PCIe error detector.

APP

All devices

  • training256.json

  • validation256.json

ResNet-50 training stress test plugin configuration JSON file for Aeon library data loader.

Aeon config file

First-gen Gaudi

  • gaudi2_dma.ini

  • gaudi3_dma.ini

INI general configuration file for all HBM stress test modes.

INI format config file

Gaudi 2/3

hl_qual.ini

INI hl_qual configuration file which defines which test plugin will be loaded and the basic behavior of the monitor sampling.

INI format config file

All devices

monitor.ini

INI configuration file to control the sampling of hl_qual monitor add-on.

INI format config file

All devices

device.ini

INI configuration file to control Gaudi device setup.

INI format config file

All devices

hlthunk_tests.ini

HBM BE hlthunk test configuration file. This file should not be edited.

INI format config file

All devices
../../_images/Qualification_Package_Content_gaudi.JPG

Figure 21 Qualification Package Content

Note

The installation folder of the hl_qual package can be found under /opt/habanalabs/qual/gaudi/