Axtrinet APG4 User Manual
  1. Manuals
  2. Brands
  3. Axtrinet Manuals
  4. Portable Generator
  5. APG4
  6. User manual

Axtrinet APG4 User Manual

Ethernet packet generator
Hide thumbs Also See for APG4:
Table of Contents

Advertisement

Quick Links

Download this manual See also: Manual
Ethernet Packet Generator
USER GUIDE
Ethernet Packet Generator
USER GUIDE
Version 2.1
APG4 APG8 APG200 APG208
APG-UG-V2-1
1
8 February 2018

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the APG4 and is the answer not in the manual?

Questions and answers

Related Manuals for Axtrinet APG4

Summary of Contents for Axtrinet APG4

  • Page 1 Ethernet Packet Generator USER GUIDE Ethernet Packet Generator USER GUIDE Version 2.1 APG4 APG8 APG200 APG208 APG-UG-V2-1 8 February 2018...
  • Page 2 Ethernet Packet Generator USER GUIDE Software Revisions This document applies to the following software revisions: APG Unit Firmware Version 2.1 APG Processing Core Version 6.010E APG Control Interface Version 2.1 Revision History Date Version Changes 4 July 2016 Restricted Customer Release ...
  • Page 3 Axtrinet does not warrant that the software will in every case process all data correctly, or that operation of the products, including software, will be uninterrupted, free from error, or secure.
  • Page 4 Ethernet Packet Generator USER GUIDE Preface About This Document This document describes the Axtrinet Packet Generator hardware, the installation procedure, and the User Manual for the APG Control Interface. It contains the following sections: Section Description 1. INTRODUCTION Key features and benefits of the Axtrinet Ethernet Packet Generators 2.

  • Page 5: Table Of Contents

    Ethernet Packet Generator USER GUIDE Contents INTRODUCTION ....................6 Main Features ....................... 6 Benefits ........................ 6 Safety Information ....................7 Care of the Product ....................7 Environmental ....................... 8 Conformance ......................8 Limited Hardware Warranty ..................9 Software Licences and Support ................9 Contact Details .....................

  • Page 6: Introduction

    TCL API for third party scripting. Ideally suited to applications in R&D, Test and Manufacturing environments, and 'on the road' with Field Sales and Application Engineers, the Axtrinet APG Ethernet Packet Generators allow reliable and affordable development and testing of: ...

  • Page 7: Safety Information

    RODUCT The Axtrinet Packet Generator contains no user-serviceable parts. Repair and servicing require specialised test equipment and must only be performed by Axtrinet. There may be a charge for these services unless covered by the Axtrinet one year warranty. Use a soft damp cloth to clean the Axtrinet Packet Generator.

  • Page 8: Environmental

    NVIRONMENTAL Disposal of Waste Electrical & Electronic Equipment When an Axtrinet Packet Generator reaches the end of its useful life, Axtrinet will arrange the responsible recycling of returned products. Where the customer wishes to return the unit to Axtrinet, the customer will be responsible for shipping the unit back to our facility.

  • Page 9: Limited Hardware Warranty

    Axtrinet shall not be liable for a breach of the warranty if the defect has been caused by wilful damage, negligence, abnormal working conditions or failure to follow Axtrinet's written advice on the storage, installation, commissioning, use or maintenance of the product;...

  • Page 10: Contact Details

    Ethernet Packet Generator USER GUIDE ONTACT ETAILS 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 Phone: +44 (0)1727 867795 Email: Technical Support: support@axtrinet.com Sales: sales@axtrinet.com...

  • Page 11: Installation

     1m 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.

  • Page 12: Linux Installation

    Ethernet Packet Generator USER GUIDE INUX NSTALLATION The Axtrinet APG Linux package contains the GUI application and the system configuration file. The GUI requires X-Windows to be running. There are 4 installation formats provided for convenience:  Simple tar ...

  • Page 13: Windows Installation

    3. Run the installation file and follow the on-screen instructions to install the USB driver, APG Control Interface GUI and the APG TCL API. DO NOT CONNECT THE AXTRINET PACKET GENERATOR TO THE WINDOWS PC UNTIL THE INSTALLATION IS COMPLETE.

  • Page 14: Connecting The Hardware

     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).

  • Page 15: Testing The Installation

    NSTALLATION  Start the APG Control Interface:  On Linux, click the home / Axtrinet Control icon or execute user/bin/apg_control  On the Windows Start menu, locate the Axtrinet directory and click on the APG Control icon.  The APG Control Interface management window will be displayed and the new unit will...

  • Page 16: Setting The Ip Address

    Ethernet Packet Generator USER GUIDE IP A ETTING THE DDRESS The default settings are: IP Address 192.168.1.100 Mask 255.255.255.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: ...

  • Page 17: Hardware Interfaces

    3. H ARDWARE NTERFACES The packet generator ports (SFP+ & QSFP+) are on the front of the unit, and the management and power interfaces are on the rear. RONT ANEL NTERFACES APG4 APG8 APG200 APG208 Status 10Gbps 10Gbps 40Gbps LEDs...

  • Page 18: Led Indicators

    The SFP+ interfaces will support 10Gbps SFPs that meet SFF-8431 MSA. Only 10Gbps transceivers are supported in V2.1 Embedded Software The list of verified SFPs is available on the Axtrinet website: www.axtrinet.com/transceivers.html The SFP+ interfaces will also support certain 10GBase-T transceivers that exceed the SFF-8431 power budget of 1W, but only in the upper ports (1,3,5,7) due to thermal limitations.
  • Page 19 RED/AMBER Failed to configure the hardware Power cycle the unit. If the problem persists, contact AXTRINET for Technical Support. 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.

  • Page 20: Rear Panel Interfaces

    Ethernet Packet Generator USER GUIDE ANEL NTERFACES USB and 10/100Base-T Ethernet interfaces provide management access to the device. 10/100Base-T Sync Power Ethernet 12Vdc @ 5A Management Interfaces 3.2.1 USB Interface The USB 2.0 Type B interface can be used to provide a connection to the PC running the Control Interface Application Software.

  • Page 21: Physical Specifications

    Ethernet Packet Generator USER GUIDE d) Multiple APG units connected through WAN After installing the Control Interface Application Software, the Network Interface must be configured using the USB Interface to set the IPV4 Address, Mask and Gateway (Section 6.3.6). Up to two Ethernet connections are supported by the Ethernet Interface, eg two Control Interface sessions or one Control Interface session and one TCL session.

  • Page 22: Management Interfaces

    The Axtrinet APG Control Interface is described in Section 6. TCL S CRIPTING 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 ...

  • Page 23: Test Environment & Concepts

    NVIRONMENT ONCEPTS The Test Environment consists of one or more Axtrinet Packet Generators. A single unit may be connected over a direct USB connection, or multiple units may be connected over USB or Ethernet. The units may be located in the same location, or in geographically separate locations connected by a WAN.

  • Page 24: Unit Configuration

    Ethernet Packet Generator USER GUIDE ONFIGURATION The unit, port and stream configuration is stored on the unit. The APG Control Interface provides a graphical interface to view and modify the configuration stored on the unit, to view the counters and the captured data. The current configuration can be saved locally to a named file and then loaded onto a unit later.

  • Page 25: Transmit Path

    Ethernet Packet Generator USER GUIDE RANSMIT Each port contains a transmit engine that comprises:  8 parallel independent configurable Ethernet stream generators  Stream multiplexer  Transmit port configuration and status  Module configuration and status Per Stream: STREAM 0 Enable Rate STREAM 1...
  • Page 26 Ethernet Packet Generator USER GUIDE The stream transmit mode defines how the packets are generated: either Continuously; as a Single Burst of BURST LENGTH packets; or a Multiple Burst of BURST LENGTH packets, repeated BURST COUNT times, separated by BURST GAP (Section 6.5.1).

  • Page 27: Receive Path

    Ethernet Packet Generator USER GUIDE The Sequence Number is set to zero when the unit powers up, and increments continuously for each packet transmitted with the Timestamp field enabled. The Sequence Number will wrap after 2 (4,294,967,296) packets. Wire-rate 64 byte packets at 40Gbps will take 1 min 12 secs. It is not possible to reset the Sequence Number in APG Control Interface Version 2.1.
  • Page 28 Ethernet Packet Generator USER GUIDE The local buffer sizes increased from 16KB and 64KB in the Version 2.1 An extended 1GB capture buffer is available to the 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.

  • Page 29: Control Interface

    NTERFACE 6.1.1 Linux Click on the home / Axtrinet Control icon or execute usr/bin/apg_control 6.1.2 Windows Click on the APG Control icon in the Start Menu \ Axtrinet directory. VERVIEW The APG Control Interface comprises 5 areas: Menu Bar APG Control Interface configuration and settings.

  • Page 30: Menu Bar

    Ethernet Packet Generator USER GUIDE File Edit Tools About Save Settings Upgrade Unit Save As Network Configuration Load Counter Configuration Exit 6.3.1 File – Save Saves the default Control Interface configuration:  IP Addresses of known units  Connection status ...
  • Page 31 Ethernet Packet Generator USER GUIDE Button Action Opens the "File Load" window to select the load file name and location. Alternatively the path and filename can be entered manually. The path and filename default to the last used settings. Disable/Enable Configuration change Applies the saved configuration to the selected options Refreshes the list of connected units Closes the Load Configuration window without applying the changes.
  • Page 32 Ethernet Packet Generator USER GUIDE 6.3.5 Edit – Settings The APG Control Interface can be configured using the Settings option: Formatting Polling Option Description Align Align counter values LEFT or RIGHT Comma Separators Add 'thousand' separators to the counter values Polling Automatically poll the connected units every 'interval' The polling interval is adjustable between 0.5 –...
  • Page 33 Ethernet Packet Generator USER GUIDE Button Action Applies the Network Configuration changes to the unit. Changing the Network Configuration while connected to the unit over a network connection will immediately disconnect the unit from the APG Control Interface. Open a new connection with the new address to continue to manage the unit.
  • Page 34 Ethernet Packet Generator USER GUIDE The following status indicators are available: Status Description Speed 10Gbps or 40Gbps Link UP or DOWN TxTime Time in seconds since the START button was pressed The following transmit counters are available: Transmit Description TxBytes Transmit Bytes TxPackets Transmit Packets...
  • Page 35 Ethernet Packet Generator USER GUIDE The following error counters are available: Errors Description Frame Checksum Errors Received Undersize Short packets (<64 bytes) with a valid SFD and FCS Fragments Packets without a valid SFD NoSFD Received Packet without a valid SFD The following calculated values are available: Calculated Description...
  • Page 36 Ethernet Packet Generator USER GUIDE To continue the firmware download, click 'yes' when the confirmation window appears: If an invalid file is selected, the following message is displayed: The progress window appears while the image is downloaded to the unit: Image download takes 2-3 minutes.

  • Page 37: Connection Panel

    Ethernet Packet Generator USER GUIDE ONNECTION ANEL Connection to APG units using USB or Ethernet management interfaces is achieved through the Connection Panel. Units using the USB interface will always be visible in the Connection Panel. Unit Serial Number USB Connection Connect Checkbox ‘Managed’...
  • Page 38 If the Unit API is incompatible with the 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: ...
  • Page 39 Ethernet Packet Generator USER GUIDE 6.4.1 Status Window Serial Number Unit Status Summary Up Time Firmware Versions The System Status summary displays the following information: Option Function Serial Number Serial number of the unit Unit Status TEMP: Temperature OK Temperature Warning – fan speed will increase Over-Temperature –...

  • Page 40: Stream Configuration Panel

    Ethernet Packet Generator USER GUIDE TREAM ONFIGURATION ANEL Stream Configuration is defined in the Stream Configuration Panel. Each port contains 8 parallel independent configurable Ethernet stream generators. Each stream generates a controlled number of Ethernet frames at a controlled length and rate; with a fixed header configuration, fixed or varying header contents, and a fixed or varying payload.
  • Page 41 Ethernet Packet Generator USER GUIDE Option Setting RATE TXGAP Inter-Packet Gap At 10Gbps, RATE VAL defines the number of bytes added to the 12-byte minimum IPG. At 40Gbps, RATE VAL defined the number of 8-byte words added to the 12-byte minimum IPG. PACKET/SECOND Packets transmitted per second %RATE...
  • Page 42 Ethernet Packet Generator USER GUIDE 6.5.2 Header Configuration The packet headers and contents are configured in the Header Configuration Panel. Field Header Type Editable Field Name Expand Header Delete Header Variable Field Fixed Field Insert new header The available headers are extracted from an external configuration file when the APG Control Interface starts.

  • Page 43: Control Panel

    Ethernet Packet Generator USER GUIDE 6.5.4 Apply/Refresh Option Action Applies the configuration to the unit. The button is highlighted orange when a configuration change has been made but not applied. Refresh cancels the configuration changes and reloads the configuration from the unit.

  • Page 44: Counter Panel

    Ethernet Packet Generator USER GUIDE OUNTER ANEL The Counter Panel provides access to:  Port control group selection  Port selection for Stream Configuration and Status Window  Hide Port display  Link Speed and Status display  Port transmit and receive counters and rates The Counter Panel is configured using the Edit - Counter Configuration menu (Section 6.3.7), or by right-clicking in the Counter Panel, then selecting 'Counter Configuration'.

  • Page 45: Port Status Window

    Ethernet Packet Generator USER GUIDE TATUS INDOW The Port Status window can be accessed in two ways:  Right-click in the counter pane to open the Port Menu, then select "Port Control", or  Middle-click in the counter pane The Port Status window provides access to: ...
  • Page 46 Ethernet Packet Generator USER GUIDE The Link Status bits are set by the transceiver: Status Definition Local Link Displays the link status of the Packet Generator MAC to the link partner. For fibre optic and direct attach cables, this is the end-to-end link status. Where the module contains an additional active linking device, eg the 10GBase-T modules contain a PHY, the 'Local Link' is the MAC-to-PHY link status.
  • Page 47 Ethernet Packet Generator USER GUIDE 6.8.3 Capture Tab The capture tab displays a summary of the capture buffer configuration, status and control for all available ports. Capture Capture Control Configuration Status The capture configuration shows the ENABLE and DEEP setting for each port. Although Deep Capture can be selected on more than one port, it can only be enabled on one port in V2.1 Embedded Software.

  • Page 48: Capture Data Display

    Ethernet Packet Generator USER GUIDE APTURE ISPLAY The Capture Data Display window is accessed either through the Port Status Capture Tab, or by right-clicking in the counter panel to open the Port Menu, then selecting 'Capture Buffer'. Packet Capture can be enabled per port by selecting the ENABLE checkbox. When enabled, the buffer captures continuously until full.
  • Page 49 Ethernet Packet Generator USER GUIDE 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 APG-UG-V2-1 8 February 2018...

This manual is also suitable for:

Apg208Apg200Apg8

Table of Contents