1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0 */
2*4882a593Smuzhiyun #ifndef _ASM_X86_MICROCODE_H
3*4882a593Smuzhiyun #define _ASM_X86_MICROCODE_H
4*4882a593Smuzhiyun
5*4882a593Smuzhiyun #include <asm/cpu.h>
6*4882a593Smuzhiyun #include <linux/earlycpio.h>
7*4882a593Smuzhiyun #include <linux/initrd.h>
8*4882a593Smuzhiyun
9*4882a593Smuzhiyun struct ucode_patch {
10*4882a593Smuzhiyun struct list_head plist;
11*4882a593Smuzhiyun void *data; /* Intel uses only this one */
12*4882a593Smuzhiyun unsigned int size;
13*4882a593Smuzhiyun u32 patch_id;
14*4882a593Smuzhiyun u16 equiv_cpu;
15*4882a593Smuzhiyun };
16*4882a593Smuzhiyun
17*4882a593Smuzhiyun extern struct list_head microcode_cache;
18*4882a593Smuzhiyun
19*4882a593Smuzhiyun struct cpu_signature {
20*4882a593Smuzhiyun unsigned int sig;
21*4882a593Smuzhiyun unsigned int pf;
22*4882a593Smuzhiyun unsigned int rev;
23*4882a593Smuzhiyun };
24*4882a593Smuzhiyun
25*4882a593Smuzhiyun struct device;
26*4882a593Smuzhiyun
27*4882a593Smuzhiyun enum ucode_state {
28*4882a593Smuzhiyun UCODE_OK = 0,
29*4882a593Smuzhiyun UCODE_NEW,
30*4882a593Smuzhiyun UCODE_UPDATED,
31*4882a593Smuzhiyun UCODE_NFOUND,
32*4882a593Smuzhiyun UCODE_ERROR,
33*4882a593Smuzhiyun };
34*4882a593Smuzhiyun
35*4882a593Smuzhiyun struct microcode_ops {
36*4882a593Smuzhiyun enum ucode_state (*request_microcode_user) (int cpu,
37*4882a593Smuzhiyun const void __user *buf, size_t size);
38*4882a593Smuzhiyun
39*4882a593Smuzhiyun enum ucode_state (*request_microcode_fw) (int cpu, struct device *,
40*4882a593Smuzhiyun bool refresh_fw);
41*4882a593Smuzhiyun
42*4882a593Smuzhiyun void (*microcode_fini_cpu) (int cpu);
43*4882a593Smuzhiyun
44*4882a593Smuzhiyun /*
45*4882a593Smuzhiyun * The generic 'microcode_core' part guarantees that
46*4882a593Smuzhiyun * the callbacks below run on a target cpu when they
47*4882a593Smuzhiyun * are being called.
48*4882a593Smuzhiyun * See also the "Synchronization" section in microcode_core.c.
49*4882a593Smuzhiyun */
50*4882a593Smuzhiyun enum ucode_state (*apply_microcode) (int cpu);
51*4882a593Smuzhiyun int (*collect_cpu_info) (int cpu, struct cpu_signature *csig);
52*4882a593Smuzhiyun };
53*4882a593Smuzhiyun
54*4882a593Smuzhiyun struct ucode_cpu_info {
55*4882a593Smuzhiyun struct cpu_signature cpu_sig;
56*4882a593Smuzhiyun int valid;
57*4882a593Smuzhiyun void *mc;
58*4882a593Smuzhiyun };
59*4882a593Smuzhiyun extern struct ucode_cpu_info ucode_cpu_info[];
60*4882a593Smuzhiyun struct cpio_data find_microcode_in_initrd(const char *path, bool use_pa);
61*4882a593Smuzhiyun
62*4882a593Smuzhiyun #ifdef CONFIG_MICROCODE_INTEL
63*4882a593Smuzhiyun extern struct microcode_ops * __init init_intel_microcode(void);
64*4882a593Smuzhiyun #else
init_intel_microcode(void)65*4882a593Smuzhiyun static inline struct microcode_ops * __init init_intel_microcode(void)
66*4882a593Smuzhiyun {
67*4882a593Smuzhiyun return NULL;
68*4882a593Smuzhiyun }
69*4882a593Smuzhiyun #endif /* CONFIG_MICROCODE_INTEL */
70*4882a593Smuzhiyun
71*4882a593Smuzhiyun #ifdef CONFIG_MICROCODE_AMD
72*4882a593Smuzhiyun extern struct microcode_ops * __init init_amd_microcode(void);
73*4882a593Smuzhiyun extern void __exit exit_amd_microcode(void);
74*4882a593Smuzhiyun #else
init_amd_microcode(void)75*4882a593Smuzhiyun static inline struct microcode_ops * __init init_amd_microcode(void)
76*4882a593Smuzhiyun {
77*4882a593Smuzhiyun return NULL;
78*4882a593Smuzhiyun }
exit_amd_microcode(void)79*4882a593Smuzhiyun static inline void __exit exit_amd_microcode(void) {}
80*4882a593Smuzhiyun #endif
81*4882a593Smuzhiyun
82*4882a593Smuzhiyun #define MAX_UCODE_COUNT 128
83*4882a593Smuzhiyun
84*4882a593Smuzhiyun #define QCHAR(a, b, c, d) ((a) + ((b) << 8) + ((c) << 16) + ((d) << 24))
85*4882a593Smuzhiyun #define CPUID_INTEL1 QCHAR('G', 'e', 'n', 'u')
86*4882a593Smuzhiyun #define CPUID_INTEL2 QCHAR('i', 'n', 'e', 'I')
87*4882a593Smuzhiyun #define CPUID_INTEL3 QCHAR('n', 't', 'e', 'l')
88*4882a593Smuzhiyun #define CPUID_AMD1 QCHAR('A', 'u', 't', 'h')
89*4882a593Smuzhiyun #define CPUID_AMD2 QCHAR('e', 'n', 't', 'i')
90*4882a593Smuzhiyun #define CPUID_AMD3 QCHAR('c', 'A', 'M', 'D')
91*4882a593Smuzhiyun
92*4882a593Smuzhiyun #define CPUID_IS(a, b, c, ebx, ecx, edx) \
93*4882a593Smuzhiyun (!((ebx ^ (a))|(edx ^ (b))|(ecx ^ (c))))
94*4882a593Smuzhiyun
95*4882a593Smuzhiyun /*
96*4882a593Smuzhiyun * In early loading microcode phase on BSP, boot_cpu_data is not set up yet.
97*4882a593Smuzhiyun * x86_cpuid_vendor() gets vendor id for BSP.
98*4882a593Smuzhiyun *
99*4882a593Smuzhiyun * In 32 bit AP case, accessing boot_cpu_data needs linear address. To simplify
100*4882a593Smuzhiyun * coding, we still use x86_cpuid_vendor() to get vendor id for AP.
101*4882a593Smuzhiyun *
102*4882a593Smuzhiyun * x86_cpuid_vendor() gets vendor information directly from CPUID.
103*4882a593Smuzhiyun */
x86_cpuid_vendor(void)104*4882a593Smuzhiyun static inline int x86_cpuid_vendor(void)
105*4882a593Smuzhiyun {
106*4882a593Smuzhiyun u32 eax = 0x00000000;
107*4882a593Smuzhiyun u32 ebx, ecx = 0, edx;
108*4882a593Smuzhiyun
109*4882a593Smuzhiyun native_cpuid(&eax, &ebx, &ecx, &edx);
110*4882a593Smuzhiyun
111*4882a593Smuzhiyun if (CPUID_IS(CPUID_INTEL1, CPUID_INTEL2, CPUID_INTEL3, ebx, ecx, edx))
112*4882a593Smuzhiyun return X86_VENDOR_INTEL;
113*4882a593Smuzhiyun
114*4882a593Smuzhiyun if (CPUID_IS(CPUID_AMD1, CPUID_AMD2, CPUID_AMD3, ebx, ecx, edx))
115*4882a593Smuzhiyun return X86_VENDOR_AMD;
116*4882a593Smuzhiyun
117*4882a593Smuzhiyun return X86_VENDOR_UNKNOWN;
118*4882a593Smuzhiyun }
119*4882a593Smuzhiyun
x86_cpuid_family(void)120*4882a593Smuzhiyun static inline unsigned int x86_cpuid_family(void)
121*4882a593Smuzhiyun {
122*4882a593Smuzhiyun u32 eax = 0x00000001;
123*4882a593Smuzhiyun u32 ebx, ecx = 0, edx;
124*4882a593Smuzhiyun
125*4882a593Smuzhiyun native_cpuid(&eax, &ebx, &ecx, &edx);
126*4882a593Smuzhiyun
127*4882a593Smuzhiyun return x86_family(eax);
128*4882a593Smuzhiyun }
129*4882a593Smuzhiyun
130*4882a593Smuzhiyun #ifdef CONFIG_MICROCODE
131*4882a593Smuzhiyun int __init microcode_init(void);
132*4882a593Smuzhiyun extern void __init load_ucode_bsp(void);
133*4882a593Smuzhiyun extern void load_ucode_ap(void);
134*4882a593Smuzhiyun void reload_early_microcode(void);
135*4882a593Smuzhiyun extern bool get_builtin_firmware(struct cpio_data *cd, const char *name);
136*4882a593Smuzhiyun extern bool initrd_gone;
137*4882a593Smuzhiyun void microcode_bsp_resume(void);
138*4882a593Smuzhiyun #else
microcode_init(void)139*4882a593Smuzhiyun static inline int __init microcode_init(void) { return 0; };
load_ucode_bsp(void)140*4882a593Smuzhiyun static inline void __init load_ucode_bsp(void) { }
load_ucode_ap(void)141*4882a593Smuzhiyun static inline void load_ucode_ap(void) { }
reload_early_microcode(void)142*4882a593Smuzhiyun static inline void reload_early_microcode(void) { }
microcode_bsp_resume(void)143*4882a593Smuzhiyun static inline void microcode_bsp_resume(void) { }
144*4882a593Smuzhiyun static inline bool
get_builtin_firmware(struct cpio_data * cd,const char * name)145*4882a593Smuzhiyun get_builtin_firmware(struct cpio_data *cd, const char *name) { return false; }
146*4882a593Smuzhiyun #endif
147*4882a593Smuzhiyun
148*4882a593Smuzhiyun #endif /* _ASM_X86_MICROCODE_H */
149