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: ''

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.

При наличии встроенного кодера код, генерируемый на основе модели, может использоваться 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'});

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

Создание файла 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);

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

Чтобы указать типы данных в интерактивном режиме (с помощью помощника по типам данных), используйте редактор шины.

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

Изменение определения типа в коде 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, осмотрите report поле importInfo.

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

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

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