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

您可以使用 C

Caller 模块中的 Port specification 表，并通过命令行创建 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);

Port specification 显示您的参数的详细内容，以及它们如何连接到您在 Simulink 中的 C Caller 模块。

Name - 指定输入和输出参数的名称。Name 是源代码中的 C 函数中定义的函数参数名称。此列仅供参考。

Scope - 指定 C 函数参数如何映射到 Simulink 作用域。您的参数根据函数定义具有默认作用域，并且您可以根据源代码中的函数定义来更改作用域。

Simulink Scope作用域到模块的映射“Input”模块输入端口

“Output”模块输出端口

“InputOutput”模块输入和输出端口

“Global”模块使用的全局变量

“Parameter”模块可调参数

“Constant”常量值

当具有常量限定符定义(如 const double

*u)时，该参数必须为 input 或 parameter 类型。如果没有常量限定符，则该参数默认为 output 类型，您可以将其更改为 “Input”、“InputOutput” 或 “Parameter” 作用域。在这种情况下，请确保 C 函数不会修改指针指向的内存。如果参数是 Output 类型，则在该函数的每次调用中，该指针指向的每个元素都应该重新分配。

C 参数Simulink Scope函数返回“Output”

double u“Input”、“Parameter”、“Constant”

double u[]

double

u[][2]

double u[2][3]“Output”(默认值)、“Input”、“Parameter”

double *u“Output”(默认值)、“InputOutput”、“Input”、“Parameter”

const double *u

const double

u[]

const double

u[][2]

const double

u[2][3]“Input”(默认值)、“Parameter”

使用 “InputOutput” 端口映射 C 函数中指针传递的输入。使用 “InputOutput” 端口创建的端口具有相同的输入和输出端口名称。“InputOutput” 端口允许输入和输出端口重用缓冲区。这可以根据信号大小和模块布局来优化内存的使用。

要将 C 函数参数映射到 “InputOutput” 端口，请在函数定义中将变量定义为指针。

extern void mean_filter(unsigned char* src,

unsigned int width, unsigned int height,

unsigned int filterSize);

然后，在 Port Specification 表中选择 “InputOutput” 作为端口作用域，并将结果函数输出赋给自定义函数中的输入变量。

您可以在自定义代码中使用全局变量，将它们映射到适当的 Simulink 作用域。要在模型中使用全局变量，请从 Model Settings > Configuration Parameters > Simulation Target 中选择 Enable global variables as function interfaces。您可以将全局变量映射到 C Caller 模块上的 “Input”、“Output”、“InputOutput” 或 “Global” 作用域。这些作用域的可用性取决于自定义代码中全局变量的使用情况。

“Global” 作用域使您能够在自定义代码和 C Caller 模块之间传输数据，并允许您在计算期间对模块使用全局变量。使用 “Global” 作用域传输的值在模块接口上不可见。下表显示示例代码段及其默认端口和可用端口。

示例代码Simulink Scopedouble data;

void foo(void)

{

int temp = data;

}全局变量数据只读取变量 data。可用作用域包括：

“Input”(默认值)

“Global”

double data;

void bar(void)

{

data = 0;

}数据写入全局变量。可用作用域包括：

“Output”(默认值)

“Global”

“InputOutput”

double data;

void foo2(void)

{

data = data + 1;

}可对全局变量读写数据。可用作用域包括：

“Global”(默认值)

“InputOutput”

“Output”

Label - 指示 Simulink 模块中对应参数的标签。默认情况下，参数标签与参数名称相同，除非您更改它。

Simulink ScopeSimulink 端口标签“input”、“output”端口名称

“inputoutput”输入和输出端口中的端口名称

“Global”端口名称和全局变量名称

“parameter”参数名称

“constant”常量值的表达式。

使用输入参数名称的 size 表达式，例如 size(in1,1)

Type - 说明 Simulink 数据类型和 C 函数参数数据类型之间的匹配。

C 参数数据类型Simulink 数据类型有符号字符int8

无符号字符uint8

charint8 或 uint8，具体取决于编译器

int*int32

无符号 int*uint32

short *int16

long *int32 或 fixdt(1,64,0)，取决于操作系统

float单精度

双精度双精度

int8_t*int8

uint8_t*int8

int16_t*int16

uint16_t*uint16

int32_t*int32

uint32_t*uint32

typedef struct {…} AStruct**总线：AStruct

typedef enum {..} AnEnum**枚举：AnEnum

* 如果 C Caller 采用整数类型，例如 int16_t，您可以将其修改为具有匹配的基类型的定点类型，例如修改为 fixdt(1, 16, 3)。

** C

Caller 同步按钮提示您将 C 函数使用的结构体或枚举类型导入为 Simulink 总线和枚举类型。

Size - 指定参数中的数据维度。

C 参数维度Simulink 端口维度double u标量 (1)

double u[]

double

u[][2]继承 (-1)(默认值)

如果参数用于输出端口，则应指定大小。无法继承输出端口的大小。

double *u继承 (-1)(默认值)

如果参数是针对 “inputoutput” 端口的，则无法继承大小，即使可以继承 “output” 端口的大小也是如此。

对于全局变量，大小是标量 (1)。

double u[2][3]大小为 [2, 3]。

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

要以编程方式更改 Port Specification 表属性，您可以创建 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]CPrototype 属性是只读属性，它显示 C 函数输入变量的声明。InputArgument 和 ReturnArgument 属性创建了 FunctionArgument 对象，您可以根据上面为 Port Specification 表定义的规则进一步编辑其属性。您可以参考 FunctionPortSpecification 了解详细信息。

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