|
Intel Graphics System Controller Firmware Update Library
Intel Graphics System Controller Firmware Update Library
|
Data Structures | |
| struct | igsc_gfsp_tile_mem_err |
| struct | igsc_gfsp_mem_err |
Functions | |
| IGSC_EXPORT int | igsc_gfsp_count_tiles (IN struct igsc_device_handle *handle, OUT uint32_t *max_num_of_tiles) |
| Gets number of tiles. | |
| IGSC_EXPORT int | igsc_gfsp_memory_errors (IN struct igsc_device_handle *handle, IN OUT struct igsc_gfsp_mem_err *tiles) |
| Gets GFSP number of memory errors. | |
| IGSC_EXPORT int | igsc_ifr_run_array_scan_test (IN struct igsc_device_handle *handle, OUT uint32_t *status, OUT uint32_t *extended_status, OUT uint32_t *pending_reset, OUT uint32_t *error_code) |
| Runs IFR Array and Scan tests on GSC IFR device. | |
| IGSC_EXPORT int | igsc_ifr_run_mem_ppr_test (IN struct igsc_device_handle *handle, OUT uint32_t *status, OUT uint32_t *pending_reset, OUT uint32_t *error_code) |
| Runs IFR memory Post Package Repair (PPR) test on GSC IFR device. | |
| IGSC_EXPORT int | igsc_ifr_get_status_ext (IN struct igsc_device_handle *handle, OUT uint32_t *supported_tests, OUT uint32_t *hw_capabilities, OUT uint32_t *ifr_applied, OUT uint32_t *prev_errors, OUT uint32_t *pending_reset) |
| Retrieves the status of GSC IFR device. | |
| IGSC_EXPORT int | igsc_ifr_count_tiles (IN struct igsc_device_handle *handle, OUT uint16_t *supported_tiles) |
| Counts the IFR supported tiles. | |
| IGSC_EXPORT int | igsc_ifr_get_tile_repair_info (IN struct igsc_device_handle *handle, IN uint16_t tile_idx, OUT uint16_t *used_array_repair_entries, OUT uint16_t *available_array_repair_entries, OUT uint16_t *failed_dss) |
| Retrieves the IFR repair info. | |
| IGSC_EXPORT int | igsc_ecc_config_set (IN struct igsc_device_handle *handle, IN uint8_t req_ecc_state, OUT uint8_t *cur_ecc_state, OUT uint8_t *pen_ecc_state) |
| Set ECC Configuration. | |
| IGSC_EXPORT int | igsc_ecc_config_get (IN struct igsc_device_handle *handle, OUT uint8_t *cur_ecc_state, OUT uint8_t *pen_ecc_state) |
| Get ECC Configuration. | |
| IGSC_EXPORT int | igsc_device_oem_version (IN struct igsc_device_handle *handle, OUT struct igsc_oem_version *version) |
| Retrieves the OEM Version from the device. | |
| IGSC_EXPORT int | igsc_device_ifr_bin_version (IN struct igsc_device_handle *handle, OUT struct igsc_ifr_bin_version *version) |
| Retrieves the IFR Binary Version from the device. | |
| IGSC_EXPORT int | igsc_device_psc_version (IN struct igsc_device_handle *handle, OUT struct igsc_psc_version *version) |
| Retrieves the PSC Version from the device. | |
| IGSC_EXPORT int | igsc_gfsp_get_health_indicator (IN struct igsc_device_handle *handle, OUT uint8_t *health_indicator) |
| IGSC_EXPORT int | igsc_gfsp_heci_cmd (struct igsc_device_handle *handle, uint32_t gfsp_cmd, uint8_t *in_buffer, size_t in_buffer_size, uint8_t *out_buffer, size_t out_buffer_size, size_t *actual_out_buffer_size) |
| Send generic GFSP command and receive response. | |
| IGSC_EXPORT int | igsc_device_update_late_binding_config (IN struct igsc_device_handle *handle, IN uint32_t type, IN uint32_t flags, IN uint8_t *payload, IN size_t payload_size, OUT uint32_t *status) |
| IGSC_EXPORT int | igsc_device_commit_arb_svn (IN struct igsc_device_handle *handle, uint8_t *fw_error) |
| Sends ARB SVN Commit HECI command. | |
| IGSC_EXPORT int | igsc_device_get_min_allowed_arb_svn (IN struct igsc_device_handle *handle, OUT uint8_t *min_allowed_svn) |
| Retrieves Minimal allowed ARB SVN. | |
| struct igsc_gfsp_tile_mem_err |
gfsp number of memory errors per tile
Definition at line 1333 of file igsc_lib.h.
| Data Fields | ||
|---|---|---|
| uint32_t | corr_err |
Correctable memory errors on this boot and tile |
| uint32_t | uncorr_err |
Uncorrectable memory errors on this boot and tile |
| struct igsc_gfsp_mem_err |
gfsp number of memory errors on the card
Definition at line 1341 of file igsc_lib.h.
| Data Fields | ||
|---|---|---|
| struct igsc_gfsp_tile_mem_err | errors[] |
array of memory errors structs for each tile |
| uint32_t | num_of_tiles |
Number of entries in errors array(number of available entries when passed to function and number of filled entries when returned |
Late Binding flags
Definition at line 1650 of file igsc_lib.h.
Late Binding payload status
Definition at line 1666 of file igsc_lib.h.
Sends Late Binding HECI command.
Late Binding payload type
| handle | A handle to the device. |
| type | Late Binding payload type |
| flags | Late Binding flags to be sent to the firmware enum csc_late_binding_flags |
| payload | Late Binding data to be sent to the firmware |
| payload_size | Size of the payload data |
| status | Late Binding payload status |
Definition at line 1657 of file igsc_lib.h.
Gets memory health indicator.
| handle | A handle to the device. |
| health_indicator | contains pointer to |
Definition at line 1609 of file igsc_lib.h.
Definition at line 1390 of file igsc_lib.h.
IFR array and scan test status bit masks
Definition at line 1383 of file igsc_lib.h.
IFR hw capabilities masks
Definition at line 1452 of file igsc_lib.h.
IFR pending reset values definition
| Enumerator | |
|---|---|
| IGSC_IFR_PENDING_RESET_NONE | 0 - No reset needed |
| IGSC_IFR_PENDING_RESET_SHALLOW | 1 - Need to perform a shallow reset |
| IGSC_IFR_PENDING_RESET_DEEP | 2 - Need to perform a deep reset |
Definition at line 1374 of file igsc_lib.h.
IFR previous errors masks
Definition at line 1461 of file igsc_lib.h.
IFR repairs masks
| Enumerator | |
|---|---|
| IGSC_IFR_REPAIRS_MASK_DSS_EN_REPAIR | DSS enable repair applied |
| IGSC_IFR_REPAIRS_MASK_ARRAY_REPAIR | Array repair applied |
| IGSC_IFR_REPAIRS_MASK_FAILURE | Repair failure occurred |
Definition at line 1483 of file igsc_lib.h.
IFR supported tests masks
| Enumerator | |
|---|---|
| IGSC_IFR_SUPPORTED_TESTS_ARRAY_AND_SCAN | 1 - Array and Scan test |
| IGSC_IFR_SUPPORTED_TESTS_MEMORY_PPR | 2 - Memory PPR |
Definition at line 1444 of file igsc_lib.h.
| IGSC_EXPORT int igsc_device_commit_arb_svn | ( | IN struct igsc_device_handle * | handle, |
| uint8_t * | fw_error ) |
Sends ARB SVN Commit HECI command.
| handle | A handle to the device. |
| fw_error | An error returned by firmware in case of failure, can be NULL if not needed |
| IGSC_EXPORT int igsc_device_get_min_allowed_arb_svn | ( | IN struct igsc_device_handle * | handle, |
| OUT uint8_t * | min_allowed_svn ) |
Retrieves Minimal allowed ARB SVN.
| handle | A handle to the device. |
| min_allowed_svn | buffer for minimal allowed ARB SVN value |
| IGSC_EXPORT int igsc_device_ifr_bin_version | ( | IN struct igsc_device_handle * | handle, |
| OUT struct igsc_ifr_bin_version * | version ) |
Retrieves the IFR Binary Version from the device.
| handle | A handle to the device. |
| version | The memory to store obtained IFR binary version. |
| IGSC_EXPORT int igsc_device_oem_version | ( | IN struct igsc_device_handle * | handle, |
| OUT struct igsc_oem_version * | version ) |
Retrieves the OEM Version from the device.
| handle | A handle to the device. |
| version | The memory to store obtained OEM version. |
| IGSC_EXPORT int igsc_device_psc_version | ( | IN struct igsc_device_handle * | handle, |
| OUT struct igsc_psc_version * | version ) |
Retrieves the PSC Version from the device.
| handle | A handle to the device. |
| version | The memory to store obtained PSC version. |
| IGSC_EXPORT int igsc_ecc_config_get | ( | IN struct igsc_device_handle * | handle, |
| OUT uint8_t * | cur_ecc_state, | ||
| OUT uint8_t * | pen_ecc_state ) |
Get ECC Configuration.
| handle | A handle to the device. |
| cur_ecc_state | Current ECC State |
| pen_ecc_state | Pending ECC State |
| IGSC_EXPORT int igsc_ecc_config_set | ( | IN struct igsc_device_handle * | handle, |
| IN uint8_t | req_ecc_state, | ||
| OUT uint8_t * | cur_ecc_state, | ||
| OUT uint8_t * | pen_ecc_state ) |
Set ECC Configuration.
| handle | A handle to the device. |
| req_ecc_state | Requested ECC State |
| cur_ecc_state | Current ECC State after command execution |
| pen_ecc_state | Pending ECC State after command execution |
| IGSC_EXPORT int igsc_gfsp_count_tiles | ( | IN struct igsc_device_handle * | handle, |
| OUT uint32_t * | max_num_of_tiles ) |
Gets number of tiles.
| handle | A handle to the device. |
| max_num_of_tiles | maximum number of tiles |
| IGSC_EXPORT int igsc_gfsp_heci_cmd | ( | struct igsc_device_handle * | handle, |
| uint32_t | gfsp_cmd, | ||
| uint8_t * | in_buffer, | ||
| size_t | in_buffer_size, | ||
| uint8_t * | out_buffer, | ||
| size_t | out_buffer_size, | ||
| size_t * | actual_out_buffer_size ) |
Send generic GFSP command and receive response.
| handle | A handle to the device. |
| gfsp_cmd | command id |
| in_buffer | pointer to the input buffer |
| in_buffer_size | input buffer size |
| out_buffer | pointer to the output buffer |
| out_buffer_size | output buffer size |
| actual_out_buffer_size | pointer to the actual data size returned in the output buffer |
| IGSC_EXPORT int igsc_gfsp_memory_errors | ( | IN struct igsc_device_handle * | handle, |
| IN OUT struct igsc_gfsp_mem_err * | tiles ) |
Gets GFSP number of memory errors.
| handle | A handle to the device. |
| tiles | structure to store errors |
| IGSC_EXPORT int igsc_ifr_count_tiles | ( | IN struct igsc_device_handle * | handle, |
| OUT uint16_t * | supported_tiles ) |
Counts the IFR supported tiles.
| handle | A handle to the device. |
| supported_tiles | Number of supported tiles |
| IGSC_EXPORT int igsc_ifr_get_status_ext | ( | IN struct igsc_device_handle * | handle, |
| OUT uint32_t * | supported_tests, | ||
| OUT uint32_t * | hw_capabilities, | ||
| OUT uint32_t * | ifr_applied, | ||
| OUT uint32_t * | prev_errors, | ||
| OUT uint32_t * | pending_reset ) |
Retrieves the status of GSC IFR device.
| handle | A handle to the device. |
| supported_tests | Bitmap holding the tests supported on the platform, |
| hw_capabilities | Bitmap holdinf hw capabilities on the platform, |
| ifr_applied | Bitmap holding the in-field-repairs applied during boot, |
| prev_errors | Bitmap holding which errors were seen on this SOC in previous tests, |
| pending_reset | Whether a reset is pending after running the test, |
| IGSC_EXPORT int igsc_ifr_get_tile_repair_info | ( | IN struct igsc_device_handle * | handle, |
| IN uint16_t | tile_idx, | ||
| OUT uint16_t * | used_array_repair_entries, | ||
| OUT uint16_t * | available_array_repair_entries, | ||
| OUT uint16_t * | failed_dss ) |
Retrieves the IFR repair info.
| handle | A handle to the device. |
| tile_idx | The index of the tile the info is requested from |
| used_array_repair_entries | Number of array repair entries used by FW |
| available_array_repair_entries | Number of available array repair entries |
| failed_dss | Number of failed DSS |
| IGSC_EXPORT int igsc_ifr_run_array_scan_test | ( | IN struct igsc_device_handle * | handle, |
| OUT uint32_t * | status, | ||
| OUT uint32_t * | extended_status, | ||
| OUT uint32_t * | pending_reset, | ||
| OUT uint32_t * | error_code ) |
Runs IFR Array and Scan tests on GSC IFR device.
| handle | A handle to the device. |
| status | Test run status, |
| extended_status | Test run extended status, |
| pending_reset | Whether a reset is pending, |
| error_code | The error code of the test (0 - no error) |
| IGSC_EXPORT int igsc_ifr_run_mem_ppr_test | ( | IN struct igsc_device_handle * | handle, |
| OUT uint32_t * | status, | ||
| OUT uint32_t * | pending_reset, | ||
| OUT uint32_t * | error_code ) |
Runs IFR memory Post Package Repair (PPR) test on GSC IFR device.
| handle | A handle to the device. |
| status | Test run status,0 - Test is available and will be run after a reset Other values - error |
| pending_reset | Whether a reset is pending, |
| error_code | The error code of the test (0 - no error) |