创建代码定义,用于控制模型数据和函数的代码生成
上的模型窗口中,打开嵌入式编码器字典C代码选项卡上,选择代码接口>嵌入式编码器词典.
“嵌入式编码器字典”窗口显示存储在模型文件中的代码生成定义。如果模型链接到数据字典,该窗口还会显示存储在该数据字典中或(如果适用的话)存储在引用字典中的定义。的源列指示存储每个定义的位置。
在Simulink中打开嵌入式编码器字典金宝app®数据字典,在模型资源管理器模型层次结构面板:
在字典节点下,选择嵌入式编码器节点。
如果没有看到该节点,右键单击字典节点并选择显示空部分.
在Dialog窗格(右侧窗格)中,单击打开嵌入式编码器字典.
在模型中,创建一个存储类,它将内部模型数据(包括块状态)聚合到一个结构中,该结构的特征可以由您控制。然后,通过从模型生成代码来验证存储类。
打开示例模型rtwdemo_roll
.
rtwdemo_roll
如果模型没有在嵌入式编码器应用程序中打开,请打开应用程序并单击C代码选项卡。
在C代码选项卡上,选择代码接口>嵌入式编码器词典.“嵌入式编码器字典”窗口显示存储在模型文件中的代码生成定义。
在“嵌入式编码器字典”窗口中,单击添加.
选择出现在列表底部的新存储类,StorageClass1
.在右侧的“属性检查器”窗格中,设置本表中列出的属性值。
财产 | 价值 |
---|---|
名字 | InternalStruct |
头文件 | internalData_ R.h美元 |
定义文件 | 美元internalData_阻容 |
存储类型 | 结构化 |
结构特性>类型名称 | internalData_T_ M美元 |
结构特性>实例名 | internalData_ M美元 |
在做出更改之后,在底部窗格中,验证伪代码预览是否反映了您所期望的内容。
返回到模型编辑器。要打开“代码映射”编辑器,在画布下面,双击“代码映射”。在数据默认值选项卡,展开信号部分。选择信号、状态和内部数据行和集存储类来InternalStruct
.
在“配置参数”对话框中,在代码生成>代码的位置窗格中,设置文件包装格式来模块化
.
生成的代码。
在Simuli金宝appnk Editor Code视图中,打开并检查该文件internalData_rtwdemo_roll.h
.文件定义结构类型internalData_T_
,其字段表示模型中的块状态。
/*存储类'InternalStruct',用于系统'<根>' */ typedef struct {real32_T FixPtUnitDelay1_DSTATE;/* '/FixPt Unit Delay1' */ real32_T Integrator_DSTATE;/* ' /Integrator' */ int8_T Integrator_PrevResetState;/* ' /Integrator' */} internalData_T_;
该文件还声明了一个全局结构变量internalData_
.
/*存储类'InternalStruct' */ extern internalData_T_ internalData_;
打开并检查文件internalData_rtwdemo_roll.c
.该文件为internalData_
.
/*存储类'InternalStruct' */ internalData_T_ internalData_;
使用函数模板,您可以指定规则来管理生成的入口点函数的名称。这种技术有助于在具有许多入口点函数的模型中节省时间和维护工作,例如导出函数模型或多速率多任务模型。
此示例显示如何创建指定命名规则的函数模板func_ N_ R美元
.$ N
是每个生成的函数的基本名称和$ R
是Simulink模型的名称。金宝app
打开示例模型rtwdemo_mrmtbb
.
更新框图。这个多任务模型有两种执行速率,因此生成的代码包括两个相应的入口点函数。
在模型中,设置模型配置参数系统目标文件来ert.tlc
.要使用函数自定义模板,必须使用基于ert的系统目标文件。
在Simuli金宝appnk编辑器中,打开嵌入式编码器应用程序并打开嵌入式编码器字典。
在嵌入式编码器字典中,在功能定制模板选项卡上,单击添加.
对于新的函数模板,设置这些属性:
名字来myfunction
.
函数名来func_ N_ R美元
.
在进行更改之后,验证伪代码预览是否反映了您所期望的内容。
在模型窗口中,打开Code Mappings编辑器。在功能默认值选项卡,用于初始化和终止而且执行行,设置功能定制模板来myfunction
.
生成的代码。
在Code视图中,打开并检查文件rtwdemo_mrmtbb.c
.该文件定义了两个执行函数,func_step0_rtwdemo_mrmtbb
而且func_step1_rtwdemo_mrmtbb
,它们的名称符合您在函数模板中指定的规则。
有关显示如何创建内存部分的示例,请参见通过插入Pragmas控制数据和函数在内存中的位置.
这个例子展示了如何创建一个存储类,将全局变量定义和声明放在文件名依赖于模型名的文件中。您可以创建存储类的两个副本,这样就可以使用一个带有参数数据的副本(数据类别)模型参数)及一份附有其他资料的复本。
通常,生成的代码在任何函数之外静态初始化参数数据,并在模型初始化函数中动态初始化其他数据。使用自定义存储类设计器或嵌入式编码器字典创建存储类时,可以设置数据初始化属性指定初始化机制。
在嵌入式编码器字典中,必须为每个存储类进行选择静态
或动态
初始化。考虑为参数数据创建存储类的一个副本(静态
)及一份其他资料(动态
).
开放范例模型rtwdemo_roll
.
如果C代码选项卡未打开,打开嵌入式编码器应用程序并单击C代码选项卡。
选择代码接口>嵌入式编码器词典
在“嵌入式编码器字典”中,单击添加.
对于新的存储类,设置这些属性:
名字来SigsStates
头文件来R_my_data.h美元
定义文件来R_my_data.c美元
数据初始化来动态
在进行更改之后,验证伪代码预览是否反映了您所期望的内容。
点击重复的.一个新的存储类,SigsStates_copy
,出现了。
对于新的存储类,设置这些属性:
名字来参数个数
数据初始化来静态
在进行更改之后,验证伪代码预览是否反映了您所期望的内容。
返回到模型并打开Code Mappings编辑器。在模型画布下面,双击代码映射- C.
在数据默认值选项卡,用于参数>模型参数行,在存储类列,选择参数个数
.
为信号>信号、状态和内部数据行,设置存储类来SigsStates
.
在模型中配置一些参数数据元素,以便优化不会从生成的代码中消除这些元素。在建模选项卡上,单击设计>模型的工作空间.
在Model Explorer的中心窗格上,选择与变量相对应的三行dispGain
,intGain
,rateGain
在模型工作区中。
右键单击其中一行并单击转换为参数对象
.模型数据编辑器将工作区变量转换为金宝app仿真软件。参数
对象。
在参数所在行dispGain
,在存储类列,单击配置.的行突出显示模型窗口dispGain
参数。
中的每个变量存储类列,选择模型默认值:Params
,这意味着它们获取您指定的默认存储类模型参数.
在“配置参数”对话框中,在代码生成>代码的位置窗格中,设置文件包装格式来模块化
.
生成的代码。
在Code视图中,打开并检查文件rtwdemo_roll_my_data.c
而且rtwdemo_roll_my_data.h
.这些文件定义并声明了与参数对象和某些块状态(如积分器块BasicRollMode
子系统。
/*存储类'SigsStates' */ real32_T rtFixPtUnitDelay1_DSTATE;real32_T rtIntegrator_DSTATE;int8_T rtIntegrator_PrevResetState;/*存储类Params */ real32_T disgain = 0.75F;real32_T intGain = 0.5F;real32_T rateGain = 2.0F;
您可以配置嵌入式编码器字典以引用存储在包中的代码生成定义(请参阅为外部数据对象创建代码定义).然后,这些定义就可以在Code Mappings编辑器中进行选择。在本例中,配置嵌入式编码器字典rtwdemo_roll
以引用存储在内置示例包中的定义ECoderDemos
.
打开嵌入式编码器字典rtwdemo_roll
.有关说明,请参见创建并验证存储类.
在“嵌入式编码器字典”窗口中,单击管理包.
在“管理包”对话框中,单击刷新.中出现更多选项时,请等待选择包下拉列表。
集选择包来ECoderDemos
并点击负载.
在“嵌入式编码器字典”窗口中存储类选项卡中定义的存储类ECoderDemos
包中。现在,在rtwdemo_roll
的“代码映射”编辑器中选择这些存储类数据默认值选项卡。
若要卸载包,请在“管理包”对话框中选择选择包下拉列表,单击卸载.
有关如何使用数据字典在模型之间共享代码生成定义的示例,请参见在模型之间共享嵌入式编码器字典定义.
有关显示如何在共享的嵌入式编码器字典中配置默认代码映射的示例,请参见在共享字典中配置默认代码映射.
这些属性显示在“嵌入式编码器字典”窗口的“属性检查器”窗格中。在表中,一些属性显示为列,以便于批量编辑。
存储类名字
—存储类名称StorageClass1
(默认)|文本存储类的名称。该名称在字典中的存储类中必须唯一。
有关Simulink提供的内置和示例存储类的列表,请参见金宝app选择在生成的代码中控制数据表示的存储类.
描述
-存储类的目的和功能可用于描述存储类的目的和功能的自定义文本。
源
—存储类定义的位置此属性是只读的。
存储类定义的位置。
内置的
-由Simulink提供。金宝app
模型名称-在Simulink模型中定义。金宝app
字典名称-在Simulink数据字典中定义(请参阅金宝app什么是数据字典?).
包名——在Simulink包或自定义包中定义(请参阅金宝app使用自定义存储类设计器创建存储类).
数据访问
-访问数据的规范直接
(默认)|函数
规范以访问与模型相关的数据。直接存取资料(直接
)或可自订得到
而且集
函数(函数
).有关更多信息,请参见使用嵌入式编码器字典中的存储类通过函数访问数据.
将此属性设置为函数
:
集数据范围来进口
.
意味着不能指定多实例属性。
启用这些属性:
访问模式
允许访问
Getter名称
Setter名称
禁用保留数组尺寸财产。若要在生成的代码中保留多维数组的维度,请设置数据访问来直接
.
数据范围
-生成数据定义的规范出口
(默认)|进口
生成的代码定义数据的规范(出口
)或import (进口
)外部代码的数据定义。内置存储类和包(如Simulink)中的存储类可以使用其他作用域选项,例如金宝app文件
.
将此属性设置为进口
:
禁用定义文件.要在构建过程中包括外部源代码文件,请使用模型配置参数。有关示例,请参见配置数据接口.
意味着你不能设置头文件来新罕布什尔州美元
,不过你可以使用the$ N
令牌。
将此属性设置为出口
,您必须使用其中一个令牌$ N
或$ R
在价值上头文件.
头文件
—声明数据的头文件名称新罕布什尔州美元
(默认)|文本声明数据的头文件的名称,指定为名称或命名规则。命名规则包括文本和标记的组合。该表中列出了有效的令牌。
令牌 | 描述 |
---|---|
$ R |
根模型名称 |
$ N |
关联数据元素的名称 |
G美元 |
存储类名称 |
你美元 |
中为模型指定的用户令牌文本标识符格式控制 |
如果你设置数据范围来出口
,您必须使用其中一个令牌$ R
或$ N
这个属性的值。
如果你设置数据范围来进口
,则不能将此属性的值设置为新罕布什尔州美元
,但你可以使用$ N
令牌。
访问模式
-通过函数访问数据的规范价值
(默认)|指针
允许访问
-允许通过函数访问数据的规范读/写
(默认)|只读
|只写
允许读写的存储类的规范(读/写
),只读(只读
),或只写(只写
)查阅资料。
此属性仅在设置时启用数据访问来函数
.
Getter名称
-项目名称得到
获取相关数据的函数get_ N M美元
(默认)|文本项目名称得到
函数,用于获取作为名称或命名规则指定的相关数据。命名规则包括文本和标记的组合。该表中列出了有效的令牌。
令牌 | 描述 |
---|---|
$ N |
关联数据元素的名称(必需) |
$ R |
根模型名称 |
M美元 |
破坏文本,确保唯一性 |
你美元 |
用户令牌文本。看到标识符格式控制. |
此属性仅在设置时启用数据访问来函数
.
Setter名称
-项目名称集
函数,用于修改相关数据set_ N M美元
(默认)|文本项目名称集
函数,用于获取作为名称或命名规则指定的修改数据。命名规则包括文本和标记的组合。该表中列出了有效的令牌。
令牌 | 描述 |
---|---|
$ N |
关联数据元素的名称(必需) |
$ R |
根模型名称 |
M美元 |
破坏文本,确保唯一性 |
你美元 |
用户令牌文本。看到标识符格式控制. |
此属性仅在设置时启用数据访问来函数
.
对单实例和多实例数据使用不同的属性设置
-分配单独存储设置的规格从
(默认)|在
类中指定的存储设置单实例存储属性中指定的存储设置多实例存储部分。当您将存储类应用于数据项时,Embedded Coder Dictionary将根据数据类型和模型引用层次结构中的模型上下文来确定它是单实例存储类还是多实例存储类。
选择此属性将启用部分单实例存储而且多实例存储.的属性存储类型,类型名称,实例名出现在单实例存储而且多实例存储部分。
存储类型
-将数据聚合到结构中的规范非结构化
(默认)|结构化
规范将使用存储类的数据聚合到生成代码中的结构中。每个数据元素都作为结构的字段出现在代码中。要创建结构,请使用结构化
.
将此属性设置为结构化
使类型名称而且实例名.
类型名称
—结构类型名称R N G M美元美元
(默认)|文本生成代码中结构类型的名称,指定为名称或命名规则。命名规则包括文本和标记的组合。该表中列出了有效的令牌。
令牌 | 描述 |
---|---|
$ R |
根模型名称 |
$ N |
关联函数的基名称,例如一步 |
G美元 |
存储类名称 |
你美元 |
中为模型指定的用户令牌文本标识符格式控制 |
M美元 |
如有必要,插入打乱名称的文本,以避免名称冲突 |
设置存储类型来结构化
启用此属性。
实例名
—结构变量名称N G美元美元
(默认)|文本生成代码中结构变量的名称,指定为名称或命名规则。命名规则包括文本和标记的组合。该表中列出了有效的令牌。
令牌 | 描述 |
---|---|
$ R |
根模型名称 |
$ N |
关联函数的基名称,例如一步 |
G美元 |
存储类名称 |
你美元 |
中为模型指定的用户令牌文本标识符格式控制 |
M美元 |
如有必要,插入打乱名称的文本,以避免名称冲突 |
设置存储类型来结构化
启用此属性。
数据初始化
—如何初始化数据汽车
(默认)|动态
|静态
|没有一个
指定生成的代码初始化数据。
汽车
—生成的代码静态初始化参数数据,动态初始化信号和状态数据。
动态
生成的代码初始化数据作为模型初始化入口点函数的一部分。
静态
—生成的代码在为数据定义和分配内存的语句中初始化数据。赋值语句出现在.c
或. cpp
源文件,在函数之外。
没有一个
—生成的代码不初始化数据。
如果您选择常量,则不能将此属性设置为动态
.
将此属性设置为动态
禁用常量.
记忆的部分
-在内存中分配数据的位置没有一个
(默认)|现有内存段内存中用于分配数据的位置,指定为存在于嵌入式编码器字典中的内存段记忆的部分选项卡。有关内存部分的信息,请参见通过插入Pragmas控制数据和函数在内存中的位置.
保留数组尺寸
-多维数组维数保存规范从
(默认)|在
存储类的规范,用于在生成的代码中保存多维数组的维度。有关更多信息,请参见在生成的代码中保留多维数组的维度.
常量
-适用规格常量
限定符从
(默认)|在
应用于常量
数据的限定符。
如果选择此属性,则无法设置数据初始化来动态
.
设置数据初始化来动态
禁用此属性。
挥发性
-适用规格挥发性
限定符从
(默认)|在
应用于挥发性
数据的限定符。
其他限定符
-应用自定义限定符的规范规范,以便对数据应用自定义限定符。例如,一些内存架构支持限定符金宝app远
而且巨大的
.
不要使用此属性应用关键字静态
.相反,使用内置存储类FileScope
,您不能使用代码映射编辑器应用它。看到选择在生成的代码中控制数据表示的存储类.
参数
—是否允许与模型参数一起使用从
(默认)|在
指示是否允许使用带有模型参数的存储类的规范。
设置数据初始化来静态
启用此属性。
设置数据初始化来动态
禁用此属性。
若要设置此属性的值,请设置数据初始化来没有一个
.
信号
-是否允许与模型信号一起使用在
(默认)|从
指示是否允许将存储类与模型信号一起使用的规范。
设置数据初始化来动态
启用此属性。
设置数据初始化来静态
禁用此属性。
若要设置此属性的值,请设置数据初始化来没有一个
.
名字
—函数模板名称FunctionTemplate1
(默认)|文本模板名称。该名称在字典中的函数模板中必须唯一。Embedded Coder提供了本表中列出的内置模板。
模板 | 描述 |
---|---|
ModelFunction |
在代码映射编辑器中,使用用于初始化、执行、终止和重置的入口点函数(请参阅配置函数的默认代码生成) |
UtilityFunction |
在代码映射编辑器中,用于共享实用程序函数(请参阅配置函数的默认代码生成) |
描述
-功能模板的目的和功能可用于描述函数模板的目的和功能的自定义文本。
源
-函数模板定义位置函数名
—生成的函数名称R N美元
(默认)|文本生成代码中的函数名称,作为命名规则指定。命名规则包括文本和标记的组合。该表中列出了有效的令牌。
令牌 | 描述 |
---|---|
$ R |
根模型名称 |
$ N |
关联函数的基名称,例如一步 |
你美元 |
中为模型指定的用户令牌文本标识符格式控制 |
$ C |
对于共享实用程序函数,插入校验和以避免名称冲突 |
M美元 |
如有必要,插入打乱名称的文本,以避免名称冲突 |
记忆的部分
-在内存中分配功能的位置没有一个
(默认)|现有内存段内存中用于分配函数的位置,指定为存在于嵌入式编码器字典中的内存段记忆的部分选项卡。有关内存部分的信息,请参见通过插入Pragmas控制数据和函数在内存中的位置.
名字
—内存段名称内存段的名称。该名称在字典中的内存区中必须是唯一的。Embedded Coder提供了表中列出的内置内存部分。
记忆的部分 | 描述 |
---|---|
MemConst |
应用存储类型限定符常量 对数据。 |
MemVolatile |
应用存储类型限定符挥发性 对数据。 |
MemConstVolatile |
应用存储类型限定符常量 而且挥发性 对数据。 |
描述
-内存部分的目的和功能可用于描述内存部分的目的和功能的自定义文本。
源
-内存段定义的位置此属性是只读的。
内存段定义的位置。
模型名称-在Simulink模型中定义。金宝app
字典名称-在Simulink数据字典中定义(请参阅金宝app什么是数据字典?).
包名——在Simulink包或自定义包中定义(请参阅金宝app为外部数据对象创建代码定义).
评论
-在生成的代码中插入的注释代码生成器包含在指令或您指定的其他修饰中的代码注释之前的声明而且发布声明.
之前的声明
—在数据或功能代码之前插入的代码在内存部分中数据或函数的定义和声明之前插入的代码,如pragmas。
您可以使用令牌$ R
来表示使用内存部分的模型的名称。
当你设置语句包围来每个变量
,您可以使用令牌$ N
表示使用内存段的每个变量或函数的名称。
发布声明
-在数据或功能代码之后插入的代码在内存部分中数据或函数的定义和声明之后插入的代码,如pragmas。
您可以使用令牌$ R
来表示使用内存部分的模型的名称。
当你设置语句包围来每个变量
,您可以使用令牌$ N
表示使用内存段的每个变量或函数的名称。
语句包围
-单独或分组包装数据和功能的规范每个变量
(默认)|变量组
插入代码语句的规范(之前的声明而且发布声明):
围绕使用内存段的每个变量和函数。选择每个变量
.
一次,绕着整个内存区。生成的代码将变量和函数定义聚合到一个连续的代码块中,并用语句包围该代码块。选择变量组
.
在嵌入式编码器字典中创建的存储类或函数自定义模板不能使用从包中加载的内存段(如中所述)参考包中的代码生成定义).使用嵌入式编码器字典中定义的内存段。
类型中不能创建代码生成定义. mdl
模型文件。
有关数据字典的嵌入式编码器字典中代码生成定义的其他限制(.sldd
文件),请参阅部署代码生成定义.