class DynamicFlexIoScratchPad

This indicates whether a display is connected to the Type-C connector and

the type (DP-Alt on Type-C, or Thunderbolt) of the display.

See enum class `TypeCLiveState` for valid values.

Drivers can use the helper method `type_c_live_state` to get Type-C state

for a given DDI.

The register has bits 0-7 representing the states for connector 0 to 7.

Since on Tiger Lake each FIA only connects to two connectors, we only

define the bits for connector 0 and 1 in this class.

This indicates whether a display is connected to the Type-C connector and

the type (DP-Alt on Type-C, or Thunderbolt) of the display.

See enum class `TypeCLiveState` for valid values.

Drivers can use the helper method `type_c_live_state` to get Type-C state

for a given DDI.

The register has bits 0-7 representing the states for connector 0 to 7.

Since on Tiger Lake each FIA only connects to two connectors, we only

define the bits for connector 0 and 1 in this class.

True if the IOM (Type C) firmware version supports MFD.

If this bit is false, the IOM (Type C subsystem microcontroller) firmware

is too old to support MFD. This configuration is not supported by our

driver, as we assume MFD is always supported when configuring the Type-C

clock.

The MFD acronym is not explained in Intel's documentation, but it probably

stands for Multi-functional display (simultaneous DisplayPort and USB

Enhanced SuperSpeed) over USB Type-C, as described in VESA DisplayPort Alt

Mode Standard Version 1.0b, Section 4.1 "Scenario 1 USB Type-C Cable".

True if the IOM (Type C) firmware version supports MFD.

If this bit is false, the IOM (Type C subsystem microcontroller) firmware

is too old to support MFD. This configuration is not supported by our

driver, as we assume MFD is always supported when configuring the Type-C

clock.

The MFD acronym is not explained in Intel's documentation, but it probably

stands for Multi-functional display (simultaneous DisplayPort and USB

Enhanced SuperSpeed) over USB Type-C, as described in VESA DisplayPort Alt

Mode Standard Version 1.0b, Section 4.1 "Scenario 1 USB Type-C Cable".

Firmware writes to the bits to indicate the PHY lane assignment for

display. Each bit correspond to a Type-C PHY lane (0-3).

Drivers can use the helper method `display_port_tx_lane_assignment` to get

Type-C transmitter lane assignment for a given DDI, or use

`display_port_assigned_tx_lane_count` to count lanes assigned for DDI.

The register has bits 0-7 representing the states for connector 0 to 7.

Since on Tiger Lake each FIA only connects to two connectors, we only

define the bits for connector 0 and 1 in this class.

Firmware writes to the bits to indicate the PHY lane assignment for

display. Each bit correspond to a Type-C PHY lane (0-3).

Drivers can use the helper method `display_port_tx_lane_assignment` to get

Type-C transmitter lane assignment for a given DDI, or use

`display_port_assigned_tx_lane_count` to count lanes assigned for DDI.

The register has bits 0-7 representing the states for connector 0 to 7.

Since on Tiger Lake each FIA only connects to two connectors, we only

define the bits for connector 0 and 1 in this class.

Same as `type_c_live_state_connector_1` but for Connector 0.

Drivers can use the helper method `type_c_live_state` to get Type-C state

for a given DDI.

Same as `type_c_live_state_connector_1` but for Connector 0.

Drivers can use the helper method `type_c_live_state` to get Type-C state

for a given DDI.

True if the FIA (Flexi IO Adapter) is modular.

If this bit is false for the FIA1 register instance, the display engine has

one monolithic FIA that houses all connections (for example, Ice Lake).

The driver must not access the register instances for other FIAs.

On Tiger Lake, this bit must be set true by the firmware, because Tiger

Lake display engines always have modular FIAs.

If this bit is true for the FIA1 register instance, the display engine has

multiple modular FIAs, and each FIA instance hosts two Type C connections.

True if the FIA (Flexi IO Adapter) is modular.

If this bit is false for the FIA1 register instance, the display engine has

one monolithic FIA that houses all connections (for example, Ice Lake).

The driver must not access the register instances for other FIAs.

On Tiger Lake, this bit must be set true by the firmware, because Tiger

Lake display engines always have modular FIAs.

If this bit is true for the FIA1 register instance, the display engine has

multiple modular FIAs, and each FIA instance hosts two Type C connections.

Same as `tx_lane_assignment_bits_connector_1` but for Connector 0.

Drivers can use the helper method `display_port_tx_lane_assignment` to get

Type-C transmitter lane assignment for a given DDI, or use

`display_port_assigned_tx_lane_count` to count lanes assigned for DDI.

Same as `tx_lane_assignment_bits_connector_1` but for Connector 0.

Drivers can use the helper method `display_port_tx_lane_assignment` to get

Type-C transmitter lane assignment for a given DDI, or use

`display_port_assigned_tx_lane_count` to count lanes assigned for DDI.

Get the Type-C connection live state of a given DDI.

This reads `type_c_live_state_connector_0` or

`type_c_live_state_connector_1` field based on `ddi_id`.

Callers must make sure they read from the correct FIA register.

Get the PHY lane assignment for display of a given DDI.

This reads `display_port_tx_lane_assignment_bits_connector_0` or

`display_port_tx_lane_assignment_bits_connector_1` field based on `ddi_id`.

Callers must make sure they read from the correct FIA register.

A helper method to count number of lanes for display of a given DDI.

This reads `display_port_tx_lane_assignment_bits_connector_0` or

`display_port_tx_lane_assignment_bits_connector_1` field based on `ddi_id`

and counts number of ones in the bitmap.

Callers must make sure they read from the correct FIA register.