Сконфигурируйте данные сигнала для генерации кода C

Данные сигнала состоят из переменных, которые хранят промежуточные результаты в глобальной памяти, когда сгенерированный алгоритмический код вычисляет значения сигналов выхода блока от входных сигналов блока, исключая сигналы, которые соединяются с корневыми блоками Inport и Outport. Данные о сигнале не являются сигнальными линиями в диаграмму модели. Для примера в этих случаях сигнальная линия не имеет представления данных в сгенерированном коде:

Передает порт вызова функции
Выход из блока сообщений, такого как блок Send
Пересекает контуры подсистемы без вычислительных блоков между

Когда вы конфигурируете модель для генерации кода, вы выбираете входные и выходные сигналы блоков, чтобы сделать доступными в сгенерированном коде. Для примера сконфигурируйте данные сигнала так:

Сделать данные доступными для взаимодействия и мониторинга во время выполнения сгенерированного кода.
Минимизируйте объем данных, которые хранятся в памяти.
Управляйте, где генератор кода помещает данные сигнала в память.
Продвигайте данные сигнала к интерфейсу модели, чтобы другие компоненты и системы могли получить доступ к этим данным.
Улучшите читаемость и трассируемость сгенерированного кода.

Генератор кода проверяет согласованность строения сигнальной линии. Например, генератор кода проверяет, что строение сигнальной линии, поступающей в подсистему, соответствует строению сигнальной линии, которая выходит из соответствующего входного порта подсистемы.

Для генерации кода примеры показывают, как сконфигурировать сигналы блоков для модели rtwdemo_configinterface. Можно сконфигурировать отображения кода с помощью интерфейса программирования Code Mappings editor или отображений кода (coder.mapping.api.CodeMapping).

Выберите опции строения кода для сигналов

На основе ваших требований к генерации кода решите, какие блочные сигналы представлять в сгенерированном коде и как представлять данные сигнала. По умолчанию сигналы в модели появляются в сгенерированном коде как поля структуры глобальных данных с именем model_B. Если вы не конфигурируете индивидуальных настроек, генератор кода определяет, устранять или изменять представление сигналов в сгенерированном коде в целях оптимизации. Если вы конфигурируете индивидуальные настройки, решите:

Какие сигналы сделать доступными в сгенерированном коде
Вы должны добавить сигналы, которые вы хотите сделать доступными в сгенерированном коде, к отображениям кода модели.
Настройка ли строения по умолчанию
Если вам нужно получить доступ к значительному количеству (например, более 10) сигналов, более эффективно сконфигурировать сигналы с настройками по умолчанию и затем переопределить эти настройки для особых случаев. Если вам нужно получить доступ к нескольким сигналам, которые имеют уникальные требования к источнику, именованию или размещению, рассмотрите настройку сигналов по отдельности.
Как объявить и обработать данные сигнала в сгенерированном коде
- Как отдельные глобальные переменные
- Чтобы считать входные данные из глобальных переменных, определенных во внешнем коде
- Как вызовы для доступа к функциям. Требуется Embedded Coder^®
Для получения дополнительной информации об этих опциях смотрите Управляющие данные и Интерфейс функции в Сгенерированном коде.

Другие факторы включают в себя вопрос о том, следует ли:

Назовите сигналы в сгенерированном коде при помощи меток сигналов, которые появляются в модели или при помощи уникальных идентификаторов кода.
Включите volatile type qualifier в определениях и объявлениях глобальных переменных. Требуется Embedded Coder. См. Раздел «Защита глобальных данных с помощью стандартных и энергозависимых классификаторов типов».
Поместите данные сигнала в определенную область памяти. Требуется Embedded Coder. Смотрите Control Data and Function Placement in Memory путем вставки прагм.

Для получения списка требований к интерфейсам, которые относятся к сигналам с соответствующими классами памяти и свойствами класса памяти, смотрите Выбор классов хранения и свойств классов хранения для хранилищ данных.

Требования к сигналу, например, к модели rtwdemo_configinterface являются:

Сконфигурируйте сигналы, которые поступают в блок Switch и выходят из него для генерации кода. Сохраните эти данные сигнала для мониторинга во время выполнения сгенерированного кода.
Представление сигналов как отдельных глобальных переменных.
Применить префикс dout_ к именам переменных, которые представляют сигналы.

Установите представление сигналов по умолчанию в сгенерированном коде как глобальные переменные, которые имеют static type qualifier. Затем вы конфигурируете выходные сигналы двух блоков интерполяционной таблицы, чтобы использовать класс памяти по умолчанию и уникальные идентификаторы кода, которые включают необходимый префикс dout_.

Добавьте сигналы к отображениям кода модели

Прежде чем вы сможете сконфигурировать сигнал для генерации кода, добавьте сигнал к отображениям кода модели. Добавьте выходные сигналы для двух блоков интерполяционной таблицы к отображениям кода модели.

Откройте пример модели rtwdemo_configinterface. Сохраните копию модели в месте с возможностью записи.
Откройте приложение Embedded Coder.
На вкладке C Code выберите Code Interface > Individual Element Code Mappings.
В редакторе Отображения перейдите на вкладку Signals/States. Сигналы не перечислены.
Добавьте сигналы к отображениям кода. Для выходного сигнала блоков интерполяционной таблицы Table1 и Table2:
1. В модели выберите сигнал.
2. Пауза на многоточии, которая появляется выше или ниже сигнальной линии, чтобы открыть панель действий. Нажмите кнопку Add Signal (добавить сигнал).
В редакторе Отображения узел Signals расширяется и перечисляет два добавленных сигнала.

Сконфигурируйте настройки генерации кода по умолчанию для сигналов

Настройка генерации кода по умолчанию для сигналов может уменьшить усилия по подготовке модели для генерации кода, особенно если модель имеет значительное количество сигналов, которые вы хотите контролировать во время выполнения сгенерированного кода. Выберите настройки строения один раз, и генератор кода применяет эти настройки к сигналам по всей модели. Simulink^® сохраняет строение по умолчанию как часть модели.

Рассмотрите конфигурирование настроек генерации кода по умолчанию для сигналов модели, если ваша модель использует несколько сигналов, которые не имеют уникальных требований, или использует общий словарь Embedded Coder.

В этом примере показано, как использовать Code Mappings editor, чтобы задать класс памяти по умолчанию для сигналов в модели rtwdemo_configinterface на FileScope. С помощью этой настройки класса памяти генератор кода представляет данные сигнала в сгенерированном коде как глобальные переменные, которые имеют static type qualifier.

Если вы еще не сделали этого, добавьте сигналы к отображениям кода модели, как описано в Add Signals to Model Code Mappings.
На вкладке C Code выберите Code Interface > Default Code Mappings.
В редакторе Отображения в разделе Signals выберите Signals, states, and internal data категории. Установите класс памяти по умолчанию равным FileScope.
Сохраните модель.

Сконфигурируйте настройки генерации кода для отдельных сигналов

Можно сконфигурировать отдельные сигналы для генерации кода. Для примера, если модель имеет два сигнала, которые имеют уникальные требования к генерации кода, сконфигурируйте сигналы индивидуально. Или, если вы конфигурируете настройки по умолчанию для сигналов, можно переопределить эти настройки для определенных сигналов.

Если ваша модель соответствует хотя бы одному из следующих критериев, рассмотрите конфигурирование настроек генерации кода для сигналов индивидуально:

Использует несколько сигналов, которые имеют уникальные требования к источнику, именованию или размещению.
Использует несколько сигналов.
Имеет строение по умолчанию для сигналов, и вам нужно переопределить строение для некоторых конкретных сигналов.

В этом примере показано, как использовать редактор Отображения для применения настройки класса памяти по умолчанию к выходным сигналам блоков интерполяционной таблицы Table1 и Table2 в rtwdemo_configinterface модели. Пример также показывает, как сконфигурировать идентификаторы кода для этих выходных сигналов. Можно задать идентификаторы генерации кода, для примера для интегрирования, не изменяя проект модели.

Если вы еще не сделали этого, выполните шаги в Настройте настройки генерации кода по умолчанию для сигналов.
В редакторе Отображения перейдите на вкладку Signals/States. Разверните Signals. Редактор перечисляет имена или идентификаторы блочных портов сигналов, которые вы добавили к отображениям кода. Если сигнал разрешается к объекту сигнала, справа от имени элемента или идентификатора порта появляется значок разрешения к объекту сигнала. Класс памяти для каждого сигнала устанавливается на Auto, что означает, что генератор кода может исключить или изменить представление соответствующего кода в целях оптимизации. Если оптимизация невозможна, генератор кода применяет строение модели по умолчанию. В данном примере строение модели по умолчанию задаёт класс памяти FileScope.
- Чтобы избежать оптимизации и заставить генератор кода использовать строение по умолчанию, установите класс памяти равным Model default.
- Чтобы переопределить строение по умолчанию, задайте класс памяти, который удовлетворяет требованиям генерации кода для этого сигнала.
В редакторе Code Mappings выберите выходные сигналы для блоков Table1 и Table2. Установите класс памяти равным Model default: FileScope.
Сконфигурируйте идентификатор кода для выходных сигналов для двух блоков интерполяционной таблицы с именами, которые включают префикс dout_. В редакторе Отображения выберите сигнал Table1:1. В Property Inspector разверните узел Code. Установите свойство класса памяти Identifier равным dout_Table1. Для Table2:1 сигналов, установите Identifier равным dout_Table2.
Сохраните модель.

Сгенерируйте и просмотрите код. Для примера, в rtwdemo_configinterface.cнайдите определения данных для данных интерполяционной таблицы.

static MYTYPE dout_Table1;
static MYTYPE dout_Table2;

Найдите, где используются данные интерполяционной таблицы в функции точки входа шага.

.
.
.
  dout_Table1 = look1_binlc(input2, ((const MYTYPE *)&(mp_Table1.BP[0])), ((
    const MYTYPE *)&(mp_Table1.Table[0])), 10U);

  if (mode) {
    output = (real_T)mp_K1 * dout_Table1;
  } else {
    output = dstate_X;
  }

  dout_Table2 = look2_binlc(input3, input4, ((const MYTYPE *)&(mp_Table2.BP1[0])),
    ((const MYTYPE *)&(mp_Table2.BP2[0])), ((const MYTYPE *)&(mp_Table2.Table[0])),
    ((const uint32_T *)&(rtwdemo_configi_Table2_maxIndex[0])), 3U);
	
  dstate_X = dout_Table2;
}

Удалите сигналы из отображений кода модели

На вкладке C Code выберите Code Interface > Individual Element Code Mappings.
В редакторе Отображения перейдите на вкладку Signals/States.
Для каждого сигнала, который вы хотите удалить:
1. В модели выберите сигнал.
2. Пауза на многоточии, которая появляется выше или ниже сигнальной линии, чтобы открыть панель действий. Нажмите кнопку «Удалить сигнал».

Сконфигурируйте настройки генерации кода для сигналов программно

Чтобы автоматизировать строение сигналов для генерации кода, используйте интерфейс программирования для отображения кода. Например, при создании пользовательских библиотек блоков или части тестового окружения приложения используйте интерфейс программирования для автоматизации строения данных.

В этом примере показано, как использовать интерфейс программирования для конфигурирования сигналов для модели rtwdemo_configinterface. Установите представление сигналов по умолчанию в сгенерированном коде как глобальные переменные, которые имеют static type qualifier. Затем сконфигурируйте выходные сигналы двух блоков интерполяционной таблицы, чтобы использовать класс памяти по умолчанию и уникальные идентификаторы кода, которые включают необходимый префикс dout_.

Откройте пример модели.
```
open_system('rtwdemo_configinterface')
```
Создайте объект cm вызовом функции coder.mapping.api.get. Объект хранит строение генерации кода для данных и функций для модели rtwdemo_configinterface.
```
cm = coder.mapping.api.get('rtwdemo_configinterface');
```
Сконфигурируйте настройки по умолчанию для сигналов путем вызова функции setDataDefault. Для аргументов задайте следующие значения:
- Объект, возвращенный coder.mapping.api.get
- InternalData для категории по умолчанию
- Имя свойства StorageClass со значением свойства FileScope
```
setDataDefault(cm,'InternalData','StorageClass','FileScope');
```
Проверьте свои строения по умолчанию для сигналов. Выполните вызов для getDataDefault который задает объект, возвращенный coder.mapping.api.get и InternalData категорий. Задайте третий аргумент как свойство StorageClass.
```
getDataDefault(cm,'InternalData','StorageClass')

ans =

    'FileScope'
```
Получите указатели на выходные порты для блоков интерполяционной таблицы Table1 и Table2. Вы используете указатели на порт, чтобы добавить данные о сигнале к отображениям кода модели.
```
lut1D_ports = get_param('rtwdemo_configinterface/Table1','PortHandles');
lut2D_ports = get_param('rtwdemo_configinterface/Table2','PortHandles');

lut1D_outPort = lut1D_ports.Outport;
lut2D_outPort = lut2D_ports.Outport;
```
Добавьте выходные сигналы блоков интерполяционной таблицы к отображениям кода модели.
```
addSignal(cm,[lut1D_outPort,lut2D_outPort]);
```
Примените строение по умолчанию для сигналов к выходу сигналу блоков интерполяционной таблицы.
По умолчанию Simulink устанавливает класс памяти для отдельных сигналов равным Auto. Генератор кода:
- Определяет, следует ли исключить данные из сгенерированного кода в целях оптимизации.
- При сохранении данных определяет, как эффективно представлять данные в сгенерированном коде с учетом настроек строения по умолчанию.
Чтобы управлять строением сигнала, вызовите функцию setSignal.
Для каждого сигнала выполните вызов на setSignal который задает:
- Объект, возвращенный coder.mapping.api.get
- Портовый указатель на сигнал, lut1D_outport или lut2D_outport.
- Класс памяти по умолчанию ранее устанавливался для сигналов при помощи свойства StorageClass и значение свойства Model default.
- Свойства Identifier и значение свойства dout_Table1 или dout_Table2
```
setSignal(cm,lut1D_outPort,'StorageClass','Model default','Identifier','dout_Table1');
setSignal(cm,lut2D_outPort,'StorageClass','Model default','Identifier','dout_Table2');
```
Проверьте настройки строения путем вызова функции getsignal. Задайте объект, возвращенный coder.mapping.api.get, указатель на порт для сигнала (lut1D_outport или lut2D_outport), и StorageClass свойств или Identifier.
```
getSignal(cm,lut1D_outPort,'StorageClass')

ans =

    'Model default'

getSignal(cm,lut1D_outPort,'Identifier')

ans =

    'dout_Table1'

getSignal(cm,lut2D_outPort,'StorageClass')

ans =

    'Model default'

getSignal(cm,lut2D_outPort,'Identifier')

ans =

    'dout_Table2'
```
Сохраните модель.

static MYTYPE dout_Table1;
static MYTYPE dout_Table2;

Найдите, где используются данные интерполяционной таблицы в функции точки входа шага.

.
.
.
  dout_Table1 = look1_binlc(input2, ((const MYTYPE *)&(mp_Table1.BP[0])), ((
    const MYTYPE *)&(mp_Table1.Table[0])), 10U);

  if (mode) {
    output = (real_T)mp_K1 * dout_Table1;
  } else {
    output = dstate_X;
  }

  dout_Table2 = look2_binlc(input3, input4, ((const MYTYPE *)&(mp_Table2.BP1[0])),
    ((const MYTYPE *)&(mp_Table2.BP2[0])), ((const MYTYPE *)&(mp_Table2.Table[0])),
    ((const uint32_T *)&(rtwdemo_configi_Table2_maxIndex[0])), 3U);
	
  dstate_X = dout_Table2;
}

Выберите класс памяти и свойства класса памяти для сигналов

В зависимости от требований к генерации кода выберите из этих классов памяти, чтобы сконфигурировать генерацию кода для блочных сигналов.

Требования	Класс памяти, который нужно выбрать
Включите оптимизацию, потенциально создавая более эффективный код.	Авто (только для отдельных отображений)
Для элементов данных, которые не могут быть оптимизированы, представьте данные как поле стандартной структуры данных.	По умолчанию (только для отображения по умолчанию)
Предотвратите устранение оптимизации системы хранения данных для элемента данных и используйте класс памяти по умолчанию для категории элемента данных.	Модель по умолчанию (только для отдельных отображений), `Dictionary Default` (Только отдельные отображения)
Сгенерируйте структуру, которая хранит логические данные в именованных битовых полях.	Битовое поле (только для индивидуального отображения)
Сгенерируйте глобальное определение переменной и объявление, которые имеют `volatile` type qualifier.	`Volatile` (См. Const, Volatile и ConstVolatile)
Сгенерируйте глобальное определение переменной и объявление.	ExportedGlobal
Сгенерируйте определение глобальной переменной и объявление в указанный файл.	ExportToFile
Сгенерируйте глобальное определение переменной и объявление, которые имеют `static` type qualifier.	FileScope
Сгенерируйте код, который взаимодействует с данными, вызывая пользовательские функции доступа.	GetSet
Сгенерируйте код, который читается и записывается в глобальную переменную или глобальный указатель переменной, заданный вашим внешним кодом.	ImportedExtern, ImportedExternPointer
Сгенерируйте код, который читается и записывается в глобальную переменную, заданную вашим внешним заголовочным файлом.	ImportFromFile
Сгенерируйте переменные, которые являются локальными по отношению к функциям.	Локализуемый
Сгенерируйте глобальную структуру, которая имеет имя, которое можно задать.	Struct (только для отдельных отображений)

Список доступных классов памяти может включать другие специфичные для проекта классы памяти, определенные в словаре Embedded Coder Dictionary. Если у вас есть особые требования, не удовлетворяющие перечисленным классам памяти, и вы имеете программное обеспечение Embedded Coder, можно задать класс памяти. Смотрите раздел «Определение классов памяти, разделов памяти и шаблонов функций» для программной архитектуры.

Для отдельного сигнала используйте свойство Identifier класса памяти, чтобы сконфигурировать имя для переменной, представляющей сигнал в сгенерированном коде. С помощью Embedded Coder, в зависимости от выбранного класса памяти, можно также сконфигурировать эти свойства.

Свойство	Описание	Соответствующие классы памяти
`DefinitionFile`	Файл определения источника, который содержит определения для глобальных данных, который считывается сигналом и внешним кодом	`ExportToFile` и `Volatile`
`GetFunction`	сигнал появляется в сгенерированном коде как вызов к заданному `get` функция	`GetSet`
`HeaderFile`	Исходный файл заголовка, который содержит объявления для глобальных данных, который считывается сигналом и внешним кодом	`ExportToFile`, `GetSet`, `ImportFromFile`, и `Volatile`
`Memory Section`(только строение сигнала по умолчанию)	Раздел памяти, который содержит данные, считанные сигналом	`Default`
`Owner`	Генератор кода помещает определение для сигналов в код, сгенерированный для одной из нескольких моделей в иерархии модели, которая разделяет определения. Необходимо выбрать параметр конфигурации модели Use owner from data object for data definition placement. См. Раздел «Управление размещением определений глобальных данных и объявлений в сгенерированных файлах».	`ExportToFile` и `Volatile`
`PreserveDimensions`	Генератор кода сохраняет размерности данных сигнала, который представлен в сгенерированном коде как многомерный массив. Вы должны задать Array layout параметра конфигурации модели на `Row-major`. См. «Сохранение размерностей многомерных массивов в сгенерированном коде».	`ExportToFile`, `FileScope`, `ImportFromFile`, `Localizable` и `Volatile`
`SetFunction`	Сигнал появляется в сгенерированном коде как вызов к заданному `set` функция.	`GetSet`
`StructName`	Имя структуры в сгенерированном коде сигнала.	`BitField` и `Struct`

См. также

Редактор отображений кода | coder.mapping.api.CodeMapping

Документация