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

timesN Обзор учебного пособия

Цель: Понять, как работает TLC с S-функцией.

Папка: matlabroot/toolbox/rtw/rtwdemos/tlctutorial/timesN (открыто)

В этом учебном пособии вы создадите версии кода C для существующей S-функции timesN.

Учебное пособие включает следующие шаги:

В более позднем учебном пособии содержится информация и практические рекомендации по «свертыванию» S-функций.

Создание неинлинированного кода

Папка учебного пособия tlctutorial/timesN в рабочей папке содержится S-функция Simulink ® timesN.c.

В этом упражнении мы создадим неинлинный код из модели sfun_xN.

/* Model output function */
static void sfun_xN_output(int_T tid)
{
  /* Sin: '<Root>/Sin' */
  sfun_xN_B.Sin = sin(sfun_xN_M->Timing.t[0] * sfun_xN_P.Sin_Freq +
                      sfun_xN_P.Sin_Phase) * sfun_xN_P.Sin_Amp +
    sfun_xN_P.Sin_Bias;

  /* S-Function Block: <Root>/S-Function */
  /* Multiply input by 3.0 */
  sfun_xN_B.timesN_output = sfun_xN_B.Sin * 3.0;

  /* Outport: '<Root>/Out' */
  sfun_xN_Y.Out = sfun_xN_B.timesN_output;
  UNUSED_PARAMETER(tid);
}

Комментарии появляются в коде, поскольку на панели «Создание кода» > «Комментарии» диалогового окна «Параметры конфигурации» по умолчанию выбран параметр «Включить комментарии».

Зачем использовать TLC для встроенных S-функций?

Генератор кода включает общий API, который можно использовать для вызова написанных пользователем алгоритмов и драйверов. API включает в себя различные функции обратного вызова - для инициализации, вывода, производных, завершения и т.д., а также структуры данных. После кодирования они создаются в памяти и вызываются во время выполнения посредством непрямых вызовов функций. Каждый вызов включает в себя кадры стека и другие служебные данные, которые увеличивают время выполнения.

В среде реального времени, особенно когда задействовано множество шагов решения, общие вызовы API могут быть недопустимо медленными. Генератор кода может ускорить S-функции в автономных приложениях, которые он генерирует, встраивая написанные пользователем алгоритмы в автоматически сгенерированные функции, а не косвенно вызывая S-функции через общий API. Эта форма оптимизации называется встроением. TLC встроен в S-функции, что приводит к более быстрому, оптимизированному коду.

Следует понимать, что TLC не является заменой для записи S-функций кода C. Для вызова пользовательских блоков в Simulink по-прежнему необходимо записывать S-функции в C (или в виде файлов MATLAB), поскольку моделирование не использует файлы TLC. Однако можно подготовить TLC-файлы, которые встроены в определенные S-функции, чтобы сделать целевой код намного более эффективным.

Создание встроенной S-функции

TLC создает встроенную S-функцию всякий раз, когда она обнаруживает .tlc с тем же именем, что и S-функция. Предполагая .tlc файл имеет ожидаемую форму, он направляет построение кода, который функционально дублирует внешнюю S-функцию без дополнительных затрат API. Чтобы узнать, как работает этот процесс, выполните следующие действия.