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

Настройка блока мастера настройки

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

Для начала создайте копию примера сценария для последующей настройки:

Следующая задача - создать библиотеку Simulink и добавить в нее пользовательский блок.

Следующая задача - связать пользовательский блок с пользовательским сценарием:

Протестируйте блок и сценарий в модели.

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

Создать сценарий мастера настройки

Создайте пользовательский сценарий мастера настройки путем копирования и изменения примера сценария. rtwsampleconfig.m.

Функция конфигурирования.  Сценарий примера реализует одну функцию без возвращаемого значения. Функция принимает один аргумент cs:

function rtwsampleconfig(cs)

Аргумент cs является дескриптором для проприетарного объекта, который содержит информацию об активном наборе конфигурации. Программа Simulink получает этот дескриптор и передает его функции настройки при двойном щелчке по блоку мастера настройки.

Пользовательский сценарий должен соответствовать этому прототипу. Код должен использовать cs как объект «черного ящика», который передает информацию в активный набор конфигурации и из него.

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

Имена опций передаются в set_param и get_param в виде векторов символов, задающих внутреннее имя опции. Внутреннее имя опции может отличаться от метки опции в интерфейсе пользователя (например, в диалоговом окне Параметры конфигурации (Configuration Parameters)). Пример конфигурации сопровождает каждый set_param и get_param вызов с комментарием, который соотносит внутренние имена опций с метками опций пользовательского интерфейса. Например:

set_param(cs,'LifeSpan','1'); % Application lifespan (days)

Чтобы получить текущую настройку опции в активном наборе конфигурации, вызовите get_param. Пройти в cs объект в качестве первого аргумента, за которым следует внутреннее имя параметра. Например, следующий фрагмент кода проверяет настройку опции Создать отчет о создании кода:

if strcmp(get_param(cs, 'GenerateReport'), 'on')
    ...

Чтобы задать опцию в активном наборе конфигурации, вызовите set_param. Пройти в cs объект в качестве первого аргумента, за которым следует одна или несколько пар параметр/значение, задающих внутреннее имя опции и ее значение. Например, следующий фрагмент кода отключает параметр Поддерживать абсолютное время (Support absolute time):

set_param(cs,'SupportAbsoluteTime','off');

Выберите целевой объект.  Сценарий мастера настройки должен выбрать целевую конфигурацию. В примере сценария в качестве целевого объекта ERT используется по умолчанию. Сценарий сначала сохраняет переменные вектора символов, которые соответствуют требуемому целевому файлу системы, файлу шаблона и настройкам команды Make:

stf = 'ert.tlc';
tmf = 'ert_default_tmf';
mc  = 'make_rtw';

Вы выбираете системный целевой файл, передавая cs объект и stf символьный вектор к switchTarget функция:

switchTarget(cs,stf,[]);

Установка make-файла шаблона и создание параметров команды с помощью set_param вызовы:

set_param(cs,'TemplateMakefile',tmf);
set_param(cs,'MakeCommand',mc);

Чтобы выбрать цель, пользовательский сценарий должен настроить переменные вектора символов stf, tmf, и mc и передать их вызовам.

Получение информации о целевом объекте и наборе конфигурации.  Следующие служебные функции и свойства предоставляются, чтобы код мог получить информацию о текущем целевом объекте и наборе конфигурации с помощью cs объект:

Эту информацию можно использовать для определения того, должен ли сценарий настраивать параметры, специфичные для ERT, например:

if isERT
  set_param(cs,'ZeroExternalMemoryAtStartup','off');
  set_param(cs,'ZeroInternalMemoryAtStartup','off');
  set_param(cs,'InitFltsAndDblsToZero','off');
  set_param(cs,'NoFixptDivByZeroProtection','on')
end

Вызов сценария мастера настройки из командной строки

Сценарии мастера настройки можно запустить из командной строки MATLAB.

Перед вызовом сценария необходимо открыть модель и создать экземпляр cs объект для передачи в качестве аргумента сценарию. После выполнения сценария можно вызвать процесс построения с помощью slbuild команда. В следующем примере открывается, конфигурируется и строится модель.

open my_model;
cs = getActiveConfigSet ('my_model');
rtwsampleconfig(cs);
slbuild('my_model');