选择C API与配置参数对话框

从命令行中选择C API

来自MATLAB^®命令行，可以使用set_param函数选择或清除C API模型配置参数。在MATLAB命令行中，输入以下一个或多个命令，其中modelname是模型的名称。

选择为:信号生成C API,输入:

set_param(“modelname”、“RTWCAPISignals”,“上”)

清除为:信号生成C API,输入:

set_param(“modelname”、“RTWCAPISignals”、“了”)

选择为:parameters生成C API,输入:

set_param(“modelname”、“RTWCAPIParams”,“上”)

清除为:parameters生成C API,输入:

set_param(“modelname”、“RTWCAPIParams”、“了”)

选择为:states生成C API,输入:

set_param(“modelname”、“RTWCAPIStates”,“上”)

清除为:states生成C API,输入:

set_param(“modelname”、“RTWCAPIStates”、“了”)

选择生成C API用于:根级I/O,输入:

set_param(“modelname”、“RTWCAPIRootIO”,“上”)

清除生成C API用于:根级I/O,输入:

set_param(“modelname”、“RTWCAPIRootIO”、“了”)

关于C API文件

的模型_capi.c(或. cpp)文件为外部应用程序提供一致的接口来建模数据。根据您的配置设置，数据可以是信号、状态、根级输入或输出或参数。在本文档中，术语数据项指信号、状态、根级输入或输出或参数。C API使用提供数据项属性接口的结构。接口将每个数据项的属性打包到数据结构中。如果模型包含多个数据项，接口将生成一个数据结构数组。数据结构的成员映射到数据属性。

要与数据项交互，应用程序需要为每个数据项提供以下属性:

如下图所示，例如，数据项A的属性位于数据结构DS_A中。数据项B的属性位于数据结构DS_B中。

一些房地产值每个数据项都可以是唯一的，并且有一些属性值可以由多个数据项共同共享。例如，Name对于每个数据项都有唯一的值。接口将唯一的属性值直接放在数据项的结构中。数据项A的name值在DS_A中，数据项B的name值在DS_B中。

但是数据类型可以是几个数据项的值相同的属性。一些数据项共享属性的能力允许C API具有重用特性。在这种情况下，接口只在DS_A中放置一个索引值，在DS_B中放置一个索引值。这些索引指向一个不同的数据结构DS_C，该结构包含实际的数据类型值。下图更详细地展示了该方案。

图中显示了三个信号。signal1而且signal2共享相同的数据类型，双．接口没有在每个信号数据结构中指定这个数据类型值，而是在结构中只提供一个索引值0。“替身”的0项描述rtDataTypeMap数组，它被两个信号引用。此外，属性值可以在信号、状态、根级输入/输出和参数之间共享，因此状态、根级输入/输出和参数也可以引用双进入rtDataTypeMap数组中。这种信息重用减少了生成接口的内存大小。

在C API文件中生成的结构数组

与数据类型一样，接口将其他公共属性(如地址、维度、定点缩放和采样时间)映射到单独的结构中，并在结构中为数据项提供索引。有关结构定义的完整列表，请参阅该文件matlabroot/ rtw / c / src /rtw_capi.h．该文件还描述了结构中的每个成员。中生成的结构数组模型_capi.c(或. cpp文件中定义的结构类型rtw_capi.h文件。下面是生成的结构数组的简要描述模型_capi.c(或. cpp)：

生成示例C API文件

次要的C API信号，C API状态，C API的根级输入和输出,C API参数使用示例模型讨论生成的C API结构rtwdemo_capi．要从示例模型生成代码，请执行以下操作:

下一个子主题中的C API代码示例是使用C作为目标语言生成的。

该模型有三个全局块输出信号，将出现在C API生成的代码中:

该模型还有两个独立的状态，它们将出现在C API生成的代码中:

模型具有根级输入/输出，如果您选择模型配置参数，这些输入/输出将出现在C API生成的代码中生成C API用于:根级I/O：

此外，该模型有5个全局块参数，将出现在C API生成的代码中:

C API信号

的rtwCAPI_Signals结构捕获信号信息，包括信号名称、地址、块路径、输出端口号、数据类型信息、尺寸信息、定点信息和采样时间信息。

下面是rtwdemo_capi_capi.c为顶层模型提供C API信号的信息rtwdemo_capi：

/*块输出信号信息*/ static const rtwCAPI_Signals rtBlockSignals[] = {/* addrMapIndex, sysNum, blockPath， * signalName, portNumber, dataTypeIndex, dimIndex, fxpIndex, sTimeIndex */ {0,0， "rtwdemo_capi/Gain1"， "top_sig1"， 0,0,0,0}， {1,0， "rtwdemo_capi/lu2d"， "sig2_eg"， 0,0,1,0,0}， {0,0， (NULL)， (NULL)， 0,0,0,0}};

{0, 0,“rtwdemo_capi / Gain1”,“top_sig1”,0,0,0,0,0},

除最后一个元素外，每个数组元素都描述了一个块信号的输出端口。最后一个数组元素是一个哨兵，所有元素都设置为空值。例如，检查第二个信号，由以下代码描述:

{1, 0,“rtwdemo_capi / lu2d”、“sig2_eg”,0,0,1,0,0},

这个信号，命名为sig2_eg，为块的第一个端口的输出信号rtwdemo_capi / lu2d．(此端口是第一个端口，因为portNumber显示在第二行中被赋值0．）

这个信号的地址是由addrMapIndex，在本例中，第一行显示为1．类的索引rtDataAddrMap数组，在rtwdemo_capi_capi.c：

/*静态声明数据地址*/ static void* rtDataAddrMap[] = {&rtwdemo_capi_B. []] = {&rtwdemo_capi_B.]top_sig1， /* 0:信号*/ &sig2_eg[0]， /* 1:信号*/ &rtwdemo_capi_DWork。top_state，/* 2: Discrete State */ &rtP_Ki, /* 3: Model Parameter */ &rtP_Kp, /* 4: Model Parameter */ &rtP_p1[0], /* 5: Model Parameter */ &rtP_p2[0], /* 6: Model Parameter */ &rtP_p3[0], /* 7: Model Parameter */ };

的指数1对象中的第二个元素rtDataAddrMap数组中。从rtDataAddrMap数组，就可以推断出这个信号的地址是&sig2_eg [0]．

这种间接级别支持同一模型的多个代码实例。金宝app对于多个实例，除地址外，信号信息保持不变。在本例中，模型是单个实例。因此,rtDataAddrMap是静态声明的。如果您选择生成可重用的代码，则会生成一个初始化函数，用于动态地初始化每个实例的地址。有关生成可重用代码的详细信息，请参见为模型入口点函数配置生成的C函数接口看看配置代码重用支持金宝app(嵌入式编码)．

的dataTypeIndex类的索引rtDataTypeMap数组，在rtwdemo_capi_capi.c，表示信号的数据类型:

/*数据类型映射-使用dataTypeMapIndex访问这个结构*/ static const rtwCAPI_DataTypeMap rtDataTypeMap[] = {/* cName, mwName, numElements, elemMapIndex, dataSize, slDataId， * * isComplex, isPointer */ {"double"， "real_T"， 0, sizeof(real_T)， SS_DOUBLE, 0, 0}};

因为索引是0为sig2_eg，索引指向数组中的第一个结构元素。您可以推断出信号的数据类型是双．的价值isComplex是0，表示信号不复杂。类中直接提供数据类型信息rtwCAPI_Signals结构，间接介绍了一层。这种间接方式允许共享相同数据类型的多个信号指向一个映射结构，从而为每个信号节省内存。

的dimIndex(维度索引)提供到rtDimensionMap数组，在rtwdemo_capi_capi.c，表示信号的尺寸。因为这个指标是1为sig2_eg的第二个元素rtDimensionMap数组:

/* DimensionMap -使用dimensionMapIndex访问结构的元素*/ static const rtwCAPI_DimensionMap rtDimensionMap[] = {/* dataOrientation, dimArrayIndex, numDims, vardimsIndex */ {rtwCAPI_SCALAR, 0,2,0}， {rtwCAPI_VECTOR, 2,2,0}，…}；

从这个结构，你可以推断出这是一个维数为的非标量信号2．的dimArrayIndexValue, 2，提供到的索引rtDimensionArray，后来在rtwdemo_capi_capi.c：

*/ static const uint_T rtDimensionArray[] ={1， /* 0 */ 1， /* 1 */ 2， /* 2 */…}；

的fxpIndex(定点索引)提供了进入的索引rtFixPtMap数组，在rtwdemo_capi_capi.c，表示信号的定点信息。您的代码可以使用缩放信息来计算信号的实际值，使用公式V =平方+ B其中，V为“真实世界”(即以10为底)值，S为用户指定的斜率，Q为“量化定点值”或“存储整数”，B为用户指定的偏差。详细信息请参见扩展(定点设计师)．

因为这个指标是0为sig2_eg时，信号不具有定点信息。定点映射索引为零意味着信号没有定点信息。

的sTimeIndex(采样时间索引)提供对rtSampleTimeMap数组，在rtwdemo_capi_capi.c，表示该信号的任务信息。如果您记录多速率信号或有条件执行的信号，则采样信息可能是有用的。

C API状态

的rtwCAPI_States结构捕获状态信息，包括状态名称、地址、块路径、类型(连续或离散)、数据类型信息、维度信息、定点信息和采样时间信息。

下面是rtwdemo_capi_capi.c中顶层模型的C API状态信息rtwdemo_capi：

/*块状态信息*/ static const rtwCAPI_States rtBlockStates[] = {/* addrMapIndex, contStateStartIndex, blockPath， * stateName, pathAlias, dWorkIndex, dataTypeIndex, dimIndex， * fixPtIdx, sTimeIndex, isContinuous */ {2， -1， "rtwdemo_capi/Delay1"， "top_state"， "" "， 0,0,0,0}， {0， -1， (NULL)， (NULL)， (NULL)， 0,0,0,0,0}};

除最后一个元素外，每个数组元素都描述了模型中的一个状态。最后一个数组元素是一个哨兵，所有元素都设置为空值。在这个例子中，顶部模型的C API代码显示了一个状态:

{2 1、“rtwdemo_capi / Delay1”、“top_state”,“”,0,0,0,0,0,0},

这个状态，命名为top_state，为块定义rtwdemo_capi / Delay1．的价值毕竟为零，表示状态是离散的而不是连续的。其他字段对应于中描述的类似命名的信号等价物C API信号，详情如下:

C API的根级输入和输出

的rtwCAPI_Signals结构捕获根级输入/输出信息，包括输入/输出名称、地址、块路径、端口号、数据类型信息、维度信息、定点信息和采样时间信息。(此结构也用于块输出信号，如前所述C API信号．）

下面是rtwdemo_capi_capi.c为顶层模型提供C API根级输入/输出的信息rtwdemo_capi：

* / / *根输入信息静态常量rtwCAPI_Signals rtRootInputs [] = { /* addrMapIndex、sysNum blockPath、* signalName portNumber, dataTypeIndex, dimIndex, fxpIndex, sTimeIndex * /{3 0“rtwdemo_capi /三机一体”,“”,1,0,0,0,0},{4 0“rtwdemo_capi / In2”,“”,2,0,0,0,0},{5 0“rtwdemo_capi / In3”,“”,3,0,0,0,0},{6 0“rtwdemo_capi / In4”,“”,4,0,0,0,0},{0 0(零),(零),0,0,0,0,0}};* / / *根输出信息静态常量rtwCAPI_Signals rtRootOutputs [] = { /* addrMapIndex、sysNum blockPath、* signalName portNumber, dataTypeIndex, dimIndex, fxpIndex, sTimeIndex * /{7 0“rtwdemo_capi /着干活”,“”,1,0,0,0,0},{8 0“rtwdemo_capi / Out2”,“”,2,0,0,0,0},{9 0“rtwdemo_capi / Out3”,“”,3,0,0,0,0},{10 0“rtwdemo_capi / Out4”,“”,4,0,0,0,0},{11日0时,“rtwdemo_capi / Out5”、“sig2_eg”,5 0,1,0,0},{12 0“rtwdemo_capi / Out6”,“”,6 0,1,0,0}， {0,0， (null)， (null)， 0,0,0,0}};

类中的值的解释信息rtwCAPI_Signals结构，请参见前一节C API信号．

C API参数

的rtwCAPI_BlockParameters而且rtwCAPI_ModelParameters结构捕获参数信息，包括参数名称、块路径(用于块参数)、地址、数据类型信息、维度信息和定点信息。

的rtModelParameters数组包含工作区变量的条目，这些变量被引用为可调的Simulink块参数或机器范围的状态流数据。金宝app例如，可调参数包括金宝app仿真软件。参数对象的存储类汽车．的金宝app仿真软件编码器软件只分配它的元素零如果没有这样的数据，则为零值。

为模型配置参数选择的设置默认参数行为确定信息如何生成到rtBlockParameters数组中模型_capi.c(或. cpp）.

每个数组的最后一个成员是一个哨兵，所有元素都设置为空值。

这是rtBlockParameters中默认生成的rtwdemo_capi_capi.c：

/*当内联参数被* *选中时，单独的块调优无效。生成一个空映射以提供独立于内联参数的一致* *接口。* */ static const rtwCAPI_BlockParameters rtBlockParameters[] = {/* addrMapIndex, blockPath， * paramName, dataTypeIndex, dimIndex, fixPtIdx */ {0， (NULL)， (NULL)， 0,0,0}};

在本例中，只生成最后的哨兵数组元素，其中包含结构的所有成员rtwCAPI_BlockParameters设置为零零值。这是因为默认参数行为设置为内联默认情况下，rtwdemo_capi模型的例子。如果你设置默认参数行为来可调时，块参数在rtwCAPI_BlockParameters结构。但是，MATLAB中出现了变量和可调参数rtwCAPI_ModelParameters结构。

这是rtModelParameters中默认生成的rtwdemo_capi_capi.c：

/*可调变量参数*/ static const rtwCAPI_ModelParameters rtModelParameters[] = {/* addrMapIndex, varName, dataTypeIndex, dimIndex, fixPtIndex */ {2, TARGET_STRING("Ki")， 0,0,0}， {3, TARGET_STRING("Kp")， 0,0,0}， {4, TARGET_STRING("p1")， 0,2,0}， {5, TARGET_STRING("p2")， 0,3,0}， {6, TARGET_STRING("p3")， 0,4,0}， {0， (NULL)， 0,0,0}};

在本例中，rtModelParameters数组包含作为可调Simulink块参数引用的每个变量的条目。金宝app

例如，varName(变量名)的第四个参数为p2．其他字段对应于中描述的类似命名的信号等价物C API信号，详情如下:

有关生成代码中可调参数存储的更多信息，请参见生成的代码如何存储内部信号，状态和参数数据．

将C API数据结构映射到rtModel

实时模型数据结构封装了完整描述模型的模型数据和相关信息。当您选择C API特性并生成代码时，金宝app仿真软件编码器代码生成器将另一个成员添加到生成的实时模型数据结构中模型．h：

下面的子结构包含了在模型的C API中生成的结构的信息。*/ struct {rtwCAPI_ModelMappingInfo mmi;} DataMapInfo;

这个成员定义了mmi(用于模型映射信息)的类型struct rtwCAPI_ModelMappingInfo．该结构位于matlabroot/ rtw / c / src /rtw_modelmap.h．的mmi子结构定义了模型和C API文件之间的接口。更具体地说，成员mmi中的结构映射实时模型数据结构模型_capi.c(或. cpp）.

初始化的值mmi成员到数组中完成映射，如将模型映射到结构的C API数组．每个成员指向生成的C API文件中的一个结构数组。的地址rtBlockSignals对象的第一个成员mmi子结构中模型．c(或. cpp)，使用rtw_modelmap.h文件:

/* signals */ struct {rtwCAPI_Signals const *信号;/*信号数组*/ uint_T numSignals;/* Num Signals */ rtwCAPI_Signals const *rootInputs;/*根输入数组*/ uint_T numRootInputs;/*根输入*/ rtwCAPI_Signals const *rootOutputs;/*根输出数组*/ uint_T numRootOutputs;

模型初始化函数在模型．c(或. cpp)通过调用C API的initialize函数来执行初始化。例如，在示例模型的模型初始化函数中生成以下代码rtwdemo_capi：

/*初始化DataMapInfo子结构，包含ModelMap */ rtwdemo_capi_InitializeDataMapInfo(rtwdemo_capi_M)