Unreal Mode: Difference between revisions

3,151 bytes added ,  26 days ago
m
Bot: Replace deprecated source tag with syntaxhighlight
[unchecked revision][unchecked revision]
mNo edit summary
m (Bot: Replace deprecated source tag with syntaxhighlight)
 
(23 intermediate revisions by 13 users not shown)
Line 1:
'''Unreal mode''' consistconsists of breaking the '64Kb'64KiB limit of real mode segments, but(while still keepingretaining 16-bit bits instructioninstructions and the <tt>segment * 16 + offset</tt> addressaddressing formationmode) by tweaking the [[Descriptor Cache|descriptor caches]].
 
==Usage==
Unreal mode is usually recommended in the two following cases :
* youYou're trying to extend a legacy 16-bitsbit DOS program so that it can deal with larger data and neither vm86[[Virtual 8086 Mode]], nor xms isare suitable for your needs.
* youYou're trying to load something that will run in 32 bits-bit mode and which is larger than 640Kb640K (sotherefore you cannot load it in conventional memory) and you don't want to bother withwriting a protected mode disk driver called from pmode yet, andbut you doalso notwant wishto toavoid switchswitching between real and protected mode forto copyingcopy chunks from the conventional memory buffer tointo the highextended memory areas ...
 
You still will not have full access to all physical RAM if you do not have have the [[A20 Line]] enabled; all the "odd" 1-megabyte MiB blocks will be unavailable.
 
==Implementation==
To do this, you need to set the descriptor cache's limits for your segment register(s) to any value higher than 64KiB (usually a full 4GiB (<tt>0xffffffff</tt>)).
The reason for doing this is to enable 32-bit offsets in real mode. However, you won't be able to go past 1 meg quite yet.
 
In protected mode, the bits 3-15 in the segment registerregisters arerepresent an index into [[GDT|the global descriptor table]]. That's why in thisthe following code 0x08 = 1000b gets you theentry #1 (entry #0 is ALWAYS a null descriptor).
 
When this(in protected mode) a segment register givenis loaded with a "selector", a "segment descriptor cache register" is filled with the descriptor's values, including the size (or limit). After the switch back to real mode, these values are not modified, regardless of what value is in the 16-bit segment register. So the 64k64KiB limit is no longer valid and 32-bit offsets can be used within theReal real-modeMode addressingto rulesactually (i.e.access shiftareas above 64KiB (<tt>segment 4* bits,16 then+ add32-bit offset</tt>).
 
===Big Unreal Mode===
Finally, note that IP is unaffected by all this, so the code itself is still limited to 64k.
This won't touch CS. <br />
Finally, note thatTherefore IP is unaffected by all this, soand the code itself is still limited to 64k64KiB.
 
<sourcesyntaxhighlight lang="asm">
; Assembly example
 
; nasmwnasm boot.asm -o boot.bin
; partcopy boot.bin 0 200 -f0
 
[ORG 0x7c00] ; add to offsets
 
start:
start: xor ax, ax ; make it zero
xor ax, ax ; make it zero
mov ds, ax ; DS=0
mov ss, ax ; stack starts at seg 0
Line 39 ⟶ 42:
or al,1 ; set pmode bit
mov cr0, eax
jmp 0x8:pmode
 
pmode:
mov bx, 0x08 ; select descriptor 1
mov dsbx, bx 0x10 ; 8hselect =descriptor 1000b2
mov ds, bx ; 10h = 10000b
 
and al,0xFE ; back to realmode
mov cr0, eax ; by toggling bit again
jmp 0x0:unreal
 
unreal:
pop ds ; get back old segment
sti
Line 54 ⟶ 61:
 
jmp $ ; loop forever
 
gdtinfo:
dw gdt_end - gdt - 1 ;last byte in table
dd gdt ;start of table
 
gdt: dd 0,0 ; entry 0 is always unused
codedesc: db 0xff, 0xff, 0, 0, 0, 10011010b, 00000000b, 0
flatdesc: db 0xff, 0xff, 0, 0, 0, 10010010b, 11001111b, 0
gdt_end:
 
times 510-($-$$) db 0 ; fill sector w/ 0's
dw 0xAA55 ; Required by some BIOSes
</syntaxhighlight>
 
===Huge Unreal Mode===
Huge Unreal Mode enables code over 64KiB. However, it is more difficult to implement as real mode interrupts do not automatically save the high 16 bits of EIP. Initialization is simple though, you just load a code segment with a 4GiB limit:
 
<syntaxhighlight lang="asm">
; Assembly example
 
; nasm boot.asm -o boot.bin
; partcopy boot.bin 0 200 -f0
 
ORG 0x7c00 ; add to offsets
 
start: xor ax, ax ; make it zero
 
... ; As before
 
mov cr0, eax
jmp 0x8:pmode
pmode:
mov bx, 0x080x10 ; select descriptor 2, instead of 1
mov ds, bx ; 10h = 10000b
 
and al,0xFE ; back to realmode
mov cr0, eax ; by toggling bit again
jmp 0x0:huge_unreal
huge_unreal:
 
... ;As before
 
gdtinfo:
Line 60 ⟶ 108:
 
gdt dd 0,0 ; entry 0 is always unused
flatdescflatcode db 0xff, 0xff, 0, 0, 0, 10010010b10011010b, 11001111b10001111b, 0
flatdata db 0xff, 0xff, 0, 0, 0, 10010010b, 11001111b, 0
gdt_end:
 
times 510-($-$$) db 0 ; fill sector w/ 0's
db 0x55 dw 0xAA55 ; req'dRequired by some BIOSes
</syntaxhighlight>
db 0xAA
 
</source>
WARNING: this may not work on some emulators or some hardware.
 
==Compiler Support==
===Smaller C===
The [[Smaller C]] compiler supports unreal mode. It produces [[MZ]] executables for unreal mode (can be loaded with [[BootProg]]).
 
The code and the stack are to be located below the 1MB mark and the stack size is limited by 64KB (IOW, there's nothing unusual about CS:(E)IP, SS:(E)SP, it's a natural setup for MZ executables in DOS). The DS and ES segment registers are set to 0, so C pointers can work as flat 32-bit physical addresses and address data or memory-mapped devices anywhere in the first 4GB of memory.
 
The startup code of these executables performs the necessary relocation (there are only custom relocations and no standard MZ relocations, which may simplify loading of the executables) and sets up unreal mode before passing control to the equivalent of ''main()''. See ''srclib/c0du.asm'' and other C/assembly code under ''srclib'' in the compiler source tree for how to write bits of assembly code for unreal mode (look for ''asm("inline asm code")'' under ''#ifdef __UNREAL__'').
 
You can try out unreal mode in DOS (e.g. in DOSBox, VirtualBox + FreeDOS) as the compiler fully supports the DOS + unreal mode combo in its C library. ''tests/vesalfb.c'' is a simple example of setting up a [[VESA]] graphics mode with the linear frame buffer enabled and drawing something on the screen in unreal mode.
 
For an example of an Unreal Mode [[bootloader]] implementation with Smaller C, look at [https://github.com/fysnet/FYSOS/tree/master/loader FYSOS].
[[Category:X86 CPU]]
[[Category:Operating Modes]]
[[Category:FAQ]]