Using QEMU on Windows

From OLPC
Revision as of 00:16, 4 December 2006 by Skierpage (talk | contribs) (updates for latest file path organization, and more wiki-fied)
Jump to navigation Jump to search

The step-by-step guide below has worked for builds 59 and 182, see User_Feedback_on_Images#QEMU_on_Windows


Download QEMU emulator and accelerator

Download QEMU for Windows from here
http://www.h7.dion.ne.jp/~qemu-win/

Unzip it, and place the files in
C:\Program Files\Qemu
(There is no setup or installation step.)

Then download the QEMU Accelerator Module from http://fabrice.bellard.free.fr/qemu/download.html
KQEMU 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.0pre9.tar.gz.

Then uncompress the kqemu-version.tar.gz file. You may need to uncompress it twice, using an application like 7Zip.
http://www.7-zip.org/
You can place the kqemu-version directory in C:\Program Files\Qemu.

Look through the unzipped files, and right-click on the one called kqemu.inf
Choose "Install" and wait a few seconds.

Then in a command prompt type

net start kqemu

You should get a message saying
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

This file will need uncompressing with an application like 7Zip, available from here
http://www.7-zip.org/

Place the uncompressed ".img" file in the same folder as QEMU.

Starting OLPC environment

In a command prompt type

cd "\Program Files\Qemu"

The command to start the emulator is qemu -L . -hda image_name

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

qemu -L . -hda olpc-redhat-stream-development-build-185-20061117_2030-devel_ext3.img

After a few seconds the emulator will start in a new window, and you will see a boot sequence
When the screen shows the OLPC 'oX' logo and 'Press any key to enter the menu', press any key to go to the GRUB menu.
It's important that you choose the 'OLPC for qemu target'option. The default for these images is to boot for the OLPC Hardware, not the Simulator.
Then you will see a typical Linux boot sequence.

See Sugar Instructions for instructions on how to use the emulated Laptop.

To close the OLPC "window" press: Alt+Ctrl+2 or only liberate the pointer using Ctrl+Alt.

Please update User Feedback on Images#QEMU_on_Windows with your experience!

--Tomhannen 19:30, 13 August 2006 (EDT)