FMU

Включите Functional Mockup Unit (FMU) в модель

  • Библиотека:
  • Отдельно оплачиваемые предметы Simulink / Импорт FMU

  • FMU block

Описание

Блок FMU импортирует существующие функциональные модули макета (FMUs) в Simulink®. Блок автоматически выбирает режим FMU на основе существующего FMU, который вы хотите импортировать:

  • Co-Simulation — Интегрируйте FMUs, которые реализуют интерфейс Functional Mock-up Interface (FMI) Co-Simulation. Эти FMUs могут содержать локальные решатели, которые используются для связи инструмента.

  • Model Exchange — Интегрируйте FMUs, которые реализуют интерфейс FMI Model Exchange. Эти FMUs не содержат локальные решатели. Вместо этого они наследовали решатели от Simulink.

Этот блок поддерживает версии 1.0 и 2.0 FMI. Для версии 2.0 FMI, если ваш FMU содержит и Co-симуляцию и элементы Exchange Модели, блок обнаруживает их и предлагает вам выбирать режим, в котором вы хотите, чтобы блок действовал.

Чтобы использовать этот блок, у вас должен сначала быть существующий FMU, экспортируемый от другого инструмента или созданный на языке C.

Порты

Выходные аргументы

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

Порт Placeholder, который не производит выхода, как. Порты ввода и вывода сконфигурированы, когда фактический FMU импортируется в блок. И порты ввода и вывода поддерживают числовые и типы данных String.

Параметры

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

Задайте имя FMU, с или без расширения файла. Эта запись является чувствительной к регистру. FMU должен существовать на MATLAB® path.

Чтобы задать имя FMU, введите имя в текстовом поле FMU name.

Когда вы нажимаете OK, блок создает /slprj/_fmu/unique_ID папка с распакованными файлами и неповрежденной файловой иерархией.

Зависимости

Когда вы задаете имя FMU, диалоговое окно блока обновляется, чтобы содержать четыре вкладки:

  • Parameters

  • Simulation

  • Input Bus

  • Output Bus

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

Параметры блоков: FMUName
Ввод: символьный вектор
Значения: имя FMU, с или без расширения файла
Значение по умолчанию: ' '

Параметры

Эта вкладка перечисляет параметры, заданные в FMU.

  • Чтобы отобразить только параметры, вы интересуетесь, вводите строку поиска в поле фильтра. Эта строка может совпадать с названием параметра или текстом в описании.

  • В таблице параметров можно изменить значение параметра в поле Value.

Симуляция

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

Зависимости

Этот параметр применим, только если ваша версия FMU или режим поддерживают значения допуска.

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

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

Значение относительной погрешности FMU (%) в виде скаляра. ​

Зависимости

Этот параметр применим, только если ваша версия FMU или режим поддерживают значения допуска.

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

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

Коммуникационный размер шага в процессе моделирования в виде скаляра. ​ Задают временной интервал между моментами времени симуляции для блока. Для получения дополнительной информации смотрите Факторы Синхронизации.

В большинстве случаев, чтобы предотвратить неожиданное поведение, установите это значение к положительному значению. Чтобы наследовать шаг расчета от ведущего блока или решателя модели, установите этот параметр на -1. Для получения дополнительной информации см. Настройку времени выборки.

Блок поддерживает различные типы шага расчета, ​ включая непрерывный, ​ дискретный, ​ и Наследованный. Однако ​ общая co-симуляция FMUs поддерживают только периодические дискретные шаги расчета без смещения (такие как положительная скалярная величина).

Зависимости

Этот параметр применим только в режиме Co-Simulation.

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

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

Чтобы включить отображение логгирования отладки FMU, установите этот флажок. В противном случае снимите этот флажок.

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

Параметры блоков: FMUDebugLogging
Ввод: 1xN массив ячеек из символьных векторов
Значения: на | прочь
Значение по умолчанию: 'off'

Отфильтруйте журналы отладки типом, заданным путем устанавливания этих флажков:

  • OK

  • Warning

  • Discard

  • Error

  • Fatal

  • Pending

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

Параметры блоков: FMUDebugLoggingFilter
Ввод: символьный вектор
Значения: OK | Warning | Discard | Error | Fatal | Pending
Значение по умолчанию: 'OK' | 'Warning' | 'Discard' | 'Error' | 'Fatal' | 'Pending'

Прямая отладка регистрирует в виде:

  • File — Поток к slprj/_fmu/_logs_modelname/modelname_FMUblockname.txt​.

  • Display — Поток к командному окну MATLAB.

Зависимости

Установка этого параметра на File включает ссылку Open FMU Log File....

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

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

Входной параметр

Эта вкладка перечисляет входные переменные, заданные в modelDescription.xml FMU.

Задайте переменную для структурированного входного порта.

Чтобы отфильтровать переменную по наименованию, введите имя переменной в текстовом поле.

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

  • Имя — Имя переменной. Это не доступно для редактирования.

  • Видимость — Устанавливает этот флажок, чтобы включить входной порт на блоке для переменной. Снимите этот флажок, чтобы удалить порт.

    Установка этого флажка в узле верхнего уровня делает дочерние узлы видимыми как один порт для блока.

    Примечание

    Когда вы нажимаете Apply, количество изменения портов блока. Не забудьте добавлять или удалять связи соответственно.

  • Запустите — Добавляет значение запуска, заданное в modelDescription.xml. Вы не можете:

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

    • Добавьте запускают значения к узлам, не являющимся листом. (Можно отредактировать, запускают значения только для вершин.)

  • Соедините шиной имя объекта — Набор переменная объекта шины, которая соответствует порту. По умолчанию переменная использует структурированное имя переменной, заданное в modelDescription.xml. Чтобы создать новую переменную в рабочей области, использовать fmudialog.createBusType.

Изменение любых значений переменных включает кнопку Restore output to default settings, которую можно нажать, чтобы восстановить исходные настройки.

Вывод

Эта вкладка перечисляет выходные переменные, заданные в modelDescription.xml FMU.

Задайте переменную для структурированного выходного порта.

Чтобы отфильтровать переменную по наименованию, введите имя переменной в текстовом поле.

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

  • Имя — Имя переменной. Это не доступно для редактирования.

  • Видимость — Устанавливает этот флажок, чтобы включить выходной порт на блоке для переменной. Снимите этот флажок, чтобы удалить порт. Если внутренние переменные существуют в этом FMU, можно включить или отключить видимость для отдельных внутренних переменных. Если внутренняя переменная выбрана, она создает дополнительный выходной порт.

    Установка этого флажка в узле верхнего уровня делает дочерние узлы видимыми как один порт для блока.

    Примечание

    Когда вы нажимаете Apply, количество изменения портов блока. Не забудьте добавлять или удалять связи соответственно.

  • Запустите — Добавляет значение запуска, заданное в modelDescription.xml. Вы не можете изменить или добавить значение запуска для выходной переменной.

  • Соедините шиной имя объекта — Набор переменная объекта шины, которая соответствует порту. По умолчанию переменная использует структурированное имя переменной, заданное в modelDescription.xml. Чтобы создать новую переменную в рабочей области, использовать fmudialog.createBusType.

Изменение любых значений переменных включает кнопку Restore output to default settings, которую можно нажать, чтобы восстановить исходные настройки.

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

Типы данных

string

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

no

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

no

Введенный в R2017b