background image

Ethernet Packet Generator 

USER GUIDE 

APG-UG-V2-1 

8 February 2018 

 

Ethernet Packet Generator 

USER GUIDE 

Version 2.1 

 

APG4   APG8   APG200   APG208 

 

 

Summary of Contents for APG200

Page 1: ...Ethernet Packet Generator USER GUIDE APG UG V2 1 1 8 February 2018 Ethernet Packet Generator USER GUIDE Version 2 1 APG4 APG8 APG200 APG208 ...

Page 2: ...1 Added File Save Section 6 3 1 Added Tools Upgrade Section 6 3 8 3 November 2016 1 1 Added APG200 7 June 2017 2 0 Updated FCC statement Added Port Topology changes Sections 3 1 2 and 5 3 including 40Gbps 4x10Gbps support on QSFP interfaces Added Burst Mode Section 6 5 1 Added Packet Second Mode Section 6 5 1 Added Packet Timestamps Section 6 5 3 Added Deep Packet Capture Section 6 9 Added Save to...

Page 3: ... the products including software will be uninterrupted free from error or secure The disclaimers in this section will not apply to the extent prohibited by applicable law The software is not designed intended or certified for use in components of systems intended for the operation of weapons weapons systems nuclear installations means of mass transportation aviation medical systems devices implant...

Page 4: ...nterfaces of the unit 5 TEST ENVIRONMENT CONCEPT Introduction to Ethernet packet generation packet structures and control 6 CONTROL INTERFACE Detailed guide to the APG Control Interface Related Documentation 1 APG GSG Axtrinet APG Getting Started Guide 2 APG TCL UG Axtrinet APG TCL API Guide 3 APG HDR Axtrinet APG Header Definitions 4 APG SW TC Axtrinet APG Software License Terms And Conditions Vi...

Page 5: ...are 14 2 6 Testing the Installation 15 2 7 Setting the IP Address 16 3 HARDWARE INTERFACES 17 3 1 Front Panel Interfaces 17 3 2 Rear Panel Interfaces 20 3 3 Physical Specifications 21 4 MANAGEMENT INTERFACES 22 4 1 APG Control Interface 22 4 2 TCL Scripting 22 5 TEST ENVIRONMENT CONCEPTS 23 5 1 Definitions 23 5 2 Unit Configuration 24 5 3 Port Topology 24 5 4 Transmit Path 25 5 5 Receive Path 27 6...

Page 6: ...structure installations encompassing cabling and switches 1 1 MAIN FEATURES Highly configurable Ethernet Packet Generation Full wire speed operation on all ports Industry standard QSFP and SFP ports Real time packet counts and error detection Packet Capture for post test analysis Simple to use Control Interface for configuration and control Clear LED status indication for unit operation and Ethern...

Page 7: ...h do not use in wet or damp conditions or near explosive gas or vapour To prevent damage to the Packet Generator use and store in the recommended environment Temperature Humidity Altitude Operating 0 C 40 C 5 to 90 RH non condensing 2000m Storage 20 C 55 C 1 4 CARE OF THE PRODUCT The Axtrinet Packet Generator contains no user serviceable parts Repair and servicing require specialised test equipmen...

Page 8: ...ial and industrial environments to provide reasonable protection against interference with licensed communication equipment Warning This is a Class A product In a domestic environment this product may cause radio interference in which case the user may be required to take adequate measures The product meets the intent of the Low Voltage Directive 2014 35 EU and has been designed to meet EN 61010 1...

Page 9: ...S EVEN IF AXTRINET IS INFORMED IN ADVANCE OF THE POSSIBILITY OF SUCH DAMAGES Should a product fail to perform as described above within the warranted period it will be repaired or replaced with the same or functionally equivalent product by Axtrinet at its discretion free of charge provided you 1 return the product to a Axtrinet designated repair facility with shipping charge prepaid or by using t...

Page 10: ... Technical assistance is available from Axtrinet at the following address Address Xentech Solutions Suite 6 Stanta Business Centre 3 Soothouse Spring St Albans AL3 6PF UK Phone 44 0 1727 867795 Email Technical Support Sales support axtrinet com sales axtrinet com Web Site www axtrinet com ...

Page 11: ...m USB Type B lead Getting Started Guide 4x Rubber Feet Axtrinet Resource CD for Windows and Linux USB Drivers APG Control Interface Application APG TCL API Documentation Visit www axtrinet com documentation for the latest documentation and software 2 2 MINIMUM SYSTEM REQUIREMENTS Processor Pentium class processor or equivalent Memory 2GB 4GB recommended Disk Space 15MB OS 64bit x86_64 Linux system...

Page 12: ... rpm U apgcontrol 2 1 1 x86_64 rpm or yum localinstall apgcontrol 2 1 1 x86_64 rpm Remove with rpm e apgcontrol There are a set of MD5 SHA1 SHA256 sums for the package files The package includes a desktop link that should appear under Network tools If it doesn t work Provided the package install worked once installed there should be an executable apgcontrol in usr bin If it does not run then check...

Page 13: ...ON IS COMPLETE 4 Read and accept the software Licence Agreement 5 Select the components to install The installer will only update the installed components if a newer component is available Click to start installing the selected components 6 The window changes to display the installation progress 7 completes the installation process 8 In addition to run the scripting interface you will require to h...

Page 14: ...e POWER LED will be illuminated ORANGE for 60 seconds while the hardware configures The POWER LED will turn GREEN after successful configuration or RED if the hardware has failed to configure If the POWER LED turns RED after configuration contact AXTRINET for further support Connect the management PC to the APG unit using the USB Type B lead provided USB Type B Type A AC Supply 12Vdc AC DC Adapter...

Page 15: ...isplayed and the new unit will appear as a USB connection If the unit does not appear in the Control Interface check that the unit is turned on and the USB lead is connected If installing the drivers onto a PC for the first time it may be necessary to re run the installation process after the device has been connected as the USB drivers may not be enabled To connect to the unit click on the Checkb...

Page 16: ...0 Gateway 0 0 0 0 You may need to contact your Network Administrator to obtain the required IP and Gateway Addresses To change the IP Address of the unit On the MENU BAR Edit Network Configuration The IP Configuration Window opens Current Settings New Settings Unit Set the IP Address Mask and Gateway Address then click APPLY For further details see Section 6 3 6 ...

Page 17: ...FACES The packet generator ports SFP QSFP are on the front of the unit and the management and power interfaces are on the rear 3 1 FRONT PANEL INTERFACES Status LEDs 10Gbps SFP 10Gbps SFP 40Gbps QSFP APG208 APG8 APG4 APG200 10Gbps SFP 40Gbps QSFP APG4 4 0 APG8 8 0 APG200 0 2 APG208 8 2 ...

Page 18: ...bled in the lower ports 2 4 6 8 3 1 2 QSFP Interfaces The QSFP interfaces will support 40Gbps QSFPs that meet SFF 8436 MSA The list of verified QSFPs is available on the Axtrinet website www axtrinet com transceivers html The QSFP interfaces can be configured in 40Gbps mode default or 4X10Gbps mode where each of the 10Gbps lanes that comprise the 40Gbps link are managed independently Section 5 3 S...

Page 19: ...ile the hardware configures Flashing AMBER Processing downloaded file 3 4 minutes RED AMBER Failed to configure the hardware Power cycle the unit If the problem persists contact AXTRINET for Technical Support RED Initial state immediately after the power has been applied If the LED remains on for 5 sec critical hardware fault detected Power cycle the unit If the problem persists contact AXTRINET f...

Page 20: ...ol Interface Application Software USB Hub a Direct Connection b Multiple APG units connected through USB Hub After installing the Control Interface Application Software no further configuration is required to enable the USB interface 3 2 2 10 100Base T Ethernet Interface The 10 100Base T RJ45 interface can be used to provide a network connection to the PC running the Control Interface Application ...

Page 21: ... eg two Control Interface sessions or one Control Interface session and one TCL session 3 2 3 Sync Interface The Sync Interface allows multiple units to be connected together for synchronous transmit START STEP and STOP control The Sync Interface is reserved for future use 3 2 4 Power The APG unit requires a 12V 5A from the ac dc power supply provided The DC Jack is 2 1mm internal diameter 5 5mm e...

Page 22: ...rt control start step stop packet counters packets bytes errors packet capture tools The Axtrinet APG Control Interface is described in Section 6 4 2 TCL SCRIPTING The Axtrinet APG API provides a TCL scripting interface for automated test generation The API provides access to unit port and stream configuration and status port control start step stop packet counters packets bytes errors packet capt...

Page 23: ...n be seen in the Connection Panel Section6 4 and in the port label in the Counters Panel Section 6 6 PORT A PORT is a physical aperture on the unit SFP or QSFP The port level functions configure the port settings and monitor the port status Section 6 8 1 and view the captured packets Section 6 8 2 Ports must be selected Section 6 6 to start step stop transmission Section 6 6 SUBPORT Where a QSFP p...

Page 24: ...interface is a composite port made up of 4x 10Gbps The topology can be configured in 40Gbps mode default or 4X10Gbps mode where each of the 10Gbps lanes that comprise the 40Gbps link are managed independently Changing the port topology of a QSFP port changes both the transmit and receive paths Stream Generators Stream Generators Stream Generators Stream Generators 10Gbps MAC 10Gbps Serdes 10Gbps M...

Page 25: ... a link up both the port and module must be enabled To transmit a stream the port module and stream must be enabled The transmit mode must be CONTINUOUS or a non zero BURST 5 4 1 Stream Generation The Stream Generator defines an Ethernet frame HEADERS PAYLOAD TIMESTAMP OPTIONAL FRAME LENGTH 4 BYTES FIXED INCREMENTING DECREMENTING RANDOM HEADER AND FIELD LENGTHS NOT DRAWN TO SCALE SFD Start of Fram...

Page 26: ...ll transmit at wire rate but the streams will transmit at a lower rate than configured The length defines the total length of the frame in bytes including the headers payload timestamp if enabled and 4 byte Frame Checksum FCS The length can be fixed or incrementing decrementing or random over a range Section 6 5 1 The HEADER is created by adding header types eg MAC VLAN IPV4 to the stream Section ...

Page 27: ...6 8 1 The module type vendor and capabilities are available Section 6 8 2 5 5 RECEIVE PATH Each port contains a receive path that comprises Receive port status and counters Filter stream multiplexer Configurable Capture Buffer FILTER 0 is reserved for internal use only FILTER 0 FILTER 1 FILTER 2 FILTER 3 Mask PORT N MODULE Receive Counters CAPTURE BUFFER Filter Counters Captured Data Match Enable ...

Page 28: ...e unit shared between the ports Access to the deep capture memory can be enabled or disabled per port The Deep Capture Memory is divided equally between the total possible number of 10Gbps lanes in APG Control Interface Version 2 1 Each 10Gbps port is allocated 64MB Each 40Gbps port is allocated 256MB The port receive counters Section 6 7 and captured packets Section 6 8 2 are available ...

Page 29: ...OVERVIEW The APG Control Interface comprises 5 areas Menu Bar APG Control Interface configuration and settings See Section 6 3 Connection Panel Open Close management connections to the packet generator units See Section 6 4 Stream Configuration Panel Port Stream Configuration See Section 6 5 Control Panel Start Stop packet generator and clear counters See Section 6 6 Counter Panel Packet Generator...

Page 30: ...ile Save As Saves the current Control Interface configuration including APG Control Interface layout settings and port counters Port and Stream configuration for all connected units A File Save As window appears to select the save file name and location The saved configuration file has a apg extension Saved configurations can be applied using the Load Configuration option 6 3 3 File Load Loads a s...

Page 31: ...iguration where the contents are analysed to determine how many units were included in the saved configuration The saved GUI Layout and Counter Selection will be applied if the corresponding checkbox is enabled The stream configuration is always applied A list of saved serial numbers and unit types are displayed with a corresponding apply list of currently connected units The connected unit list c...

Page 32: ...en 0 5 2 seconds 6 3 6 Edit Network Configuration The network configuration is entered using the Network Configuration window Current Settings New Settings Unit You may need to contact your Network Administrator to obtain the required IP and Gateway Addresses The serial number of the target unit is displayed If more than one unit is connected through the APG Control Interface select the desired un...

Page 33: ...ers are always active so can be viewed or hidden without affecting the counter values Counter management is performed using the Counter Configuration window Display Pane Available Counter Pane Separator Selected Counter Insert Point The following control buttons are available Button Action Adds the selected counters to the DISPLAY COUNTER pane at the insert point The insert point can be moved UP a...

Page 34: ... length between 1025 and 1536 bytes Tx1537 9000 Transmitted Packets with length between 1537 and 9000 bytes Tx 9000 Transmitted Packets with length greater than 9000 bytes The following receive counters are available Receive Description RxBytes Receive Bytes RxPackets Valid Receive Packets Rx64 Valid Receive Packets with length equal to 64 bytes Rx65 128 Valid Receive Packets with length between 6...

Page 35: ... gigabits per second Rx PPS Receive Packets per Second FCS RxPkts FCS Error Rate percentage 6 3 8 Tools Upgrade Unit The embedded software and FPGA firmware can be updated through the download window Current Versions Download files Unit Directory Path Software Version FPGA Version Select the target unit by the serial number from the dropdown list The current embedded software and FPGA firmware ver...

Page 36: ...age is downloaded to the unit Image download takes 2 3 minutes When the download completes the download complete message is displayed and the unit reboots The PWR LED flashes amber while the new image is processed and saved into FLASH memory The re FLASH process takes 3 4 minutes The unit then boots normally Total download re FLASH and reboot time is 6 8 minutes 6 3 9 About Displays the current AP...

Page 37: ...Connection Ethernet Connection Unit Serial Number Unit ID Connections to networked units must be defined using the button Click on the Connect Checkbox to toggle the management connection The USB interface does not display a connection status The Unit Status serial number and ID are greyed out when not connected The visible ports are automatically added to the counter pane when the management inte...

Page 38: ...e GUI API the management connection is refused Download the latest Embedded Software from www axtrinet com software html Then use the Upgrade Unit tool Section 6 3 8 Failed to connect to the APG management interface If the connection fails check IP Address Can you ping the APG unit Is the APG unit connected to the network Is the IP address configured on the APG unit If trying to connect from a dif...

Page 39: ...s TEMP Temperature OK Temperature Warning fan speed will increase Over Temperature front panel disabled FAN Fan OK Fan is running faster than expected Fan is running at full speed SELF TEST Self Test passed Self Test running Self Test Failed READY status will also be RED READY Unit OK and ready to generate Ethernet Traffic Unit booting Unit failed Up Time Time since the unit was turned on Versions...

Page 40: ...t Control Panel Apply Refresh Payload Configuration Panel Port Label Enable Stream Expander Stream Enabled Stream Disabled 6 5 1 Transmit Control The stream transmit mode rate and length are configured in the Transmit Control Panel Option Setting ENABLE ON Enable stream for port transmission OFF Disable stream MODE CONTINUOUS Transmit continuously until STOPPED or PAUSED SINGLE BURST Transmit BURS...

Page 41: ... SIZE FIXED Transmit packets of a single packet length only INCREMENT Transmit packets with incrementing packet length starting with SIZE MIN to SIZE MAX wrapping to SIZE MIN DECREMENT Transmit packets with decrementing packet length starting with SIZE MAX to SIZE MIN wrapping to SIZE MAX RANDOM Transmit packets with random packet length between SIZE MAX and SIZE MIN SIZE FIXED MIN Packet Length i...

Page 42: ...iting box and allow user values to be entered Fixed fields are greyed out and cannot be changed Variable fields can be FIXED or INCREMENTING A fixed field uses the field setting only Incrementing fields operate at byte level not across the whole field The incr value defines the step and max defines the maximum value 6 5 3 Payload Configuration Option Setting MODE FIXED Fixed repeating DATA pattern...

Page 43: ...d length burst the transmit count is paused Pressing the START button will continue the transmit burst STOP Stop transmission on the selected ports CLEAR SELECTED COUNTERS Clear counters on the selected ports only CLEAR ALL COUNTERS To transmit a stream the port module and stream must be enabled and the BURST LENGTH must be non zero or continuous If all enabled streams configured on a port are in ...

Page 44: ...ected Calculated Values Mouse Click Toggle port selection Select Port for Stream Config Open Port Status Window Display Port Menu Port Counters Transmit Time Option Setting Port Selector Port selected for transmit control Port not selected for transmit control Click on the Port Label toggles the port selection Speed 10Gbps or 40Gbps Link Status Link is UP or DOWN If TRANSMIT ENABLE Section 6 8 1 1...

Page 45: ...ink Status Port Selector The contents of the Control Tab varies depending on the inserted module 6 8 1 1 Module Control Status The Module Control bits can be set by the user Option Function Transmit Enable Set to enable the transceiver If not set ie module disabled the Link Status in the counter panel Section 6 7 is followed by txd Rate Select 1 0 Rate Select bits are normally set for 10Gbps opera...

Page 46: ... linking device eg the 10GBase T modules contain a PHY the Module Link is the external link status to the link partner 6 8 1 2 Physical Configuration Port Topology and Connection Mode are configured in the Physical Configuration settings to the applicable port 6 8 1 3 Module Configuration optional The Control Tab will display additional module configuration options if they are available eg for the...

Page 47: ...values show the data captured in bytes available buffer space allocated in bytes alloc and upload progress yellow bar and The port capture buffers can be controlled with the buttons Control Function Clear the packet capture buffer and restart the capture Click the VIE w button to display the captured packets Upload the Packet Data window with the latest captured data Updating the Packet Data windo...

Page 48: ...d when the deep packet capture is enabled Deep Capture can only be enabled on one port in V2 1 Embedded Software Display Packet Width Enable Capture Enable Deep Capture Transmit Timestamp Packet ID Packet Data Packet Length Buffer Control Upload Status Port Selector Byte number Coarse Slider Fine Slider The buffer control is performed with the following buttons Control Function Update with the lat...

Page 49: ...Packet Generator USER GUIDE APG UG V2 1 49 8 February 2018 Xentech Solutions Ltd Suite 6 Stanta Business Centre 3 Soothouse Spring St Albans AL3 6PF United Kingdom Tel 44 0 1727 867795 Email support axtrinet com ...

Reviews: