Connecting Maemo Devices

Configuring Connections to Maemo Devices

To be able to run and debug applications on the Maemo emulator and devices, you must set up connections to the emulator and devices in the Qt Creator build and run settings. If you install Qt SDK, the connection to the emulator is configured automatically and you only need to configure a connection to the device.

You use a wizard to create the connections. You can edit the settings later in Tools > Options... > Linux Devices > Device Configurations.

By default, you create the connection as the developer user. This protects real user data on the device from getting corrupted during testing. If you write applications that use Qt Mobility APIs, you might want to test them with real user data. To create a connection as a user, specify the Username and Password in Qt Creator. For more information, see Testing with User Data on Maemo Devices.

You can protect the connections between Qt Creator and a device by using either a password or an SSH key. If you use a password, you must generate it in the connectivity tool and enter it in Qt Creator every time you start the connectivity tool.

If you do not have an SSH key, you can create it in Qt Creator. Encrypted keys are not supported. For more information, see Generating SSH Keys.

You can view processes running on devices and kill them. For more information, see Managing Device Processes.

To configure connections between Qt Creator and a device:

1. To deploy applications and run them remotely on devices, specify parameters for accessing devices:
   1. Connect your device to the development PC via a USB cable or a WLAN. For a USB connection, you are prompted to select the mode to use. Choose PC suite mode.

      Note: If you experience connection problems due to a USB port issue, switch to a different port or use WLAN to connect to the device.

   2. Select Tools > Options... > Linux Devices > Device Configurations > Add, and add a new configuration for a hardware device.

      

   3. In the The name to identify this configuration field, enter a name for the connection.
   4. In the The system running on the device field, select the software platform of the device.
   5. In the The kind of device field, select Hardware device.
   6. In the The device's host name or IP address field, enter the IP address from the connectivity tool on the device.
   7. In the The SSH server port field, enter the port number to use for SSH connections.
   8. Click Next.
   9. Follow the instructions of the wizard to create the connection.
2. To test applications on the emulator (QEMU) separately, you must create a connection to it from the development PC. If you installed Qt SDK, the connection is created automatically and you can omit this step.
   1. In Qt Creator, select Tools > Options... > Linux Devices > Device Configurations > Add to add a new configuration.

      

   2. In the The name to identify this configuration field, enter a name for the connection.
   3. In the The system running on the device field, select the software platform to emulate.
   4. In the The kind of device field, select Emulator (Qemu).
   5. Click Next.
   6. Follow the instructions of the wizard to create and test the connection.
3. To specify build and run settings:
   1. Open a project for an application you want to develop for your device.
   2. Click Projects to open the projects mode.
   3. In the Build Settings section, choose the MADDE Qt version that was registered by the installation program.

      

   4. In the Run Settings section, click Add to add a new deploy configuration. The configuration is named automatically. To give it a new name, click Rename.
   5. In the Device configuration field, select the device connection or the emulator connection.

      

   6. Click <no target path set> in Remote Directory to specify the folder where the file is installed on the device. For example, /opt/usr/bin.