Data Store Memory

Задайте хранилище данных

  • Библиотека:
  • Simulink / Маршрутизация Сигнала

  • Data Store Memory block

Описание

Блок Data Store Memory задает и инициализирует именованное общее хранилище данных, которое является областью памяти, применимой Data Store Read и блоками Data Store Write, которые задают то же имя хранилища данных.

Местоположение блока Data Store Memory, который задает хранилище данных, определяет, который Data Store Read и блоки Data Store Write могут получить доступ к хранилищу данных:

  • Если блок Data Store Memory находится в системе верхнего уровня, Data Store Read и блоки Data Store Write где угодно в модели могут получить доступ к хранилищу данных.

  • Если блок Data Store Memory находится в подсистеме, Data Store Read и блоки Data Store Write в той же подсистеме или в любой подсистеме ниже его в иерархии модели могут получить доступ к хранилищу данных.

Data Store Read или блоки Data Store Write не могут получить доступ к блоку Data Store Memory, который является или в модели, которая содержит блок Model или в модели, на которую ссылаются.

Не включайте блок Data Store Memory в Для Каждой подсистемы.

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

Можно использовать Simulink.Signal объекты в дополнение к, или вместо, Data Store Memory блокируется, чтобы задать хранилища данных. Хранилище данных, заданное в базовом рабочем пространстве с объектом сигнала, является хранилищем глобальных данных. Хранилища глобальных данных доступны для каждой модели, включая все модели, на которые ссылаются. Смотрите Хранилища данных для получения дополнительной информации.

Параметры

развернуть все

Основной

Задайте имя для хранилища данных, которое вы задаете с этим блоком. Data Store Read и блоки Data Store Write с тем же именем могут читать из и записать в, хранилище данных, инициализированное этим блоком. Имя может представлять блок Data Store Memory или объект знака, заданный, чтобы быть хранилищем данных.

Программируемое использование

Параметры блоков: DataStoreName
Ввод: символьный вектор
Значения: 'A' | ...
Значение по умолчанию: 'A'

Переименуйте это хранилище данных везде, Data Store Read и блоки Data Store Write используют его в модели.

Ограничения

Вы не можете использовать Rename All, чтобы переименовать хранилище данных если вы:

  • Используйте Simulink.Signal объект в рабочей области, чтобы управлять кодом, сгенерированным для хранилища данных

  • Используйте Simulink.Signal объект вместо блока Data Store Memory, чтобы задать хранилище данных

Необходимо вместо этого переименовать соответствующий Simulink.Signal объект от Model Explorer. Для примера смотрите, Переименовывают Хранилище данных, Заданное Объектом Сигнала.

Перечислите весь Data Store Read и блоки Data Store Write, которые имеют то же имя хранилища данных как текущий блок, и которые находятся в существующей системе или в любой подсистеме ниже его в иерархии модели. Нажатие на блок path отображает и подсвечивает что блок в вашей модели.

Атрибуты сигнала

Задайте начальное значение или значения хранилища данных. Параметр Minimum задает минимальное значение для этого параметра, и параметр Maximum задает максимальное значение.

Если вы задаете нескалярное значение и устанавливаете Dimensions на -1 (значение по умолчанию), хранилище данных имеет те же размерности как массив. Данные, которые вы пишете в хранилище данных (при помощи блоков Data Store Write) должны иметь эти размерности.

Если вы устанавливаете параметр Dimensions на значение кроме -1, размерности начального значения должны совпадать с размерностями, которые вы задаете, если начальное значение не является скаляром или структурой MATLAB®. Если вы задаете скаляр, каждый элемент хранилища данных использует скаляр в качестве начального значения. Используйте этот метод, чтобы применить то же начальное значение (скаляр, который вы задаете) к каждому элементу, вручную не совпадая с размерностями начального значения с размерностями хранилища данных.

Чтобы использовать этот блок, чтобы инициализировать невиртуальный сигнал шины, задайте начальное значение как структуру MATLAB и установите параметр конфигурации модели обнаружение инициализации Underspecified на Simplified. Для получения дополнительной информации об инициализации невиртуальных сигналов шины с помощью структур, смотрите, Задают Начальные условия для Сигналов Шины.

Программируемое использование

Параметры блоков: InitialValue
Ввод: символьный вектор
Значения: скаляр | вектор | матрица | массив N-D
Значение по умолчанию: '0'

Задайте минимальное значение, которое должен вывести блок. Значением по умолчанию является [] (незаданный). Этот номер должен быть конечным действительным двойным скалярным значением.

Примечание

Если вы задаете объект шины как тип данных для этого блока, не устанавливайте минимальное значение для данных о шине по блоку. Simulink игнорирует эту установку. Вместо этого установите минимальные значения для элементов шины объекта шины, заданного как тип данных. Для получения информации о свойстве Minimum элемента шины смотрите Simulink.BusElement.

Simulink® использует минимальное значение, чтобы выполнить:

Программируемое использование

Параметры блоков: OutMin
Ввод: символьный вектор
Значения: скаляр
Значение по умолчанию: '[ ]'

Задайте максимальное значение, которое должен вывести блок. Значением по умолчанию является [] (незаданный). Этот номер должен быть конечным действительным двойным скалярным значением.

Примечание

Если вы задаете объект шины как тип данных для этого блока, не устанавливайте максимальное значение для данных о шине по блоку. Simulink игнорирует эту установку. Вместо этого установите максимальные значения для элементов шины объекта шины, заданного как тип данных. Для получения информации о свойстве Maximum элемента шины смотрите Simulink.BusElement.

Simulink использует максимальное значение, чтобы выполнить:

Программируемое использование

Параметры блоков: OutMax
Ввод: символьный вектор
Значения: скаляр
Значение по умолчанию: '[ ]'

Задайте тип выходных данных. Можно установить его на:

  • Правило, которое наследовало тип данных (например, Inherit: auto).

  • Имя встроенного типа данных (например, single).

  • Имя объекта типа данных (например, Simulink.NumericType объект.

  • Выражение, которое оценивает к типу данных (например, fixdt(1,16,0)). Не задавайте объект шины как тип данных в выражении; используйте Bus: <object name> задавать тип данных шины.

Нажмите кнопку Show data type assistant, чтобы отобразить Data Type Assistant, который помогает вам установить атрибуты типа данных. Для получения дополнительной информации смотрите, Задают Типы данных Используя Ассистент Типа данных.

Программируемое использование

Параметры блоков: OutDataTypeStr
Ввод: символьный вектор
Значения: 'Inherit: auto' | 'double' | 'single' | 'half' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'int64' | 'uint64' | 'boolean' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)' | 'string' | 'Enum: <class name>'
Значение по умолчанию: 'Inherit: auto'

Выберите этот параметр, чтобы препятствовать тому, чтобы Fixed-Point Tool заменили тип данных Output, который вы задаете на блоке. Для получения дополнительной информации смотрите, что Тип Выходных данных Блокировки Использования Устанавливает (Fixed-Point Designer).

Программируемое использование

Параметры блоков: LockScale
Ввод: символьный вектор
Значения: 'off' | 'on'
Значение по умолчанию: 'off'

Размерности хранилища данных. Значение по умолчанию, -1, позволяет вам установить размерности хранилища данных при помощи параметра Initial value. Однако в этом случае вы не можете использовать скалярное расширение с начальным значением. Необходимо задать начальное значение при помощи массива, который имеет размерности, которые вы хотите.

Если вы используете значение кроме -1, задайте те же размерности как размерности параметра Initial value, если вы не задаете начальное значение как скаляр (для скалярного расширения) или структура MATLAB. Если хранилище данных представляет массив шин, и если вы используете структуру MATLAB для начального значения, можно задать размерности, чтобы инициализировать массив шин с этой структурой.

Программируемое использование

Параметры блоков: Dimensions
Ввод: символьный вектор
Значения: скаляр | вектор | матрица
Значение по умолчанию: '-1'

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

По умолчанию MATLAB представляет векторные данные как матрицы, которые имеют две размерности. Например, MATLAB представляет векторный [1 2 3] как 1 3 матрица.

Когда вы выбираете этот параметр, хранилище данных представляет векторные данные при помощи только одной размерности вместо два. Например, если вы задаете начальное значение [1 2 3], хранилище данных хранит одномерный вектор тремя элементами.

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

Программируемое использование

Параметры блоков: VectorParams1D
Ввод: символьный вектор
Значения: 'off' | 'on'
Значение по умолчанию: 'on'

Задайте числовой тип, действительный или комплексный, значений в хранилище данных.

Программируемое использование

Параметры блоков: SignalType
Ввод: символьный вектор
Значения: 'auto' | 'real' | 'complex'
Значение по умолчанию: 'auto'

В одной иерархии модели - ссылки, когда вы используете несколько блоков Model, чтобы обратиться к модели, которая содержит блок Data Store Memory, по умолчанию, каждый экземпляр модели, на которую ссылаются (каждый блок Model) чтения от и пишет в отдельную копию хранилища данных. Когда вы выбираете Share across model instances, вместо того, чтобы взаимодействовать с отдельной копией, всеми экземплярами, считанными из, и пишете в то же хранилище данных.

Когда вы устанавливаете параметр конфигурации модели Code interface packaging на Reusable function чтобы сгенерировать повторно используемый код из модели (Simulink Coder™), хранилище данных с выбранным Share across model instances появляется в коде как глобальный символ что сгенерированный доступ к функциям точки входа непосредственно. Например, глобальный символ является глобальной переменной или полем глобальной переменной структуры. Поэтому каждый вызов, который ваш код выполняет к функциям точки входа (каждый экземпляр модели) совместно использует данные.

Для примера смотрите, Осуществляют обмен данными Хранилище Между Экземплярами Допускающего повторное использование Алгоритма. Для получения дополнительной информации смотрите, Осуществляют обмен данными Среди Экземпляров Модели, на которые Ссылаются.

Программируемое использование

Параметры блоков: ShareAcrossModelInstances
Ввод: символьный вектор
Значения: 'off' | 'on'
Значение по умолчанию: 'off'

Укажите, что программное обеспечение Simulink, при компиляции модели, ищет рабочее пространство модели и базовое рабочее пространство для Simulink.Signal объект, имеющий то же имя, как описано в Разрешении Символа. Если Simulink не находит такой объект, остановки компиляции с ошибкой. В противном случае Simulink сравнивает атрибуты объекта сигнала к соответствующим атрибутам Блока памяти Хранилища данных. Если блок и атрибуты объектов противоречивы, остановы Simulink компиляция модели, и отображает ошибку.

Программируемое использование

Параметры блоков: StateMustResolveToSignalObject
Ввод: символьный вектор
Значения: 'off' | 'on'
Значение по умолчанию: 'off'

Выберите пользовательский пакет класса памяти путем выбора класса объекта сигнала, который задает целевой пакет. Например, чтобы применить пользовательские классы памяти от встроенного пакета mpt, выберите mpt.Signal. Если вы не используете основанную на ERT цель генерации кода с программным обеспечением Embedded Coder®, пользовательские классы памяти не влияют на сгенерированный код.

Для получения информации о классах памяти смотрите Настройку генерации кода C для Элементов Интерфейса модели (Simulink Coder). Для получения информации о пользовательских классах памяти смотрите, Организуют Данные о Параметре в Структуру при помощи Класса памяти Struct (Embedded Coder).

Программируемое использование

Параметры блоков: StateSignalObject
Ввод: символьный вектор
Значения: 'Simulink.Signal' | ...
Значение по умолчанию: 'Simulink.Signal'

Применяет класс памяти или пользовательский класс памяти, который вы выбираете из списка. Для получения информации о классах памяти смотрите Настройку генерации кода C для Элементов Интерфейса модели (Simulink Coder). Для получения информации о пользовательских классах памяти смотрите, Организуют Данные о Параметре в Структуру при помощи Класса памяти Struct (Embedded Coder).

Используйте Signal object class, чтобы выбрать пользовательские классы памяти из пакета кроме Simulink.

Чтобы программно установить этот параметр, используйте StateStorageClass или StateSignalObject. Смотрите настройку генерации кода C для элементов интерфейса модели (Simulink Coder).

Программируемое использование

Параметры блоков: StateStorageClass
Ввод: символьный вектор
Значения: 'Auto' | 'Model default' | 'ExportedGlobal' | 'ImportedExtern' | 'ImportedExternPointer' | 'Custom' | ...
Значение по умолчанию: 'Auto'

Задайте спецификатор типа хранения, такой как const или volatile.

Примечание

TypeQualifier будет удален в будущем релизе. Чтобы применить спецификаторы типа хранения к данным, используйте разделы custom storage classes и memory. Если вы не используете основанную на ERT цель генерации кода с Embedded Coder, разделы custom storage classes и memory не влияют на сгенерированный код.

В процессе моделирования блок использует следующие значения:

  • Начальное значение объекта сигнала, к которому разрешено имя состояния

  • Минимальные и Максимальные значения объекта сигнала

Для получения дополнительной информации смотрите Объекты данных.

Зависимости

Чтобы включить этот параметр, установите Code generation storage class на ExportedGlobal, ImportedExtern, ImportedExternPointer, или Model default. Этот параметр скрыт, если вы ранее не устанавливаете его значение.

Программируемое использование

Параметры блоков: RTWStateStorageTypeQualifier
Ввод: символьный вектор
Значения: '' | 'const' | 'volatile' | ...
Значение по умолчанию: ''

Диагностика

Выберите диагностическое действие, чтобы взять, если модель пытается считать данные от хранилища данных, до которого это не записало данные в этом временном шаге. См. также Обнаружить чтение перед диагностикой записи в разделе Блока памяти Хранилища данных Model Configuration Parameters> Diagnostics> панель Data Validity.

  • None — Не произведите ответ.

  • Warning — Выведите предупреждение и продолжите симуляцию.

  • Error — Отключите симуляцию и отобразите ошибку.

Программируемое использование

Параметры блоков: ReadBeforeWriteMsg
Ввод: символьный вектор
Значения: 'none' | 'warning' | 'error'
Значение по умолчанию: 'warning'

Выберите диагностическое действие, чтобы взять, если модель пытается записать данные к хранилищу данных после предыдущего чтения данных из него на шаге текущего времени. См. также Обнаружить запись после диагностики чтения в разделе Data Store Memory block Model Configuration Parameters> Diagnostics> панель Data Validity.

  • None — Не произведите ответ.

  • Warning — Выведите предупреждение и продолжите симуляцию.

  • Error — Отключите симуляцию и отобразите ошибку.

Программируемое использование

Параметры блоков: WriteAfterReadMsg
Ввод: символьный вектор
Значения: 'none' | 'warning' | 'error'
Значение по умолчанию: 'warning'

Выберите диагностическое действие, чтобы взять, если модель пытается записать данные к хранилищу данных дважды по очереди на шаге текущего времени. См. также Обнаружить запись после диагностики записи в разделе Блока памяти Хранилища данных Model Configuration Parameters> Diagnostics> панель Data Validity.

  • None — Не произведите ответ.

  • Warning — Выведите предупреждение и продолжите симуляцию.

  • Error — Отключите симуляцию и отобразите ошибку.

Программируемое использование

Параметры блоков: WriteAfterWriteMsg
Ввод: символьный вектор
Значения: 'none' | 'warning' | 'error'
Значение по умолчанию: 'warning'

Логгирование

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

Программируемое использование

Параметры блоков: DataLogging
Ввод: символьный вектор
Значения: 'off' | 'on'
Значение по умолчанию: 'off'

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

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

Программируемое использование

Параметры блоков: DataLoggingNameMode
Ввод: символьный вектор
Значения: 'SignalName' | 'Custom'
Значение по умолчанию: ''

Примечание

Если вы устанавливаете DataLoggingNameMode к Custom, необходимо задать имя, сопоставленное с регистрируемыми данными сигнала с помощью DataLoggingName параметр.

Параметры блоков: DataLoggingName
Ввод: символьный вектор
Значения: символьный вектор
Значение по умолчанию: ''

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

Программируемое использование

Параметры блоков: DataLoggingMaxPoints
Ввод: символьный вектор
Значения: ненулевое целое число
Значение по умолчанию: '5000'

Регистрируйте каждый Nточка данных th, где N номер, который вы вводите в смежном поле редактирования. Например, предположите, что ваша модель использует решатель фиксированного шага с размером шага 0.1 s. Если вы выбираете эту опцию и принимаете значение децимации по умолчанию (2), Simulink записывает точки данных для этого сигнала во времена 0.0, 0.2, 0.4, и так далее. Для получения дополнительной информации смотрите Хранилища Данных логов.

Программируемое использование

Параметры блоков: DataLoggingLimitDataPoints
Ввод: символьный вектор
Значения: ненулевое целое число
Значение по умолчанию: '2'

Характеристики блока

Типы данных

Boolean | bus | double | enumerated | fixed point | half | integer | single | string

Прямое сквозное соединение

yes

Многомерные сигналы

yes

Сигналы переменного размера

no

Обнаружение пересечения нулем

no

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью Simulink® Coder™.

Преобразование фиксированной точки
Спроектируйте и симулируйте системы фиксированной точки с помощью Fixed-Point Designer™.

Представлено до R2006a