|
|
|
| R2012a Documentation → Simulink | |
Learn more about Simulink |
|
| Contents | Index |
No
#define MDL_SET_INPUT_PORT_SAMPLE_TIME
void mdlSetInputPortSampleTime(SimStruct *S, int_T port, real_T sampleTime, real_T offsetTime)
SimStruct representing an S-Function block.
Index of a port.
Inherited sample time for port.
Inherited offset time for port.
SetInputPortSampleTime(s, port, time)
Instance of Simulink.MSFcnRunTimeBlock class representing the Level-2 MATLAB S-Function block.
Integer value specifying the index of port whose sampling mode is to be set.
Two-element array, [period offset], that specifies the period and offset of the times that this port samples its input.
The Simulink engine invokes this method with the sample time that port inherits from the port to which it is connected.
For C MEX S-functions, if the inherited sample time is acceptable, this method sets the sample time of port to the inherited time, using ssSetInputPortSampleTime and ssSetInputPortOffsetTime. If the sample time is unacceptable, this method generates an error via ssSetErrorStatus. Note that any other input or output ports whose sample times are implicitly defined by virtue of knowing the sample time of the given port can also have their sample times set via calls to ssSetInputPortSampleTime or ssSetOutputPortSampleTime. This method is only valid for simulation, and must be enclosed in a #if defined(MATLAB_MEX_FILE) statement.
For Level-2 MATLAB S-functions, if the inherited sample time is acceptable, this method sets the sample time and offset time using the line
s.InputPort(port).SampleTime = time;
The engine calls this method until all input ports with inherited sample times are specified.
When inherited port-based sample times are specified, the sample time is guaranteed to be one of the following where 0.0 < period < inf and 0.0 <= offset < period.
| Sample Time | Offset Time | |
|---|---|---|
| Continuous | 0.0 | 0.0 |
| Discrete | period | offset |
Constant, triggered, and variable-step sample times are not propagated to S-functions with port-based sample times.
Generally mdlSetInputPortSampleTime is called once per port with the input port sample time. However, there can be cases where this function is called more than once. This happens when the simulation engine is converting continuous sample times to continuous but fixed in minor steps sample times. When this occurs, the original values of the sample times specified in mdlInitializeSizes are restored before this method is called again.
The final sample time specified at the port can be different from (but equivalent to) the sample time specified by this method. This occurs when
The model uses a fixed-step solver and the port has a continuous but fixed in minor step sample time. In this case, the Simulink engine converts the sample time to the fundamental sample time for the model.
The engine adjusts the sample time to be as numerically sound as possible. For example, the engine converts [0.2499999999999, 0] to [0.25, 0].
The S-function can examine the final sample times in mdlInitializeSampleTimes.
C, C++, MATLAB
ssSetInputPortSampleTime, ssSetOutputPortSampleTime, mdlInitializeSampleTimes
Learn more about Simulink through this collection of videos, articles, technical literature and the Getting Started with Simulink Guide.
| © 1984-2012- The MathWorks, Inc. - Site Help - Patents - Trademarks - Privacy Policy - Preventing Piracy - RSS |
