指定源代码和依赖关系

指定包含您的 C 函数的外部源代码文件。

N 维数组处理

Simulink 可以将 N 维数组数据传递给 C Caller 模块中的自定义代码函数，并从这些模块中接收数据。当您这样做时，必须指定正确的数组布局才能获得预期的结果。请参阅默认函数数组布局和例外(按函数)。有关将数组数据用于 C Caller 模块的示例，请参阅Use Custom Image Filter Algorithms as Reusable Blocks in Simulink和Call Legacy Lookup Table Function Using C Caller Block。

您可以指定矩阵数据在 C 函数中的处理顺序。如果需要，传递给 C 函数和从 C 函数传递的矩阵数据会转换为指定的数组布局。如果未指定数组布局，矩阵数据将按照与 Simulink 数据相同的顺序通过 C 函数，并且由于行-列优先混乱，可能会出现计算错误。确保对所有 Simulink 数据使用相同的默认函数数组布局。

要了解有关 Simulink 中行优先和列优先数组布局的更多信息，请参阅Default function array layout。

如果您的 C 函数只接受标量和/或向量输入，则默认函数数组布局设置不起作用。

调用 C Caller 模块并指定端口

您可以在 Simulink 画布中键入 C Caller，以开始在 Simulink 中集成您的自定义 C 代码。或者，将 User-Defined Functions 库中的一个 C Caller 模块拖到画布上。双击该模块打开模块参数对话框，查看您的函数名称和端口设定。

将 C 函数参量映射到 Simulink 端口

您可以使用 C Caller 模块中的端口设定表，或通过命令行创建 FunctionPortSpecification 对象，将源代码中的 C 函数参量映射到 Simulink 端口。在源代码中，头文件包含要连接到 Simulink 端口的 C 函数参量。

extern void mean_filter(const unsigned char* src,
                           unsigned char* dst,
                           unsigned int width, unsigned int height,
                           unsigned int filterSize);

端口设定表显示您的参量的详细内容，以及它们如何连接到您在 Simulink 中的 C Caller 模块。

该表包含以下各列：

extern void mean_filter(unsigned char* src,
                           unsigned int width, unsigned int height,
                           unsigned int filterSize);

double data;

void foo(void)
    {
        int temp = data;  
    }

double data;

void bar(void)
    {
        data = 0;
    }

double data;

void foo2(void)
    {
        data = data + 1;
    }

创建 FunctionPortSpecification 对象并编辑 C Caller 模块属性

要以编程方式更改端口设定表属性，您可以创建 FunctionPortSpecification 对象并修改其属性。要为模型中的所选 C Caller 模块创建 FunctionPortSpecification 对象，请在命令行中键入：

myCCallerConfigObj = get_param(gcb, 'FunctionPortSpecification')

myCCallerConfigObj = 

  FunctionPortSpecification with properties:

        CPrototype:  'real_T add(real_T u1, real_T u2);'
    InputArguments:  [1×2 Simulink.CustomCode.FunctionArgument]
    ReturnArgument:  [1×1 Simulink.CustomCode.FunctionArgument] 
    GlobalArguments: [1×0 Simulink.CustomCode.FunctionArgument]

要修改 C Caller 模块中的全局参量，请使用 getGlobalArg 创建 GlobalArguments 对象的句柄并修改其属性。

创建自定义 C Caller 库

建议创建一个库模型来对 C Caller 模块进行分组并保持模型组织良好。还可以将数据字典链接到库以保留代码中定义的自定义类型。当您有多个模型或一个使用自定义 C 代码的模型引用层次结构时，使用库模型尤其有用。

您也可以使用 Simulink 代码导入器从自定义代码创建 C Caller 模块库。请参阅基于 C/C++ 代码创建模块库。

调试自定义代码

通过启动外部调试器并在自定义代码中设置断点，您可以从 Simulink 内部调试您的代码。有关详细信息，请参阅Debug Custom C/C++ Code。

从模型生成代码

C Caller 支持代码生成。在从您的模型生成的代码中，C Caller 模块的每次执行对应于对与该模块相关联的外部 C 函数的一次调用。为了编译生成的代码，模型配置参数的代码生成 > 自定义代码窗格必须填充有关自定义代码的正确信息。请参阅模型配置参数：代码生成自定义代码 (Simulink Coder)。

限制

要测试包含 C Caller 模块的模型，请参阅测试集成的 C 代码 (Simulink Test)。