Rawheds Tutorial#4:

    CPUID

    [Introduction]
    [CPUID Intro]
    [EFLAGS To Detect CPUID]
    [Returned Data - Standard Level 0]
    [Returned Data - Standard Level 1]
    [Returned Data - Standard Level 2+3]
    [Returned Data - Extended Level 0]
    [Returned Data - Extended Level 1]
    [Returned Data - Extended Level 2+3+4]
    [Returned Data - Extended Level 5]
    [Returned Data - Extended Level 6]
    [Quick Example]
    [Closing Words]

---==[Introduction]==---------------------------------------------------------

Ever needed to know what processor your program/demo was running on? I did. After looking at these lengthy hacks people wrote long ago(before the CPUID instruction) to identifty rudimentary processor information, I was very glad when I did stumble into CPUID. I didn't touch the instruction for months as I didn't know how to use it, thought that all it did was output 1 for p5, 2 for p6, 3 for ppro etc. Hehe, luckily thats NOT the case! :)

So here I am, a little wiser, about to tell you about this actually quite cool instruction. Some of you might be wondering why a demo would be wanting to know what processor its running on? I'm not sure. But initially I thought it would be really cool for the demo to show specs about the machine it was running on, just before the demo began. Now that I think about it, that was a rather silly reason. Later on(after my cousin got his AMD machine), I wanted to create a demo which had 3DNow! and MMX support. So I needed the CPUID instruction to identify whether the chip could handle MMX/3DNow!.

Sofar my MMX and 3DNow! enabled demo is going very well, and I'll probably write a tutorial about it soon. I'd like to see some more demos which support these technologies, as they are actually quite good. MMX didn't recieve a HUGE round of applause when it was released - even I thought it was just another one of Intels gimmicks - but actually(surprisingly) after coding it a bit, I've found it to be actually very cool. So anyways, enough jaw-gyration - here is how its all done :)

---==[CPUID Intro]==--------------------------------------------------------

CPUID is an assembler instruction, just like MOV or ADD is. It was implimented from late 486's and up. With cool new assemblers like NASM you can just type the instruction in straight, but with others you'll have to use the opcode which is: 0fh, 0a2h (two bytes).

            Instruction:CPUID
            Description:Used to return information about the processor type, family
                        model and many other things.  The ammount of information
                        that this instruction can return is growing all the time.
                        Chip features can be returned, even L1/L2/L3(even) cache
                        sizes.
            Input:      Set EAX to the relivant level number.
            Output:     Varies according to which level number you ask it for.
            Example:    mov   eax, 1
                        CPUID

---==[EFLAGS To Detect CPUID]==-----------------------------------------------

The first step is to check whether the computer actually supports the CPUID instruction! This can be done by looking at the EFLAGS register. Only 32bit processors support the EFLAGS register. EFLAGS is just the 32bit version of the 16bit FLAGS register :) The EFLAGS register is a 32bit number, and each number is either set/unset(1/0) for certain things. Lets have a look:
(Remember 16bit machines will only have the 1st 16bits).
(Remember you won't need most of this - its mostly for interests sake :)
-----------------------------
Bit 00 : Carry flag
Bit 01 : Always 1
Bit 02 : Parity flag
Bit 03 : Always 0
Bit 04 : Auxilary Carry flag
Bit 05 : Always 0
Bit 06 : Zero flag
Bit 07 : Sign flag
Bit 08 : Trap flag
Bit 09 : Interupt flag
Bit 10 : Direction flag
Bit 11 : Overflow flag
Bit 12 : I/O Privelage level
Bit 13 : I/O Privelage level
Bit 14 : Nested Task flag
Bit 15 : Always 0
-----------------------------
Bit 16 : Resume flag
Bit 17 : Virtual Mode flag
Bit 18 : Alignment Check flag
Bit 19 : Virtual Interupt flag
Bit 20 : Virtual Interrupt Pending flag
Bit 21 : Identification flag
Bit 21->31 : Unspecified, so 0
-----------------------------

All we are interested in is Bit 21, the ID flag. But how do we get it??? Lets consult our good ol' Intel.doc file we have lying in PCGPE.

PUSHF/PUSHFD - Push Flags onto Stack

            Usage:  PUSHF
                    PUSHFD  (386+)
            Modifies flags: None

            Transfers the Flags Register onto the stack.  PUSHF saves a 16 bit
            value while PUSHFD saves a 32 bit value.

                                     Clocks                 Size
            Operands         808x  286   386   486          Bytes

            none            10/14   3     4     4             1
            none  (PM)        -     -     4     3             1

Cool! There you go.
One thing interesting is that PUSHF and PUSHFD both have the same opcode, but its surposed to figure out if its to parse 16bit/32bit depending on the destination operand. So here is how we would test for Bit 21:

            NOTE!  Some processors support the CPUID instr, but you have
            to turn the feature on, so this code tries to turn Bit 21 on
            and if successful, then CPUID works.

                   ;cpuid supported?
                    pushfd                  ;push the flags onto the stack
                    pop eax                 ;pop them back out, into EAX
                    mov ebx, eax            ;keep original
                    xor eax, 00200000h      ;turn bit 21 on.
                    push eax                ;put altered EAX on stack
                    popfd                   ;pop stack into flags
                    pushfd                  ;push flags back onto stack
                    pop eax                 ;put them back into EAX
                    cmp eax, ebx
                    jnz @CPUID_SUPPORTED    ;COOL!!
                    ;blah	                ;booo
                    @CPUID_SUPPORTED:

---==[Returned Data - Standard Level 0]==-------------------------------------

There are many levels that CPUID works at. You need to set these levels by setting EAX to the level number you want info about. New levels are being added to the CPUID instruction all the time, so I'll just introduct the most common and useful ones. There are also 2 types of levels: standard levels and extended levels. Standard levels go from 0 --> 7FFFFFFFh and extended goes from 8000000h --> FFFFFFFFh.

            EAX=0

            Output:	[EAX] - Maxiumum supported standard level
                    [EBX-EDX-ECX] - CPU vendor ID string

The maximum supported standard level is the maxiumum level you can take EAX up to in the CPUID instruction, supported by the current CPU. The CPU vendor string is really neat. Concatinate(join) EBX, EDX and ECX reading them as strings. This should return either:

                    GenuineIntel    (Intel processor)
                    UMC UMC UMC     (UMC processor)
                    AuthenticAMD    (AMD processor)
                    CyrixInstead    (Cyrix processor)
                    NexGenDriven    (NexGen processor)
                    CentaurHauls    (Centaur/IDT processor)
                    RiseRiseRise    (Rise Technology processor)

So thats how you find out what make the chipset is. Apparently in some of the earlier implimentations of CPUID, you were able to change the value of the vendor ID string. This resulted in companies changing a lot of "CyrixInstead" to "GenuineIntel" :)

---==[Returned Data - Standard Level 1]==-------------------------------------

Now its time to get more details on the CPU. On level 1 we can find out if the CPU is a primary/secondard processor, what family it is, its model, and its stepping values. We can also find out what CPU features it supports, such as MMX, 3DNow! and a ton more.

           EAX=1

           Output:	[EAX] - Processor type/family/model/stepping
                    [EDX] - CPU "Feature flags"

For EAX, only the 1st 16bits are used, so its really AX that you need to use. Its structured like this:

            EAX     FEDCBA9876543210
                    00TTFFFFMMMMSSSS

                    T - Processor type(2bits)
                    F - Processor family(4bits)
                    M - Processor model(4bits)
                    S - Processor stepping(4bits)
    Processor type:
            11b = reserved
            10b = secondary processor (for MultiProcessing)
            01b = Overdrive processor
            00b = primary processor

    Processor family:
            4 = most 80486s, AMD 5x86, Cyrix 5x86
            5 = Intel P5, P54C, P55C, P24T
                NexGen Nx586, Cyrix M1
                AMD K5, K6, Centaur/IDT C6, C2
                Rise mP6
            6 = Intel P6, P2, P3, Cyrix M2

This family data may seem messy(and it is), but things are made easier when you combine this information with the VENDOR ID returned from level 0. And again this cummulative data must be combined to use the value returned in the "processor model" properly.

    Processor model:
            Intel 80486     0 i80486DX-25/33
                            1 i80486DX-50
                            2 i80486SX
                            3 i80486DX2
                            4 i80486SL
                            5 i80486SX2
                            7 i80486DX2WB
                            8 i80486DX4
                            9 i80486DX4WB

            UMC 80486       1 U5D
                            2 U5S

            AMD 80486       3 80486DX2
                            7 80486DX2WB
                            8 80486DX4
                            9 80486DX4WB
                            E 5x86
                            F 5x86WB

            Cyrix 5x86      9 5x86

            Cyrix MediaGX   4 GX, GXm

            Intel P5-core   0 P5 A-step
                            1 P5
                            2 P54C
                            3 P24T Overdrive
                            4 P55C
                            7 P54C
                            8 P55C (0.25µm)

            NexGen Nx586    0 Nx586 or Nx586FPU (only later ones)

            Cyrix M1        2 6x86

            Cyrix M2        0 6x86MX

            AMD K5          0 SSA5 (PR75, PR90, PR100)
                            1 5k86 (PR120, PR133)
                            2 5k86 (PR166)
                            3 5k86 (PR200)

            AMD K6          6 K6 (0.30 µm)
                            7 K6 (0.25 µm)
                            8 K6-2
                            9 K6-III

            Centaur/IDT     4 C6
                            8 C2

            Rise            0 mP6

            Intel P6-core   0 P6 A-step
                            1 P6
                            3 P2 (0.28 µm)
                            5 P2 (0.25µm)
                            6 P2 with on-die L2 cache
                            7 P3

This list is NOT complete, for a better one, check INTEL/AMD/CYRIX.

EDX contains 32bits, each one a flag indicating what features the chip supported. For my program I just used it to see if MMX was supported, then I just counted up the features and displayed how many features the chip had.

    EDX bit 00 - FPU on-chip
        bit 01 - Virtual mode extension (V86 Mode Extensions)
        bit 02 - Debugging extension
        bit 03 - Page size extension (4 MB pages)
        bit 04 - Time stamp counter and RDTSC instruction
        bit 05 - RDMSR / WRMSR instructions
        bit 06 - Physical address extension (36-bit address, 2MB pages)
        bit 07 - Machine check exception
        bit 08 - CMPXCHG8B instruction
        bit 09 - On-chip APIC hardware (multiprocesssor operation support)
        bit 10 - undefined
        bit 11 - SYSENTER / SYSEXIT instructions
        bit 12 - Memory type range registers
        bit 13 - Page global enable
        bit 14 - Machine check architecture
        bit 15 - Conditional move instruction(CMOV)
        bit 16 - Page attribute table
        bit 17 - 36 bit Page Size Extenions
        bit 18 - undefined
        bit 19 - undefined
        bit 20 - undefined
        bit 21 - undefined
        bit 22 - undefined
        bit 23 - MMX instructions
        bit 24 - Fast FPU save and restore   (FXSAVE and FXRSTOR)
        bit 25 - SSE, MXCSR, CR4.OSXMMEXCPT, #XF
        bit 26 - undefined
        bit 27 - undefined
        bit 28 - undefined
        bit 29 - undefined
        bit 30 - undefined
        bit 31 - undefined

I'm not sure what most of the above means, although I'd love to know. Anybody know?

---==[Returned Data - Standard Level 2 and 3]==-----------------------------------

I'm not gonna talk much about levels 2 and 3 because my processor doesn't support them so I havn't tested them :)

Basically level 2 allows you to get details on the processor CACHE(L1 and L2). Level 3 allows you to get the processors SERIAL number(if it has one). I wanna find out how to disable serial number on the PIII's.

Visit www.sandpile.org for more info on these levels.

---==[Returned Data - Extended Level 0]==-------------------------------------

AMD introduced extended level for the CPUID instruction. The extended level is not supported by all processors, but is definately supported by:

            AMD K6, K6-2
            Cyrix (starting with GXm - a successor of MediaGX, but not on MII)
            IDT C6-2.

I'm not sure why this extended level was made, but level 0 starts with EAX= 80000000h, and so level 1 would be 80000001h.

Not all CPU's support this extended level, so you need to test if its supported. Its easy though. Just let EAX=80000000h, call CPUID and test the retured EAX value. If EAX >= 80000000h then the extended level is supported.

This is works because, just like standard level 0, EAX = the maximum supported level. EBX, ECX and EDX return (just like standard level 0) the Vendor ID of the processor. There is a lot of fields which are duplicated in the extended levels from the standard levels. I think it is because the details for things such as VendorID, cpu model, family, type etc had been fulled in the standard level so newer device details are stored in the extended level. But I'm not sure about this.

            EAX=80000000h

            Output:	[EAX] - Maximum extended level supported
                    [EBX-EDX-ECX] - VendorID

---==[Returned Data - Extended Level 1]==-------------------------------------

Here again, its VERY similar to the standard level 1. Although again its still different. For instance to detect for 3DNow!, you can only use extended level 1.

            EAX=80000001h

            Output:	[EAX] - Processor family/model/stepping
                    [EDX] - CPU "Feature flags"

            EAX     FEDCBA9876543210
                    0000FFFFMMMMSSSS

                    F - Processor family(4bits)
                    M - Processor model(4bits)
                    S - Processor stepping(4bits)

    Processor family:
            5 = AMD K5, Centaur/IDT C2
            6 = AMD K6

    Processor model:
            AMD K5          1 = 5k86 (PR120 or PR133)
                            2 = 5k86 (PR166)
                            3 = 5k86 (PR200)

            AMD K6          6 = K6 (0.30 µm)
                            7 = K6 (0.25 µm)
                            8 = K6-2
                            9 = K6-III

            Centaur/IDT     8 = C2

Most of the details in the extended features flag is the same, here are some main differences:

    EDX bit 15 - Integer conditional move instruction(CMOV)
        bit 16 - FPU conditional move instruction(FCMOV)
        bit 24 - Cyrix Extended MMX
        bit 31 - 3DNow!

---==[Returned Data - Extended Level 2 and 3 and 4]==---------------------------------

Cool, here is something very different from the standard level. These 3 levels are used in conjunction with eachother to return an ASCII string name of the processor. This sort of kills all those standard levels before which were a pain in the butt to use to find the processor type, family, model etc. But not all processors support this instruction.

            EAX=80000002h

            Output:	[EAX] - Processors name string 01
                    [EBX] - Processors name string 02
                    [ECX] - Processors name string 03
                    [EDX] - Processors name string 04

            EAX=80000003h

            Output:	[EAX] - Processors name string 05
                    [EBX] - Processors name string 06
                    [ECX] - Processors name string 07
                    [EDX] - Processors name string 08

            EAX=80000004h

            Output:	[EAX] - Processors name string 09
                    [EBX] - Processors name string 10
                    [ECX] - Processors name string 11
                    [EDX] - Processors name string 12

Just concatinate all the values to form a 48character string. If the string doesn't use all 48characters, it just fills the rest of the space with NULL (zero) values. Some examples of strings are:
"AMD-K6tm w/ multimedia extensions", "AMD K6-2 AMD-K6(tm) 3D processor" "AMD-K6(tm)-III Processor", "IDT WinChip 2-3D".

---==[Returned Data - Extended Level 5]==-------------------------------------

This level is cool, it returns data about your level1 cache. Unfortunately Cyrix doesn't adhere to its return value format, so you have to write a special function for the cyrix ext level 5. Or just leave this level out if a cyrix is detected :)
Here is how everybody else (except Cyrix) handle things:

            EAX=80000005h

            Output:	[EBX] - TLB data
                    [ECX] - L1 DATA Cache data
                    [EDX] - L1 CODE Cache data

            EBX bits 31..24 DATA TLB associativity (FFh=full)
                     23..16 DATA TLB entries
                     15..08 CODE TLB associativity (FFh=full)
                     07..00 CODE TLB entries

            ECX bits 31..24 DATA L1 cache size in KBs
                     23..16 DATA L1 cache associativity (FFh=full)
                     15..08 DATA L1 cache lines per tag
                     07..00 DATA L1 cache line size in bytes

            EDX bits 31..24 CODE L1 cache size in KBs
                     23..16 CODE L1 cache associativity (FFh=full)
                     15..08 CODE L1 cache lines per tag
                     07..00 CODE L1 cache line size in bytes

Quite handy don't you think? :)

---==[Returned Data - Extended Level 6]==-------------------------------------

This level is very cool, returns data about your level2 cache!

            EAX=80000006h

            Output:	[ECX] - L2 Cache data

            ECX bits 31..16 L2 cache size in KBs
                     15..12 L2 cache associativity (Fh=full)
                     11..08 L2 cache lines per tag
                     07..00 L2 cache line size in bytes

---==[Quick Example]==--------------------------------------------------------

Some quick very simple code, just to get you going:

    struct {
            long max_std_lvl;      //maximum standard level supported
            char vendorID[13];     //13th for NULL char
            char mmx;              //MMX supported?
            char _3dnow;           //3DNow! supported?
            long max_ext_lvl;      //maximum exteneded level supported
            };

            mov edi,[ptr_to_cputable]

    ;Get VendorID

            mov eax,0
            CPUID                     ;CPUID!
            mov [edi+0],eax           ;max standard level supported
            add edi,4
            mov [edi+0],ebx
            mov [edi+4],edx
            mov [edi+8],ecx
            mov [edi+12],byte 0       ;vendor ID string+padding

            add edi,16

    ;Check for MMX

            mov EAX,1
            CPUID
            mov ebx,edx
            and ebx,0x800000
            shr ebx,23
            mov [edi+0],bl            ;MMX support?

            add edi,1

    ;Check for 3DNow!

            mov [edi+0],byte 0
            mov eax, 0x80000001       ;extended level 1
            CPUID
            test edx, 0x80000000
            jz @no_3dnow
            mov [edi+0],byte 1        ; 3DNow! technology supported
            @no_3dnow:

            add edi,1

    ;Check maximum extended levels

            mov eax, 0x80000000
            CPUID
            mov [edi+0],eax

---==[Closing Words]==--------------------------------------------------------

The CPUID instruction is growing all the time, so the ammount of information you can extract from it is increasing! You can get seriously low-down-'n-dirty details about the CPU. For more information check out: www.sandpile.org

-Rawhed/Sensory Overload
-Mailto:sfeist@netactive.co.za
-Htpp://www.surf.to/demos/
-Andrew Griffiths
-South Africa
-10-07-1999