Emulating the XO/Quick Start

From OLPC
< Emulating the XO
Revision as of 19:24, 13 December 2007 by Ohm (talk | contribs) (Swapped first two steps for avoiding duplicate image download.)
Jump to navigation Jump to search
  english | español | 日本語 | português | 中文 HowTo [ID# 84459]  +/-  

This page will help you get a look at the XO software, by running a "virtual XO" in an emulator. Another option is burning a LiveCd.

What to expect

This "virtual XO" was created as a software development tool. It is not intended for general use, and many things will not work. It is "just to get a taste" (and to help software developers). With time and people constraints, we are focused on the real XO.

  • The camera and video will not work.
  • Things are slower than on the actual machine. If you are unable to install qemu's kqemu accelerator, very much slower.
  • You will see a snapshot of the past. The instructions will have you download the "latest stable build", which is sometimes quite a few weeks old. Development is very rapid. Things will be missing or different compared with the present.
  • While rapidly maturing, this is still "alpha" software.
  • TamTam, the popular music program, will likely not work (no sound).

Four steps

First, get the qemu emulator which will run the image:

Second, download olpc-redhat-stream-development-devel_ext3.img.bz2. It is in this directory.

Third, extract the .img file from the .bz2 file.

Fourth, run:

  qemu -m 256 -kernel-kqemu -soundhw es1370 -net user -net nic,model=rtl8139 -hda olpc-redhat-stream-development-devel_ext3.img

If qemu responds with an error like "qemu: could not load PC bios '/c/Program Files/Qemu/bios.bin'" then you may have to use qemu's -L option to specify the directory where you installed qemu, which contains the bios.bin file. If you're using a 64 bit processor, you need to run the command 'qemu-system-x86_64' instead of 'qemu'.

Note that qemu by default gives 128 MB RAM, but according to Hardware_specification recent XO HW have 256 MB, that's why the "-m 256". To test for early XO HW (or later with more), change the -m param. Giving 256 MB RAM appears to have a noticeable effect on speed in the emulator (as I'm sure in the real HW ;)).

You should now have a running "virtual XO".

Running for the first time

Sugar Instructions will help you get oriented, though you may not need it.

Note: when you see the X with the circle on top it is running OK. Enter you name and move the cursor to one of the corners to see the menus of sugar. I would like to see a right click bring up a menu bar (in addition)

You can also get other Help and tips on emulating Sugar.

When running under emulation, the sugar fonts will appear very tiny until you set the screen to 200 dpi.