hssi

SYNOPSIS

hssi COMMON_OPTIONS MODE MODE_OPTIONS

DESCRIPTION

The hssi application provides a means of interacting with the 10G, 100G, and 200G/400F HE-HSSI AFUs. In all operating modes, the application initializes the AFU and completes the desired transfer as described by the mode- specific options.

COMMON_OPTIONS - application options common to the 10G, 100g, and 200G/400G 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, hssi_100g, hssi_200g_400g.

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.

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

--start-size SIZE

Specify the packet size in bytes, or the first packet size for --pattern increment.

--end-size SIZE

Specify the end packet size in bytes.

--end-select pkt_num|gen_idle

Specify packet generation end mode.

MODE_OPTIONS [pkt_filt_10g] - application options specific to the Packet Filter 10G AFU.

--dfl-dev DFL_DEV

Packet Filter DFL device, eg --dfl-dev dfl_dev.0

MODE_OPTIONS [pkt_filt_100g] - application options specific to the Packet Filter 100G AFU.

--dfl-dev DFL_DEV

Packet Filter DFL device, eg --dfl-dev dfl_dev.1

MODE_OPTIONS [hssi_200g_400g] - application options specific to the 200G/400G AFU.

--num-packets PACKETS

The number of packets to transfer. Must be a multiple of 32. Default value is 32. Increasing the timeout (--timeout) may be necessary if specifying a large number of packets.

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
sudo hssi --pci-address=0000:0d:00.6 hssi_200g_400g --num-packets=640000