Access Bus Signals Through Stateflow Structures

A Stateflow® structure is a data type that you define from a Simulink.Bus object. Using Stateflow structures, you can bundle data of different size and type to create:

  • Inputs and outputs that access Simulink® bus signals from Stateflow charts, Truth Table blocks, and MATLAB Function blocks.

  • Local data in Stateflow charts, truth tables, graphical functions, MATLAB® functions, and boxes.

  • Temporary data in Stateflow graphical functions, truth tables, and MATLAB functions.

For example, in the model sf_bus_demo, a Stateflow chart receives a bus input signal by using the structure inbus and outputs a bus signal from the structure outbus. The input signal comes from the Simulink Bus Creator block COUNTERBUSCreator, which bundles signals from two other Bus Creator blocks. The output structure outbus connects to a Simulink Bus Selector block. Both inbus and outbus derive their type from the Simulink.Bus object COUNTERBUS.

The elements of a Stateflow structure data type are called fields. Fields can be any combination of individual signals, muxed signals, vectors, and other structures (also called substructures). Each field has its own data type. The data type does not have to match the type of any other field in the structure. For example, in the model sfbus_demo, each of the structures inbus and outbus has two fields:

  • inputsignal is a substructure with one field, input.

  • limits is a substructure with two fields, upper_saturation_limit and lower_saturation_limit.

Define Stateflow Structures

  1. To define the structure data type, create a Simulink bus object in the base workspace, as described in Create Bus Objects with the Bus Editor (Simulink).

  2. Add a data object to the chart, as described in Add Stateflow Data.

    To define temporary structures in truth tables, graphical functions, and MATLAB functions, add a data object to your function. For more information, see Add Data Through the Model Explorer.

  3. Set the Scope property for the structure. Your choices are:

    • Input

    • Output

    • Local

    • Parameter

    • Temporary

  4. Set the Type property for the structure. Depending on its scope, a Stateflow structure can have one of these data types.

    TypeDescription
    Inherit: Same as Simulink

    This option is available for input structures only. The input structure inherits its data type from the Simulink bus signal in your model that connects to it. The Simulink bus signal must be a nonvirtual bus. For more information, see Virtual and Nonvirtual Buses.

    In the base workspace, specify a Simulink.Bus object with the same properties as the bus signal that connects to the Stateflow input structure. These properties must match:

    • Number, name, and type of inputs

    • Dimension

    • Sample Time

    • Complexity

    • Sampling Mode

    If the input signal comes from a Bus Creator block, in the Bus Creator dialog box, specify an appropriate bus object for Output data type field. When you specify the bus object, Simulink verifies that the properties of the Simulink.Bus object in the base workspace match the properties of the Simulink bus signal.

    Bus: <object name>

    In the Type field, replace <object name> with the name of the Simulink.Bus object that defines the Stateflow structure.

    For input or output structures, you are not required to specify the bus signal in your Simulink model that connects to the Stateflow structure. If you do specify a bus signal, its properties must match the Simulink.Bus object that defines the Stateflow structure.

    <date type expression>

    In the Type field, replace <data type expression> with an expression that evaluates to a data type. For example:

For example, in the sfbus_demo model, the input structure inbus and the output structure outbus derive their type through a type specification of the form Bus: COUNTERBUS.

Specify Structure Types by Calling the type Operator

To specify structure types, you can use expressions that call the Stateflow type operator. This operator sets the type of one structure to the type of another structure in the Stateflow chart. For example, in the sf_bus_demo model, a type operator expression specifies the type of the local structure counterbus_struct in terms of the input structure inbus. Both structures are defined from the Simulink.Bus object COUNTERBUS. For more information, see Derive Data Types from Other Data Objects.

Virtual and Nonvirtual Buses

Simulink models support virtual and nonvirtual buses. Nonvirtual buses read their inputs from data structures stored in contiguous memory. Virtual buses read their inputs from noncontiguous memory. For more information, see Virtual and Nonvirtual Buses (Simulink).

Stateflow charts support only nonvirtual buses. Stateflow input structures can accept virtual bus signals and convert them to nonvirtual bus signals. Stateflow input structures cannot inherit properties from virtual bus signals. If the input to a chart is a virtual bus, set the Type property of the input structure through a type specification of the form Bus: <object name>.

Debug Structures

To debug a Stateflow structure, open the Stateflow Breakpoints and Watch window and examine the values of structure fields during simulation. To view the values of structure fields at the command line, use dot notation to index into the structure. For more information, see Watch Stateflow Data Values and Index Substructures and Fields.

Guidelines for Structure Data Types

  • Define each structure from a Simulink.Bus object in the base workspace.

  • Structures cannot have a constant scope.

  • Structures of parameter scope must be tunable.

  • Data array objects cannot contain structures.

  • You cannot define structures for Stateflow machines. For more information, see Hierarchy of Stateflow Objects.

See Also

Related Examples

More About