Emulating the XO/Quick Start: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Changed link from 'Sugar Instructions' (which is deprecated) to 'Getting Started')
(Redirected page to Emulating the XO)
 
(24 intermediate revisions by 9 users not shown)
Line 1: Line 1:
#REDIRECT [[Emulating the XO]]
{{Translations}}
This page will help you get a look at the XO software, by running a "virtual XO" in an emulator.
Another option is burning a [[LiveCd]].

== What to expect ==

This "virtual XO" was created as a software development tool. It is not intended for general use, and many things will not work. It is "just to get a taste" (and to help software developers). With time and people constraints, we are focused on the real XO.

*The camera and video will not work.
*Things are slower than on the actual machine. If you are unable to install qemu's kqemu accelerator, very much slower.
*You will see a snapshot of the past. The instructions will have you download the "latest stable build", which is sometimes quite a few weeks old. Development is very rapid. Things will be missing or different compared with the present.
*While rapidly maturing, this is still "alpha" software.
*TamTam, the popular music program, will likely not work (no sound).

== Four steps ==

First, get the qemu emulator which will run the image:
*[[Using QEMU on Windows XP|Windows]] (or use [[Emulating the XO/Quick Start/Windows|all-in-one version]])
*[[Emulating the XO/Quick Start/Mac|Mac]]
*[[Emulating the XO/Quick Start/Linux|Linux]]
*[[Emulating the XO/Quick Start/Linux#FreeBSD|FreeBSD]]
*[[Emulating the XO/Quick Start/Linux#Yellow Dog Linux on PlayStation3|Yellow Dog Linux on PlayStation3]]

Second, download
[http://xs-dev.laptop.org/cscott/olpc/streams/ship.2/latest/devel_ext3/olpc-redhat-stream-ship.2-devel_ext3.img.bz2]. It is in [http://xs-dev.laptop.org/cscott/olpc/streams/ship.2/latest/devel_ext3/ this directory].

Third, extract the .img file from the .bz2 file.

bunzip2 olpc-redhat-stream-ship.2-devel_ext3.img.bz2

Fourth, run:

qemu -m 256 -kernel-kqemu -soundhw es1370 -net user -net nic,model=rtl8139 -hda olpc-redhat-stream-ship.2-devel_ext3.img

If qemu responds with an error like "qemu: could not load PC bios '/c/Program Files/Qemu/bios.bin'" then you may have to use qemu's -L option to specify the directory where you installed qemu, which contains the bios.bin file. If you're using a 64 bit processor, you need to run the command 'qemu-system-x86_64' instead of 'qemu'.

Note that qemu by default gives 128 MB RAM, but according to [[Hardware_specification]] recent XO HW have 256 MB, that's why the "-m 256". To test for early XO HW (or later with more), change the -m param. Giving 256 MB RAM appears to have a noticeable effect on speed in the emulator (as I'm sure in the real HW ;)).

You should now have a running "virtual XO".

== Running for the first time ==

[[Getting Started]] will help you get oriented, though you may not need it.

Note: when you see the X with the circle on top it is running OK. Enter you name and move the cursor to one of the corners to see the menus of sugar. I would like to see a right click bring up a menu bar (in addition)

You can also get other [[Emulating the XO/Help and tips|Help and tips]] on emulating Sugar.

When running under emulation, the sugar fonts will appear very tiny until you [https://dev.laptop.org/ticket/3681 set the screen to 200 dpi].

[[Category:Emulation]]
[[Category:Sugar]]

Latest revision as of 15:37, 7 February 2011

Redirect to: