2 * AMD CPU Microcode Update Driver for Linux
3 * Copyright (C) 2008-2011 Advanced Micro Devices Inc.
5 * Author: Peter Oruba <peter.oruba@amd.com>
8 * Tigran Aivazian <tigran@aivazian.fsnet.co.uk>
11 * Andreas Herrmann <andreas.herrmann3@amd.com>
12 * Borislav Petkov <borislav.petkov@amd.com>
14 * This driver allows to upgrade microcode on F10h AMD
17 * Licensed under the terms of the GNU General Public
18 * License version 2. See file COPYING for details.
21 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
23 #include <linux/firmware.h>
24 #include <linux/pci_ids.h>
25 #include <linux/uaccess.h>
26 #include <linux/vmalloc.h>
27 #include <linux/kernel.h>
28 #include <linux/module.h>
29 #include <linux/pci.h>
31 #include <asm/microcode.h>
32 #include <asm/processor.h>
35 MODULE_DESCRIPTION("AMD Microcode Update Driver");
36 MODULE_AUTHOR("Peter Oruba");
37 MODULE_LICENSE("GPL v2");
39 #define UCODE_MAGIC 0x00414d44
40 #define UCODE_EQUIV_CPU_TABLE_TYPE 0x00000000
41 #define UCODE_UCODE_TYPE 0x00000001
43 struct equiv_cpu_entry
{
45 u32 fixed_errata_mask
;
46 u32 fixed_errata_compare
;
49 } __attribute__((packed
));
51 struct microcode_header_amd
{
57 u32 mc_patch_data_checksum
;
66 } __attribute__((packed
));
68 struct microcode_amd
{
69 struct microcode_header_amd hdr
;
73 #define SECTION_HDR_SIZE 8
74 #define CONTAINER_HDR_SZ 12
76 static struct equiv_cpu_entry
*equiv_cpu_table
;
78 /* page-sized ucode patch buffer */
81 static int collect_cpu_info_amd(int cpu
, struct cpu_signature
*csig
)
83 struct cpuinfo_x86
*c
= &cpu_data(cpu
);
85 csig
->rev
= c
->microcode
;
86 pr_info("CPU%d: patch_level=0x%08x\n", cpu
, csig
->rev
);
91 static unsigned int verify_ucode_size(int cpu
, u32 patch_size
,
94 struct cpuinfo_x86
*c
= &cpu_data(cpu
);
97 #define F1XH_MPB_MAX_SIZE 2048
98 #define F14H_MPB_MAX_SIZE 1824
99 #define F15H_MPB_MAX_SIZE 4096
103 max_size
= F14H_MPB_MAX_SIZE
;
106 max_size
= F15H_MPB_MAX_SIZE
;
109 max_size
= F1XH_MPB_MAX_SIZE
;
113 if (patch_size
> min_t(u32
, size
, max_size
)) {
114 pr_err("patch size mismatch\n");
121 static u16
find_equiv_id(void)
123 unsigned int current_cpu_id
, i
= 0;
125 BUG_ON(equiv_cpu_table
== NULL
);
127 current_cpu_id
= cpuid_eax(0x00000001);
129 while (equiv_cpu_table
[i
].installed_cpu
!= 0) {
130 if (current_cpu_id
== equiv_cpu_table
[i
].installed_cpu
)
131 return equiv_cpu_table
[i
].equiv_cpu
;
139 * we signal a good patch is found by returning its size > 0
141 static int get_matching_microcode(int cpu
, const u8
*ucode_ptr
,
142 unsigned int leftover_size
, int rev
,
143 unsigned int *current_size
)
145 struct microcode_header_amd
*mc_hdr
;
146 unsigned int actual_size
, patch_size
;
149 /* size of the current patch we're staring at */
150 patch_size
= *(u32
*)(ucode_ptr
+ 4);
151 *current_size
= patch_size
+ SECTION_HDR_SIZE
;
153 equiv_cpu_id
= find_equiv_id();
158 * let's look at the patch header itself now
160 mc_hdr
= (struct microcode_header_amd
*)(ucode_ptr
+ SECTION_HDR_SIZE
);
162 if (mc_hdr
->processor_rev_id
!= equiv_cpu_id
)
165 /* ucode might be chipset specific -- currently we don't support this */
166 if (mc_hdr
->nb_dev_id
|| mc_hdr
->sb_dev_id
) {
167 pr_err("CPU%d: chipset specific code not yet supported\n",
172 if (mc_hdr
->patch_id
<= rev
)
176 * now that the header looks sane, verify its size
178 actual_size
= verify_ucode_size(cpu
, patch_size
, leftover_size
);
182 /* clear the patch buffer */
183 memset(patch
, 0, PAGE_SIZE
);
185 /* all looks ok, get the binary patch */
186 get_ucode_data(patch
, ucode_ptr
+ SECTION_HDR_SIZE
, actual_size
);
191 static int apply_microcode_amd(int cpu
)
194 int cpu_num
= raw_smp_processor_id();
195 struct ucode_cpu_info
*uci
= ucode_cpu_info
+ cpu_num
;
196 struct microcode_amd
*mc_amd
= uci
->mc
;
197 struct cpuinfo_x86
*c
= &cpu_data(cpu
);
199 /* We should bind the task to the CPU */
200 BUG_ON(cpu_num
!= cpu
);
205 wrmsrl(MSR_AMD64_PATCH_LOADER
, (u64
)(long)&mc_amd
->hdr
.data_code
);
206 /* get patch id after patching */
207 rdmsr(MSR_AMD64_PATCH_LEVEL
, rev
, dummy
);
209 /* check current patch id and patch's id for match */
210 if (rev
!= mc_amd
->hdr
.patch_id
) {
211 pr_err("CPU%d: update failed for patch_level=0x%08x\n",
212 cpu
, mc_amd
->hdr
.patch_id
);
216 pr_info("CPU%d: new patch_level=0x%08x\n", cpu
, rev
);
217 uci
->cpu_sig
.rev
= rev
;
223 static int install_equiv_cpu_table(const u8
*buf
)
225 unsigned int *ibuf
= (unsigned int *)buf
;
226 unsigned int type
= ibuf
[1];
227 unsigned int size
= ibuf
[2];
229 if (type
!= UCODE_EQUIV_CPU_TABLE_TYPE
|| !size
) {
230 pr_err("empty section/"
231 "invalid type field in container file section header\n");
235 equiv_cpu_table
= vmalloc(size
);
236 if (!equiv_cpu_table
) {
237 pr_err("failed to allocate equivalent CPU table\n");
241 get_ucode_data(equiv_cpu_table
, buf
+ CONTAINER_HDR_SZ
, size
);
243 /* add header length */
244 return size
+ CONTAINER_HDR_SZ
;
247 static void free_equiv_cpu_table(void)
249 vfree(equiv_cpu_table
);
250 equiv_cpu_table
= NULL
;
253 static enum ucode_state
254 generic_load_microcode(int cpu
, const u8
*data
, size_t size
)
256 struct ucode_cpu_info
*uci
= ucode_cpu_info
+ cpu
;
257 struct microcode_header_amd
*mc_hdr
= NULL
;
258 unsigned int mc_size
, leftover
, current_size
= 0;
260 const u8
*ucode_ptr
= data
;
262 unsigned int new_rev
= uci
->cpu_sig
.rev
;
263 enum ucode_state state
= UCODE_ERROR
;
265 offset
= install_equiv_cpu_table(ucode_ptr
);
267 pr_err("failed to create equivalent cpu table\n");
271 leftover
= size
- offset
;
273 if (*(u32
*)ucode_ptr
!= UCODE_UCODE_TYPE
) {
274 pr_err("invalid type field in container file section header\n");
279 mc_size
= get_matching_microcode(cpu
, ucode_ptr
, leftover
,
280 new_rev
, ¤t_size
);
284 new_rev
= mc_hdr
->patch_id
;
288 ucode_ptr
+= current_size
;
289 leftover
-= current_size
;
293 state
= UCODE_NFOUND
;
300 pr_debug("CPU%d update ucode (0x%08x -> 0x%08x)\n",
301 cpu
, uci
->cpu_sig
.rev
, new_rev
);
304 free_equiv_cpu_table();
311 * AMD microcode firmware naming convention, up to family 15h they are in
314 * amd-ucode/microcode_amd.bin
316 * This legacy file is always smaller than 2K in size.
318 * Starting at family 15h they are in family specific firmware files:
320 * amd-ucode/microcode_amd_fam15h.bin
321 * amd-ucode/microcode_amd_fam16h.bin
324 * These might be larger than 2K.
326 static enum ucode_state
request_microcode_amd(int cpu
, struct device
*device
)
328 char fw_name
[36] = "amd-ucode/microcode_amd.bin";
329 const struct firmware
*fw
;
330 enum ucode_state ret
= UCODE_NFOUND
;
331 struct cpuinfo_x86
*c
= &cpu_data(cpu
);
334 snprintf(fw_name
, sizeof(fw_name
), "amd-ucode/microcode_amd_fam%.2xh.bin", c
->x86
);
336 if (request_firmware(&fw
, (const char *)fw_name
, device
)) {
337 pr_err("failed to load file %s\n", fw_name
);
342 if (*(u32
*)fw
->data
!= UCODE_MAGIC
) {
343 pr_err("invalid magic value (0x%08x)\n", *(u32
*)fw
->data
);
347 ret
= generic_load_microcode(cpu
, fw
->data
, fw
->size
);
350 release_firmware(fw
);
356 static enum ucode_state
357 request_microcode_user(int cpu
, const void __user
*buf
, size_t size
)
362 static void microcode_fini_cpu_amd(int cpu
)
364 struct ucode_cpu_info
*uci
= ucode_cpu_info
+ cpu
;
369 static struct microcode_ops microcode_amd_ops
= {
370 .request_microcode_user
= request_microcode_user
,
371 .request_microcode_fw
= request_microcode_amd
,
372 .collect_cpu_info
= collect_cpu_info_amd
,
373 .apply_microcode
= apply_microcode_amd
,
374 .microcode_fini_cpu
= microcode_fini_cpu_amd
,
377 struct microcode_ops
* __init
init_amd_microcode(void)
379 struct cpuinfo_x86
*c
= &cpu_data(0);
381 if (c
->x86_vendor
!= X86_VENDOR_AMD
|| c
->x86
< 0x10) {
382 pr_warning("AMD CPU family 0x%x not supported\n", c
->x86
);
386 patch
= (void *)get_zeroed_page(GFP_KERNEL
);
390 return µcode_amd_ops
;
393 void __exit
exit_amd_microcode(void)
395 free_page((unsigned long)patch
);