Emulating the XO: Difference between revisions

From OLPC
Jump to navigation Jump to search
(begging of a linux quick start.)
No edit summary
 
(234 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 ===


[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].
=== Linux Quick Start ===


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!
1. Obtain qemu.


[[Category:OS]]
On Fedora, as root:
[[Category:Developers]]

[[Category:Emulation]]
yum install qemu
[[Category:Sugar]]

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 (optional) Make qemu run faster.

If you want to use [http://fabrice.bellard.free.fr/qemu/kqemu-doc.html kqemu] to speed up the emulation (on x86 and related cpus) then

modprobe kqemu major=0

and add the <tt>-kernel-kqemu</tt> option. See [[Using QEMU for Troubleshooting]] for tips.

We have heard multiple people say that QEMU doesn't work with these images on the debian-derived distributions. The symptom is that the kernel hangs during boot. There's a problem with <code>bochsbios</code> version 2.2, version 2.3 works. As a quick fix, <code>apm=off</code> can be added to OLPC kernel arguments. (For more info, see the [[Talk:OS images for emulation#Boot hangs on Debian-derived distros|discussion]].)

If you have network problems through Qemu and OLPC, [[Using_QEMU_on_Troubleshooting#Network|try this.]]


=== FreeBSD Quick Start ===

{| cellspacing=5

|- valign="top"
| Install qemu from ports:
| style="background:lightgray; " | <tt>cd /usr/ports/emulators/qemu && make install clean</tt>

|- valign="top"
| or as a package
| style="background:lightgray; " | <tt>pkg_add -r qemu</tt>

|- valign="top"
| Once installed, load kqemu and aio kernel modules:
| style="background:lightgray; " | <tt>kldload kqemu<br>kldload aio</tt>

|- valign="top"
| and launch the image you want:
| style="background:lightgray; " | <tt>qemu -hda olpc-stream-development-7-20060609_1600-ext3.img</tt>

|}

=== Quick Start: Get image ===


== Developing software using emulation ==

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!