Сетевой наклон, масштабирующий замену кода

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

В этом примере показано, как разработать заменяющую библиотеку кода, чтобы оптимизировать производительность фиксированной точки сетевые наклонные операции путем предоставления информации о том, как задать замену кода для divide операция. Чтобы разработать заменяющую библиотеку кода используют или интерактивный или программируемый подход. Для получения дополнительной информации смотрите, Разрабатывают Заменяющую Библиотеку Кода.

В интерактивном режиме разработайте заменяющую библиотеку кода

  1. Откройте Code Replacement Tool (crtool) из командной строки MATLAB со следующей командой:

    >>crtool

  2. Составление таблицы.

    1. Из crtool контекстного меню выберите File> New Table.

    2. На правой панели назовите таблицу crl_table_netslopeScaling. Нажмите Apply.

  3. Создайте запись. Из crtool контекстного меню выберите File> New entry> Fixed Point Net Slope Operation.

  4. Создайте параметры записи. В Operation выпадающий список выберите Divide.

  5. Создайте концептуальное представление. Концептуальное представление описывает подпись функции, которую вы хотите заменить. В подразделе Conceptual function crtool задайте возвращаемый аргумент, y1, и входной параметр, u1 и u2 с Data Type fixdt(true,16,*,*) и Argument Type Скаляра.

  6. Создайте представление реализации. Представление реализации описывает подпись оптимизационной функции. В подразделе Function arguments crtool задайте возвращаемый аргумент, y1, и входной параметр, u1 и u2 с Data Type int 16. Также установите Net slope Adjustment Factor как 1 и Net Fixed Exponent как 0.

    Задайте Name для заменяющей функции под Function prototype.

  7. Укажите информацию сборки. Кликните по вкладке Build Information, чтобы открыть панель Requirements сборки. Задайте файлы (источник, заголовок, объект), которого генератор кода требует для замены кода. В данном примере вы не должны указывать информацию сборки.

  8. Подтвердите и сохраните таблицу. Во вкладке Mapping Information нажмите Validate entry. В crtool контекстном меню выберите File> Save table> Save.

  9. Укажите заменяющую библиотеку кода. Регистрация создает библиотеку, состоявшую из таблиц, которые вы задаете. Выберите File> Generate registration file. В Сгенерировать регистрационном диалоговом окне файла заполните эти поля:

    Чтобы пользоваться вашей заменяющей библиотекой кода, обновите свой текущий сеанс работы с MATLAB с командой:

    >>sl_refresh_customizations

  10. Проверьте заменяющую библиотеку кода. Из командной строки MATLAB откройте библиотеку при помощи Code Replacement Viewer и проверьте, что таблица и запись правильно заданы. Для получения дополнительной информации смотрите, Проверяют Заменяющую Библиотеку Кода. Сконфигурируйте свою модель, чтобы пользоваться заменяющей библиотекой кода, сгенерировать код и проверить, что замена происходит как ожидалось. Если неожиданное поведение происходит, исследуйте журналы удачи и неудачи, чтобы диагностировать проблемы.

Программно разработайте заменяющую библиотеку кода

  1. Откройте программируемый интерфейс в меню MATLAB путем выбора New> Function.

  2. Составление таблицы.

    1. Создайте функцию с именем вашей заменяющей таблицы библиотеки кода, которая не имеет аргументов и возвращает объект таблицы. Можно использовать эту функцию, чтобы вызвать заменяющую таблицу библиотеки кода.

    2. Создайте объект таблицы путем вызова RTW.TflTable.

    function hTable = crl_table_netslopeScaling
% Create a function to call the code replacement library table 

%% Create a table object
hTable = RTW.TflTable;

  3. Создайте запись. Поскольку этот пример заменяет функцию, создайте заменяющую запись кода в своей таблице путем вызывания функции записи RTW.TflCOperationEntryGenerator_NetSlope.

    function hTable = crl_table_netslopeScaling
% Create a function to call the code replacement library table 

%% Create a table object
hTable = RTW.TflTable;

%% Create an entry
hEntry = RTW.TflCOperationEntryGenerator_NetSlope;

  4. Установите параметры записи оператора с вызовом setTflCOperationEntryParameters функция. Параметры задают тип операции как деление, режим насыщения, как переносятся на переполнении, округляя режимы, столь же незаданные, и имя заменяющей функции как user_div_*. NetSlopeAdjustmentFactor и NetFixedExponent задайте F и E части сетевого наклонного F2E.

    function hTable = crl_table_netslopeScaling
% Create a function to call the code replacement library table 

%% Create a table object
hTable = RTW.TflTable;

%% Create an entry
hEntry = RTW.TflCOperationEntryGenerator_NetSlope;

%% Create entry parameters
hEntry.setTflCOperationEntryParameters(...
   'Key',                      'RTW_OP_DIV', ...
   'Priority',                 90, ...
   'SaturationMode',           'RTW_WRAP_ON_OVERFLOW', ...
   'RoundingModes',            {'RTW_ROUND_CEILING'}, ...
   'NetSlopeAdjustmentFactor',   1.0, ...
   'NetFixedExponent',           0.0, ...
   'ImplementationName',       's16_div_s16_s16', ...
   'ImplementationHeaderFile', 's16_div_s16_s16.h', ...
   'ImplementationSourceFile', 's16_div_s16_s16.c');

  5. Создайте концептуальные аргументы y1, u1, и u2. Этот пример использует вызовы createAndAddConceptualArg функция, чтобы создать и добавить аргумент с одним вызовом функции. Задайте каждый аргумент как фиксированную точку, 16 битов, и подписанный. Кроме того, для каждого аргумента укажите, что заменяющая обработка запросов кода не проверяет на точное совпадение наклону сайта вызова и смещает значения.

    function hTable = crl_table_netslopeScaling
% Create a function to call the code replacement library table 

%% Create a table object
hTable = RTW.TflTable;

%% Create an entry
hEntry = RTW.TflCOperationEntryGenerator_NetSlope;

%% Create entry parameters
hEntry.setTflCOperationEntryParameters(...
   'Key',                      'RTW_OP_DIV', ...
   'Priority',                 90, ...
   'SaturationMode',           'RTW_WRAP_ON_OVERFLOW', ...
   'RoundingModes',            {'RTW_ROUND_CEILING'}, ...
   'NetSlopeAdjustmentFactor',   1.0, ...
   'NetFixedExponent',           0.0, ...
   'ImplementationName',       's16_div_s16_s16', ...
   'ImplementationHeaderFile', 's16_div_s16_s16.h', ...
   'ImplementationSourceFile', 's16_div_s16_s16.c');

%% Create the conceptual representation
createAndAddConceptualArg(hEntry, 'RTW.TflArgNumeric', ...
   'Name',           'y1', ...
   'IOType',         'RTW_IO_OUTPUT', ...
   'CheckSlope',     false, ...
   'CheckBias',      false, ...
   'DataType',       'Fixed', ...
   'IsSigned',       true, ...
   'WordLength',     16);

createAndAddConceptualArg(hEntry, 'RTW.TflArgNumeric', ...
   'Name',           'u1', ...
   'IOType',         'RTW_IO_INPUT', ...
   'CheckSlope',     false, ...
   'CheckBias',      false, ...
   'DataType',       'Fixed', ...
   'IsSigned',       true, ...
   'WordLength',     16);

createAndAddConceptualArg(hEntry, 'RTW.TflArgNumeric', ...
   'Name',           'u2', ...
   'IOType',         'RTW_IO_INPUT', ...
   'CheckSlope',     false, ...
   'CheckBias',      false, ...
   'DataType',       'Fixed', ...
   'IsSigned',       true, ...
   'WordLength',     16);

  6. Создайте представление реализации. Представление реализации описывает подпись оптимизационной функции. Этот пример использует вызовы createAndSetCImplementationReturn и createAndAddImplementationArg функции, чтобы создать и добавить аргументы реализации в запись. Аргументы реализации должны описать основные типы числовых данных (не типы данных с фиксированной точкой). В этом случае выходные аргументы и входные параметры составляют 16 битов и подписанный (int16).

    function hTable = crl_table_netslopeScaling
% Create a function to call the code replacement library table 

%% Create a table object
hTable = RTW.TflTable;

%% Create an entry
hEntry = RTW.TflCOperationEntryGenerator_NetSlope;

%% Create entry parameters
hEntry.setTflCOperationEntryParameters(...
   'Key',                      'RTW_OP_DIV', ...
   'Priority',                 90, ...
   'SaturationMode',           'RTW_WRAP_ON_OVERFLOW', ...
   'RoundingModes',            {'RTW_ROUND_CEILING'}, ...
   'NetSlopeAdjustmentFactor',   1.0, ...
   'NetFixedExponent',           0.0, ...
   'ImplementationName',       's16_div_s16_s16', ...
   'ImplementationHeaderFile', 's16_div_s16_s16.h', ...
   'ImplementationSourceFile', 's16_div_s16_s16.c');

%% Create the conceptual representation
createAndAddConceptualArg(hEntry, 'RTW.TflArgNumeric', ...
   'Name',           'y1', ...
   'IOType',         'RTW_IO_OUTPUT', ...
   'CheckSlope',     false, ...
   'CheckBias',      false, ...
   'DataType',       'Fixed', ...
   'IsSigned',       true, ...
   'WordLength',     16);

createAndAddConceptualArg(hEntry, 'RTW.TflArgNumeric', ...
   'Name',           'u1', ...
   'IOType',         'RTW_IO_INPUT', ...
   'CheckSlope',     false, ...
   'CheckBias',      false, ...
   'DataType',       'Fixed', ...
   'IsSigned',       true, ...
   'WordLength',     16);

createAndAddConceptualArg(hEntry, 'RTW.TflArgNumeric', ...
   'Name',           'u2', ...
   'IOType',         'RTW_IO_INPUT', ...
   'CheckSlope',     false, ...
   'CheckBias',      false, ...
   'DataType',       'Fixed', ...
   'IsSigned',       true, ...
   'WordLength',     16);

%% Create the Implementation Representation
createAndSetCImplementationReturn(hEntry, 'RTW.TflArgNumeric', ...
                              'Name',           'y1', ...
                              'IOType',         'RTW_IO_OUTPUT', ...
                              'IsSigned',       true, ...
                              'WordLength',     16, ...
                              'FractionLength', 0);

createAndAddImplementationArg(hEntry, 'RTW.TflArgNumeric',...
                              'Name',           'u1', ...
                              'IOType',         'RTW_IO_INPUT', ...
                              'IsSigned',       true, ...
                              'WordLength',     16, ...
                              'FractionLength', 0);

createAndAddImplementationArg(hEntry, 'RTW.TflArgNumeric',...
                              'Name',           'u2', ...
                              'IOType',         'RTW_IO_INPUT', ...
                              'IsSigned',       true, ...
                              'WordLength',     16, ...
                              'FractionLength', 0);

%% Add the entry to the table
addEntry(hTable, hEntry);

  7. Укажите информацию сборки. В параметрах записи задайте файлы (заголовок, источник, объект), в котором генератор кода нужен для замены кода. В данном примере создайте информацию, не требуется.

  8. Подтвердите и сохраните файл настройки. В меню MATLAB сохраните этот файл настройки путем выбора File> Save. Из командной строки подтвердите заменяющую таблицу библиотеки кода путем вызова его:

    >> hTable = crl_table_netslopeScaling

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

    function rtwTargetInfo(cm)
 
cm.registerTargetInfo(@loc_register_crl);
end
 
function this = loc_register_crl 
 
this(1) = RTW.TflRegistry; 
this(1).Name = 'CRL for net slope scaling’;
this(1).TableList = {'crl_table_netslopeScaling.m'}; % table created in this example
this(1).TargetHWDeviceType = {'*'};
this(1).Description = 'Example code replacement library';

end

    Чтобы пользоваться вашей заменяющей библиотекой кода, обновите свой текущий сеанс работы с MATLAB с командой:

    >>sl_refresh_customizations

  10. Проверьте заменяющую библиотеку кода. Из командной строки MATLAB откройте библиотеку при помощи Code Replacement Viewer и проверьте, что таблица и запись правильно заданы. Для получения дополнительной информации смотрите, Проверяют Заменяющую Библиотеку Кода. Сконфигурируйте свою модель, чтобы пользоваться заменяющей библиотекой кода, сгенерировать код и проверить, что замена происходит как ожидалось. Если неожиданное поведение происходит, исследуйте журналы удачи и неудачи, чтобы диагностировать проблемы.

Похожие темы

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