Debian Codegraph @

Documentation/networking/device_drivers/ethernet/amd/pds_core.rst

raw
1 .. SPDX-License-Identifier: GPL-2.0+
2
3 ========================================================
4 Linux Driver for the AMD/Pensando(R) DSC adapter family
5 ========================================================
6
7 Copyright(c) 2023 Advanced Micro Devices, Inc
8
9 Identifying the Adapter
10 =======================
11
12 To find if one or more AMD/Pensando PCI Core devices are installed on the
13 host, check for the PCI devices::
14
15 # lspci -d 1dd8:100c
16 b5:00.0 Processing accelerators: Pensando Systems Device 100c
17 b6:00.0 Processing accelerators: Pensando Systems Device 100c
18
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::
22
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
28
29 Driver and firmware version information can be gathered with devlink::
30
31 $ devlink dev info pci/0000:b5:00.0
32 pci/0000:b5:00.0:
33 driver pds_core
34 serial_number FLM18420073
35 versions:
36 fixed:
37 asic.id 0x0
38 asic.rev 0x0
39 running:
40 fw 1.51.0-73
41 stored:
42 fw.goldfw 1.15.9-C-22
43 fw.mainfwa 1.60.0-73
44 fw.mainfwb 1.60.0-57
45
46 Info versions
47 =============
48
49 The ``pds_core`` driver reports the following versions
50
51 .. list-table:: devlink info versions implemented
52 :widths: 5 5 90
53
54 * - Name
55 - Type
56 - Description
57 * - ``fw``
58 - running
59 - Version of firmware running on the device
60 * - ``fw.goldfw``
61 - stored
62 - Version of firmware stored in the goldfw slot
63 * - ``fw.mainfwa``
64 - stored
65 - Version of firmware stored in the mainfwa slot
66 * - ``fw.mainfwb``
67 - stored
68 - Version of firmware stored in the mainfwb slot
69 * - ``asic.id``
70 - fixed
71 - The ASIC type for this device
72 * - ``asic.rev``
73 - fixed
74 - The revision of the ASIC for this device
75
76 Parameters
77 ==========
78
79 The ``pds_core`` driver implements the following generic
80 parameters for controlling the functionality to be made available
81 as auxiliary_bus devices.
82
83 .. list-table:: Generic parameters implemented
84 :widths: 5 5 8 82
85
86 * - Name
87 - Mode
88 - Type
89 - Description
90 * - ``enable_vnet``
91 - runtime
92 - Boolean
93 - Enables vDPA functionality through an auxiliary_bus device
94
95 Firmware Management
96 ===================
97
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::
101
102 # devlink dev flash pci/0000:b5:00.0 \
103 file pensando/dsc_fw_1.63.0-22.tar
104
105 Health Reporters
106 ================
107
108 The driver supports a devlink health reporter for FW status::
109
110 # devlink health show pci/0000:2b:00.0 reporter fw
111 pci/0000:2b:00.0:
112 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
116
117 Enabling the driver
118 ===================
119
120 The driver is enabled via the standard kernel configuration system,
121 using the make command::
122
123 make oldconfig/menuconfig/etc.
124
125 The driver is located in the menu structure at:
126
127 -> Device Drivers
128 -> Network device support (NETDEVICES [=y])
129 -> Ethernet driver support
130 -> AMD devices
131 -> AMD/Pensando Ethernet PDS_CORE Support
132
133 Support
134 =======
135
136 For general Linux networking support, please use the netdev mailing
137 list, which is monitored by AMD/Pensando personnel::
138
139 [email protected]