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

В командной строке введите crtool, чтобы открыть Заменяющий Инструмент Кода.

Добавьте новую таблицу, выберите ту таблицу и добавьте новую функциональную запись.

На вкладке Mapping Information выберите Custom для параметра Function.

Ищите подпись вызова и информацию о параметре алгоритма для функции интерполяционной таблицы, которую вы хотите обновить с заменой алгоритма. Смотрите Подписи Функции Интерполяционной таблицы.

В данном примере вы заменяете алгоритм для концептуальной функции, сопоставленной с 1D блоком Lookup Table. Подпись для этой функции:

y1 = lookup1D(u1, u2, u3, u4)

Аргументы u1, u2, u3, u4 представляет вход, устанавливают точки останова данные, табличные данные и табличную длину размерности, соответственно. Функция возвращает выходной параметр к y1.

Справа от Function выпадающий список, в текстовом поле имени функции, вводят имя функции интерполяционной таблицы Simulink. В данном примере введите имя lookup1D. Введите имя точно, как это появляется в зарегистрированной подписи, включая символьное преобразование регистра. Нажмите Enter.

Инструмент отображает настройки параметра алгоритма, которые инициировали достойный 1D блока Lookup Table в модели в качестве примера. Обязательные параметры появляются только с одним значением. В данном примере не изменяйте значения. Дополнительные параметры появляются с несколькими значениями. Изменения в дополнительных параметрах не влияют на процесс соответствия.

Задайте концептуальные аргументы. Под полем списка Conceptual arguments нажмите +, чтобы добавить аргументы, которые находятся в зарегистрированной функциональной подписи. Функция lookup1D берет один выходной аргумент и четыре входных параметра. Нажмите + пять раз.

Инструмент задает выходной аргумент y1 и четыре входных параметра u1, u2, u3 и u4. По умолчанию эти четыре аргумента являются скалярами типа double.

Можно настроить концептуальные свойства аргумента. В данном примере вы не вносите изменения для y1 и u1. Однако, когда диалоговое окно параметров блоков для модели в качестве примера показывает, необходимо настроить свойства аргумента для точки останова и табличных аргументов данных.

Настройте концептуальные свойства аргумента при помощи следующей таблицы. Нажмите Apply.

Введите информацию для заменяющего прототипа функции. Прототип для функции, взятой в качестве примера:

real_T my_Lookup1D_Repl(real_T u0, const real_T *bp0, const real_T *table, uint32_T tdl)

В разделе Replacement function> Function prototype введите имя функции my_Lookup1D_Repl в текстовом поле Name.

Задайте аргументы для заменяющей функции. Под полем списка Function arguments нажмите + пять раз, чтобы добавить пять аргументов реализации.

Вы можете должны быть настроить свойства аргумента функции. Когда заменяющая подпись функции показывает, настройте свойства аргумента для точки останова, табличных данных и табличных аргументов длины размерности. Для u2 (точки останова) и u3 (таблица), установите флажок Const. Для u4, набор Data type к uint32.

Функциональный предварительный просмотр подписи должен появиться можно следующим образом:

double my_Lookup1D_Repl(double u1, const double* u2, const double* u3, uint32 u4)

Установите соответствующие атрибуты реализации. Используйте настройки по умолчанию.

Подтвердите запись. Если ошибки отчетов инструмента, зафиксируйте их и повторите валидацию. Повторите процедуру, пока инструмент не сообщит об ошибках.

Сохраните заменяющую таблицу кода в своей рабочей папке как my_lookup_replacement_table.m.

Укажите заменяющее отображение кода.

Используйте модель rtwdemo_crllookup1D в качестве примера.

Сконфигурируйте модель со следующими настройками:

Создайте табличный файл определения, который содержит функциональное определение. Например:

function hLib = my_lookup_replacement_table

В теле функции составьте таблицу путем вызова функционального RTW.TflTable.

hLib = RTW.TflTable;

Создайте запись для отображения функции с вызовом функции RTW.TflCFunctionEntry.

hEnt = RTW.TflCFunctionEntry;

Параметры записи функции множества с вызовом функции setTflCFunctionEntryParameters. Функциональная клавиша, имя реализации, и заголовок и исходные файлы в вызове функции идентифицируют имя функции интерполяционной таблицы Simulink, lookup1D и следующую информацию для заменяющей функции my_Lookup1D_Repl:

Задайте имя функции интерполяционной таблицы Simulink точно, как это появляется в зарегистрированной подписи, включая преобразование регистра символа (см. Подписи Функции Интерполяционной таблицы). Если вы скопировали файлы в качестве примера в папку кроме рабочей папки, которая содержит тестовую модель, rtwdemo_crllookup1D, задайте пути к исходному и заголовочному файлу.

setTflCFunctionEntryParameters(hEnt, ...
          'Key',                      'lookup1D', ...
          'Priority',                 100, ...
          'ImplementationName',       'my_Lookup1D_Repl', ...
          'ImplementationHeaderFile', 'myLookup1D.h', ...
          'ImplementationSourceFile', 'myLookup1D.c', ...
          'GenCallback',              'RTW.copyFileToBuildDir');

Создайте концептуальные аргументы и добавьте их в запись. Этот пример использует вызовы getTflArgFromString и функций addConceptualArg, чтобы создать и добавить аргументы.

Пример задает пять концептуальных аргументов для функции lookup1D, один выходной аргумент y1 и четыре входных параметра u1, u2, u3 и u4. Аргументы y1 и u1 заданы как скалярные данные double. Аргументы u2 и u3 представляют bp1 и table в подписи и заданы как 1x10 матрицы данных double. Аргумент u4 представляет tdl и задан как скаляр данных uint32. Это определение инициировало соответствие с моделью в качестве примера.

arg = hEnt.getTflArgFromString('y1','double');
arg.IOType = 'RTW_IO_OUTPUT';
addConceptualArg(hEnt, arg);

arg = hEnt.getTflArgFromString('u1','double');
addConceptualArg(hEnt, arg);

arg = RTW.TflArgMatrix('u2', 'RTW_IO_INPUT',  'double');
arg.DimRange = [0 0; Inf Inf];
addConceptualArg(hEnt, arg);

arg = RTW.TflArgMatrix('u3', 'RTW_IO_INPUT',  'double');
arg.DimRange = [0 0; Inf Inf];
addConceptualArg(hEnt, arg);

arg = hEnt.getTflArgFromString('u4','uint32');
addConceptualArg(hEnt, arg);

Рассмотрите информацию о параметре алгоритма для функции поиска, которую вы хотите обновить с заменой алгоритма. Используйте функцию getAlgorithmParameters, чтобы отобразить информацию о параметре.

algParams = getAlgorithmParameters(hEnt)

algParams = 

  Lookup with properties:

                 InterpMethod: [1x1 coder.algorithm.parameter.InterpMethod]
                 ExtrapMethod: [1x1 coder.algorithm.parameter.ExtrapMethod]
         UseRowMajorAlgorithm: [1x1 coder.algorithm.parameter.UseRowMajorAlgorithm]
                      RndMeth: [1x1 coder.algorithm.parameter.RndMeth]
            IndexSearchMethod: [1x1 coder.algorithm.parameter.IndexSearchMethod]
            UseLastTableValue: [1x1 coder.algorithm.parameter.UseLastTableValue]
        RemoveProtectionInput: [1x1 coder.algorithm.parameter.RemoveProtectionInput]
    SaturateOnIntegerOverflow: [1x1 coder.algorithm.parameter.SaturateOnIntegerOverflow]
      SupportTunableTableSize: [1x1 coder.algorithm.parameter.SupportTunableTableSize]
              BPPower2Spacing: [1x1 coder.algorithm.parameter.BPPower2Spacing]

Исследуйте информацию на каждый параметр. Списки свойств Options возможные значения. Primary указывает, требуется ли параметр (1) или дополнительный (0). Свойство Value задает текущее значение. Для обязательных параметров, первоначально, Value установлен в значение по умолчанию для данной функции интерполяционной таблицы.

algParams.InterpMethod

ans = 

  InterpMethod with properties:

       Name: 'InterpMethod'
    Options: {'Linear'  'Flat'  'Nearest'}
    Primary: 1
      Value: {'Linear'}

algParams.RndMeth

ans = 

  RndMeth with properties:

       Name: 'RndMeth'
    Options: {1x7 cell}
    Primary: 0
      Value: {1x7 cell}

algParams.RndMeth.Options

ans = 

  Columns 1 through 5

    'Ceiling'    'Convergent'    'Floor'    'Nearest'    'Round'

  Columns 6 through 7

    'Simplest'    'Zero'

Установите свойства алгоритма для записи таблицы lookup1D. Присвойте значение каждому параметру. Обновите установки параметров для записи путем вызова функционального setAlgorithmParameters. Следующие установки параметров инициировали соответствие с моделью в качестве примера.

algParams.InterpMethod = 'Linear';
algParams.ExtrapMethod = 'Clip';
algParams.UseRowMajorAlgorithm: = 'off';
algParams.RndMeth = 'Round';
algParams.IndexSearchMethod = 'Linear search';
algParams.UseLastTableValue = 'Evenly spaced point';
algParams.RemoveProtectionInput = 'off';
algParams.SaturateOnIntegerOverflow = 'off';
algParams.SupportTunableTableSize = 'off';
algParams.BPPower2Spacing = 'off';
setAlgorithmParameters(hEnt, algParams);

Чтобы проверить ваши изменения, вызовите getAlgorithmParameters, чтобы установить параметр для записи таблицы. Исследуйте значение каждого параметра.

getAlgorithmParameters(hEnt, algParams);
algParams.InterpMethod.Value

ans = 

    'Linear'

algParams.ExtrapMethod.Value

ans = 

    'Clip'

algParams.UseRowMajorAlgorithm.Value

ans = 

    'off'
.
.
.

Создайте аргументы реализации и добавьте их в запись. Этот пример использует вызовы функции getTflArgFromString, чтобы создать пять аргументов реализации, которые сопоставляют с аргументами в заменяющем прототипе функции: один выходной аргумент y1 и четыре входных параметра u1, u2, u3 и u4. setReturn удобных методов и addArgument задают, является ли аргумент возвращаемым значением или аргументом. Функция addArgument также добавляет каждый аргумент в массив записи аргументов реализации.

arg = hEnt.getTflArgFromString('y1','double');
arg.IOType = 'RTW_IO_OUTPUT';
hEnt.Implementation.setReturn(arg); 

arg = hEnt.getTflArgFromString('u1','double');
hEnt.Implementation.addArgument(arg);

arg = hEnt.getTflArgFromString('u2','double*');
hEnt.Implementation.addArgument(arg);

arg = hEnt.getTflArgFromString('u3','double*');
hEnt.Implementation.addArgument(arg);

arg = hEnt.getTflArgFromString('u4','uint32');
hEnt.Implementation.addArgument(arg);

Добавьте запись в заменяющую таблицу кода с вызовом функции addEntry.

addEntry(hLib, hEnt);

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

Укажите заменяющее отображение кода.

Используйте модель rtwdemo_crllookup1D в качестве примера.

Сконфигурируйте модель со следующими настройками: