Using Instrumentation Dashboard

Instrumentation Dashboard is an extension to Qt Creator that provides data gathering and visualisation features for a subset of analysis tools available on the device. The visualisations enable the developers to see the behaviour of the device and/or applications in a graphical format. Tools for viewing the output in textual format are already available on the device terminal.

Instrumentation Dashboard provides adaptation for the following tools:

In the Ready to Update Packages window, click Update. Instrumentation Dashboard is now installed.

Click Finish to exit the Qt SDK Maintenance Tool.

Restart Qt Creator.

Connecting the Harmattan device

Before you can use the tools and utilities, you must install the tool packages on the Harmattan device and set up the connection between the device, Qt SDK and the Instrumentation Dashboard. Otherwise, the tools and utilities will be disabled in their respective menus in the Instrumentation Dashboard.

To prepare the Harmattan device and the Qt SDK connection, follow these steps:

The commands are displayed as a list in the Remote Processes view. Highlight a command to see the context menu. From this menu you can copy a command or copy a PID.

To retrieve updated process information from the device, use the refresh icon. Use the search box to highlight the first matching entry in the list of remote processes.

Open Instrumentation Dashboard

Using Deploy Package utility

With the Deploy Package utility you can transfer and install a Debian package to the connected Harmattan device.

To use the Deploy Package utility:

Click Utilities and select Deploy Package.

Navigate to the Debian package path in file browsing window.

Select the Debian package to deploy.

After a successful deployment, a message window appears that states <package-name> deployed successfully. In case of failure, a message window appears that states <packagename> package deployment failed and the error message from the package manager.

Disconnecting the Harmattan device

In the Instrumentation Dashboard window, click File in the top menu bar.

Select Disonnect.

Updating the Instrumentation Dashboard default installation

To update the Instrumentation Dashboard to a new version, follow these steps:

Open Qt Creator.

Launch the Qt SDK Maintenance Tool by clicking Help in the top menu bar and selecting Start Updater.

Select Update components and click Next.

In the Select Components window, under Experimental -> Harmattan, check the box of the new version of the Instrumentation Dashboard and click Next.

In the Ready to Update Packages window, click Update. Instrumentation Dashboard is now updated.

Click Finish to exit the Qt SDK Wizard.

Uninstalling the Instrumentation Dashboard

To uninstall the Instrumentation Dashboard, follow these steps:

Open Qt Creator.

Launch the Qt SDK Maintenance Tool by clicking Help in the top menu bar and selecting Start Updater.