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®.

Чтобы задать имя 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, которую можно нажать, чтобы восстановить исходные настройки.

Введенный в R2017b