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

Зачем генерировать код из функциональных блоков Simulink и вызывающих функций?

Функциональные блоки Simulink обеспечивают механизм генерации кода C or C++ для компонентов моделирования, которые представляют общие ресурсы. Вы определяете логику как ресурс в блоке Simulink Function, который отделяет интерфейс функции (имя и аргументы) от реализации логики. Функциональные вызывающие абоненты (блоки Function Caller, блоки MATLAB Function и Stateflow^® графики) может затем повторно использовать логику функции на разных уровнях иерархии модели.

Функциональные блоки Simulink обеспечивают альтернативу переиспользуемым подсистемам. Для примера фактора использования блока Simulink Function вместо блока подсистемы состоит в том, что блок Simulink Function разделяет состояния между вызывающими функциями. Генератор кода производит одну функцию. Если блок Simulink Function содержит блоки, которые имеют состояния, такие как задержка или память, состояния, постоянные между вызывающими функциями. Порядок вызовов функций является важным фактором.

Переиспользуемые функции, которые генерирует генератор кода из подсистем, не разделяют состояния. Генератор кода производит одну функцию для нескольких образцов подсистемы как оптимизацию. Если эта подсистема содержит блоки, которые имеют состояния, генератор кода производит одну функцию, но передает другую переменную состояния каждому образцу. Состояния образцов не разделяются.

Другие способы использования функциональных блоков Simulink и вызывающих абонентов:

Опции реализации

Выберите, как реализовать Simulink^® функции и вызывающие абоненты на основе ваших требований к генерации кода. Факторы включают в себя:

Выбор шаблона моделирования

Эта таблица показывает Код С для функции, которая умножает вход значение на два, и блока Simulink Function, который может представлять эту функцию в модели Simulink.

#include "timestwo_sf.h"

#include "ex_slfunc_comp_sf.h"
#include "ex_slfunc_comp_sf_private.h"

void timestwo_sf(real_T rtu_x, real_T *rty_y)
{
  *rty_y = 2.0 * rtu_x;
}

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

void ex_slfunc_comp_sf_step(void)
{
  real_T rtb_FunctionCaller1;

timestwo_sf(ex_slfunc_comp_sf_U.In1, &rtb_FunctionCaller1);

ex_slfunc_comp_sf_Y.Out1 = rtb_FunctionCaller1;
.
.
.

void ex_slfunc_comp_gf_step(void)
{
  real_T rtb_y1_l;

  timestwo_gf(ex_slfunc_comp_gf_U.In4, &rtb_y1_l);

  ex_slfunc_comp_gf_Y.Out4 = rtb_y1_l;  
  .
  .
  .

void ex_slfunc_comp_mf_step(void)
{ 
  real_T rtb_y;
  
  timestwo_mf(ex_slfunc_comp_mf_U.In3, &rtb_y);

  ex_slfunc_comp_mf_Y.Out3 = rtb_y;
  .
  .
  .

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

Задайте возможности функции

Функция, которую вы задаете с блоком Simulink Function, может быть глобальной или масштабированной.

Для получения дополнительной информации см., и Обзор масштабированных и глобальных функциональных блоков Simulink.

Решите, генерировать ли код экспорта функций

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

Для получения дополнительной информации смотрите Сгенерировать исходный код компонента для экспорта во внешнюю основу кода и Обзор моделей экспорта функций.

Задайте интерфейс кода функции Индивидуальных настроек

С помощью Embedded Coder упростите интегрирование сгенерированного кода с внешним кодом, настроив сгенерированные интерфейсы кода функции для блоков Simulink Function и Function Caller. Можно настроить интерфейсы функций для:

Для получения дополнительной информации смотрите Сконфигурируйте интерфейсы функции точки входа для блоков Simulink Function и Function Caller.

Незакрытые функциональные блоки Simulink

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

Чтобы идентифицировать такие блоки в модели на основе скорости, отобразите шаг расчета цвета во время симуляции. По умолчанию блоки Constant появляются пурпурно. Поскольку генератор кода рассматривает незакрытые Simulink Function блокирует константы во время симуляции, они кажутся пурпурными.

Требования

Ограничения

Сгенерируйте и вызовите переиспользуемый код функции

В этом примере показано, как использовать блоки Simulink Function и Function Caller для генерации кода переиспользуемой функции. Генератор кода производит глобальную функцию, которая соответствует требованиям кода, так что существующий внешний код может вызвать функцию и локальную функцию. Генератор кода также производит вызовы глобальных и локальных функций. Вызов глобальной функции показывает, что глобальная функция используется повторно (совместно используется).

Требования к коду для глобальной функции:

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

Некоторые функции, используемые в этом примере, такие как псевдонимизация и замена типов данных, требуют программного обеспечения Embedded Coder.

typedef int my_int;

#include "call_times2.h"

void call_times2(void)
{
  int times2result;

  func_times2(x1, &y1);

  printf('Times 2 Value:', y1);
}

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

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

Откройте пример модели rtwdemo_export_functions. Модель использует программное обеспечение Stateflow, но в этом примере рассматривается только код, сгенерированный из ссылочных моделей.

void rtwdemo_caller_t_10tic(const real_T *rtu_u, 
                            real_T *rty_y)
{
  f3(*rtu_u, rty_y);
}