Editing MADDE/Device runtime

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

===Introduction===

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]])

This guide shows how to:

* install the client on device
* 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;">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-testing]] repository on device.</div></div>

# Open the Application Manager.
# Add the [[extras-testing]] repository.
# Go to: Download -> Development -> mad-developer
# Install the client

===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 [[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.

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

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

=== Test the [[MADDE/Qt Example|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

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

[[Category:Development]]
[[Category:Qt]]

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Templates used on this page:

Template:Ambox (view source) (semi-protected)
Template:MADDE (edit)

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

Personal tools

Navigation

Views

Editing MADDE/Device runtime

@@ Line 6: / Line 6: @@
 * 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 14: / 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;">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-testing]] repository on device.</div></div>
 # Open the Application Manager.
-# Enable the [[extras]] repository.
+# Add the [[extras-testing]] repository.
 # Go to: Download -> Development -> mad-developer
 # Install the client