xref: /openbmc/linux/arch/x86/include/asm/microcode.h (revision f9e14dbbd454581061c736bf70bf5cbb15ac927c)
1b2441318SGreg Kroah-Hartman /* SPDX-License-Identifier: GPL-2.0 */
21965aae3SH. Peter Anvin #ifndef _ASM_X86_MICROCODE_H
31965aae3SH. Peter Anvin #define _ASM_X86_MICROCODE_H
4bb898558SAl Viro 
599f925ceSBorislav Petkov #include <asm/cpu.h>
6760d765bSBorislav Petkov #include <linux/earlycpio.h>
75f9c01aaSBorislav Petkov #include <linux/initrd.h>
8760d765bSBorislav Petkov 
9058dc498SBorislav Petkov struct ucode_patch {
10058dc498SBorislav Petkov 	struct list_head plist;
11058dc498SBorislav Petkov 	void *data;		/* Intel uses only this one */
12058dc498SBorislav Petkov 	u32 patch_id;
13058dc498SBorislav Petkov 	u16 equiv_cpu;
14058dc498SBorislav Petkov };
15058dc498SBorislav Petkov 
16058dc498SBorislav Petkov extern struct list_head microcode_cache;
17058dc498SBorislav Petkov 
18bb898558SAl Viro struct cpu_signature {
19bb898558SAl Viro 	unsigned int sig;
20bb898558SAl Viro 	unsigned int pf;
21bb898558SAl Viro 	unsigned int rev;
22bb898558SAl Viro };
23bb898558SAl Viro 
24bb898558SAl Viro struct device;
25bb898558SAl Viro 
263f1f576aSBorislav Petkov enum ucode_state {
273f1f576aSBorislav Petkov 	UCODE_OK	= 0,
282613f36eSBorislav Petkov 	UCODE_NEW,
293f1f576aSBorislav Petkov 	UCODE_UPDATED,
303f1f576aSBorislav Petkov 	UCODE_NFOUND,
313f1f576aSBorislav Petkov 	UCODE_ERROR,
323f1f576aSBorislav Petkov };
33871b72ddSDmitry Adamushko 
34bb898558SAl Viro struct microcode_ops {
35871b72ddSDmitry Adamushko 	enum ucode_state (*request_microcode_user) (int cpu,
36871b72ddSDmitry Adamushko 				const void __user *buf, size_t size);
37bb898558SAl Viro 
3848e30685SBorislav Petkov 	enum ucode_state (*request_microcode_fw) (int cpu, struct device *,
3948e30685SBorislav Petkov 						  bool refresh_fw);
40bb898558SAl Viro 
41bb898558SAl Viro 	void (*microcode_fini_cpu) (int cpu);
42871b72ddSDmitry Adamushko 
43871b72ddSDmitry Adamushko 	/*
44871b72ddSDmitry Adamushko 	 * The generic 'microcode_core' part guarantees that
45871b72ddSDmitry Adamushko 	 * the callbacks below run on a target cpu when they
46871b72ddSDmitry Adamushko 	 * are being called.
47871b72ddSDmitry Adamushko 	 * See also the "Synchronization" section in microcode_core.c.
48871b72ddSDmitry Adamushko 	 */
493f1f576aSBorislav Petkov 	enum ucode_state (*apply_microcode) (int cpu);
50871b72ddSDmitry Adamushko 	int (*collect_cpu_info) (int cpu, struct cpu_signature *csig);
51bb898558SAl Viro };
52bb898558SAl Viro 
53bb898558SAl Viro struct ucode_cpu_info {
54bb898558SAl Viro 	struct cpu_signature	cpu_sig;
55bb898558SAl Viro 	int			valid;
56bb898558SAl Viro 	void			*mc;
57bb898558SAl Viro };
58bb898558SAl Viro extern struct ucode_cpu_info ucode_cpu_info[];
5906b8534cSBorislav Petkov struct cpio_data find_microcode_in_initrd(const char *path, bool use_pa);
60bb898558SAl Viro 
61bb898558SAl Viro #ifdef CONFIG_MICROCODE_INTEL
62bb898558SAl Viro extern struct microcode_ops * __init init_intel_microcode(void);
63bb898558SAl Viro #else
64bb898558SAl Viro static inline struct microcode_ops * __init init_intel_microcode(void)
65bb898558SAl Viro {
66bb898558SAl Viro 	return NULL;
67bb898558SAl Viro }
68bb898558SAl Viro #endif /* CONFIG_MICROCODE_INTEL */
69bb898558SAl Viro 
70bb898558SAl Viro #ifdef CONFIG_MICROCODE_AMD
71bb898558SAl Viro extern struct microcode_ops * __init init_amd_microcode(void);
72f72c1a57SBorislav Petkov extern void __exit exit_amd_microcode(void);
73bb898558SAl Viro #else
74bb898558SAl Viro static inline struct microcode_ops * __init init_amd_microcode(void)
75bb898558SAl Viro {
76bb898558SAl Viro 	return NULL;
77bb898558SAl Viro }
78f72c1a57SBorislav Petkov static inline void __exit exit_amd_microcode(void) {}
79bb898558SAl Viro #endif
80bb898558SAl Viro 
81a8ebf6d1SFenghua Yu #define MAX_UCODE_COUNT 128
8258ce8d6dSBorislav Petkov 
8358ce8d6dSBorislav Petkov #define QCHAR(a, b, c, d) ((a) + ((b) << 8) + ((c) << 16) + ((d) << 24))
8458ce8d6dSBorislav Petkov #define CPUID_INTEL1 QCHAR('G', 'e', 'n', 'u')
8558ce8d6dSBorislav Petkov #define CPUID_INTEL2 QCHAR('i', 'n', 'e', 'I')
8658ce8d6dSBorislav Petkov #define CPUID_INTEL3 QCHAR('n', 't', 'e', 'l')
8758ce8d6dSBorislav Petkov #define CPUID_AMD1 QCHAR('A', 'u', 't', 'h')
8858ce8d6dSBorislav Petkov #define CPUID_AMD2 QCHAR('e', 'n', 't', 'i')
8958ce8d6dSBorislav Petkov #define CPUID_AMD3 QCHAR('c', 'A', 'M', 'D')
9058ce8d6dSBorislav Petkov 
9158ce8d6dSBorislav Petkov #define CPUID_IS(a, b, c, ebx, ecx, edx)	\
9258ce8d6dSBorislav Petkov 		(!((ebx ^ (a))|(edx ^ (b))|(ecx ^ (c))))
9358ce8d6dSBorislav Petkov 
9458ce8d6dSBorislav Petkov /*
9558ce8d6dSBorislav Petkov  * In early loading microcode phase on BSP, boot_cpu_data is not set up yet.
9699f925ceSBorislav Petkov  * x86_cpuid_vendor() gets vendor id for BSP.
9758ce8d6dSBorislav Petkov  *
9858ce8d6dSBorislav Petkov  * In 32 bit AP case, accessing boot_cpu_data needs linear address. To simplify
9999f925ceSBorislav Petkov  * coding, we still use x86_cpuid_vendor() to get vendor id for AP.
10058ce8d6dSBorislav Petkov  *
10199f925ceSBorislav Petkov  * x86_cpuid_vendor() gets vendor information directly from CPUID.
10258ce8d6dSBorislav Petkov  */
10399f925ceSBorislav Petkov static inline int x86_cpuid_vendor(void)
10458ce8d6dSBorislav Petkov {
10558ce8d6dSBorislav Petkov 	u32 eax = 0x00000000;
10658ce8d6dSBorislav Petkov 	u32 ebx, ecx = 0, edx;
10758ce8d6dSBorislav Petkov 
10858ce8d6dSBorislav Petkov 	native_cpuid(&eax, &ebx, &ecx, &edx);
10958ce8d6dSBorislav Petkov 
11058ce8d6dSBorislav Petkov 	if (CPUID_IS(CPUID_INTEL1, CPUID_INTEL2, CPUID_INTEL3, ebx, ecx, edx))
11158ce8d6dSBorislav Petkov 		return X86_VENDOR_INTEL;
11258ce8d6dSBorislav Petkov 
11358ce8d6dSBorislav Petkov 	if (CPUID_IS(CPUID_AMD1, CPUID_AMD2, CPUID_AMD3, ebx, ecx, edx))
11458ce8d6dSBorislav Petkov 		return X86_VENDOR_AMD;
11558ce8d6dSBorislav Petkov 
11658ce8d6dSBorislav Petkov 	return X86_VENDOR_UNKNOWN;
11758ce8d6dSBorislav Petkov }
11858ce8d6dSBorislav Petkov 
11999f925ceSBorislav Petkov static inline unsigned int x86_cpuid_family(void)
12058ce8d6dSBorislav Petkov {
12158ce8d6dSBorislav Petkov 	u32 eax = 0x00000001;
12258ce8d6dSBorislav Petkov 	u32 ebx, ecx = 0, edx;
12358ce8d6dSBorislav Petkov 
12458ce8d6dSBorislav Petkov 	native_cpuid(&eax, &ebx, &ecx, &edx);
12558ce8d6dSBorislav Petkov 
12699f925ceSBorislav Petkov 	return x86_family(eax);
12758ce8d6dSBorislav Petkov }
12858ce8d6dSBorislav Petkov 
129fe055896SBorislav Petkov #ifdef CONFIG_MICROCODE
130a8ebf6d1SFenghua Yu extern void __init load_ucode_bsp(void);
131148f9bb8SPaul Gortmaker extern void load_ucode_ap(void);
132fbae4ba8SBorislav Petkov void reload_early_microcode(void);
13324c25032SBorislav Petkov extern bool initrd_gone;
134*f9e14dbbSBorislav Petkov void microcode_bsp_resume(void);
135a8ebf6d1SFenghua Yu #else
136a8ebf6d1SFenghua Yu static inline void __init load_ucode_bsp(void)			{ }
137148f9bb8SPaul Gortmaker static inline void load_ucode_ap(void)				{ }
138fbae4ba8SBorislav Petkov static inline void reload_early_microcode(void)			{ }
139*f9e14dbbSBorislav Petkov static inline void microcode_bsp_resume(void)			{ }
140a8ebf6d1SFenghua Yu #endif
1415f9c01aaSBorislav Petkov 
1421965aae3SH. Peter Anvin #endif /* _ASM_X86_MICROCODE_H */
143