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

Встраивание S-функции

Встраивать S-функцию означает обеспечивать файл TLC для Блока s-function, который заменит C, C++, Фортран или версию языка MATLAB^® блока, который использовался во время симуляции.

Невстроенная S-функция

Если встраивание, которое файл TLC не обеспечивается, большинство целей, поддерживает блок путем перекомпиляции S-функции MEX C для блока. Как обсуждено ранее, существуют издержки в использовании памяти, и скорость при использовании C/C++ закодировала S-функцию и ограниченное подмножество вызовов API mx*, поддержанных в контексте генератора кода. Если вы хотите самый эффективный сгенерированный код, необходимо встроить S-функции путем записывания файла TLC для них.

Когда симуляция должна выполнить одну из функций для Блока s-function, это вызывает файл MEX для этой функции. Когда генератор кода выполняет невстроенную S-функцию, он делает так подобным образом, как эта схема иллюстрирует.

Типы встраивания

Полезно задать две категории встраивания:

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

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

Полностью встроенный пример S-функции

Встраивание S-функции предоставляет механизм непосредственно встроенному коду для Блока s-function в сгенерированный код для модели. Вместо того, чтобы вызвать в отдельный исходный файл через указатели функции и поддержать отдельную структуру данных (SimStruct) для него, код кажется “встроенным”, когда следующие данные показывают.

S-функция timestwo.c обеспечивает простой пример полностью встроенной S-функции. Этот блок умножает свой вход на 2 и выводит его. Версия MEX C блока находится в файле matlabroot/toolbox/simulink/simdemos/simfeatures/src/timestwo.c и встраивание, файлом TLC для блока является matlabroot/toolbox/simulink/simdemos/simfeatures/tlc_c/timestwo.tlc.

%implements "timestwo" "C"

%% Function: Outputs ==========================================
%%
%function Outputs(block, system) Output
  /* %<Type> Block: %<Name> */
  %%
  /* Multiply input by two */
  %assign rollVars = ["U", "Y"]
  %roll idx = RollRegions, lcv = RollThreshold, block, "Roller", rollVars
    %<LibBlockOutputSignal(0, "", lcv, idx)> = \
    %<LibBlockInputSignal(0, "", lcv, idx)> * 2.0;
  %endroll
%endfunction

/* Model output function */
static void timestwo_ex_output(int_T tid)
{

  /* S-Function Block: <Root>/S-Function */
  /* Multiply input by two */
  timestwo_ex_B.timestwo_output = timestwo_ex_P.Constant_Value 
	 * 2.0;

  /* Outport: '<Root>/Out1' */
  timestwo_ex_Y.Out1 = timestwo_ex_B.timestwo_output;
}

Обертка встроенный пример S-функции

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

Это - встраивание файл TLC для версии обертки блока timestwo.

%implements "timestwo" "C"

%% Function: BlockTypeSetup ==================================
%%
%function BlockTypeSetup(block, system) void
  %% Add function prototype to model's header file
  %<LibCacheFunctionPrototype...
   ("extern void mytimestwo(real_T* in,real_T* out,int_T els);")>
  %% Add file that contains "myfile" to list of files to be compiled
  %<LibAddToModelSources("myfile")>
%endfunction

%% Function: Outputs ==========================================
%%
%function Outputs(block, system) Output
  /* %<Type> Block: %<Name> */
  %assign outPtr = LibBlockOutputSignalAddr(0, "", "", 0)
  %assign inPtr = LibBlockInputSignalAddr(0, "", "",0)
  %assign numEls = LibBlockOutputSignalWidth(0)
  /* Multiply input by two */
  mytimestwo(%<inPtr>,%<outPtr>,%<numEls>);
  
%endfunction

static void timestwo_ex_output(int_T tid)
{
  /* S-Function Block: <Root>/S-Function */
  /* Multiply input by two */
  mytimestwo(&model_B.Constant_Value,&model_B.S_Function,1);

  /* Outport Block: <Root>/Out1 */
model_Y.Out1 = model_B.S_Function;
}