Emulating the XO: Difference between revisions

From OLPC
Jump to navigation Jump to search
(first draft of linux quick start)
No edit summary
 
(232 intermediate revisions by 60 users not shown)
Line 1: Line 1:
{{translations}}
''This page is an inprogress overhaul of [[OS images for emulation]].''
{{emulation-nav}}


In the past, OLPC produced alternative software images which could be run in emulators such as QEMU and VMware. This meant that development and testing could happen to a limited extent without requiring an XO laptop.
== Quick Start ==


'''In 2013, please see Tom Gilliard's many [http://wiki.sugarlabs.org/go/Sugar_Creation_Kit virtual machine images ready-to-go].'''
*[[Using QEMU on Windows XP|Windows]]
*[[Emulating the XO#Mac Quick Start|Mac]]
*[[Emulating the XO#Linux Quick Start|Linux]]
*[[Emulating the XO#FreeBSD Quick Start|FreeBSD]]


Note, XOs are readily available to genuine volunteer contributors through the [[Contributors program]].
=== Mac Quick Start ===

=== Linux Quick Start ===

1. Obtain qemu.

On Fedora, as root:

yum install qemu

On Debian/Ubuntu, as root:

apt-get install qemu

2. Obtain an image.

Download [http://olpc.download.redhat.com/olpc/streams/development/LATEST-STABLE-BUILD/ext3/olpc-redhat-stream-development-ext3.img.bz2 olpc-redhat-stream-development-ext3.img.bz2] ([http://olpc.download.redhat.com/olpc/streams/development/LATEST-STABLE-BUILD/ext3/olpc-redhat-stream-development-ext3.img.bz2.md5 md5]). Then,

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

3. Run qemu on the image.

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

4. See [[Emulating the XO#Quick Start: Running for the first time|Quick Start: Running for the first time]].

5 (optional) Make qemu run faster.

If you have an x86 or x86_64 cpu, you can use [http://fabrice.bellard.free.fr/qemu/kqemu-doc.html kqemu] to speed up the emulation several 100%.

5a. Obtain kqemu.

On fedora, x86,
XXX please fill this in if you know

On fedora, x86_64, there are no official kqemu, or kqemu kernel module, rpms. [http://atrpms.net/name/kqemu/ atrpms.net] has some. Or install from source.

On Debian/Ubuntu, as root:
XXX please fill this in if you know

5b. 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).

5c. Run a qemu variant with the <tt>-kernel-kqemu</tt> option.

On x86,
qemu -kernel-kqemu ...

On x86_64,
qemu-system-x86_64 -kernel-kqemu ...
If you forget and use just <tt>qemu</tt> 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? [[User:MitchellNCharity|MitchellNCharity]] 21:18, 23 May 2007 (EDT)


=== Quick Start: Getting an image ===

=== Quick Start: Running for the first time ===

=== Quick Start: Does my qemu have kqemu? ===

Does the version of the QEMU support [http://fabrice.bellard.free.fr/qemu/kqemu-doc.html KQEMU]? Type ctrl+alt+2 and type '''info kqemu'''. Use ctrl+alt+1 to return to OLPC screen.

== Developing software using emulation ==


[http://sugarlabs.org Sugar], the unique user interface of the XO laptops, is also distributed as a generic software project and can be developed and tested on "regular" computers as well as XOs. See [http://wiki.sugarlabs.org/go/Downloads Sugar Labs Downloads] for the full range of options, such as [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick Sugar on a Stick].


For emulation of extremely old builds, you may be able to come across "ext3 images" on some corners of http://download.laptop.org and http://xs-dev.laptop.org/~cscott/olpc/streams/ which can be loaded into emulators. You are unlikely to find support for them!


[[Category:OS]]
[[Category:OS]]

Latest revision as of 16:26, 30 July 2013

  english | español日本語한국어portuguêsрусский HowTo [ID# 290021]  +/-  
modify 

In the past, OLPC produced alternative software images which could be run in emulators such as QEMU and VMware. This meant that development and testing could happen to a limited extent without requiring an XO laptop.

In 2013, please see Tom Gilliard's many virtual machine images ready-to-go.

Note, XOs are readily available to genuine volunteer contributors through the Contributors program.

Sugar, the unique user interface of the XO laptops, is also distributed as a generic software project and can be developed and tested on "regular" computers as well as XOs. See Sugar Labs Downloads for the full range of options, such as Sugar on a Stick.

For emulation of extremely old builds, you may be able to come across "ext3 images" on some corners of http://download.laptop.org and http://xs-dev.laptop.org/~cscott/olpc/streams/ which can be loaded into emulators. You are unlikely to find support for them!