Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "DSDP/TML/Creating TmL Plugins update"
(→Defining the device state machine) |
(→Defining the device state machine) |
||
| Line 30: | Line 30: | ||
It is highly recommended that you draw a graph which represents the device state machine you are creating in TmL. As an example, see the graph below: | It is highly recommended that you draw a graph which represents the device state machine you are creating in TmL. As an example, see the graph below: | ||
| + | |||
| + | [[Image:state-machine-graph.jpg]] | ||
=== Instantiating the new device on the TmL framework === | === Instantiating the new device on the TmL framework === | ||
Revision as of 16:40, 5 December 2008
Contents
Creating TmL devices
Purpose and Target audience
This tutorial provides directions on creating devices:LINK_CONCEPT for TmL.
The target audience is anyone who wants to create a device:LINK_CONCEPT in TmL context.
Initial requirements
Here follows the steps necessary to prepare the environment to create TmL devices.
- Download and install the most recent Eclipse Europa (3.3) version. Click here for the eclipse download site.
- Connect to Eclipse CVS Repository and get the project set for Common utilities (see instructions here).
After that, your workspace should contain a new project named org.eclipse.tml.common.utilities.
Creating a TmL device
The process of creating a TmL device consists of the following:
- Defining the state machine which describes the device behavior in what concerns the TmL framework.
- Creating an eclipse extension which instantiates the device you want to create.
- Creating the device state machine on the TmL framwork. This comprises the following steps:
- Creating one eclipse extension to represent each of the states pertaining to the device state machine.
- For each possible event on the device state machine, create an eclipse extension to represent the state changes which occur as a consequence of this event.
Defining the device state machine
In order to define the device state machine you should consider three points:
- The operations that can be performed on the device. That is, the events. Examples of events: turn device on, turn device off, start phonebook application.
- The status the device assumes as a consequence of these operations. That is, the sates. Examples of states: turned on, turned off, running phonebook application.
- The operations that can be performed when the device is at a given status. That is, how the possible states constrain the operations. Examples of such constraints: The turn on operation can be performed only if the device is on turned off state, start phonebook application operation cannot be performed if device is on turned off state.
It is highly recommended that you draw a graph which represents the device state machine you are creating in TmL. As an example, see the graph below:
Instantiating the new device on the TmL framework
Creating the device state machine on the TmL framwork
Creating the states for the device state machine
Creating the states for the device state machine
- Create a new Plug-in project using the Eclipse New Project Wizard.
- If this plug-in will be contributed to TmL certify that it is using the naming conventions in Development Conventions and Guidelines or check with TmL committer the best name for that. (ex: org.eclipse.tml.sample)
- Fill provider, version and name and change the default name for activator to this format "<your-plugin-name>Plugin". (ex: SamplePlugin)
- Uncheck option to select a code template.
Configuring the plugin to work with the TmL framework
- Open plugin.xml in the dependencies tab
- Add org.eclipse.tml.common.utilities
