Using QEMU on Windows

From OLPC
Revision as of 18:33, 7 October 2007 by Vorburger (talk | contribs) (-m 256)
Jump to navigation Jump to search
  english | español | francais | 日本語 | 한국어 | português HowTo [ID# 68966]  +/-  

Setting up QEMU

In order to use the provided OLPC images in your Windows XP box you must first install an emulator: QEMU which is an open-source processor emulator. The accelerator, not required, is recommended as a performance booster.

Note: people have converted some QEMU images to work with VMWare Player, but regular OLPC builds are for QEMU.

QEMU Emulator

  1. Download QEMU for Windows from here
  2. Since there's no installation step, just unzip it into any directory (ie: C:\Program Files\Qemu)
  3. if you want, proceed with the accelerator below, if not go to downloading the image

QEMU Accelerator

The QEMU Accelerator is a driver allowing the QEMU PC emulator to run much faster when emulating a PC on an x86 host. The latest stable is currently kqemu-1.3.0pre11.tar.gz.

  1. Download the QEMU Accelerator Module from here
  2. Unzip the kqemu-version.tar.gz file into a directory (ie: C:\Program Files\Qemu\KQemu-version)
    • may have to unzip it twice given the file format.
  3. In the target directory, locate kqemu.inf and install it (menu/right-click and select Install). Let it finish (it'll take just a couple of seconds).
  4. Open a command prompt (aka cmd.exe) and type
    • net start kqemu
    • If everything went fine, you should see the following message:
      • The KQEMU virtualisation module for QEMU service was started successfully.

Download an OLPC image

Then you need to download a drive image, so go to Latest Stable Build on the OS Images page and navigate to the ext3 subdirectory (this has images for the ext3 filesystem; if you want to use development tools, navigate to devel_ext3). The image you want will be named something like olpc-redhat-stream-development-build-num-date_ext3.img.bz2

After you've downloaded the image, you must unzip it (using a program that understands the bz2 format) and place the .img file in the same directory as QEMU (ie: C:\Program Files\Qemu).

Starting OLPC environment

Before you launch the emulated image, we strongly recommend reading through the Sugar Instructions on how to use the environment -- this does not look like the Windows or Mac operating systems!

Open a command prompt (aka cmd.exe) in the QEMU directory and launch qemu.exe using the appropriate image and "-L ." as first argument, and further arguments as explained on Emulating_the_XO/Quick_Start: (At the time of writing, the arguments are as shown below, but this can change/evolve, so please check the Quick Start page for the latest recommended arguments first!)

cd "\Program Files\Qemu"
qemu.exe -L . -m 256 -kernel-kqemu -soundhw es1370 -net user -net nic,model=rtl8139 -hda image_name

Where image_name is the newest version you have downloaded. For example:

qemu.exe -L . -m 256 -kernel-kqemu -soundhw es1370 -net user -net nic,model=rtl8139 -hda olpc-redhat-stream-development-build-185-20061117_2030-devel_ext3.img

The emulator will start in a new window, and will soon display the OLPC 'XO' logo and 'Booting OLPC for qemu target in nn seconds'. (If it does not, then press any key to go to the GRUB menu and choose the 'OLPC for qemu target' option. You need to boot the emulator, not the OLPC hardware.)

Then you will see a typical Linux boot sequence ending in a dialog asking for your nickname.

As a reminder: pressing Alt + Ctrl will liberate / return control to Windows.

NOTE: There are a some issues (mainly for the first timers) on how to get the whole enchilada going.

Closing the OLPC image

To close the OLPC "window" you must first go into the QEMU monitor screen and then quit. You do that by:

  1. Make sure the window has the focus (label should say QEMU - Press Ctrl-Alt to exit grab).
  2. Press Alt + Ctrl + 2 to enter the QEMU Monitor (may need shift as well on some computers: Alt + Ctrl + Shift + 2)
  3. Type quit or q to quit.

Please update User Feedback on Images#QEMU on Windows with your experience.

Troubleshooting

See Emulating the XO/Help and tips.

From some info found [here.]