1 .. SPDX-License-Identifier: GPL-2.0+
3 ========================================================
4 Linux Driver for the AMD/Pensando(R) DSC adapter family
5 ========================================================
7 Copyright(c) 2023 Advanced Micro Devices, Inc
9 Identifying the Adapter
10 =======================
12 To find if one or more AMD/Pensando PCI Core devices are installed on the
13 host, check for the PCI devices::
16 b5:00.0 Processing accelerators: Pensando Systems Device 100c
17 b6:00.0 Processing accelerators: Pensando Systems Device 100c
19 If such devices are listed as above, then the pds_core.ko driver should find
20 and configure them for use. There should be log entries in the kernel
21 messages such as these::
23 $ dmesg | grep pds_core
24 pds_core 0000:b5:00.0: 252.048 Gb/s available PCIe bandwidth (16.0 GT/s PCIe x16 link)
25 pds_core 0000:b5:00.0: FW: 1.60.0-73
26 pds_core 0000:b6:00.0: 252.048 Gb/s available PCIe bandwidth (16.0 GT/s PCIe x16 link)
27 pds_core 0000:b6:00.0: FW: 1.60.0-73
29 Driver and firmware version information can be gathered with devlink::
31 $ devlink dev info pci/0000:b5:00.0
34 serial_number FLM18420073
49 The ``pds_core`` driver reports the following versions
51 .. list-table:: devlink info versions implemented
59 - Version of firmware running on the device
62 - Version of firmware stored in the goldfw slot
65 - Version of firmware stored in the mainfwa slot
68 - Version of firmware stored in the mainfwb slot
71 - The ASIC type for this device
74 - The revision of the ASIC for this device
79 The ``pds_core`` driver implements the following generic
80 parameters for controlling the functionality to be made available
81 as auxiliary_bus devices.
83 .. list-table:: Generic parameters implemented
93 - Enables vDPA functionality through an auxiliary_bus device
98 The ``flash`` command can update a the DSC firmware. The downloaded firmware
99 will be saved into either of firmware bank 1 or bank 2, whichever is not
100 currently in use, and that bank will used for the next boot::
102 # devlink dev flash pci/0000:b5:00.0 \
103 file pensando/dsc_fw_1.63.0-22.tar
108 The driver supports a devlink health reporter for FW status::
110 # devlink health show pci/0000:2b:00.0 reporter fw
113 state healthy error 0 recover 0
114 # devlink health diagnose pci/0000:2b:00.0 reporter fw
115 Status: healthy State: 1 Generation: 0 Recoveries: 0
120 The driver is enabled via the standard kernel configuration system,
121 using the make command::
123 make oldconfig/menuconfig/etc.
125 The driver is located in the menu structure at:
128 -> Network device support (NETDEVICES [=y])
129 -> Ethernet driver support
131 -> AMD/Pensando Ethernet PDS_CORE Support
136 For general Linux networking support, please use the netdev mailing
137 list, which is monitored by AMD/Pensando personnel::
139 netdev@vger.kernel.org