MATLAB System

Включите Системный объект в модель

Библиотека:
Simulink/Пользовательские функции
HDL-кодер/пользовательские функции

Описание

Блок MATLAB System приносит существующие Системные объекты (на основе matlab.System) в Simulink^®. Это также позволяет вам использовать системный объект APIs для разработки новых блоков для Simulink. Для получения дополнительной информации об этом блоке см. MATLAB System Block.

Для интерпретированного выполнения модель моделирует блок с помощью MATLAB^® механизм выполнения.

Для генерации кода модель моделирует блок с помощью генерации кода (используя подмножество кода MATLAB, поддерживаемое для генерации кода). Блок MATLAB System поддерживает только подмножество функций, доступных в MATLAB. Полный список функций см. в разделе Функции и объекты, поддерживаемые для генерации кода C/C + +. Эти функции включают функции, относящиеся к общим категориям, таким как:

Массив и Матричные операции, например plus, minus, и power
Матричные операции, например size и length
Расширенные матричные операции, например lu, inv, svd, и chol
Тригонометрические функции, такие как sin, cos, sinh, и cosh

Системные объекты

Чтобы использовать блок MATLAB System, вы должны сначала иметь новую Системную object™ или использовать существующую. Для получения дополнительной информации см. «Интеграция системных объектов с помощью MATLAB System Block».

Порты

Вход

расширить все

`In` - Вход сигнала в блок MATLAB System
скаляр | вектор | матрица

Блок MATLAB System принимает входы типов, перечисленных в таблице Характеристики блоков. Он не поддерживает виртуальные шины в качестве входных или выходных. Он не поддерживает невиртуальные шины, которые содержат сигналы переменного размера. Для получения дополнительной информации см. «Типы данных, поддерживаемые Simulink».

Для получения информации о поддержке с фиксированной точкой для этого блока, смотрите Ускорение кода и Генерация кода из MATLAB (Fixed-Point Designer).

Блок MATLAB System поддерживает системы координат Simulink. Для получения дополнительной информации смотрите Концепции на основе выборок и фреймов (DSP System Toolbox).

Выход

расширить все

`Out` - Выход сигнала блока MATLAB System
скаляр | вектор | матрица

Выход сигнала блока MATLAB System , который возвращает Системный объект.

Параметры

расширить все

`System Object Name` - Имя системного объекта
массив ячеек (по умолчанию)

Укажите полное имя определяемого пользователем класса системного объекта без расширения файла. Эта запись учитывает регистр. Имя класса должно существовать в пути MATLAB.

Вы можете задать имя системного объекта одним из следующих способов:

Введите имя в текстовое поле.
Щелкните список стрелы прикрепленный к текстовому полю. Если действительные системные объекты существуют в текущей папке, имена отображаются в списке. Выберите системный объект из этого списка.
Перейдите к папке, содержащей допустимый системный объект. Если папка отсутствует в пути MATLAB, программа предлагает добавить ее.

Если необходимо создать системный объект, можно создать его из шаблона нажав New.

После сохранения системного объекта имя появляется в System object name текстовом поле.

Используйте полное имя определяемого пользователем имени класса системного объекта. Блок не принимает Переменного MATLAB, которую вы присвоили Системный объект имени класса.

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

Параметры блоков: System

Тип: Вектор символов

Значение: имя системного объекта

По умолчанию: ' '

`New` - Создайте системный объект из шаблона
`Basic` (по умолчанию) | `Advanced` | `Simulink Extension`

Выберите одну из опций для шаблона системного объекта.

Basic: Запускает РЕДАКТОР MATLAB и отображает шаблон для простого объекта System с помощью наименьшего количества методов системного объекта.
Advanced: Запускает РЕДАКТОР MATLAB и отображает шаблон для более расширенного системного объекта с помощью большинства методов системного объекта.
Simulink Extension: Запускает РЕДАКТОР MATLAB и отображает файл, содержащий утилиты для настройки блока для Simulink. Это тот же файл, что и в MATLAB, когда вы выбираете New > System Object > Simulink Extension.

После сохранения системного объекта в текстовое поле System object name можно ввести имя.

`Simulate using` - Выберите режим симуляции
`Code generation` (по умолчанию) | `Interpreted Execution`

Выберите режим симуляции.

Code generation

При первом запуске модели моделируйте и сгенерируйте код для MATLAB System блока, используя только функции MATLAB, поддерживаемые для генерации кода. Если структура блока не меняется, последующие запуски модели не регенерируют код.

Если режим симуляции Code generation, Системные Объекты принимают максимум 32 входы.

Interpreted execution

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

`Dependency` - Параметр зависимости для MATLAB System блока
auto (по умолчанию)

После того, как вы присвоите допустимое имя класса системного объекта блоку, при следующем открытии диалогового окна блока параметр будет виден. Этот параметр появляется для каждого блока MATLAB System. Вы не можете удалить его.

Если блок не имеет вкладок, этот параметр появляется в нижней части диалогового окна.
Если блок имеет несколько вкладок, этот параметр появляется в нижней части первой вкладки диалогового окна.

`Saturate on integer overflow` - Укажите, насыщаются ли переполнения
Off (по умолчанию) | On

На: Переполнения достигает минимального или максимального значения, которое может представлять тип данных. Для примера переполнение, сопоставленное с 8-битным целым числом со знаком, может насыщаться до -128 или 127.
Прочь: Переполнения переходят к соответствующему значению, которое может представлять тип данных. Для примера число 130 не помещается в 8-разрядное целое число со знаком и переносами к -126.

Совет

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

Зависимость

Этот флажок появляется при использовании showFiSettingsImpl метод в системном объекте.

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

Блочный параметр: SaturateOnIntegerOverflow

Тип: Вектор символов

Значения: 'off' | 'on'

По умолчанию: 'off'

`Treat these inherited Simulink signal types as fi objects` - Задайте типы данных fi
`Fixed-point` (по умолчанию) | `Fixed-point & Integer`

Выберите унаследованные типы данных для обработки типов данных fi,

Fixed-point: Обрабатывайте типы данных с фиксированной точкой как типы данных fi.
Fixed-point & Integer: Обрабатывайте типы данных с фиксированной и целочисленной точками как типы данных fi.

Зависимость

Этот флажок появляется при использовании showFiSettingsImpl метод в системном объекте.

`MATLAB System fimath` - Задайте параметры фиксированной точки, которые нужно использовать
Same as MATLAB (по умолчанию) | Specify Other

Выберите математические настройки с фиксированной точкой для использования.

Same as MATLAB: Используйте текущие настройки математики с фиксированной точкой MATLAB.
Specify Other: Включите поле редактирования для определения необходимых параметров математики с фиксированной точкой. Для получения информации об установке математики с фиксированной точкой см. fimath (Fixed-Point Designer).

Зависимость

Этот флажок появляется при использовании showFiSettingsImpl метод в системном объекте.

Примеры моделей

Specify Sample Time for MATLAB System Block System Objects

Задайте Шаг расчета для MATLAB System Block Системных объектов

Управляйте шагом расчета блока MATLAB System с помощью методов System object™.

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

Типы данных	`Булев^[a]` \| `шина^[b]^[a]` \| `double^[a]` \| `перечисленные^[a]` \| `фиксированную точку^[a]` \| `целое число^[a]` \| `сингл^[a]`
Прямое сквозное соединение	`no`
Многомерные сигналы	`ограниченный^[a]`
Сигналы переменного размера	`ограниченный^[c]^[a]`
Обнаружение пересечения нулем	`no`
^[a] Фактический тип данных или поддержка возможностей зависит от реализации блоков. ^[b] Смотрите Невиртуальные Шины и MATLAB System Block для получения дополнительной информации. ^[c] Смотрите Сигналы Переменного Размера для получения дополнительной информации.

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

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

Фактическая поддержка генерации кода зависит от реализации блока.

Генерация HDL-кода
Сгенерируйте Verilog и VHDL код для FPGA и ASIC проектов с использованием HDL- Coder™.

HDL Coder™ предоставляет дополнительные опции строения, которые влияют на реализацию HDL и синтезированную логику.

Можно задать системный объект и использовать его в блоке MATLAB System для генерации HDL-кода.

Поддержка настраиваемых параметров

HDL Coder поддерживает настраиваемые параметры со следующими типами данных:

Числовой
Фиксированная точка
Символ
Логичный

При использовании настраиваемых параметров с блоком MATLAB System настраиваемым параметром должен быть объект Simulink .Parameter с StorageClass установлено на ExportedGlobal.

x = Simulink.Parameter 
x.Value = 1 
x.CoderInfo.StorageClass = 'ExportedGlobal'

Для получения дополнительной информации смотрите Сгенерировать порты DUT для настраиваемых параметров (HDL Coder).

Архитектура HDL

Этот блок имеет одну архитектуру HDL по умолчанию.

Свойства блоков

Если вы используете предопределенный системный объект, доступные свойства HDL-блоков совпадают со свойствами, доступными для соответствующего блока.

По умолчанию доступны следующие свойства блоков.

ConstMultiplierOptimization	Canonical signed digit (CSD) или факторизованная оптимизация CSD. Значение по умолчанию является `none`. См. также ConstMultiplierOptimization (HDL Coder).
ConstrainedOutputPipeline	Количество регистров для размещения на выходах путем перемещения существующих задержек в рамках вашего проекта. Распределённая конвейеризация не перераспределяет эти регистры. Значение по умолчанию является `0`. Для получения дополнительной информации смотрите ConstrainedOutputPipeline (HDL Coder).
DistributedPipelining	Распределение регистров трубопроводов или синхронизация регистров. Значение по умолчанию является `off`. См. также DistributedPipelining (HDL Coder).
InputPipeline	Количество входных этапов конвейера для вставки в сгенерированный код. Распределённая конвейеризация и ограниченная выходная конвейеризация могут перемещать эти регистры. Значение по умолчанию является `0`. Для получения дополнительной информации смотрите InputPipeline (HDL Coder).
LoopOptimization	Разворачивайте, потокуйте или не оптимизируйте циклы. Значение по умолчанию является `none`. См. также LoopOptimization (HDL Coder).
MapPersistentVarsToRAM	Сопоставить постоянные массивы с ОЗУ. Значение по умолчанию является `off`. См. также MapPersistentVarsToRAM (HDL Coder).
OutputPipeline	Количество выходных этапов конвейера для вставки в сгенерированный код. Распределённая конвейеризация и ограниченная выходная конвейеризация могут перемещать эти регистры. Значение по умолчанию является `0`. Для получения дополнительной информации смотрите OutputPipeline (HDL Coder).
ResetType	Подавьте генерацию логики сброса. Значение по умолчанию является `default`, который генерирует логику сброса. См. также ResetType (HDL Coder).
SharingFactor	Количество функционально эквивалентных ресурсов для сопоставления с одним общим ресурсом. Значение по умолчанию 0. См. также раздел «Совместное использование ресурсов» (HDL Coder).
VariablesToPipeline	Предупреждение `VariablesToPipeline` не рекомендуется. Использовать `coder.hdl.pipeline` (HDL Coder). Вставьте регистр трубопровода в выходы указанного переменного MATLAB или переменных. Задайте список переменных в качестве вектора символов с пространствами, разделяющими переменные.

Ограничения

Подсистема DUT должна быть односкоростной.
Входы не могут иметь дискретных (постоянных или Inf) шаг расчета.
Следующие предопределенные System objects поддерживаются для генерации кода, когда вы используете их в блоке MATLAB System:
- hdl.RAM (HDL-кодер)
- comm.HDLCRCDetector (Communications Toolbox)
- comm.HDLCRCGenerator (Communications Toolbox)
- comm.HDLRSDecoder (Communications Toolbox)
- comm.HDLRSEncoder (Communications Toolbox)
- dsp.DCBlocker (DSP System Toolbox)
- dsp.HDLComplexToMagnitudeAngle (DSP System Toolbox)
- dsp.HDLFFT (DSP System Toolbox)
- dsp.HDLIFFT (DSP System Toolbox)
- dsp.HDLNCO (DSP System Toolbox)
Если вы используете пользовательский системный объект, он должен поддерживать генерацию HDL-кода. Для получения информации об определяемых пользователем System objects и требованиях к генерации HDL-кода смотрите HDL Code Generation for Системные Объекты (HDL Coder).

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

Фактическая поддержка типа данных зависит от реализации блоков.

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

MATLAB System