I2C Controller Read

I2C 周辺デバイスまたは I2C 周辺デバイスレジスタからデータを読み取る

アドオンが必要: この機能には Embedded Coder Support Package for STMicroelectronics STM32 Processors アドオンが必要です。

ライブラリ:
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32F1xx Based Boards
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32F2xx Based Boards
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32F3xx Based Boards
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32F4xx Based Boards
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32F7xx Based Boards
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32G0xx Based Boards
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32G4xx Based Boards
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32H7xx Based Boards
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32L4xx Based Boards
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32L5xx Based Boards
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32U5xx Based Boards
Embedded Coder Support Package for STMicroelectronics STM32 Processors / STM32WBxx Based Boards
Simulink Coder Support Package for STMicroelectronics Nucleo Boards / Common

説明

I2C Controller Read ブロックは、ボードに接続された I2C 周辺デバイスからシリアルデータを読み取ります。このブロックを使用して、I2C 周辺デバイスの特定のレジスタからデータを読み取ることができます。I2C 通信の詳細については、I2C 通信のサポートを参照してください。

メモ

I2C Controller Read ブロックを含む Simulink^® モデルは、STM32 プロセッサベースのボード上で接続済み IO モードで実行できます。詳細については、Communicate with Hardware Using Connected IOを参照してください。

端子

出力

すべて展開する

Data — I2C 周辺デバイスからのデータ
ベクトル

この端子はボード上の I2C デバイスからベクトルデータを読み取ります。データのサイズは [データサイズ] パラメーターで指定した値になります。

Status — 読み取り操作のステータス
スカラー

この端子は各読み取り要求のステータスを次の表に記載されているとおりに出力します。

戻りステータスコード

ステータス	説明
`0`	SUCCESS
`1`	BUSY
`2`	ARBITRATION_LOST
`4`	NO_ACKNOWLEDGE
`8`	BUS_ERROR
`16`	BUS_NOT_IN_USE

依存関係

この端子を有効にするには、[出力エラーステータス] パラメーターを選択します。

データ型: uint8

パラメーター

すべて展開する

I2C module — データを読み取る I2C モジュール
`I2C1` (既定値) | `I2C2` | `I23C` | `...`

I2C 周辺デバイスからデータを読み取るボード上の I2C モジュールを指定します。

Peripheral byte order — I2C 周辺デバイスでサポートされているバイト順
`BigEndian` (既定値) | `LittleEndian`

2 バイトのバイト順のオプションは次のとおりです。

BigEndian - I2C バスで最上位バイトが最初に送信されます。
LittleEndian - I2C バスで最下位バイトが最初に送信されます。

Peripheral address via — I2C の周辺デバイスアドレスの取得元
`Dialog` (既定値) | `Inport`

I2C コントローラーの周辺デバイスアドレスの取得元を選択します。

Peripheral address — データを読み取る I2C レジスタ周辺デバイスアドレス
`10` (既定値) | `integer greater than or equal to 0`

データを読み取る I2C 周辺デバイスアドレスを指定します。このアドレスは 16 進数形式の hex2dec() で指定できます。たとえば、‘hex2dec(‘20’)’ のようになります。

Enable register access address mode — 特定の I2C 周辺デバイスレジスタから読み取るためのオプション
オン (既定値) | オフ

このパラメーターを選択すると、ブロックは [Peripheral register address] パラメーターで指定された I2C 周辺デバイスレジスタからデータを読み取ります。

このパラメーターをオフにすると、[Send no acknowledgment at the end of the transfer] パラメーターと [Remove stop bit at the end of data transfer (Repeated start)] パラメーターが表示されます。これらのパラメーターを使用して、要件に従って読み取り操作を変更できます。

Register address via — I2C の周辺デバイスレジスタアドレスの取得元
`Dialog` (既定値) | `Inport`

I2C コントローラーのレジスタアドレスの取得元を選択します。

依存関係

このパラメーターを有効にするには、[Enable register access address mode] パラメーターをオンにします。

Peripheral register address — データを読み取る I2C 周辺デバイスレジスタアドレス
`0` (既定値) | `integer between 0 and 255`

データを読み取る I2C レジスタアドレスを指定します。

このアドレスは、整数として指定するか、hex2dec() を使用して 16 進数形式で指定します。たとえば、‘hex2dec(‘20’)’ のようになります。

レジスタの読み取り/書き込みの詳細については、I2C レジスタの読み取り/書き込みを参照してください。

依存関係

このパラメーターを有効にするには、[Enable register access address mode] パラメーターをオンにします。

データ型 — I2C 周辺デバイスからのデータのデータ型
`uint8` (既定値) | `int8` | `int16` | `uint16` | `int32` | `uint32` | `single` | `double`

I2C 周辺デバイスから読み取るデータ型を選択します。

Data size (N) — I2C 周辺デバイスから読み取るデータサイズ
`1` (既定値) | `integer greater than or equal to 0`

選択したデータ型について I2C 周辺デバイスから読み取るデータサイズを指定します。

Remove stop bit at the end of data transfer (Repeated start) — データ転送の最後にストップビットを削除するためのオプション
オフ (既定値) | オン

このパラメーターをオフにすると、ブロックはストップコンディションを送信します。このコンディションは、ブロックによるデータ送信が終了し、他の任意の I2C コントローラーブロックで新しい読み取り/書き込み操作を開始できるように I2C バスが空いたことを示します。

このパラメーターを選択すると、ブロックは別のスタートコンディションとそれに続くアドレスおよび読み取り/書き込みビットを送信します。ブロックは任意の数のスタートコンディションを再帰的に送信します。このような繰り返しのスタートコンディションにより、バスをリリースせずに周辺デバイスへの書き込み操作が可能になります。操作中に他のコントローラーブロックによる割り込みは発生しません。

依存関係

このパラメーターを有効にするには、[Enable register access address mode] パラメーターをオフにします。

Send no acknowledgment at the end of the transfer — データ転送の最後に Not Acknowledge (応答なし) ビットを送信するためのオプション
オフ (既定値) | オン

このパラメーターを選択すると、I2C Controller Read ブロックは周辺デバイスに対して最終バイトで NACK (Not Acknowledge/応答なし) ビットを送信します。

周辺デバイスは NACK を受信すると、I2C コントローラーブロックからのストップコンディションを待機します。コントローラーブロックは、転送を中止するためのストップコンディション、または新しい転送を開始するための繰り返しのスタートコンディションのいずれかを生成します。

このパラメーターをオフにすると、I2C Controller Read ブロックは周辺デバイスに対してすべてのバイトの最後に ACK (Acknowledge/肯定応答) ビットを送信します。ACK は、I2C Controller Read ブロックで次のバイトを周辺デバイスから読み取る準備ができたことを示します。

依存関係

このパラメーターを有効にするには、[Enable register access address mode] パラメーターをオフにします。

出力エラーステータス — データ送信中にエラーステータスを表示するためのオプション
オフ (既定値) | オン

このパラメーターを選択すると、ブロックで出力端子が構成されます。ブロックの端子には Status というラベルが付けられ、ブロックの出力端子で書き込み操作のステータスが出力されることを示します。

ブロックはステータスを uint8 値として出力します。それぞれの値がデータ転送ステータスに対応します。

ステータスの値	ステータスの説明
`0`	`SUCCESS`
`1`	`BUSY`
`2`	`ARBITRATION_LOST`
`4`	`NO_ACKNOWLEDGE`
`8`	`I2C_BUS_ERROR`

サンプル時間 — I2C 周辺デバイスからデータを読み取る頻度
`-1` (既定値)

I2C Controller Read ブロックで I2C 周辺デバイスからデータを読み取る頻度を指定します。このパラメーターを -1 と指定すると、ブロックはモデル内のブロックのコンテキストに基づいてサンプル時間を継承します。

タイムアウト — 読み取り操作完了までの待ち時間を指定する
`0.001` (既定値)

Timeout は、読み取り操作が完了するまで待機する最大時間 (秒単位) になるように構成します。

拡張機能

すべて展開する

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

参考

I2C Controller Write

I2C Controller Read

説明

端子

出力

Data — I2C 周辺デバイスからのデータ ベクトル

Status — 読み取り操作のステータス スカラー

依存関係

パラメーター

I2C module — データを読み取る I2C モジュール I2C1 (既定値) | I2C2 | I23C | ...

Peripheral byte order — I2C 周辺デバイスでサポートされているバイト順 BigEndian (既定値) | LittleEndian

Peripheral address via — I2C の周辺デバイス アドレスの取得元 Dialog (既定値) | Inport

Peripheral address — データを読み取る I2C レジスタ周辺デバイス アドレス 10 (既定値) | integer greater than or equal to 0

Enable register access address mode — 特定の I2C 周辺デバイス レジスタから読み取るためのオプション オン (既定値) | オフ

Register address via — I2C の周辺デバイス レジスタ アドレスの取得元 Dialog (既定値) | Inport

依存関係

Peripheral register address — データを読み取る I2C 周辺デバイス レジスタ アドレス 0 (既定値) | integer between 0 and 255

依存関係

データ型 — I2C 周辺デバイスからのデータのデータ型 uint8 (既定値) | int8 | int16 | uint16 | int32 | uint32 | single | double

Data size (N) — I2C 周辺デバイスから読み取るデータ サイズ 1 (既定値) | integer greater than or equal to 0

Remove stop bit at the end of data transfer (Repeated start) — データ転送の最後にストップ ビットを削除するためのオプション オフ (既定値) | オン

依存関係

Send no acknowledgment at the end of the transfer — データ転送の最後に Not Acknowledge (応答なし) ビットを送信するためのオプション オフ (既定値) | オン

依存関係

出力エラー ステータス — データ送信中にエラー ステータスを表示するためのオプション オフ (既定値) | オン

サンプル時間 — I2C 周辺デバイスからデータを読み取る頻度 -1 (既定値)

タイムアウト — 読み取り操作完了までの待ち時間を指定する 0.001 (既定値)

拡張機能

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

参考

Data — I2C 周辺デバイスからのデータ
ベクトル

Status — 読み取り操作のステータス
スカラー

I2C module — データを読み取る I2C モジュール
`I2C1` (既定値) | `I2C2` | `I23C` | `...`

Peripheral byte order — I2C 周辺デバイスでサポートされているバイト順
`BigEndian` (既定値) | `LittleEndian`

Peripheral address via — I2C の周辺デバイスアドレスの取得元
`Dialog` (既定値) | `Inport`

Peripheral address — データを読み取る I2C レジスタ周辺デバイスアドレス
`10` (既定値) | `integer greater than or equal to 0`

Enable register access address mode — 特定の I2C 周辺デバイスレジスタから読み取るためのオプション
オン (既定値) | オフ

Register address via — I2C の周辺デバイスレジスタアドレスの取得元
`Dialog` (既定値) | `Inport`

Peripheral register address — データを読み取る I2C 周辺デバイスレジスタアドレス
`0` (既定値) | `integer between 0 and 255`

データ型 — I2C 周辺デバイスからのデータのデータ型
`uint8` (既定値) | `int8` | `int16` | `uint16` | `int32` | `uint32` | `single` | `double`

Data size (N) — I2C 周辺デバイスから読み取るデータサイズ
`1` (既定値) | `integer greater than or equal to 0`

Remove stop bit at the end of data transfer (Repeated start) — データ転送の最後にストップビットを削除するためのオプション
オフ (既定値) | オン

Send no acknowledgment at the end of the transfer — データ転送の最後に Not Acknowledge (応答なし) ビットを送信するためのオプション
オフ (既定値) | オン

出力エラーステータス — データ送信中にエラーステータスを表示するためのオプション
オフ (既定値) | オン

サンプル時間 — I2C 周辺デバイスからデータを読み取る頻度
`-1` (既定値)

タイムアウト — 読み取り操作完了までの待ち時間を指定する
`0.001` (既定値)

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