12508da22SEric JoynerOS Default Dynamic Device Personalization (DDP) Package 2*a9d78bb7SEric Joyner******************************************************* 3*a9d78bb7SEric Joyner 4*a9d78bb7SEric JoynerAugust 09, 2024 571d10453SEric Joyner 671d10453SEric Joyner 771d10453SEric JoynerContents 8*a9d78bb7SEric Joyner^^^^^^^^ 9*a9d78bb7SEric Joyner 10*a9d78bb7SEric Joyner* OS Default Dynamic Device Personalization (DDP) Package 11*a9d78bb7SEric Joyner 12*a9d78bb7SEric Joyner * Overview 13*a9d78bb7SEric Joyner 14*a9d78bb7SEric Joyner * Supported Operating Systems 15*a9d78bb7SEric Joyner 16*a9d78bb7SEric Joyner * Contents of This Package 17*a9d78bb7SEric Joyner 18*a9d78bb7SEric Joyner * Related Documentation 19*a9d78bb7SEric Joyner 20*a9d78bb7SEric Joyner * Notes 21*a9d78bb7SEric Joyner 22*a9d78bb7SEric Joyner * Installation 23*a9d78bb7SEric Joyner 24*a9d78bb7SEric Joyner * Troubleshooting 25*a9d78bb7SEric Joyner 26*a9d78bb7SEric Joyner * Legal / Disclaimers 2771d10453SEric Joyner 2871d10453SEric Joyner 2971d10453SEric JoynerOverview 3071d10453SEric Joyner======== 3171d10453SEric Joyner 32*a9d78bb7SEric JoynerDevices based on the Intel(R) Ethernet 800 Series require a Dynamic 33*a9d78bb7SEric JoynerDevice Personalization (DDP) package file to enable advanced features 34*a9d78bb7SEric Joyner(such as dynamic tunneling, Intel(R) Ethernet Flow Director, RSS, and 35*a9d78bb7SEric JoynerADQ). 3671d10453SEric Joyner 37*a9d78bb7SEric JoynerDDP allows you to change the packet processing pipeline of a device by 38*a9d78bb7SEric Joynerapplying a profile package to the device at runtime. Profiles can be 39*a9d78bb7SEric Joynerused to, for example, add support for new protocols, change existing 40*a9d78bb7SEric Joynerprotocols, or change default settings. DDP profiles can also be rolled 41*a9d78bb7SEric Joynerback without rebooting the system. 4271d10453SEric Joyner 43*a9d78bb7SEric JoynerThe DDP package loads during device initialization or driver runtime, 44*a9d78bb7SEric Joynerdepending on the operating system. The driver checks to see if the DDP 45*a9d78bb7SEric Joynerpackage is present and compatible. If this file exists, the driver 46*a9d78bb7SEric Joynerwill load it into the device. If the DDP package file is missing or 47*a9d78bb7SEric Joynerincompatible with the driver, the driver will go into Safe Mode where 48*a9d78bb7SEric Joynerit will use the configuration contained in the device's NVM. 49*a9d78bb7SEric Joyner 50*a9d78bb7SEric JoynerSafe Mode disables advanced and performance features, and supports 51*a9d78bb7SEric Joyneronly basic traffic and minimal functionality, such as updating the NVM 52*a9d78bb7SEric Joyneror downloading a new driver or DDP package. 53*a9d78bb7SEric Joyner 54*a9d78bb7SEric JoynerRefer to the Intel(R) Ethernet Adapters and Devices User Guide for 55*a9d78bb7SEric Joynermore details on DDP and Safe Mode. 56*a9d78bb7SEric Joyner 57*a9d78bb7SEric JoynerA general-purpose, default DDP package is automatically installed with 58*a9d78bb7SEric Joynerall supported Intel Ethernet 800 Series drivers on supported operating 59*a9d78bb7SEric Joynersystems. Additional DDP packages are available to address needs for 60*a9d78bb7SEric Joynerspecific market segments or targeted solutions. 6171d10453SEric Joyner 62e438f0a9SEric JoynerThe default DDP package supports the following: 63*a9d78bb7SEric Joyner 64*a9d78bb7SEric Joyner* MAC 65*a9d78bb7SEric Joyner 66*a9d78bb7SEric Joyner* EtherType 67*a9d78bb7SEric Joyner 68*a9d78bb7SEric Joyner* VLAN 69*a9d78bb7SEric Joyner 70*a9d78bb7SEric Joyner* IPv4 71*a9d78bb7SEric Joyner 72*a9d78bb7SEric Joyner* IPv6 73*a9d78bb7SEric Joyner 74*a9d78bb7SEric Joyner* TCP 75*a9d78bb7SEric Joyner 76*a9d78bb7SEric Joyner* ARP 77*a9d78bb7SEric Joyner 78*a9d78bb7SEric Joyner* UDP 79*a9d78bb7SEric Joyner 80*a9d78bb7SEric Joyner* SCTP 81*a9d78bb7SEric Joyner 82*a9d78bb7SEric Joyner* ICMP 83*a9d78bb7SEric Joyner 84*a9d78bb7SEric Joyner* ICMPv6 85*a9d78bb7SEric Joyner 86*a9d78bb7SEric Joyner* CTRL 87*a9d78bb7SEric Joyner 88*a9d78bb7SEric Joyner* LLDP 89*a9d78bb7SEric Joyner 90*a9d78bb7SEric Joyner* VXLAN-GPE 91*a9d78bb7SEric Joyner 92*a9d78bb7SEric Joyner* VXLAN (non-GPE) 93*a9d78bb7SEric Joyner 94*a9d78bb7SEric Joyner* Geneve 95*a9d78bb7SEric Joyner 96*a9d78bb7SEric Joyner* GRE 97*a9d78bb7SEric Joyner 98*a9d78bb7SEric Joyner* NVGRE 99*a9d78bb7SEric Joyner 100*a9d78bb7SEric Joyner* RoCEv2 101*a9d78bb7SEric Joyner 102*a9d78bb7SEric Joyner* MPLS (up to 5 consecutive MPLS labels in the outermost Layer 2 103*a9d78bb7SEric Joyner header group) 10471d10453SEric Joyner 10571d10453SEric Joyner 1062508da22SEric JoynerSupported Operating Systems 1072508da22SEric Joyner=========================== 108*a9d78bb7SEric Joyner 1092508da22SEric JoynerThis DDP package is supported on the following operating systems: 1102508da22SEric Joyner 111*a9d78bb7SEric Joyner* Microsoft* Windows Server* 112*a9d78bb7SEric Joyner 113*a9d78bb7SEric Joyner* Linux* 114*a9d78bb7SEric Joyner 115*a9d78bb7SEric Joyner* FreeBSD* 116*a9d78bb7SEric Joyner 117*a9d78bb7SEric Joyner* VMware* ESXi* 118*a9d78bb7SEric Joyner 119*a9d78bb7SEric JoynerRefer to the Intel(R) Ethernet Adapters and Devices User Guide for 120*a9d78bb7SEric Joynercurrently supported versions of these operating systems. 1212508da22SEric Joyner 1222508da22SEric Joyner 123*a9d78bb7SEric JoynerRelated Documentation 124*a9d78bb7SEric Joyner===================== 12571d10453SEric Joyner 126*a9d78bb7SEric JoynerSee the "Intel(R) Ethernet Adapters and Devices User Guide" for 127*a9d78bb7SEric Joyneradditional information on features: 128*a9d78bb7SEric Joyner 129*a9d78bb7SEric Joyner* https://cdrdv2.intel.com/v1/dl/getContent/705831/ 130*a9d78bb7SEric Joyner 131*a9d78bb7SEric JoynerAdditionally, a detailed technology guide is available for this DDP 132*a9d78bb7SEric Joynerpackage: 133*a9d78bb7SEric Joyner 134*a9d78bb7SEric Joyner* https://cdrdv2.intel.com/v1/dl/getContent/617015 13571d10453SEric Joyner 13671d10453SEric Joyner 13771d10453SEric JoynerNotes 13871d10453SEric Joyner===== 13971d10453SEric Joyner 140*a9d78bb7SEric Joyner* In Linux, FreeBSD, and Windows, you cannot update the DDP package if 141*a9d78bb7SEric Joyner any PF drivers are already loaded. To overwrite a package, unload 142*a9d78bb7SEric Joyner all PFs and then reload the driver with the new package. 14371d10453SEric Joyner 144*a9d78bb7SEric Joyner* In FreeBSD and Windows, you can only use one DDP package per driver, 145*a9d78bb7SEric Joyner even if you have more than one device installed that uses the 146*a9d78bb7SEric Joyner driver. 1472508da22SEric Joyner 148*a9d78bb7SEric Joyner* In Linux, FreeBSD, and Windows, only the first loaded PF per device 149*a9d78bb7SEric Joyner can download a package for that device. In ESXi, you can load 150*a9d78bb7SEric Joyner different DDP packages for different PFs associated with a device. 15171d10453SEric Joyner 152*a9d78bb7SEric Joyner* If you are using DPDK, see the DPDK documentation at 153*a9d78bb7SEric Joyner https://www.dpdk.org/ for installation instructions and more 154*a9d78bb7SEric Joyner information. 1552508da22SEric Joyner 1562508da22SEric Joyner 1572508da22SEric JoynerTroubleshooting 1582508da22SEric Joyner=============== 1592508da22SEric Joyner 1602508da22SEric Joyner 1612508da22SEric JoynerFreeBSD 1622508da22SEric Joyner------- 1632508da22SEric Joyner 164*a9d78bb7SEric JoynerIf you encounter issues with the DDP package file, you may need to 165*a9d78bb7SEric Joynerdownload an updated driver or ice_ddp module. See the log messages for 166*a9d78bb7SEric Joynermore information. 1672508da22SEric Joyner 1682508da22SEric Joyner 16971d10453SEric JoynerLegal / Disclaimers 17071d10453SEric Joyner=================== 17171d10453SEric Joyner 172*a9d78bb7SEric JoynerCopyright (c) 2019 - 2024, Intel Corporation. 17371d10453SEric Joyner 174*a9d78bb7SEric JoynerIntel technologies may require enabled hardware, software or service 175*a9d78bb7SEric Joyneractivation. 17671d10453SEric Joyner 177*a9d78bb7SEric JoynerNo product or component can be absolutely secure. 178*a9d78bb7SEric Joyner 179*a9d78bb7SEric JoynerYour costs and results may vary. 180*a9d78bb7SEric Joyner 181*a9d78bb7SEric JoynerIntel, the Intel logo, and other Intel marks are trademarks of Intel 182*a9d78bb7SEric JoynerCorporation or its subsidiaries. Other names and brands may be 183*a9d78bb7SEric Joynerclaimed as the property of others. 184*a9d78bb7SEric Joyner 185*a9d78bb7SEric JoynerPerformance varies by use, configuration, and other factors. Learn 186*a9d78bb7SEric Joynermore at https://www.Intel.com/PerformanceIndex. 187*a9d78bb7SEric Joyner 188*a9d78bb7SEric JoynerThe products described may contain design defects or errors known as 189*a9d78bb7SEric Joynererrata which may cause the product to deviate from published 190*a9d78bb7SEric Joynerspecifications. Current characterized errata are available on request. 191*a9d78bb7SEric Joyner 192*a9d78bb7SEric JoynerThis software and the related documents are Intel copyrighted 193*a9d78bb7SEric Joynermaterials, and your use of them is governed by the express license 194*a9d78bb7SEric Joynerunder which they were provided to you ("License"). Unless the License 195*a9d78bb7SEric Joynerprovides otherwise, you may not use, modify, copy, publish, 196*a9d78bb7SEric Joynerdistribute, disclose or transmit this software or the related 197*a9d78bb7SEric Joynerdocuments without Intel's prior written permission. 198*a9d78bb7SEric Joyner 199*a9d78bb7SEric JoynerThis software and the related documents are provided as is, with no 200*a9d78bb7SEric Joynerexpress or implied warranties, other than those that are expressly 201*a9d78bb7SEric Joynerstated in the License. 202