Встраивать S-функцию означает обеспечивать файл TLC для Блока s-function, который заменит C, C++, Фортран или версию языка MATLAB® блока, который использовался в процессе моделирования.
Если встраивание, которое файл TLC не обеспечивается, большинство целей, поддерживает блок путем перекомпиляции S-функции MEX C для блока. Как обсуждено ранее, существуют издержки в использовании памяти, и скорость при использовании C/C++ закодировала S-функцию и ограниченное подмножество mx* Вызовы API поддержаны в контексте генератора кода. Если вы хотите самый эффективный сгенерированный код, необходимо встроить S-функции путем записывания файла TLC для них.
Когда симуляция должна выполнить одну из функций для Блока s-function, это вызывает файл MEX для этой функции. Когда генератор кода выполняет невстроенную S-функцию, он делает так подобным образом, как эта схема иллюстрирует.
Полезно задать две категории встраивания:
Полностью встроенные S-функции
Обертка встроила S-функции
В то время как и встроенный S-функция и удаляет издержки невстроенной S-функции, два подхода отличаются. Первый пример ниже, с помощью timestwo.tlc, рассматривается полностью встроенным файлом TLC, где полное внедрение блока содержится в файле TLC для блока.
Второй пример использует обертку файл TLC. Вместо того, чтобы генерировать алгоритмический код на месте, этот пример вызывает функцию C, которая содержит тело кода. Существует несколько потенциальных выгод для использования обертки файл TLC:
Это обеспечивает путь к S-функции MEX C и сгенерированному коду, чтобы совместно использовать код С. Вы не должны писать код дважды.
Вызванная функция C является оптимизированной стандартной программой.
Несколько из блоков могут существовать в модели, и более эффективно в терминах размера кода сделать, чтобы они вызвали функцию, в противоположность каждому создающему идентичному алгоритмическому коду.
Это обеспечивает способ включить устаревший код С беспрепятственно в сгенерированный код.
Встраивание S-функции предоставляет механизм непосредственно встроенному коду для Блока s-function в сгенерированный код для модели. Вместо того, чтобы вызвать в отдельный исходный файл через указатели функции и обеспечить отдельную структуру данных (SimStruct) для него код кажется “встроенным”, когда следующий рисунок показывает.
S-функция timestwo.c обеспечивает простой пример полностью встроенной S-функции. Этот блок умножает свой вход на 2 и выводит его. Версия MEX C блока находится в файле matlabroot/toolbox/simulink/simdemos/simfeatures/src/timestwo.cmatlabroot/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%implements директива требуется файлами блока TLC и используется целевым Языковым компилятором, чтобы проверить тип блока и язык, поддержанный блоком. %function директива запускает объявление функции и показывает имя функции, Outputs, и аргументы передали ему, block и system. Это соответствующие записи от model.rtw
Последней частью прототипа является Output. Это означает, что любая линия, которая не является директивой TLC, выводится функцией к текущему файлу, который выбран в TLC. Так, ненаправленные линии в Outputs функционируйте становятся сгенерированным кодом для блока.
Самой сложной частью этого примера блока TLC является %roll директива. TLC использует эту директиву, чтобы обеспечить автоматическую генерацию for циклы, в зависимости от ширин ввода/вывода и непрерывны ли входные параметры в памяти. Этот пример использует типичную форму доступа к выходным параметрам и вводит из тела списка, с помощью LibBlockOutputSignal и LibBlockInputSignal получить доступ к выходным параметрам и входным параметрам и выполнить умножение и присвоение. Обратите внимание на то, что этот файл TLC поддерживает любую допустимую ширину сигнала.
Единственной функцией, используемой, чтобы реализовать этот блок, является Outputs. Для более сложных блоков другие функции объявляются также. Можно найти примеры более сложного встраивания файлами TLC в папках matlabroot/toolbox/simulink/simdemos/simfeatures/tlc_cmatlabroot/toolbox/simulink/blocks/tlc_cmatlabroot/rtw/c/tlc/blocks
Эта простая модель использует timestwo S-функция и показывает MdlOutputs функция от сгенерированного modelC
/* 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-функцию наверху, но обеспечивая функцию пользователя.
Это - встраивание файл 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Функциональный BlockTypeSetup называется однажды для каждого типа блока в модели; это не производит выход непосредственно как Outputs функция. Используйте BlockTypeSetup включать прототипа функции в modelHmyfile.c.
Вместо того, чтобы выполнить умножение непосредственно, Outputs функционируйте теперь вызывает функциональный mytimestwo. Все экземпляры этого блока в модели вызывают ту же функцию, чтобы выполнить умножение. Получившаяся функция модели, MdlOutputs, затем становится
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;
}