Arduino IDE(EthernetUDP.available関数の使い方)

EthernetUDP.available関数

EthernetUDPクラス※1のUDP.available関数は、バッファから読み込み可能なバイト数（文字数）を取得します。

これは既に到着したデータです。

この関数は、UDP.parsePacket関数の後にのみ正常に呼び出すことができます。

available関数はStreamユーティリティー・クラスから継承します。

Arduino Leonardo EthernetはArduino Leonardo（ATmega32u4搭載）とArduino イーサネットシールド2をひとつに合わせたArduinoボードです。MACアドレスを書いたシールがボードに貼られています。このボードで開発をするためにはArduino IDE 1.7.2以降が必要です。（2015.04.30現在）PoE （Power over Ethernet）モジュールを追加すると、LANケーブル1本で電源供給と通信が可能です。IEEE802.3af の規格に準拠した環境下で動作します。

図1：Arduino Leonardo Ethernet

以下補足です

※1：EthernetUDPのクラスは、UDPメッセージの送受信が出来ます。

Arduino IDEで使用するUDP.available関数の使い方は以下の通りです。

例えば「Arduino Leonardo Ethernet」をPCにUSB接続し、またネットワークに接続されたLANケーブル接続して、ArduinoIDEの「ツール」→「ボード」→「Arduino Ethernet」を選択した状態にします。

最初にEthernetUDP関数でUDP経由でパケットを送受信できるようにするEthernetUDPインスタンスを作成します。

Ethernet.begin関数とUdp.begin関数でイーサネットとUDPを開始します。

Udp.parsePacket関数でUPDデータを読み込み、Udp.available関数でバッファから読み込み可能なバイト数が有る場合には、「"Received packet of size "」と共に受信したパケットサイズをシリアル出力します。

#include <SPI.h>

#include <Ethernet.h>
#include <EthernetUdp.h>
// 下のコントローラのMACアドレスとIPアドレスを入力します。
// IPアドレスはローカルネットワークに依存します：
byte mac[] = {0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
IPAddress ip(192, 168, 1, 177);
unsigned int localPort = 8888; // 待機するローカルポート
EthernetUDP Udp;// UDP経由でパケットを送受信できるようにするEthernetUDPインスタンス
char packetBuffer[UDP_TX_PACKET_MAX_SIZE]; //着信パケットを保持するバッファ

void setup() {
// イーサネットとUDPを開始します。
Ethernet.begin(mac,ip);
Udp.begin(localPort);}

void loop() {
int packetSize = Udp.parsePacket();
if(Udp.available()){

   Serial.print("Received packet of size ");
   Serial.println(packetSize);
   Serial.print("From ");
   IPAddress remote = Udp.remoteIP();
   for (int i =0; i < 4; i++){
     Serial.print(remote[i], DEC);
     if (i < 3){
       Serial.print(".");}}
   Serial.print(", port ");
   Serial.println(Udp.remotePort());
   Udp.read(packetBuffer,UDP_TX_PACKET_MAX_SIZE);// パケットをpacketBuffferに読み込む
   Serial.println("Contents:");
   Serial.println(packetBuffer);}}