Можно снова использовать сгенерированный код для идентичных подсистем, которые происходят в нескольких экземплярах в модели и через модели, на которые ссылаются. Для получения дополнительной информации о генерации кода подсистем для повторного использования кода, смотрите Генерацию Управления Функций для Подсистем.
Чтобы использовать S-функцию для повторного использования кода для подсистемы, S-функция должна удовлетворить эти требования:
S-функция должна быть встроена.
Код, сгенерированный от S-функции, не должен использовать статические переменные.
S-функция должна инициализировать свой указатель, работают вектор только в mdlStart
и не прежде.
S-функция не должна быть приемником что данные логов к рабочей области.
S-функция должна указать свои параметры как параметры периода выполнения в mdlSetWorkWidths
. С этой целью S-функция не должна использовать ssWriteRTWParameters
в его mdlRTW
функция.
S-функция не должна быть драйвером устройства.
Кроме того, ваша S-функция должна установить SS_OPTION_WORKS_WITH_CODE_REUSE
отметьте в функции ssSetOptions. Этот флаг указывает, что ваша S-функция удовлетворяет требования для повторного использования кода подсистемы. Если флаг установлен, и ваша S-функция не удовлетворяет требования, генератор кода не генерирует допускающую повторное использование функцию, и вы видите предупреждение.
Можно поместить S-функции в допускающих повторное использование подсистемах библиотеки. В S-файле-функции, набор оба из этих флагов:
SS_OPTION_WORKS_WITH_CODE_REUSE
отметьте в ssSetOptions
функция
ssSetSupportedForCodeReuseAcrossModels
установите на 1
или true
Если вы используете legacy_code
инструмент, чтобы сгенерировать вашу S-функцию, опция S-функции supportCodeReuseAcrossModels
задает повторное использование кода через модели для подсистемы, которая содержит S-функцию.
Сконфигурируйте S-функцию для повторного использования кода через модели, только если S-функция не получает доступ ни к каким структурам данных модели специфичным. Эта настройка необходима потому что сгенерированный код в _sharedutils
папка скомпилирована отдельно от сгенерированного кода в model_ert_rtw folder
. Допускающий повторное использование код подсистемы библиотеки сгенерирован в _sharedutils
папка не имеет доступа к типам и макросам, которые объявляются в model.h
. Допускающий повторное использование код подсистемы библиотеки должен быть независимым. Для получения дополнительной информации смотрите, Генерируют Повторно используемый код от Подсистем Библиотеки, Разделяемых Через Модели.
Если ваша S-функция использует пользовательские функции, определяемые в ваших внешних заголовочных файлах, добавьте LibAddtoSystemCustomIncludes (система, incFileName) функция в файле вашей S-функции TLC. Например, когда вы добавляете LibAddtoSystemCustomIncludes("company_math.h")
в вашем .tlc
файл, допускающий повторное использование код подсистемы библиотеки в _sharedutils
папка включает #company_math.h
заголовочный файл.
1. Создайте новый MATLAB рабочая папка. В командном окне MATLAB скопируйте эти внешние файлы кода в свой текущий MATLAB рабочая папка:
currentDir = pwd; [~,cgDir] = rtwdemodir(); copyfile(fullfile(matlabroot,'toolbox','rtw','rtwdemos','doubleIt.c')); copyfile(fullfile(matlabroot,'toolbox','rtw','rtwdemos','doubleIt.h'));
2. Открытая модель rtwdemo_sfcn_rls
в качестве примера. Эта модель в качестве примера использует два экземпляра допускающей повторное использование подсистемы библиотеки
rtwdemo_sfcn_rls_lib
. S-функция sfun_mySrc
в допускающей повторное использование библиотеке подсистема использует внешние файлы doubleIt.c
и doubleIt.h
.
rtwdemo_sfcn_rls;
3. Сгенерируйте код S-функции при помощи Legacy Code Tool. Используйте эти команды в своем окне MATLAB Command:
def = legacy_code('initialize'); def.SFunctionName = 'sfun_mySrc'; def.SourceFiles = {'doubleIt.c'}; def.HeaderFiles = {'doubleIt.h'}; def.OutputFcnSpec = 'double y1 = doubleIt(double u1)';
4. Задайте S-функцию для повторного использования кода:
def.Options.supportCodeReuseAcrossModels = true;
5. Сгенерируйте файл блока TLC S-функции кода. Затем скомпилируйте S-функцию.
legacy_code('sfcn_tlc_generate',def); legacy_code('sfcn_cmex_generate', def); legacy_code('compile', def);
### Start Compiling sfun_mySrc mex('-I/tmp/BR2021ad_1640230_185635/publish_examples0/tpf04d3736_4e5d_4505_8a34_093e4a511912/coderdemo', '-c', '-outdir', '/tmp/BR2021ad_1640230_185635/publish_examples0/tpc01b2f48_4d70_4f18_9c4b_7490c1380e4b', '/tmp/BR2021ad_1640230_185635/publish_examples0/tpf04d3736_4e5d_4505_8a34_093e4a511912/coderdemo/doubleIt.c') Building with 'gcc'. MEX completed successfully. mex('sfun_mySrc.c', '-I/tmp/BR2021ad_1640230_185635/publish_examples0/tpf04d3736_4e5d_4505_8a34_093e4a511912/coderdemo', '/tmp/BR2021ad_1640230_185635/publish_examples0/tpc01b2f48_4d70_4f18_9c4b_7490c1380e4b/doubleIt.o') Building with 'gcc'. MEX completed successfully. ### Finish Compiling sfun_mySrc ### Exit
6. Генератор кода создает S-файл-функции sfun_mySrc.c
и его файл TLC sfun_mySrc.tlc
в вашем MATLAB рабочая папка. В sfun_mySrc.c
файл, генератор кода добавляет эти технические требования:
file = fullfile('sfun_mySrc.c'); rtwdemodbtype(file,'* All options have the form SS_OPTION_<name>', ... 'ssSetSupportedForCodeReuseAcrossModels(S, 1);',1,1);
* All options have the form SS_OPTION_<name> and are documented in * matlabroot/simulink/include/simstruc.h. The options should be * bitwise or'd together as in * ssSetOptions(S, (SS_OPTION_name1 | SS_OPTION_name2)) */ ssSetOptions(S, SS_OPTION_USE_TLC_WITH_ACCELERATOR | SS_OPTION_CAN_BE_CALLED_CONDITIONALLY | SS_OPTION_EXCEPTION_FREE_CODE | SS_OPTION_WORKS_WITH_CODE_REUSE | SS_OPTION_SFUNCTION_INLINED_FOR_RTW | SS_OPTION_DISALLOW_CONSTANT_SAMPLE_TIME ); ssSetSupportedForCodeReuseAcrossModels(S, 1);
В sfun_mySrc.c
, SS_OPTION_WORKS_WITH_CODE_REUSE
флаг установлен в ssSetOptions
функция и ssSetSupportedForCodeReuseAcrossModels
установлен в истину.
7. На панели инструментов Simulink откройте приложение Simulink Coder или Embedded Coder.
8. Сгенерируйте код для модели. На вкладке C Code нажмите Build.
evalc('slbuild(''rtwdemo_sfcn_rls'')');
Генератор кода производит допускающую повторное использование функцию, которая может быть снова использована через модели в _sharedutils
папка. Модели в иерархии модели - ссылки совместно используют этот _sharedutils
папка, чтобы снова использовать код. В данном примере допускающая повторное использование функция сгенерирована в slprj/grt/_sharedutils/sfunc.c
файл:
file = fullfile('slprj','grt','_sharedutils','sfunc.c'); rtwdemodbtype(file,'Output and update for atomic system', ... 'rtb_sfun_mySrc',1,1);
* Output and update for atomic system: * 'ReusableSubsystem' ('rtwdemo_sfcn_rls_lib:60') * 'ReusableSubsystem' ('rtwdemo_sfcn_rls_lib:60') */ void sfunc(real_T rtu_In1, B_sfunc_T *localB, DW_sfunc_T *localDW) { /* local block i/o variables */ real_T rtb_sfun_mySrc;
По умолчанию S-функции в подсистеме не сконфигурированы для повторного использования кода в модели. Можно задать S-функции в подсистеме для повторного использования кода в модели. В S-файле-функции, набор SS_OPTION_WORKS_WITH_CODE_REUSE
отметьте в ssSetOptions
функция. Этот флаг указывает, что ваша S-функция удовлетворяет требования для повторного использования кода подсистемы и сконфигурирована для повторного использования кода. Если флаг установлен, и ваша S-функция не удовлетворяет требования, генератор кода не генерирует допускающую повторное использование функцию, и вы видите предупреждение.
1. Создайте новый MATLAB рабочая папка и скопируйте эти внешние файлы кода в свой текущий MATLAB рабочая папка:
currentDir = pwd; [~,cgDir] = rtwdemodir(); copyfile(fullfile(matlabroot,'toolbox','rtw','rtwdemos','doubleIt.c')); copyfile(fullfile(matlabroot,'toolbox','rtw','rtwdemos','doubleIt.h'));
2. Для модели rtwdemo_sfcn_rls
в качестве примера, сгенерируйте код S-функции при помощи Legacy Code Tool. Не включайте опцию S-функции
supportCodeReuseAcrossModels
. Используйте эти команды в своем окне MATLAB Command:
def = legacy_code('initialize'); def.SFunctionName = 'sfun_mySrc'; def.SourceFiles = {'doubleIt.c'}; def.HeaderFiles = {'doubleIt.h'}; def.OutputFcnSpec = 'double y1 = doubleIt(double u1)';
3. Сгенерируйте файл блока TLC S-функции кода. Затем скомпилируйте S-функцию.
legacy_code('sfcn_tlc_generate',def); legacy_code('sfcn_cmex_generate', def); legacy_code('compile', def);
### Start Compiling sfun_mySrc mex('-I/tmp/BR2021ad_1640230_185635/publish_examples0/tp8a393614_6b24_45e7_b39f_f305a55f9966/coderdemo', '-c', '-outdir', '/tmp/BR2021ad_1640230_185635/publish_examples0/tp3827e55f_3739_4000_b4c7_513a2b1b8b31', '/tmp/BR2021ad_1640230_185635/publish_examples0/tp8a393614_6b24_45e7_b39f_f305a55f9966/coderdemo/doubleIt.c') Building with 'gcc'. MEX completed successfully. mex('sfun_mySrc.c', '-I/tmp/BR2021ad_1640230_185635/publish_examples0/tp8a393614_6b24_45e7_b39f_f305a55f9966/coderdemo', '/tmp/BR2021ad_1640230_185635/publish_examples0/tp3827e55f_3739_4000_b4c7_513a2b1b8b31/doubleIt.o') Building with 'gcc'. MEX completed successfully. ### Finish Compiling sfun_mySrc ### Exit
4. Генератор кода создает S-файл-функции sfun_mySrc.c
и его файл TLC sfun_mySrc.tlc
в вашем MATLAB рабочая папка.
file = fullfile('sfun_mySrc.c'); rtwdemodbtype(file,'* All options have the form SS_OPTION_<name>', ... 'SS_OPTION_DISALLOW_CONSTANT_SAMPLE_TIME',1,1);
* All options have the form SS_OPTION_<name> and are documented in * matlabroot/simulink/include/simstruc.h. The options should be * bitwise or'd together as in * ssSetOptions(S, (SS_OPTION_name1 | SS_OPTION_name2)) */ ssSetOptions(S, SS_OPTION_USE_TLC_WITH_ACCELERATOR | SS_OPTION_CAN_BE_CALLED_CONDITIONALLY | SS_OPTION_EXCEPTION_FREE_CODE | SS_OPTION_WORKS_WITH_CODE_REUSE | SS_OPTION_SFUNCTION_INLINED_FOR_RTW | SS_OPTION_DISALLOW_CONSTANT_SAMPLE_TIME
В sfun_mySrc.c
файл, генератор кода добавляет SS_OPTION_WORKS_WITH_CODE_REUSE
отметьте в ssSetOptions
функционируйте по умолчанию, но не включайте ssSetSupportedForCodeReuseAcrossModels
спецификация, которая препятствует тому, чтобы S-функция была снова использована через модели.
5. На панели инструментов Simulink откройте приложение Simulink Coder или Embedded Coder.
6. Сгенерируйте код для модели. На вкладке C Code нажмите Build.
evalc('slbuild(''rtwdemo_sfcn_rls'')');
Генератор кода производит допускающую повторное использование функцию для подсистемы в rtwdemo_sfcn_rls.c
файл, который находится вне _sharedutils
папка. Этот код может быть снова использован в модели, но не через иерархию модели - ссылки:
file = fullfile('rtwdemo_sfcn_rls_grt_rtw','rtwdemo_sfcn_rls.c'); rtwdemodbtype(file,'void sfunc', ... 'localDW->UnitDelay_DSTATE = rtb_sfun_mySrc;',1,1);
void sfunc_Init(DW_sfunc_T *localDW) { /* InitializeConditions for UnitDelay: '<S1>/Unit Delay' */ localDW->UnitDelay_DSTATE = 0.0; } /* * Output and update for atomic system: * '<Root>/ReusableSubsystem1' * '<Root>/ReusableSubsystem2' */ void sfunc(real_T rtu_In1, B_sfunc_T *localB, DW_sfunc_T *localDW) { /* local block i/o variables */ real_T rtb_sfun_mySrc; /* UnitDelay: '<S1>/Unit Delay' */ localB->UnitDelay = localDW->UnitDelay_DSTATE; /* S-Function (sfun_mySrc): '<S1>/sfun_mySrc' */ rtb_sfun_mySrc = doubleIt(rtu_In1); /* Update for UnitDelay: '<S1>/Unit Delay' */ localDW->UnitDelay_DSTATE = rtb_sfun_mySrc;