Можно исследовать, как механизм Simulink® взаимодействует с S-функциями с двух точек зрения:
Перспектива процесса, i.e., в которых точках в симуляции механизм вызывает S-function.
Перспектива данных, i.e., как механизм и S-функция обмениваются информацией во время симуляции.
Следующие рисунки показывают порядок, в котором механизм Simulink вызывает методы коллбэка в S-функции. Сплошные прямоугольники указывают на коллбэки, которые всегда происходят во время инициализации модели или на каждом временном шаге. Пунктирные прямоугольники указывают на коллбэки, которые могут произойти во время инициализации и/или в некоторых или всех временных шагах во время цикла симуляции. См. документацию для каждого метода коллбэка, чтобы определить точные обстоятельства, при которых механизм вызывает коллбэк.
Примечание
Схема представления процесса представляет выполнение S-функций, которые содержат непрерывные и дискретные состояния, включают обнаружение пересечения нулем и находятся в модели, которая использует решатель переменного шага. Другие решатели не используют определенные шаги в схеме. Для лучшего понимания того, как механизм Simulink выполняет вашу конкретную S-функцию, запустите модель, содержащую S-функцию с помощью отладчика Simulink. Для получения дополнительной информации смотрите Введение в Отладчик.
В следующем цикле инициализации модели механизм Simulink конфигурирует S-функцию для предстоящей симуляции. Механизм всегда выполняет необходимые вызовы к mdlInitializeSizes и mdlInitializeSampleTime чтобы настроить основные атрибуты S-функции, включая порты ввода и вывода, диалоговые параметры S-функции, работают векторы, шаги расчета, и т.д.
Механизм вызывает дополнительные методы, по мере необходимости, завершить инициализацию S-функции. Например, если использование S-функции работает векторы, механизм вызывает mdlSetWorkWidths. Кроме того, если mdlInitializeSizes метод задержал подготовку атрибутов порта ввода и вывода, механизм вызывает любые методы, необходимые, чтобы завершить инициализацию портов, такую как mdlSetInputPortWidth, во время распространения сигнала. mdlStart вызовы метода mdlCheckParameters и mdlProcessParameters методы, если S-функция использует диалоговые параметры.
Примечание
mdlInitializeSizes метод коллбэка также запускается, когда вы вводите имя скомпилированной S-функции в диалоговое окно S-Function Block Parameters.
После инициализации механизм Simulink выполняет следующий цикл симуляции. Если цикл симуляции прерван, или вручную или когда ошибка происходит, механизм переходит непосредственно к mdlTerminate метод. Если симуляция была вручную остановлена, механизм сначала завершает шаг текущего времени прежде, чем вызов mdlTerminate.
Если ваша модель содержит несколько Блоков s-function на данном уровне иерархии модели, механизм вызывает конкретный метод для каждой S-функции прежде, чем перейти к следующему методу. Например, механизм вызывает весь mdlInitializeSizes методы прежде, чем вызвать любой mdlInitializeSampleTimes методы. Механизм использует блок отсортированный порядок определить порядок выполнить S-функции. Чтобы узнать больше, как механизм определяет порядок выполнения блока, смотрите Порядок выполнения Управления и Отображения.
Если вы используете продукт Simulink Coder™, чтобы сгенерировать код для модели, содержащей S-функции, механизм Simulink не выполняет целую вызывающую последовательность, обрисованную в общих чертах выше. Инициализация продолжает, как обрисовано в общих чертах выше, пока механизм не достигает mdlStart метод. Механизм затем вызывает методы S-функции, показанные в следующем рисунке, где mdlRTW метод уникален для продукта Simulink Coder.
Если S-функция находится в условно выполняемой подсистеме, для сгенерированного кода возможно чередовать вызовы mdlInitializeConditions и mdlStart. Считайте следующую модель Simulink sfcndemo_enablesub.
Модель содержит две невиртуальных подсистемы, условно выполняемую активированную подсистему под названием Сброс и атомарную подсистему под названием Атомарный. Каждая подсистема содержит Блок s-function, который вызывает S-функцию dsfunc.c, который моделирует дискретную систему в пространстве состояний с двумя состояниями. Активированный Сброс подсистемы сбрасывает значения состояния, когда подсистема включена, и выходные значения, когда подсистема отключена.
Используя цель типового в реальном времени (GRT), сгенерированный код для Start всей модели вызовы функции Start функции этих двух подсистем прежде, чем вызвать MdlInitialize всей модели функция, как показано в следующем коде:
void MdlStart(void)
{
/* snip */
/* Start for enabled SubSystem: '<Root>/Reset' */
sfcndemo_enablesub_Reset_Start();
/* end of Start for SubSystem: '<Root>/Reset' */
/* Start for atomic SubSystem: '<Root>/Atomic' */
sfcndemo_enablesub_Atomic_Start();
/* end of Start for SubSystem: '<Root>/Atomic' */
MdlInitialize();Start функция для активированной подсистемы вызывает InitializeConditions подсистемы функция:
void sfcndemo_enablesub_Reset_Start(void)
{
sfcndemo_enablesub_Reset_Init();
/* snip */
}MdlInitialize функция, вызванная в MdlStart, содержит вызов InitializeConditions функция для атомарной подсистемы:
void MdlInitialize(void)
{
/* InitializeConditions for atomic SubSystem:
'<Root>/Atomic' */
sfcndemo_enablesub_Atomic_Init();
}Поэтому Start всей модели функционируйте вызовы чередований Start и InitializeConditions функции для этих двух подсистем и S-функции они содержат.
Для получения дополнительной информации о продукте Simulink Coder и как это взаимодействует с S-функциями, смотрите S-функции и Генерацию кода (Simulink Coder).
Когда вы запускаете модель Simulink в режиме external mode, вызывающая последовательность для стандартных программ S-функции изменяется как показано в следующем рисунке.
Механизм вызывает mdlRTW однажды, когда это переходит к режиму external mode и снова каждый раз, параметр изменяется или когда вы нажимаете Update Model на вкладке Modeling.
Примечание
Выполнение модели Simulink в режиме external mode требует продукта Simulink Coder.
Блоки s-function имеют сигналы ввода и вывода, параметры и внутренние состояния, плюс другие общие рабочие области. В общем случае блокируйтесь, вводы и выводы записаны в и считаны из, вектор блока I/O. Входные параметры могут также прибыть из
Внешние входные параметры через корневые блоки Inport
Основывайтесь, если входной сигнал не связан или основан
Блокируйтесь выходные параметры могут также перейти к внешним выходным параметрам через корневые блоки Выходного порта. В дополнение к сигналам ввода и вывода S-функции могут иметь
Непрерывные состояния
Дискретные состояния
Другие рабочие области такой как действительные, целочисленные, или указатель работают векторы
Можно параметрировать Блоки s-function передающими параметрами им использующий диалоговое окно S-Function Block Parameters.
Следующий рисунок показывает общее отображение между этими различными типами данных.
S-функция mdlInitializeSizes стандартная программа устанавливает размеры различных сигналов и векторов. Методы S-функции, названные во время цикла симуляции, могут определить размеры и значения сигналов.
Метод S-функции может получить доступ к входным сигналам двумя способами:
Через указатели
Используя непрерывные входные параметры
Во время цикла симуляции получите доступ к использованию входных сигналов
InputRealPtrsType uPtrs = ssGetInputPortRealSignalPtrs(S,portIndex)
Это возвращает массив указателей для входного порта с индексом portIndex, где portIndex запускается в 0. Существует один массив указателей для каждого входного порта. Чтобы получить доступ к элементу этого массива, необходимо использовать
*uPtrs[element]
Следующая фигура описывает, как получить доступ к входным сигналам S-функции с двумя входными параметрами.
Как показано на предыдущем рисунке, указатели входного массива могут указать на места, состоящие из нескольких несмежных участков, в памяти.
Можно получить выходной сигнал при помощи этого кода.
real_T *y = ssGetOutputPortSignal(S,outputPortIndex);
mdlInitializeSizes S-функции метод может указать, что элементы его входных сигналов должны занять непрерывные области памяти, с помощью ssSetInputPortRequiredContiguous. Если входные параметры непрерывны, другие методы могут использовать ssGetInputPortSignal получить доступ к входным параметрам.
В этом разделе описывается получить доступ ко всем входным сигналам конкретного порта и записать им в выходной порт. Предыдущий рисунок показывает, что входной массив указателей может указать на записи, состоящие из нескольких несмежных участков, в векторе блока I/O. Выходные сигналы конкретного порта формируют непрерывный вектор. Поэтому правильный способ получить доступ к входным элементам и записать им в выходные элементы (принимающий порты ввода и вывода имеют равные ширины) состоит в том, чтобы использовать этот код.
int_T element;
int_T portWidth = ssGetInputPortWidth(S,inputPortIndex);
InputRealPtrsType uPtrs = ssGetInputPortRealSignalPtrs(S,inputPortIndex);
real_T *y = ssGetOutputPortSignal(S,outputPortIdx);
for (element=0; element<portWidth; element++) {
y[element] = *uPtrs[element];
}
Частая ошибка состоит в том, чтобы попытаться получить доступ к входным сигналам через адресную арифметику с указателями. Например, если необходимо было поместить
real_T *u = *uPtrs; /* Incorrect */
чуть ниже инициализации uPtrs и замените внутреннюю часть вышеупомянутого цикла с
*y++ = *u++; /* Incorrect */
компиляции кода, но файл MEX могут разрушить программное обеспечение Simulink. Это вызвано тем, что возможно получить доступ к недопустимой памяти (который зависит от того, как вы создаете свою модель). При доступе к входным сигналам неправильно, происходит катастрофический отказ, когда сигналы, вводящие Блок s-function, не непрерывны. Данные сигнала, состоящие из нескольких несмежных участков, происходят, когда сигналы проходят через виртуальные блоки связи, такие как Мультиплексор или Селекторные блоки.
Чтобы проверить что ваша S-функция правильно доступы широкие входные сигналы, передайте реплицированный сигнал каждому входному порту вашей S-функции. Для этого создайте блок Mux с количеством входных портов, равных ширине желаемого сигнала, вводящего вашу S-функцию. Затем соедините ведущий источник с каждым портом S-входного-параметра-функции как показано в следующем рисунке. Наконец, запустите свою S-функцию с помощью этого входного сигнала, чтобы проверить, что это не разрушает и производит ожидаемые результаты.
Level-2 MATLAB S-Function | MATLAB Function | S-Function | S-Function Builder