; ; Base Driver Deny List ; ===================== ; ; Hardware checks are controlled by the console variable "r.WarnOfBadDrivers". The the console variable options for more information. ; ; What to do when a certain driver or hardware shows problems: ; - If the driver exhibiting the problem is old, add it to the DriverDenyList with "<=". In general it's better to ask users to upgrade. ; - If the driver exhibiting the problem is the latest, add it to the DriverDenyList with ">=". We should not assume the next driver version fixes the problem. ; ; Expectations on QA: ; - QA always tests the latest driver version. ; - When a new driver is released, QA should test it and if it does not introduce bugs the SuggestedDriverVersion should be updated to the latest driver. ; - If the latest driver is denied, it is not removed until QA verifies it is fixed. ; - If driver specific bugs are found, enter them in JIRA so that they can be tracked. ; ; Expectations on Engineering: ; - Bugs on older drivers are added to the DriverDenyList and otherwise ignored. ; - Bugs on the latest driver are added to the DriverDenyList but treated as critical bugs for which we must try to find a workaround. We must also notify the IHV to help if we cannot find the problem. ; ; INI sections: ; [Vendor OS] where ; Vendor: GPU_NVIDIA, GPU_AMD, GPU_Intel ; OS: Windows, Linux ; ; Explanation of the INI entries: ; - "SuggestedDriverVersion": string used to communicate to the user which driver version is appropriate (not used by any code), empty if unknown. ; Can use multiple so we can add per RHI appending ";D3D12" for instance for a specific RHI; having no ';RHI' will return that one if the RHI is not found ; - "DriverDenyList": array of tests that can be made to mark a driver or a range of them as problematic ; "DriverVersion": to compare against the "unified driver" (see log) version e.g. "123.45.2" "==123.45" "<123.45", comparison operators: == != > < >= <= ; "Reason": string used to document the reason for denying the driver, could be shown to the user ; comment above each deny list entry: more details about the problem, potential workarounds ; ;----------------------------------------------------------------------------------------------------------------- [GPU_NVIDIA Windows] SuggestedDriverVersion="560.81" ; The newest driver which supports legacy Nvidia GPUs (700 series and older) is 474.64. We allow this driver for DX11. +DriverDenyList=(DriverVersion="<474.64", Reason="These driver versions have known stability issues and missing features", RHI="D3D11") ; DX12 require recent drivers. The 536 series was released in June 2023. +DriverDenyList=(DriverVersion="<536.00", Reason="These driver versions have known stability issues and missing features", RHI="D3D12") ; Vulkan require recent drivers, the 570 series includes important fixes. +DriverDenyList=(DriverVersion="<570.00", Reason="These driver versions have known stability issues and missing features", RHI="Vulkan") ;----------------------------------------------------------------------------------------------------------------- [GPU_NVIDIA Linux] SuggestedDriverVersion="570.86" ; Vulkan require recent drivers, the 570 series includes important fixes. +DriverDenyList=(DriverVersion="<570.00", Reason="These driver versions have known stability issues and missing features") ;----------------------------------------------------------------------------------------------------------------- [GPU_AMD Windows] SuggestedDriverVersion="24.3.1" ; The newest driver which supports legacy AMD GPUs (GCN1-GCN3 chips like the Radeon R9 or older) is 22.6.1. We allow this driver for DX11. +DriverDenyList=(DriverVersion="<27.20.20913.2000", Reason="These driver versions have known stability issues and missing features", RHI="D3D11") ; The minimum version for DX12 is 24.3.1, published in March 2024. There are separate packages for different GPU generations and they ; have different internal versions, so we can't check for a version number explicitly (the RDNA driver is 31.0.24027.1012, older GPUs have ; 31.0.21912.14). We'll use a driver date check instead, as both packages have internal date stamps newer than Feb 19th. +DriverDenyList=(DriverDate="<2-19-2024", Reason="These driver versions have known stability issues and missing features", RHI="D3D12") ; The minimum version for Vulkan is 25.2.1, published in Feb 2025. +DriverDenyList=(DriverDate="<2-10-2025", Reason="These driver versions have known stability issues and missing features", RHI="Vulkan") ;----------------------------------------------------------------------------------------------------------------- [GPU_AMD Linux] SuggestedDriverVersion="24.2.8" ; RADV builds older than 24.2.8 have issues running UE5, so we'll use this as the minimum version. ; For SM6 and ray tracing, verison 25.0.0+ of RADV is recommended. ; Note that it's also possible to use the AMD proprietary driver on Linux, and we don't distinguish between driver vendors. +DriverDenyList=(DriverVersion="<24.2.8", Reason="These driver versions have known stability issues and missing features") ;----------------------------------------------------------------------------------------------------------------- [GPU_Intel Windows] SuggestedDriverVersion="101.5333" ; Legacy integrated GPUs are supported by several driver packages (depending on CPU generation) and they all have different version numbers, so ; we will check the date instead. The latest driver for Ivy Bridge chips is 105.161, dated Aug 6th 2020, so we will allow that for D3D11. +DriverDenyList=(DriverDate="<8-6-2020", Reason="These driver versions have known stability issues and missing features", RHI="D3D11") ; DX12 and Vulkan should not be used on integrated GPUs. ARC and newer chips require recent drivers. 101.5333 was released in February 2024. +DriverDenyList=(DriverVersion="<101.5333", Reason="These driver versions have known stability issues and missing features", RHI="D3D12") +DriverDenyList=(DriverVersion="<101.5333", Reason="These driver versions have known stability issues and missing features", RHI="Vulkan") ;----------------------------------------------------------------------------------------------------------------- [GPU_Intel Linux] SuggestedDriverVersion="24.2.8" ; Mesa builds older than 24.2.8 have issues running UE5, so we'll use this as the minimum version. +DriverDenyList=(DriverVersion="<24.2.8", Reason="These driver versions have known stability issues and missing features")