SDK/Docs/1.2/Using a MeeGo runtime with QEMU

This page is in progress and is likely to contain incorrect instructions at present -- Elliot Smith 11:25, 4 May 2011 (UTC)

QEMU is a component of the MeeGo SDK. It can run handset or netbook images under an emulator, so you can test your applications on a MeeGo operating system, even if you don't have a MeeGo device.

If you haven't already installed the SDK, see:

• Installing the SDK on Linux or Installing the SDK on Windows ???content for Windows still to be finalised

For QEMU, it is important to check your graphics capability. See this page about graphics acceleration for details. Please read this page carefully and follow the instructions on it if you are having issues starting runtimes under QEMU.

It is also possible to build and install QEMU manually: see the QEMU tools page for details.

The best and simplest way to use a MeeGo OS image with QEMU is to use mad-admin to download a runtime, and mad to run it. See the instructions below for how to do this.

Contents 1 Install a MeeGo Runtime 2 Using a runtime 2.1 Using a runtime without graphics 2.2 Shortcut button in Qt Creator 3 SSH into QEMU Image 4 Configuring access to an emulated device in Qt Creator 4.1 Screen rotation

Install a MeeGo Runtime

You can get a list of available runtimes with ???SDK maintenance tool.

???to install, select them in the UI

This will download the runtime (a ~650+ MB .bz2 file) and install it.

???how to check it installed

Using a runtime

???normally you do this in Qt Creator; but here are the manual instructions

To start an installed runtime, use the mad command to boot the image inside QEMU.

To start the IA32 handset runtime:

$ sudo mad remote -r <handset runtime name> poweron

Here's what the handset image looks like (this is the Applications zone):

 ???verify screenshot

To start the IA32 netbook runtime:

$ sudo mad remote -r <netbook runtime name> poweron

Here's what the netbook image looks like (this is Myzone):

 ???verify screenshot

You can now use this running image as a deployment target for Qt Creator, or log into it manually over SSH (see below).

When you've finished, use the power off icon in the emulator to switch it off (if available); or from the command line, do:

$ sudo mad remote -r <netbook runtime name> poweroff

Using a runtime without graphics

If you are having issues with running QEMU, you can try running the image without graphics to help isolate the problem. To do this, set QEMU_NOGRAPHIC=yes in the environment before running the emulator. For example:

$ QEMU_NOGRAPHIC=yes mad remote -r <handset runtime name> poweron

If you are then able to ssh into the running image, you can be fairly certain that your issues are graphics-related, rather than anything to do with the image itself.

Shortcut button in Qt Creator

Qt Creator provides a shortcut button to start a QEMU runtime associated with a project, in the bottom left corner:

Clicking on this has the same effect as starting the QEMU runtime manually (as described above).

Once the emulator is running, the button shows a red square: when it is in this state, clicking on it again stops the emulator.

SSH into QEMU Image

Any time MeeGo is running in QEMU, you can use SSH to connect to the image from a command-line terminal on the host system.

When the SDK starts QEMU, it sets up a redirect from port 6666 on the host to the SSH port (port 22) on the guest (MeeGo on QEMU). So you can log into the running QEMU image with:

$ ssh meego@127.0.0.1 -p 6666

Two user accounts are available:

1. User: meego, password: meego
2. User: root, password: meego

Configuring access to an emulated device in Qt Creator

 ???verify screenshot

To configure access to an emulated device:

1. Open Tools > Options > Projects > MeeGo Device Configurations.
2. In the dialog box, create a new Device Configuration by clicking on Add.
3. Give the new Device Configuration a name in the Configuration Name text field, and add the following settings in the other test fields:
   • Device type: choose MeeGo emulator
   • Authentication type: Password
   • Host name: 127.0.0.1
   • Ports, SSH: 6666

     Note that the emulator is setup with a redirect from port 6666 on localhost to the SSH port (22) of the emulated device.

   • Ports, Gdb Server: 13219 (the default)

   Note: If this port is not free, you can select another one.

   • Connection Timeout: 30
   • User Name: root
   • Password: meego
4. Click Apply.
5. To test the settings, ensure that the emulated device is running, then click Test.

   If successful, you'll see a dialog box with the message "Device configuration successful".

   If the message "Could not connect to host" is displayed, check your setting selections and make sure that the network is connected.

6. Click Close and OK.

Screen rotation

???check this

If you are using a handset image with QEMU, you can rotate the screen with Alt+Shift+R (???does R have to be uppercase?):

???screenshot