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

Создание кода для инициализации и завершения событий

При создании кода для компонента, включающего блоки «Инициализация функции» и «Завершение функции», генератор кода:

Рассмотрим модель rtwdemo_irt_base.

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

void rtwdemo_irt_base_initialize(void)
void rtwdemo_irt_base_terminate(void)

Этот код появляется в созданном файле rtwdemo_irt_base.c. Функция инициализации, rtwdemo_irt_base_initialize:

Функция завершения,,rtwdemo_irt_base_terminate, не требует кода.

Этот код предполагает, что поддержка неокончательных номеров и ведения журнала MAT-файлов отключена.

void rtwdemo_irt_base_initialize(void)
{
  rtmSetErrorStatus(rtwdemo_irt_base_M, (NULL));

  (void) memset((void *)&rtwdemo_irt_base_DW, 0,
                 sizeof(DW_rtwdemo_irt_base_T));   
      
  rtwdemo_irt_base_Y.Out1 = 0.0;

  rtwdemo_irt_base_DW.DiscreteIntegrator_DSTATE = 0.0;
}
	
void rtwdemo_irt_base_terminate(void)
{
  /* (no terminate code required) */
}

Добавление в модель блоков Initialize Function и Terminate Function (см. rtwdemo_irt_initterm). Блок инициализации функции использует блок записи состояния для установки начального состояния блока дискретного интегратора. Блок завершения функции включает в себя блок считывания состояния, который считывает состояние блока дискретного интегратора.

Параметр Тип события для блока прослушивателя событий для функций инициализации и завершения имеет значение Initialize и Terminateсоответственно. Функция инициализации использует блок записи состояния для инициализации входного значения для блока дискретного интегратора на 10. Функция завершения использует блок считывания состояния для считывания состояния блока дискретного интегратора.

Генератор кода включает код события, который он создает для блоков Initialize Function и Terminate Function со стандартным кодом initialize и terminate в функциях начального уровня. rtwdemo_irt_initterm_initialize и rtwdemo_irt_initterm_terminate. Этот код предполагает, что поддержка неокончательных номеров и ведения журнала MAT-файлов отключена.

void rtwdemo_irt_initterm_initialize(void)
{
  rtmSetErrorStatus(rtwdemo_irt_initterm_M, (NULL));
		
  (void) memset((void *)&rtwdemo_irt__initterm_DW, 0,
	          sizeof(DW_rtwdemo_irt__initterm_T));
	
  rtwdemo_irt_initterm_Y.Out1 = 0.0;

  rtwdemo_irt_initterm_DW.DiscreteIntegrator_DSTATE = 10.0;
}

void rtwdemo_irt__initterm_terminate(void)
{
  /* (no terminate code required) */
} 

Создать код для событий сброса

Создайте код, реагирующий на событие сброса, включив в компонент моделирования блок «Инициализация функции» или «Завершение функции». Настройте блок для сброса, установив для параметра Event type его блока Event Listener значение Reset. Также задайте параметр Имя события. Имя по умолчанию: reset.

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

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

Для параметра Тип события (Event type) и Имя события (Event name) блока Прослушиватель событий (Event Listener) установлено значение Reset и resetсоответственно. Функция использует блок записи состояния, чтобы сбросить входное значение для блока дискретного интегратора на 5.

Генератор кода создает функцию сброса rtwdemo_irt_reset_reset.

void rtwdemo_irt_reset_reset(void)

{
  rtwdemo_irt_reset_DW.DiscreteIntegrator_DSTATE = 5.0;
}

Имена событий и агрегирование кодов

Блоки Initialize Function и Terminate Function используются для определения нескольких функций инициализации, сброса и завершения иерархии компонентов. Определите только одну функцию инициализации и одну функцию завершения на уровне иерархии. Для уровня иерархии можно определить несколько функций сброса. Имена событий, настраиваемые для функций на данном уровне, должны быть уникальными.

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

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

Хотя модель включает несколько копий функций инициализации, сброса и завершения, генератор кода создает одну функцию точки входа для сброса (rtwdemo_irt_shared_reset), один для инициализации (rtwdemo_irt_shared_initialize) и один для завершения (rtwdemo_irt_shared_terminate). В каждой функции точки входа после перечисления кода для блоков, сконфигурированных с начальным условием (model_P.block_IC), генератор кода упорядочивает код для компонентов, начиная с самого низкого уровня иерархии и заканчивая корнем.

.
.
.
void rtwdemo_irt_shared_reset(void)
{
  rtwdemo_irt_shared_DW.SubIntegrator2_DSTATE = 5.0;

  rtwdemo_irt_shared_DW.Integrator2_DSTATE = 5.0;
} 
.
.
.
void rtwdemo_irt_shared_initialize(void)
{
  rtmSetErrorStatus(rtwdemo_irt_shared_M, (NULL));

  (void) memset(((void *)&rtwdemo_irt_shared_DW), 0,
                sizeof(DW_rtwdemo_irt_shared_T));

  rtwdemo_irt_shared_Y.Out1 = 0.0;

  rtwdemo_irt_shared_DW.Integrator1_DSTATE = 0.0;

  rtwdemo_irt_shared_DW.SubIntegrator2_DSTATE = 2.0;

  rtwdemo_irt_shared_DW.Integrator2_DSTATE = 10.0;
.
.
.
void rtwdemo_irt_shared_terminate(void)
{
   /* (no terminate code required) */
   }

При переименовании события, сконфигурированного для функции сброса подсистемы, в reset_02генератор кода создает две функции сброса точки входа, rtwdemo_irt_shared_reset и rtwdemo_irt_shared_reset_02.

void rtwdemo_irt_shared_reset(void)
{
	  rtwdemo_irt_shared_DW.SubIntegrator2_DSTATE = 5.0;
}
 
void rtwdemo_irt_shared_reset_02(void)
{
   rtwdemo_irt_shared_DW.Integrator2_DSTATE = 5.0;
}

Ограничение

Нельзя создать код из модели кабельных трасс - корневой модели, содержащей блок «Модель», который открывает порты функций инициализации, сброса или завершения.