Code Generation - StateMachines

Ribbon

Design > Diagram > Toolbox > Artifacts

Keyboard Shortcuts

Alt+5 > Artifacts

Other

You can display or hide the Diagram Toolbox by clicking on the or icons at the left-hand end of the Caption Bar at the top of the Diagram View.

1

For each StateMachine you want to model, create a Class diagram.

2

From the 'Class Elements' page of the Diagram Toolbox, drag the 'Class' icon onto your diagram and give the element an appropriate name.

3

Right-click on the Class element and select the 'New Child Diagram | StateMachine' context menu option.

Give the StateMachine diagram an appropriate name.

4

Create the StateMachine model to reflect the appropriate transitions between States.

1

Create a new Class diagram to contain the modeled StateMachine(s) from which you intend to generate code.

2

From the 'Artifacts' page of the Diagram Toolbox, drag the 'Executable StateMachine' icon onto the diagram to create the Artifact element. Name the element and drag its borders out to enlarge it.

3

From the Project Browser, drag the (first) Class element containing a StateMachine diagram onto the Artifact element on the diagram.

The '<element name>: Paste As' dialog displays, with the 'Paste as' field defaulted to 'Property'.

(If the dialog does not display, press Ctrl as you drag the Class element from the Project Browser.)

4

Click on the OK button. The Class element is pasted inside the Artifact as a Part.

5

Repeat steps 3 and 4 for any other Classes with StateMachines that you want to combine and generate code for. These might be:

• Repeat 'drops' of the same Class and StateMachine, modeling parallel objects
• Different Classes and StateMachines, modeling separate interacting objects

6

Right-click on the Artifact element and select the 'Properties' option, and in the 'Language' field click on the drop-down arrow and set the code language to the same language as is defined for the Class elements.

You can now drag this Executable StateMachine Artifact element from the Project Browser onto the diagram any number of times, and modify the Parts to model variations of the system or process, or the same system or process with different programming languages.

1

Right-click on the Executable StateMachine Artifact element and select the 'Simulate > Executable > StateMachines > Generate' ribbon option.

The 'Executable StateMachine Code Generation' dialog displays.

2

In the 'Project output directory' field, type or browse for the directory path under which to create the output files.

During code generation, all existing files in this directory are deleted.

3

Select the Target System. If you are running on WIndows select the 'Local' option. If you are working on Linux choose the 'Remote' option. The choice affects the scripts generated to support the Simulation.

4

In the 'Location of <compiler> installation directory' field, type or browse for the path of the compiler installation directory, to be automatically mapped to the local path (displayed to the left of the field). For each programming language, the paths might resemble these examples:

• Java
  JAVA_HOME     C:\Program Files (x86)\Java\jdk1.7.0_17
• C/C++
  VC_HOME         C:\Program Files (x86)\Microsoft Visual Studio 9.0
• C#
  CS_HOME         C:\Windows\Microsoft.NET\Framework\V3.5

5

Click on the Generate button. The code files are created appropriate to the programming language.

The System Output window displays with an 'Executable StateMachine Output' tab, showing the progress and status of the generation.

During code generation, an automatic validation function is executed to check for diagram or model errors against the UML constraints. Any errors are identified by error messages on the 'Executable StateMachine Output' tab.

Double-click on an error message to display the modeling structure in which the error occurs, and correct the mistake before re-generating the code.

6

When the code generates without error, click on the Artifact element and select the 'Simulate > Executable > StateMachines > Build' ribbon option to compile the code.

The System Output window displays with a 'Build' tab, showing the progress and status of the compilation. Notice that the compilation includes configuration of the simulation operation.

SEND_EVENT

Send an event to a receiver (the Part). For example:

     %SEND_EVENT("event1", "Part1")%

BROADCAST_EVENT

Broadcast an event to all receivers. For example:

     %BROADCAST_EVENT("event2")%

1

Select the ribbon option 'Simulate > Dynamic Simulation > Simulator > Apply Simulator Layout' to display the Simulation window and the Simulation Events window together

Dock the two windows in a convenient area of the screen.

2

On the diagram or Project Browser, click on the Artifact element and select the 'Simulate > Executable > StateMachines > Run' ribbon option.

The first StateMachine diagram in the series displays with the simulation of the process already started. In the Simulation window, the processing steps are indicated in this format:

     [03516677]     Part1[Class1].Initial_367_TO_State4_142 Effect

     [03516683]     Part1[Class1].StateMachine_State4 ENTRY

     [03516684]     Part1[Class1].StateMachine_State4 DO

     [03518375]     Blocked

3

Click on the appropriate Simulation window toolbar buttons to step through the simulation as you prefer.

When the simulation finishes at the Exit or Terminate element, click on the Stop button in the Simulation window toolbar.

4

Where the trace shows Blocked, the simulation has reached a point where a Trigger event has to occur before processing can continue. On the Simulation Events window, in the 'Waiting Triggers' column, double-click on the appropriate Trigger.

When the Trigger is fired, the simulation continues to the next pause point, Trigger or exit.