Хранилища данных позволяют подсистемам и ссылочным моделям совместно использовать данные без использования портов ввода-вывода для передачи данных с уровня на уровень (см. Основные сведения о хранилище данных и хранилища данных в сгенерированном коде). Типы хранилищ данных включают типы, перечисленные в этой таблице.
| Тип хранилища данных | Описание |
|---|---|
| Локальное хранилище данных | Хранилище данных, доступное в любом месте иерархии модели на уровне или ниже уровня, на котором определяется хранилище данных. Локальное хранилище данных можно определить графически в модели, включив блок памяти хранилища данных. |
| Общее локальное хранилище данных | Блок памяти хранилища данных с параметром блока Общий доступ для экземпляров модели. Эти хранилища данных доступны только в той модели, где они определены. Значение хранилища данных является общим для всех экземпляров модели. |
| Глобальное хранилище данных | Хранилище данных, определяемое сигнальным объектом в базовой рабочей области или в словаре данных. Эти хранилища данных могут использоваться несколькими моделями в приложении. |
При открытии модели в приложении Simulink Coder локальные и общие локальные хранилища данных отображаются в редакторе Сопоставления кода, где можно настроить хранилища данных для создания кода. Если модель использует глобальные хранилища данных, их можно просмотреть в редакторе сопоставлений кодов, щелкнув значок Refresh , которая отображается справа от имени хранилища данных. Эта связь инициирует схему обновления и добавляет глобальные хранилища данных, используемые моделью в представлении редактора.
Настройка хранилищ данных для:
Сделать данные доступными для взаимодействия во время выполнения созданного кода.
Управление местом, где генератор кода помещает данные в память.
Улучшение читаемости и прослеживаемости генерируемого кода.
Для создания кода в примерах показано, как настроить хранилище данных для модели rtwdemo_configrpinterface. Можно настроить сопоставления кода с помощью редактора сопоставлений кода или API-интерфейса сопоставлений кода (coder.mapping.api.CodeMapping).
По умолчанию локальные хранилища данных в модели отображаются в сгенерированном коде как поля глобальной структуры данных с именем model_DWmodel_SharedDSM
Настройка конфигурации по умолчанию
Если модель включает значительное количество (например, более 10) хранилищ данных для данной категории, которые должны быть доступны во время выполнения программы, более эффективно настроить хранилища данных с настройкой по умолчанию, а затем переопределить эту настройку для особых случаев. Если модель включает несколько хранилищ данных для данной категории, имеющих уникальные требования к источнику, именованию или размещению, рассмотрите возможность индивидуальной настройки хранилищ данных.
Объявление и обработка хранилищ данных модели в сгенерированном коде
Как отдельные глобальные переменные
Считывание из хранилищ данных в виде глобальных переменных, определенных во внешнем коде
Как вызовы функций доступа. Требуется встроенный кодер ®
Дополнительные сведения об этих параметрах см. в разделе Управление данными и функциональным интерфейсом в сгенерированном коде.
Другие соображения для параметров модели включают в себя необходимость:
Имена хранилищ данных в созданном коде с помощью имен хранилищ данных в модели или с помощью уникальных идентификаторов кода.
Включить static квалификатор типа в определениях и объявлениях глобальных переменных, например, для предотвращения конфликтов имен. Требуется встроенный кодер. См. раздел Предотвращение конфликтов имен путем настройки элемента данных как статического (встроенный кодер).
Включить volatile квалификатор типа в определениях и объявлениях глобальных переменных. Требуется встроенный кодер. См. раздел Защита глобальных данных с помощью квалификаторов типа const и volative (Embedded Coder).
Создайте глобальную структуру данных с указанным именем. Требуется встроенный кодер. См. раздел Организация данных в структуры в сгенерированном коде (встроенный кодер).
Размещение хранилищ данных в определенной области памяти. Требуется встроенный кодер. См. раздел Управление данными и размещением функций в памяти путем вставки прагматиков (встроенный кодер).
Список требований к интерфейсам, относящихся к хранилищам данных с соответствующими классами хранения и свойствами класса хранения, см. в разделе Выбор класса хранения и свойств класса хранения для хранилищ данных.
Например, модель rtwdemo_configrpinterface, требования к хранилищу данных:
Представление локальных и общих локальных хранилищ данных в виде отдельных глобальных переменных.
Применить префикс ds_ к именам переменных, представляющих хранилища данных.
В этом примере в качестве глобальных переменных задается представление по умолчанию для локальных и общих локальных хранилищ данных в сгенерированном коде. Затем необходимо настроить локальное хранилище данных в модели для использования класса хранения по умолчанию и уникального идентификатора кода, включающего требуемый префикс. ds_. Функция идентификатора кода позволяет задавать идентификаторы генерации кода без необходимости изменения конструкции модели.
Настройки генерации кода по умолчанию для хранилищ данных могут уменьшить усилия по подготовке модели к генерации кода, особенно если модель имеет значительное количество хранилищ данных, к которым требуется получить доступ во время выполнения сгенерированного кода. Один раз выберите настройки конфигурации, и генератор кода применит эти настройки к хранилищам данных в модели. Simulink ® сохраняет конфигурацию по умолчанию как часть модели.
Рекомендуется настроить параметры генерации кода по умолчанию для хранилищ данных модели, если модель использует несколько хранилищ данных для данной категории, не имеющих уникальных требований.
В этом примере показано, как использовать редактор сопоставления кодов для настройки параметров по умолчанию для хранилищ данных. Используйте редактор сопоставлений кодов, чтобы задать класс хранения по умолчанию для локальных и общих локальных хранилищ данных в rtwdemo_configrpinterface модели в значение ExportedGlobal. С этими настройками класса хранения генератор кода представляет хранилища данных в сгенерированном коде в виде глобальных переменных.
Открыть rtwdemo_configrpinterface модели. Сохраните копию модели в доступном для записи расположении.
Откройте приложение Simulink Coder.
На вкладке Код C выберите Интерфейс кода > Сопоставления кодов по умолчанию.
Настройка сопоставлений кодов по умолчанию для локальных хранилищ данных. В редакторе сопоставлений кодов на вкладке «Значения по умолчанию» разверните узел «Сигналы». Выберите категорию Сигналы, состояния и внутренние данные. Задайте для класса хранения значение ExportedGlobal.
Настройте сопоставления кодов по умолчанию для общих локальных хранилищ данных. Выберите категорию Общие локальные хранилища данных. Задайте для класса хранения значение ExportedGlobal.
Сохраните модель.
Для создания кода можно сконфигурировать отдельные хранилища данных. Например, если модель имеет два хранилища данных одной категории с уникальными требованиями к созданию кода, настройте хранилища данных по отдельности. Кроме того, при настройке параметров по умолчанию для категории хранилищ данных эти параметры можно переопределить для определенных хранилищ данных.
Если модель удовлетворяет хотя бы одному из этих критериев, рассмотрите возможность настройки параметров генерации кода для хранилищ данных по отдельности:
Использует несколько хранилищ данных одной категории, имеющих уникальные требования к источнику, именованию или размещению.
Использует несколько хранилищ данных той же категории.
Имеет конфигурацию по умолчанию для категории хранилищ данных, и необходимо переопределить конфигурацию для некоторых определенных состояний.
В этом примере показано, как с помощью редактора сопоставлений кодов применить настройки класса хранения по умолчанию к блоку памяти хранилища данных mode в модели rtwdemo_configinterface. В примере также показано, как настроить идентификатор кода для этого хранилища данных.
Если это еще не сделано, выполните шаги в разделе Настройка параметров генерации кода по умолчанию для хранилищ данных.
В редакторе сопоставлений кодов перейдите на вкладку «Хранилища данных». Разверните узел Локальные хранилища данных. Класс хранения для хранения данных mode имеет значение Auto, что означает, что генератор кода может исключить или изменить представление соответствующего кода в целях оптимизации. Если оптимизация невозможна, генератор кода применяет конфигурацию модели по умолчанию. В этом примере конфигурация модели по умолчанию определяет класс хранения ExportedGlobal.
Чтобы избежать оптимизации и заставить генератор кода использовать конфигурацию по умолчанию, задайте для класса хранения значение Model default.
Чтобы переопределить конфигурацию по умолчанию, укажите класс хранения, соответствующий требованиям к созданию кода для этого хранилища данных.
В редакторе сопоставлений кодов выберите локальное хранилище данных mode. Задайте для класса хранения значение Model default: ExportedGlobal.
Настройка идентификатора кода для хранилища данных с именем, включающим префикс ds_. В редакторе сопоставлений кодов выберите общее локальное хранилище данных mode. В инспекторе свойств разверните узел «Код». Задайте для свойства класса хранения Identifier значение ds_mode.
Сохраните модель.
Создайте и просмотрите код. Например, в rtwdemo_configrpinterface.cнайдите определения данных для хранилища данных.
boolean_T ds_mode;
Найдите, где используются данные состояния в функции начального уровня шага.
.
.
.
ds_mode = ((input1 > rtwdemo_configrpinterface_UPPER) || (input1 <
rtwdemo_configrpinterface_LOWER));
.
.
.
if (ds_mode) {
output = (real_T)mp_K1 * dout_Table1;
} else {
output = dstate_X;
}
.
.
.
Для автоматизации конфигурирования хранилищ данных для генерации кода используйте интерфейс программирования для отображения кода. Например, при создании пользовательских библиотек блоков или части тестовой среды приложения используйте интерфейс программирования для автоматизации настройки данных.
В этом примере показано, как использовать интерфейс программирования для конфигурирования хранилищ данных для rtwdemo_configrpinterface модели. Задайте представление по умолчанию локальных и общих локальных хранилищ данных в созданном коде в качестве глобальных переменных. Настройка блока памяти хранилища данных mode для использования класса хранения по умолчанию и уникального идентификатора кода, включающего требуемый префикс ds_.
Откройте пример модели.
open_system('rtwdemo_configrpinterface')
Создать объект cm путем вызова функции coder.mapping.api.get. Объект сохраняет конфигурацию создания кода данных для модели. rtwdemo_configrpinterface.
cm = coder.mapping.api.get('rtwdemo_configrpinterface');Настройка параметров по умолчанию для локальных хранилищ данных путем вызова функции setDataDefault. Для аргументов укажите следующие значения:
Объект, возвращенный coder.mapping.api.get
InternalData для категории по умолчанию
Имя свойства StorageClass со значением свойства ExportedGlobal
setDataDefault(cm,'InternalData','StorageClass','ExportedGlobal');
Настройка параметров по умолчанию для общих локальных хранилищ данных путем вызова функции setDataDefault. Укажите следующие значения для аргументов:
Объект, возвращенный coder.mapping.api.get.
SharedLocalDataStore для категории по умолчанию.
Имя свойства StorageClass со значением свойства ExportedGlobal.
setDataDefault(cm,'SharedLocalDataStore','StorageClass','ExportedGlobal');
Проверьте параметры конфигурации по умолчанию для локальных и общих локальных хранилищ данных. Выполните вызов getDataDefault который указывает объект, возвращенный coder.mapping.api.get, категория InternalData, и собственность StorageClass. Во втором вызове getDataDefault, заменить категорию на SharedLocalDataStore.
getDataDefault(cm,'InternalData','StorageClass')
ans =
'ExportedGlobal'
getDataDefault(cm,'SharedLocalDataStore','StorageClass')
ans =
'ExportedGlobal'
Применить конфигурацию по умолчанию для локального хранилища данных mode.
По умолчанию Simulink устанавливает класс хранения для хранилищ данных на Auto. Когда класс хранения данных Auto, генератор кода:
Определяет необходимость исключения данных из созданного кода в целях оптимизации.
При сохранении данных определяет способ эффективного представления данных в сгенерированном коде с учетом настроек конфигурации по умолчанию.
Для управления конфигурацией отдельного хранилища данных вызовите функцию setDataStore. Выполните вызов для setDataStore которая определяет:
Объект, возвращенный coder.mapping.api.get
Имя хранилища данных mode
Класс хранения по умолчанию, ранее установленный для хранилища данных с помощью свойства StorageClass и значение свойства Model default.
Собственность Identifier и значение свойства ds_mode
setDataStore(cm,'mode','StorageClass','Model default','Identifier','ds_mode');
Проверьте изменения конфигурации, вызвав функцию getDataStore. Укажите объект, возвращенный coder.mapping.api.get, имя хранилища данных и свойство StorageClass или Identifier.
getDataStore(cm,'mode','StorageClass')
ans =
'Model default'
getDataStore(cm,'mode','Identifier')
ans =
'ds_mode'
Сохраните модель.
Создайте и просмотрите код. Например, в rtwdemo_configrpinterface.c, найдите определение данных для хранилища данных.
boolean_T ds_mode;
Найдите, где хранилище данных используется в функции начального уровня шага.
.
.
.
ds_mode = ((input1 > rtwdemo_configrpinterface_UPPER) || (input1 <
rtwdemo_configrpinterface_LOWER));
.
.
.
if (ds_mode) {
output = (real_T)mp_K1 * dout_Table1;
} else {
output = dstate_X;
}
.
.
.
В зависимости от требований к созданию кода выберите один из этих классов хранения, чтобы настроить создание кода для хранилищ данных.
| Требования | Класс хранения |
|---|---|
| Активизируйте оптимизацию, потенциально создавая более эффективный код. | Авто (только отдельные сопоставления) |
| Для элементов данных, которые не могут быть оптимизированы, представляют данные как поле стандартной структуры данных. | По умолчанию (только сопоставление по умолчанию) |
| Предотвращение исключения оптимизации хранилища для элемента данных и использование класса хранения по умолчанию для категории элементов данных. | Модель по умолчанию (только отдельные сопоставления), Dictionary Default (Только отдельные сопоставления) |
| Создание определения и объявления глобальной переменной. | ExportedGlobal |
| Создание кода, считывающего и записывающего в глобальную переменную или указатель глобальной переменной, определенный внешним кодом. | ImportedExtern, ImportedExternPointer |
Список доступных классов хранения может включать другие классы хранения для конкретного проекта, определенные в словаре встроенного кодера. При наличии специальных требований, не удовлетворяющих указанным классам хранения, и наличии программного обеспечения Embedded Coder можно определить класс хранения. См. раздел Определение классов хранения, разделов памяти и шаблонов функций для архитектуры программного обеспечения (встроенный кодер).
Для отдельного хранилища данных используйте свойство Класс хранения идентификаторов, чтобы настроить имя переменной, представляющей хранилище данных в сгенерированном коде.
Редактор сопоставлений кода | coder.mapping.api.CodeMapping