Simulink.importExternalCTypes

在当前文件夹中，创建文件 ex_cc_simpleTypes.h。

typedef enum {
  PWR_LOSS = 0,                 /* Default value */
  OVERSPD,
  PRESS_LOW,
} fault_T;

typedef struct {
    double coeff;
    double init;
} params_T;

通过调用 Simulink.importExternalCTypes 生成类型的 Simulink 表示。

Simulink.importExternalCTypes('ex_cc_simpleTypes.h');

函数在基础工作区中创建 Simulink.Bus 对象 params_T。

要检查该对象的属性，请打开类型编辑器。

typeeditor

每个总线元素使用与 ex_cc_simpleTypes.h 中的对应结构体字段匹配的名称和数据类型 (double)。

在当前文件夹中，检查生成的文件 fault_T.m，它将枚举类型 fault_T 定义为枚举类。

您可以使用总线对象和枚举类在 Simulink 模型中设置信号和参数数据类型。

此示例说明如何生成对字段使用自定义数据类型 (typedef) 的结构体类型的 Simulink 表示。

在当前文件夹中创建文件 ex_integer_aliases.h。

typedef int sint_32;

typedef unsigned short uint_16;

在当前文件夹中创建文件 ex_cc_struct_alias.h。

#include "ex_integer_aliases.h"

typedef struct {
    sint_32 accum;
    uint_16 index;
} my_ints_T;

将结构体类型作为基础工作区中的 Simulink.Bus 对象导入 Simulink 中。将 typedef 语句作为 Simulink.AliasType 对象导入。

Simulink.importExternalCTypes('ex_cc_struct_alias.h');

检查总线对象中总线元素的数据类型。例如，检查第一个总线元素的 DataType 属性，该属性对应于结构体字段 accum。

my_ints_T.Elements(1)

ans = 

  BusElement with properties:

              Name: 'accum'
        Complexity: 'real'
        Dimensions: 1
          DataType: 'sint_32'
               Min: []
               Max: []
    DimensionsMode: 'Fixed'
              Unit: ''
       Description: ''

Simulink.importExternalCTypes 函数使用生成的 Simulink.AliasType 对象来设置总线元素的数据类型。

检查基础工作区中的 Simulink.AliasType 对象。例如，名为 sint_32 的对象对应于 ex_integer_aliases.h 中的 typedef 语句之一。

sint_32

sint_32 = 

  AliasType with properties:

    Description: ''
      DataScope: 'Imported'
     HeaderFile: 'ex_integer_aliases.h'
       BaseType: 'int32'

对于大多数主机（默认为函数的目标），int 的字长为 32 位，unsigned short 的字长为 16 位。函数将 int 和 unsigned short 映射到 Simulink 类型 int32 和 uint16。

如果您有 Embedded Coder®，则您从模型生成的代码可以使用 sint_32 和 uint_16，而不是标准数据类型名称 int32_T 和 uint16_T。

此示例说明如何将导入的数据类型存储在 Simulink 数据字典中。数据字典存储一个或多个 Simulink 模型的数据设定（例如用于信号和模块参数值）、数据类型和其他设计数据。

在当前文件夹中，创建文件 ex_cc_simpleTypes.h。

typedef enum {
  PWR_LOSS = 0,            /* Default value */
  OVERSPD,
  PRESS_LOW,
} fault_T;

typedef struct {
    double coeff;
    double init;
} params_T;

创建子文件夹 myDictionaries。

mkdir('myDictionaries')

通过调用 Simulink.importExternalCTypes 来生成类型的 Simulink 表示。通过在新的子文件夹中创建新数据字典 ex_cc_myTypes.sldd 来永久存储类型定义。

Simulink.importExternalCTypes('ex_cc_simpleTypes.h',...
    'DataDictionary','ex_cc_myTypes.sldd',...
    'OutputDir','myDictionaries');

要检查字典的内容，请将当前文件夹设置为 myDictionaries，然后双击字典文件。

要在字典中使用 Simulink 表示，您必须将一个或多个模型链接到该字典。请参阅迁移模型以使用 Simulink 数据字典。

此示例说明如何仅为您按名称标识的枚举和结构体数据类型生成 Simulink 表示。

在当前文件夹中，创建文件 ex_cc_manySimpleTypes.h。该文件定义三种结构体类型：params_T、signals_T 和 states_T。

typedef struct {
    double coeff;
    double init;
} params_T;

typedef struct {
    double flow_rate;
    double steam_press;
} signals_T;

typedef struct {
    double accum;
    double error;
} states_T;

仅为 params_T 和 signals_T 生成 Simulink 表示。

Simulink.importExternalCTypes('ex_cc_manySimpleTypes.h',...
    'Names',{'params_T','signals_T'});

Simulink.Bus 对象 params_T 和 signals_T 出现在基础工作区中。

默认情况下，Simulink.importExternalCTypes 通过创建派生自内置类 Simulink.IntEnumType 的枚举类来表示枚举数据类型。当您从使用生成的类的模型进行仿真或生成代码时，您为模型选择的配置参数（例如，在硬件实现窗格上）将确定 Simulink.IntEnumType 和枚举类使用的具体整数长度。

默认情况下，函数根据主机的字长解释泛型原始 C 数据类型，如 short 和 int。例如，要表示 int 结构体字段，函数通常将 32 位数据类型 int32 应用于对应的总线元素。如果要针对主机之外的其他硬件进行仿真和生成代码，请使用 HardwareImplementation 对组参量来标识目标硬件并通过扩展名标识硬件的字长。

此示例说明如何从您打算用于 16 位硬件的代码导入数据类型。对于该硬件板，int 具有 16 位长度，并且枚举数据 (enum) 的每个项占用 16 位。

在当前文件夹中，创建文件 ex_cc_intTypes.h。

typedef enum {
  PWR_LOSS = 0,            /* Default value */
  OVERSPD,
  PRESS_LOW,
} fault_T;

typedef struct {
    int coeff;
    int init;
} params_T;

该代码定义了枚举数据类型和结构体类型，其字段使用泛型 C 数据类型 int。

要生成结构体类型的精确 Simulink 表示，请首先打开一个现有模型或新建一个模型。对于此示例，创建名为 ex_hdwImpl_16bit 的新模型。

在新模型中，将配置参数 > 硬件实现 > 设备供应商设置为 Atmel。将设备类型设置为 AVR。

或者，在命令提示符下，使用以下命令创建和配置模型：

new_system('ex_hdwImpl_16bit','Model');
set_param('ex_hdwImpl_16bit','ProdHWDeviceType','Atmel->AVR')

生成类型的 Simulink 表示。要指定 16 位目标硬件的字长，请将模型配置参数（包括硬件实现设置）提取为 Simulink.ConfigSet 对象。

configSet = getActiveConfigSet('ex_hdwImpl_16bit');
Simulink.importExternalCTypes('ex_cc_intTypes.h','HardwareImplementation',configSet);

Simulink.Bus 对象 params_T 出现在基础工作区中。总线元素（如 coeff）使用 Simulink 数据类型 int16。

params_T.Elements(1)

ans = 

  BusElement with properties:

              Name: 'coeff'
        Complexity: 'real'
        Dimensions: 1
          DataType: 'int16'
               Min: []
               Max: []
    DimensionsMode: 'Fixed'
              Unit: ''
       Description: ''

在当前文件夹中，文件 fault_T.m 定义枚举类 fault_T。该类派生自 Simulink.IntEnumType，因此您必须使用模型配置参数来标识目标硬件，并使用扩展名来标识正确的本机整数长度。

假设以下代码在 16 位硬件上运行（这样，泛型 C 数据类型 int 的字长为 16 位）。要生成类型的 Simulink 表示，请首先创建用于标识硬件的 coder.HardwareImplementation 对象。

hdw = coder.HardwareImplementation;
hdw.ProdHWDeviceType = 'Atmel->AVR';

生成结构体类型的 Simulink 表示。

Simulink.importExternalCTypes('ex_cc_fixpt_struct.h',...
    'HardwareImplementation',hdw);

Simulink.Bus 对象 params_T 出现在基础工作区中。每个总线元素（如 coeff）使用数据类型 int16。

params_T.Elements(1)

ans = 

  BusElement with properties:

              Name: 'coeff'
        Complexity: 'real'
        Dimensions: 1
          DataType: 'int16'
               Min: []
               Max: []
    DimensionsMode: 'Fixed'
              Unit: ''
       Description: ''

Simulink.importExternalCTypes 不能从 C 代码推断定点定标（二进制小数长度）。您必须手动指定总线元素的数据类型。要在命令提示符下指定数据类型，请使用 fixdt 函数。

params_T.Elements(1).DataType = 'fixdt(1,16,7)';
params_T.Elements(2).DataType = 'fixdt(1,16,3)';

要以交互方式指定数据类型（通过使用数据类型助手），请使用类型编辑器。

typeeditor

导入自定义 C 类型

在当前文件夹中创建文件 ex_cc_myTypes_rec.h。该文件定义了一个自定义结构体类型。

typedef struct {
    double flow;
    double pres;
    double tqe;
} sigStructType;

生成表示该类型的 Simulink.Bus 对象。

Simulink.importExternalCTypes('ex_cc_myTypes_rec.h');

修改 C 代码中的类型定义

在 ex_cc_myTypes_rec.h 中，将名为 spd 的字段添加到 sigStructType。

在同一个文件中，创建新结构体类型 stateStructType。

typedef struct {
    double flow;
    double pres;
    double tqe;
    double spd;
} sigStructType;

typedef struct {
    double err;
    double read;
    double write;
} stateStructType;

再次尝试导入类型

尝试生成表示类型的总线对象。

importInfo = Simulink.importExternalCTypes('ex_cc_myTypes_rec.h');

函数在命令提示符下生成警告。您可以通过检查输出 importInfo（而不是依赖警告）来确定函数是否未导入任何类型。

importInfo.failedToImport.Bus

ans =

  1×1 cell array

    {'sigStructType'}

该函数未导入 sigStructType。基础工作区中对应的总线对象仍然只有三个总线元素。要确定函数未导入 sigStructType 的原因，请检查 importInfo 的 report 字段。

再次导入 sigStructType。这次会覆盖现有总线对象。

importInfo = Simulink.importExternalCTypes('ex_cc_myTypes_rec.h',...
    'Names',importInfo.failedToImport.Bus,'Overwrite','on');

当您覆盖现有 Simulink 表示时，您对 Simulink 表示所做的任何自定义（例如将定点数据类型应用于总线元素）都将被覆盖。