При использовании привязки модели для разделения большой системы на компоненты каждый компонент является отдельной моделью. Можно повторно использовать компонент, обратившись к нему с несколькими блоками модели. Каждый блок модели является экземпляром компонента. Затем можно настроить параметр блока (например, параметр усиления блока усиления) для использования одного и того же значения или другого значения для каждого экземпляра компонента. Для использования различных значений создайте и используйте аргумент модели для задания значения параметра блока.
При создании кода из иерархии модели, в которой используются аргументы модели, аргументы отображаются в коде как формальные параметры ссылочных функций точки входа модели, таких как вывод (step) функция. Затем созданный код передает значения параметров экземпляра, указанные в каждом блоке модели, соответствующим вызовам функций.
Независимо от того, используете ли вы аргументы модели или нет, можно использовать классы хранения данных, чтобы настроить отображение параметров блоков в создаваемом коде в качестве настраиваемых глобальных переменных. Классы хранения можно также использовать для создания настраиваемых значений аргументов модели, которые генерируемый код сохраняет в памяти и передает вызовам функции. Затем можно изменить значения во время выполнения.
Настройте ссылочную модель для принятия данных параметров через формальные параметры созданной функции точки входа модели. Этот метод позволяет задать различные значения параметров для каждого экземпляра (блока модели) ссылочной модели.
Настройка ссылочной модели для использования аргументов модели
Открытие модели ex_arg_code_ref. Эта модель представляет многократно используемый алгоритм.
open_system('ex_arg_code_ref')
На вкладке Моделирование (Modeling) щелкните Редактор данных модели (Model Data Editor).
В редакторе данных модели в таблице данных используйте столбец Тип данных (Data Type), чтобы задать тип данных блока Inport равным single. Из-за наследования типа данных другие сигналы в модели используют тот же тип данных.
Выберите вкладку Параметры (Parameters).
В модели выберите блок усиления.
В редакторе данных модели используйте столбец Значение (Value), чтобы задать значение параметра Коэффициент усиления (Gain) равным gainArg.
Рядом с gainArgнажмите кнопку действия (3 вертикальные точки) и выберите Создать (Create).
В диалоговом окне «Создание новых данных» задайте для параметра «Значение» значение Simulink.Parameter и расположение в Model Workspace. Щелкните Создать (Create).
В диалоговом окне свойств задайте для параметра «Значение» значение, например: 3.17. Нажмите кнопку ОК.
Используйте Редактор данных модели (Model Data Editor), чтобы задать параметр Числитель (Numerator) с помощью Simulink.Parameter объект с именем coeffArg значение которого - 1.05. Как и с gainArgсохраните объект параметра в рабочем пространстве модели.
В редакторе данных модели нажмите кнопку Показать/обновить дополнительную информацию.
Используйте поле Содержимое фильтра (Filter contents), чтобы найти каждый объект параметра (gainArg и coeffArg). Для каждого объекта установите флажок в столбце «Аргумент».
Сохранить ex_arg_code_ref модель.
Кроме того, в командной строке можно использовать следующие команды для настройки блоков и объектов параметров:
set_param('ex_arg_code_ref/In1','OutDataTypeStr','single') set_param('ex_arg_code_ref/Gain','Gain','gainArg') modelWorkspace = get_param('ex_arg_code_ref','ModelWorkspace'); assignin(modelWorkspace,'gainArg',Simulink.Parameter(3.17)); set_param('ex_arg_code_ref/Discrete Filter','Numerator','coeffArg') assignin(modelWorkspace,'coeffArg',Simulink.Parameter(1.05)); set_param('ex_arg_code_ref','ParameterArgumentNames','coeffArg,gainArg') save_system('ex_arg_code_ref')
Задание значений параметров, зависящих от экземпляра, в блоках модели
Открытие модели ex_arg_code. Эта модель использует несколько экземпляров (блоки модели) многократно используемого алгоритма.
open_system('ex_arg_code')
В модели откройте вкладку «Параметры редактора данных модели» («Моделирование» > «Редактор данных модели»). Редактор данных модели показывает четыре строки, которые соответствуют аргументам модели. coeffArg и gainArg, который можно задать для двух блоков модели.
Используйте редактор данных модели, чтобы задать значения для аргументов модели в Model. Например, используйте значения на рисунке. Для Model1, не указывайте значение для аргументов модели. По умолчанию аргумент модели использует последнее значение, указанное ниже в иерархии модели (обозначается значением from below).
Кроме того, в командной строке можно использовать эту команду для установки значений Model:
set_param('ex_arg_code/Model','ParameterArgumentValues',... struct('coeffArg','0.98','gainArg','2.98'))
Создание кода из верхней модели.
slbuild('ex_arg_code')
### Starting serial model reference code generation build ### Successfully updated the model reference code generation target for: ex_arg_code_ref ### Starting build procedure for: ex_arg_code ### Successful completion of build procedure for: ex_arg_code Build Summary Code generation targets built: Model Action Rebuild Reason ================================================================================= ex_arg_code_ref Code generated and compiled ex_arg_code_ref.c does not exist. Top model targets built: Model Action Rebuild Reason ============================================================================================ ex_arg_code Code generated and compiled Code generation information file does not exist. 2 of 2 models built (0 models already up to date) Build duration: 0h 0m 17.745s
Файл ex_arg_code_ref.c определяет ссылочную функцию точки входа модели, ex_arg_code_ref. Функция имеет два формальных параметра, rtp_coeffArg и rtp_gainArg, которые соответствуют аргументам модели, coeffArg и gainArg. Формальные параметры используют тип данных real32_T, который соответствует типу данных single в Simulink.
file = fullfile('slprj','grt','ex_arg_code_ref','ex_arg_code_ref.c'); rtwdemodbtype(file,'/* Output and update for referenced model:',... 'real32_T rtp_gainArg)',1,1)
/* Output and update for referenced model: 'ex_arg_code_ref' */
void ex_arg_code_ref(const real32_T *rtu_In1, real32_T *rty_Out1, real32_T
rtp_coeffArg, real32_T rtp_gainArg, DW_ex_arg_code_ref_f_T *
localDW)
{
real32_T rtb_Sum;
/* Sum: '<Root>/Sum' incorporates:
* UnitDelay: '<Root>/Unit Delay'
*/
rtb_Sum = *rtu_In1 + localDW->UnitDelay_DSTATE;
/* Gain: '<Root>/Gain' */
rtb_Sum *= rtp_gainArg;
/* DiscreteFilter: '<Root>/Discrete Filter' */
localDW->DiscreteFilter_tmp = rtb_Sum - 0.5F * localDW->DiscreteFilter_states;
*rty_Out1 = rtp_coeffArg * localDW->DiscreteFilter_tmp;
/* Update for UnitDelay: '<Root>/Unit Delay' */
localDW->UnitDelay_DSTATE = rtb_Sum;
/* Update for DiscreteFilter: '<Root>/Discrete Filter' */
localDW->DiscreteFilter_states = localDW->DiscreteFilter_tmp;
}
/* Model initialize function */
void ex_arg_code_ref_initialize(const char_T **rt_errorStatus,
RT_MODEL_ex_arg_code_ref_T *const ex_arg_code_ref_M, DW_ex_arg_code_ref_f_T
*localDW)
{
/* Registration code */
/* initialize error status */
rtmSetErrorStatusPointer(ex_arg_code_ref_M, rt_errorStatus);
/* states (dwork) */
(void) memset((void *)localDW, 0,
sizeof(DW_ex_arg_code_ref_f_T));
}
Файл ex_arg_code.c содержит определение верхней функции точки входа модели, ex_arg_code. Эта функция вызывает ссылочную функцию точки входа модели, ex_arg_code_refи использует указанные значения аргументов модели (например, 1.11 и 3.34) в качестве значений rtp_coeffArg и rtp_gainArg.
file = fullfile('ex_arg_code_grt_rtw','ex_arg_code.c'); rtwdemodbtype(file,'/* ModelReference: ''<Root>/Model'' incorporates:',... '1.05F, 3.17F)',1,1)
/* ModelReference: '<Root>/Model' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out1'
*/
ex_arg_code_ref(&ex_arg_code_U.In1, &ex_arg_code_Y.Out1, 0.98F, 2.98F,
&(ex_arg_code_DW.Model_InstanceData.rtdw));
/* ModelReference: '<Root>/Model1' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out2'
*/
ex_arg_code_ref(&ex_arg_code_U.In1, &ex_arg_code_Y.Out2, 1.05F, 3.17F,
&(ex_arg_code_DW.Model1_InstanceData.rtdw));
/* Matfile logging */
rt_UpdateTXYLogVars(ex_arg_code_M->rtwLogInfo,
(&ex_arg_code_M->Timing.taskTime0));
/* signal main to stop simulation */
{ /* Sample time: [0.2s, 0.0s] */
if ((rtmGetTFinal(ex_arg_code_M)!=-1) &&
!((rtmGetTFinal(ex_arg_code_M)-ex_arg_code_M->Timing.taskTime0) >
ex_arg_code_M->Timing.taskTime0 * (DBL_EPSILON))) {
rtmSetErrorStatus(ex_arg_code_M, "Simulation finished");
}
}
/* Update absolute time for base rate */
/* The "clockTick0" counts the number of times the code of this task has
* been executed. The absolute time is the multiplication of "clockTick0"
* and "Timing.stepSize0". Size of "clockTick0" ensures timer will not
* overflow during the application lifespan selected.
* Timer of this task consists of two 32 bit unsigned integers.
* The two integers represent the low bits Timing.clockTick0 and the high bits
* Timing.clockTickH0. When the low bit overflows to 0, the high bits increment.
*/
if (!(++ex_arg_code_M->Timing.clockTick0)) {
++ex_arg_code_M->Timing.clockTickH0;
}
ex_arg_code_M->Timing.taskTime0 = ex_arg_code_M->Timing.clockTick0 *
ex_arg_code_M->Timing.stepSize0 + ex_arg_code_M->Timing.clockTickH0 *
ex_arg_code_M->Timing.stepSize0 * 4294967296.0;
}
/* Model initialize function */
void ex_arg_code_initialize(void)
{
/* Registration code */
/* initialize non-finites */
rt_InitInfAndNaN(sizeof(real_T));
/* initialize real-time model */
(void) memset((void *)ex_arg_code_M, 0,
sizeof(RT_MODEL_ex_arg_code_T));
rtmSetTFinal(ex_arg_code_M, 10.0);
ex_arg_code_M->Timing.stepSize0 = 0.2;
/* Setup for data logging */
{
static RTWLogInfo rt_DataLoggingInfo;
rt_DataLoggingInfo.loggingInterval = (NULL);
ex_arg_code_M->rtwLogInfo = &rt_DataLoggingInfo;
}
/* Setup for data logging */
{
rtliSetLogXSignalInfo(ex_arg_code_M->rtwLogInfo, (NULL));
rtliSetLogXSignalPtrs(ex_arg_code_M->rtwLogInfo, (NULL));
rtliSetLogT(ex_arg_code_M->rtwLogInfo, "tout");
rtliSetLogX(ex_arg_code_M->rtwLogInfo, "");
rtliSetLogXFinal(ex_arg_code_M->rtwLogInfo, "");
rtliSetLogVarNameModifier(ex_arg_code_M->rtwLogInfo, "rt_");
rtliSetLogFormat(ex_arg_code_M->rtwLogInfo, 0);
rtliSetLogMaxRows(ex_arg_code_M->rtwLogInfo, 0);
rtliSetLogDecimation(ex_arg_code_M->rtwLogInfo, 1);
/*
* Set pointers to the data and signal info for each output
*/
{
static void * rt_LoggedOutputSignalPtrs[] = {
&ex_arg_code_Y.Out1,
&ex_arg_code_Y.Out2
};
rtliSetLogYSignalPtrs(ex_arg_code_M->rtwLogInfo, ((LogSignalPtrsType)
rt_LoggedOutputSignalPtrs));
}
{
static int_T rt_LoggedOutputWidths[] = {
1,
1
};
static int_T rt_LoggedOutputNumDimensions[] = {
1,
1
};
static int_T rt_LoggedOutputDimensions[] = {
1,
1
};
static boolean_T rt_LoggedOutputIsVarDims[] = {
0,
0
};
static void* rt_LoggedCurrentSignalDimensions[] = {
(NULL),
(NULL)
};
static int_T rt_LoggedCurrentSignalDimensionsSize[] = {
4,
4
};
static BuiltInDTypeId rt_LoggedOutputDataTypeIds[] = {
SS_SINGLE,
SS_SINGLE
};
static int_T rt_LoggedOutputComplexSignals[] = {
0,
0
};
static RTWPreprocessingFcnPtr rt_LoggingPreprocessingFcnPtrs[] = {
(NULL),
(NULL)
};
static const char_T *rt_LoggedOutputLabels[] = {
"",
"" };
static const char_T *rt_LoggedOutputBlockNames[] = {
"ex_arg_code/Out1",
"ex_arg_code/Out2" };
static RTWLogDataTypeConvert rt_RTWLogDataTypeConvert[] = {
{ 0, SS_SINGLE, SS_SINGLE, 0, 0, 0, 1.0, 0, 0.0 },
{ 0, SS_SINGLE, SS_SINGLE, 0, 0, 0, 1.0, 0, 0.0 }
};
static RTWLogSignalInfo rt_LoggedOutputSignalInfo[] = {
{
2,
rt_LoggedOutputWidths,
rt_LoggedOutputNumDimensions,
rt_LoggedOutputDimensions,
rt_LoggedOutputIsVarDims,
rt_LoggedCurrentSignalDimensions,
rt_LoggedCurrentSignalDimensionsSize,
rt_LoggedOutputDataTypeIds,
rt_LoggedOutputComplexSignals,
(NULL),
rt_LoggingPreprocessingFcnPtrs,
{ rt_LoggedOutputLabels },
(NULL),
(NULL),
(NULL),
{ rt_LoggedOutputBlockNames },
{ (NULL) },
(NULL),
rt_RTWLogDataTypeConvert
}
};
rtliSetLogYSignalInfo(ex_arg_code_M->rtwLogInfo, rt_LoggedOutputSignalInfo);
/* set currSigDims field */
rt_LoggedCurrentSignalDimensions[0] = &rt_LoggedOutputWidths[0];
rt_LoggedCurrentSignalDimensions[1] = &rt_LoggedOutputWidths[1];
}
rtliSetLogY(ex_arg_code_M->rtwLogInfo, "yout");
}
/* states (dwork) */
(void) memset((void *)&ex_arg_code_DW, 0,
sizeof(DW_ex_arg_code_T));
/* external inputs */
ex_arg_code_U.In1 = 0.0F;
/* external outputs */
(void) memset((void *)&ex_arg_code_Y, 0,
sizeof(ExtY_ex_arg_code_T));
/* Model Initialize function for ModelReference Block: '<Root>/Model' */
ex_arg_code_ref_initialize(rtmGetErrorStatusPointer(ex_arg_code_M),
&(ex_arg_code_DW.Model_InstanceData.rtm),
&(ex_arg_code_DW.Model_InstanceData.rtdw));
/* Model Initialize function for ModelReference Block: '<Root>/Model1' */
ex_arg_code_ref_initialize(rtmGetErrorStatusPointer(ex_arg_code_M),
&(ex_arg_code_DW.Model1_InstanceData.rtm),
&(ex_arg_code_DW.Model1_InstanceData.rtdw));
/* Matfile logging */
rt_StartDataLoggingWithStartTime(ex_arg_code_M->rtwLogInfo, 0.0, rtmGetTFinal
(ex_arg_code_M), ex_arg_code_M->Timing.stepSize0, (&rtmGetErrorStatus
(ex_arg_code_M)));
/* SystemInitialize for ModelReference: '<Root>/Model' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out1'
*/
ex_arg_code_ref_Init(&(ex_arg_code_DW.Model_InstanceData.rtdw));
/* SystemInitialize for ModelReference: '<Root>/Model1' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out2'
*/
ex_arg_code_ref_Init(&(ex_arg_code_DW.Model1_InstanceData.rtdw));
}
/* Model terminate function */
void ex_arg_code_terminate(void)
{
/* (no terminate code required) */
}
Формальные параметры используют тип данных real32_T (single) потому что:
Параметры блока в ex_arg_code_ref определять свои типы данных с помощью внутренних правил. Например, в диалоговом окне «Блок усиления» на вкладке «Атрибуты параметра» для параметра «Тип данных» установлено значение Inherit: Inherit via internal rule (значение по умолчанию). В этом случае внутреннее правило выбирает тот же тип данных, что и входной и выходной сигналы. single.
Аргументы модели в рабочей области модели используют контекстно-зависимую типизацию данных, поскольку значение DataType свойство имеет значение auto (значение по умолчанию). В этом параметре аргументы модели используют тот же тип данных, что и параметры блока. single.
Формальные параметры в сгенерированном коде используют тот же тип данных, что и аргументы модели. single.
Создание настраиваемых значений аргументов
Можно настроить значения для конкретного экземпляра в блоках модели, чтобы они отображались в создаваемом коде как настраиваемые глобальные переменные. Этот метод позволяет сохранять значения параметров для каждого экземпляра в памяти и настраивать значения во время выполнения кода.
В верхней модели ex_arg_codeвыберите вкладку Параметры редактора данных модели (Model Data Editor Parameters).
Используйте редактор данных модели, чтобы задать значения аргументов модели в соответствии с этим рисунком.
set_param('ex_arg_code/Model','ParameterArgumentValues',... struct('coeffArg','coeffForInst1','gainArg','gainForInst1')) set_param('ex_arg_code/Model1','ParameterArgumentValues',... struct('coeffArg','coeffForInst2','gainArg','gainForInst2'))
Просмотр содержимого ex_arg_code_ref рабочее пространство модели в Обозревателе моделей.
Копия gainArg и coeffArg от ex_arg_code_ref в рабочее пространство модели в базовое рабочее пространство.
Переименовать gainArg как gainForInst1. Переименовать coeffArg как coeffForInst1.
gainForInst1 = getVariable(modelWorkspace,'gainArg'); gainForInst1 = copy(gainForInst1); coeffForInst1 = getVariable(modelWorkspace,'coeffArg'); coeffForInst1 = copy(coeffForInst1);
Копия gainForInst1 и coeffForInst1 как gainForInst2 и coeffForInst2.
gainForInst2 = copy(gainForInst1); coeffForInst2 = copy(coeffForInst1);
Задайте значения параметров, специфичных для экземпляра, с помощью Value свойства объектов параметров в базовой рабочей области.
gainForInst1.Value = 2.98; coeffForInst1.Value = 0.98; gainForInst2.Value = 3.34; coeffForInst2.Value = 1.11;
Для каждого нового объекта параметра на вкладке Создание кода установите StorageClass кому ExportedGlobal. Этот параметр приводит к отображению объектов параметров в созданном коде в качестве настраиваемых глобальных переменных.
gainForInst1.StorageClass = 'ExportedGlobal'; coeffForInst1.StorageClass = 'ExportedGlobal'; gainForInst2.StorageClass = 'ExportedGlobal'; coeffForInst2.StorageClass = 'ExportedGlobal';
Создание кода из верхней модели.
slbuild('ex_arg_code')
### Starting serial model reference code generation build ### Model reference code generation target for ex_arg_code_ref is up to date. ### Starting build procedure for: ex_arg_code ### Successful completion of build procedure for: ex_arg_code Build Summary Top model targets built: Model Action Rebuild Reason =========================================================================== ex_arg_code Code generated and compiled Generated code was out of date. 1 of 2 models built (1 models already up to date) Build duration: 0h 0m 9.4991s
Файл ex_arg_code.c определяет глобальные переменные, соответствующие объектам параметров в базовой рабочей области.
file = fullfile('ex_arg_code_grt_rtw','ex_arg_code.c'); rtwdemodbtype(file,'/* Exported block parameters */',... '/* Block states (default storage) */',1,0)
/* Exported block parameters */
real32_T coeffForInst1 = 0.98F; /* Variable: coeffForInst1
* Referenced by: '<Root>/Model'
*/
real32_T coeffForInst2 = 1.11F; /* Variable: coeffForInst2
* Referenced by: '<Root>/Model1'
*/
real32_T gainForInst1 = 2.98F; /* Variable: gainForInst1
* Referenced by: '<Root>/Model'
*/
real32_T gainForInst2 = 3.34F; /* Variable: gainForInst2
* Referenced by: '<Root>/Model1'
*/
В каждом вызове ex_arg_code_refалгоритм модели верхнего уровня использует глобальные переменные для установки значений формальных параметров.
rtwdemodbtype(file,'/* ModelReference: ''<Root>/Model'' incorporates:',... 'gainForInst2);',1,1)
/* ModelReference: '<Root>/Model' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out1'
*/
ex_arg_code_ref(&ex_arg_code_U.In1, &ex_arg_code_Y.Out1, coeffForInst1,
gainForInst1, &(ex_arg_code_DW.Model_InstanceData.rtdw));
/* ModelReference: '<Root>/Model1' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out2'
*/
ex_arg_code_ref(&ex_arg_code_U.In1, &ex_arg_code_Y.Out2, coeffForInst2,
gainForInst2, &(ex_arg_code_DW.Model1_InstanceData.rtdw));
/* Matfile logging */
rt_UpdateTXYLogVars(ex_arg_code_M->rtwLogInfo,
(&ex_arg_code_M->Timing.taskTime0));
/* signal main to stop simulation */
{ /* Sample time: [0.2s, 0.0s] */
if ((rtmGetTFinal(ex_arg_code_M)!=-1) &&
!((rtmGetTFinal(ex_arg_code_M)-ex_arg_code_M->Timing.taskTime0) >
ex_arg_code_M->Timing.taskTime0 * (DBL_EPSILON))) {
rtmSetErrorStatus(ex_arg_code_M, "Simulation finished");
}
}
/* Update absolute time for base rate */
/* The "clockTick0" counts the number of times the code of this task has
* been executed. The absolute time is the multiplication of "clockTick0"
* and "Timing.stepSize0". Size of "clockTick0" ensures timer will not
* overflow during the application lifespan selected.
* Timer of this task consists of two 32 bit unsigned integers.
* The two integers represent the low bits Timing.clockTick0 and the high bits
* Timing.clockTickH0. When the low bit overflows to 0, the high bits increment.
*/
if (!(++ex_arg_code_M->Timing.clockTick0)) {
++ex_arg_code_M->Timing.clockTickH0;
}
ex_arg_code_M->Timing.taskTime0 = ex_arg_code_M->Timing.clockTick0 *
ex_arg_code_M->Timing.stepSize0 + ex_arg_code_M->Timing.clockTickH0 *
ex_arg_code_M->Timing.stepSize0 * 4294967296.0;
}
/* Model initialize function */
void ex_arg_code_initialize(void)
{
/* Registration code */
/* initialize non-finites */
rt_InitInfAndNaN(sizeof(real_T));
/* initialize real-time model */
(void) memset((void *)ex_arg_code_M, 0,
sizeof(RT_MODEL_ex_arg_code_T));
rtmSetTFinal(ex_arg_code_M, 10.0);
ex_arg_code_M->Timing.stepSize0 = 0.2;
/* Setup for data logging */
{
static RTWLogInfo rt_DataLoggingInfo;
rt_DataLoggingInfo.loggingInterval = (NULL);
ex_arg_code_M->rtwLogInfo = &rt_DataLoggingInfo;
}
/* Setup for data logging */
{
rtliSetLogXSignalInfo(ex_arg_code_M->rtwLogInfo, (NULL));
rtliSetLogXSignalPtrs(ex_arg_code_M->rtwLogInfo, (NULL));
rtliSetLogT(ex_arg_code_M->rtwLogInfo, "tout");
rtliSetLogX(ex_arg_code_M->rtwLogInfo, "");
rtliSetLogXFinal(ex_arg_code_M->rtwLogInfo, "");
rtliSetLogVarNameModifier(ex_arg_code_M->rtwLogInfo, "rt_");
rtliSetLogFormat(ex_arg_code_M->rtwLogInfo, 0);
rtliSetLogMaxRows(ex_arg_code_M->rtwLogInfo, 0);
rtliSetLogDecimation(ex_arg_code_M->rtwLogInfo, 1);
/*
* Set pointers to the data and signal info for each output
*/
{
static void * rt_LoggedOutputSignalPtrs[] = {
&ex_arg_code_Y.Out1,
&ex_arg_code_Y.Out2
};
rtliSetLogYSignalPtrs(ex_arg_code_M->rtwLogInfo, ((LogSignalPtrsType)
rt_LoggedOutputSignalPtrs));
}
{
static int_T rt_LoggedOutputWidths[] = {
1,
1
};
static int_T rt_LoggedOutputNumDimensions[] = {
1,
1
};
static int_T rt_LoggedOutputDimensions[] = {
1,
1
};
static boolean_T rt_LoggedOutputIsVarDims[] = {
0,
0
};
static void* rt_LoggedCurrentSignalDimensions[] = {
(NULL),
(NULL)
};
static int_T rt_LoggedCurrentSignalDimensionsSize[] = {
4,
4
};
static BuiltInDTypeId rt_LoggedOutputDataTypeIds[] = {
SS_SINGLE,
SS_SINGLE
};
static int_T rt_LoggedOutputComplexSignals[] = {
0,
0
};
static RTWPreprocessingFcnPtr rt_LoggingPreprocessingFcnPtrs[] = {
(NULL),
(NULL)
};
static const char_T *rt_LoggedOutputLabels[] = {
"",
"" };
static const char_T *rt_LoggedOutputBlockNames[] = {
"ex_arg_code/Out1",
"ex_arg_code/Out2" };
static RTWLogDataTypeConvert rt_RTWLogDataTypeConvert[] = {
{ 0, SS_SINGLE, SS_SINGLE, 0, 0, 0, 1.0, 0, 0.0 },
{ 0, SS_SINGLE, SS_SINGLE, 0, 0, 0, 1.0, 0, 0.0 }
};
static RTWLogSignalInfo rt_LoggedOutputSignalInfo[] = {
{
2,
rt_LoggedOutputWidths,
rt_LoggedOutputNumDimensions,
rt_LoggedOutputDimensions,
rt_LoggedOutputIsVarDims,
rt_LoggedCurrentSignalDimensions,
rt_LoggedCurrentSignalDimensionsSize,
rt_LoggedOutputDataTypeIds,
rt_LoggedOutputComplexSignals,
(NULL),
rt_LoggingPreprocessingFcnPtrs,
{ rt_LoggedOutputLabels },
(NULL),
(NULL),
(NULL),
{ rt_LoggedOutputBlockNames },
{ (NULL) },
(NULL),
rt_RTWLogDataTypeConvert
}
};
rtliSetLogYSignalInfo(ex_arg_code_M->rtwLogInfo, rt_LoggedOutputSignalInfo);
/* set currSigDims field */
rt_LoggedCurrentSignalDimensions[0] = &rt_LoggedOutputWidths[0];
rt_LoggedCurrentSignalDimensions[1] = &rt_LoggedOutputWidths[1];
}
rtliSetLogY(ex_arg_code_M->rtwLogInfo, "yout");
}
/* states (dwork) */
(void) memset((void *)&ex_arg_code_DW, 0,
sizeof(DW_ex_arg_code_T));
/* external inputs */
ex_arg_code_U.In1 = 0.0F;
/* external outputs */
(void) memset((void *)&ex_arg_code_Y, 0,
sizeof(ExtY_ex_arg_code_T));
/* Model Initialize function for ModelReference Block: '<Root>/Model' */
ex_arg_code_ref_initialize(rtmGetErrorStatusPointer(ex_arg_code_M),
&(ex_arg_code_DW.Model_InstanceData.rtm),
&(ex_arg_code_DW.Model_InstanceData.rtdw));
/* Model Initialize function for ModelReference Block: '<Root>/Model1' */
ex_arg_code_ref_initialize(rtmGetErrorStatusPointer(ex_arg_code_M),
&(ex_arg_code_DW.Model1_InstanceData.rtm),
&(ex_arg_code_DW.Model1_InstanceData.rtdw));
/* Matfile logging */
rt_StartDataLoggingWithStartTime(ex_arg_code_M->rtwLogInfo, 0.0, rtmGetTFinal
(ex_arg_code_M), ex_arg_code_M->Timing.stepSize0, (&rtmGetErrorStatus
(ex_arg_code_M)));
/* SystemInitialize for ModelReference: '<Root>/Model' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out1'
*/
ex_arg_code_ref_Init(&(ex_arg_code_DW.Model_InstanceData.rtdw));
/* SystemInitialize for ModelReference: '<Root>/Model1' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out2'
*/
ex_arg_code_ref_Init(&(ex_arg_code_DW.Model1_InstanceData.rtdw));
}
/* Model terminate function */
void ex_arg_code_terminate(void)
{
/* (no terminate code required) */
}
Глобальные переменные в созданном коде используют тип данных real32_T (single) потому что:
Объекты параметров в базовой рабочей области используют контекстно-зависимую типизацию данных, поскольку DataType свойство имеет значение auto (значение по умолчанию). В этом параметре объекты параметров в базовой рабочей области используют тот же тип данных, что и аргументы модели. single.
Глобальные переменные в созданном коде используют тот же тип данных, что и объекты параметров в базовой рабочей области.
Группировать аргументы нескольких моделей в единую структуру
Копирование в Обозревателе моделей gainArg и coeffArg от ex_arg_code_ref в базовое рабочее пространство модели.
temp = getVariable(modelWorkspace,'gainArg'); gainArg = copy(temp); temp = getVariable(modelWorkspace,'coeffArg'); coeffArg = copy(temp);
В командной строке объедините эти два объекта параметров в структуру. structArg.
structArg = Simulink.Parameter(struct('gain',gainArg.Value,... 'coeff',coeffArg.Value));
Перемещение с помощью Проводника моделей structArg в рабочее пространство модели.
assignin(modelWorkspace,'structArg',copy(structArg)); clear structArg gainArg coeffArg
На панели «Содержимое» настройте structArg как единственный аргумент модели.
set_param('ex_arg_code_ref','ParameterArgumentNames','structArg')
В ex_arg_code_ref выберите вкладку Параметры редактора данных модели (Model Data Editor Parameters).
Используйте Редактор данных модели (Model Data Editor), чтобы задать значение параметра «Усиление» (Gain) равным structArg.gain и значение параметра Numerator для structArg.coeff. Сохраните модель.
set_param('ex_arg_code_ref/Gain','Gain','structArg.gain') set_param('ex_arg_code_ref/Discrete Filter',... 'Numerator','structArg.coeff') save_system('ex_arg_code_ref')
В командной строке объедините четыре объекта параметров в базовом рабочем пространстве в две структуры. В каждой структуре хранятся значения параметров для одного экземпляра ex_arg_code_ref.
structForInst1 = Simulink.Parameter(struct('gain',gainForInst1.Value,... 'coeff',coeffForInst1.Value)); structForInst2 = Simulink.Parameter(struct('gain',gainForInst2.Value,... 'coeff',coeffForInst2.Value));
В верхнем ex_arg_code модели используйте редактор данных модели, чтобы задать значения аргументов в соответствии с этим рисунком.
set_param('ex_arg_code/Model','ParameterArgumentValues',... struct('structArg','structForInst1')) set_param('ex_arg_code/Model1','ParameterArgumentValues',... struct('structArg','structForInst2'))
Нажмите кнопку Показать/обновить дополнительную информацию.
Для новых объектов параметров structForInst1 и structForInst2, используйте обозреватель моделей для применения класса хранения ExportedGlobal.
structForInst1.StorageClass = 'ExportedGlobal'; structForInst2.StorageClass = 'ExportedGlobal';
В командной строке используйте функцию Simulink.Bus.createObject для создания Simulink.Bus объект. Иерархия элементов в объекте соответствует иерархии полей структуры. Имя объекта по умолчанию: slBus1.
Simulink.Bus.createObject(structForInst1.Value);
Переименование объекта шины в myParamStructType путем копирования.
myParamStructType = copy(slBus1);
В редакторе данных модели для ex_arg_code, используйте столбец «Тип данных» для установки типа данных structForInst1 и structForInst2 кому Bus: myParamStructType.
structForInst1.DataType = 'Bus: myParamStructType'; structForInst2.DataType = 'Bus: myParamStructType';
temp = getVariable(modelWorkspace,'structArg'); temp = copy(temp); temp.DataType = 'Bus: myParamStructType'; assignin(modelWorkspace,'structArg',copy(temp));
Сохранить ex_arg_code_ref модель.
save_system('ex_arg_code_ref')
При использовании структур для группирования значений параметров нельзя использовать контекстно-зависимую типизацию данных для управления типами данных полей структур (например, полей structForInst1). Однако для управления типами данных полей можно использовать свойства объекта шины.
По команде promt установите тип данных элементов в объекте шины в значение single. соответствующие поля в структурах (например, structForInst1 и structArg) использовать один и тот же тип данных.
myParamStructType.Elements(1).DataType = 'single'; myParamStructType.Elements(2).DataType = 'single';
Создание кода из верхней модели, ex_arg_code.
slbuild('ex_arg_code')
### Starting serial model reference code generation build ### Successfully updated the model reference code generation target for: ex_arg_code_ref ### Starting build procedure for: ex_arg_code ### Successful completion of build procedure for: ex_arg_code Build Summary Code generation targets built: Model Action Rebuild Reason ============================================================================================= ex_arg_code_ref Code generated and compiled Model or library ex_arg_code_ref has changed. Top model targets built: Model Action Rebuild Reason =========================================================================== ex_arg_code Code generated and compiled Referenced models were updated. 2 of 2 models built (0 models already up to date) Build duration: 0h 0m 13.053s
Файл ex_arg_code_types.h определяет тип структуры myParamStructType, что соответствует Simulink.Bus объект.
file = fullfile('ex_arg_code_grt_rtw','ex_arg_code_types.h'); rtwdemodbtype(file,'typedef struct {','} myParamStructType;',1,1)
typedef struct {
real32_T gain;
real32_T coeff;
} myParamStructType;
В файле ex_arg_code_ref.c, ссылочная функция точки входа модели имеет формальный параметр, rtp_structArg, которые соответствуют аргументу модели structArg.
file = fullfile('slprj','grt','ex_arg_code_ref','ex_arg_code_ref.c'); rtwdemodbtype(file,'/* Output and update for referenced model:',... '*rtp_structArg)',1,1)
/* Output and update for referenced model: 'ex_arg_code_ref' */
void ex_arg_code_ref(const real32_T *rtu_In1, real32_T *rty_Out1, const
myParamStructType *rtp_structArg, DW_ex_arg_code_ref_f_T
*localDW)
{
real32_T rtb_Sum;
/* Sum: '<Root>/Sum' incorporates:
* UnitDelay: '<Root>/Unit Delay'
*/
rtb_Sum = *rtu_In1 + localDW->UnitDelay_DSTATE;
/* Gain: '<Root>/Gain' */
rtb_Sum *= rtp_structArg->gain;
/* DiscreteFilter: '<Root>/Discrete Filter' */
localDW->DiscreteFilter_tmp = rtb_Sum - 0.5F * localDW->DiscreteFilter_states;
*rty_Out1 = rtp_structArg->coeff * localDW->DiscreteFilter_tmp;
/* Update for UnitDelay: '<Root>/Unit Delay' */
localDW->UnitDelay_DSTATE = rtb_Sum;
/* Update for DiscreteFilter: '<Root>/Discrete Filter' */
localDW->DiscreteFilter_states = localDW->DiscreteFilter_tmp;
}
/* Model initialize function */
void ex_arg_code_ref_initialize(const char_T **rt_errorStatus,
RT_MODEL_ex_arg_code_ref_T *const ex_arg_code_ref_M, DW_ex_arg_code_ref_f_T
*localDW)
{
/* Registration code */
/* initialize error status */
rtmSetErrorStatusPointer(ex_arg_code_ref_M, rt_errorStatus);
/* states (dwork) */
(void) memset((void *)localDW, 0,
sizeof(DW_ex_arg_code_ref_f_T));
}
Файл ex_arg_code.c определяет переменные глобальной структуры, которые соответствуют объектам параметров в базовой рабочей области.
file = fullfile('ex_arg_code_grt_rtw','ex_arg_code.c'); rtwdemodbtype(file,'/* Exported block parameters */',... '/* Block states (default storage) */',1,0)
/* Exported block parameters */
myParamStructType structForInst1 = {
2.98F,
0.98F
} ; /* Variable: structForInst1
* Referenced by: '<Root>/Model'
*/
myParamStructType structForInst2 = {
3.34F,
1.11F
} ; /* Variable: structForInst2
* Referenced by: '<Root>/Model1'
*/
Алгоритм модели верхнего уровня в файле ex_arg_code.c передает адреса структурных переменных ссылочной функции точки входа модели.
file = fullfile('ex_arg_code_grt_rtw','ex_arg_code.c'); rtwdemodbtype(file,'/* ModelReference: ''<Root>/Model'' incorporates:',... '&structForInst2);',1,1)
/* ModelReference: '<Root>/Model' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out1'
*/
ex_arg_code_ref(&ex_arg_code_U.In1, &ex_arg_code_Y.Out1, &structForInst1,
&(ex_arg_code_DW.Model_InstanceData.rtdw));
/* ModelReference: '<Root>/Model1' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out2'
*/
ex_arg_code_ref(&ex_arg_code_U.In1, &ex_arg_code_Y.Out2, &structForInst2,
&(ex_arg_code_DW.Model1_InstanceData.rtdw));
/* Matfile logging */
rt_UpdateTXYLogVars(ex_arg_code_M->rtwLogInfo,
(&ex_arg_code_M->Timing.taskTime0));
/* signal main to stop simulation */
{ /* Sample time: [0.2s, 0.0s] */
if ((rtmGetTFinal(ex_arg_code_M)!=-1) &&
!((rtmGetTFinal(ex_arg_code_M)-ex_arg_code_M->Timing.taskTime0) >
ex_arg_code_M->Timing.taskTime0 * (DBL_EPSILON))) {
rtmSetErrorStatus(ex_arg_code_M, "Simulation finished");
}
}
/* Update absolute time for base rate */
/* The "clockTick0" counts the number of times the code of this task has
* been executed. The absolute time is the multiplication of "clockTick0"
* and "Timing.stepSize0". Size of "clockTick0" ensures timer will not
* overflow during the application lifespan selected.
* Timer of this task consists of two 32 bit unsigned integers.
* The two integers represent the low bits Timing.clockTick0 and the high bits
* Timing.clockTickH0. When the low bit overflows to 0, the high bits increment.
*/
if (!(++ex_arg_code_M->Timing.clockTick0)) {
++ex_arg_code_M->Timing.clockTickH0;
}
ex_arg_code_M->Timing.taskTime0 = ex_arg_code_M->Timing.clockTick0 *
ex_arg_code_M->Timing.stepSize0 + ex_arg_code_M->Timing.clockTickH0 *
ex_arg_code_M->Timing.stepSize0 * 4294967296.0;
}
/* Model initialize function */
void ex_arg_code_initialize(void)
{
/* Registration code */
/* initialize non-finites */
rt_InitInfAndNaN(sizeof(real_T));
/* initialize real-time model */
(void) memset((void *)ex_arg_code_M, 0,
sizeof(RT_MODEL_ex_arg_code_T));
rtmSetTFinal(ex_arg_code_M, 10.0);
ex_arg_code_M->Timing.stepSize0 = 0.2;
/* Setup for data logging */
{
static RTWLogInfo rt_DataLoggingInfo;
rt_DataLoggingInfo.loggingInterval = (NULL);
ex_arg_code_M->rtwLogInfo = &rt_DataLoggingInfo;
}
/* Setup for data logging */
{
rtliSetLogXSignalInfo(ex_arg_code_M->rtwLogInfo, (NULL));
rtliSetLogXSignalPtrs(ex_arg_code_M->rtwLogInfo, (NULL));
rtliSetLogT(ex_arg_code_M->rtwLogInfo, "tout");
rtliSetLogX(ex_arg_code_M->rtwLogInfo, "");
rtliSetLogXFinal(ex_arg_code_M->rtwLogInfo, "");
rtliSetLogVarNameModifier(ex_arg_code_M->rtwLogInfo, "rt_");
rtliSetLogFormat(ex_arg_code_M->rtwLogInfo, 0);
rtliSetLogMaxRows(ex_arg_code_M->rtwLogInfo, 0);
rtliSetLogDecimation(ex_arg_code_M->rtwLogInfo, 1);
/*
* Set pointers to the data and signal info for each output
*/
{
static void * rt_LoggedOutputSignalPtrs[] = {
&ex_arg_code_Y.Out1,
&ex_arg_code_Y.Out2
};
rtliSetLogYSignalPtrs(ex_arg_code_M->rtwLogInfo, ((LogSignalPtrsType)
rt_LoggedOutputSignalPtrs));
}
{
static int_T rt_LoggedOutputWidths[] = {
1,
1
};
static int_T rt_LoggedOutputNumDimensions[] = {
1,
1
};
static int_T rt_LoggedOutputDimensions[] = {
1,
1
};
static boolean_T rt_LoggedOutputIsVarDims[] = {
0,
0
};
static void* rt_LoggedCurrentSignalDimensions[] = {
(NULL),
(NULL)
};
static int_T rt_LoggedCurrentSignalDimensionsSize[] = {
4,
4
};
static BuiltInDTypeId rt_LoggedOutputDataTypeIds[] = {
SS_SINGLE,
SS_SINGLE
};
static int_T rt_LoggedOutputComplexSignals[] = {
0,
0
};
static RTWPreprocessingFcnPtr rt_LoggingPreprocessingFcnPtrs[] = {
(NULL),
(NULL)
};
static const char_T *rt_LoggedOutputLabels[] = {
"",
"" };
static const char_T *rt_LoggedOutputBlockNames[] = {
"ex_arg_code/Out1",
"ex_arg_code/Out2" };
static RTWLogDataTypeConvert rt_RTWLogDataTypeConvert[] = {
{ 0, SS_SINGLE, SS_SINGLE, 0, 0, 0, 1.0, 0, 0.0 },
{ 0, SS_SINGLE, SS_SINGLE, 0, 0, 0, 1.0, 0, 0.0 }
};
static RTWLogSignalInfo rt_LoggedOutputSignalInfo[] = {
{
2,
rt_LoggedOutputWidths,
rt_LoggedOutputNumDimensions,
rt_LoggedOutputDimensions,
rt_LoggedOutputIsVarDims,
rt_LoggedCurrentSignalDimensions,
rt_LoggedCurrentSignalDimensionsSize,
rt_LoggedOutputDataTypeIds,
rt_LoggedOutputComplexSignals,
(NULL),
rt_LoggingPreprocessingFcnPtrs,
{ rt_LoggedOutputLabels },
(NULL),
(NULL),
(NULL),
{ rt_LoggedOutputBlockNames },
{ (NULL) },
(NULL),
rt_RTWLogDataTypeConvert
}
};
rtliSetLogYSignalInfo(ex_arg_code_M->rtwLogInfo, rt_LoggedOutputSignalInfo);
/* set currSigDims field */
rt_LoggedCurrentSignalDimensions[0] = &rt_LoggedOutputWidths[0];
rt_LoggedCurrentSignalDimensions[1] = &rt_LoggedOutputWidths[1];
}
rtliSetLogY(ex_arg_code_M->rtwLogInfo, "yout");
}
/* states (dwork) */
(void) memset((void *)&ex_arg_code_DW, 0,
sizeof(DW_ex_arg_code_T));
/* external inputs */
ex_arg_code_U.In1 = 0.0F;
/* external outputs */
(void) memset((void *)&ex_arg_code_Y, 0,
sizeof(ExtY_ex_arg_code_T));
/* Model Initialize function for ModelReference Block: '<Root>/Model' */
ex_arg_code_ref_initialize(rtmGetErrorStatusPointer(ex_arg_code_M),
&(ex_arg_code_DW.Model_InstanceData.rtm),
&(ex_arg_code_DW.Model_InstanceData.rtdw));
/* Model Initialize function for ModelReference Block: '<Root>/Model1' */
ex_arg_code_ref_initialize(rtmGetErrorStatusPointer(ex_arg_code_M),
&(ex_arg_code_DW.Model1_InstanceData.rtm),
&(ex_arg_code_DW.Model1_InstanceData.rtdw));
/* Matfile logging */
rt_StartDataLoggingWithStartTime(ex_arg_code_M->rtwLogInfo, 0.0, rtmGetTFinal
(ex_arg_code_M), ex_arg_code_M->Timing.stepSize0, (&rtmGetErrorStatus
(ex_arg_code_M)));
/* SystemInitialize for ModelReference: '<Root>/Model' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out1'
*/
ex_arg_code_ref_Init(&(ex_arg_code_DW.Model_InstanceData.rtdw));
/* SystemInitialize for ModelReference: '<Root>/Model1' incorporates:
* Inport: '<Root>/In1'
* Outport: '<Root>/Out2'
*/
ex_arg_code_ref_Init(&(ex_arg_code_DW.Model1_InstanceData.rtdw));
}
/* Model terminate function */
void ex_arg_code_terminate(void)
{
/* (no terminate code required) */
}
При использовании аргументов модели можно применить тип данных к:
Параметры блока, использующие аргументы (для определенных блоков, например, в библиотеке дискретных блоков).
Аргументы в рабочей области ссылочной модели.
Значения аргументов, указанные в блоках модели.
Чтобы создать эффективный код за счет исключения ненужных типов и сдвигов C, рассмотрите возможность использования наследуемых и контекстно-зависимых типов данных для соответствия типам данных.
В рабочей области модели используйте переменную MATLAB ® с типом данных double или объект параметра, DataType свойство имеет значение auto. В этом случае переменная или объект использует тот же тип данных, что и параметр блока.
При задании значений аргументов в блоках модели используйте контекстно-зависимую типизацию данных. Чтобы задать значение аргумента, используйте нетипизированное значение.
Буквенное число, например 15.23. Не использовать типизированное выражение, например single(15.23).
Переменная MATLAB с типом данных double.
A Simulink.Parameter объект, чей DataType свойство имеет значение auto.
В этих случаях число, переменная или объект используют тот же тип данных, что и аргумент модели в рабочей области ссылочной модели. При настройке аргумента модели на использование контекстно-зависимой типизации данных можно управлять типами данных параметра блока, аргумента и значения аргумента, указывая тип только для параметра блока.
Основные сведения об управлении типами данных параметров см. в разделе Типы данных параметров в сгенерированном коде.
Если аргумент модели используется для установки нескольких значений параметров блока, а типы данных параметров блока различаются, использование контекстно-зависимого ввода данных невозможно (double или auto) для аргумента в рабочей области модели. Необходимо явно указать тип данных для аргумента. Например, если аргумент в рабочей области модели является объектом параметра (например, Simulink.Parameter), установите DataType свойство для значения, отличного от auto. Дополнительные сведения об этой ситуации см. в разделе Повторное использование данных параметров в контекстах различных типов данных.
В этом случае можно продолжать использовать контекстно-зависимую типизацию данных для управления типом данных значений аргументов, указанных в блоках модели. Каждое значение аргумента использует тип данных, указанный для соответствующего аргумента в рабочей области модели.