Receive, Message Receive

Получение сообщений

Библиотека:
Simulink/Сообщения и события
SimEvents

Описание

Блок Receive извлекает данные из полученных сообщений и записывает их в порт выходного сигнала. Если при выполнении блока нет новых сообщений, блок использует Value source when queue is empty значение. Receive и Message Receive блоки являются идентичными блоками.

Выберите Hold last value для хранения данных, считанных из последнего сообщения.
Выберите Use initial value для записи данных по умолчанию.

Порты

Вход

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

`Port_1` - Входное сообщение
скаляр | вектор | матрица

Порт входа для сообщения.

Выход

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

`Port_S` - Показать, было ли получено сообщение
скаляр

Выходы 1 если блок получает сообщение успешно, и 0 в противном случае.

Зависимости

Чтобы включить этот порт, установите флажок, помеченный Show receive status.

Типы данных: double

`Port_1` - Выходной сигнал
скаляр | вектор | матрица

Выходной порт для сигнала.

Параметры

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

`Use internal queue` - Выберите, чтобы использовать внутреннюю очередь
on (по умолчанию для SimEvents^®) | off (по умолчанию для Simulink^®)

Установите этот флажок, если для получения сообщений используется внутренняя очередь.

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

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

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

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

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

`Overwrite the oldest element if queue is full` - Задайте политику перезаписи очереди
on (по умолчанию для Simulink) | off (по умолчанию для SimEvents)

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

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

Зависимости

Этот параметр видим, когда вы выбираете прямоугольник, маркированный Use internal queue.

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

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

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

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

По умолчанию: 'on' (для Simulink) и 'off' (для SimEvents)

`Queue length` - Задайте длину очереди сообщений
`16` (по умолчанию) | `scalar`

Укажите пропускную способность очереди сообщений. Длина очереди может быть задана как положительное целое число между 1 и 2²⁶- 1 (оба включены).

Зависимости

Этот параметр видим, когда вы выбираете прямоугольник, маркированный Use internal queue.

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

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

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

Значения: '16' | скаляр

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

`Queue type` - Задайте политику сортировки очереди сообщений
`FIFO` (по умолчанию) | `LIFO` | `Priority`

Блок поддерживает три политики сортировки сообщений:

Первый в первом (FIFO) - Первое отправляется самое старое сообщение в хранилище.
Последний в первом (LIFO) - Первое отправляется новейшее сообщение в хранилище.
Priority - Сообщения или сущности сортируются в зависимости от их приоритета.
Очередь приоритетов может использоваться только при снятии флажка Overwrite the oldest element if queue is full.

Примечание
Очередь приоритетов принимает только скаляр без шины, и она не поддерживает fixed point тип данных.

Зависимости

Этот параметр видим, когда вы выбираете прямоугольник, маркированный Use internal queue.

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

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

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

Значения: 'FIFO' | 'LIFO' | 'Priority'

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

`Priority order` - Задайте приоритет очереди сообщений
`Ascending` (по умолчанию) | `Descending`

Выберите направление сортировки сообщений в зависимости от приоритета.

Ascending - Перед очередью появляются сообщения с меньшими значениями приоритета.
Descending - Перед очередью появляются сообщения с большими значениями приоритета.

Зависимости

Этот параметр видим, когда вы выбираете прямоугольник с метками Use internal queue и Queue type > Priority.

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

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

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

Значения: 'Ascending' | 'Descending'

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

`Show receive status` - Показать, было ли получено сообщение
`off` (по умолчанию) | на

Установите этот флажок, чтобы показать, было ли получено сообщение. Если этот флажок установлен, блоки выводятся 1 если оно успешно получает сообщение, и 0 в противном случае.

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

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

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

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

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

`Initial value` - Установите начальное значение данных
`[](unspecified)` (по умолчанию) | `scalar` | `vector` | `matrix`

Введите начальное значение данных для очереди до прибытия первого сообщения. Значение по умолчанию [](unspecified) рассматривается как 0 с типом данных double.

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

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

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

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

Значения: '[]' | скаляр

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

`Value source when queue is empty` - Источник значения для пустой очереди
`Hold last value` (по умолчанию) | `Use initial value`

Укажите значение, которое должно быть получено, когда очередь полученных сообщений пуста.

Hold last value (по умолчанию) - содержит данные, считанные из последнего сообщения.
Первоначально, если блок пытается получить сообщение и отказывает, он выводит начальное значение.
Use initial value - Записывает данные по умолчанию.

Зависимости

Этот параметр видим, когда вы выбираете прямоугольник, маркированный Use internal queue.

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

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

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

Значения: 'Hold last value' | 'Use initial value'

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

`Sample time (-1 for inherited)` - Задайте временной интервал между выборками
`-1` (по умолчанию) | `scalar`

Чтобы наследовать шаг расчета, установите этот параметр равным -1. Дополнительные сведения см. в разделе «Задание шага расчета».

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

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

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

Значения: '-1' | скаляр

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

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

Animate and Understand Sending and Receiving Messages

Анимируйте и осмыслите отправку и прием сообщений

Отправляйте, получайте и визуализируйте сообщения. В примере также показано, как использовать Данные Моделирования Inspector, Sequence Viewer, Animation и Storage Inspector, чтобы понять, как сообщения происходят в вашей модели.

Используйте блок очереди для управления сообщениями

Используйте блок Queue для хранения и постановки сообщений в очередь. Блок Queue позволяет вам задавать емкость памяти сообщений, политику перезаписи и политику сортировки во время переходов сообщений.

Establish Message Send and Receive Interfaces Between Software Components

Установление интерфейсов отправки и приема сообщений между компонентами программного обеспечения

Моделируйте коммуникацию на основе сообщений между программными компонентами, которые запускаются в различных приложениях. Пример также показывает, как подготовить компоненты модели для генерации кода С++.

Model a Message Receive Interface that Runs on Message Availability

Моделируйте интерфейс приема сообщений, который запускается при доступности сообщений

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

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

Типы данных	`Boolean` \| `bus` \| `double` \| `enumerated` \| `fixed point` \| `integer` \| `single` \| `string`
Прямое сквозное соединение	`no`
Многомерные сигналы	`yes`
Сигналы переменного размера	`no`
Обнаружение пересечения нулем	`no`

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

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

См. также

Send (SimEvents)

Темы

Обзор сообщений Simulink

Введенный в R2016a

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

Receive, Message Receive

Описание

Порты

Вход

Port_1 - Входное сообщение скаляр | вектор | матрица

Выход

Port_S - Показать, было ли получено сообщение скаляр

Зависимости

Port_1 - Выходной сигнал скаляр | вектор | матрица

Параметры

Use internal queue - Выберите, чтобы использовать внутреннюю очередь on (по умолчанию для SimEvents®) | off (по умолчанию для Simulink®)

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

Overwrite the oldest element if queue is full - Задайте политику перезаписи очереди on (по умолчанию для Simulink) | off (по умолчанию для SimEvents)

Зависимости

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

Queue length - Задайте длину очереди сообщений 16 (по умолчанию) | scalar

Зависимости

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

Queue type - Задайте политику сортировки очереди сообщений FIFO (по умолчанию) | LIFO | Priority

Зависимости

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

Priority order - Задайте приоритет очереди сообщений Ascending (по умолчанию) | Descending

Зависимости

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

Show receive status - Показать, было ли получено сообщение off (по умолчанию) | на

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

Initial value - Установите начальное значение данных [](unspecified) (по умолчанию) | scalar | vector | matrix

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

Value source when queue is empty - Источник значения для пустой очереди Hold last value (по умолчанию) | Use initial value

Зависимости

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

Sample time (-1 for inherited) - Задайте временной интервал между выборками -1 (по умолчанию) | scalar

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

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

Анимируйте и осмыслите отправку и прием сообщений

Используйте блок очереди для управления сообщениями

Установление интерфейсов отправки и приема сообщений между компонентами программного обеспечения

Моделируйте интерфейс приема сообщений, который запускается при доступности сообщений

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

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

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

См. также

Темы

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

Поддержка

`Port_1` - Входное сообщение
скаляр | вектор | матрица

`Port_S` - Показать, было ли получено сообщение
скаляр

`Port_1` - Выходной сигнал
скаляр | вектор | матрица

`Use internal queue` - Выберите, чтобы использовать внутреннюю очередь
on (по умолчанию для SimEvents^®) | off (по умолчанию для Simulink^®)

`Overwrite the oldest element if queue is full` - Задайте политику перезаписи очереди
on (по умолчанию для Simulink) | off (по умолчанию для SimEvents)

`Queue length` - Задайте длину очереди сообщений
`16` (по умолчанию) | `scalar`

`Queue type` - Задайте политику сортировки очереди сообщений
`FIFO` (по умолчанию) | `LIFO` | `Priority`

`Priority order` - Задайте приоритет очереди сообщений
`Ascending` (по умолчанию) | `Descending`

`Show receive status` - Показать, было ли получено сообщение
`off` (по умолчанию) | на

`Initial value` - Установите начальное значение данных
`[](unspecified)` (по умолчанию) | `scalar` | `vector` | `matrix`

`Value source when queue is empty` - Источник значения для пустой очереди
`Hold last value` (по умолчанию) | `Use initial value`

`Sample time (-1 for inherited)` - Задайте временной интервал между выборками
`-1` (по умолчанию) | `scalar`

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