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

Запуск нового сеанса работы с MATLAB.

Создайте или перемещайтесь (cd) в пустую папку.

В командной строке введите crtool команда. Откроется Code Replacement Tool окно.

В Code Replacement Tool окне выберите File > New table.

На правой панели назовите таблицу crl_table_sinfcn и нажмите Apply. Позже, когда вы сохраняете таблицу, инструмент сохраняет ее с именем файла crl_table_sinfcn.m.

На левой панели выберите таблицу crl_table_sinfcn. Затем выберите File > New entry > Function. Новая запись появится на средней панели, первоначально без имени.

На средней панели выберите новую запись.

На правой панели, на вкладке Mapping Information, в меню Function, выберите sin.

Оставьте Algorithm установленным на Unspecifiedи оставьте параметры в группе Conceptual function равными значениям по умолчанию.

В группе Replacement function назовите функцию замены sin_dbl.

Оставьте оставшиеся параметры в группе Replacement function установленными на значения по умолчанию.

Нажмите Apply. Инструмент обновляет Function signature preview, чтобы отразить указанное имя функции замены.

Перейдите в нижнюю часть вкладки Mapping Information и нажмите Validate entry. Инструмент проверяет вашу запись.

На вкладке Build Information для параметра Implementation header file введите sin_dbl.h.

Оставьте оставшиеся параметры равными значениям по умолчанию.

Нажмите Apply.

Вы также можете переоценить запись. Вернитесь на вкладку Mapping Information и нажмите Validate entry.

На средней панели выберите sin_dbl запись.

Выберите Edit > Copy

Выберите Edit > Paste

На вкладке Mapping Information, в разделе Conceptual function, установите тип данных входных параметров u1 на single.

В Replacement function разделе назовите функцию sin_sgl. Установите тип данных входных параметров u1 на single.

Нажмите Apply. Обратите внимание на изменения, которые появляются для Function signature preview.

На вкладке Build Information для параметра Implementation header file введите sin_sgl.h. Оставьте оставшиеся параметры равными значениям по умолчанию и нажмите Apply.

Выберите Actions > Validate table.

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

В инструменте замены кода выберите File > Generate registration file.

В диалоговом окне Generate registration file отредактируйте поля диалогового окна так, чтобы они совпадали со следующим рисунком, и нажмите OK.

В диалоговом окне Select location to save the registration file укажите местоположение файла регистрации. Расположение должно быть в пути MATLAB или в текущей рабочей папке. Сохраните файл. Инструмент сохраняет файл следующим rtwTargetInfo.m.

Проверьте наличие ошибок. В командной строке активируйте файл определения таблицы. Для примера:

Если ошибка существует в файле определения, вызов инициирует появление сообщения. Исправьте ошибку и повторите попытку.

tbl = crl_table_sinfcn

tbl =

TflTable with properties:
               Version: '1.0'
       ReservedSymbols: []
   StringResolutionMap: []
            AllEntries: [2x1 RTW.TflCFunctionEntry]
           EnableTrace: 1|

Используйте средство просмотра замещения кода для проверки записей замещения кода. Для примера:

crviewer('Sin Function Example')

В средстве просмотра выберите записи в таблице и проверьте, что содержимое - это то, что вы ожидаете. Средство просмотра может помочь вам обнаружить такие проблемы, как:

Идентифицируйте существующий или создайте новый код MATLAB, который вызывает sin функция. Для примера:

function y = my_sin_fnc(x)
  y = sin(x);
end

Откройте приложение MATLAB Coder.

Добавьте функцию, которая включает вызов к sin функция как файл точки входа. Для примера добавьте my_sin_func.m. Приложение создает проект с именем my_sin_func.prj.

Щелкните Next, чтобы перейти к Define Input Type шагу. Определите типы для входных параметров функции точки входа.

Щелкните Next, чтобы перейти к Check for Run-Time Issues шагу. Этот шаг является необязательным. Однако лучшая практика выполнить этот шаг. Предоставьте тестовый файл, который вызывает вашу функцию точки входа. Приложение генерирует MEX-функцию из функции точки входа. Затем приложение запускает тестовый файл, заменяя вызовы функции MATLAB вызовами сгенерированной MEX-функции.

Щелкните Next, чтобы перейти к Generate Code шагу. Чтобы открыть диалоговое окно Generate, щелкните стрелу Generate.

Установите Build type, чтобы сгенерировать библиотеку или исполняемый файл.

Нажмите More Settings.

Сконфигурируйте генератор кода, чтобы использовать библиотеку замены кода. На вкладке Custom Code установите для параметра Code replacement library имя библиотеки. Для примера, Sin Function Example.

Сконфигурируйте отчет генерации кода. На вкладке Debug установите параметры Always create a report, Code replacements и Automatically launch a report if one is generated.

Сконфигурируйте генератор кода, чтобы сгенерировать код только. Для Build type выберите Source code. Перед созданием исполняемого файла необходимо просмотреть изменения кода в сгенерированном коде.

Щелкните Generate, чтобы сгенерировать код С и отчет.

Просмотрите результаты замены кода в разделе «Отчет о замене кода» отчета генерации кода.

Отчет указывает, что генератор кода нашел совпадение и применил код замены для функции sin_dbl.

Проверьте замены кода. В отчете щелкните функцию MATLAB, которая инициировала замену, my_sin_func.m. Откроется Редактор MATLAB, который подсвечивает вызов функции, который запускает замену кода.