Примеры Legacy Code Tool

Можно использовать Simulink® Legacy Code Tool для генерации полностью встроенных S-функций C MEX для устаревшего или пользовательского кода. S-функции оптимизированы для встроенных компонентов, таких как драйверы устройств и интерполяционные таблицы, и они вызывают существующие функции C или C++. Эти примеры показывают, как использовать Legacy Code Tool для интеграции различных внешних функций.

Интеграция внешних функций C, которые передают входные параметры по значению от адреса

В этом примере показано, как использовать Legacy Code Tool для интеграции устаревших функций C, которые передают свои входные параметры по значению от адреса.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототипами наследственных функций, вызываемых в этом примере, являются:

  • FLT- filterV1 (const FLT-сигнал, const FLT prevSignal, const FLT-коэффициент усиления)

  • FLT- filterV2 (const FLT * сигнал, const FLT prevSignal, const FLT коэффициент усиления)

FLT - это typedef с плавающей точкой. Устаревший исходный код находится в файлах your_types.h, myfilter.h, filterV1.c и filterV2.c.

Обратите внимание на различие в OutputFcnSpec, заданную в двух структурах; первый случай задает, что первый входной параметр передается по значению, а второй случай задает проход по указателю.

defs = [];

% rtwdemo_sfun_filterV1
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_filterV1';
def.OutputFcnSpec = 'single y1 = filterV1(single u1, single u2, single p1)';
def.HeaderFiles   = {'myfilter.h'};
def.SourceFiles   = {'filterV1.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
defs = [defs; def];

% rtwdemo_sfun_filterV2
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_filterV2';
def.OutputFcnSpec = 'single y1 = filterV2(single u1[1], single u2, single p1)';
def.HeaderFiles   = {'myfilter.h'};
def.SourceFiles   = {'filterV2.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
defs = [defs; def];

Сгенерируйте S-функции для симуляции

Чтобы сгенерировать S-функции C-MEX согласно описанию, предоставленному входным параметром 'defs', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функции вызывают унаследованные функции в симуляции. Исходный код для S-функций находится в файлах rtwdemo_sfun_filterV1.c и rtwdemo_sfun_filterV2.c.

legacy_code('sfcn_cmex_generate', defs);

Скомпилируйте сгенерированные S-функции для симуляции

После того, как вы сгенерируете исходные файлы S-функции C-MEX, чтобы скомпилировать S-функции для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', defs);
### Start Compiling rtwdemo_sfun_filterV1
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex19632214', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp10ea571f_5466_40d8_bea0_ec5d12c6970d', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/filterV1.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_filterV1.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex19632214', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp10ea571f_5466_40d8_bea0_ec5d12c6970d/filterV1.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_filterV1
### Exit

### Start Compiling rtwdemo_sfun_filterV2
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex19632214', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp3cbff89f_0f8d_41c1_822e_7d45e8bded4b', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/filterV2.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_filterV2.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex19632214', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp3cbff89f_0f8d_41c1_822e_7d45e8bded4b/filterV2.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_filterV2
### Exit

Сгенерируйте файлы блоков TLC для генерации кода

После того, как вы скомпилируете S-функции и используете их в симуляции, можно снова вызвать legacy_code функции () с первым входным набором на 'sfcn _ tlc _ generate', чтобы сгенерировать файлы блоков TLC. Блочные файлы определяют, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файлы блоков TLC и пытаетесь сгенерировать код для модели, которая включает S-функции, генерация кода прекращается. Файлы блоков TLC для S-функций являются rtwdemo_sfun_filterV1.tlc и rtwdemo_sfun_filterV2.tlc.

legacy_code('sfcn_tlc_generate', defs);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создаете файлы блоков TLC, можно снова вызвать функцию legacy_code () с первым входным набором 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функций находятся не в той же папке, что и S-функции, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', defs);

Сгенерируйте маскированные блоки s-function для вызова сгенерированных S-функций

После того, как вы скомпилируете источник S-функции C-MEX, можно снова вызвать legacy_code функции () с первым входным набором на 'slblock _ generate', чтобы сгенерировать маскированные блоки S-функции, которые вызывают S-функции. Программное обеспечение помещает блоки в новую модель. Оттуда можно скопировать их в существующую модель.

legacy_code('slblock_generate', defs);

Показать сгенерированное интегрирование с унаследованным кодом

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

open_system('rtwdemo_lct_filter')
open_system('rtwdemo_lct_filter/TestFilter')
sim('rtwdemo_lct_filter')

Интеграция внешних функций C, которые передают выходной аргумент как возвращаемый аргумент

В этом примере показано, как использовать Legacy Code Tool для интеграции устаревших функций C, которые передают их выход в качестве возвращаемого аргумента.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототип наследственных функций, вызываемых в этом примере, является:

FLT gainScalar (const FLT in, const FLT gain)

FLT - это typedef с плавающей точкой. Устаревший исходный код находится в файлах your_types.h, gain.h и gainScalar.c.

% rtwdemo_sfun_gain_scalar
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_gain_scalar';
def.OutputFcnSpec = 'single y1 = gainScalar(single u1, single p1)';
def.HeaderFiles   = {'gain.h'};
def.SourceFiles   = {'gainScalar.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};

Сгенерируйте S-функцию для симуляции

Чтобы сгенерировать S-функцию C-MEX согласно описанию, предоставленному входным параметром 'def', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функция вызывает устаревшие функции во время симуляции. Исходный код для S-функции находится в файле rtwdemo_sfun_gain_scalar.c.

legacy_code('sfcn_cmex_generate', def);

Скомпилируйте сгенерированную S-функцию для симуляции

После того, как вы сгенерируете исходный файл S-функции C-MEX, чтобы скомпилировать S-функцию для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', def);
### Start Compiling rtwdemo_sfun_gain_scalar
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex09148220', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples4/tpf131ed4a_0f1b_4580_8b13_aaa37bac7e3b', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/gainScalar.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_gain_scalar.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex09148220', '/tmp/BR2021ad_1584584_202060/publish_examples4/tpf131ed4a_0f1b_4580_8b13_aaa37bac7e3b/gainScalar.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_gain_scalar
### Exit

Сгенерируйте файл блока TLC для генерации кода

После того, как вы скомпилируете S-функцию и используете ее в симуляции, можно снова вызвать legacy_code функции () с первым входным набором на 'sfcn _ tlc _ generate', чтобы сгенерировать блочный файл TLC. Блочный файл задает, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файл блока TLC и пытаетесь сгенерировать код для модели, которая включает S-функцию, генерация кода прекращается. Файл блока TLC для S-функции: rtwdemo_sfun_gain_scalar.tlc.

legacy_code('sfcn_tlc_generate', def);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создали блочный файл TLC, можно снова вызвать функцию legacy_code () с первым входным набором 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функции находятся не в той же папке, что и S-функция, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', def);

Сгенерируйте маскированный блок s-function для вызова сгенерированной S-функции

После того, как вы скомпилируете источник S-функции C-MEX, можно снова вызвать legacy_code функции () с первым входным набором на 'slblock _ generate', чтобы сгенерировать маскированный блок S-функции, который вызывает эту S-функцию. Программа помещает блок в новую модель. Оттуда можно скопировать его в существующую модель.

legacy_code('slblock_generate', def);

Показать сгенерированное интегрирование с унаследованным кодом

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

open_system('rtwdemo_lct_gain')
open_system('rtwdemo_lct_gain/TestGain')
sim('rtwdemo_lct_gain')

Интеграция внешних методов объекта C++

Интеграция устаревших методов объекта C++ с помощью Legacy Code Tool.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C++ MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте блочный файл TLC и необязательный файл rtwmakecfg.m, который вызывает унаследованный код во время генерации кода.

Предоставьте спецификацию унаследованной функции

Функции, предоставляемые с помощью Legacy Code Tool, берут в качестве аргумента определенную структуру данных или массив структур. Структура данных инициализируется путем вызова функции legacy_code () с использованием 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Определение унаследованного класса C++ в этом примере:

class adder {
  private:
      int int_state;
  public:
      adder();
      int add_one(int increment);
      int get_val();
};

Устаревший исходный код находится в файлах adder_cpp.h и adder_cpp.cpp.

% rtwdemo_sfun_adder_cpp
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_adder_cpp';
def.StartFcnSpec  = 'createAdder()';
def.OutputFcnSpec = 'int32 y1 = adderOutput(int32 u1)';
def.TerminateFcnSpec = 'deleteAdder()';
def.HeaderFiles   = {'adder_cpp.h'};
def.SourceFiles   = {'adder_cpp.cpp'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
def.Options.language = 'C++';
def.Options.useTlcWithAccel = false;

Сгенерируйте S-функцию для симуляции

Чтобы сгенерировать S-функцию C-MEX согласно описанию, предоставленному входным параметром 'def', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функция вызывает устаревшие функции во время симуляции. Исходный код для S-функции находится в файле rtwdemo_sfun_adder_cpp.cpp.

legacy_code('sfcn_cmex_generate', def);

Скомпилируйте сгенерированную S-функцию для симуляции

После того, как вы сгенерируете исходный файл S-функции C-MEX, чтобы скомпилировать S-функцию для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', def);
### Start Compiling rtwdemo_sfun_adder_cpp
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples5/tpc56de889/ex06428671', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples5/tp66b2afce_86d9_4640_b52a_2acaaab738b2', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/adder_cpp.cpp')
Building with 'g++'.
MEX completed successfully.
    mex('rtwdemo_sfun_adder_cpp.cpp', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples5/tpc56de889/ex06428671', '-cxx', '/tmp/BR2021ad_1584584_202060/publish_examples5/tp66b2afce_86d9_4640_b52a_2acaaab738b2/adder_cpp.o')
Building with 'g++'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_adder_cpp
### Exit

Сгенерируйте файл блока TLC для генерации кода

После того, как вы скомпилируете S-функцию и используете ее в симуляции, можно вызвать функцию legacy_code () снова. Установите первый вход на 'sfcn _ tlc _ generate', чтобы сгенерировать блочный файл TLC, который поддерживает генерацию кода через Coder™ Simulink ®. Если файл блока TLC не создан и вы пытаетесь сгенерировать код для модели, которая включает S-функцию, генерация кода прекращается. Файл блока TLC для S-функции: rtwdemo_sfun_adder_cpp.tlc.

legacy_code('sfcn_tlc_generate', def);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После создания файла блока TLC можно вызвать функцию legacy_code () снова. Установите первый вход на 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m, который поддерживает генерацию кода через Coder™ Simulink ®. Если требуемые исходный код и заголовочные файлы для S-функции находятся не в той же папке, что и S-функция, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', def);

Сгенерируйте маскированный блок s-function для вызова сгенерированной S-функции

После компиляции источника S-функции C-MEX можно вызвать функцию legacy_code () снова. Установите первый вход на 'slblock _ generate', чтобы сгенерировать блок s-function, который сконфигурирован для вызова этой S-функции. Программа помещает блок в новую модель. Можно скопировать блок в существующую модель.

% legacy_code('slblock_generate', def);

Показать сгенерированное интегрирование с унаследованным кодом

Модель rtwdemo_lct_cpp показывает интегрирование с унаследованным кодом.

open_system('rtwdemo_lct_cpp')
sim('rtwdemo_lct_cpp')

Интеграция внешних функций C, которые передают входные и выходные аргументы как параметры с типом данных с фиксированной точкой

Интегрируйте устаревшие функции C, которые передают их входные и выходные параметры с помощью параметров типа данных с фиксированной точкой с помощью Legacy Code Tool.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототип наследственных функций, вызываемых в этом примере, является:

myFixpt timesS16 (const myFixpt in1, const myFixpt in2, const uint8_T fracLength)

myFixpt логически является фиксированным точкой типом данных, который физически является typedef к 16-битному целому числу:

myFixpt = Simulink.NumericType;
myFixpt.DataTypeMode = 'Fixed-point: binary point scaling';
myFixpt.Signed = true;
myFixpt.WordLength = 16;
myFixpt.FractionLength = 10;
myFixpt.IsAlias = true;
myFixpt.HeaderFile = 'timesFixpt.h';

Устаревший исходный код находится в файлах timesFixpt.h и timesS16.c.

% rtwdemo_sfun_gain_fixpt
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_gain_fixpt';
def.OutputFcnSpec = 'myFixpt y1 = timesS16(myFixpt u1, myFixpt p1, uint8 p2)';
def.HeaderFiles   = {'timesFixpt.h'};
def.SourceFiles   = {'timesS16.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};

Сгенерируйте S-функцию для симуляции

Чтобы сгенерировать S-функцию C-MEX согласно описанию, предоставленному входным параметром 'def', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функция вызывает устаревшие функции во время симуляции. Исходный код для S-функции находится в файле rtwdemo_sfun_gain_fixpt.c.

legacy_code('sfcn_cmex_generate', def);

Скомпилируйте сгенерированную S-функцию для симуляции

После того, как вы сгенерируете исходный файл S-функции C-MEX, чтобы скомпилировать S-функцию для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', def);
### Start Compiling rtwdemo_sfun_gain_fixpt
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex05928773', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples4/tpffa46896_ae8c_46b0_bf61_6f4e5d3e21e6', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/timesS16.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_gain_fixpt.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex05928773', '/tmp/BR2021ad_1584584_202060/publish_examples4/tpffa46896_ae8c_46b0_bf61_6f4e5d3e21e6/timesS16.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_gain_fixpt
### Exit

Сгенерируйте файл блока TLC для генерации кода

После того, как вы скомпилируете S-функцию и используете ее в симуляции, можно вызвать функцию legacy_code () снова. Установите первый вход на 'sfcn _ tlc _ generate', чтобы сгенерировать блочный файл TLC. Блочный файл задает, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файл блока TLC и пытаетесь сгенерировать код для модели, которая включает S-функцию, генерация кода прекращается. Файл блока TLC для S-функции: rtwdemo_sfun_gain_fixpt.tlc.

legacy_code('sfcn_tlc_generate', def);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После создания файла блока TLC можно вызвать функцию legacy_code () снова. Установите первый вход на 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m, который поддерживает генерацию кода. Если требуемые исходный код и заголовочные файлы для S-функции находятся не в той же папке, что и S-функция, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', def);

Сгенерируйте маскированный блок s-function для вызова сгенерированной S-функции

После компиляции источника S-функции C-MEX можно вызвать функцию legacy_code () снова. Установите первый вход на 'slblock _ generate', чтобы сгенерировать блок s-function, который вызывает эту S-функцию. Программа помещает блок в новую модель. Можно скопировать блок в существующую модель.

legacy_code('slblock_generate', def);

Показать сгенерированное интегрирование с унаследованным кодом

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

open_system('rtwdemo_lct_fixpt_params')
open_system('rtwdemo_lct_fixpt_params/TestFixpt')
sim('rtwdemo_lct_fixpt_params')

Интеграция внешних функций C, которые передают входные и выходные аргументы как сигналы с типом данных с фиксированной точкой

В этом примере показано, как использовать Legacy Code Tool для интеграции устаревших функций C, которые передают их входные и выходные параметры с использованием параметров типа данных с фиксированной точкой.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототип наследственных функций, вызываемых в этом примере, является:

myFixpt timesS16 (const myFixpt in1, const myFixpt in2, const uint8_T fracLength)

myFixpt логически является типом данных с фиксированной точкой, который физически является typedef до 16-битного целого числа:

myFixpt = Simulink.NumericType;
myFixpt.DataTypeMode = 'Fixed-point: binary point scaling';
myFixpt.Signed = true;
myFixpt.WordLength = 16;
myFixpt.FractionLength = 10;
myFixpt.IsAlias = true;
myFixpt.HeaderFile = 'timesFixpt.h';

Устаревший исходный код находится в файлах timesFixpt.h и timesS16.c.

% rtwdemo_sfun_times_s16
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_times_s16';
def.OutputFcnSpec = 'myFixpt y1 = timesS16(myFixpt u1, myFixpt u2, uint8 p1)';
def.HeaderFiles   = {'timesFixpt.h'};
def.SourceFiles   = {'timesS16.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};

Сгенерируйте S-функцию для симуляции

Чтобы сгенерировать S-функцию C-MEX согласно описанию, предоставленному входным параметром 'def', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функция вызывает устаревшие функции во время симуляции. Исходный код для S-функции находится в файле rtwdemo_sfun_times_s16.c.

legacy_code('sfcn_cmex_generate', def);

Скомпилируйте сгенерированную S-функцию для симуляции

После того, как вы сгенерируете исходный файл S-функции C-MEX, чтобы скомпилировать S-функцию для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', def);
### Start Compiling rtwdemo_sfun_times_s16
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex96454812', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples4/tpf321327e_a855_44ec_977a_4ef16c8c0f3d', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/timesS16.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_times_s16.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex96454812', '/tmp/BR2021ad_1584584_202060/publish_examples4/tpf321327e_a855_44ec_977a_4ef16c8c0f3d/timesS16.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_times_s16
### Exit

Сгенерируйте файл блока TLC для генерации кода

После того, как вы скомпилируете S-функцию и используете ее в симуляции, можно снова вызвать legacy_code функции () с первым входным набором на 'sfcn _ tlc _ generate', чтобы сгенерировать блочный файл TLC. Блочный файл задает, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файл блока TLC и пытаетесь сгенерировать код для модели, которая включает S-функцию, генерация кода прекращается. Файл блока TLC для S-функции: rtwdemo_sfun_times_s16.tlc.

legacy_code('sfcn_tlc_generate', def);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создали блочный файл TLC, можно снова вызвать функцию legacy_code () с первым входным набором 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функции находятся не в той же папке, что и S-функция, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', def);

Сгенерируйте маскированный блок s-function для вызова сгенерированной S-функции

После того, как вы скомпилируете источник S-функции C-MEX, можно снова вызвать legacy_code функции () с первым входным набором на 'slblock _ generate', чтобы сгенерировать маскированный блок S-функции, который вызывает эту S-функцию. Программа помещает блок в новую модель. Оттуда можно скопировать его в существующую модель.

legacy_code('slblock_generate', def);

Покажите интегрирование модели с унаследованным кодом

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

open_system('rtwdemo_lct_fixpt_signals')
open_system('rtwdemo_lct_fixpt_signals/TestFixpt')
sim('rtwdemo_lct_fixpt_signals')

Интеграция внешних функций C с постоянной памятью конкретного экземпляра

Интеграция устаревших функций C, которые используют специфическую для экземпляра постоянную память, с помощью Legacy Code Tool.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототипами наследственных функций, вызываемых в этом примере, являются:

пустота memory_bus_init (COUNTERBUS *мадам, int32_T upper_sat, int32_T lower_sat);

пустота memory_bus_step (COUNTERBUS *вход, COUNTERBUS *мадам, COUNTERBUS *выход);

mem является специфичной для экземпляра постоянной памятью для применения задержки с одним шагом интегрирования. COUNTERBUS является struct typedef, заданным в counterbus.h и реализованным с объектом Simulink .Bus в базовом рабочем пространстве. Устаревший исходный код находится в файлах memory_bus.h и memory_bus.c.

evalin('base','load rtwdemo_lct_data.mat')

% rtwdemo_sfun_work
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_work';
def.InitializeConditionsFcnSpec = ...
    'void memory_bus_init(COUNTERBUS work1[1], int32 p1, int32 p2)';
def.OutputFcnSpec = ...
    'void memory_bus_step(COUNTERBUS u1[1], COUNTERBUS work1[1], COUNTERBUS y1[1])';
def.HeaderFiles   = {'memory_bus.h'};
def.SourceFiles   = {'memory_bus.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};

Сгенерируйте S-функцию для симуляции

Чтобы сгенерировать S-функцию C-MEX согласно описанию, предоставленному входным параметром 'def', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функция вызывает устаревшие функции во время симуляции. Исходный код для S-функции находится в файле rtwdemo_sfun_work.c.

legacy_code('sfcn_cmex_generate', def);

Скомпилируйте сгенерированную S-функцию для симуляции

После того, как вы сгенерируете исходный файл S-функции C-MEX, чтобы скомпилировать S-функцию для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', def);
### Start Compiling rtwdemo_sfun_work
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex38707886', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples4/tpfe80f8c8_ce62_44ee_be3d_f75bd74a70a1', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/memory_bus.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_work.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex38707886', '/tmp/BR2021ad_1584584_202060/publish_examples4/tpfe80f8c8_ce62_44ee_be3d_f75bd74a70a1/memory_bus.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_work
### Exit

Сгенерируйте файл блока TLC для генерации кода

После того, как вы скомпилируете S-функцию и используете ее в симуляции, можно снова вызвать legacy_code функции () с первым входным набором на 'sfcn _ tlc _ generate', чтобы сгенерировать блочный файл TLC. Блочный файл задает, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файл блока TLC и пытаетесь сгенерировать код для модели, которая включает S-функцию, генерация кода прекращается. Файл блока TLC для S-функции: rtwdemo_sfun_work.tlc.

legacy_code('sfcn_tlc_generate', def);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создали блочный файл TLC, можно снова вызвать функцию legacy_code () с первым входным набором 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функции находятся не в той же папке, что и S-функция, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', def);

Сгенерируйте маскированный блок s-function для вызова сгенерированной S-функции

После того, как вы скомпилируете источник S-функции C-MEX, можно снова вызвать legacy_code функции () с первым входным набором на 'slblock _ generate', чтобы сгенерировать маскированный блок S-функции, который вызывает эту S-функцию. Программа помещает блок в новую модель. Оттуда можно скопировать его в существующую модель.

legacy_code('slblock_generate', def);

Покажите интегрирование модели с унаследованным кодом

Модель rtwdemo_lct_work показывает интегрирование модели с унаследованным кодом. Подсистема memory_bus служит обвязкой для вызова устаревшей функции C.

open_system('rtwdemo_lct_work')
open_system('rtwdemo_lct_work/memory_bus')
sim('rtwdemo_lct_work')

Интеграция внешних функций C, которые используют аргументы структуры

Интеграция устаревших функций C со структурными аргументами, которые используют шины Simulink ® с помощью Legacy Code Tool.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототип наследственных функций, вызываемых в этом примере, является:

counterbusFcn (COUNTERBUS * u1, int32_T u2, COUNTERBUS * y1, int32_T * y2)

COUNTERBUS является struct typedef, заданным в counterbus.h и реализованным с объектом Simulink .Bus в базовом рабочем пространстве. Устаревший исходный код находится в файлах counterbus.h и counterbus.c.

evalin('base','load rtwdemo_lct_data.mat')

% rtwdemo_sfun_counterbus
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_counterbus';
def.OutputFcnSpec = ...
    'void counterbusFcn(COUNTERBUS u1[1], int32 u2, COUNTERBUS y1[1], int32 y2[1])';
def.HeaderFiles   = {'counterbus.h'};
def.SourceFiles   = {'counterbus.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};

Сгенерируйте S-функцию для симуляции

Чтобы сгенерировать S-функцию C-MEX согласно описанию, предоставленному входным параметром 'def', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функция вызывает устаревшие функции во время симуляции. Исходный код для S-функции находится в файле rtwdemo_sfun_counterbus.c.

legacy_code('sfcn_cmex_generate', def);

Скомпилируйте сгенерированную S-функцию для симуляции

После того, как вы сгенерируете исходный файл S-функции C-MEX, чтобы скомпилировать S-функцию для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', def);
### Start Compiling rtwdemo_sfun_counterbus
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex90330074', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp1e49f975_722b_4ada_9d1a_36476df7170d', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/counterbus.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_counterbus.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex90330074', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp1e49f975_722b_4ada_9d1a_36476df7170d/counterbus.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_counterbus
### Exit

Сгенерируйте файл блока TLC для генерации кода

После того, как вы скомпилируете S-функцию и используете ее в симуляции, можно снова вызвать legacy_code функции () с первым входным набором на 'sfcn _ tlc _ generate', чтобы сгенерировать блочный файл TLC. Блочный файл задает, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файл блока TLC и пытаетесь сгенерировать код для модели, которая включает S-функцию, генерация кода прекращается. Файл блока TLC для S-функции: rtwdemo_sfun_counterbus.tlc.

legacy_code('sfcn_tlc_generate', def);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создали блочный файл TLC, можно снова вызвать функцию legacy_code () с первым входным набором 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функции находятся не в той же папке, что и S-функция, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', def);

Сгенерируйте маскированный блок s-function для вызова сгенерированной S-функции

После того, как вы скомпилируете источник S-функции C-MEX, можно снова вызвать legacy_code функции () с первым входным набором на 'slblock _ generate', чтобы сгенерировать маскированный блок S-функции, который вызывает эту S-функцию. Программа помещает блок в новую модель. Оттуда можно скопировать его в существующую модель.

legacy_code('slblock_generate', def);

Покажите интегрирование модели с унаследованным кодом

Модель rtwdemo_lct_bus показывает интегрирование модели с унаследованным кодом. Подсистема TestCounter служит обвязкой для вызова устаревшей функции C.

open_system('rtwdemo_lct_bus')
open_system('rtwdemo_lct_bus/TestCounter')
sim('rtwdemo_lct_bus')

Интегрирование внешних функций C, которые передают входные и выходные аргументы как сигналы со комплексными данными

Интеграция устаревших функций C с помощью сложных сигналов с помощью Legacy Code Tool.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототип наследственных функций, вызываемых в этом примере, является:

void cplx_gain (creal_T * вход, creal_T * усиление, creal_T * выход);

creal_T - комплексное представление двойника. Устаревший исходный код находится в файлах cplxgain.h и cplxgain.c.

% rtwdemo_sfun_gain_scalar
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_cplx_gain';
def.OutputFcnSpec = ...
    ['void cplx_gain(complex<double> u1[1], '...
    'complex<double> p1[1], complex<double> y1[1])'];
def.HeaderFiles   = {'cplxgain.h'};
def.SourceFiles   = {'cplxgain.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};

Сгенерируйте S-функцию для симуляции

Чтобы сгенерировать S-функцию C-MEX согласно описанию, предоставленному входным параметром 'def', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функция вызывает устаревшие функции во время симуляции. Исходный код для S-функции находится в файле rtwdemo_sfun_cplx_gain.c.

legacy_code('sfcn_cmex_generate', def);

Скомпилируйте сгенерированную S-функцию для симуляции

После того, как вы сгенерируете исходный файл S-функции C-MEX, чтобы скомпилировать S-функцию для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', def);
### Start Compiling rtwdemo_sfun_cplx_gain
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex97344681', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp4230a205_46c4_40d4_8429_7e362a18bd8a', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/cplxgain.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_cplx_gain.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex97344681', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp4230a205_46c4_40d4_8429_7e362a18bd8a/cplxgain.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_cplx_gain
### Exit

Сгенерируйте файл блока TLC для генерации кода

После того, как вы скомпилируете S-функцию и используете ее в симуляции, можно снова вызвать legacy_code функции () с первым входным набором на 'sfcn _ tlc _ generate', чтобы сгенерировать блочный файл TLC. Блочный файл задает, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файл блока TLC и пытаетесь сгенерировать код для модели, которая включает S-функцию, генерация кода прекращается. Файл блока TLC для S-функции: rtwdemo_sfun_cplx_gain.tlc.

legacy_code('sfcn_tlc_generate', def);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создали блочный файл TLC, можно снова вызвать функцию legacy_code () с первым входным набором 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функции находятся не в той же папке, что и S-функция, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', def);

Сгенерируйте маскированный блок s-function для вызова сгенерированной S-функции

После того, как вы скомпилируете источник S-функции C-MEX, можно снова вызвать legacy_code функции () с первым входным набором на 'slblock _ generate', чтобы сгенерировать маскированный блок S-функции, который вызывает эту S-функцию. Программа помещает блок в новую модель. Оттуда можно скопировать его в существующую модель.

legacy_code('slblock_generate', def);

Покажите интегрирование модели с унаследованным кодом

Модель rtwdemo_lct_cplxgain показывает интегрирование модели с унаследованным кодом. Подсистема complex_gain служит обвязкой для вызова устаревшей функции C через генерацию S-функции.

if isempty(find_system('SearchDepth',0,'Name','rtwdemo_lct_cplxgain'))
    open_system('rtwdemo_lct_cplxgain')
    open_system('rtwdemo_lct_cplxgain/complex_gain')
    sim('rtwdemo_lct_cplxgain')
end

Интегрирование внешних функций C, которые передают аргументы, которые унаследовали размерности

В этом примере показано, как использовать Legacy Code Tool для интеграции устаревших функций C, аргументы которых унаследовали размерности.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототипами наследственных функций, вызываемых в этом примере, являются:

  • пустота mat_add (real_T *u1, real_T *u2, int32_T nbRows, int32_T nbCols, real_T *y1)

  • пустота mat_mult (real_T *u1, real_T *u2, int32_T nbRows1, int32_T nbCols1, int32_T nbCols2, real_T *y1)

real_T от typedef до double, а int32_T - от typedef до 32-битного целого числа. Устаревший исходный код находится в файлах mat_ops.h и mat_ops.c.

defs = [];

% rtwdemo_sfun_mat_add
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_mat_add';
def.OutputFcnSpec = ['void mat_add(double u1[][], double u2[][], ' ...
                   'int32 u3, int32 u4, double y1[size(u1,1)][size(u1,2)])'];
def.HeaderFiles   = {'mat_ops.h'};
def.SourceFiles   = {'mat_ops.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
defs = [defs; def];

% rtwdemo_sfun_mat_mult
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_mat_mult';
def.OutputFcnSpec =  ['void mat_mult(double u1[p1][p2], double u2[p2][p3], '...
                   'int32 p1, int32 p2, int32 p3, double y1[p1][p3])'];
def.HeaderFiles   = {'mat_ops.h'};
def.SourceFiles   = {'mat_ops.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
defs = [defs; def];

Сгенерируйте S-функции для симуляции

Чтобы сгенерировать S-функции C-MEX согласно описанию, предоставленному входным параметром 'defs', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функции вызывают устаревшие функции во время симуляции. Исходный код S-функции находится в файлах rtwdemo_sfun_mat_add.c и rtwdemo_sfun_mat_mult.c.

legacy_code('sfcn_cmex_generate', defs);

Скомпилируйте сгенерированные S-функции для симуляции

После того, как вы сгенерируете исходные файлы S-функции C-MEX, чтобы скомпилировать S-функции для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', defs);
### Start Compiling rtwdemo_sfun_mat_add
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex89794148', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp49ef0950_7fe2_4ff0_b1ff_a4ce8281f80c', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/mat_ops.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_mat_add.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex89794148', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp49ef0950_7fe2_4ff0_b1ff_a4ce8281f80c/mat_ops.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_mat_add
### Exit

### Start Compiling rtwdemo_sfun_mat_mult
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex89794148', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp065d8091_18e4_4132_946c_a0c7d2d03ff6', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/mat_ops.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_mat_mult.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex89794148', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp065d8091_18e4_4132_946c_a0c7d2d03ff6/mat_ops.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_mat_mult
### Exit

Сгенерируйте файлы блоков TLC для генерации кода

После того, как вы скомпилируете S-функции и используете их в симуляции, можно снова вызвать legacy_code функции () с первым входным набором на 'sfcn _ tlc _ generate', чтобы сгенерировать файлы блоков TLC. Блочные файлы определяют, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файлы блоков TLC и пытаетесь сгенерировать код для модели, которая включает S-функции, генерация кода прекращается. Файлы блоков TLC для S-функций являются rtwdemo_sfun_mat_add.tlc и rtwdemo_sfun_mat_mult.tlc.

legacy_code('sfcn_tlc_generate', defs);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создаете файлы блоков TLC, можно снова вызвать функцию legacy_code () с первым входным набором 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функций находятся не в той же папке, что и S-функции, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', defs);

Сгенерируйте маскированные блоки s-function для вызова сгенерированных S-функций

После того, как вы скомпилируете источник S-функции C-MEX, можно снова вызвать legacy_code функции () с первым входным набором на 'slblock _ generate', чтобы сгенерировать маскированные блоки S-функции, которые вызывают S-функции. Программное обеспечение помещает блоки в новую модель. Оттуда можно скопировать их в существующую модель

legacy_code('slblock_generate', defs);

Показать сгенерированное интегрирование с унаследованным кодом

Модель rtwdemo_lct_inherit_dims показывает интегрирование модели с унаследованным кодом. Подсистема TestMatOps служит обвязкой для вызовов устаревших функций C с задержками модуля, служащими для хранения предыдущих выходных значений.

open_system('rtwdemo_lct_inherit_dims')
open_system('rtwdemo_lct_inherit_dims/TestMatOps')
sim('rtwdemo_lct_inherit_dims')

Интегрирование внешних функций C, которые передают аргументы как многомерные сигналы

В этом примере показано, как использовать Legacy Code Tool для интеграции устаревших функций C с многомерными Сигналами.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототип наследственных функций, вызываемых в этом примере, является:

void array3d_add (real_T * y1, real_T * u1, real_T * u2, int32_T nbRows, int32_T nbCols int32_T nbPages);

real_T от typedef до double, а int32_T - от typedef до 32-битного целого числа. Устаревший исходный код находится в файлах ndarray_ops.h и ndarray_ops.c.

% rtwdemo_sfun_ndarray_add
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_ndarray_add';
def.OutputFcnSpec =...
    ['void array3d_add(double y1[size(u1,1)][size(u1,2)][size(u1,3)], ',...
    'double u1[][][], double u2[][][], ' ...
    'int32 size(u1,1), int32 size(u1,2), int32 size(u1,3))'];
def.HeaderFiles   = {'ndarray_ops.h'};
def.SourceFiles   = {'ndarray_ops.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};

y1 является 3-D выходным сигналом тех же размерностей, что и 3-D входной сигнал u1. Обратите внимание, что последние 3 аргумента, переданные в устаревшую функцию, соответствуют количеству элементов в каждой размерности 3-D входного сигнала u1.

Сгенерируйте S-функцию для симуляции

Чтобы сгенерировать S-функцию C-MEX согласно описанию, предоставленному входным параметром 'def', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функция вызывает устаревшие функции во время симуляции. Исходный код для S-функции находится в файле rtwdemo_sfun_ndarray_add.c.

legacy_code('sfcn_cmex_generate', def);

Скомпилируйте сгенерированную S-функцию для симуляции

После того, как вы сгенерируете исходный файл S-функции C-MEX, чтобы скомпилировать S-функцию для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', def);
### Start Compiling rtwdemo_sfun_ndarray_add
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex14927435', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp6d56cb76_760f_453b_8a21_051a894f9b86', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/ndarray_ops.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_ndarray_add.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex14927435', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp6d56cb76_760f_453b_8a21_051a894f9b86/ndarray_ops.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_ndarray_add
### Exit

Сгенерируйте файл блока TLC для генерации кода

После того, как вы скомпилируете S-функцию и используете ее в симуляции, можно снова вызвать legacy_code функции () с первым входным набором на 'sfcn _ tlc _ generate', чтобы сгенерировать блочный файл TLC. Блочный файл задает, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файл блока TLC и пытаетесь сгенерировать код для модели, которая включает S-функцию, генерация кода прекращается. Файл блока TLC для S-функции: rtwdemo_sfun_ndarray_add.tlc.

legacy_code('sfcn_tlc_generate', def);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создали блочный файл TLC, можно снова вызвать функцию legacy_code () с первым входным набором 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функции находятся не в той же папке, что и S-функция, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', def);

Сгенерируйте маскированный блок s-function для вызова сгенерированной S-функции

После того, как вы скомпилируете источник S-функции C-MEX, можно снова вызвать legacy_code функции () с первым входным набором на 'slblock _ generate', чтобы сгенерировать маскированный блок S-функции, который вызывает эту S-функцию. Программа помещает блок в новую модель. Оттуда можно скопировать его в существующую модель.

legacy_code('slblock_generate', def);

Отображение сгенерированного интегрирования с унаследованным кодом

Модель rtwdemo_lct_ndarray показывает интегрирование модели с унаследованным кодом. Подсистема ndarray_add служит обвязкой для вызова устаревшей функции C.

open_system('rtwdemo_lct_ndarray')
open_system('rtwdemo_lct_ndarray/ndarray_add')
sim('rtwdemo_lct_ndarray')

Интеграция внешних функций C, которые реализуют начало и прекращают действия

Интеграция устаревших функций C, которые запускают и прекращают действия с помощью Legacy Code Tool.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототипами наследственных функций, вызываемых в этом примере, являются:

  • void initFaultCounter (без знака int * counter)

  • void openLogFile (void * * fid)

  • void incAndLogFaultCounter (void * fid, беззнаковый счетчик int *, двойное время)

  • void closeLogFile (void * * fid)

Устаревший исходный код находится в файлах your_types.h, fault.h и fault.c.

% rtwdemo_sfun_fault
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_fault';
def.InitializeConditionsFcnSpec  = 'initFaultCounter(uint32 work2[1])';
def.StartFcnSpec                 = 'openLogFile(void **work1)';
def.OutputFcnSpec                = ...
    'incAndLogFaultCounter(void *work1, uint32 work2[1], double u1)';
def.TerminateFcnSpec             = 'closeLogFile(void **work1)';
def.HeaderFiles                  = {'fault.h'};
def.SourceFiles                  = {'fault.c'};
def.IncPaths                     = {'rtwdemo_lct_src'};
def.SrcPaths                     = {'rtwdemo_lct_src'};
def.Options.useTlcWithAccel      = false;

Сгенерируйте S-функцию для симуляции

Чтобы сгенерировать S-функцию C-MEX согласно описанию, предоставленному входным параметром 'def', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функция вызывает устаревшие функции во время симуляции. Исходный код для S-функции находится в файле rtwdemo_sfun_fault.c.

legacy_code('sfcn_cmex_generate', def);

Скомпилируйте сгенерированную S-функцию для симуляции

После того, как вы сгенерируете исходный файл S-функции C-MEX, чтобы скомпилировать S-функцию для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', def);
### Start Compiling rtwdemo_sfun_fault
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex46254423', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp38bf5c75_bf4f_4817_b007_fe2f2ddeccfd', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/fault.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_fault.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex46254423', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp38bf5c75_bf4f_4817_b007_fe2f2ddeccfd/fault.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_fault
### Exit

Сгенерируйте файл блока TLC для генерации кода

После того, как вы скомпилируете S-функцию и используете ее в симуляции, можно снова вызвать legacy_code функции () с первым входным набором на 'sfcn _ tlc _ generate', чтобы сгенерировать блочный файл TLC. Блочный файл задает, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файл блока TLC и пытаетесь сгенерировать код для модели, которая включает S-функцию, генерация кода прекращается. Файл блока TLC для S-функции: rtwdemo_sfun_fault.tlc.

legacy_code('sfcn_tlc_generate', def);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создали блочный файл TLC, можно снова вызвать функцию legacy_code () с первым входным набором 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функции находятся не в той же папке, что и S-функция, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', def);

Сгенерируйте маскированный блок s-function для вызова сгенерированной S-функции

После того, как вы скомпилируете источник S-функции C-MEX, можно снова вызвать legacy_code функции () с первым входным набором на 'slblock _ generate', чтобы сгенерировать маскированный блок S-функции, который вызывает эту S-функцию. Программа помещает блок в новую модель. Оттуда можно скопировать его в существующую модель.

legacy_code('slblock_generate', def);

Отображение сгенерированного интегрирования с унаследованным кодом

Модель rtwdemo_lct_start_term показывает интегрирование модели с унаследованным кодом. Подсистема TestFixpt служит обвязкой для вызова устаревшей функции C, а возможности сравнивают вывод функции с выходом встроенного блока продукта Simulink ®; результаты должны быть одинаковыми.

open_system('rtwdemo_lct_start_term')
open_system('rtwdemo_lct_start_term/TestFault')
sim('rtwdemo_lct_start_term')

Интеграция внешних функций C, которые реализуют интерполяцию N-мерной таблицы

Интеграция устаревших функций C, которые реализуют поиск N-мерной таблицы с помощью Legacy Code Tool.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототип наследственных функций, вызываемых в этом примере, является:

FLT direct Lookup Table ND (const FLT * table ND, const UINT32 nb Dims, const UINT32 * table Dims, const UINT32 * table Idx)

FLT является typedef для плавания, и UINT32 является typedef для неподписанного int32. Устаревший исходный код находится в файлах your_types.h, lookup Table.h и direct Lookup Table ND. c.

defs = [];
evalin('base','load rtwdemo_lct_data.mat')

% rtwdemo_sfun_dlut3D
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_dlut3D';
def.OutputFcnSpec = 'single y1 = DirectLookupTable3D(single p1[][][], uint32 p2[3], uint32 u1[3])';
def.HeaderFiles   = {'lookupTable.h'};
def.SourceFiles   = {'directLookupTableND.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
defs = [defs; def];

% rtwdemo_sfun_dlut4D
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_dlut4D';
def.OutputFcnSpec = 'single y1 = DirectLookupTable4D(single p1[][][][], uint32 p2[4], uint32 u1[4])';
def.HeaderFiles   = {'lookupTable.h'};
def.SourceFiles   = {'directLookupTableND.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
defs = [defs; def];

Сгенерируйте S-функции для симуляции

Чтобы сгенерировать S-функции C-MEX согласно описанию, предоставленному входным параметром 'defs', снова вызовите функцию legacy_code (). Установите первый вход на 'sfcn _ cmex _ generate'. S-функции вызывают устаревшие функции во время симуляции. Исходный код для S-функций находится в файлах rtwdemo_sfun_dlut3D.c и rtwdemo_sfun_dlut4D.c.

legacy_code('sfcn_cmex_generate', defs);

Скомпилируйте сгенерированные S-функции для симуляции

После того, как вы сгенерируете исходные файлы S-функции C-MEX, чтобы скомпилировать S-функции для симуляции с Simulink ®, вызовите функцию legacy_code () снова. Установите первый вход на 'compile'.

legacy_code('compile', defs);
### Start Compiling rtwdemo_sfun_dlut3D
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex19426386', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples3/tpdc72babf_259e_4068_8f65_13101afe8968', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/directLookupTableND.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_dlut3D.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex19426386', '/tmp/BR2021ad_1584584_202060/publish_examples3/tpdc72babf_259e_4068_8f65_13101afe8968/directLookupTableND.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_dlut3D
### Exit

### Start Compiling rtwdemo_sfun_dlut4D
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex19426386', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp5e02334a_7851_4a64_93aa_c0908f35b351', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/directLookupTableND.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_dlut4D.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex19426386', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp5e02334a_7851_4a64_93aa_c0908f35b351/directLookupTableND.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_dlut4D
### Exit

Сгенерируйте файлы блоков TLC для генерации кода

После того, как вы скомпилируете S-функции и используете их в симуляции, можно вызвать функцию legacy_code () снова. Установите первый вход на 'sfcn _ tlc _ generate', чтобы сгенерировать файлы блоков TLC. Блочные файлы определяют, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файлы блоков TLC и пытаетесь сгенерировать код для модели, которая включает S-функции, генерация кода прекращается. Файлы блоков TLC для S-функций являются rtwdemo_sfun_dlut3D.tlc и rtwdemo_sfun_dlut4D.tlc.

legacy_code('sfcn_tlc_generate', defs);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создаете файлы блоков TLC, можно вызвать функцию legacy_code () снова. Установите первый вход на 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функций находятся не в той же папке, что и S-функции, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', defs);

Сгенерируйте маскированные блоки s-function для вызова сгенерированных S-функций

После компиляции источника S-функции C-MEX можно вызвать функцию legacy_code () снова. Установите первый вход на 'slblock _ generate', чтобы сгенерировать маскированные блоки S-функции, которые вызывают S-функции. Программное обеспечение помещает блоки в новую модель. Можно скопировать блоки в существующую модель.

legacy_code('slblock_generate', defs);

Показать сгенерированное интегрирование с унаследованным кодом

Модель rtwdemo_lct_lut показывает интегрирование модели с унаследованным кодом. Подсистема TestFixpt служит обвязкой для вызова устаревшей функции C, а блоки Display сравнивают вывод функции с выходом встроенных интерполяционных блоков Simulink ®. Результаты идентичны.

open_system('rtwdemo_lct_lut')
open_system('rtwdemo_lct_lut/TestLut1')
sim('rtwdemo_lct_lut')

Интегрирование внешних функций C, которые передают аргументы как многомерные сигналы

В этом примере показано, как использовать Legacy Code Tool для интеграции устаревших функций C с многомерными Сигналами.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототип наследственных функций, вызываемых в этом примере, является:

void array3d_add (real_T * y1, real_T * u1, real_T * u2, int32_T nbRows, int32_T nbCols int32_T nbPages);

real_T от typedef до double, а int32_T - от typedef до 32-битного целого числа. Устаревший исходный код находится в файлах ndarray_ops.h и ndarray_ops.c.

% rtwdemo_sfun_ndarray_add
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_ndarray_add';
def.OutputFcnSpec =...
    ['void array3d_add(double y1[size(u1,1)][size(u1,2)][size(u1,3)], ',...
    'double u1[][][], double u2[][][], ' ...
    'int32 size(u1,1), int32 size(u1,2), int32 size(u1,3))'];
def.HeaderFiles   = {'ndarray_ops.h'};
def.SourceFiles   = {'ndarray_ops.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};

y1 является 3-D выходным сигналом тех же размерностей, что и 3-D входной сигнал u1. Обратите внимание, что последние 3 аргумента, переданные в устаревшую функцию, соответствуют количеству элементов в каждой размерности 3-D входного сигнала u1.

Сгенерируйте S-функцию для симуляции

Чтобы сгенерировать S-функцию C-MEX согласно описанию, предоставленному входным параметром 'def', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функция вызывает устаревшие функции во время симуляции. Исходный код для S-функции находится в файле rtwdemo_sfun_ndarray_add.c.

legacy_code('sfcn_cmex_generate', def);

Скомпилируйте сгенерированную S-функцию для симуляции

После того, как вы сгенерируете исходный файл S-функции C-MEX, чтобы скомпилировать S-функцию для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', def);
### Start Compiling rtwdemo_sfun_ndarray_add
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex14927435', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp6d56cb76_760f_453b_8a21_051a894f9b86', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/ndarray_ops.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_ndarray_add.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples3/tp026926c6/ex14927435', '/tmp/BR2021ad_1584584_202060/publish_examples3/tp6d56cb76_760f_453b_8a21_051a894f9b86/ndarray_ops.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_ndarray_add
### Exit

Сгенерируйте файл блока TLC для генерации кода

После того, как вы скомпилируете S-функцию и используете ее в симуляции, можно снова вызвать legacy_code функции () с первым входным набором на 'sfcn _ tlc _ generate', чтобы сгенерировать блочный файл TLC. Блочный файл задает, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файл блока TLC и пытаетесь сгенерировать код для модели, которая включает S-функцию, генерация кода прекращается. Файл блока TLC для S-функции: rtwdemo_sfun_ndarray_add.tlc.

legacy_code('sfcn_tlc_generate', def);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создали блочный файл TLC, можно снова вызвать функцию legacy_code () с первым входным набором 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функции находятся не в той же папке, что и S-функция, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', def);

Сгенерируйте маскированный блок s-function для вызова сгенерированной S-функции

После того, как вы скомпилируете источник S-функции C-MEX, можно снова вызвать legacy_code функции () с первым входным набором на 'slblock _ generate', чтобы сгенерировать маскированный блок S-функции, который вызывает эту S-функцию. Программа помещает блок в новую модель. Оттуда можно скопировать его в существующую модель.

legacy_code('slblock_generate', def);

Отображение сгенерированного интегрирования с унаследованным кодом

Модель rtwdemo_lct_ndarray показывает интегрирование модели с унаследованным кодом. Подсистема ndarray_add служит обвязкой для вызова устаревшей функции C.

open_system('rtwdemo_lct_ndarray')
open_system('rtwdemo_lct_ndarray/ndarray_add')
sim('rtwdemo_lct_ndarray')

Интеграция внешних функций C с заданным, унаследованным и параметризованным шагом расчета блоков

В этом примере показано, как использовать Legacy Code Tool для интеграции устаревших функций C с заданным, унаследованным и параметризованным шагом расчета блока.

С помощью Legacy Code Tool можно:

  • Предоставьте спецификацию унаследованной функции.

  • Сгенерируйте S-функцию C-MEX, которая вызывает унаследованный код во время симуляции.

  • Скомпилируйте и создайте сгенерированную S-функцию для симуляции.

  • Сгенерируйте файл блока TLC и необязательный файл rtwmakecfg.m, который задает, как сгенерированный код для модели вызывает унаследованный код.

Предоставьте спецификацию унаследованной функции

Функции Legacy Code Tool берут в качестве аргумента определенную структуру данных или массив структур. Вы можете инициализировать структуру данных, вызвав функцию legacy_code (), используя 'initialize' в качестве первого входа. После инициализации структуры присвойте ее свойства значениям, соответствующим унаследованному коду. Прототип наследственных функций, вызываемых в этом примере, является:

FLT gainScalar (const FLT in, const FLT gain)

FLT - это typedef с плавающей точкой. Устаревший исходный код находится в файлах your_types.h, gain.h и gainScalar.c.

defs = [];

% rtwdemo_sfun_st_inherited
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_st_inherited';
def.OutputFcnSpec = 'single y1 = gainScalar(single u1, single p1)';
def.HeaderFiles   = {'gain.h'};
def.SourceFiles   = {'gainScalar.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
defs = [defs; def];

% rtwdemo_sfun_st_fixed
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_st_fixed';
def.OutputFcnSpec = 'single y1 = gainScalar(single u1, single p1)';
def.HeaderFiles   = {'gain.h'};
def.SourceFiles   = {'gainScalar.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
def.SampleTime    = [2 1];
defs = [defs; def];

% rtwdemo_sfun_st_parameterized
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_sfun_st_parameterized';
def.OutputFcnSpec = 'single y1 = gainScalar(single u1, single p1)';
def.HeaderFiles   = {'gain.h'};
def.SourceFiles   = {'gainScalar.c'};
def.IncPaths      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
def.SampleTime    = 'parameterized';
defs = [defs; def];

Сгенерируйте S-функции для симуляции

Чтобы сгенерировать S-функции C-MEX согласно описанию, предоставленному входным параметром 'defs', снова вызовите legacy_code функции () с первым входным набором 'sfcn _ cmex _ generate'. S-функции вызывают устаревшие функции во время симуляции. Исходный код для S-функций находится в файлах rtwdemo_sfun_st_inherited.c и rtwdemo_sfun_st_fixed.c. rtwdemo_sfun_st_parameterized.c.

legacy_code('sfcn_cmex_generate', defs);

Скомпилируйте сгенерированные S-функции для симуляции

После того, как вы сгенерируете исходные файлы S-функции C-MEX, чтобы скомпилировать S-функции для симуляции с Simulink ®, снова вызовите legacy_code функции () с первым входным набором на 'compile'.

legacy_code('compile', defs);
### Start Compiling rtwdemo_sfun_st_inherited
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex74504488', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp6af2580b_8a65_4c58_b1e0_c3221c42c51f', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/gainScalar.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_st_inherited.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex74504488', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp6af2580b_8a65_4c58_b1e0_c3221c42c51f/gainScalar.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_st_inherited
### Exit

### Start Compiling rtwdemo_sfun_st_fixed
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex74504488', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp555faf52_30a3_496c_ba92_62d542170b29', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/gainScalar.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_st_fixed.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex74504488', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp555faf52_30a3_496c_ba92_62d542170b29/gainScalar.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_st_fixed
### Exit

### Start Compiling rtwdemo_sfun_st_parameterized
    mex('-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex74504488', '-c', '-outdir', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp8e5d7fdc_f13c_4c67_82c5_01f22ad2dc83', '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/gainScalar.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_st_parameterized.c', '-I/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/BR2021ad_1584584_202060/publish_examples4/tp8ee346b5/ex74504488', '/tmp/BR2021ad_1584584_202060/publish_examples4/tp8e5d7fdc_f13c_4c67_82c5_01f22ad2dc83/gainScalar.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_st_parameterized
### Exit

Сгенерируйте файлы блоков TLC для генерации кода

После того, как вы скомпилируете S-функции и используете их в симуляции, можно снова вызвать legacy_code функции () с первым входным набором на 'sfcn _ tlc _ generate', чтобы сгенерировать файлы блоков TLC. Блочные файлы определяют, как сгенерированный код для модели вызывает унаследованный код. Если вы не генерируете файлы блоков TLC и пытаетесь сгенерировать код для модели, которая включает S-функции, генерация кода прекращается. Файлы блоков TLC для S-функций являются rtwdemo_sfun_st_inherited.tlc и rtwdemo_sfun_st_fixed.tlc. rtwdemo_sfun_st_parameterized.tlc.

legacy_code('sfcn_tlc_generate', defs);

Сгенерируйте файл rtwmakecfg.m для генерации кода

После того, как вы создаете файлы блоков TLC, можно снова вызвать функцию legacy_code () с первым входным набором 'rtwmakecfg _ generate', чтобы сгенерировать файл rtwmakecfg.m для поддержки генерации кода. Если требуемые исходный код и заголовочные файлы для S-функций находятся не в той же папке, что и S-функции, и вы хотите добавить эти зависимости в make-файл, произведенный во время генерации кода, сгенерируйте файл rtwmakecfg.m.

legacy_code('rtwmakecfg_generate', defs);

Сгенерируйте маскированные блоки s-function для вызова сгенерированных S-функций

После того, как вы скомпилируете источник S-функции C-MEX, можно снова вызвать legacy_code функции () с первым входным набором на 'slblock _ generate', чтобы сгенерировать маскированные блоки S-функции, которые вызывают S-функции. Программное обеспечение помещает блоки в новую модель. Оттуда можно скопировать их в существующую модель.

legacy_code('slblock_generate', defs);

Показать сгенерированное интегрирование с унаследованным кодом

Модель rtwdemo_lct_sampletime показывает интегрирование модели с унаследованным кодом. Подсистема sample_time служит обвязкой для вызовов устаревших функций C, с задержками модуля, служащими для хранения предыдущих выходных значений.

open_system('rtwdemo_lct_sampletime')
open_system('rtwdemo_lct_sampletime/sample_time')
sim('rtwdemo_lct_sampletime')

См. также

Похожие темы

Для просмотра документации необходимо авторизоваться на сайте