MADDE/Device runtime

Latest revision as of 08:06, 10 May 2010

MADDE is currently a technology preview.

These instructions are liable to change as development progresses. If some of the components do not work as expected, please add your question to the MADDE talk thread and follow up the discussion.

tablets-dev.nokia.com is down, see MADDE#Installation for alternatives.

1 Introduction
2 Install the client
3 Set up a "Device runtime"
4 How to use the device runtime
5 Test the example on device
6 More commands

[edit] Introduction

This guide shows how to connect MADDE with your device. This guide requires:

Basic configuration of the development environment. (Guide)
Basic understanding of MADDE (Example)

This guide shows how to:

install the client on device
connect MADDE with the device
send, install and execute files remotely

[edit] Install the client

Open the Application Manager.
Enable the extras repository.
Go to: Download -> Development -> mad-developer
Install the client

[edit] Set up a "Device runtime"

Following steps are needed to create a device runtime:

1. ON DEVICE: Install mad-developer package, as described above.

The program creates a 'developer' user account on device and installs the packages to enable the device runtime usage in MADDE. Further the mad-developer package contains also a GUI application to view information about the available network interfaces, to configure the USB networking interface and manage 'developer' user password generation.

2. ON DEVICE: Set up networking interface between your host PC and device.

On the device you can use the mad-developer GUI application to view the information about available network interfaces and to configure USB networking interface. You can choose one of the available network interfaces.

A Wifi interface is a good alternative if you don't want to plug the USB cable every time you want to test an app. You can use an Ad-Hoc Wifi network set up for the occasion, or if the computer and the N900 are connected to the same network, you can simply use this network.

3. ON DEVICE: Prepare to start

After setting up the network connection, start the mad-developer GUI application (if it is not running yet) and click the 'Password' button. This generates a password for the which is needed for the communication between MADDE and the device.

4. ON HOST: Create runtime

Create the device runtime by:

mad-admin create <runtime name> -a <ip-address>

The IP-address is shown within the application, which is running on the device. Then enter the password, you got in step 3 shown on mad-developer application window when requested. After the command is accomplished you can click the 'Close' button in the mad-developer application window.After that you can close the application. The set up of the device runtime is completed. You can check this by running:

mad list

In this example the runtime name is "n900":

Targets:
fremantle-qt-0942  (default)
maemo412-1         (installable)

Runtimes:
n900  (installed)

5. ON HOST: Remove device runtime:

If you ever finish working with the device, the runtime can be removed by:

mad-admin remove <runtime name>

[edit] How to use the device runtime

The following shows the basic steps on how to use the MADDE with the device runtime. The parameter 'remote' is used for everything regarding the runtime. A runtime cannot be set as 'default', so that it has to be specified with every call of the command. For example to start a remote shell run:

mad remote -r <runtime name> shell

To check whether the runtime is available use:

mad remote -r <runtime name> ping

[edit] Test the example on device

After creating and compiling a simple example and the device runtime set up, it is now possible to run and test it directly on device. Here we assume, that the example is already created and compiled. The name of this example application is "qthello". Further the Qt GUI library has to be installed on device to run the example.

1. Go to the directory of the "qthello" example before.

3. Check if the connection works:

mad remote -r <runtime name> ping

2. Send the executable file to the device, by running:

mad remote -r <runtime name> send build/qthello

3. Run the program on device:

mad remote -r <runtime name>  run qthello

4. To stop the program from command line, type:

mad remote -r <runtime name>  stop qthello

5. After creating a package with MADDE, as shown in the example, you can send and install it by:

mad remote -r <runtime name>  send ../qthello_0.1_armel.deb
mad remote -r <runtime name>  install qthello_0.1_armel.deb

[edit] More commands

With 'mad remote' command you can also remove files from runtime, uninstall debian packages and check if the runtime is up and connectable.

Remove files from the runtime:

mad remote -r <runtime name> remove qthello

Uninstall debian package

mad remote -r <runtime name> uninstall qthello

Check if the runtime is up and connectable

mad remote -r <runtime name> ping

Retrieved from "http://wiki.maemo.org/MADDE/Device_runtime"

Categories: MADDE | Development | Qt

This page was last modified on 10 May 2010, at 08:06.
This page has been accessed 33,592 times.

@@ Line 1: / Line 1: @@
+{{MADDE}}
 ===Introduction===
-This guide shows how to connect MADDE with your device. This guide requires:
+This guide shows how to connect [[MADDE]] with your device. This guide requires:
 * Basic configuration of the development environment. ([[MADDE/Configuration |Guide]])
-* Basic understanding of MADDE ([[MADDE/Qt Example |Example]])
+* Basic understanding of MADDE ([[MADDE/Qt example |Example]])
@@ Line 12: / Line 14: @@
 * connect MADDE with the device
 * send, install and execute files remotely
 ===Install the client===
-<div style="border: 1px solid red; background-color: #faa; padding: 20px;"><div style="text-align:center;">Please keep in mind that this is a '''TECHNOLOGY PREVIEW'''. The following steps should only be taken if you want to test software in an early stage of development. To test the preview, you have to activate the [[Extras-devel | extras-devel]] repository on device.</div></div>
+# Open the Application Manager.
+# Enable the [[extras]] repository.
+# Go to: Download -> Development -> mad-developer
-. Download the package from [url here]
+# Install the client
-. Get [[Root access|root access] on device.
-. Activate the [[Extras-devel | extras-devel]] repository
-. Open the terminal on device, gain root access and run:
- dpkg -i <path_to_file>/mad-developer_1.3.130_armel.deb
-:and to fix the dependencies:
- apt-get update
- apt-get -f install
 ===Set up a "Device runtime"===
@@ Line 48: / Line 35: @@
 '''2. ON DEVICE: Set up networking interface between your host PC and device.'''
-:On device you can use mad-developer GUI application to view the information about available network interfaces and to configure [[N900_USB_networking | USB networking interface]]. You can choose one of the available network interfaces.
+:On the device you can use the mad-developer GUI application to view the information about available network interfaces and to configure [[N900_USB_networking | USB networking interface]]. You can choose one of the available network interfaces.
+:A Wifi interface is a good alternative if you don't want to plug the USB cable every time you want to test an app. You can use an Ad-Hoc Wifi network set up for the occasion, or if the computer and the N900 are connected to the same network, you can simply use this network.
@@ Line 80: / Line 68: @@
 '''5. ON HOST: Remove device runtime:'''
-:The device runtime can be removed by:
+:If you ever finish working with the device, the runtime can be removed by:
   mad-admin remove <runtime name>
@@ Line 146: / Line 134: @@
   mad remote -r <runtime name> ping
+[[Category:Development]]
+[[Category:Qt]]

Personal tools

Navigation

Views