このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

I2C Controller Write

I2C 周辺デバイスまたは I2C 周辺デバイス レジスタにデータを書き込む

• 

ライブラリ:
Embedded Coder Support Package for STMicroelectronics Discovery Boards / STM32F769I-Discovery
Embedded Coder Support Package for STMicroelectronics Discovery Boards / STM32F746G-Discovery

説明

I2C Controller Write ブロックは、ボードに接続された I2C 周辺デバイスにデータを書き込みます。このブロックを使用して、I2C 周辺デバイスの特定のレジスタにデータを書き込むことができます。

I2C 通信の詳細については、I2C 通信のサポートを参照してください。

端子

入力

Data — I2C 周辺デバイスに書き込むデータ

スカラー | ベクトル

データ型: int8 | uint8 | int16 | uint16 | int32 | uint32 | single | double

出力

Status — 書き込み操作のステータス

スカラー

[出力エラー ステータス] パラメーターを選択すると、Status というラベルが付いた出力端子が使用可能になります。

この端子は書き込み操作が成功すると 0 を出力します。

データ型: uint8

パラメーター

I2C module — データを書き込む I2C モジュール

0 (既定値) | integer greater than or equal to 0

I2C 周辺デバイスにデータを書き込むボード上の I2C モジュールを指定します。

Peripheral address — データを書き込む I2C 周辺デバイス アドレス

hex2dec('48') (既定値)

データを書き込む I2C 周辺デバイス アドレスを指定します。I2C 周辺デバイス アドレスは 7 ビット アドレスです。

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

Peripheral byte order — I2C 周辺デバイスでサポートされているバイト順

BigEndian (既定値) | LittleEndian

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

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

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

Enable register access — 特定の I2C 周辺デバイス レジスタに書き込むためのオプション

オン (既定値) | オフ

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

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

Peripheral register address — データを書き込む I2C 周辺デバイス レジスタ アドレス

uint8(1) (既定値)

データを書き込む I2C 周辺デバイス レジスタ アドレスを指定します。

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

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

依存関係

このパラメーターは、[Enable register access] パラメーターを選択した場合にのみ表示されます。

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

オフ (既定値) | オン

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

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

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

依存関係

このパラメーターは、[Enable register access] パラメーターをオフにした場合にのみ表示されます。

Remove stop bit at the end of data transfer — データ転送の最後にストップ ビットを削除するためのオプション

オフ (既定値) | オン

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

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

依存関係

このパラメーターは、[Enable register access] パラメーターをオフにした場合にのみ表示されます。

出力エラー ステータス — データ送信中にエラー ステータスを表示するためのオプション

オフ (既定値) | オン

このパラメーターを選択すると、Status というラベルが付いた出力端子が使用可能になります。

この端子は書き込み操作が成功すると 0 を出力します。

バージョン履歴

R2018a で導入

参考

I2C Controller Read (Embedded Coder) | Workaround for Interrupt Workflow with Sensors