Ifr

Topics
	IGSC_IFR_RUN_TEST_STATUSES

Enumerations
enum	igsc_ifr_tiles { IGSC_IFR_TILE_0 = 0x0001 , IGSC_IFR_TILE_1 = 0x0002 }
enum	igsc_supported_ifr_tests { IGSC_IFR_SUPPORTED_TEST_SCAN = 0x00000001 , IGSC_IFR_SUPPORTED_TEST_ARRAY = 0x00000002 }
enum	igsc_ifr_repairs { IGSC_IFR_REPAIR_DSS_EN = 0x00000001 , IGSC_IFR_REPAIR_ARRAY = 0x00000002 }

Functions
IGSC_EXPORT void	igsc_library_version (uint32_t *major, uint32_t *minor, uint32_t *patch, uint32_t *build)
	Return the library version.

Variables
char	igsc_fw_version::project [4]
uint16_t	igsc_fw_version::hotfix
uint16_t	igsc_fw_version::build
uint16_t	igsc_ifr_bin_version::major
uint16_t	igsc_ifr_bin_version::minor
uint16_t	igsc_ifr_bin_version::hotfix
uint16_t	igsc_ifr_bin_version::build
uint32_t	igsc_psc_version::date
uint32_t	igsc_psc_version::cfg_version
uint16_t	igsc_oem_version::length
uint8_t	igsc_oem_version::version [IGSC_MAX_OEM_VERSION_LENGTH]
uint16_t	igsc_oem_serial_number::length
uint8_t	igsc_oem_serial_number::sn [IGSC_MAX_OEM_SN_LENGTH]
uint32_t	igsc_fwdata_version::oem_manuf_data_version
uint16_t	igsc_fwdata_version::major_version
uint16_t	igsc_fwdata_version::major_vcn
uint32_t	igsc_fwdata_version2::format_version
uint32_t	igsc_fwdata_version2::oem_manuf_data_version
uint32_t	igsc_fwdata_version2::oem_manuf_data_version_fitb
uint16_t	igsc_fwdata_version2::major_version
uint16_t	igsc_fwdata_version2::major_vcn
uint32_t	igsc_fwdata_version2::flags
uint32_t	igsc_fwdata_version2::data_arb_svn
uint32_t	igsc_fwdata_version2::data_arb_svn_fitb
uint8_t	igsc_oprom_version::version [IGSC_OPROM_VER_SIZE]
uint16_t	igsc_oprom_device_info::subsys_vendor_id
uint16_t	igsc_oprom_device_info::subsys_device_id
uint16_t	igsc_oprom_device_info_4ids::vendor_id
uint16_t	igsc_oprom_device_info_4ids::device_id
uint16_t	igsc_oprom_device_info_4ids::subsys_vendor_id
uint16_t	igsc_oprom_device_info_4ids::subsys_device_id
uint16_t	igsc_fwdata_device_info::vendor_id
uint16_t	igsc_fwdata_device_info::device_id
uint16_t	igsc_fwdata_device_info::subsys_vendor_id
uint16_t	igsc_fwdata_device_info::subsys_device_id
char	igsc_device_info::name [IGSC_INFO_NAME_SIZE]
uint16_t	igsc_device_info::domain
uint8_t	igsc_device_info::bus
uint8_t	igsc_device_info::dev
uint8_t	igsc_device_info::func
uint16_t	igsc_device_info::device_id
uint16_t	igsc_device_info::vendor_id
uint16_t	igsc_device_info::subsys_device_id
uint16_t	igsc_device_info::subsys_vendor_id
uint32_t	igsc_hw_config::format_version
uint8_t	igsc_hw_config::blob [IGSC_HW_CONFIG_BLOB_SIZE]
uint16_t	igsc_subsystem_ids::ssvid
uint16_t	igsc_subsystem_ids::ssdid
struct igsc_lib_ctx *	igsc_device_handle::ctx
uint32_t	igsc_fw_update_flags::force_update: 1
uint32_t	igsc_fw_update_flags::reserved: 31
uint32_t	igsc_gfsp_tile_mem_err::corr_err
uint32_t	igsc_gfsp_tile_mem_err::uncorr_err
uint32_t	igsc_gfsp_mem_err::num_of_tiles
struct igsc_gfsp_tile_mem_err	igsc_gfsp_mem_err::errors []
uint32_t	igsc_device_mbist_ppr_status::mbist_test_status
uint32_t	igsc_device_mbist_ppr_status::num_of_ppr_fuses_used_by_fw
uint32_t	igsc_device_mbist_ppr_status::num_of_remaining_ppr_fuses
uint8_t	igsc_ppr_status::boot_time_memory_correction_pending
uint8_t	igsc_ppr_status::ppr_mode
uint8_t	igsc_ppr_status::test_run_status
uint8_t	igsc_ppr_status::reserved
uint32_t	igsc_ppr_status::ras_ppr_applied
uint32_t	igsc_ppr_status::mbist_completed
uint32_t	igsc_ppr_status::num_devices
struct igsc_device_mbist_ppr_status	igsc_ppr_status::device_mbist_ppr_status []

Detailed Description

Enumeration Type Documentation

igsc_ifr_repairs

enum igsc_ifr_repairs

ifr repairs masks

Definition at line 1279 of file igsc_lib.h.

igsc_ifr_tiles

enum igsc_ifr_tiles

ifr tiles masks

Definition at line 1263 of file igsc_lib.h.

igsc_supported_ifr_tests

enum igsc_supported_ifr_tests

ifr supported test masks

Definition at line 1271 of file igsc_lib.h.

Function Documentation

igsc_library_version()

IGSC_EXPORT void igsc_library_version	(	uint32_t *	major,
		uint32_t *	minor,
		uint32_t *	patch,
		uint32_t *	build )

Return the library version.

Parameters

major	pointer to fill for major version part
minor	pointer to fill for minor version part
patch	pointer to fill for patch version part
build	pointer to fill for build version part

Variable Documentation

blob

uint8_t igsc_hw_config::blob[IGSC_HW_CONFIG_BLOB_SIZE]

Definition at line 351 of file igsc_lib.h.

boot_time_memory_correction_pending

uint8_t igsc_ppr_status::boot_time_memory_correction_pending

0 - No pending boot time memory correction, 1 - Pending boot time memory correction

Definition at line 1839 of file igsc_lib.h.

build [1/2]

uint16_t igsc_fw_version::build

FW Build Number

Definition at line 128 of file igsc_lib.h.

build [2/2]

uint16_t igsc_ifr_bin_version::build

IFR Binary Build Number

Definition at line 138 of file igsc_lib.h.

bus

uint8_t igsc_device_info::bus

pci bus number for GFX device

Definition at line 304 of file igsc_lib.h.

cfg_version

uint32_t igsc_psc_version::cfg_version

PSC configuration version

Definition at line 146 of file igsc_lib.h.

corr_err

uint32_t igsc_gfsp_tile_mem_err::corr_err

Correctable memory errors on this boot and tile

Definition at line 1349 of file igsc_lib.h.

ctx

struct igsc_lib_ctx* igsc_device_handle::ctx

Internal library context

Definition at line 376 of file igsc_lib.h.

data_arb_svn

uint32_t igsc_fwdata_version2::data_arb_svn

GSC in-field data firmware SVN

Definition at line 219 of file igsc_lib.h.

data_arb_svn_fitb

uint32_t igsc_fwdata_version2::data_arb_svn_fitb

GSC in-field data firmware SVN from FITB

Definition at line 220 of file igsc_lib.h.

date

uint32_t igsc_psc_version::date

PSC date

Definition at line 145 of file igsc_lib.h.

dev

uint8_t igsc_device_info::dev

device number on pci bus

Definition at line 305 of file igsc_lib.h.

device_id [1/3]

uint16_t igsc_device_info::device_id

gfx device id

Definition at line 308 of file igsc_lib.h.

device_id [2/3]

uint16_t igsc_fwdata_device_info::device_id

device id

Definition at line 269 of file igsc_lib.h.

device_id [3/3]

uint16_t igsc_oprom_device_info_4ids::device_id

device id

Definition at line 258 of file igsc_lib.h.

device_mbist_ppr_status

struct igsc_device_mbist_ppr_status igsc_ppr_status::device_mbist_ppr_status[]

Array of PPR statuses per device

Definition at line 1848 of file igsc_lib.h.

domain

uint16_t igsc_device_info::domain

pci domain for GFX device

Definition at line 303 of file igsc_lib.h.

errors

struct igsc_gfsp_tile_mem_err igsc_gfsp_mem_err::errors[]

array of memory errors structs for each tile

Definition at line 1359 of file igsc_lib.h.

flags

uint32_t igsc_fwdata_version2::flags

GSC in-field data firmware flags

Definition at line 218 of file igsc_lib.h.

force_update

uint32_t igsc_fw_update_flags::force_update

Definition at line 648 of file igsc_lib.h.

format_version [1/2]

uint32_t igsc_fwdata_version2::format_version

GSC in-field data firmware version format

Definition at line 213 of file igsc_lib.h.

format_version [2/2]

uint32_t igsc_hw_config::format_version

Definition at line 350 of file igsc_lib.h.

func

uint8_t igsc_device_info::func

device function number

Definition at line 306 of file igsc_lib.h.

hotfix [1/2]

uint16_t igsc_fw_version::hotfix

FW Hotfix Number

Definition at line 127 of file igsc_lib.h.

hotfix [2/2]

uint16_t igsc_ifr_bin_version::hotfix

IFR Binary Hotfix Number

Definition at line 137 of file igsc_lib.h.

length [1/2]

uint16_t igsc_oem_serial_number::length

actual OEM serial number length

Definition at line 165 of file igsc_lib.h.

length [2/2]

uint16_t igsc_oem_version::length

actual OEM version length

Definition at line 155 of file igsc_lib.h.

major

uint16_t igsc_ifr_bin_version::major

IFR Binary Major Number

Definition at line 135 of file igsc_lib.h.

major_vcn [1/2]

uint16_t igsc_fwdata_version2::major_vcn

GSC in-field data firmware major VCN

Definition at line 217 of file igsc_lib.h.

major_vcn [2/2]

uint16_t igsc_fwdata_version::major_vcn

GSC in-field data firmware major VCN

Definition at line 200 of file igsc_lib.h.

major_version [1/2]

uint16_t igsc_fwdata_version2::major_version

GSC in-field data firmware major version

Definition at line 216 of file igsc_lib.h.

major_version [2/2]

uint16_t igsc_fwdata_version::major_version

GSC in-field data firmware major version

Definition at line 199 of file igsc_lib.h.

mbist_completed

uint32_t igsc_ppr_status::mbist_completed

0 - Not Applied, Any set bit represents mbist completed

Definition at line 1846 of file igsc_lib.h.

mbist_test_status

uint32_t igsc_device_mbist_ppr_status::mbist_test_status

0 – Pass, Any set bit represents that MBIST on the matching channel has failed

Definition at line 1830 of file igsc_lib.h.

minor

uint16_t igsc_ifr_bin_version::minor

IFR Binary Minor Number

Definition at line 136 of file igsc_lib.h.

name

char igsc_device_info::name[IGSC_INFO_NAME_SIZE]

the device node path

Definition at line 301 of file igsc_lib.h.

num_devices

uint32_t igsc_ppr_status::num_devices

real number of devices in the array (on Xe_HP SDV, PVC <= 8)

Definition at line 1847 of file igsc_lib.h.

num_of_ppr_fuses_used_by_fw

uint32_t igsc_device_mbist_ppr_status::num_of_ppr_fuses_used_by_fw

Number of PPR fuses used by the firmware

Definition at line 1831 of file igsc_lib.h.

num_of_remaining_ppr_fuses

uint32_t igsc_device_mbist_ppr_status::num_of_remaining_ppr_fuses

Number of remaining PPR fuses

Definition at line 1832 of file igsc_lib.h.

num_of_tiles

uint32_t igsc_gfsp_mem_err::num_of_tiles

Number of entries in errors array (number of available entries when passed to the function and number of filled entries when returned)

Definition at line 1357 of file igsc_lib.h.

oem_manuf_data_version [1/2]

uint32_t igsc_fwdata_version2::oem_manuf_data_version

GSC in-field data firmware OEM manufacturing data version

Definition at line 214 of file igsc_lib.h.

oem_manuf_data_version [2/2]

uint32_t igsc_fwdata_version::oem_manuf_data_version

GSC in-field data firmware OEM manufacturing data version

Definition at line 198 of file igsc_lib.h.

oem_manuf_data_version_fitb

uint32_t igsc_fwdata_version2::oem_manuf_data_version_fitb

GSC in-field data firmware OEM manufacturing data version from FITB

Definition at line 215 of file igsc_lib.h.

ppr_mode

uint8_t igsc_ppr_status::ppr_mode

0 – PPR enabled, 1 – PPR disabled, 2 – PPR test mode, 3 – PPR auto run on next boot

Definition at line 1841 of file igsc_lib.h.

project

char igsc_fw_version::project[4]

Project code name

Definition at line 126 of file igsc_lib.h.

ras_ppr_applied

uint32_t igsc_ppr_status::ras_ppr_applied

0 - ppr not applied, 1 - ppr applied, 2 - ppr exhausted

Definition at line 1845 of file igsc_lib.h.

reserved [1/2]

uint32_t igsc_fw_update_flags::reserved

Definition at line 649 of file igsc_lib.h.

reserved [2/2]

uint8_t igsc_ppr_status::reserved

Definition at line 1844 of file igsc_lib.h.

sn

uint8_t igsc_oem_serial_number::sn[IGSC_MAX_OEM_SN_LENGTH]

buffer to store the oem serial number

Definition at line 166 of file igsc_lib.h.

ssdid

uint16_t igsc_subsystem_ids::ssdid

Definition at line 361 of file igsc_lib.h.

ssvid

uint16_t igsc_subsystem_ids::ssvid

Definition at line 360 of file igsc_lib.h.

subsys_device_id [1/4]

uint16_t igsc_device_info::subsys_device_id

gfx device subsystem device id

Definition at line 310 of file igsc_lib.h.

subsys_device_id [2/4]

uint16_t igsc_fwdata_device_info::subsys_device_id

subsystem device id

Definition at line 271 of file igsc_lib.h.

subsys_device_id [3/4]

uint16_t igsc_oprom_device_info::subsys_device_id

subsystem device id

Definition at line 249 of file igsc_lib.h.

subsys_device_id [4/4]

uint16_t igsc_oprom_device_info_4ids::subsys_device_id

subsystem device id

Definition at line 260 of file igsc_lib.h.

subsys_vendor_id [1/4]

uint16_t igsc_device_info::subsys_vendor_id

gfx device subsystem vendor id

Definition at line 311 of file igsc_lib.h.

subsys_vendor_id [2/4]

uint16_t igsc_fwdata_device_info::subsys_vendor_id

subsystem vendor id

Definition at line 270 of file igsc_lib.h.

subsys_vendor_id [3/4]

uint16_t igsc_oprom_device_info::subsys_vendor_id

subsystem vendor id

Definition at line 248 of file igsc_lib.h.

subsys_vendor_id [4/4]

uint16_t igsc_oprom_device_info_4ids::subsys_vendor_id

subsystem vendor id

Definition at line 259 of file igsc_lib.h.

test_run_status

uint8_t igsc_ppr_status::test_run_status

test status

See also

enum igsc_ppr_test_status_mask

Definition at line 1843 of file igsc_lib.h.

uncorr_err

uint32_t igsc_gfsp_tile_mem_err::uncorr_err

Uncorrectable memory errors on this boot and tile

Definition at line 1350 of file igsc_lib.h.

vendor_id [1/3]

uint16_t igsc_device_info::vendor_id

gfx device vendor id

Definition at line 309 of file igsc_lib.h.

vendor_id [2/3]

uint16_t igsc_fwdata_device_info::vendor_id

vendor id

Definition at line 268 of file igsc_lib.h.

vendor_id [3/3]

uint16_t igsc_oprom_device_info_4ids::vendor_id

vendor id

Definition at line 257 of file igsc_lib.h.

version [1/2]

uint8_t igsc_oem_version::version[IGSC_MAX_OEM_VERSION_LENGTH]

buffer to store oem version

Definition at line 156 of file igsc_lib.h.

version [2/2]

uint8_t igsc_oprom_version::version[IGSC_OPROM_VER_SIZE]

OPROM Version string

Definition at line 231 of file igsc_lib.h.