Stateless Packet Generator produces a configured stream of untagged Ethernet/IPv4/UDP packets. Use it for controlled packet-generation checks in an existing compatible design. It supplies packet fields, pacing, and a finite generation duration; it does not simulate a stateful application conversation.
Return to Validation Tools for the component selection table and shared execution workflow.
Current Scope And Required Topology
The current generator requires a retained HostPool component. HostPool is hidden from the current palette but remains loadable in compatible saved designs. A newly added generator and TestPort alone are incomplete, and Test Hosts cannot substitute for HostPool on the generator's Hosts pad.
| Generator pad | Required peer | Connection |
|---|---|---|
| Wire, pad 0 | A single-queue TestPort | Bidirectional; uses Q0 on the same physical interface for RX and TX. |
| Hosts, pad 1 | Retained HostPool | Bidirectional, with the same peer in both directions. |
Include one Test Project for the TestPort and recorded run. Open an existing compatible design to use this topology. For a new packet-replay design that does not depend on HostPool, use PCAP Replay. Use Test Hosts for client/server application activities.
The implemented generator has one generation lane, a maximum configured load of 100 Mbps, and untagged IPv4/UDP packet construction. It is not a line-rate or physical-layer qualification tool.
Configure The Packet And Load
| Setting | Meaning | Initial value |
|---|---|---|
| Source MAC / Destination MAC | Explicit Ethernet addresses. The destination is the next-hop MAC for the intended path. | 02:00:00:00:00:01 / 02:00:00:00:00:02 |
| Source IPv4 / Destination IPv4 | Addresses placed in generated packets. | 198.18.0.1 / 198.18.0.2 |
| UDP Source Port / UDP Destination Port | Transport fields used by the generated stream. | 49152 / 49153 |
| Frame Size (bytes) | Ethernet frame size including FCS, from 64 to 1518 bytes. | 128 bytes |
| Offered Rate (bps) | Configured wire-rate target, including FCS, preamble, and inter-frame gap. | 10,000,000 bps |
| Duration (seconds) | Finite generation interval, from 1 to 86,400 seconds. | 10 seconds |
| Generation Lanes | Current implementation supports one lane. | 1 |
Set the destination MAC explicitly: this generator does not discover it through ARP or borrow the management interface's neighbor table. IPv4 and UDP checksums are generated in software. The NIC supplies the Ethernet FCS.
The offered rate includes eight bytes of preamble/SFD and twelve bytes of inter-frame gap in addition to the frame size. A displayed byte rate that excludes this overhead will be lower. HostPool traffic is additional to the configured generation load.
Receive Forwarding
Forward All RX to HostPool is enabled initially. Received packets are sent to HostPool, which applies its own host ownership and admission policy.
Disabling the option enables the generator's software filter. ARP and IPv4 ICMP, plus the configured Slow-path TCP Ports and Slow-path UDP Ports, go to HostPool. Bulk UDP and unmatched traffic go to an intentional software sink. The bulk destination port cannot also be a slow-path UDP port. VLAN, IPv6, and fragmented packets are outside that filter's admitted scope.
The receive-forwarding path and generated traffic share the Wire output. Output queues are bounded, so inspect their drop counters when comparing load with actual delivery. Intentional sink packets are distinct from queue drops.
Run A Baseline Check
- Open a saved compatible design and confirm both Wire and Hosts connections. Check its retained HostPool settings and the service's Test Project.
- Select the intended physical TestPort, leave it at one queue, and connect an independent receiver or capture device.
- Configure the MAC/IP addresses and UDP ports for that path. For a modest first check, use a 128-byte frame, 10 Mbps, and a 10-second duration.
- Confirm the receive-forwarding policy and any slow-path port filters. Keep the bulk UDP destination outside the slow-path UDP list.
- Save and verify, then start with Stop when complete when automatic finalization is desired.
- Let generation finish and allow its one-second receive drain and the project's completion grace. Compare generator, TestPort, and receiver counts.
- Review recording completeness and selected Validation Rules before drawing an acceptance conclusion.
Measurements And Completion
The generator reports generated packets/bytes, received packets/bytes, allocation failures, malformed packets, intentional sink packets, HostPool traffic, and software-output drops. Generated byte counts exclude FCS.
Generated packets are offered packets, rather than proof that they reached the wire. TestPort TX totals provide a separate device observation; the peer's receive or capture totals establish delivery at that receiver. Keep all three measurement points distinct.
Generation ends at the configured duration, followed by a bounded one-second receive/slow-path drain. A manual interruption remains cancelled. A worker or recording failure must be reviewed as a failure or incomplete result, rather than treating the elapsed duration as success.
Troubleshooting
| Symptom | What to check |
|---|---|
| Verification reports a missing Hosts peer. | Both duplex connections and the retained HostPool dependency. Test Hosts is not a compatible replacement. |
| Offered packets do not reach the receiver. | Destination MAC, cabling, selected TestPort, MTU, IP/UDP fields, and output drops. |
| Displayed byte rate differs from the configured rate. | Whether the measurement includes FCS, preamble, and inter-frame gap, and whether it includes HostPool traffic. |
| Packets appear in the sink instead of HostPool. | Forward All RX setting and slow-path TCP/UDP filters. |
| The design requests multiple lanes. | Reduce to the supported single-lane topology. |
Field Reference
Stateless Packet Generator field reference and initial values
Initial values describe a newly added component. Saved designs keep their configured values. Dependent fields appear when their controlling option is selected.
| Setting | Purpose | Initial value |
|---|---|---|
| Forward All RX to HostPool | Prototype receive path; disable to use ARP/ICMP and configured TCP/UDP filters | Enabled |
| Generation Lanes | One lane in this prototype | 1 |
| Offered Rate (bps) | Generator rate including FCS, preamble and inter-frame gap; HostPool traffic is additional | 10000000 |
| Duration (seconds) | Generation time followed by a one-second receive drain | 10 |
| Frame Size (bytes) | Ethernet frame including FCS; untagged IPv4/UDP | 128 |
| UDP Source Port | Generated packet source port | 49152 |
| UDP Destination Port | Generated packet destination port; excluded from slow path when filtering is enabled | 49153 |
| Source MAC | Unicast Ethernet source | 02:00:00:00:00:01 |
| Destination MAC | Static next-hop MAC; no automatic neighbor resolution | 02:00:00:00:00:02 |
| Source IPv4 | Generated source address | 198.18.0.1 |
| Destination IPv4 | Generated destination address | 198.18.0.2 |
| Slow-path TCP Ports | Comma-separated ports (up to 16); ARP and ICMP are admitted automatically | Not set |
| Slow-path UDP Ports | Comma-separated ports (up to 16), excluding the bulk UDP port | Not set |
| Compute Resources | Allocate compute resource for the service | 1 configured item |