Linux Driver for the AMD/Pensando DSC adapter family

AMD/Pensando DSC adapter 식별

AMD/Pensando(R) DSC adapter family용 Linux driver

Copyright(c) 2023 Advanced Micro Devices, Inc

Adapter 식별

Host에 AMD/Pensando PCI Core device가 하나 이상 설치되어 있는지 확인하려면 다음과 같이 PCI device를 조회합니다.

# lspci -d 1dd8:100c
b5:00.0 Processing accelerators: Pensando Systems Device 100c
b6:00.0 Processing accelerators: Pensando Systems Device 100c

위와 같은 device가 표시되면 `pds_core.ko` driver가 device를 찾아 사용할 수 있도록 설정해야 합니다. Kernel message에는 다음과 같은 log가 있어야 합니다.

$ dmesg | grep pds_core
pds_core 0000:b5:00.0: 252.048 Gb/s available PCIe bandwidth (16.0 GT/s PCIe x16 link)
pds_core 0000:b5:00.0: FW: 1.60.0-73
pds_core 0000:b6:00.0: 252.048 Gb/s available PCIe bandwidth (16.0 GT/s PCIe x16 link)
pds_core 0000:b6:00.0: FW: 1.60.0-73

Driver와 firmware version 정보는 devlink로 수집할 수 있습니다.

$ devlink dev info pci/0000:b5:00.0
pci/0000:b5:00.0:
  driver pds_core
  serial_number FLM18420073
  versions:
      fixed:
        asic.id 0x0
        asic.rev 0x0
      running:
        fw 1.51.0-73
      stored:
        fw.goldfw 1.15.9-C-22
        fw.mainfwa 1.60.0-73
        fw.mainfwb 1.60.0-57

.. SPDX-License-Identifier: GPL-2.0+

========================================================
Linux Driver for the AMD/Pensando(R) DSC adapter family
========================================================

Copyright(c) 2023 Advanced Micro Devices, Inc

Identifying the Adapter
=======================

To find if one or more AMD/Pensando PCI Core devices are installed on the
host, check for the PCI devices::

  # lspci -d 1dd8:100c
  b5:00.0 Processing accelerators: Pensando Systems Device 100c
  b6:00.0 Processing accelerators: Pensando Systems Device 100c

If such devices are listed as above, then the pds_core.ko driver should find
and configure them for use.  There should be log entries in the kernel
messages such as these::

  $ dmesg | grep pds_core
  pds_core 0000:b5:00.0: 252.048 Gb/s available PCIe bandwidth (16.0 GT/s PCIe x16 link)
  pds_core 0000:b5:00.0: FW: 1.60.0-73
  pds_core 0000:b6:00.0: 252.048 Gb/s available PCIe bandwidth (16.0 GT/s PCIe x16 link)
  pds_core 0000:b6:00.0: FW: 1.60.0-73

Driver and firmware version information can be gathered with devlink::

  $ devlink dev info pci/0000:b5:00.0
  pci/0000:b5:00.0:
    driver pds_core
    serial_number FLM18420073
    versions:
        fixed:
          asic.id 0x0
          asic.rev 0x0
        running:
          fw 1.51.0-73
        stored:
          fw.goldfw 1.15.9-C-22
          fw.mainfwa 1.60.0-73
          fw.mainfwb 1.60.0-57

Devlink info version field

Info version

`pds_core` driver는 다음 version 정보를 보고합니다.

• `fw` / running: device에서 현재 실행 중인 firmware version입니다.
• `fw.goldfw` / stored: `goldfw` slot에 저장된 firmware version입니다.
• `fw.mainfwa` / stored: `mainfwa` slot에 저장된 firmware version입니다.
• `fw.mainfwb` / stored: `mainfwb` slot에 저장된 firmware version입니다.
• `asic.id` / fixed: 이 device의 ASIC type입니다.
• `asic.rev` / fixed: 이 device의 ASIC revision입니다.

Info versions
=============

The ``pds_core`` driver reports the following versions

.. list-table:: devlink info versions implemented
   :widths: 5 5 90

   * - Name
     - Type
     - Description
   * - ``fw``
     - running
     - Version of firmware running on the device
   * - ``fw.goldfw``
     - stored
     - Version of firmware stored in the goldfw slot
   * - ``fw.mainfwa``
     - stored
     - Version of firmware stored in the mainfwa slot
   * - ``fw.mainfwb``
     - stored
     - Version of firmware stored in the mainfwb slot
   * - ``asic.id``
     - fixed
     - The ASIC type for this device
   * - ``asic.rev``
     - fixed
     - The revision of the ASIC for this device

Parameter와 firmware 관리

Parameter

`pds_core` driver는 `auxiliary_bus` device로 제공할 기능을 제어하기 위해 다음 generic parameter를 구현합니다.

`enable_vnet`은 runtime Boolean parameter입니다. Auxiliary bus device를 통해 vDPA 기능을 활성화합니다.

Firmware 관리

`flash` command로 DSC firmware를 update할 수 있습니다. Download한 firmware는 현재 사용하지 않는 firmware bank 1 또는 bank 2에 저장되며, 다음 boot에서 그 bank를 사용합니다.

# devlink dev flash pci/0000:b5:00.0 \
          file pensando/dsc_fw_1.63.0-22.tar

Parameters
==========

The ``pds_core`` driver implements the following generic
parameters for controlling the functionality to be made available
as auxiliary_bus devices.

.. list-table:: Generic parameters implemented
   :widths: 5 5 8 82

   * - Name
     - Mode
     - Type
     - Description
   * - ``enable_vnet``
     - runtime
     - Boolean
     - Enables vDPA functionality through an auxiliary_bus device

Firmware Management
===================

The ``flash`` command can update a the DSC firmware.  The downloaded firmware
will be saved into either of firmware bank 1 or bank 2, whichever is not
currently in use, and that bank will used for the next boot::

  # devlink dev flash pci/0000:b5:00.0 \
            file pensando/dsc_fw_1.63.0-22.tar

Devlink health reporter

Health reporter

Driver는 firmware 상태를 위한 devlink health reporter를 지원합니다.

# devlink health show pci/0000:2b:00.0 reporter fw
pci/0000:2b:00.0:
  reporter fw
    state healthy error 0 recover 0
# devlink health diagnose pci/0000:2b:00.0 reporter fw
 Status: healthy State: 1 Generation: 0 Recoveries: 0

`show`는 reporter의 health, error, recovery counter를 보여주며 `diagnose`는 status, state, generation, recovery 정보를 진단합니다.

Health Reporters
================

The driver supports a devlink health reporter for FW status::

  # devlink health show pci/0000:2b:00.0 reporter fw
  pci/0000:2b:00.0:
    reporter fw
      state healthy error 0 recover 0
  # devlink health diagnose pci/0000:2b:00.0 reporter fw
   Status: healthy State: 1 Generation: 0 Recoveries: 0

Driver 활성화와 지원

Driver 활성화

Driver는 표준 kernel configuration system을 통해 활성화합니다. 다음과 같은 make command를 사용합니다.

make oldconfig/menuconfig/etc.

Driver의 menu 위치는 다음과 같습니다.

-> Device Drivers
  -> Network device support (NETDEVICES [=y])
    -> Ethernet driver support
      -> AMD devices
        -> AMD/Pensando Ethernet PDS_CORE Support

지원

일반 Linux networking 지원은 AMD/Pensando 담당자가 확인하는 netdev mailing list를 이용하십시오.

netdev@vger.kernel.org

Enabling the driver
===================

The driver is enabled via the standard kernel configuration system,
using the make command::

  make oldconfig/menuconfig/etc.

The driver is located in the menu structure at:

  -> Device Drivers
    -> Network device support (NETDEVICES [=y])
      -> Ethernet driver support
        -> AMD devices
          -> AMD/Pensando Ethernet PDS_CORE Support

Support
=======

For general Linux networking support, please use the netdev mailing
list, which is monitored by AMD/Pensando personnel::

  netdev@vger.kernel.org