Using QEMU on Troubleshooting

More often than not, technology manages to get us 95% of the way... being the last 5% a mix of magical incantations, rituals and other esoteric activities only clear to the initiated. This page tries to take some of the magic away from the sufficiently advanced science... You should also check configuration issues of the latest images.

Sound

Latest images add support of sound. Emulation does not work properly with Tam-Tam, yet, even with kqemu at 2 GHz Pentium4 (performance or insufficient emulation issue?)

Keyboard and Mouse

A typical case is that their keyboard and mouse don't work. A solution to the problem is:

1. Make sure the the window has the focus (label should say QEMU - Press Ctrl-Alt to exit grab).
2. Press Alt + Ctrl + 1 (or Alt + Ctrl + 3) to enter the terminal mode of the OLPC. Notice that QEMu seems to respond better to by pushing first down Ctrl, after Alt and finally the number.
3. Make sure that you're logged in.
   • If not, just hit enter and it'll ask you to.
   • Login as root (no password is required)
4. Type modprobe i8042 (oddly, you may need to try this multiple times before it works, so keep trying!)

1. Press Alt + Ctrl + 7 to return to the graphical mode of the OLPC.
2. Your keyboard and mouse should be working fine.
   • Usually the result is a continuous series of 1's will flow (as if the key is stuck)
   • Just hit any key (to stop it) and delete the offending 1's

Alternatively you can use the developers console and su command. Quote from BTest-1_Release_Notes

 The terminal (activity) does not appear on the Frame, but can be launched by typing Alt-Shift-F11. 
 (F11 is found in the 3rd position from the left in the Volume Slider key.)
 Note that on some newer builds, the terminal window (Memphis) is launched by typing Alt-Shift-F12.
 In even more recent builds, e.g., Build 224, Memphis is launched by typing Alt-View_Source or Alt-F12. 

See also Sugar_Instructions#Terminal_.28linux_prompt.29

Network

Chances are that the network will not be enabled. Following are two possible ways to enable it.

Enabling the Network Alternative #1

1. 1. Make sure the the window has the focus (label should say QEMU - Press Ctrl-Alt to exit grab).
   2. If the following keys do not work try pushing also the Shift key down to exit the Sugar environment.
   3. If it does not work see the sendkey method down.
3. Press Alt + Ctrl + 1 to enter the terminal mode of the OLPC.
4. Make sure that you're logged in.
   • If not, just hit enter and it'll ask you to.
   • Login as root (no password is required)
5. Type dhclient
6. Press Alt + Ctrl + 7 to return to the graphical mode of the OLPC.
7. Your browser / network connection should be working fine.

Enabling the Network Alternative #2

The steps below work on QEmu regardless of which operating system you are running.

If you are having trouble getting an internet connection inside QEmu:

Get the image running in QEmu so that you can see the normal view with the XO icon in the middle.

Make sure your mouse is active in QEmu, then press ctrl+alt+2 together.

This will bring up a screen like a command line, called the QEmu monitor.

Type the following:

sendkey ctrl-alt-f1

And press return.

Then with the keyboard hold down the following keys: ctrl+alt+7

Another text based screen will appear, asking you to log-in. Sometimes there can be an extra "1" after the word "Login:", just delete it. Type root and press return

Then type:

dhclient

You should see the screen fill with text.

Some of the numbers have been removed from the screenshot above - they're not important.

If you like to have permanent change in the disk image, you can put the network start in the file

  /etc/rc.local

You can also put your local keyboard layout command there like this (using tabulator key to complete the filenames):

  echo ifup eth0: >> /etc/rc.local
  echo loadkeys Your_two_letter_country_code >> /etc/rc.local

You can then change XKbLayOut in the file /etc/X11/xorg.conf to your country code with for example nano text editor by

  nano /etc/X11/xorg.conf

If you want to use nano for other system file edits, disable the line wrap by Alt-L .

Then hold down the following keys on the keyboard: ctrl+alt+2

and type the following:

sendkey ctrl-alt-f7

Then using the keyboard, hold down the following keys: ctrl+alt+1

Now open the browser and you should have internet access.