Receive

メッセージを受信

• 

ライブラリ:
Simulink / Messages & Events
SimEvents

Receive ブロックの代替構成:
Message Receive

説明

Receive ブロックは受信したメッセージからデータを抽出し、出力信号端子に書き出します。ブロックが実行されるときに新しいメッセージがない場合は、ブロックは [キューが空のときの値のソース] の値を使用します。Receive と Message Receive は同じブロックです。

• [最後の値をホールド] を選択すると最後のメッセージから読み取ったデータを保持します。

• [初期値を使用] を選択すると既定のデータを書き込みます。

例

メッセージの送受信のアニメーション化および理解

メッセージの送信、受信、可視化、およびアニメーション化とメッセージ データの表示。

• モデルを開く

Queue ブロックを使用したメッセージの管理

FIFO キュー、LIFO キュー、優先順位キューを使用したメッセージの並べ替えおよび格納とキューのポリシーの定義。

• モデルを開く

ソフトウェア コンポーネント間におけるメッセージ送受信インターフェイスの確立

メッセージ送受信インターフェイスの作成と C++ コード生成のためのコンポーネントの準備。

• モデルを開く

Simulink 関数によるメッセージ受信インターフェイスの接続

この例では、メッセージベースのシステムでデータの入手に実行を同期させる方法を説明します。イベントとアクションを使用してこの動作をモデル化する方法を示します。この例は、2 つのソフトウェア コンポーネントがメッセージを使用して通信する別の例、ソフトウェア コンポーネント間におけるメッセージ送受信インターフェイスの確立に基づいています。

• モデルを開く

端子

入力

Port_1 — 入力メッセージ

スカラー | ベクトル | 行列

メッセージの入力端子。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | enumerated | bus | fixed point

出力

Port_S — メッセージが受信されたかどうかを表示

スカラー

ブロックがメッセージを正常に受信した場合は 1 を、そうでない場合は 0 を出力します。

依存関係

この端子を有効にするには [受信ステータスの表示] というラベルのチェック ボックスをオンにします。

データ型: double

Port_1 — 出力信号

スカラー | ベクトル | 行列

信号の出力端子。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | enumerated | bus | fixed point

パラメーター

内部キューの使用 — 内部キューを使用するよう選択

オン (SimEvents^® の既定値) | オフ (Simulink^® の既定値)

メッセージの受信に内部キューを使用する場合は、このチェック ボックスをオンにします。

プログラムでの使用

ブロック パラメーター: UseInternalQueue

型: 文字ベクトル

値: 'on' | 'off'

既定の設定: 'on'

キューが満杯の場合は最も古い要素を上書き — キューの上書きポリシーの指定

オン (Simulink の既定値) | オフ (SimEvents の既定値)

このチェック ボックスの選択によって、2 つのキュー上書きポリシーの間での選択を行います。

• このチェック ボックスをオンにすると、キューが満杯の場合に受信メッセージが最も古いメッセージを上書きします。

• このチェック ボックスをオフにすると、キューが満杯の場合にブロックは新しいメッセージを受け取りません。

依存関係

このパラメーターは、[内部キューの使用] というラベルのチェック ボックスをオンにすると表示されます。

プログラムでの使用

ブロック パラメーター: QueueOverwriting

型: 文字ベクトル

値: 'on' | 'off'

既定の設定: 'on' (Simulink の場合) および 'off' (SimEvents の場合)

キューの長さ — メッセージ キューの長さを指定

16 (既定値) | scalar

メッセージ キューの容量を指定します。キューの長さは、1 から 2²⁶-1 までの正の整数として指定できます。

依存関係

このパラメーターは、[内部キューの使用] というラベルのチェック ボックスをオンにすると表示されます。

プログラムでの使用

ブロック パラメーター: QueueLength

型: 文字ベクトル

値: '16' | スカラー

既定の設定: '16'

キュー タイプ — メッセージ キューの並べ替えポリシーを指定

[FIFO] (既定値) | [LIFO] | [優先]

ブロックは 3 つのメッセージの並べ替えポリシーをサポートします。

• 先入れ先出し (FIFO) — ストレージ内の最も古いメッセージが最初に出ていく。

• 後入れ先出し (LIFO) — ストレージ内の最も新しいメッセージが最初に出ていく。

• 優先 — メッセージやエンティティは優先順位に基づいて並べ替えられる。

  優先順位キューは、[Overwrite the oldest element if queue is full] チェック ボックスがオフであるときのみ使用できます。

  メモ

  優先順位キューは非バスのスカラーのみを受け入れ、fixed point データ型はサポートしません。

依存関係

このパラメーターは、[内部キューの使用] というラベルのチェック ボックスをオンにすると表示されます。

プログラムでの使用

ブロック パラメーター: QueueType

型: 文字ベクトル

値: 'FIFO' | 'LIFO' | 'Priority'

既定の設定: 'FIFO'

優先順位 — メッセージ キューの優先順位の指定

Ascending (既定値) | Descending

優先順位に基づいてメッセージの並べ替えの方向を選択します。

• 昇順 — 小さい優先順位値をもつメッセージがキューの先頭に来ます。

• 降順 — 大きい優先順位値をもつメッセージがキューの先頭に来ます。

依存関係

このパラメーターは、ボックス [内部キューの使用] および [キュー タイプ] 、 [優先] というラベルのチェック ボックスがオンのときにのみ表示されます。

プログラムでの使用

ブロック パラメーター: PriorityOrder

型: 文字ベクトル

値: 'Ascending' | 'Descending'

既定の設定: 'Ascending'

受信ステータスの表示 — メッセージが受信されたかどうかを表示

off (既定値) | オン

メッセージが受信されたかどうかを表示するにはこのチェック ボックスをオンにします。このチェック ボックスがオンの場合、ブロックは、メッセージが正常に受信された場合には 1 を、そうでない場合は 0 を出力します。

プログラムでの使用

ブロック パラメーター: ShowQueueStatus

型: 文字ベクトル

値: 'on' | 'off'

既定の設定: 'off'

初期値 — 初期データ値の設定

[](unspecified) (既定値) | scalar | vector | matrix

最初のメッセージが到着する前のキューの初期データ値を入力します。既定の値 [](unspecified) は、データ型が double の 0 として取り扱われます。

このブロックを使用して非バーチャル バス信号を初期化するには、初期値を MATLAB^® 構造体として指定します。構造体を使用した非バーチャル バス信号の初期化についての詳細は、Specify Initial Conditions for Bus Elementsを参照してください。

プログラムでの使用

ブロック パラメーター: InitialValue

型: 文字ベクトル

値: '[]' | スカラー

既定の設定: '[]'

キューが空のときの値のソース — 空のキューの値のソース

Hold last value (既定値) | Use initial value

受信したメッセージ キューが空だったときに受け取る値を指定します。

• 最後の値をホールド (既定) — 最後のメッセージから読み取ったデータを保持します。

  まず、ブロックがメッセージの受信を試みて失敗した場合、ブロックは初期値を出力します。

• 初期値を使用 — 既定のデータを書き込みます。

依存関係

このパラメーターは、[内部キューの使用] というラベルのチェック ボックスをオンにすると表示されます。

プログラムでの使用

ブロック パラメーター: ValueSourceWhenQueueIsEmpty

型: 文字ベクトル

値: 'Hold last value' | 'Use initial value'

既定の設定: 'Hold last value'

サンプル時間 (継承は -1) — サンプルの時間間隔を指定します。

-1 (既定値) | scalar

サンプル時間を継承するには、このパラメーターを -1 に設定します。詳細については、サンプル時間の指定を参照してください。

プログラムでの使用

ブロック パラメーター: SampleTime

型: 文字ベクトル

値: '-1' | スカラー

既定の設定: '-1'

ブロックの特性

データ型	Boolean | bus | double | enumerated | fixed point | integer | single | string
直達	いいえ
多次元信号	はい
可変サイズの信号	いいえ
ゼロクロッシング検出	いいえ

代替構成

Message Receive — メッセージをキューに受信

Message Receive ブロックは [内部キューの使用] パラメーターを選択し、[キュー タイプ] を FIFO、[キューの長さ] を 16 に設定します。

ライブラリ:
Simulink / Messages & Events
SimEvents

拡張機能

C/C++ コード生成

Simulink® Coder™ を使用して C および C++ コードを生成します。

メッセージ キューを使用していてマルチタスクが有効になっているモデルのコードを生成する際、そのモデルがマルチタスク環境に展開される場合は同時実行タスクの動作を有効にします。そうでない場合、生成コードでデータ破損が発生する可能性があります。同時実行タスクの動作を有効にするにはAllow tasks to execute concurrently on targetを選択します。

メモ

Receive ブロックでは行優先のコード生成はサポートされません。

バージョン履歴

R2016a で導入

参考

Send (SimEvents)

トピック

• Simulink メッセージの概要