В этом примере показов, как установить владение глобальными данными в коде, сгенерированном из ссылочных моделей.
Можно создать глобальную переменную в сгенерированном коде путем применения класса памяти к элементу данных в модели-ссылке (см. Строение генерации кода C для элементов интерфейса модели). При определенные обстоятельства генератор кода помещает определение переменной с кодом, сгенерированным из верхней модели в иерархии. Это размещение по умолчанию может затруднить определение того, какая модель отвечает за данные, и управление изменениями кода в среде разработки на базе команды.
Чтобы установить принадлежность глобальной переменной путем размещения определения с кодом, сгенерированным из соответствующей модели, примените класс памяти, такой как ExportToFile и задайте пользовательский атрибут Владелец. Кроме того, для таких объектов параметров, как Simulink.Parameter который вы используете только в одной модели, можно установить владение путем хранения объекта в рабочем пространстве модели вместо базового рабочего пространства или словаря данных.
1. Скопируйте файл скрипта prepare_sldemo_fuelsys_dd_ctrl.m в текущую папку.
[~, ~] = copyfile(fullfile(matlabroot,'examples','ecoder','main','prepare_sldemo_fuelsys_dd_ctrl.m'),... 'prepare_sldemo_fuelsys_dd_ctrl.m','f');
2. Запустите копию скрипта в текущей папке. Скрипт открывает модель sldemo_fuelsys_dd_controller и готовит его к этому примеру.
prepare_sldemo_fuelsys_dd_ctrl
open_system('sldemo_fuelsys_dd_controller')
Эти модели контроллеров содержат две модели, airflow_calc и fuel_calc. Два выхода airflow_calc, est_airflow и fb_correction, являются входами fuel_calc.
3. Откройте airflow_calc модель.
open_system('airflow_calc')
4. На вкладке Моделирование (Modeling) щелкните Редактор данных модели (Model Data Editor).
5. В Model Data Editor установите в раскрывающемся списке Изменить представление значение Code.
6. В airflow_calc модель, выберите est_airflow Блок вывода.
7. В Model Data Editor проверьте значение в столбце Классе памяти. Сигнал, который представляет этот блок, est_airflow, использует класс памяти ExportToFile. При этой настройке сигнал появляется в сгенерированном коде как глобальная переменная. Блок Outport маркирован fb_correction также использует эту настройку.
8. В Model Data Editor выберите вкладку Параметры и нажмите кнопку Показать/обновить дополнительную информацию. Теперь Model Data Editor показывает информацию о переменных рабочей области и объектах, таких как Simulink.Parameter объекты, которые модель использует, чтобы задать значения параметров блоков.
9. В поле Содержимое фильтра введите numerator. The Simulink.Parameter numerator_param объекта, который находится в базовом рабочем пространстве, устанавливает значение параметра Numerator в маркированном блоке Discrete Filter Throttle Transient. Объект использует класс памяти ExportToFile.
10. Выберите вкладку Signals. В поле Содержимое фильтра введите e0. Сигнал e0, который является внутренним по отношению к airflow_calc ссылка на модель, также использует ExportToFile. Сигнал является внутренним, потому что это не вход или выход корневого уровня модели.
11. Откройте fuel_calc модель.
open_system('fuel_calc')
12. В Model Data Editor для этой модели на вкладке Inports/Outports установите значение представления Change Code. Входной порт блокирует est_airflow и fb_correction использовать тот же класс памяти, ExportToFile, как соответствующие блоки Outport в airflow_calc. Блок Outport маркирован fuel_rate также использует ExportToFile.
Сгенерируйте код из моделей контроллеров, sldemo_fuelsys_dd_controller.
evalc('slbuild(''sldemo_fuelsys_dd_controller'')');
В отчете о генерации кода в разделе Ссылочные Модели щелкните гиперссылку, чтобы просмотреть код, сгенерированный для airflow_calc.
Файл airflow_calc.c задает глобальную переменную, которая представляет сигнал e0. Потому что блоки, которые записывают и читают из e0 существует только в airflow_calcГенератор кода принимает, что эта модель владеет сигналом.
file = fullfile('slprj','ert','airflow_calc','airflow_calc.c'); rtwdemodbtype(file,'/* Definition for custom storage class: ExportToFile */',... 'real32_T e0;',1,1)
/* Definition for custom storage class: ExportToFile */ real32_T e0; /* '<Root>/Sum1' */
В отчете генерации кода вернитесь к коду, сгенерированному для sldemo_fuelsys_dd_controller.
Файл sldemo_fuelsys_dd_controller.c задает другие глобальные переменные.
file = fullfile('sldemo_fuelsys_dd_controller_ert_rtw',... 'sldemo_fuelsys_dd_controller.c'); rtwdemodbtype(file,... '/* Definition for custom storage class: ExportToFile */',... 'real32_T numerator_param[2] = { 0.01F, -0.01F } ;',1,1);
/* Definition for custom storage class: ExportToFile */
real32_T est_airflow; /* '<Root>/airflow_calc' */
real32_T fb_correction; /* '<Root>/airflow_calc' */
real32_T fuel_rate; /* '<Root>/fuel_calc' */
real32_T numerator_param[2] = { 0.01F, -0.01F } ;
Потому что сигналы est_airflow и fb_correction пройти между двумя моделями и через модели контроллеров верхнего уровня, генератор кода принимает, что sldemo_fuelsys_dd_controller владеет сигналами. Генератор кода делает аналогичное предположение о fuel_rate. Потому что объект параметра numerator_param существует в базовом рабочем пространстве, любая модель в иерархии может использовать объект. Поэтому генератор кода принимает, что sldemo_fuelsys_dd_controller владеет параметром.
Можно сконфигурировать каждый общий сигнал и объект параметра так, чтобы соответствующее определение переменной появилось в коде, сгенерированном для релевантной модели.
В этом примере вы конфигурируете настройки генерации кода так, чтобы:
Код, сгенерированный для airflow_calc модель определяет сигналы, которые проходят между двумя моделями, est_airflow и fb_correction.
Код, сгенерированный для airflow_calc определяет данные параметра, numerator_param.
Код, сгенерированный для fuel_calc определяет сигнал выхода, который он вычисляет, fuel_rate.
1. В airflow_calc модель, на вкладке Modeling, в разделе Design, нажмите Property Inspector.
2. В Model Data Editor выберите вкладку Inports/Outports.
3. Выберите строку, которая соответствует блоку Outport est_airflow. Property Inspector показывает свойства блока Outport.
4. В Property Inspector в разделе «Коде» установите значение «Владелец» равным airflow_calc. Генератор кода помещает определение глобальной переменной с кодом, сгенерированным для airflow_calc.
5. Для fb_correction, используйте Model Data Editor и Property Inspector, чтобы задать значение Owner airflow_calc.
6. Выберите вкладку Parameters.
7. Найдите строку, которая соответствует объекту параметра, numerator_param. В строке дважды щелкните значок в левом столбце. Откроется Обозреватель моделей (Model Explorer), в котором отобразятся свойства numerator_param.
8. На панели Иерархия модели разверните узел airflow_calc так, чтобы вы могли увидеть подчиненный узел Рабочего пространства модели.
9. Используйте браузер Model Explorer, чтобы переместить numerator_param из базового рабочего пространства в airflow_calc рабочего пространства модели. Для примера на панели Иерархия модели выберите Базовое рабочее пространство. Затем перетащите мышью numerator_param от панели Содержимое до узла Рабочего пространства модели на панели иерархии модели. С этим изменением генератор кода принимает, что airflow_calc владеет numerator_param, и помещает определение переменной в код, сгенерированный для airflow_calc.
10. В fuel_calc модель, на вкладке Modeling, в разделе Design, нажмите Property Inspector.
11. Для блоков Inport est_airflow и fb_correction, используйте Model Data Editor и Property Inspector, чтобы задать значение Owner airflow_calc. С помощью этого строения fuel_calc код не определяет переменные.
12. Для блока Outport используйте Model Data Editor и Property Inspector, чтобы задать значение Owner fuel_calc.
Кроме того, чтобы сконфигурировать данные в моделях, используйте эти команды в командной строке:
temp = Simulink.Signal; temp.CoderInfo.StorageClass = 'Custom'; temp.CoderInfo.CustomStorageClass = 'ExportToFile'; temp.CoderInfo.CustomAttributes.Owner = 'airflow_calc'; set_param('airflow_calc/est_airflow','SignalName','est_airflow') set_param('airflow_calc/est_airflow','SignalObject',copy(temp)) set_param('airflow_calc/fb_correction','SignalName','fb_correction') set_param('airflow_calc/fb_correction','SignalObject',copy(temp)) mdlwks = get_param('airflow_calc','ModelWorkspace'); assignin(mdlwks,'numerator_param',copy(numerator_param)); portHandles = get_param('fuel_calc/est_airflow','portHandles'); outportHandle = portHandles.Outport; set_param(outportHandle,'Name','est_airflow') set_param(outportHandle,'SignalObject',copy(temp)) portHandles = get_param('fuel_calc/fb_correction','portHandles'); outportHandle = portHandles.Outport; set_param(outportHandle,'Name','fb_correction') set_param(outportHandle,'SignalObject',copy(temp)) temp.CoderInfo.CustomAttributes.Owner = 'fuel_calc'; set_param('fuel_calc/fuel_rate','SignalName','fuel_rate') set_param('fuel_calc/fuel_rate','SignalObject',copy(temp)) clear temp portHandles outportHandle numerator_param
13. В каждой из трех моделей выберите Параметры конфигурации > Использовать владельца из объекта данных для размещения определения данных. Когда этот параметр снят (по умолчанию), генератор кода игнорирует значения, заданные для Owner.
set_param('fuel_calc','EnableDataOwnership','on') set_param('airflow_calc','EnableDataOwnership','on') set_param('sldemo_fuelsys_dd_controller','EnableDataOwnership','on')
14. Сохраните ссылку на модели.
save_system('fuel_calc') save_system('airflow_calc')
Сгенерируйте код из моделей контроллеров, sldemo_fuelsys_dd_controller.
evalc('slbuild(''sldemo_fuelsys_dd_controller'')');
Теперь файл sldemo_fuelsys_dd_controller.c не задает ни одну из глобальных переменных.
В отчете о генерации кода проверьте код, сгенерированный для airflow_calc.
Файл airflow_calc.c теперь задает глобальные переменные, которые относятся к airflow_calc.
file = fullfile('slprj','ert','airflow_calc','airflow_calc.c'); rtwdemodbtype(file,'/* Definition for custom storage class: ExportToFile */',... 'real32_T numerator_param[2] = { 0.01F, -0.01F } ;',1,1)
/* Definition for custom storage class: ExportToFile */
real32_T e0; /* '<Root>/Sum1' */
real32_T est_airflow; /* '<Root>/Sum' */
real32_T fb_correction; /* '<Root>/Discrete Integrator' */
real32_T numerator_param[2] = { 0.01F, -0.01F } ;
Смотрите код, сгенерированный для fuel_calc. Файл fuel_calc.c задает глобальную переменную fuel_rate.
file = fullfile('slprj','ert','fuel_calc','fuel_calc.c'); rtwdemodbtype(file,'/* Definition for custom storage class: ExportToFile */',... 'real32_T fuel_rate;',1,1)
/* Definition for custom storage class: ExportToFile */ real32_T fuel_rate; /* '<S2>/Merge' */
Элементы данных сигнала est_airflow и fb_correction представлены блоками Outport в airflow_calc и блоками Inport в fuel_calc. Если вы хотите изменить строение одного из этих сигналов, вы должны сделать изменение в обеих моделях. Для примера, если вы хотите изменить класс памяти est_airflow от ExportToFile на Volatileнеобходимо изменить класс памяти дважды: один раз для блока Outport в airflow_calc и снова для блока Inport в fuel_calc.
Чтобы облегчить обслуживание каждого сигнала, сохраните настройки генерации кода в Simulink.Signal объект, который может существовать в базовом рабочем пространстве или словаре данных.
1. В Model Data Editor для airflow_calc, на вкладке Inports/Outports найдите строку, которая соответствует est_airflow. Для этой строки в столбце «Имя сигнала» щелкните камеру.
2. В камере, рядом с est_airflow нажмите кнопку действия (с тремя вертикальными точками). Выберите «Создать и решить».
3. В диалоговом окне «Создание новых данных» установите значение Simulink.Signal и нажмите «Создать». A Simulink.Signal объект с именем est_airflow появляется в базовом рабочем пространстве. В Model Data Editor для est_airflowустановлен флажок в флажке Разрешить (Resolve), что означает, что блок Outport получает настройки генерации кода от объекта сигнала в базовом рабочем пространстве.
4. В est_airflow диалоговое окно свойств, установите для класса памяти значение ExportToFile.
5. Установите для владельца значение airflow_calc.
6. Используйте Model Data Editor, чтобы создать аналогичный объект сигнала для fb_correction.
В Model Data Editor для fuel_calc, на вкладке Inports/Outports, в столбце Resolve, установите флажки для est_airflow и fb_correction. Теперь каждый блок Inport получает настройки генерации кода от соответствующего объекта сигнала.
Кроме того, чтобы создать объект сигнала и сконфигурировать блоки и линии в модели, в командной строке используйте следующие команды:
est_airflow = Simulink.Signal; est_airflow.CoderInfo.StorageClass = 'Custom'; est_airflow.CoderInfo.CustomStorageClass = 'ExportToFile'; est_airflow.CoderInfo.CustomAttributes.Owner = 'airflow_calc'; fb_correction = Simulink.Signal; fb_correction.CoderInfo.StorageClass = 'Custom'; fb_correction.CoderInfo.CustomStorageClass = 'ExportToFile'; fb_correction.CoderInfo.CustomAttributes.Owner = 'airflow_calc'; set_param('airflow_calc/est_airflow', 'StorageClass', 'Auto') set_param('airflow_calc/est_airflow','MustResolveToSignalObject','on') set_param('airflow_calc/fb_correction', 'StorageClass', 'Auto') set_param('airflow_calc/fb_correction','MustResolveToSignalObject','on') portHandles = get_param('fuel_calc/est_airflow','portHandles'); outportHandle = portHandles.Outport; set_param(outportHandle, 'StorageClass', 'Auto') set_param(outportHandle,'MustResolveToSignalObject','on') portHandles = get_param('fuel_calc/fb_correction','portHandles'); outportHandle = portHandles.Outport; set_param(outportHandle, 'StorageClass', 'Auto') set_param(outportHandle,'MustResolveToSignalObject','on') clear portHandles outportHandle
7. Сохраните модели и сгенерируйте код из sldemo_fuelsys_dd_controller. Код такой же, как был до того, как вы создали Simulink.Signal объекты. Теперь можно вносить изменения в объекты сигнала вместо соответствующих блоков и линий в моделях.
save_system('airflow_calc') save_system('fuel_calc') evalc('slbuild(''sldemo_fuelsys_dd_controller'')');