doc/guides/bbdevs/la12xx.rst

   1 ..  SPDX-License-Identifier: BSD-3-Clause
   2     Copyright 2021 NXP
   3
   4 NXP LA12xx Poll Mode Driver
   5 ===========================
   6
   7 The BBDEV LA12xx poll mode driver (PMD) supports an implementation for
   8 offloading High Phy processing functions like LDPC Encode / Decode 5GNR wireless
   9 acceleration function, using PCI based LA12xx Software defined radio.
  10
  11 More information can be found at `NXP Official Website
  12 <https://www.nxp.com/products/processors-and-microcontrollers/arm-processors/layerscape-processors/layerscape-access-la1200-programmable-baseband-processor:LA1200>`_.
  13
  14 Features
  15 --------
  16
  17 LA12xx PMD supports the following features:
  18
  19 - Maximum of 8 LDPC decode (UL) queues
  20 - Maximum of 8 LDPC encode (DL) queues
  21 - PCIe Gen-3 x8 Interface
  22
  23 Installation
  24 ------------
  25
  26 Section 3 of the DPDK manual provides instructions on installing and compiling DPDK.
  27
  28 DPDK requires hugepages to be configured as detailed in section 2 of the DPDK manual.
  29
  30 Initialization
  31 --------------
  32
  33 The device can be listed on the host console with:
  34
  35
  36 Use the following lspci command to get the multiple LA12xx processor ids. The
  37 device ID of the LA12xx baseband processor is "1c30".
  38
  39 .. code-block:: console
  40
  41   sudo lspci -nn
  42
  43 ...
  44 0001:01:00.0 Power PC [0b20]: Freescale Semiconductor Inc Device [1957:1c30] (
  45 rev 10)
  46 ...
  47 0002:01:00.0 Power PC [0b20]: Freescale Semiconductor Inc Device [1957:1c30] (
  48 rev 10)
  49
  50
  51 Prerequisites
  52 -------------
  53
  54 Currently supported by DPDK:
  55
  56 - NXP LA1224 BSP **1.0+**.
  57 - NXP LA1224 PCIe Modem card connected to ARM host.
  58
  59 - Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup the basic DPDK environment.
  60
  61 Enabling logs
  62 -------------
  63
  64 For enabling logs, use the following EAL parameter:
  65
  66 .. code-block:: console
  67
  68    ./your_bbdev_application <EAL args> --log-level=la12xx:<level>
  69
  70 Using ``bb.la12xx`` as log matching criteria, all Baseband PMD logs can be
  71 enabled which are lower than logging ``level``.