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

Создание входных портов для C S-функций

Для создания и конфигурирования портов ввода, mdlInitializeSizes метод должен сначала указать количество входных портов S-функции, используя ssSetNumInputPorts. Затем, для каждого входного порта, метод должен указать

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

if (!ssSetNumInputPorts(S, 2)) return;

for (i = 0; i < 2; i++) {
  /* Input has direct feedthrough */
  ssSetInputPortDirectFeedThrough(S, i, 1);

  /* Input is a real signal */
  ssSetInputPortComplexSignal(S, i, COMPLEX_NO);

  /* Input is a dynamically sized 2-D matrix */
  ssSetInputPortMatrixDimensions(S ,i, 
     DYNAMICALLY_SIZED, DYNAMICALLY_SIZED);

  /* Input inherits its sample time */
  ssSetInputPortSampleTime(S, i,INHERITED_SAMPLE_TIME);

  /* Input signal must be contiguous */
  ssSetInputPortRequiredContiguous(S, i, 1);

  /* The input port cannot share memory */
  ssSetInputPortOverWritable(S, i, 0);
}

#if defined(MATLAB_MEX_FILE)
#define MDL_SET_INPUT_PORT_DIMENSION_INFO
static void mdlSetInputPortDimensionInfo(SimStruct        *S,
                                  int_T            port,
                                  const DimsInfo_T *dimsInfo)
{
    if(!ssSetInputPortDimensionInfo(S, port, dimsInfo)) return;
}
#endif

Создание выходных портов для C S-функций

Для создания и конфигурирования портов вывода, mdlInitializeSizes метод должен сначала указать количество выходных портов S-функции, используя ssSetNumOutputPorts. Затем для каждого выходного порта метод должен указать

Пример инициализации входного порта S-функции см. в разделе Создание входных портов для C S-функций. Эта же процедура используется для инициализации выходных портов S-функции, но с соответствующим макросом выходного порта.

Скалярное расширение входных данных

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

Функция Level-2 MATLAB ® S использует правила скалярного расширения по умолчанию, если входные и выходные порты задаются динамически (см. раздел Скалярное расширение входов и параметров в разделе Использование Simulink).

При включенном скалярном расширении S-функция mdlInitializeSizes метод должен определять динамический размер входного и выходного портов. Модуль Simulink использует метод по умолчанию для задания размеров портов ввода и вывода. Если блок имеет более двух входов, входные сигналы могут быть скалярными или широкими, где все широкие сигналы имеют одинаковое количество элементов. В этом случае механизм устанавливает размеры выходных портов на ширину широких входных сигналов и расширяет любые скалярные входы на эту ширину. Если широкие входы управляются векторами 1-D и 2-D, то выход является сигналом вектора 2-D, а скалярные входы расширяются до сигнала вектора 2-D.

Если скалярное расширение не включено, модуль предполагает, что все порты (входной и выходной порты) должны иметь одинаковые размеры, и устанавливает для всех размеров портов одинаковые размеры, заданные одним из управляющих блоков.

Лучший способ понять, как использовать скалярное расширение, это рассмотреть пример sfcndemo_sfun_multiport. Эта модель содержит три S-функциональных блока, каждый из которых имеет несколько входных портов. S-функция sfun_multiport.c используется в этих блоках устанавливает SS_OPTION_ALLOW_INPUT_SCALAR_EXPANSION вариант в его mdlInitializeSizes способ, допускающий скалярное расширение входов. S-функция определяет динамический размер входов и выходов. Поэтому во время распространения сигнала механизм устанавливает ширину входных портов на ширину сигнала, соединенного с портом, и ширину выходных портов на ширину любого широкого входного сигнала. mdlOutputs способ выполняет поэлементную сумму по входным сигналам, расширяя при необходимости любые скалярные входы.

/* Calculate an element-by-element sum of the input signals.
   yWidth is the width of the output signal. */

for (el = 0; el < yWidth; el++) {

   int_T  port;
   real_T sum = 0.0;
   for (port = 0; port < nInputPorts; port++) {
      /* Get the input signal value */
      InputRealPtrsType uPtrs = 
                   ssGetInputPortRealSignalPtrs(S,port);

      if (el < ssGetInputPortWidth(S,port)) {
         /* Input is a wide signal. Use specific element */
         sum = sum + ((real_T)signs[port] * (*uPtrs[el]));

      } else { 
         /* Use the scalar value to expand the signal */
         sum = sum + ((real_T)signs[port] * (*uPtrs[0]));
      }
   }
}

Маскированные мультипортовые S-функции

Если вы разрабатываете маскированные мультипортовые S-функциональные блоки, количество портов которых зависит от какого-либо параметра, и хотите поместить их в библиотеку Simulink, необходимо указать, что маска изменяет внешний вид блока. Для этого выполните команду

  set_param(blockname,'MaskSelfModifiable','on')

в командной строке MATLAB перед сохранением библиотеки, где blockname - полный путь к блоку. Если не указать, что маска изменяет внешний вид блока, экземпляр блока в модели возвращается к количеству портов в библиотеке при загрузке модели или обновлении связи с библиотекой.