ssSetSFcnParamTunable (Writing S-Functions)

Make a block parameter tunable

Syntax

void ssSetSFcnParamTunable(SimStruct *S, int_T param, 
int_T isTunable)

Arguments

S
SimStruct representing an S-Function block.

param
Index of the parameter.

isTunable
Valid values are SS_PRM_TUNABLE (tunable), SS_PRM_NOT_TUNABLE (not tunable), or SS_PRM_SIM_ONLY_TUNABLE (tunable only during simulation).

Description

Use this macro in mdlInitializeSizes to specify whether a user can change a dialog parameter during the simulation. The parameter index starts at 0 and is less than ssGetSFcnParamsCount(S). This improves efficiency and provides error handling in the event that an attempt is made to change the parameter.

If you specify the SS_PRM_TUNABLE option, you must create a corresponding run-time parameter (see Creating Run-Time Parameters). You do not have to create a corresponding run-time parameter if you specify the SS_PRM_SIM_ONLY_TUNABLE option.

Note Dialog parameters are tunable by default. However, an S-function should declare the tunability of all parameters, whether tunable or not, to avoid programming errors. If the user enables the simulation diagnostic S-function upgrade needed, Simulink issues the diagnostic whenever it encounters an S-function that fails to specify the tunability of all its parameters.

Languages

See Also

ssGetSFcnParamsCount

ssSetSFcnParamNotTunable ssSetSolverNeedsReset