Printing To Screen: Difference between revisions

!! Basics

Working on the assumption that you are in protected mode and not using the BIOS to do screen writes, you will have to do screen writes direct to "video" memory yourself.

This is quite easy to do, the text screen video memory for colour monitors resides at =0xB8000=, and for monochrome monitors it is at address =0xB0000=.

Text mode memory takes two bytes for every "character" on the screen. One is the _ASCII code_ byte and the other the _attribute_ byte. so =~HeLlo= is stored as

The _attribute_ byte carries the _foreground colour_ in its lowest 4 bits and the _background color_ in its highest 3 bits. The bit #7 's interpretation depends on how you (or the BIOS) configured the hardware (see VgaResources for additionnal info).

For instance, using =0x00= as attribute means black-on-black (you'll see nothing). =0x07= is lightgrey-on-black (dos default), =0x1F= is white-on-blue (Win9x's blue-screen-of-death), =0x2a= is for green-monochrome nostalgics :P

When you print to any other page than 0, it will _not_ appear on screen until that page is _enabled_ or "copied" into the page 0 memory space.

!! Writing strings

<verbatim>

/* note this example will always write to the top

line of the screen */

void write_string(int colour, char *string)

char *video=(char*)0xB8000;

while(*string!=0)

{

*video=*string;

string++;

video++;

*video=colour;

video++;

}

</verbatim>

!! Okay for strings, but how do i print numbers ?

<verbatim>

</verbatim>

!! How do i print formatted messages (a la printf) ?

If you're working with C, you may want to print any number of arguments and you may have looked at the stdarg.h file from other Operating Systems (e.g. linux 0.1 and Thix 0.3.x). These macro definitions may be a bit weird to understand as they're basically C voodoo using pointers and casts and sizeof. Beware before porting them to 16 bits system, though.

va_start() points to the first variable argument.

va_arg() advances the pointer, then evaluates to the previous argument (comma operator).

va_end() doesn't do anything.

E.g. to implement =va_start()=, you extract the address of the last 'known' argument and advance (yes, it's a =+= since you're rewinding the stack) to the next stack item. The voodoo comes to the fact that things are automatically aligned on 32bits boundary on the stack, even if just 1 byte. Under gcc, the =_~_builtin_next_arg()= function may help you. Versions 3.x even seem to have =_~_builtin_va_start()=, =_~_builtin_va_end()= and =_~_builtin_va_arg()= so no black magic is required at all.

=va_arg()= usually require a bit more black magic since you have two things to do:

- advance to the next item

- return the value of the (previously current) item.

You can get [stdarg.h|http://www.execpc.com/~~geezer/osd/code/inc/stdarg.h], [_printf.h|http://www.execpc.com/~~geezer/osd/code/inc/_printf.h] and [doprintf.c|http://www.execpc.com/~~geezer/osd/code/tinylib/stdio/doprintf.c] from geezer/osd. It seems a spider ate Geezers website, [here's a mirror from archive.org|

http://web.archive.org/web/20050212051530/my.execpc.com/~geezer/osd/index.htm].

!! Uh ? I get nothing displayed at all ...

Keep in mind that this way of writing to video memory will _only_ work if the screen has been correctly set up for 80x25 video mode (which is mode 03). You can do this either by initializing every VGA register manually or by calling the Set Video Mode service of the BIOS Int10h while you're still in real mode (in your bootsector, for instance). Most BIOSes does that initialization for you, but some other (mainly on laptops) do not. Check out [Ralf Browns Interrupt List | http://www.ctyme.com/rbrown.htm] for details. Note also that some modes that are reported as "both text&graphic" by mode lists are actually graphic modes with BIOS functions that plot fonts when you call char/message output through Int10h (which means you'll end up with plain graphic mode once in ProtectedMode)

----

Categories: HowTo, HardWareVga

! Can you print in real mode ?

While still in RealMode, try to write directly to Video memory. If this doesn't work either you haven't set up the Video mode properly to 0x03 (check out [RBIL]) or you're assuming the wrong video memory address (=0xb8000= instead of =0xb0000=)

! Can you print a single character ?

While in ProtectedMode, try a simple command like

<verbatim>

*((int*)0xb8000)=0x07690748;

</verbatim>

<verbatim>

mov [0xb8000], 0x07690748

</verbatim>

<verbatim>

movl $0x07690748,0xb8000

</verbatim>

! Can you find your string in the kernel image ?

That may sound stupid, but it's a common mistake to forget the =.rodata= section in the linker script. =-fwritable-strings= can be a substitute, but still if you had

kprint("Hello World");