Emulating the XO/Quick Start/Mac

This page needs some cleaning to become a nice quickstart. Non-quickstart mac-specific content can be moved to Emulating the XO/Mac. The mentioned "Enabling SSH" section was missing even before this was copied here. If found, it can go in Emulating the XO. MitchellNCharity 03:34, 24 May 2007 (EDT)

Installing QEMU for MacOS-X

You should already have an XO build image.

The port of Qemu for MacOSX is called Q and can be found in kju-app.org. Download and install Q.app stable version 0.8.1a35. Other builds are here: kberg.ch/q/builds/

Setting up

Q.app

Click on the (+) button to create a new guest:

Create new Guest:              Name:  OLPC
                   Operating System:  Q Standard Guest
                -- click (Create PC) --

Proceed to configure its preferences:

 General Prefs | SMB Filessharing:  No file sharing
Hardware Prefs |        Hard disk:  Select your unzipped build image
Advanced Prefs |   QEMU Arguments:  -redir tcp:2222::22
                -- click (Create PC) --

Starting OLPC Environment

Double click on the newly created "OLPC" to launch a window for it.

NOTE

what follows may not be required. If you happen to do with or without it, please let us know in the discussion page (signing it) so this section can be updated accordingly.

— press "space" to get into GRUB

— choose "OLPC for Qemu Target",

— press "e" to edit commands,

— select "kernel" line, and press "e"

— add "single" option at the end of the line

— hit "return", then "b" to boot

Advanced

You may encounter some issues supporting USB devices.

You can run Q.app from the command line:

$ /Applications/Q.app/Contents/MacOS/i386-softmmu.app/Contents/MacOS/i386-softmmu -hda olpc/olpc-redhat-stream-development-devel_ext3.img -serial stdio

Ctrl-Alt combos in Qemu (or Q.app)

This page needs clean-up and editing for coherence, clarity, and completeness.

Please improve this article if you can.

This section about keys should go somewhere else...

According to Sugar Instructions you need to "hold down Ctrl+Alt+F1 to leave the Sugar screen and return to the login prompt" and then "you can return to Sugar with Ctrl+Alt+F7". Unfortunately for me the "Ctrl+Alt" action seems to be grabbed by the Q.app "mouse pointer ungrab" functionality.

Under Linux, this will be grabbed by the X server running on your computer, and not the one running in the emulator, and will switch your own computer to a terminal.

The other method(s) suggested for opening a terminal activity didn't work for me either (OLPC build 239). I eventually discovered that Q.app actually has a "Monitor" accessible by "ctrl-alt-2". When in this monitor mode you can send key-presses directly to the OLPC emulation by using the "sendkey" command. For example:

  sendkey ctrl-alt-f1       # to switch to the shell
  sendkey ctrl-alt-f7       # to return to Sugar

Note: you will need to exit the monitor mode and return to the emulated machine by pressing "ctrl-alt-1" once you type either of the above commands.

Note: you type the name of the keys to send, you don't actually press the keys.