2 * AMD CPU Microcode Update Driver for Linux
3 * Copyright (C) 2008 Advanced Micro Devices Inc.
5 * Author: Peter Oruba <peter.oruba@amd.com>
8 * Tigran Aivazian <tigran@aivazian.fsnet.co.uk>
10 * This driver allows to upgrade microcode on AMD
11 * family 0x10 and 0x11 processors.
13 * Licensed under the terms of the GNU General Public
14 * License version 2. See file COPYING for details.
16 #include <linux/firmware.h>
17 #include <linux/pci_ids.h>
18 #include <linux/uaccess.h>
19 #include <linux/vmalloc.h>
20 #include <linux/kernel.h>
21 #include <linux/module.h>
22 #include <linux/pci.h>
24 #include <asm/microcode.h>
25 #include <asm/processor.h>
28 MODULE_DESCRIPTION("AMD Microcode Update Driver");
29 MODULE_AUTHOR("Peter Oruba");
30 MODULE_LICENSE("GPL v2");
32 #define UCODE_MAGIC 0x00414d44
33 #define UCODE_EQUIV_CPU_TABLE_TYPE 0x00000000
34 #define UCODE_UCODE_TYPE 0x00000001
36 struct equiv_cpu_entry {
38 u32 fixed_errata_mask;
39 u32 fixed_errata_compare;
42 } __attribute__((packed));
44 struct microcode_header_amd {
50 u32 mc_patch_data_checksum;
59 } __attribute__((packed));
61 struct microcode_amd {
62 struct microcode_header_amd hdr;
66 #define UCODE_CONTAINER_SECTION_HDR 8
67 #define UCODE_CONTAINER_HEADER_SIZE 12
69 static struct equiv_cpu_entry *equiv_cpu_table;
71 static int collect_cpu_info_amd(int cpu, struct cpu_signature *csig)
73 struct cpuinfo_x86 *c = &cpu_data(cpu);
76 memset(csig, 0, sizeof(*csig));
77 if (c->x86_vendor != X86_VENDOR_AMD || c->x86 < 0x10) {
78 printk(KERN_WARNING "microcode: CPU%d: AMD CPU family 0x%x not "
79 "supported\n", cpu, c->x86);
82 rdmsr(MSR_AMD64_PATCH_LEVEL, csig->rev, dummy);
83 printk(KERN_INFO "microcode: CPU%d: patch_level=0x%x\n", cpu, csig->rev);
87 static int get_matching_microcode(int cpu, void *mc, int rev)
89 struct microcode_header_amd *mc_header = mc;
90 unsigned int current_cpu_id;
94 BUG_ON(equiv_cpu_table == NULL);
95 current_cpu_id = cpuid_eax(0x00000001);
97 while (equiv_cpu_table[i].installed_cpu != 0) {
98 if (current_cpu_id == equiv_cpu_table[i].installed_cpu) {
99 equiv_cpu_id = equiv_cpu_table[i].equiv_cpu;
106 printk(KERN_WARNING "microcode: CPU%d: cpu revision "
107 "not listed in equivalent cpu table\n", cpu);
111 if (mc_header->processor_rev_id != equiv_cpu_id)
114 /* ucode might be chipset specific -- currently we don't support this */
115 if (mc_header->nb_dev_id || mc_header->sb_dev_id) {
116 printk(KERN_ERR "microcode: CPU%d: loading of chipset "
117 "specific code not yet supported\n", cpu);
121 if (mc_header->patch_id <= rev)
127 static unsigned int verify_ucode_size(int cpu, const u8 *buf, unsigned int size)
129 struct cpuinfo_x86 *c = &cpu_data(cpu);
130 unsigned int max_size, actual_size;
132 #define F1XH_MPB_MAX_SIZE 2048
133 #define F14H_MPB_MAX_SIZE 1824
134 #define F15H_MPB_MAX_SIZE 4096
138 max_size = F14H_MPB_MAX_SIZE;
141 max_size = F15H_MPB_MAX_SIZE;
144 max_size = F1XH_MPB_MAX_SIZE;
148 actual_size = buf[4] + (buf[5] << 8);
150 if (actual_size > size || actual_size > max_size) {
151 pr_err("section size mismatch\n");
158 static int apply_microcode_amd(int cpu)
161 int cpu_num = raw_smp_processor_id();
162 struct ucode_cpu_info *uci = ucode_cpu_info + cpu_num;
163 struct microcode_amd *mc_amd = uci->mc;
165 /* We should bind the task to the CPU */
166 BUG_ON(cpu_num != cpu);
171 wrmsrl(MSR_AMD64_PATCH_LOADER, (u64)(long)&mc_amd->hdr.data_code);
172 /* get patch id after patching */
173 rdmsr(MSR_AMD64_PATCH_LEVEL, rev, dummy);
175 /* check current patch id and patch's id for match */
176 if (rev != mc_amd->hdr.patch_id) {
177 printk(KERN_ERR "microcode: CPU%d: update failed "
178 "(for patch_level=0x%x)\n", cpu, mc_amd->hdr.patch_id);
182 printk(KERN_INFO "microcode: CPU%d: updated (new patch_level=0x%x)\n",
185 uci->cpu_sig.rev = rev;
190 static int get_ucode_data(void *to, const u8 *from, size_t n)
197 get_next_ucode(int cpu, const u8 *buf, unsigned int size, unsigned int *mc_size)
199 unsigned int actual_size = 0;
200 u8 section_hdr[UCODE_CONTAINER_SECTION_HDR];
203 if (get_ucode_data(section_hdr, buf, UCODE_CONTAINER_SECTION_HDR))
206 if (section_hdr[0] != UCODE_UCODE_TYPE) {
207 printk(KERN_ERR "microcode: error: invalid type field in "
208 "container file section header\n");
212 actual_size = verify_ucode_size(cpu, buf, size);
216 mc = vmalloc(actual_size);
220 memset(mc, 0, actual_size);
221 get_ucode_data(mc, buf + UCODE_CONTAINER_SECTION_HDR, actual_size);
222 *mc_size = actual_size + UCODE_CONTAINER_SECTION_HDR;
227 static int install_equiv_cpu_table(const u8 *buf)
229 u8 *container_hdr[UCODE_CONTAINER_HEADER_SIZE];
230 unsigned int *buf_pos = (unsigned int *)container_hdr;
233 if (get_ucode_data(&container_hdr, buf, UCODE_CONTAINER_HEADER_SIZE))
238 if (buf_pos[1] != UCODE_EQUIV_CPU_TABLE_TYPE || !size) {
239 printk(KERN_ERR "microcode: error: invalid type field in "
240 "container file section header\n");
244 equiv_cpu_table = (struct equiv_cpu_entry *) vmalloc(size);
245 if (!equiv_cpu_table) {
246 printk(KERN_ERR "microcode: failed to allocate "
247 "equivalent CPU table\n");
251 buf += UCODE_CONTAINER_HEADER_SIZE;
252 if (get_ucode_data(equiv_cpu_table, buf, size)) {
253 vfree(equiv_cpu_table);
257 return size + UCODE_CONTAINER_HEADER_SIZE; /* add header length */
260 static void free_equiv_cpu_table(void)
262 vfree(equiv_cpu_table);
263 equiv_cpu_table = NULL;
266 static enum ucode_state
267 generic_load_microcode(int cpu, const u8 *data, size_t size)
269 struct ucode_cpu_info *uci = ucode_cpu_info + cpu;
270 const u8 *ucode_ptr = data;
273 int new_rev = uci->cpu_sig.rev;
274 unsigned int leftover;
275 unsigned long offset;
276 enum ucode_state state = UCODE_OK;
278 offset = install_equiv_cpu_table(ucode_ptr);
280 printk(KERN_ERR "microcode: failed to create "
281 "equivalent cpu table\n");
286 leftover = size - offset;
289 unsigned int uninitialized_var(mc_size);
290 struct microcode_header_amd *mc_header;
292 mc = get_next_ucode(cpu, ucode_ptr, leftover, &mc_size);
296 mc_header = (struct microcode_header_amd *)mc;
297 if (get_matching_microcode(cpu, mc, new_rev)) {
299 new_rev = mc_header->patch_id;
304 ucode_ptr += mc_size;
312 pr_debug("microcode: CPU%d found a matching microcode "
313 "update with version 0x%x (current=0x%x)\n",
314 cpu, new_rev, uci->cpu_sig.rev);
320 state = UCODE_NFOUND;
322 free_equiv_cpu_table();
327 static enum ucode_state request_microcode_fw(int cpu, struct device *device)
329 const char *fw_name = "amd-ucode/microcode_amd.bin";
330 const struct firmware *firmware;
331 enum ucode_state ret;
333 if (request_firmware(&firmware, fw_name, device)) {
334 printk(KERN_ERR "microcode: failed to load file %s\n", fw_name);
338 if (*(u32 *)firmware->data != UCODE_MAGIC) {
339 printk(KERN_ERR "microcode: invalid UCODE_MAGIC (0x%08x)\n",
340 *(u32 *)firmware->data);
344 ret = generic_load_microcode(cpu, firmware->data, firmware->size);
346 release_firmware(firmware);
351 static enum ucode_state
352 request_microcode_user(int cpu, const void __user *buf, size_t size)
354 printk(KERN_INFO "microcode: AMD microcode update via "
355 "/dev/cpu/microcode not supported\n");
359 static void microcode_fini_cpu_amd(int cpu)
361 struct ucode_cpu_info *uci = ucode_cpu_info + cpu;
367 static struct microcode_ops microcode_amd_ops = {
368 .request_microcode_user = request_microcode_user,
369 .request_microcode_fw = request_microcode_fw,
370 .collect_cpu_info = collect_cpu_info_amd,
371 .apply_microcode = apply_microcode_amd,
372 .microcode_fini_cpu = microcode_fini_cpu_amd,
375 struct microcode_ops * __init init_amd_microcode(void)
377 return µcode_amd_ops;