Emulating the XO/Quick Start/Windows: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
 
(34 intermediate revisions by 15 users not shown)
Line 1: Line 1:
<big><b><font color=red>For current information on emulation of OLPC software images, see [[Emulating the XO]]</font></b></big>
=Really Quick Start=
This instruction is meant for the first-time user who wants to try OLPC. Everything is included in a single download.


{{Deprecated}}
==Assumptions==

{{__TOCright__}}
==Installer for Windows==

The Sugar Installer for Windows includes everything you need to run Sugar on a Windows based PC: An XO-1 image, the QEMU emulator, and KQEMU to speed up emulation. An uninstaller is also included.

===Requirements===
* Windows XP or Vista (Windows 2000 should work, not tested)
* Windows XP or Vista (Windows 2000 should work, not tested)
* About 1.5 GB free space on disk
* About 1.5 GB free space on disk
* Administration privileges on PC (as with any other software installation)
* Administration privileges on PC (as with any other software installation)
* Good Internet connection (you'll download 232 MB file)
* Good Internet connection (you'll download a 127 MB file)

===Installation===

Download and run the following setup file to install an 8.2.0 build using QEMU:

http://dev.laptop.org/~wadeb/OLPC-XO-Software-8.2.0-Setup.exe (127MB)
[
]

Then go to the folder where the files got unpacked (on Windows XP that should be C:\Program Files\OLPC XO Software Release 8.2.0), right click on the file kqemu.inf and select "install" to install kqemu.


If you receive an error that you cannot install you can follow these steps:


1. "Start" -> "Run" -> enter 'cmd'
==Steps==
2. Change the directory to where the 'kqemu.inf' file is located
# Download [http://slimak.onet.pl/_m/onetlajt/olpc/olpc_qemu_full.zip olpc_qemu_full.zip] (232 MB)
> dir C:\"Program Files"\"OLPC XO Software Release 8.2.0"\
# Doubleclick the file - it should open compressed file contents which is one directory, called '''olpc'''
3. Enter the command:
# Drag and drop this "olpc" directory somewhere, '''c:\''' recommended, but you can use different directory for that.
> rundll32 syssetup,SetupInfObjectInstallAction DefaultInstall 128 .\kqemu.inf
# Enter olpc directory and doubleclick '''start_olpc.cmd''' (if you are running Windows Vista, you should instead right-click the file and select '''Run as administrator''').
# Enjoy!


==Next steps==
=Next steps= (what is the diff between "Steps" and "Next Steps" ?? why don't you be clear?)
{{Latest Releases | devel = inline}}
{{Latest Releases | devel = inline | rc = inline}}
* You might want to read [[Sugar Instructions]]. Sugar is the name of the graphical environment of XO.
* You might want to read [[Sugar Instructions]]. Sugar is the name of the graphical environment of XO.
* You can download another OS image, starting from ones in the green box on the right -> <br>(always pick ext3, not jffs2 version).
* You can download another OS image, starting from ones in the green box on the right -> <br>(always pick ext3, not jffs2 version).
** Remark 1: Remember, the file will be compressed with "bzip2", so you'll need to uncompress it before use. You can use [http://gnuwin32.sourceforge.net/packages/bzip2.htm Windows version of Bzip2] for that.
** Remark 1: Remember, the file will be compressed with "bzip2", so you'll need to uncompress it before use. You can use [http://gnuwin32.sourceforge.net/packages/bzip2.htm Windows version of Bzip2] for that.
** Remark 2: The start_olpc.cmd script uses first file with .img extension as a OLPC filesystem image. If you have more than one image in olpc directory, change extensions or move out all but one file.
** Remark 2: The start_olpc.cmd script uses first file with .img extension as a OLPC filesystem image. If you have more than one image in olpc directory, change extensions or move out all but one file.
* You can connect to the emulated XO by SSH, using address 127.0.0.1 and port 2222. More info [[Emulating_the_XO/Help_and_tips#Comfortably_transfer_Files_between_Host_and_XO|here]].
* You can connect to the emulated XO by SSH (PuTTY is one good SSH client for MS Windows), using address 127.0.0.1 and port 2222. More info [[Emulating_the_XO/Help_and_tips#Comfortably_transfer_Files_between_Host_and_XO|here]].
* You can read more about emulator: [[Emulating the XO/Help and tips]]
* You can read more about emulator: [[Emulating the XO/Help and tips]]


== Quick Start - The Longer, but Efficient Way ==
== Quick start - step by step instructions ==
=== QEMU ===
* In order to start emulating the OLPC software, you will first need an emulator called QEMU, which can be found [http://www.h7.dion.ne.jp/~qemu-win/ here]. On the download page click the link with the name: qemu-0.9.0-windows.zip. Download the file to your desktop.
* In order to start emulating the OLPC software, you will first need an emulator called QEMU, which can be found [http://www.h7.dion.ne.jp/~qemu-win/ here]. On the download page click the link with the name: qemu-0.9.0-windows.zip. Download the file to your desktop.
** In order to use a .zip file you will need a program that has the capability to extract certain file types, we suggest 7-Zip which can be found [http://www.7-zip.org/ here]. Download the latest stable version, which should be the first link on the page. Install the program and you should now be able to "unzip files".
** In order to use a .zip file you will need a program that has the capability to extract certain file types, we suggest 7-Zip which can be found [http://www.7-zip.org/ here]. Download the latest stable version, which should be the first link on the page. Install the program and you should now be able to "unzip files".
Line 49: Line 68:
* Qemu is now installed.
* Qemu is now installed.


== KQEMU ==
=== KQEMU ===


* Kqemu is an accelerator module for the Qemu emulator which improves performance on many systems.
* Kqemu is an accelerator module for the Qemu emulator which improves performance on many systems.


=== KQEMU option 1 ===
==== KQEMU on Windows ====


This is one method of installing Kqemu. If it doesn't work, try option 2 below.
This is one method of installing Kqemu. If it doesn't work, try option 2 below.


* First, download the the module from [http://fabrice.bellard.free.fr/qemu/download.html here]. The stable version is kqemu-1.3.0pre11. Click on the link provided, and download the file to your desktop. As before, extract the files to the desktop by right-clicking on the file, and hitting "Extract Here". This time, instead of going into the folder and cutting all of the files separately, cut the entire folder at once, and paste it into your Qemu Program Files Folder.
* First, download the the module from [http://wiki.qemu.org/Download here]. The stable version is kqemu-1.3.0pre11. Click on the link provided, and download the file to your desktop. As before, extract the files to the desktop by right-clicking on the file, and hitting "Extract Here". This time, instead of going into the folder and cutting all of the files separately, cut the entire folder at once, and paste it into your Qemu Program Files Folder.


[[Image:Foldercut.jpg]]
[[Image:Foldercut.jpg]]
Line 68: Line 87:


* Right Click the file, and hit "Install". It should only take a few seconds, and then the module should be installed.
* Right Click the file, and hit "Install". It should only take a few seconds, and then the module should be installed.
:* Right clicking on the .inf file and selecting Install in Vista returns the error "The INF file you selected does not support this method of installation". In Windows Vista, install KQEMU with this alternate command line from an Administrator CMD prompt:
::<tt>rundll32.exe setupapi,InstallHinfSection DefaultInstall 132 kqemu.inf</tt>

:* Another way to install KQEMU on Windows Vista uses the installer from this alternative download site: [http://www.h7.dion.ne.jp/~qemu-win/ here] --- choose the link for the executable file under "Accelerators" near the bottom of page. Download the executable file and save it on your PC. The link looks something like this: "http://www.h6.dion.ne.jp/~kazuw/qemu-win/Kqemu-1.3.0pre11-install.exe"
::* Double-click the downloaded executable file to run it.
::* When asked where to install the accelerator, choose "C:\Program Files\Qemu\Kqemu".

* Now we are going to start the module so that when you run the emulator it can access it.
* Now we are going to start the module so that when you run the emulator it can access it.
** Hit the start button, or Windows Key and then hit the "Run" button:
** Hit the start button, or Windows Key and then hit the "Run" button:
Line 87: Line 113:
The KQEMU virtualisation module for QEMU service was started successfully.
The KQEMU virtualisation module for QEMU service was started successfully.


=== KQEMU option 2 ===
=== Getting an OLPC image ===


* Now that we have the basic emulator set up, its time to get the actual image that will allow us to utilize the OLPC Sugar software. All the latest images can be found [http://xs-dev.laptop.org/~cscott/olpc/streams/ here]. Click on "update.1", then "latest", "devel_ext3", and then click on the image named: olpc-redhat-stream-update.1-build-657-20071212_1519-devel_ext3.img.bz2. (This is currently the latest build of the software, but feel free to go ahead and try any of the other images on the site).
When trying the above option to install Kqemu, Windows Vista told me that the .inf file “does not support this method of installation”. After a bit of searching, I found an alternative download site:
** Here's another place to look for the latest (up to February 29, 2008) image: go to [this location http://xs-dev.laptop.org/~cscott/olpc/streams/ship.2/latest/devel_ext3/] then select file "olpc-redhat-stream-ship.2-devel_ext3.img.bz2".
* An alternative download site for the accelerator is [http://www.h7.dion.ne.jp/~qemu-win/ here] --- choose the link for the executable file under "Accelerators" near the bottom of page. Download the executable file and save it on your PC. The link looks something like this: "http://www.h6.dion.ne.jp/~kazuw/qemu-win/Kqemu-1.3.0pre11-install.exe"
** As of October, 2008, the latest images can be found [here http://xs-dev.laptop.org/cscott/olpc/streams/joyride/latest/devel_ext3/].
* Double-click the downloaded executable file to run it.
* When asked where to install the accelerator, choose "C:\Program Files\Qemu\Kqemu".

== Getting the Image ==

* Now that we have the basic emulator set up, its time to get the actual image that will allow us to utilize the OLPC Software. All the latest images can be found [http://xs-dev.laptop.org/~cscott/olpc/streams/ here]. Click on "update.1", then "latest", "devel_ext3", and then click on the image named: olpc-redhat-stream-update.1-build-657-20071212_1519-devel_ext3.img.bz2. (This is currently the latest build of the software, but feel free to go ahead and try any of the other images on the site).
** Here's another place to look for the latest image: go to [this location http://xs-dev.laptop.org/~cscott/olpc/streams/ship.2/latest/devel_ext3/] then select file "olpc-redhat-stream-ship.2-devel_ext3.img.bz2".
** Download the image to your desktop.
** Download the image to your desktop.
* Using 7-Zip, as before right-click and "Extract Here" to extract the image to your desktop. Then, cut that file, and paste it into your Qemu Program Files Folder:
* Using 7-Zip, as before right-click and "Extract Here" to extract the image to your desktop. Then, cut that file, and paste it into your Qemu Program Files Folder:
Line 103: Line 123:
[[Image:Image.jpg]]
[[Image:Image.jpg]]


== The Final Steps ==
=== The final steps ===


* You are now ready to use QEMU to emulate the software.
* You are now ready to use QEMU to emulate the software.
Line 127: Line 147:
* You can now use the OLPC Software, and experience the innovation of the XO on your own computer!
* You can now use the OLPC Software, and experience the innovation of the XO on your own computer!


== Easily starting up the Emulation ==
=== Easily starting up the emulation ===


* One problem with this method is that every time that you wish to run the emulation, you will need to open up the Command Prompt and type in the long code shown above.
One problem with this method is that every time that you wish to run the emulation, you will need to open up the Command Prompt and type in the long command lines shown above.
** A solution to this problem is to create a .bat file which will with one click will automatically run the script for you.
You can create a .bat file which will run the commands for you with one click .
In order to do this
* In order to do this, open up your "Notepad" which can easily be opened by opening the "Run" dialog and typing in "notepad".
* open up your "Notepad" which can easily be opened by opening the "Run" dialog and typing in "notepad".
** Then type in this code:
* Then in Notepad type in this code:
cd "\Program Files\Qemu"
cd "\Program Files\Qemu"
qemu -L . -m 256 -kernel-kqemu -soundhw es1370 -net user -net nic,model=rtl8139 -hda olpc-redhat-stream-update.1-build-657-20071212_1519-devel_ext3.img
qemu -L . -m 256 -kernel-kqemu -soundhw es1370 -net user -net nic,model=rtl8139 -hda olpc-redhat-stream-''update.1-build-657-20071212_1519''-devel_ext3.img
pause
pause
: replacing the long name of the <tt>devel_ext3.img</tt> file with the name of the image you downloaded.
* It should look like this:
* It should look like this:
[[Image:Bat.jpg]]
[[Image:Bat.jpg]]


* Now, go to File > Save and name it name_here.bat:
* Now, go to File > Save and name it, say <tt>XO.bat</tt>:

[[Image:Saveas.jpg]]
[[Image:Saveas.jpg]]


* Save this file to your desktop and you can now click on this file at any time to run the OLPC Emulation.
* Save this file to your desktop and you can now click on this file at any time to run the OLPC Emulation.


* [[Getting Started]] will help you get oriented, though you may not need it.
[[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)
Note: when you see the OX icon in the center of the screen, Sugar has started. Enter you name and move the cursor to one of the corners to see the menus of sugar.


You can also get other [[Emulating the XO/Help and tips|Help and tips]] on emulating Sugar.
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].
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]. ''still true''


== Other notes ==

== Other Notes ==


If qemu responds with an error like "qemu: could not load PC bios '/c/Program Files/Qemu/bios.bin'" when trying to run it in the command prompt 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'.
If qemu responds with an error like "qemu: could not load PC bios '/c/Program Files/Qemu/bios.bin'" when trying to run it in the command prompt 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'.
Line 161: Line 181:


You should now have a running "virtual XO"
You should now have a running "virtual XO"

[[Category:Emulation]]

Latest revision as of 16:14, 8 February 2011

For current information on emulation of OLPC software images, see Emulating the XO

Stop hand.png WARNING:
The content of this section is considered
DEPRECATED and OBSOLETE
It is preserved for historical or documenting reasons.

Installer for Windows

The Sugar Installer for Windows includes everything you need to run Sugar on a Windows based PC: An XO-1 image, the QEMU emulator, and KQEMU to speed up emulation. An uninstaller is also included.

Requirements

  • Windows XP or Vista (Windows 2000 should work, not tested)
  • About 1.5 GB free space on disk
  • Administration privileges on PC (as with any other software installation)
  • Good Internet connection (you'll download a 127 MB file)

Installation

Download and run the following setup file to install an 8.2.0 build using QEMU:

http://dev.laptop.org/~wadeb/OLPC-XO-Software-8.2.0-Setup.exe (127MB) [ ]

Then go to the folder where the files got unpacked (on Windows XP that should be C:\Program Files\OLPC XO Software Release 8.2.0), right click on the file kqemu.inf and select "install" to install kqemu.


If you receive an error that you cannot install you can follow these steps:

  1.  "Start" -> "Run" -> enter 'cmd'
  2.  Change the directory to where the 'kqemu.inf' file is located
     > dir C:\"Program Files"\"OLPC XO Software Release 8.2.0"\
  3.  Enter the command:
     > rundll32 syssetup,SetupInfObjectInstallAction DefaultInstall 128 .\kqemu.inf

Next steps


  • You might want to read Sugar Instructions. Sugar is the name of the graphical environment of XO.
  • You can download another OS image, starting from ones in the green box on the right ->
    (always pick ext3, not jffs2 version).
    • Remark 1: Remember, the file will be compressed with "bzip2", so you'll need to uncompress it before use. You can use Windows version of Bzip2 for that.
    • Remark 2: The start_olpc.cmd script uses first file with .img extension as a OLPC filesystem image. If you have more than one image in olpc directory, change extensions or move out all but one file.
  • You can connect to the emulated XO by SSH (PuTTY is one good SSH client for MS Windows), using address 127.0.0.1 and port 2222. More info here.
  • You can read more about emulator: Emulating the XO/Help and tips

Quick start - step by step instructions

QEMU

  • In order to start emulating the OLPC software, you will first need an emulator called QEMU, which can be found here. On the download page click the link with the name: qemu-0.9.0-windows.zip. Download the file to your desktop.
    • In order to use a .zip file you will need a program that has the capability to extract certain file types, we suggest 7-Zip which can be found here. Download the latest stable version, which should be the first link on the page. Install the program and you should now be able to "unzip files".
  • Now that you have the program extract the files to your desktop like so:


Extract.jpg

  • You will now have a folder on your desktop called: qemu-0.9.0-windows. In order to use the QEMU program, we need to create a folder in the Program Files directory, and name it Qemu. So, navigate to your Program Files Page, which will look like this:

Programf.jpg

    • In order to create a new folder, right-click, and go to New > Folder. A new folder should appear, and then edit the name to be Qemu.


Newfold.jpg

  • Now, go back to your desktop and open up the qemu-0.9.0-windows folder; you should see many files. Select all the files in the folder by pressing Control + A. Then press right click and "cut" the files out of the folder. After that, go back to your newly created Program Files folder, and press right click and "paste" the files into the folder.

Cut.jpg

Paste.jpg

  • Qemu is now installed.

KQEMU

  • Kqemu is an accelerator module for the Qemu emulator which improves performance on many systems.

KQEMU on Windows

This is one method of installing Kqemu. If it doesn't work, try option 2 below.

  • First, download the the module from here. The stable version is kqemu-1.3.0pre11. Click on the link provided, and download the file to your desktop. As before, extract the files to the desktop by right-clicking on the file, and hitting "Extract Here". This time, instead of going into the folder and cutting all of the files separately, cut the entire folder at once, and paste it into your Qemu Program Files Folder.

Foldercut.jpg

Updatef.jpg

  • Now that you have the accelerator folder in your main Qemu folder, it is time to install Kqemu so that the main program can access it. Navigate to your Program Files Folder, go to Qemu, and then to the folder that you just pasted in. You will find many different files, but the one that you are interested in is the one named: kqemu.inf:

Kqemui.jpg

  • Right Click the file, and hit "Install". It should only take a few seconds, and then the module should be installed.
  • Right clicking on the .inf file and selecting Install in Vista returns the error "The INF file you selected does not support this method of installation". In Windows Vista, install KQEMU with this alternate command line from an Administrator CMD prompt:
rundll32.exe setupapi,InstallHinfSection DefaultInstall 132 kqemu.inf
  • Double-click the downloaded executable file to run it.
  • When asked where to install the accelerator, choose "C:\Program Files\Qemu\Kqemu".
  • Now we are going to start the module so that when you run the emulator it can access it.
    • Hit the start button, or Windows Key and then hit the "Run" button:

Start.jpg

  • Type in "cmd.exe" into the box that pops up:

Run.jpg

  • You should have the command prompt:

Cmdp.jpg

  • Then type in:
net start kqemu
  • If the startup is successful you should see a dialog:
The KQEMU virtualisation module for QEMU service was started successfully.

Getting an OLPC image

  • Now that we have the basic emulator set up, its time to get the actual image that will allow us to utilize the OLPC Sugar software. All the latest images can be found here. Click on "update.1", then "latest", "devel_ext3", and then click on the image named: olpc-redhat-stream-update.1-build-657-20071212_1519-devel_ext3.img.bz2. (This is currently the latest build of the software, but feel free to go ahead and try any of the other images on the site).
  • Using 7-Zip, as before right-click and "Extract Here" to extract the image to your desktop. Then, cut that file, and paste it into your Qemu Program Files Folder:

Image.jpg

The final steps

  • You are now ready to use QEMU to emulate the software.
    • As before, go to the start button, and hit "run" - and then type in "cmd.exe".
  • Now type into the box the following:
cd "\Program Files\Qemu"
qemu -L . -m 256 -kernel-kqemu -soundhw es1370 -net user -net nic,model=rtl8139 -hda (image name here, without these brackets)
  • In this case the "image name" would be olpc-redhat-stream-update.1-build-657-20071212_1519-devel_ext3.img.
    • NOTE: When entering the code remember that this section: "model=rtl8139" should be spelled with a letter L for rtl and not the number 1 for rt1
  • If the process is a success, a window should open up with the name QEMU:


  • The emulator will start in a new window, and will soon display the OLPC 'XO' logo and 'Booting OLPC for qemu target in nn seconds'. (If it does not, then press any key to go to the GRUB menu and choose the 'OLPC for qemu target' option. You need to boot the emulator, not the OLPC hardware.)
    • Then you will see a typical Linux boot sequence ending in a dialog asking for your nickname.
  • You can now use the OLPC Software, and experience the innovation of the XO on your own computer!

Easily starting up the emulation

One problem with this method is that every time that you wish to run the emulation, you will need to open up the Command Prompt and type in the long command lines shown above. You can create a .bat file which will run the commands for you with one click . In order to do this

  • open up your "Notepad" which can easily be opened by opening the "Run" dialog and typing in "notepad".
  • Then in Notepad type in this code:
cd "\Program Files\Qemu"
qemu -L . -m 256 -kernel-kqemu -soundhw es1370 -net user -net nic,model=rtl8139 -hda  olpc-redhat-stream-update.1-build-657-20071212_1519-devel_ext3.img
pause
replacing the long name of the devel_ext3.img file with the name of the image you downloaded.
  • It should look like this:

Bat.jpg

  • Now, go to File > Save and name it, say XO.bat:

Saveas.jpg

  • Save this file to your desktop and you can now click on this file at any time to run the OLPC Emulation.

Getting started will help you get oriented, though you may not need it.

Note: when you see the OX icon in the center of the screen, Sugar has started. Enter you name and move the cursor to one of the corners to see the menus of sugar.

You can also get other Help and tips on emulating Sugar.

When running under emulation, the sugar fonts will appear very tiny until you set the screen to 200 dpi. still true

Other notes

If qemu responds with an error like "qemu: could not load PC bios '/c/Program Files/Qemu/bios.bin'" when trying to run it in the command prompt 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"