SDK/Docs/1.1/Configuring QEMU runtimes

Revision as of 14:31, 1 November 2010

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

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

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

Creating a runtime

You can get a list of available runtimes for your version of MADDE with:

$ mad-admin list runtimes
qemu-n900-pr12                                              (installable)
rx48-diablo                                                 (installable)
meego-handset-ia32-qemu-1.1.20101031.2201-sda-runtime       (installable)
meego-netbook-ia32-qemu-1.1.20101031.2037-sda-runtime       (installable)
meego-handset-ia32-1.0.80.9.20100706.1-sdk-pre0901-runtime  (installable)

To install one of the "installable" runtimes, such as the IA32 handset runtime, do:

$ sudo mad-admin create -f -e meego-handset-ia32-qemu-1.1.20101031.2201-sda-runtime

This will download the runtime and install it (into MADDE's runtimes directory; on Linux, the default location is /usr/lib/madde/linux-i686/runtimes).

To check the runtime is installed, use mad-admin list runtimes again:

$ mad-admin list runtimes
qemu-n900-pr12                                              (installable)
rx48-diablo                                                 (installable)
meego-handset-ia32-qemu-1.1.20101031.2201-sda-runtime       (installed)
meego-netbook-ia32-qemu-1.1.20101031.2037-sda-runtime       (installable)
meego-handset-ia32-1.0.80.9.20100706.1-sdk-pre0901-runtime  (installable)

Note that installed is shown next to the handset runtime.

Using a runtime

To start an installed runtime, for example the IA32 handset runtime:

$ mad remote -r meego-handset-ia32-qemu-1.1.20101031.2201-sda-runtime poweron

This boots the image inside QEMU.

Here's what it looks like:

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.

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 MADDE 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

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.