DcbPfcLoadValidationTestCaseConfig Object

Description:

DCB PFC load validation test configuration.

Writable Attributes
Read-Only Attributes

Parents: DcbTestConfig

Children: DcbTrafficGroupWeightConfig

Relations:

Side name (Type)	Relative	Description
GroupCollection (AffiliationGroupCollection)	GroupCollection	This relation indicates which GroupCollection object contains the test traffic for the test.
PauseDevice (PfcPauseDeviceBinding)	EmulatedDevice	This relation indicates which devices will send PFC pause frames during the test.
SequencerRootCommand (TestCaseRootCommand)	SequencerGroupCommand	This relation indicates the root command for this test case in the sequencer.

DcbPfcLoadValidationTestCaseConfig Writable Attributes

Attribute

Description

Common Writable Attributes

Active, Name

BurstSizeIterationMode

This option configures how the burst size is iterated.

Type: enum

Default: FIXED

Possible Values:

Value	Description
FIXED	Use a single, FIXED burst size.
CUSTOM	Use a CUSTOM list of burst sizes.
STEP	Increment burst sizes between a min and max value by a fixed STEP.

CustomBurstSizeList

Burst size values to use when iteration mode is CUSTOM.

Type: u32

Default: 0

Range: 1 - 4294967295

CustomFrameSizeList

Frame size values to use when iteration mode is CUSTOM.

Type: u16

Default: 0

Range: 40 - 16383

CustomLoadSizeList

List of loads to use for CUSTOM iteration mode.

Type: double

Default: 0

CustomPauseRateList

Pause Rate values to use when iteration mode is CUSTOM.

Type: u32

Default: 0

Range: 1 - 1000

CustomPauseTimeList

Pause Time values to use when iteration mode is CUSTOM.

Type: u32

Default: 0

Range: 1 - 67108863

CustomQuantaList

Quanta values to use when iteration mode is CUSTOM.

Type: u16

Default: 0

CustomXonDelayList

NOTE: This attribute is deprecated. It will be removed in subsequent releases, so it is recommended that you do not use it.

XON delay values to use when iteration mode is CUSTOM.

Type: u32

Default: 0

Range: 1 - 67108863

EnableXonXoffFlowControl

Configures whether to transmit a XON frame at the end of each pause or not.

Type: bool

Default: FALSE

Possible Values:

Value	Description
TRUE	Transmit XON frame.
FALSE	Do not transmit XON frame.

FixedBurstSize

Burst size value to use when iteration mode is FIXED.

Type: u32

Default: 1

Range: 1 - 4294967295

FixedFrameSize

Frame size to use when iteration mode is FIXED.

Type: u16

Default: 128

Range: 40 - 16383

FixedLoadSize

Load to use for FIXED iteration mode.

Type: double

Default: 10

FixedPauseRate

Pause Rate to use when iteration mode is FIXED.

Type: u32

Default: 100

Range: 1 - 1000

FixedPauseTime

Pause Time value to use when iteration mode is FIXED.

Type: u32

Default: 1024

Range: 1 - 67108863

FixedQuanta

Quanta value to use when iteration mode is FIXED.

Type: u16

Default: 65535

FixedXonDelay

NOTE: This attribute is deprecated. It will be removed in subsequent releases, so it is recommended that you do not use it.

XON delay value to use when iteration mode is FIXED.

Type: u32

Default: 1024

Range: 1 - 67108863

FrameSizeIterationMode

This option configures how the frame size is iterated.

Type: enum

Default: FIXED

Possible Values:

Value	Description
FIXED	Use a single, FIXED frame size.
CUSTOM	Use a CUSTOM list of frame sizes.
STEP	STEP frame sizes by a fixed amount between a min and max frame size.
RANDOM	Use a uniform, RANDOM distribution of frames bounded by a min and max value [min, max].

InterFrameGap

IFG to use within a burst when InterFrameGapConfigMode is set to USER.

Type: u32

Default: 12

Range: 11 - 16383

InterFrameGapConfigMode

This option configures the Inter-frame Gap (IFG) to use within a burst.

Type: enum

Default: MINIMUM

Possible Values:

Value	Description
MINIMUM	Use the smallest IFG supported by the port.
USER	Use a user specified IFG.

LoadSizeConfigMode

Specifies which load configuration is to be used for this test case.

Type: enum

Default: WEIGHTED

Possible Values:

Value	Description
WEIGHTED	Use a single aggregate load for each iteration of the test via the load properties on the test case object. Requires a DcbTrafficGroupWeightConfig for each TrafficGroup object in the test.
DISCRETE	Configure discrete loads for each TrafficGroup individually via the TrafficGroup's child TrafficGroupLoadSizeProfile object.

LoadSizeIterationMode

This option configures how the load is iterated.

Type: enum

Default: STEP

Possible Values:

Value	Description
FIXED	Use a single, FIXED load.
CUSTOM	Use a CUSTOM list of loads.
STEP	Increment loads between a min and max value by a fixed STEP.

LoadUnits

Units used for the load value.

Type: enum

Default: PERCENT_LINE_RATE

Possible Values:

Value	Description
PERCENT_LINE_RATE	Percent line rate.
MEGABITS_PER_SECOND	Megabits per second (Mbps).
KILOBITS_PER_SECOND	Kilobits per second (Kbps).
BITS_PER_SECOND	Bits per second (bps).

PauseRateIterationMode

This option configures how the PFC Pause Rate is iterated.

Type: enum

Default: FIXED

Possible Values:

Value	Description
CUSTOM	Use a CUSTOM list of pause rates.
FIXED	Use a single, FIXED pause rate.
STEP	STEP pause rate values by a fixed amount between a min and max rate.

PauseTimeIterationMode

This option configures how the PFC Pause Time is iterated.

Type: enum

Default: FIXED

Possible Values:

Value	Description
CUSTOM	Use a CUSTOM list of pause times.
FIXED	Use a single, FIXED pause time.
STEP	STEP pause time values by a fixed amount between a min and max pause time value.

PauseTimeUnit

This options specifies what units are used to describe Pause Time.

Type: enum

Default: QUANTA

Possible Values:

Value	Description
QUANTA	Pause Time is in quanta.
BYTES	Pause Time is in bytes.

PfcPauseQueueConfigMode

Indicates how the test should configure the hardware to respond to PFC frames from the DUT.

Type: enum

Default: MANUAL

Possible Values:

Value	Description
AUTOMATIC	Create DCBx devices to match the current test configuration.
NEGOTIATE_VIA_DCBX	Use existing DCBx configs to negotiate PFC pause queues with the DUT.
MANUAL	Manually enable/disable pause response via the PriorityFlowControlArray property.

PfcPauseQueueEnableDCBX24

Option to enable Data Bridging Capability Exchange 2.4.

Type: bool

Default: FALSE

Possible Values:

Value	Description
TRUE	Data Bridging Capability Exchange 2.4 is enabled.
FALSE	Data Bridging Capability Exchange 2.4 is disabled.

PfcPauseTxRate

NOTE: This attribute is deprecated. It will be removed in subsequent releases, so it is recommended that you do not use it.

Pause transmission rate (in pauses per second, per device).

Type: u32

Default: 1

Range: 1 - 1000

PriorityFlowControlArray

Specifies which priorities will be paused in response to a PFC frame from the DUT.

Type: bool

Default: TRUE

Possible Values:

Value	Description
TRUE	Enable PFC pausing for the corresponding priority.
FALSE	Disable PFC pausing for the corresponding priority.

PriorityFlowControlTxArray

Specifies which Priorities will be paused by PFC frames transmitted from the test tool.

Type: bool

Default: TRUE

Possible Values:

Value	Description
TRUE	Enable PFC pausing for the corresponding priority.
FALSE	Disable PFC pausing for the corresponding priority.

QuantaIterationMode

This option configures how the PFC quanta value is iterated.

Type: enum

Default: FIXED

Possible Values:

Value	Description
CUSTOM	Use a CUSTOM list of quanta values.
FIXED	Use a single, FIXED quanta value.
STEP	STEP quanta values by a fixed amount between a min and max quanta value.
RANDOM	Use a uniform, RANDOM distribution of quanta values between 0 and 65535.

QuantaOverlap

Adjusts the gap between sequential non-zero PFC pause frames.

Type: double

Default: 50

Range: 10 - 90

RandomMaxFrameSize

Maximum frame size to use when iteration mode is RANDOM.

Type: u16

Default: 256

Range: 40 - 16383

RandomMinFrameSize

Minimum frame size to use when iteration mode is RANDOM.

Type: u16

Default: 128

Range: 40 - 16383

ResultViewMode

Specifies which set of hardware counters will be used during the test run.

Type: enum

Default: LATENCY_JITTER

Possible Values:

Value	Description
BASIC	Use the BASIC result mode. This mode provides Advanced Sequencing.
HISTOGRAM	Use the HISTOGRAM result mode.
JITTER	Use the JITTER result mode.
INTERARRIVALTIME	Use the INTERARRIVALTIME result mode.
FORWARDING	Use the FORWARDING result mode. This mode provides Advanced Sequencing.
LATENCY_JITTER	Use the LATENCY_JITTER result mode.

StepBurstSizeEnd

Final burst size value to use when iteration mode is STEP.

Type: u32

Default: 1000

Range: 1 - 4294967295

StepBurstSizeStart

Initial burst size value to use when iteration mode is STEP.

Type: u32

Default: 100

Range: 1 - 4294967295

StepBurstSizeStep

Burst size step value to use when iteration mode is STEP.

Type: u32

Default: 100

Range: 1 - 4294967295

StepFrameSizeEnd

Final frame size to use when iteration mode is STEP.

Type: u16

Default: 1518

Range: 40 - 16383

StepFrameSizeStart

Initial frame size to use when iteration mode is STEP.

Type: u16

Default: 128

Range: 40 - 16383

StepFrameSizeStep

Frame size step value to use when iteration mode is STEP.

Type: u16

Default: 128

Range: 1 - 16383

StepLoadSizeEnd

Final load to use for STEP iteration mode.

Type: double

Default: 10

StepLoadSizeStart

Initial load to use for STEP iteration mode.

Type: double

Default: 100

StepLoadSizeStep

Load value to increment by for STEP iteration mode.

Type: double

Default: 10

Range: 0.001 - 100000000000.0

StepPauseRateEnd

Final pause rate to use when iteration mode is STEP.

Type: u32

Default: 200

Range: 1 - 1000

StepPauseRateStart

Initial pause rate to use when iteration mode is STEP.

Type: u32

Default: 50

Range: 1 - 1000

StepPauseRateStep

Pause rate step to use when iteration mode is STEP.

Type: u32

Default: 50

Range: 1 - 1000

StepPauseTimeEnd

Final pause time value to use when iteration mode is STEP.

Type: u32

Default: 32768

Range: 1 - 67108863

StepPauseTimeStart

Initial pause time value to use when iteration mode is STEP.

Type: u32

Default: 1024

Range: 1 - 67108863

StepPauseTimeStep

Pause time step value to use when iteration mode is STEP.

Type: u32

Default: 1024

Range: 1 - 67108863

StepQuantaEnd

Final quanta value to use when iteration mode is STEP.

Type: u16

Default: 1024

StepQuantaStart

Initial quanta value to use when iteration mode is STEP.

Type: u16

Default: 0

StepQuantaStep

Quanta step value to use when iteration mode is STEP.

Type: u16

Default: 128

Range: 1 - 65535

StepXonDelayEnd

NOTE: This attribute is deprecated. It will be removed in subsequent releases, so it is recommended that you do not use it.

Final XON delay value to use when iteration mode is STEP.

Type: u32

Default: 32768

Range: 1 - 67108863

StepXonDelayStart

NOTE: This attribute is deprecated. It will be removed in subsequent releases, so it is recommended that you do not use it.

Initial XON delay value to use when iteration mode is STEP.

Type: u32

Default: 1024

Range: 1 - 67108863

StepXonDelayStep

NOTE: This attribute is deprecated. It will be removed in subsequent releases, so it is recommended that you do not use it.

Step XON delay values by this value when iteration mode is STEP.

Type: u32

Default: 1024

Range: 1 - 67108863

Tolerance

Specifies the range of values considered a pass for this test case (in % of line rate).

Type: double

Default: 1.0

Range: 0.001 - 10.0

XonDelayIterationMode

NOTE: This attribute is deprecated. It will be removed in subsequent releases, so it is recommended that you do not use it.

This option configures how the XON Delay is iterated. Only applicable when EnableXonXoffFlowControl is TRUE.

Type: enum

Default: FIXED

Possible Values:

Value	Description
CUSTOM	Use a CUSTOM list of XON Delay value.
FIXED	Use a single, FIXED XON Delay value.
STEP	STEP XON Delay values by a fixed amount between a min and max XON Delay value.

XonDelayUnit

NOTE: This attribute is deprecated. It will be removed in subsequent releases, so it is recommended that you do not use it.

Specifies what units are used to describe XON delay.

Type: enum

Default: QUANTA

Possible Values:

Value	Description
QUANTA	XON delay value is in quanta.
BYTES	XON delay value is in bytes.

DcbPfcLoadValidationTestCaseConfig Read-Only Attributes

Read-Only Attribute

Description

ConfigIsValid

Indicates whether the test case currently has a valid configuration or not.

Type: bool

Default: TRUE

Possible Values:

Value	Description
TRUE	Current configuration is valid.
FALSE	Current configuration is not valid.

ConfigValidationErrors

Provides validation errors when the test case determines that the configuration is invalid.

Type: string

Default: 0

FrameSizeIsValid

Indicates whether the test case currently has a valid frame size configuration or not.

Type: bool

Default: TRUE

Possible Values:

Value	Description
TRUE	Current frame size configuration is valid.
FALSE	Current frame size configuration is not valid.

FrameSizeValidationErrors

Provides frame size validation errors when the test case determines that the frame size configuration is invalid.

Type: string

Default: 0

LoadIsValid

Indicates whether the test case currently has a valid load configuration or not. An invalid load indicates that a port is oversubscribed.

Type: bool

Default: TRUE

Possible Values:

Value	Description
TRUE	Current load configuration is valid.
FALSE	Current load configuration is invalid.

LoadValidationErrors

Provides load validation errors when the test case determines that the load configuration is invalid.

Type: string

Default: 0