hssi¶

SYNOPSIS¶

hssi COMMON_OPTIONS MODE MODE_OPTIONS

DESCRIPTION¶

The hssi application provides a means of interacting with the 10G and with the 100G HSSI AFUs. In both 10G and 100G operating modes, the application initializes the AFU, completes the desired transfer as described by the mode- specific options, and displays the ethernet statistics by invoking ethtool --statistics INTERFACE.

COMMON_OPTIONS - application options common to both 10G and 100G modes.

-h, --help

Display common command-line help and exit.

-p, --pci-address ADDR

The PCIe address of the desired accelerator in ssss:bb:dd.f format.

-s, --shared on|off

Whether to open the accelerator in shared mode. The default is off.

-t, --timeout VALUE

The application timeout value in milliseconds. The default timeout is 60000 msec.

MODE - select AFU. Valid values are hssi_10g and hssi_100g.

MODE_OPTIONS [hssi_10g] - application options specific to the 10G AFU.

-h, --help

Display 10G AFU specific command-line help and exit.

--port PORT

Select the QSFP port in the range 0-7. The default is port 0.

--eth-loopback on|off

Whether to enable loopback on the ethernet interface. Valid values are
on and off. The default is on.

--num-packets PACKETS

The number of packets to transfer. The default is 1 packet.

--random-length fixed|random

Specify packet length randomization. Valid values are fixed and
random. The default is fixed (no randomization).

--random-payload incremental|random

Specify payload randomization. Valid values are incremental and
random. The default is incremental.

--packet-length LENGTH

Specify packet length. The default is 64 bytes.

--src-addr ADDR

Specify the source MAC address. The default value is 11:22:33:44:55:66.

--dest-addr ADDR

Specify the destination MAC address. The default value is 77:88:99:aa:bb:cc.

--rnd-seed0 SEED0

Specify the prbs generator bits [31:0]. The default is 1592590336.

--rnd-seed1 SEED1

Specify the prbs generator bits [47:32]. The default is 1592590337.

--rnd-seed2 SEED2

Specify the prbs generator bits [91:64]. The default is 155373.

MODE_OPTIONS [hssi_100g] - application options specific to the 100G AFU.

--port PORT

Select the QSFP port in the range 0-7. The default is port 0.

--eth-loopback on|off

Whether to enable loopback on the ethernet interface. Valid values are
on and off. The default is on.

--num-packets PACKETS

The number of packets to transfer. The default is 1 packet.

--gap random|none

Inter-packet gap. Valid values are random and none. The default is none.

--pattern random|fixed|increment

Pattern mode. Valid values are random, fixed, or increment. The default
is random.

--src-addr ADDR

Specify the source MAC address. The default value is 11:22:33:44:55:66.

--dest-addr ADDR

Specify the destination MAC address. The default value is 77:88:99:aa:bb:cc.

EXAMPLES¶

hssi -h
hssi hssi_10g -h
sudo hssi --pci-address=0000:3b:00.0 hssi_10g --eth-loopback=on --num-packets=500
sudo hssi --pci-address=0000:3b:00.0 hssi_100g --pattern=increment

Revision History¶