summaryrefslogtreecommitdiffstats
path: root/src/cpu/intel/microcode/Kconfig
blob: 25894e8be0b4537bd9a1adb2e94e89b9815aa2ed (plain)
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
## SPDX-License-Identifier: GPL-2.0-only

config MICROCODE_UPDATE_PRE_RAM
	bool
	depends on SUPPORT_CPU_UCODE_IN_CBFS
	default n if CPU_INTEL_FIRMWARE_INTERFACE_TABLE
	default y
	help
	  Select this option if you want to update the microcode
	  during the cache as RAM setup.

config RELOAD_MICROCODE_PATCH
	bool
	default n
	help
	  Select this option if SoC recommends to re-load microcode
	  patch as part of CPU multiprocessor initialization process.
	  This feature is mostly required with Intel latest generation
	  processors starting with Alder Lake (with modified MCHECK init
	  flow).

config CPU_INTEL_MICROCODE_CBFS_SPLIT_BINS
	bool "For Intel CPU, include microcode per CPUID into CBFS"
	depends on CBFS_VERIFICATION && !MICROCODE_UPDATE_PRE_RAM
	default n
	help
	  This option controls whether to include external microcode binaries per
	  CPUID in CBFS.

	  The current approach of loading microcode blobs post CPU reset is to search
	  the unified blob in the CBFS and then perform the CBFS verification. The bigger
	  the unified microcode blob in size the longer it takes to perform the verification.

	  Select this option to store the split microcode blobs per CPUID in the CBFS.
	  As the microcode blobs will be divided into smaller chunks per CPUID, which will
	  reduce the overall search, verify and load time.

	  The microcode file may be removed from the ROM image at a later
	  time with cbfstool, if desired.

	  If unsure, and applicable, select "Generate from tree"

config CPU_INTEL_UCODE_SPLIT_BINARIES
	string "Specify the split microcode blob directory path"
	depends on CPU_INTEL_MICROCODE_CBFS_SPLIT_BINS
	default ""
	help
	  Provide the split microcode blob directory path if
	  CPU_INTEL_MICROCODE_CBFS_SPLIT_BINS config is enabled.

	  CPU_INTEL_MICROCODE_CBFS_SPLIT_BINS config is allowed to pack the individual microcode
	  patch file per CPUID inside the CBFS.

	  Intel distributes CPU microcode updates based on CPUID as part of the github repository
	  in INC format and expects it also getting used in binary form.

	  For example: Intel CPU microcode `m506e3.inc` is getting converted into F-MO-S
	  (06-5e-03) binary file for Linux kernel.

	  `MicrocodeConverter` is an Intel-provided tool for converting binary form MCU into
	  several other common formats for integration.

	  Implementation logic behind CPU_INTEL_MICROCODE_CBFS_SPLIT_BINS config relies on
	  converting Intel CPU microcode INC file into the binary file as per format specified
	  here `cpu_microcode_$(CPUID).bin`. For example: Intel CPU microcode `m506e3.inc` to
	  convert into `cpu_microcode_506e3.bin` binary file for coreboot to integrate if
	  CPU_INTEL_MICROCODE_CBFS_SPLIT_BINS config is enabled.

	  This config provides the directory name (including path) that holds the split microcode
	  binary files per CPUID as mentioned above for each coreboot variants. For example: if
	  google/kunimitsu had built with Intel SkyLake processor with CPUID `506e3` and `506e4`
	  then CPU_INTEL_UCODE_SPLIT_BINARIES refers to the directory path that holds the split
	  microcode binary files aka `cpu_microcode_506e3.bin` and `cpu_microcode_506e4.bin`.

	  CONFIG_CPU_UCODE_SPLIT_BINARIES="3rdparty/blobs/mainboard/google/kunimitsu/microcode_inputs/kunimitsu"
	  Refer to the file representation below:
	  |---3rdparty
	  |   |--- blobs
	  |   |    |--- mainboard
	  |   |    |   |--- google
	  |   |    |   |    |--- kunimitsu
	  |   |    |   |    |    |--- microcode_inputs
	  |   |    |   |    |    |    |--- kunimitsu
	  |   |    |   |    |    |    |    |--- cpu_microcode_506e3.bin
	  |   |    |   |    |    |    |    |--- cpu_microcode_506e4.bin

	  Users of this config option requires to manually place the microcode binary files per
	  CPUIDs as per the given format (`cpu_microcode_$(CPUID).bin`) in a directory.
	  Finally specify the microcode binary directory path using CPU_UCODE_SPLIT_BINARIES
	  config.

	  At runtime (either from romstage/ramstage), coreboot read the CPUID and search for the
	  `cpu_microcode_$(CPUID).bin` file (in this example: cpu_microcode_506e3.bin) inside RW
	  CBFS. Eventually able to locate the appropriate `cpu_microcode_$(CPUID).bin` file and
	  perform the verification prior loading into the CPUs (BSP and APs).

	  If unsure, leave this blank.