OBSERVE. ANALYZE. ACT.
Support Login

FlowMagic NextIO Components

FlowMagic Stateless Packet Generator

Configure a controlled Ethernet/IPv4/UDP stream, understand the retained HostPool topology, and compare offered traffic with port and receiver measurements.

UI Path: NextIO Diagram Editor → Components → Validation Tools → Stateless Packet Generator ID: nextio-flowmagic-stateless-generator

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

  1. Open a saved compatible design and confirm both Wire and Hosts connections. Check its retained HostPool settings and the service's Test Project.
  2. Select the intended physical TestPort, leave it at one queue, and connect an independent receiver or capture device.
  3. 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.
  4. Confirm the receive-forwarding policy and any slow-path port filters. Keep the bulk UDP destination outside the slow-path UDP list.
  5. Save and verify, then start with Stop when complete when automatic finalization is desired.
  6. Let generation finish and allow its one-second receive drain and the project's completion grace. Compare generator, TestPort, and receiver counts.
  7. 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.

SettingPurposeInitial 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