Based on kernel version 6.8
. Page generated on 2024-03-11 21:26 EST
.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 | .. 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 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 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 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 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 |