Emulating the XO

This page is an inprogress overhaul of OS images for emulation.

Quick Start

• Windows
• Mac
• Linux
• FreeBSD

Linux Quick Start

Obtain qemu

On Fedora, as root:

yum install qemu

On Debian/Ubuntu, as root:

apt-get install qemu

Obtain an image

Download olpc-redhat-stream-development-ext3.img.bz2 (md5). Then,

bzcat olpc-redhat-stream-development-ext3.img.bz2 > laptop.img

Run qemu on the image

qemu -soundhw es1370 -serial `tty` -hda laptop.img

See Quick Start: Running for the first time.

(optional) Make qemu run faster

If you have an x86 or x86_64 cpu, you can use kqemu to speed up the emulation several 100%.

Obtain kqemu

On fedora, x86,

XXX please fill this in if you know

On fedora, x86_64, as of 2007-05-13, there are no official kqemu, or kqemu kernel module, rpms. atrpms.net has some. Or install from source.

On Debian/Ubuntu, as root:

XXX please fill this in if you know

Run modprobe

modprobe kqemu major=0

This will need to be run again if the host computer is rebooted. If you forget, qemu will be slow again (and a one-line error message scroll by when you run qemu).

Run a qemu variant with the -kernel-kqemu option

On x86,

qemu -kernel-kqemu ...

On x86_64,

qemu-system-x86_64 -kernel-kqemu ...

If you forget and use just qemu instead, things will be slow again.

FreeBSD Quick Start

Install qemu from ports:

cd /usr/ports/emulators/qemu && make install clean

or as a package

pkg_add -r qemu

Then load kqemu and aio kernel modules:

kldload kqemu
kldload aio

and launch the image you want:

qemu -hda olpc-stream-development-7-20060609_1600-ext3.img

Should this take the same arguments as the linux qemu invocation? Are those arguments even needed for linux? MitchellNCharity 21:18, 23 May 2007 (EDT)

Quick Start: Does my qemu have kqemu?

Does the version of the QEMU support KQEMU? Type ctrl+alt+2 and type info kqemu. Use ctrl+alt+1 to return to OLPC screen.