Emulating the XO: Difference between revisions

From OLPC
Jump to navigation Jump to search
(in linux quick start, put common case (or used by more novice users case) first)
No edit summary
 
(228 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 Debian/Ubuntu, as root:

apt-get install qemu

On Fedora, as root:

yum 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

Then see [[Emulating the XO#Quick Start: Running for the first time|Quick Start: Running for the first time]].

'''4 - (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%.

'''4 a - Obtain kqemu'''

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

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

On Fedora x86_64, as of 2007-05-13, there are no official rpms for kqemu, or the kqemu kernel module, and they are not included in the qemu rpm. [http://atrpms.net/name/kqemu/ atrpms.net] has kqemu rpms. Or install from source.
:There are several kernel rpms to choose from. Some guidance should be given here. [[User:MitchellNCharity|MitchellNCharity]] 22:01, 23 May 2007 (EDT)

'''4 b - 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).

'''4 c - 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!