Overview

Demos provided as part of the runtime are a convenient way to experience each module's functionality without the need to do special development or connect actual devices. The demos of all modules are placed in the demo/<demo_dir> directory. Each demo should come with a detailed description and instructions, located in a readme.txt file.

Starting a Demo

Using framework console commands

One way to start a demo is directly from the framework text console using system commands:

• The 'exec' command reads and executes the installation scripts contained in the install.txt file, located in the demo/<demo_dir> directory:

  fw>exec ../../demo/<demo_dir>/install.txt

• The ‘install’ (or just ‘i’) command with the 'start' option (-s) runs the demo as a bundle or a set of bundles as described in the readme.txt file:

  fw>install -s ../../demo/<demo_bundle.jar>

Using Kit Manager

To use the Kitman Manager, first you need to have the com.prosyst.mbs.util.kitman bundle installed. Then, type 'list' (or just 'ls') in the 'kitman' command group to see all available installation scripts with their corresponding demo script IDs and names. Run the script in one of the following ways:

• Using the demo kitman script ID:

  kitman>install <kit_ID>

• Using the demo kitman script name:

  kitman>install "<kit_name>"

When starting a demo, it is recommended that you uninstall any previously used demos unless explicitly specified otherwise in the documentation. Use the 'uninstall' command.

Using a demo from Eclipse

1. Make sure you have properly set up your development environment.
2. Import the plugin project of the demo available in the SDK:
   1. Select File -> Import.
   2. In the Select dialog of the Import wizard, go to General -> Existing Projects in the Workspace.
   3. In the Import Projects dialog of the Import wizard, click the Browse button under Select root directory and locate the demo/<demo_dir> directory.
   4. Check the demo project box in the Projects list and click Finish.

   The demo project will appear in the Package Explorer of the workbench.

3. Connect to the OSGi Runtime from the Frameworks view or run an emulation as described in Generating a Target Image.

   As a pre-requisite for connecting to the OSGi Framework from Eclipse you have to activate the Tooling Client (IAgent).

4. In the Package Explorer right-click on the project node and use the Install to -> Select OSGi Framework option from the context menu.
5. Select the connected device and click the OK button to start the installation.

The demo bundle will appear in the runtime within the Frameworks view.

All dependencies should be resolved manually. Installing a Demo via Eclipse does not install dependent bundles.

Rebuilding a Demo

If you are using Eclipse, a demo is automatically rebuilt when (re)installed/updated on the runtime from the IDE.