1. В текущей папке создайте файл ex_cc_simpleTypes.h.

   typedef enum {
     PWR_LOSS = 0,                 /* Default value */
     OVERSPD,
     PRESS_LOW,
   } fault_T;
   
   typedef struct {
       double coeff;
       double init;
   } params_T;

2. Сгенерируйте представления типов Simulink путем вызова Simulink.importExternalCTypes.

   Simulink.importExternalCTypes('ex_cc_simpleTypes.h');

   Функция создает Simulink.Bus объект, params_T, в базовом рабочем пространстве.

3. Чтобы просмотреть свойства объекта, откройте Редактор шины.

   buseditor

   Каждый элемент шины использует имя и тип данных (double), которые соответствуют соответствующему полю структуры в ex_cc_simpleTypes.h.

4. В текущей папке проверьте сгенерированный файл, fault_T.m, который задает перечисляемый тип fault_T как класс перечисления.

   Можно использовать объект шины и класс перечисления, чтобы задать типы данных сигнала и параметра в моделях Simulink.

В этом примере показано, как сгенерировать представление Simulink типа структуры, в полях которого используются пользовательские типы данных (typedef).

Создайте файл 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 как Simulink.Bus объект в базовом рабочем пространстве. Импортируйте 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'
        SampleTime: -1
              Unit: ''
       Description: ''

The Simulink.importExternalCTypes функция использует сгенерированные Simulink.AliasType объекты для установки типов данных элементов шины.

Осмотрите Simulink.AliasType объекты в базовом рабочем пространстве. Для примера - объект с именем sint_32 соответствует одному из typedef операторы в ex_integer_aliases.h.

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 путем вызова Simulink.importExternalCTypes. Навсегда храните определения типов путем создания нового словаря данных, 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;

Сгенерируйте представления Simulink только для params_T и signals_T.

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

The 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);

The 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, поэтому вы должны использовать параметры конфигурации модели, чтобы идентифицировать целевой компьютер и, по расширению, правильную собственную целую длину.

Создайте файл ex_cc_fixpt_struct.h в текущей папке.

typedef struct {
    
    int coeff;   /* Word length 16, 
       binary fraction length 7 */
    
    int init;   /* Word length 16, 
       binary fraction length 3 */
    
} params_T;

Файл определяет тип структуры, в полях которого используются типы данных с фиксированной точкой. Для примера структура хранит поле coeff в 16-битном целочисленном типе данных со знаком. Длина двоичной дроби 7 связывает сохраненное целое число со значением в реальном мире.

Предположим, что этот код работает на 16-битном оборудовании (таком, что типоразмер типичных данных C int имеет 16-битный размер слова). Чтобы сгенерировать представление типа Simulink, сначала создайте coder.HardwareImplementation объект, идентифицирующий оборудование.

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

Сгенерируйте представление Simulink типа структуры.

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

The 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 невозможно вывести масштабирование с фиксированной точкой (длина двоичной дроби) из кода С Необходимо вручную задать типы данных элементов шины. Чтобы задать типы данных в командной строке, используйте fixdt функция.

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

Для интерактивного определения типов данных (с помощью помощника по типам данных) используйте Редактор шин.

buseditor

Импорт пользовательских типов C

Создайте файл ex_cc_myTypes_rec.h в текущей папке. Файл задает пользовательский тип структуры.

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

Сгенерируйте Simulink.Bus объект, который представляет тип.

Simulink.importExternalCTypes('ex_cc_myTypes_rec.h');

Изменение определения типа в коде С

В 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, осмотрите report область importInfo.

Импортируйте sigStructType снова. На этот раз перезаписать существующий объект шины.

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

При перезаписи существующих представлений Simulink любые индивидуальные настройки, выполненные в представлениях Simulink (такие как применение типов данных с фиксированной точкой к элементам шины), перезаписываются.