Edit on GitHub

C Code Generation

This example demonstrates how to generate C code from a statechart. We will use a simple light switch example and focus on the generator model.

Generator Model

In order to generate code we need to specify which code generator to use and into which folder to generate. For this, we need to create a so-called generator model. To do so,

  • Select the models folder in the Project Explorer
  • Right-click and choose New -> Code generator model
  • Follow the wizard to select the C code generator and the state machine for which you want to generate C code

The new generator model will look similar to this one:

Simple C generator model

This is the simplest possible generator model. Line 1 defines which code generator to use. Line 3 refers to the statechart model. Lines 6 and 7 specify the target location for the generated artifacts.

Besides setting up the target location, the generator model allows you to adjust several aspects of the generated code like naming, license comments or function inlining. Press [Ctrl]+[Space] to get a list of available features. For more information, please refer to our documentation.

Content assist in generator model

Invoking Code Generation

Code generation is usually invoked each time the statechart model is saved. This behavior can be disabled by unchecking the option Project -> Build Automatically. You can always manually invoke the code generation with Generate Code Artifacts in the context menu of the generator model.

The Example Application

As an example application we will use the light switch example with brightness adjustment from the Basic Tutorial.

Light switch model

Our application is a simple interactive console with which the user can switch the light on or off. The complete application code is implemented in main.c:

Application code

The interesting parts are the following:
  • Line 14 instantiates the state machine
  • Line 17 initializes the state machine, in particular all variables are set to a proper value
  • Line 18 enters the state machine; from this point on the state machine is ready to react on incoming events
  • Line 24 raises the On event in the state machine which causes the corresponding transition to be taken
  • Line 26 raises the Off event in the state machine

You can run the application with Run As -> Local C/C++ Application on the project. A console should open and ask you for input like in the screenshot below.

Light switch console application

Download examples

Drag to install

Drag to your running YAKINDU Statechart Tools (min. version 2.8.0) workspace.

Back to overview