Gigabyte X570-UD

General Information
This article Article description::details the Gigabyte X570-UD motherboard, providing Linux kernel configuration hints and outlines what to expect (including known hardware and firmware issues). The motherboard has an X570 chipset and AM4 CPU socket compatible with Ryzen CPUs. This page is for the “rev 1.0” hardware, the only revision at the time of writing.

CPU
This list is only a guideline, in particular note that current kernels (5.4) need to disable SME due to an incompatibility with the amdgpu driver.

The CCP is present but non-functional due to a broken BIOS:

Storage Devices
The NVMe driver has support for temperature sensors as of Linux 5.5.

If you have SATA disks, the usual driver works. There are six physical ports spread across four PCIe devices, presumably to make virtualisation setups simpler.

Ethernet
The NIC can have its firmware built into the kernel to silence a warning, though in practice it doesn't affect functionality.

Peripherals
The XHCI driver covers all USB functionality, even the USB 2.0 ports.

Sensors
The following is correct for Linux 5.6:


 * The CPU supports the driver with ⅛°C resolution. Linux 5.6 also supports Fam17h voltage, current and per-core-complex temperatures.
 * ACPI Thermal Zone readings appear to be invalid and unchanging, at 16.8°C. contains warnings about “Invalid passive threshold” which might be related, but according to web search results this appears to be a BIOS bug.
 * The X570-UD has an IT8688 chip on an bus. sensors-detect can see the IT8688 but Linux does not have a driver for it. The BIOS provides a configuration GUI for its various fan settings and temperature trip points.

Raw unfiltered sensor values for reference, using kernel 5.5.2 (with the k10temp patches from 5.6): {{Cmd|sensors -jc /dev/null {{!}} sed -n '/k10temp\{{!}}acpitz/,/^  },$/ p'|collapse-output=true|output= "k10temp-pci-00c3":{ "Adapter": "PCI adapter", "Vcore":{ "in0_input": 1.494 },     "Vsoc":{ "in1_input": 1.013 },     "Tdie":{ "temp1_input": 33.500 },     "Tctl":{ "temp2_input": 33.500 },     "Tccd1":{ "temp3_input": 33.250 },     "Tccd2":{ "temp4_input": 33.250 },     "Icore":{ "curr1_input": 11.000 },     "Isoc":{ "curr2_input": 7.500 }  },   "acpitz-acpi-0":{ "Adapter": "ACPI interface", "temp1":{ "temp1_input": 16.800, "temp1_crit": 20.800 },     "temp2":{ "temp2_input": 16.800, "temp2_crit": 20.800 }  }, }}

dmesg excerpts
The usual set of x86 hardware vulnerabilities have to be worked around:

The BIOS wants to know if we're running Linux, for some reason:

Some messages about badly-provisoned onboard PCIe devices:

Buggy ACPI:

Buggy USB 3.1 controllers:

There is a watchdog timer chip physically present, but not usable:

Known hardware issues

 * Many of AMD's AM4 CPUs come with an animated RGB LED heatsink fan, which some may find irritating. It can be disabled (persistently) using the included USB cable and cm-rgb.
 * If boot ends in a hard reset more than once in a row (e.g. due to a kernel misconfiguration), the firmware will reset its settings back to factory defaults. To lessen the impact of this, use the “Save Profile” option in the BIOS menu to keep a backup of known-working settings, and use kexec to test new kernels and avoid doing a cold reboot.
 * Do not change from "BIOS default" in the kernel, as the power saving modes will cause various peripherals (including NVMe) to go missing during boot.