GeneratorConfig Object

HOME | TECHNOLOGIES | TEST CONFIGURATION | SEQUENCER COMMANDS | GUI COMMAND NAMES | ALL COMMANDS | RESULT | PDU | ALL | OBJECT TREE

Description:

Port configuration related to traffic generation. Exposes the Spirent TestCenter generator hardware capabilities, including time stamp reference location, counter configuration, etc.

Children: ManualSchedule

Automatically created from: Generator

GeneratorConfig Writable Attributes

Attribute Description
Common Writable Attributes Active, Name
AdvancedInterleaving

Used to enable the option to interleave packets to reduce the burstiness of the traffic. Applicable to Rate Based scheduler only.

Type: bool

Default: FALSE

Possible Values:

Value Description
TRUE

Enable advanced interleaving.
FALSE

Disable advanced interleaving.
BurstSize

Number of frames in each burst transmitted.

Type: u32

Default: 1
Duration

Length of packet transmission. You specify the transmission unit by the duration mode.

Type: double

Default: 30
DurationMode

Length of transmission in terms of continuous, bursts, or seconds.

Type: enum

Default: CONTINUOUS

Possible Values:

Value Description
CONTINUOUS

Generate traffic continuously until stopped manually.
BURSTS

Generate traffic for the specified number of bursts.
SECONDS

Generate traffic for the specified number of seconds.
TABLE_REPETITIONS

Repeat the manual schedule table for specified number of times.
STEP

Generator will transmit one packet each time you start the traffic. The sequence of the packets depends on the order of the entries configured in the manual schedule table. All the packets generated from the first entry will be transmitted before proceeding to the second entry.
EnableRateGranularity

Determines if the generator will use new functionality to improve the accuracy of high bitrate streams in tandem to more granular low bitrate streams. If enabled, the burst size parameter is not supported.

Type: bool

Default: FALSE

Possible Values:

Value Description
TRUE

Rate Granularity is enabled.
FALSE

Rate Granularity is disabled.
FixedLoad

Fixed load value.

Type: double

Default: 10
InterFrameGap

Gap (bytes) between frames in the same burst, when the burst size is greater than 1.

Type: double

Default: 12
InterFrameGapUnit

Unit for inter-frame gap.

Type: enum

Default: BYTES

Possible Values:

Value Description
PERCENT_LINE_RATE

inter-frame gap as a percentage of the maximum bandwidth available on the test module.
FRAMES_PER_SECOND

inter-frame gap as the number of frames per second.
BYTES

inter-frame gap as the number of bytes.
MILLISECONDS

inter-frame gap in milliseconds.
NANOSECONDS

inter-frame gap in nanoseconds.
BITS_PER_SECOND

inter-frame gap as the number of bits per second.
KILOBITS_PER_SECOND

inter-frame gap as the number of kilobits per second.
MEGABITS_PER_SECOND

inter-frame gap as the number of megabits per second.
JumboFrameThreshold

Transmitted frame sizes above this threshold will be counted as jumbo frames. The value you specify must be less than the over-sized frame threshold to avoid frames being counted as over-sized but not counted as jumbo frames.

Note: 10/100/1000 Mbps Ethernet range is 12-16383; 10 Gigabit Ethernet range is 56-16383; POS range is 46-16383.

Type: s16

Default: 1518
LoadMode

Load mode as fixed or random rate.

Type: enum

Default: FIXED

Possible Values:

Value Description
FIXED

Use fixed load value.
RANDOM

Use random load value.
LoadUnit

Load unit for the overall port load when in port-based scheduling mode.

Type: enum

Default: PERCENT_LINE_RATE

Possible Values:

Value Description
PERCENT_LINE_RATE

Load as a percentage of the maximum bandwidth available on the test module. Minimum = 0.001.
FRAMES_PER_SECOND

Load as the number of frames per second. Minimum = 1; maximum depends on the frame size (bit rate/((frame size + 8) * 8 + 12 * 8)).
INTER_BURST_GAP

Load as the gap in bytes between adjacent bursts.
BITS_PER_SECOND

Load as the number of bits per second. Minimum depends on frame length and minimum allowable interframe gap of the test module. Maximum depends on port speed: 10/100/1000 Ethernet = 10000000/100000000/1000000000; 10 Gigabit Ethernet = 10000000000; OC-3 = 149760000; OC-12 = 599040000; OC-48 = 2396160000; OC-192 = 9584640000.
KILOBITS_PER_SECOND

Load as the number of kilobits per second. Minimum = 1. Maximum depends on port speed: 10/100/1000 Ethernet = 10000/100000/1000000; 10 Gigabit Ethernet = 10000000; OC-3 = 149760; OC-12 = 599040; OC-48 = 2396160; OC-192 = 9584640.
MEGABITS_PER_SECOND

Load as the number of megabits per second. Minimum = 1. Maximum depends on port speed: 10/100/1000 Ethernet = 10/100/1000; 10 Gigabit Ethernet = 10000; OC-3 = 149.76; OC-12 = 599.04; OC-48 = 2396.16; OC-192 = 9584.64.
L2_RATE

Load as the number of layer 2 bits per second. Minimum depends on frame length and minumum allowable interframe gap of the test module. Maximum depends on port speed.

OversizeFrameThreshold

Transmitted frame sizes above this threshold will be counted as over-sized frames.

Note: 10/100/1000 Mbps Ethernet range is 12-16383; 10 Gigabit Ethernet range is 56-16383; POS range is 46-16383.

Type: s16

Default: 9018
RandomLengthSeed

Seed value for generating a random frame length.

Type: s32

Default: 10900842

Range: 1 - 16777215
RandomMaxLoad

Maximum random port load when in port-based scheduling mode.

Type: double

Default: 100
RandomMinLoad

Minimum random port load when in port-based scheduling mode.

Type: double

Default: 10
SchedulingMode

Scheduling mode as port, rate, priority, or manual based. The scheduling mode affects the sequence in which frames from each stream block are transmitted.

Type: enum

Default: PORT_BASED

Possible Values:

Value Description
PORT_BASED

Load is controlled at port level; guarantees a fixed interframe gap for Layer 2 testing. The order of frames sent is determined by the order of the configured stream blocks.

Example: Port load = 60%, burst size = 2, 3 stream blocks (Stream Block A = 1 stream, Stream Block B = 1 stream, Stream Block C = 2 streams). Packet sequence = A B, C1 C2, A B, C1 C2, A B.
RATE_BASED

Load is controlled at stream block level.

Example: 3 stream blocks (Stream Block A = 1 stream, Stream Block B = 1 stream, Stream Block C = 2 streams); 10% load on Stream Block A, 10% load on Stream Block B, and 20% load on Stream Block C; burst size = 2. The Scheduler algorithm first determines the ratio (1:1:2) between stream block loads, then uses burst size to build the Stream Sequence Table. Packet sequence = A A, B B, C1 C1, C2 C2, A A. Each stream block is repeated as many times as specified by the burst size; ratio between stream blocks remains 1:1:2.
PRIORITY_BASED

High priority stream blocks are scheduled first; lower priority stream blocks are fit into gaps left available by higher priority stream blocks.

Per-stream block burst configuration can be specified, as well as per-stream block load, including interframe gap. Each stream block is considered an independent traffic source generating periodic bursts of traffic based on burst size, interframe gap, and load. The Scheduler interleaves multiple stream block traffic in round-robin mode.
MANUAL_BASED

Provide rate control to users such that they will be able to program the rates of the streams and bursts, as well as the gaps between streams, bursts and frames.

Users can control the order in which stream blocks are transmitted. One stream block can be scheduled in multiple table entries with different rates. Users will also be able to repeat sequence by using loops. Users can also specify the size of the bursts and the number of bursts for each stream block. Schedule can be modified in real-time without stopping the generator.
SmoothenRandomLength

Indicate if smoothen random length distribution per port is generated.

Type: bool

Default: FALSE

Possible Values:

Value Description
TRUE

Smoothen random length distribution is enabled, which requires length to be uniformly distributed across the minimum and maximum length integer values.

FALSE

Smoothen random length distribution is not enabled

StepSize

Number of packets to transmit per step. Applicable to step mode.

Type: u16

Default: 1
TimestampLatchMode

Position the timestamp on a specific frame location.

Type: enum

Default: START_OF_FRAME

Possible Values:

Value Description
START_OF_FRAME

Position the timestamp on the start of the frame.
END_OF_FRAME

Position the timestamp on the end of the frame.
UndersizeFrameThreshold

Transmitted frame sizes below this threshold will be counted as under-sized frames.

Note: 10/100/1000 Mbps Ethernet range is 12-16383; 10 Gigabit Ethernet range is 56–16383; POS range is 46–16383.

Type: s16

Default: 64

GeneratorConfig Read-Only Attributes

Read-Only Attribute Description
AvgBpsLoad

Average load value as the number of bits per second.

Type: double

Default: 100000000
AvgFpsLoad

Average load value as the number of frames per second.

Type: double

Default: 84459
AvgIbgLoad

Average load value as the gap (in bytes) between adjacent bursts.

Type: double

Default: 1344
AvgKbpsLoad

Average load value as the number of kilobits per second.

Type: double

Default: 100000
AvgL2Rate

Average layer 2 bit rate.

Type: double

Default: 100000000
AvgMbpsLoad

Average load value as the number of megabits per second.

Type: double

Default: 100
AvgPercentageLoad

Average load value as percentage of line rate.

Type: double

Default: 10
BandwidthUtilization

Read-only property used to show the port bandwidth utilization i.e. the total port load as percentage of max line rate.

Type: double

Default: 0
BpsIfg

inter-frame gap as the number of bits per second.

Type: double

Default: 100000000
BpsLoad

Load value as the number of bits per second.

Type: double

Default: 100000000
BytesIfg

inter-frame gap as the number of bytes.

Type: double

Default: 12
FpsIfg

inter-frame gap as the number of frames per second.

Type: double

Default: 84459
FpsLoad

Load value as the number of frames per second.

Type: double

Default: 84459
IbgLoad

Load value as the gap (in bytes) between adjacent bursts.

Type: double

Default: 1344
IsPriorityManualSchedulingSupported

Indicate if generator supports priority and manual scheduling modes.

Type: bool

Default: TRUE

Possible Values:

Value Description
TRUE

Generator supports priority and manual scheduling modes.

FALSE

Generator does not support priority and manual scheduling modes.
KbpsIfg

inter-frame gap as the number of kilobits per second.

Type: double

Default: 100000
KbpsLoad

Load value as the number of kilobits per second.

Type: double

Default: 100000
L2Rate

Layer 2 bit rate.

Type: double

Default: 86486016
MaxBpsLoad

Maximum load value as the number of bits per second.

Type: double

Default: 100000000
MaxFpsLoad

Maximum load value as the number of frames per second.

Type: double

Default: 84459
MaxIbgLoad

Maximum load value as the gap (in bytes) between adjacent bursts.

Type: double

Default: 1344
MaxKbpsLoad

Maximum load value as the number of kilobits per second.

Type: double

Default: 100000
MaxL2Rate

Maximum layer 2 bit rate.

Type: double

Default: 100000000
MaxMbpsLoad

Maximum load value as the number of megabits per second.

Type: double

Default: 100
MaxPercentageLoad

Maximum load value as percentage of line rate.

Type: double

Default: 10
MbpsIfg

inter-frame gap as the number of megabits per second.

Type: double

Default: 100
MbpsLoad

Load value as the number of megabits per second.

Type: double

Default: 100
MillisecondsIfg

inter-frame gap in milliseconds.

Type: double

Default: 1344
MinBpsLoad

Minimum load value as the number of bits per second.

Type: double

Default: 100000000
MinFpsLoad

Minimum load value as the number of frames per second.

Type: double

Default: 84459
MinIbgLoad

Minimum load value as the gap (in bytes) between adjacent bursts.

Type: double

Default: 1344
MinKbpsLoad

Minimum load value as the number of kilobits per second.

Type: double

Default: 100000
MinL2Rate

Minimum layer 2 bit rate.

Type: double

Default: 100000000
MinMbpsLoad

Minimum load value as the number of megabits per second.

Type: double

Default: 100
MinPercentageLoad

Minimum load value as percentage of line rate.

Type: double

Default: 10
NanosecondsIfg

inter-frame gap in nanoseconds.

Type: double

Default: 1344
PercentageIfg

inter-frame gap as a percentage of the maximum bandwidth available on the test module.

Type: double

Default: 10
PercentageLoad

Load value as percentage of line rate.

Type: double

Default: 10