From 16508bfd0816a944c459c8c7c8300c7aabea54a0 Mon Sep 17 00:00:00 2001 From: Gregory Etelson Date: Tue, 16 Nov 2021 17:45:14 +0200 Subject: [PATCH] doc: add flex item specifications in mlx5 guide Describe firmware configuration requirements. List mlx5 hardware and PMD limitations. Signed-off-by: Gregory Etelson Acked-by: Viacheslav Ovsiienko --- doc/guides/nics/mlx5.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index 552e06c0db..feb2e57cee 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -248,6 +248,20 @@ Limitations extension header type = 0x85). - Match on GTP extension header is not supported in group 0. +- Flex item: + + - Hardware support: BlueField 2. + - Flex item is supported on PF only. + - Hardware limits ``header_length_mask_width`` up to 6 bits. + - Firmware supports 8 global sample fields. + Each flex item allocates non-shared sample fields from that pool. + - Supported flex item can have 1 input link - ``eth`` or ``udp`` + and up to 2 output links - ``ipv4`` or ``ipv6``. + - Flex item fields (``next_header``, ``next_protocol``, ``samples``) + do not participate in RSS hash functions. + - In flex item configuration, ``next_header.field_base`` value + must be byte aligned (multiple of 8). + - No Tx metadata go to the E-Switch steering domain for the Flow group 0. The flows within group 0 and set metadata action are rejected by hardware. @@ -1256,6 +1270,11 @@ Below are some firmware configurations listed. FLEX_PARSER_PROFILE_ENABLE=4 PROG_PARSE_GRAPH=1 +- enable dynamic flex parser for flex item:: + + FLEX_PARSER_PROFILE_ENABLE=4 + PROG_PARSE_GRAPH=1 + - enable realtime timestamp format:: REAL_TIME_CLOCK_ENABLE=1 -- 2.39.5