Сконфигурируйте интерфейс класса C++ для основанных на скорости моделей

В этом примере показано, как сконфигурировать интерфейс класса C++ для модели на основе скорости. В Simulink можно создать и сгенерировать код для основанной на скорости системы моделирования, которая позволяет вам управлять планированием компонентов модели. В этом примере показано, как настроить сгенерированное имя класса, пространство имен, члены класса и методы класса для модели примера. Этот пример, rtwdemo_cppclass, моделирует, включен или выключен двигатель транспортного средства в зависимости от того, было ли включено зажигание.

Цели и требования к интерфейсам

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

  • Чтобы лучше отразить, что эта модель является моделью состояния двигателя, обновите имя класса на engine_status.

  • Чтобы предотвратить столкновения с другими символами в проекте и указать, что сгенерированный код из Simulink, обновите пространство имен класса на sl.

  • Чтобы включить строение имени и аргументов периодической функции базовой скорости, сконфигурируйте входные и выходные порты модели как общедоступные члены класса без метода get/set.

  • Чтобы включить калибровку общих значений для нескольких образцов сгенерированного класса модели, сконфигурируйте параметры модели как частные члены класса с помощью метода get/set.

  • Чтобы упростить интерфейс, сконфигурируйте аргументы параметра и внутренние данные как частные без метода get/set.

  • Чтобы сделать другие имена точек входа более значимыми, обновите имена методов initialize и terminate.

Интерактивный пример

Сконфигурируйте имя класса модели и пространство имен

1. На вкладке Код С++ нажмите Code Interface и выберите Class Name & Namespace.

2. Чтобы сконфигурировать имя класса, в поле C++ Class Name обновите имя на engine_status.

3. Чтобы сконфигурировать пространство имен класса, в поле C++ Class Namespace, обновите имя на sl.

4. Нажмите кнопку ОК.

Сконфигурируйте элементы данных моделей как члены класса

1. Откройте редактор Отображения. На вкладке Код С++ нажмите Code Interface и выберите Code Mappings.

2. Настройте видимость данных. Для категорий элементов модели:

  • Установите значения входных и выходных портов равными public и None.

  • Установите параметры модели равными private и Method.

  • Установите аргументы параметра модели и Signals, состояния и внутренние данные в private и None.

Сконфигурируйте функции модели как методы класса

1. Откройте панель «Функции». В редакторе Отображения перейдите на вкладку Functions.

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

3. Сконфигурируйте периодические функции, чтобы различить частоты дискретизации.

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

  • Сконфигурируйте имя функции. В диалоговом окне строения интерфейса Step Function Interface C++ Step Function Name поле обновите имя функции на EngineEntrypoint.

  • Откройте средство просмотра аргументов. В диалоговом окне выберите Настроить аргументы для прототипа функции Step и нажмите Get default.

  • Сконфигурируйте имена аргумента. В столбце «Имя идентификатора C++» нажмите и отредактируйте имена в keyState arg_keyState, engineState arg_engineState, cycleTime arg_cycleTime.

  • Сконфигурируйте идентификаторы аргументов. В столбце C++ Type Qualifier выберите соответствующий идентификатор из выпадающих опций. Сконфигурируйте keyState arg_keyState как value, engineState arg_engineState как Pointer, и cycleTime arg_cycleTime как Pointer.

  • Измените порядок аргументов. Щелкните и перетащите строки аргументов в средстве просмотра в следующий порядок: keyState arg_keyState, engineState arg_engineState, и cycleTime arg_cycleTime.

  • Проверьте выбранные аргументы. Щелкните Проверить.

  • Чтобы применить изменения и выйти из диалогового окна, нажмите кнопку ОК.

4. Сконфигурируйте другие методы точки входа.

  • Сконфигурируйте имя функции Initialize. В столбце «Имя метода» щелкните и измените электронную таблицу, чтобы изменить имя на initIntegrator.

  • Сконфигурируйте имя функции Terminate. В столбце «Имя метода» щелкните и измените электронную таблицу, чтобы изменить имя на terminateReadIntegrator.

5. Проверьте прототипы методов для всех функций точки входа в столбце Method Preview.

Сгенерируйте интерфейс

1. Сгенерируйте код. Чтобы сгенерировать интерфейс класса C++, на вкладке Код С++, нажмите Build.

2. Просмотрите код. Чтобы просмотреть сгенерированный код, на вкладке нажмите View Code. Сгенерированный код появляется рядом с моделью в рабочем пространстве модели.

Программный пример

Программная конфигурация интерфейса класса C++ для rtwdemo_cppclass модель, используйте этот рабочий процесс:

Откройте модель примера

model ='rtwdemo_cppclass';
open_system(model);

% Get the C++ mapping object
cm = coder.mapping.api.get(model);

Сконфигурируйте имя класса модели и пространство имен

% Configure the C++ class name
setClassName(cm,'engine_status');
% Configure the enclosing namespace
setClassNamespace(cm,'sl');

Сконфигурируйте элементы данных моделей как члены класса

% Configure the inports and outport to pass external data directly to
% the base-rate periodic function in the modeled application. This
% configuration enables you to later configure the name and arguments for
% the base-rate periodic function
setData(cm, 'Inports', 'DataVisibility', 'public');
setData(cm, 'Outports', 'DataVisibility', 'public');
setData(cm, 'Inports', 'MemberAccessMethod', 'None');
setData(cm, 'Outports', 'MemberAccessMethod', 'None');

% Configure model parameters so that you can adjust calibration values
setData(cm, 'ModelParameters','DataVisibility','private');
setData(cm,'ModelParameters', 'MemberAccessMethod','Method');

% Configure Model Parameter Arguments and Iternal data as encapsulated and simple
setData(cm, 'ModelParameterArguments', 'DataVisibility', 'private');
setData(cm, 'ModelParameterArguments', 'MemberAccessMethod', 'None');
setData(cm, 'InternalData', 'DataVisibility', 'private');
setData(cm, 'InternalData', 'MemberAccessMethod', 'None');

Сконфигурируйте функции модели как методы класса

% To configure the periodic functions, use the find function to
% retrieve the periodic functions for the model
periodic_functions = find(cm, 'Periodic');

% Configure the base-rate periodic function method name
setFunction(cm, periodic_functions, 'MethodName', 'EngineEntrypoint');

% Configure the base-rate periodic function arguments
setFunction(cm, periodic_functions,'Arguments',...
    '(const & keyState arg_keyState, * engineState arg_engineState, * cycleTime arg_cycleTime)');

% Configure the initialize and terminate function names
setFunction(cm,'Initialize','MethodName', 'initIntegrator');
setFunction(cm,'Terminate', 'MethodName', 'terminateReadIntegrator');

Сгенерируйте интерфейс

Создайте модель приложения, чтобы сгенерировать интерфейс класса C++.

См. также

|

Похожие темы