Real-Time Workshop

Storage Classes of Tunable Parameters

Real-Time Workshop defines four storage classes for tunable parameters. You must declare a tunable parameter to have one of the following storage classes:

• SimulinkGlobal(Auto): SimulinkGlobal(Auto) is the default storage class. Real-Time Workshop stores the parameter as a member of rtP. Each member of rtP is initialized to the value of the corresponding workspace variable at code generation time.
• ExportedGlobal: The generated code instantiates and initializes the parameter and model_private.h exports it as a global variable. An exported global variable is independent of the rtP data structure. Each exported global variable is initialized to the value of the corresponding workspace variable at code generation time.
• ImportedExtern: model_private.h declares the parameter as an extern variable. Your code must supply the proper variable definition and initializer, if any.
• ImportedExternPointer: model_private.h declares the variable as an extern pointer. Your code must supply the proper pointer variable definition and initializer, if any.

The generated code for model.h includes model_private.h in order to make the extern declarations available to subsystem files.

As an example of how the storage class declaration affects the code generated for a parameter, consider the model shown below.

The workspace variable Kp sets the gain of the Gain1 block. Assume that the value of Kp is 5.0. Table 5-2 shows the variable declarations and the code generated for the gain block when Kp is declared as a tunable parameter. An example is shown for each storage class.

Note    Real-Time Workshop uses column-major ordering for two-dimensional signal and parameter data. When interfacing your hand-written code interfaces to such signals or parameters via ExportedGlobal, ImportedExtern, or ImportedExternPointer declarations, make sure that your code observes this ordering convention.

Note that the symbolic name Kp is preserved in the variable and field names in the generated code.

Table 5-2: Tunable Parameter Storage Declarations and Code

Storage Class	Generated Variable Declaration and Code
SimulinkGlobal(Auto)	typedef struct Parameters_tag {   real_T Kp; } Parameters; . . Parameters rtP = {   5.0 }; . . rtY.Out1 = (rtP.Kp * rtb_u);
ExportedGlobal	extern real_T Kp; . . real_T Kp = 5.0; . . rtY.Out1 = (Kp * rtb_u);
ImportedExtern	extern real_T Kp; . . rtY.Out1 = (Kp * rtb_u);
ImportedExternPointer	extern real_T *Kp; . . rtY.Out1 = ((*Kp) * rtb_u);

Tunable Parameter Storage

Using the Model Parameter Configuration Dialog