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

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

Чтобы создать и сконфигурировать входные порты, 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

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

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

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

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

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

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

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

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

Лучший способ понять, как использовать скалярное расширение, это рассмотреть пример sfcndemo_sfun_multiport. Эта модель содержит три блоков s-function, каждый с несколькими входными портами. S-функция sfun_multiport.c используется в этих блоках, устанавливает SS_OPTION_ALLOW_INPUT_SCALAR_EXPANSION опция в своей mdlInitializeSizes способ, позволяющий скалярное расширение входов. S-функция задает, что ее входы и выходы динамически. Поэтому во время распространения сигнала двигатель устанавливает ширину входных портов на ширину сигнала, соединенного с портом, и ширину выходных портов на ширину любого широкого входного сигнала. The 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-function, количество портов которых изменяется на основе некоторого параметра и хотите поместить их в библиотеку Simulink, необходимо указать, что маска изменяет внешний вид блока. Для этого выполните команду

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

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