ucode.h

Go to the documentation of this file.

#ifndef _IPXE_UCODE_H
#define _IPXE_UCODE_H
 
/** @file
 *
 * Microcode updates
 *
 */
 
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
 
#include <stdint.h>
#include <ipxe/mp.h>
 
/** Platform ID MSR */
#define MSR_PLATFORM_ID 0x00000017UL
 
/** Extract platform ID from MSR value */
#define MSR_PLATFORM_ID_VALUE( value ) ( ( (value) >> 50 ) & 0x7 )
 
/** Intel microcode load trigger MSR */
#define MSR_UCODE_TRIGGER_INTEL 0x00000079UL
 
/** AMD microcode load trigger MSR */
#define MSR_UCODE_TRIGGER_AMD 0xc0010020UL
 
/** CPUID signature applicability mask
 *
 * We assume that only steppings may vary between the boot CPU and any
 * application processors.
 */
#define UCODE_SIGNATURE_MASK 0xfffffff0UL
 
/** Minimum possible microcode version */
#define UCODE_VERSION_MIN -0x80000000L
 
/** Maximum possible microcode version */
#define UCODE_VERSION_MAX 0x7fffffffL
 
/** A microcode update control
 *
 * This must match the layout as used by the assembly code in
 * ucode_mp.S.
 */
struct ucode_control {
        /** Microcode descriptor list physical address */
        uint64_t desc;
        /** Microcode status array physical address */
        uint64_t status;
        /** Microcode load trigger MSR */
        uint32_t trigger_msr;
        /** Maximum expected APIC ID */
        uint32_t apic_max;
        /** Unexpected APIC ID
         *
         * Any application processor may set this to indicate that its
         * APIC ID was higher than the maximum expected APIC ID.
         */
        uint32_t apic_unexpected;
        /** APIC ID eligibility mask bits */
        uint32_t apic_mask;
        /** APIC ID eligibility test bits */
        uint32_t apic_test;
        /** Microcode version requires manual clear */
        uint8_t ver_clear;
        /** Microcode version is reported via high dword */
        uint8_t ver_high;
} __attribute__ (( packed ));
 
/** A microcode update descriptor
 *
 * This must match the layout as used by the assembly code in
 * ucode_mp.S.
 */
struct ucode_descriptor {
        /** CPUID signature (or 0 to terminate list) */
        uint32_t signature;
        /** Microcode version */
        int32_t version;
        /** Microcode physical address */
        uint64_t address;
} __attribute__ (( packed ));
 
/** A microcode update status report
 *
 * This must match the layout as used by the assembly code in
 * ucode_mp.S.
 */
struct ucode_status {
        /** CPU signature */
        uint32_t signature;
        /** APIC ID (for sanity checking) */
        uint32_t id;
        /** Initial microcode version */
        int32_t before;
        /** Final microcode version */
        int32_t after;
} __attribute__ (( packed ));
 
/** A microcode date */
struct ucode_date {
        /** Year (BCD) */
        uint8_t year;
        /** Century (BCD) */
        uint8_t century;
        /** Day (BCD) */
        uint8_t day;
        /** Month (BCD) */
        uint8_t month;
} __attribute__ (( packed ));
 
/** An Intel microcode update file header */
struct intel_ucode_header {
        /** Header version number */
        uint32_t hver;
        /** Microcode version */
        int32_t version;
        /** Date */
        struct ucode_date date;
        /** CPUID signature */
        uint32_t signature;
        /** Checksum */
        uint32_t checksum;
        /** Loader version */
        uint32_t lver;
        /** Supported platforms */
        uint32_t platforms;
        /** Microcode data size (or 0 to indicate 2000 bytes) */
        uint32_t data_len;
        /** Total size (or 0 to indicate 2048 bytes) */
        uint32_t len;
        /** Reserved */
        uint8_t reserved[12];
} __attribute__ (( packed ));
 
/** Intel microcode header version number */
#define INTEL_UCODE_HVER 0x00000001UL
 
/** Intel microcode loader version number */
#define INTEL_UCODE_LVER 0x00000001UL
 
/** Intel microcode default data length */
#define INTEL_UCODE_DATA_LEN 2000
 
/** Intel microcode file alignment */
#define INTEL_UCODE_ALIGN 1024
 
/** An Intel microcode update file extended header */
struct intel_ucode_ext_header {
        /** Extended signature count */
        uint32_t count;
        /** Extended checksum */
        uint32_t checksum;
        /** Reserved */
        uint8_t reserved[12];
} __attribute__ (( packed ));
 
/** An Intel microcode extended signature */
struct intel_ucode_ext {
        /** CPUID signature */
        uint32_t signature;
        /** Supported platforms */
        uint32_t platforms;
        /** Checksum */
        uint32_t checksum;
} __attribute__ (( packed ));
 
/** An AMD microcode update file header */
struct amd_ucode_header {
        /** Magic signature */
        uint32_t magic;
        /** Equivalence table type */
        uint32_t type;
        /** Equivalence table length */
        uint32_t len;
} __attribute__ (( packed ));
 
/** AMD microcode magic signature */
#define AMD_UCODE_MAGIC ( ( 'A' << 16 ) | ( 'M' << 8 ) | ( 'D' << 0 ) )
 
/** AMD microcode equivalence table type */
#define AMD_UCODE_EQUIV_TYPE 0x00000000UL
 
/** An AMD microcode equivalence table entry */
struct amd_ucode_equivalence {
        /** CPU signature */
        uint32_t signature;
        /** Reserved */
        uint8_t reserved_a[8];
        /** Equivalence ID */
        uint16_t id;
        /** Reserved */
        uint8_t reserved_b[2];
} __attribute__ (( packed ));
 
/** An AMD microcode patch header */
struct amd_ucode_patch_header {
        /** Patch type */
        uint32_t type;
        /** Patch length */
        uint32_t len;
} __attribute__ (( packed ));
 
/** An AMD microcode patch */
struct amd_ucode_patch {
        /** Date */
        struct ucode_date date;
        /** Microcode version */
        int32_t version;
        /** Reserved */
        uint8_t reserved_a[16];
        /** Equivalence ID */
        uint16_t id;
        /** Reserved */
        uint8_t reserved_b[14];
} __attribute__ (( packed ));
 
/** AMD patch type */
#define AMD_UCODE_PATCH_TYPE 0x00000001UL
 
extern mp_func_t ucode_update;
 
#endif /* _IPXE_UCODE_H */