class PowerMailboxInterface

Defined at line 28 of file ../../src/graphics/display/drivers/intel-display/registers-gt-mailbox.h

GTDRIVER_MAILBOX_INTERFACE (GT Driver Mailbox Interface).

Used for communication between the graphics driver and the PCODE (power

controller firmware code) running on the PCU (power controller).

This register's field breakdown was last documented in the Broadwell

documentation (IHD-OS-BDW-Vol 12-11.15 pages 31-32).

Tiger Lake: IHD-OS-TGL-Vol 2c-1.22-Rev2.0 Part 1 page 1090

DG1: IHD-OS-DG1-Vol 2c-2.21 Part 1 page 1049

Kaby Lake: IHD-OS-KBL-Vol 12-1.17 "Sequences for Changing CD Clock

Frequency", pages 138-139

Skylake: IHD-OS-SKL-Vol 12-05.16 "Skylake Sequences for Changing CD Clock

Frequency", pages 135-136

Public Members

 field_has_active_transaction_39

 field_RsvdZ_51

 field_param2_60

 field_param1_70

 field_command_code_77

Public Methods

template <, >

typename SelfType::ValueType has_active_transaction ()

True if the PCU is currently executing a command from the graphics driver.

The driver sets this field to true to ask the PCU (power control unit)

firmware to execute a command. The data registers must be set to correct

values before setting this to true.

The PCU firmware sets this field to false when it completes the command.

This field is also called RUN_BUSY (Run/Busy) in Intel's documentation.

Defined at line 39 of file ../../src/graphics/display/drivers/intel-display/registers-gt-mailbox.h

template <, >

SelfType & set_has_active_transaction (typename SelfType::ValueType val)

True if the PCU is currently executing a command from the graphics driver.

The driver sets this field to true to ask the PCU (power control unit)

firmware to execute a command. The data registers must be set to correct

values before setting this to true.

The PCU firmware sets this field to false when it completes the command.

This field is also called RUN_BUSY (Run/Busy) in Intel's documentation.

Defined at line 39 of file ../../src/graphics/display/drivers/intel-display/registers-gt-mailbox.h

template <, >

typename SelfType::ValueType param2 ()

The PARAM2 field in Intel's documentation.

This field is mentioned in the display engine PRMs, but its underlying bits

are not documented. We deduced its placement by comparing the

icl_pcode_read_qgv_point_info() function in the i915 OpenBSD driver with

against the MAILBOX_GTRDIVER_CMD_MEM_SS_INFO_SUBCOMMAND_READ_QGV_POINT_INFO

description in Tiger Lake documentation.

Defined at line 60 of file ../../src/graphics/display/drivers/intel-display/registers-gt-mailbox.h

template <, >

SelfType & set_param2 (typename SelfType::ValueType val)

The PARAM2 field in Intel's documentation.

This field is mentioned in the display engine PRMs, but its underlying bits

are not documented. We deduced its placement by comparing the

icl_pcode_read_qgv_point_info() function in the i915 OpenBSD driver with

against the MAILBOX_GTRDIVER_CMD_MEM_SS_INFO_SUBCOMMAND_READ_QGV_POINT_INFO

description in Tiger Lake documentation.

Defined at line 60 of file ../../src/graphics/display/drivers/intel-display/registers-gt-mailbox.h

template <, >

typename SelfType::ValueType param1 ()

The PARAM1 field in Intel documentation.

This field is documented implicitly by a mention of "PARAM1[15:8]" in the

MAILBOX_GTRDIVER_CMD_MEM_SS_INFO command description under the "Mailbox

Commands" section of the display engine PRM.

Tiger Lake: IHD-OS-TGL-Vol 12-1.22-Rev2.0 page 212

DG1: IHD-OS-DG1-Vol 12-2.21 page 169

Lakefield: IHD-OS-LKF-Vol 12-4.21 page 166

Defined at line 70 of file ../../src/graphics/display/drivers/intel-display/registers-gt-mailbox.h

template <, >

SelfType & set_param1 (typename SelfType::ValueType val)