Документация

Определите номер состояний и начальных условий

Используя таблицу Settings, можно задать количество дискретных и непрерывных состояний и их начальных условий.

Можно ввести значения начальных условий как список запятых-seperated, (например, 1,1,1) или как вектор (например, [1 1 1]). Количество начальных условий должно быть равно количеству обозначенных состояний.

Установите размещение массивов

Установите размещение массивов своего кода C/C++. Можно выбрать одну из перечисленных в таблице опций.

Выберите Sample Mode

Выберите демонстрационный режим своей S-функции. Демонстрационный режим определяет длину интервала между временами, когда S-функция обновляет свой выход. Можно выбрать одну из следующих опций:

Определите номер PWorks

Установите PWorks, количество указателей данных используется S-функцией. PWorks точки к памяти за жизненный цикл блока. Если вы вводите значение, чем 0 для Number of PWorks это добавляет указатель, void **PW, ко всем функциям в Разработчике S-функции. Например, можно объявить и инициализировать указатель на файл или память в Start_wrapper, получите доступ к нему в Outputs_wrapper, Update_wrapper, и Derivatives_wrapper функции, и освобождают его в Terminate_wrapper функция. Код, написанный в этих функциях, вызван mdlStart, mdlOutputs, mdlUpdate, mdlDerivatives, и mdlTerminate методы. Смотрите Скользящее среднее значение в качестве примера с Запуском и Оконечный и Сочетание с помощью Классов Cpp в Демонстрациях S-функции.

Включите доступ к SimStruct

Сделайте SimStruct S) доступный для функций обертки, которые использует Разработчик S-функции. Этот выбор позволяет вам использовать SimStruct макросы и функции с вашим кодом в Outputs_wrapper, Derivatives_wrapper, и Update_wrapper функции. Когда вы включаете эту установку, SimStruct *S добавляется к списку параметров.

Например, с этой включенной опцией, можно использовать макросы такой как ssGetT в коде, который вычисляет S-функцию выходные параметры:

double t = ssGetT(S);
  if(t < 2) 
  {
    y0[0] = u0[0];
  } else 
  {
    y0[0]= 0.0;
  }

Прямое сквозное соединение

Установите флажок Direct Feedthrough на таблице Settings, если значения от шага текущего времени S-входных-параметров-функции используются для расчета его выходные параметры. Механизм Simulink использует эту информацию, чтобы обнаружить алгебраические циклы, созданные, прямо или косвенно соединяя S-функцию выход с S-входным-параметром-функции.

Вычислите Выходные параметры Используя Выходной метод

В Разработчике S-функции используйте Outputs_wrapper метод, чтобы ввести код, который вычисляет выходные параметры S-функции на каждом шаге времени симуляции. Обратите внимание на то, что при генерации кода S-функции, S-Function Builder генерирует метод обертки с помощью имени модели и функции обертки в форме <system_name>_<function_name>_wrapper. Например, если именем вашей модели является dsfunc_builder, выходной метод появляется как dsfunc_builder_Output_wrapper в редакторе S-Function Builder. Если у вас еще нет имени для вашего блока S-Function Builder, это появляется как system_Output_wrapper.

См. следующий код для примера Outputs метод:

void sfun_Outputs_wrapper(const real_T *u,
                          real_T       *y,
				const real_T *xD, /* optional */
				const real_T *xC, /* optional */
				const real_T  *param0, /* optional */
				int_T p_width0 /* optional */
				real_T  *param1 /* optional */
				int_t p_width1 /* optional */
				int_T y_width, /* optional */
				int_T u_width) /* optional */
{

/* Your code inserted here */
}

где sfun имя S-функции. Разработчик S-функции вставляет вызов этой функции обертки в mdlOutputs метод коллбэка, который это генерирует для вашей S-функции. Механизм Simulink вызывает mdlOutputs метод в каждом времени симуляции или шаге расчета продвигается, чтобы вычислить S-функцию выход. mdlOutputs метод в свою очередь вызывает функцию обертки, содержащую ваш выходной код. Ваш выходной код затем вычисляет и возвращает S-функцию выход.

mdlOutputs метод передает некоторых или все следующие аргументы к выходной функции обертки.

Эти аргументы разрешают вам вычислять выход блока в зависимости от его входных параметров и, опционально, его состояний и параметров. Код, который вы вводите в этом поле, может вызвать внешние функции, объявленные в заголовочных файлах или внешних объявлениях на таблице Libraries, которая позволяет вам использовать существующий код, чтобы вычислить выходные параметры S-функции.

Обновите дискретные состояния Используя метод обновления

Используйте Update_wrapper функция, чтобы ввести код, который вычисляет значения дискретных состояний на следующем временном шаге согласно значениям на шаге текущего времени. См. следующий код:

void sfun_Update_wrapper(const real_T *u,
                         const real_T *y,
                         real_T *xD,
                         const real_T  *param0,  /* optional */
                         int_T p_width0, /* optional */
                         real_T  *param1,/* optional */
                         int_T p_width1, /* optional */
                         int_T y_width, /* optional */
                         int_T u_width) /* optional */
{

	/* Your code inserted here. */

}

где sfun имя S-функции. Разработчик S-функции вставляет вызов этой функции обертки в mdlUpdate метод коллбэка, который это генерирует для S-функции. Механизм Simulink вызывает mdlUpdate метод в конце каждого временного шага, чтобы получить значения дискретных состояний на следующем временном шаге (см. Взаимодействие Engine Simulink с S-функциями C). На следующем временном шаге механизм передает обновленные состояния обратно mdlOutputs метод.

mdlUpdate метод коллбэка, сгенерированный для S-функции, передает следующие аргументы Update_wrapper функция:

Смотрите Вычисляют Выходные параметры Используя Выходной Метод для значений и использования этих аргументов. Ваш код должен использовать переменную дискретных состояний, xD, возвращать значения дискретных состояний, которые это вычисляет. Аргументы позволяют вашему коду вычислять дискретные состояния как функции S-входных-параметров-функции, выходных параметров, и, опционально, параметров. Ваш код может вызвать внешние функции, объявленные в редакторе кода.

Вычислите непрерывные состояния Используя метод производных

Если S-функция имеет непрерывные состояния, используйте Derivatives_wrapper функция, чтобы ввести код, требуемый вычислить производные состояния. Введите код для mdlDerivatives функция, чтобы вычислить производные непрерывного редактора состояний под этим полем. Объявление в качестве примера функции может быть похожим на следующее:

void system_Derivatives_wrapper(const real_T *u,
				      const real_T *y, 
				      real_T *dx,
				      real_T *xC, 
				      const real_T  *param0,  /* optional */
				      int_T p_width0, /* optional */
				      real_T  *param1,/* optional */
	 			     int_T p_width1, /* optional */
				      int_T y_width, /* optional */
		 		     int_T u_width) /* optional */
{

	/* Your code inserted here. */

}

где system имя S-функции.

Разработчик S-функции вставляет вызов этой функции обертки в mdlDerivatives метод, который это генерирует для S-функции. Механизм Simulink вызывает mdlDerivatives метод в конце каждого временного шага, чтобы получить производные непрерывных состояний (см. Взаимодействие Engine Simulink с S-функциями C). Решатель Simulink численно интегрирует производные, чтобы определить непрерывные состояния на следующем временном шаге. На следующем временном шаге механизм передает обновленные состояния обратно mdlOutputs метод. Для получения дополнительной информации о том, как механизм Simulink взаимодействует с S-функциями, смотрите Взаимодействие Engine Simulink с S-функциями C.

mdlDerivatives метод, сгенерированный для S-функции, передает следующие аргументы функции обертки производных:

dx аргумент является указателем на массив, ширина которого совпадает с количеством непрерывных производных, заданных на панели Settings. Ваш код должен использовать этот массив, чтобы возвратить значения производных, которые это вычисляет. Смотрите, что объяснение под Вычисляет Выходные параметры Используя Выходной метод Метода для значений и использования других аргументов. Аргументы позволяют вашему коду вычислять производные в зависимости от S-входных-параметров-функции, выходных параметров, и, опционально, параметров. Ваш код может вызвать внешние функции, объявленные в редакторе кода.

Выделите и освободите память Используя запуск и оконечные методы

Используйте Start_wrapper метод, чтобы записать код, чтобы выделить память в начале симуляции. На выделенное ссылается Pworks для использования в S-функции. Точно так же используйте Terminate_wrapper метод, чтобы записать код в свободный память, выделенная в Start_wrapper метод. На память ссылается PWorks может также быть замечен Terminate и должен быть освобожден здесь.

Смотрите Набор Количество PWorks, чтобы узнать больше о PWorks.