51. OCTEON TX EP Poll Mode driver

The OCTEON TX EP ETHDEV PMD (librte_pmd_octeon_ep) provides poll mode ethdev driver support for the virtual functions (VF) of Marvell OCTEON 9, OCTEON 10, CN20K and legacy Cavium OCTEON adapters in SR-IOV context when the SoC operates as a PCIe endpoint (SDP).

More information can be found at Marvell Official Website.

51.1. Supported OCTEON SDP endpoint SoCs

  • OCTEON TX (CN8XX)

  • CN9XX

  • CN10XX

  • CN20XX

51.2. Supported SDP VF PCI devices

SoC family

PCI device ID

Description

OCTEON TX

0xA303

SDP VF

CN9XX

0xB103

CN98XX SDP VF

CN9XX

0xB203

CN9K SDP VF

CN9XX

0xB403

CNF95N SDP VF

CN9XX

0xB603

CNF95O SDP VF

CN10XX

0xB903

CN10KA SDP VF

CN10XX

0xBA03

CNF10KA SDP VF

CN10XX

0xBC03

CNF10KB SDP VF

CN10XX

0xBD03

CN10KB SDP VF

CN20XX

0xC203

CN20KA SDP VF

CN20XX

0xCA03

CNF20KA SDP VF

On CN20K SDP VFs, IO queue rings are allocated through a mailbox to the SDP physical function. Link status and device control also use this mailbox.

51.3. Runtime Config Options

The following devargs parameters can be passed when binding the device. For example:

-a 0002:02:00.0,ism_enable=1

ism_enable

Enable ISM memory for Rx and Tx packet-count polling on CN9K, CN10K and CN20K SDP VFs (default 0).

When disabled, the PMD reads packet counts from hardware registers. When enabled, the PMD reads packet counts from ISM memory. Register polling tends to perform better for larger packets; ISM polling can perform better for smaller packets.

51.3.1. CN20K runtime config options

The following devargs parameter applies to CN20K SDP VFs. For example:

-a 0002:02:00.0,max_rings=4

max_rings

Number of Tx/Rx queue pairs to use (default 8). The value must be in the range 1 to 8.

51.4. Prerequisites

This driver relies on an external kernel PF driver for resource allocation and initialization. The following dependencies are not part of DPDK and must be installed separately:

  • Kernel module The octeon_drv module drives the physical function, initializes hardware, allocates resources such as the number of VFs, input/output queues for the PF, and the number of I/O queues each VF can use.

See Marvell cnxk platform guide for SDP interface information which provides PCIe endpoint support for a remote host.