基本ライブラリ
デジタルIO
アナログIO
拡張IO
時間
数学
三角関数
乱数
ビットバイト操作
割り込み
シリアル通信
標準ライブラリ
Ethernet
Ethernetサーバー
Ethernetクライアント
サーボモーター
ステッピングモーター
キャラクタ液晶表示
EEPROM
SPI通信
I2C通信(Wire)
メモリカード
メモリカード(File操作)
画像処理
周期処理
時計(RTC)
ユーティリティ
I2C通信(Wire)
2線による通信を行うためのI2C通信ライブラリです。Wireと呼ばれることもあります。通信ラインにはプルアップ抵抗をつけてください。 チャネルは合計8本使用可能です。スレーブとしては動作できません。対応するチャネルとピン番号は以下の通りで、ピンマップでも確認できます。 使用する場合は、#include <wire.h>
を記述してください。
Wire: A5(SCL), A4(SDA)
Wire1: 0(SCL), 1(SDA)
Wire2: 7(SCL), 6(SDA)
Wire3: 26(SCL), 24(SDA)
Wire4: 5(SCL), 3(SDA)
Wire5: 8(SCL), 9(SDA)
Wire6: 11(SCL), 12(SDA)
Wire7: 60(SCL), 58(SDA)
begin
- 概要
- 初期化します。
- 文法
- Wire.begin()
- パラメータ
- なし
- 戻り値
- なし
requestFrom
- 概要
- 相手先に対して受信シーケンスを発行し、データを読み出す。
- 文法
- Wire.requestFrom(address, quantity)
Wire.requestFrom(address, quantity, stop) - パラメータ
- address: データ要求をするデバイスの7ビットアドレス
quantity: 要求するバイト数
stop : boolean。trueは要求後、バス要求までメッセージを停止。falseは通信を継続して、送信を継続。 - 戻り値
- スレーブデバイスから受信したバイト数。
beginTransmission
- 概要
- 該当アドレスのスレーブに対して通信を開始する。送るデータはwrite()でキューに入れ、endTransmission()でスレーブに送る。
- 文法
- Wire.beginTransmission(address)
- パラメータ
- address: 7ビットのアドレス。
- 戻り値
- なし
endTransmission
- 概要
- beginTransmission()で開始したスレーブデバイスに、write()で入れたキューのデータを送り、通信を完了する。
- 文法
- unsigned char Wire.endTransmission()
- パラメータ
- なし
- 戻り値
- 0: 成功
1: 送信バッファ溢れ
2: アドレス送信時にNACKを受信
3: データ送信時にNACKを受信
4: その他エラー
write
- 概要
- 送信バッファの末尾に文字列や、データを追加する。
- 文法
- Wire.write(value)
Wire.write(string)
Wire.write(data, length) - パラメータ
- value: 1バイトのデータ
string: 1バイトの文字列
data: 配列データ
length: 送るバイト数 - 戻り値
- 送信したバイト数。
available
- 概要
- 受信バッファ内にあるデータ数を調べる
- 文法
- Wire.available()
- パラメータ
- なし
- 戻り値
- データ数(バイト単位)
read
- 概要
- 受信バッファからデータを1バイト取り出す
- 文法
- Wire.read()
- パラメータ
- なし
- 戻り値
- 次に受信したデータ。
サンプルプログラム
アドレス2のスレーブデバイスからデータを受信。
#include <Arduino.h>
#include <Wire.h>
void setup()
{
Wire.begin(); // join i2c bus (address optional for master)
Serial.begin(9600); // start serial for output
}
void loop()
{
Wire.requestFrom(2, 6); // request 6 bytes from slave device #2
while(Wire.available()) // slave may send less than requested
{
char c = Wire.read(); // receive a byte as character
Serial.print(c); // print the character
}
delay(500);
}