MATLAB System

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

Библиотека:
Simulink / Пользовательские Функции
HDL Coder / Пользовательские Функции

Описание

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

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

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

Массив по сравнению Матричные операции, как plusминус, , и 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 и отображает шаблон для простого Системного объекта с помощью наименьшего количества методов Системного объекта.
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
автоматический (значение по умолчанию)

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

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

`Saturate on integer overflow` — Задайте, насыщает ли переполнение
Off (значение по умолчанию) | On

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

Советы

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

Зависимость

Этот флажок появляется, когда вы используете showFiSettingsImpl метод в Системном объекте.

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

Блокируйте Parameter: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 с помощью Системы object™ методы.

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

Типы данных	`^Boolean[a]` \| `^bus[][]b^a` \| `^double[a]` \| `^{enumerated[a]}` \| `^{fixed point[a]}` \| `^integer[a]` \| `^single[a]`
Прямое сквозное соединение	`no`
Многомерные сигналы	`^limited[a]`
Сигналы переменного размера	`^limited[][]c^a`
Обнаружение пересечения нулем	`no`
^[a] Фактическая поддержка типа данных или возможности зависит от реализации блока. ^[b] Смотрите Невиртуальные Шины и MATLAB System Block для получения дополнительной информации. ^[c] Смотрите Сигналы Переменного Размера для получения дополнительной информации.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ConstMultiplierOptimization	Каноническая цифра со знаком (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	Сопоставьте персистентные массивы с RAM. Значением по умолчанию является `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 Coder)
- 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-кода для Системных объектов (HDL Coder).

См. также Генерируют Код для Пользовательских Системных объектов (HDL Coder) и генерация HDL-кода для Системных объектов (HDL Coder).

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

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

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

MATLAB System