Moving all AVR specific libraries to hardware/avr

110 files changed, 18494 insertions, 0 deletions

diff --git a/libraries/EEPROM/EEPROM.cpp b/libraries/EEPROM/EEPROM.cpp
new file mode 100755
index 0000000..dfa1deb
--- /dev/null
+++ b/libraries/EEPROM/EEPROM.cpp
@@ -0,0 +1,50 @@
+/*
+  EEPROM.cpp - EEPROM library
+  Copyright (c) 2006 David A. Mellis.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+/******************************************************************************
+ * Includes
+ ******************************************************************************/
+
+#include <avr/eeprom.h>
+#include "Arduino.h"
+#include "EEPROM.h"
+
+/******************************************************************************
+ * Definitions
+ ******************************************************************************/
+
+/******************************************************************************
+ * Constructors
+ ******************************************************************************/
+
+/******************************************************************************
+ * User API
+ ******************************************************************************/
+
+uint8_t EEPROMClass::read(int address)
+{
+	return eeprom_read_byte((unsigned char *) address);
+}
+
+void EEPROMClass::write(int address, uint8_t value)
+{
+	eeprom_write_byte((unsigned char *) address, value);
+}
+
+EEPROMClass EEPROM;
diff --git a/libraries/EEPROM/EEPROM.h b/libraries/EEPROM/EEPROM.h
new file mode 100755
index 0000000..aa2b577
--- /dev/null
+++ b/libraries/EEPROM/EEPROM.h
@@ -0,0 +1,35 @@
+/*
+  EEPROM.h - EEPROM library
+  Copyright (c) 2006 David A. Mellis.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#ifndef EEPROM_h
+#define EEPROM_h
+
+#include <inttypes.h>
+
+class EEPROMClass
+{
+  public:
+    uint8_t read(int);
+    void write(int, uint8_t);
+};
+
+extern EEPROMClass EEPROM;
+
+#endif
+
diff --git a/libraries/EEPROM/examples/eeprom_clear/eeprom_clear.pde b/libraries/EEPROM/examples/eeprom_clear/eeprom_clear.pde
new file mode 100644
index 0000000..d1e29bd
--- /dev/null
+++ b/libraries/EEPROM/examples/eeprom_clear/eeprom_clear.pde
@@ -0,0 +1,23 @@
+/*
+ * EEPROM Clear
+ *
+ * Sets all of the bytes of the EEPROM to 0.
+ * This example code is in the public domain.
+
+ */
+
+#include <EEPROM.h>
+
+void setup()
+{
+  // write a 0 to all 512 bytes of the EEPROM
+  for (int i = 0; i < 512; i++)
+    EEPROM.write(i, 0);
+    
+  // turn the LED on when we're done
+  digitalWrite(13, HIGH);
+}
+
+void loop()
+{
+}
diff --git a/libraries/EEPROM/examples/eeprom_read/eeprom_read.pde b/libraries/EEPROM/examples/eeprom_read/eeprom_read.pde
new file mode 100644
index 0000000..88e3488
--- /dev/null
+++ b/libraries/EEPROM/examples/eeprom_read/eeprom_read.pde
@@ -0,0 +1,39 @@
+/*
+ * EEPROM Read
+ *
+ * Reads the value of each byte of the EEPROM and prints it 
+ * to the computer.
+ * This example code is in the public domain.
+ */
+
+#include <EEPROM.h>
+
+// start reading from the first byte (address 0) of the EEPROM
+int address = 0;
+byte value;
+
+void setup()
+{
+  Serial.begin(9600);
+}
+
+void loop()
+{
+  // read a byte from the current address of the EEPROM
+  value = EEPROM.read(address);
+  
+  Serial.print(address);
+  Serial.print("\t");
+  Serial.print(value, DEC);
+  Serial.println();
+  
+  // advance to the next address of the EEPROM
+  address = address + 1;
+  
+  // there are only 512 bytes of EEPROM, from 0 to 511, so if we're
+  // on address 512, wrap around to address 0
+  if (address == 512)
+    address = 0;
+    
+  delay(500);
+}
diff --git a/libraries/EEPROM/examples/eeprom_write/eeprom_write.pde b/libraries/EEPROM/examples/eeprom_write/eeprom_write.pde
new file mode 100644
index 0000000..ae7c57e
--- /dev/null
+++ b/libraries/EEPROM/examples/eeprom_write/eeprom_write.pde
@@ -0,0 +1,38 @@
+/*
+ * EEPROM Write
+ *
+ * Stores values read from analog input 0 into the EEPROM.
+ * These values will stay in the EEPROM when the board is
+ * turned off and may be retrieved later by another sketch.
+ */
+
+#include <EEPROM.h>
+
+// the current address in the EEPROM (i.e. which byte
+// we're going to write to next)
+int addr = 0;
+
+void setup()
+{
+}
+
+void loop()
+{
+  // need to divide by 4 because analog inputs range from
+  // 0 to 1023 and each byte of the EEPROM can only hold a
+  // value from 0 to 255.
+  int val = analogRead(0) / 4;
+  
+  // write the value to the appropriate byte of the EEPROM.
+  // these values will remain there when the board is
+  // turned off.
+  EEPROM.write(addr, val);
+  
+  // advance to the next address.  there are 512 bytes in 
+  // the EEPROM, so go back to 0 when we hit 512.
+  addr = addr + 1;
+  if (addr == 512)
+    addr = 0;
+  
+  delay(100);
+}
diff --git a/libraries/EEPROM/keywords.txt b/libraries/EEPROM/keywords.txt
new file mode 100644
index 0000000..d3218fe
--- /dev/null
+++ b/libraries/EEPROM/keywords.txt
@@ -0,0 +1,18 @@
+#######################################
+# Syntax Coloring Map For Ultrasound
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+EEPROM	KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+
+#######################################
+# Constants (LITERAL1)
+#######################################
+
diff --git a/libraries/Ethernet/Client.cpp b/libraries/Ethernet/Client.cpp
new file mode 100644
index 0000000..f146ac5
--- /dev/null
+++ b/libraries/Ethernet/Client.cpp
@@ -0,0 +1,164 @@
+#include "w5100.h"
+#include "socket.h"
+
+extern "C" {
+  #include "string.h"
+}
+
+#include "Arduino.h"
+
+#include "Ethernet.h"
+#include "Client.h"
+#include "Server.h"
+#include "Dns.h"
+
+uint16_t Client::_srcport = 1024;
+
+Client::Client() : _sock(MAX_SOCK_NUM) {
+}
+
+Client::Client(uint8_t sock) : _sock(sock) {
+}
+
+int Client::connect(const char* host, uint16_t port) {
+  // Look up the host first
+  int ret = 0;
+  DNSClient dns;
+  IPAddress remote_addr;
+
+  dns.begin(Ethernet.dnsServerIP());
+  ret = dns.getHostByName(host, remote_addr);
+  if (ret == 1) {
+    return connect(remote_addr, port);
+  } else {
+    return ret;
+  }
+}
+
+int Client::connect(IPAddress ip, uint16_t port) {
+  if (_sock != MAX_SOCK_NUM)
+    return 0;
+
+  for (int i = 0; i < MAX_SOCK_NUM; i++) {
+    uint8_t s = W5100.readSnSR(i);
+    if (s == SnSR::CLOSED || s == SnSR::FIN_WAIT) {
+      _sock = i;
+      break;
+    }
+  }
+
+  if (_sock == MAX_SOCK_NUM)
+    return 0;
+
+  _srcport++;
+  if (_srcport == 0) _srcport = 1024;
+  socket(_sock, SnMR::TCP, _srcport, 0);
+
+  if (!::connect(_sock, ip.raw_address(), port)) {
+    _sock = MAX_SOCK_NUM;
+    return 0;
+  }
+
+  while (status() != SnSR::ESTABLISHED) {
+    delay(1);
+    if (status() == SnSR::CLOSED) {
+      _sock = MAX_SOCK_NUM;
+      return 0;
+    }
+  }
+
+  return 1;
+}
+
+void Client::write(uint8_t b) {
+  if (_sock != MAX_SOCK_NUM)
+    send(_sock, &b, 1);
+}
+
+void Client::write(const char *str) {
+  if (_sock != MAX_SOCK_NUM)
+    send(_sock, (const uint8_t *)str, strlen(str));
+}
+
+void Client::write(const uint8_t *buf, size_t size) {
+  if (_sock != MAX_SOCK_NUM)
+    send(_sock, buf, size);
+}
+
+int Client::available() {
+  if (_sock != MAX_SOCK_NUM)
+    return W5100.getRXReceivedSize(_sock);
+  return 0;
+}
+
+int Client::read() {
+  uint8_t b;
+  if ( recv(_sock, &b, 1) > 0 )
+  {
+    // recv worked
+    return b;
+  }
+  else
+  {
+    // No data available
+    return -1;
+  }
+}
+
+int Client::read(uint8_t *buf, size_t size) {
+  return recv(_sock, buf, size);
+}
+
+int Client::peek() {
+  uint8_t b;
+  // Unlike recv, peek doesn't check to see if there's any data available, so we must
+  if (!available())
+    return -1;
+  ::peek(_sock, &b);
+  return b;
+}
+
+void Client::flush() {
+  while (available())
+    read();
+}
+
+void Client::stop() {
+  if (_sock == MAX_SOCK_NUM)
+    return;
+
+  // attempt to close the connection gracefully (send a FIN to other side)
+  disconnect(_sock);
+  unsigned long start = millis();
+
+  // wait a second for the connection to close
+  while (status() != SnSR::CLOSED && millis() - start < 1000)
+    delay(1);
+
+  // if it hasn't closed, close it forcefully
+  if (status() != SnSR::CLOSED)
+    close(_sock);
+
+  EthernetClass::_server_port[_sock] = 0;
+  _sock = MAX_SOCK_NUM;
+}
+
+uint8_t Client::connected() {
+  if (_sock == MAX_SOCK_NUM) return 0;
+  
+  uint8_t s = status();
+  return !(s == SnSR::LISTEN || s == SnSR::CLOSED || s == SnSR::FIN_WAIT ||
+    (s == SnSR::CLOSE_WAIT && !available()));
+}
+
+uint8_t Client::status() {
+  if (_sock == MAX_SOCK_NUM) return SnSR::CLOSED;
+  return W5100.readSnSR(_sock);
+}
+
+// the next function allows us to use the client returned by
+// Server::available() as the condition in an if-statement.
+
+Client::operator bool() {
+  return _sock != MAX_SOCK_NUM;
+}
diff --git a/libraries/Ethernet/Client.h b/libraries/Ethernet/Client.h
new file mode 100644
index 0000000..582f493
--- /dev/null
+++ b/libraries/Ethernet/Client.h
@@ -0,0 +1,34 @@
+#ifndef client_h
+#define client_h
+#include "Arduino.h"	
+#include "Print.h"
+
+class Client : public Stream {
+
+public:
+  Client();
+  Client(uint8_t sock);
+
+  uint8_t status();
+  int connect(IPAddress ip, uint16_t port);
+  int connect(const char *host, uint16_t port);
+  virtual void write(uint8_t);
+  virtual void write(const char *str);
+  virtual void write(const uint8_t *buf, size_t size);
+  virtual int available();
+  virtual int read();
+  virtual int read(uint8_t *buf, size_t size);
+  virtual int peek();
+  virtual void flush();
+  void stop();
+  uint8_t connected();
+  operator bool();
+
+  friend class Server;
+
+private:
+  static uint16_t _srcport;
+  uint8_t _sock;
+};
+
+#endif
diff --git a/libraries/Ethernet/Dhcp.cpp b/libraries/Ethernet/Dhcp.cpp
new file mode 100755
index 0000000..c20d2e6
--- /dev/null
+++ b/libraries/Ethernet/Dhcp.cpp
@@ -0,0 +1,341 @@
+// DHCP Library v0.3 - April 25, 2009

+// Author: Jordan Terrell - blog.jordanterrell.com

+

+#include "w5100.h"

+

+#include <string.h>

+#include <stdlib.h>

+#include "Dhcp.h"

+#include "Arduino.h"

+#include "util.h"

+

+int DhcpClass::beginWithDHCP(uint8_t *mac, unsigned long timeout, unsigned long responseTimeout)

+{

+    uint8_t dhcp_state = STATE_DHCP_START;

+    uint8_t messageType = 0;

+  

+    // zero out _dhcpMacAddr, _dhcpSubnetMask, _dhcpGatewayIp, _dhcpLocalIp, _dhcpDhcpServerIp, _dhcpDnsServerIp

+    memset(_dhcpMacAddr, 0, 26); 

+

+    memcpy((void*)_dhcpMacAddr, (void*)mac, 6);

+  

+    // Pick an initial transaction ID

+    _dhcpTransactionId = random(1UL, 2000UL);

+    _dhcpInitialTransactionId = _dhcpTransactionId;

+

+    if (_dhcpUdpSocket.begin(DHCP_CLIENT_PORT) == 0)

+    {

+      // Couldn't get a socket

+      return 0;

+    }

+    

+    presend_DHCP();

+    

+    int result = 0;

+    

+    unsigned long startTime = millis();

+    

+    while(dhcp_state != STATE_DHCP_LEASED)

+    {

+        if(dhcp_state == STATE_DHCP_START)

+        {

+            _dhcpTransactionId++;

+            

+            send_DHCP_MESSAGE(DHCP_DISCOVER, ((millis() - startTime) / 1000));

+            dhcp_state = STATE_DHCP_DISCOVER;

+        }

+        else if(dhcp_state == STATE_DHCP_DISCOVER)

+        {

+            uint32_t respId;

+            messageType = parseDHCPResponse(responseTimeout, respId);

+            if(messageType == DHCP_OFFER)

+            {

+                // We'll use the transaction ID that the offer came with,

+                // rather than the one we were up to

+                _dhcpTransactionId = respId;

+                send_DHCP_MESSAGE(DHCP_REQUEST, ((millis() - startTime) / 1000));

+                dhcp_state = STATE_DHCP_REQUEST;

+            }

+        }

+        else if(dhcp_state == STATE_DHCP_REQUEST)

+        {

+            uint32_t respId;

+            messageType = parseDHCPResponse(responseTimeout, respId);

+            if(messageType == DHCP_ACK)

+            {

+                dhcp_state = STATE_DHCP_LEASED;

+                result = 1;

+            }

+            else if(messageType == DHCP_NAK)

+                dhcp_state = STATE_DHCP_START;

+        }

+        

+        if(messageType == 255)

+        {

+            messageType = 0;

+            dhcp_state = STATE_DHCP_START;

+        }

+        

+        if(result != 1 && ((millis() - startTime) > timeout))

+            break;

+    }

+    

+    // We're done with the socket now

+    _dhcpUdpSocket.stop();

+    _dhcpTransactionId++;

+    

+    return result;

+}

+

+void DhcpClass::presend_DHCP()

+{

+}

+

+void DhcpClass::send_DHCP_MESSAGE(uint8_t messageType, uint16_t secondsElapsed)

+{

+    uint8_t buffer[32];

+    memset(buffer, 0, 32);

+    IPAddress dest_addr( 255, 255, 255, 255 ); // Broadcast address

+

+    if (-1 == _dhcpUdpSocket.beginPacket(dest_addr, DHCP_SERVER_PORT))

+    {

+        // FIXME Need to return errors

+        return;

+    }

+

+    buffer[0] = DHCP_BOOTREQUEST;   // op

+    buffer[1] = DHCP_HTYPE10MB;     // htype

+    buffer[2] = DHCP_HLENETHERNET;  // hlen

+    buffer[3] = DHCP_HOPS;          // hops

+

+    // xid

+    unsigned long xid = htonl(_dhcpTransactionId);

+    memcpy(buffer + 4, &(xid), 4);

+

+    // 8, 9 - seconds elapsed

+    buffer[8] = ((secondsElapsed & 0xff00) >> 8);

+    buffer[9] = (secondsElapsed & 0x00ff);

+

+    // flags

+    unsigned short flags = htons(DHCP_FLAGSBROADCAST);

+    memcpy(buffer + 10, &(flags), 2);

+

+    // ciaddr: already zeroed

+    // yiaddr: already zeroed

+    // siaddr: already zeroed

+    // giaddr: already zeroed

+

+    //put data in W5100 transmit buffer

+    _dhcpUdpSocket.write(buffer, 28);

+

+    memset(buffer, 0, 32); // clear local buffer

+

+    memcpy(buffer, _dhcpMacAddr, 6); // chaddr

+

+    //put data in W5100 transmit buffer

+    _dhcpUdpSocket.write(buffer, 16);

+

+    memset(buffer, 0, 32); // clear local buffer

+

+    // leave zeroed out for sname && file

+    // put in W5100 transmit buffer x 6 (192 bytes)

+  

+    for(int i = 0; i < 6; i++) {

+        _dhcpUdpSocket.write(buffer, 32);

+    }

+  

+    // OPT - Magic Cookie

+    buffer[0] = (uint8_t)((MAGIC_COOKIE >> 24)& 0xFF);

+    buffer[1] = (uint8_t)((MAGIC_COOKIE >> 16)& 0xFF);

+    buffer[2] = (uint8_t)((MAGIC_COOKIE >> 8)& 0xFF);

+    buffer[3] = (uint8_t)(MAGIC_COOKIE& 0xFF);

+

+    // OPT - message type

+    buffer[4] = dhcpMessageType;

+    buffer[5] = 0x01;

+    buffer[6] = messageType; //DHCP_REQUEST;

+

+    // OPT - client identifier

+    buffer[7] = dhcpClientIdentifier;

+    buffer[8] = 0x07;

+    buffer[9] = 0x01;

+    memcpy(buffer + 10, _dhcpMacAddr, 6);

+

+    // OPT - host name

+    buffer[16] = hostName;

+    buffer[17] = strlen(HOST_NAME) + 3; // length of hostname + last 3 bytes of mac address

+    strcpy((char*)&(buffer[18]), HOST_NAME);

+

+    buffer[24] = _dhcpMacAddr[3];

+    buffer[25] = _dhcpMacAddr[4];

+    buffer[26] = _dhcpMacAddr[5];

+

+    //put data in W5100 transmit buffer

+    _dhcpUdpSocket.write(buffer, 27);

+

+    if(messageType == DHCP_REQUEST)

+    {

+        buffer[0] = dhcpRequestedIPaddr;

+        buffer[1] = 0x04;

+        buffer[2] = _dhcpLocalIp[0];

+        buffer[3] = _dhcpLocalIp[1];

+        buffer[4] = _dhcpLocalIp[2];

+        buffer[5] = _dhcpLocalIp[3];

+

+        buffer[6] = dhcpServerIdentifier;

+        buffer[7] = 0x04;

+        buffer[8] = _dhcpDhcpServerIp[0];

+        buffer[9] = _dhcpDhcpServerIp[1];

+        buffer[10] = _dhcpDhcpServerIp[2];

+        buffer[11] = _dhcpDhcpServerIp[3];

+

+        //put data in W5100 transmit buffer

+        _dhcpUdpSocket.write(buffer, 12);

+    }

+    

+    buffer[0] = dhcpParamRequest;

+    buffer[1] = 0x06;

+    buffer[2] = subnetMask;

+    buffer[3] = routersOnSubnet;

+    buffer[4] = dns;

+    buffer[5] = domainName;

+    buffer[6] = dhcpT1value;

+    buffer[7] = dhcpT2value;

+    buffer[8] = endOption;

+    

+    //put data in W5100 transmit buffer

+    _dhcpUdpSocket.write(buffer, 9);

+

+    _dhcpUdpSocket.endPacket();

+}

+

+uint8_t DhcpClass::parseDHCPResponse(unsigned long responseTimeout, uint32_t& transactionId)

+{

+    uint8_t type = 0;

+    uint8_t opt_len = 0;

+     

+    unsigned long startTime = millis();

+

+    while(_dhcpUdpSocket.parsePacket() <= 0)

+    {

+        if((millis() - startTime) > responseTimeout)

+        {

+            return 255;

+        }

+        delay(50);

+    }

+    // start reading in the packet

+    RIP_MSG_FIXED fixedMsg;

+    _dhcpUdpSocket.read((uint8_t*)&fixedMsg, sizeof(RIP_MSG_FIXED));

+  

+    if(fixedMsg.op == DHCP_BOOTREPLY && _dhcpUdpSocket.remotePort() == DHCP_SERVER_PORT)

+    {

+        transactionId = ntohl(fixedMsg.xid);

+        if(memcmp(fixedMsg.chaddr, _dhcpMacAddr, 6) != 0 || (transactionId < _dhcpInitialTransactionId) || (transactionId > _dhcpTransactionId))

+        {

+            // Need to read the rest of the packet here regardless

+            _dhcpUdpSocket.flush();

+            return 0;

+        }

+

+        memcpy(_dhcpLocalIp, fixedMsg.yiaddr, 4);

+

+        // Skip to the option part

+        // Doing this a byte at a time so we don't have to put a big buffer

+        // on the stack (as we don't have lots of memory lying around)

+        for (int i =0; i < (240 - sizeof(RIP_MSG_FIXED)); i++)

+        {

+            _dhcpUdpSocket.read(); // we don't care about the returned byte

+        }

+

+        while (_dhcpUdpSocket.available() > 0) 

+        {

+            switch (_dhcpUdpSocket.read()) 

+            {

+                case endOption :

+                    break;

+                    

+                case padOption :

+                    break;

+                

+                case dhcpMessageType :

+                    opt_len = _dhcpUdpSocket.read();

+                    type = _dhcpUdpSocket.read();

+                    break;

+                

+                case subnetMask :

+                    opt_len = _dhcpUdpSocket.read();

+                    _dhcpUdpSocket.read(_dhcpSubnetMask, 4);

+                    break;

+                

+                case routersOnSubnet :

+                    opt_len = _dhcpUdpSocket.read();

+                    _dhcpUdpSocket.read(_dhcpGatewayIp, 4);

+                    break;

+                

+                case dns :

+                    opt_len = _dhcpUdpSocket.read();

+                    _dhcpUdpSocket.read(_dhcpDnsServerIp, 4);

+                    break;

+                

+                case dhcpServerIdentifier :

+                    opt_len = _dhcpUdpSocket.read();

+                    if( *((uint32_t*)_dhcpDhcpServerIp) == 0 || 

+                        IPAddress(_dhcpDhcpServerIp) == _dhcpUdpSocket.remoteIP() )

+                    {

+                        _dhcpUdpSocket.read(_dhcpDhcpServerIp, sizeof(_dhcpDhcpServerIp));

+                    }

+                    else

+                    {

+                        // Skip over the rest of this option

+                        while (opt_len--)

+                        {

+                            _dhcpUdpSocket.read();

+                        }

+                    }

+                    break;

+                

+                case dhcpIPaddrLeaseTime :

+                default :

+                    opt_len = _dhcpUdpSocket.read();

+                    // Skip over the rest of this option

+                    while (opt_len--)

+                    {

+                        _dhcpUdpSocket.read();

+                    }

+                    break;

+            }

+        }

+    }

+

+    // Need to skip to end of the packet regardless here

+    _dhcpUdpSocket.flush();

+

+    return type;

+}

+

+IPAddress DhcpClass::getLocalIp()

+{

+    return IPAddress(_dhcpLocalIp);

+}

+

+IPAddress DhcpClass::getSubnetMask()

+{

+    return IPAddress(_dhcpSubnetMask);

+}

+

+IPAddress DhcpClass::getGatewayIp()

+{

+    return IPAddress(_dhcpGatewayIp);

+}

+

+IPAddress DhcpClass::getDhcpServerIp()

+{

+    return IPAddress(_dhcpDhcpServerIp);

+}

+

+IPAddress DhcpClass::getDnsServerIp()

+{

+    return IPAddress(_dhcpDnsServerIp);

+}

+

diff --git a/libraries/Ethernet/Dhcp.h b/libraries/Ethernet/Dhcp.h
new file mode 100755
index 0000000..c003494
--- /dev/null
+++ b/libraries/Ethernet/Dhcp.h
@@ -0,0 +1,158 @@
+// DHCP Library v0.3 - April 25, 2009

+// Author: Jordan Terrell - blog.jordanterrell.com

+

+#ifndef Dhcp_h

+#define Dhcp_h

+

+#include "Udp.h"

+

+/* DHCP state machine. */

+#define STATE_DHCP_START 0

+#define	STATE_DHCP_DISCOVER	1

+#define	STATE_DHCP_REQUEST	2

+#define	STATE_DHCP_LEASED	3

+#define	STATE_DHCP_REREQUEST	4

+#define	STATE_DHCP_RELEASE	5

+

+#define DHCP_FLAGSBROADCAST	0x8000

+

+/* UDP port numbers for DHCP */

+#define	DHCP_SERVER_PORT	67	/* from server to client */

+#define DHCP_CLIENT_PORT	68	/* from client to server */

+

+/* DHCP message OP code */

+#define DHCP_BOOTREQUEST	1

+#define DHCP_BOOTREPLY		2

+

+/* DHCP message type */

+#define	DHCP_DISCOVER		1

+#define DHCP_OFFER		  2

+#define	DHCP_REQUEST		3

+#define	DHCP_DECLINE		4

+#define	DHCP_ACK		    5

+#define DHCP_NAK		    6

+#define	DHCP_RELEASE		7

+#define DHCP_INFORM		  8

+

+#define DHCP_HTYPE10MB		1

+#define DHCP_HTYPE100MB		2

+

+#define DHCP_HLENETHERNET	6

+#define DHCP_HOPS		0

+#define DHCP_SECS		0

+

+#define MAGIC_COOKIE		0x63825363

+#define MAX_DHCP_OPT	16

+

+#define HOST_NAME "WIZnet"

+

+enum

+{

+	padOption		=	0,

+	subnetMask		=	1,

+	timerOffset		=	2,

+	routersOnSubnet		=	3,

+	/* timeServer		=	4,

+	nameServer		=	5,*/

+	dns			=	6,

+	/*logServer		=	7,

+	cookieServer		=	8,

+	lprServer		=	9,

+	impressServer		=	10,

+	resourceLocationServer	=	11,*/

+	hostName		=	12,

+	/*bootFileSize		=	13,

+	meritDumpFile		=	14,*/

+	domainName		=	15,

+	/*swapServer		=	16,

+	rootPath		=	17,

+	extentionsPath		=	18,

+	IPforwarding		=	19,

+	nonLocalSourceRouting	=	20,

+	policyFilter		=	21,

+	maxDgramReasmSize	=	22,

+	defaultIPTTL		=	23,

+	pathMTUagingTimeout	=	24,

+	pathMTUplateauTable	=	25,

+	ifMTU			=	26,

+	allSubnetsLocal		=	27,

+	broadcastAddr		=	28,

+	performMaskDiscovery	=	29,

+	maskSupplier		=	30,

+	performRouterDiscovery	=	31,

+	routerSolicitationAddr	=	32,

+	staticRoute		=	33,

+	trailerEncapsulation	=	34,

+	arpCacheTimeout		=	35,

+	ethernetEncapsulation	=	36,

+	tcpDefaultTTL		=	37,

+	tcpKeepaliveInterval	=	38,

+	tcpKeepaliveGarbage	=	39,

+	nisDomainName		=	40,

+	nisServers		=	41,

+	ntpServers		=	42,

+	vendorSpecificInfo	=	43,

+	netBIOSnameServer	=	44,

+	netBIOSdgramDistServer	=	45,

+	netBIOSnodeType		=	46,

+	netBIOSscope		=	47,

+	xFontServer		=	48,

+	xDisplayManager		=	49,*/

+	dhcpRequestedIPaddr	=	50,

+	dhcpIPaddrLeaseTime	=	51,

+	/*dhcpOptionOverload	=	52,*/

+	dhcpMessageType		=	53,

+	dhcpServerIdentifier	=	54,

+	dhcpParamRequest	=	55,

+	/*dhcpMsg			=	56,

+	dhcpMaxMsgSize		=	57,*/

+	dhcpT1value		=	58,

+	dhcpT2value		=	59,

+	/*dhcpClassIdentifier	=	60,*/

+	dhcpClientIdentifier	=	61,

+	endOption		=	255

+};

+

+typedef struct _RIP_MSG_FIXED

+{

+	uint8_t  op; 

+	uint8_t  htype; 

+	uint8_t  hlen;

+	uint8_t  hops;

+	uint32_t xid;

+	uint16_t secs;

+	uint16_t flags;

+	uint8_t  ciaddr[4];

+	uint8_t  yiaddr[4];

+	uint8_t  siaddr[4];

+	uint8_t  giaddr[4];

+	uint8_t  chaddr[6];

+}RIP_MSG_FIXED;

+

+class DhcpClass {

+private:

+  uint32_t _dhcpInitialTransactionId;

+  uint32_t _dhcpTransactionId;

+  uint8_t  _dhcpMacAddr[6];

+  uint8_t  _dhcpLocalIp[4];

+  uint8_t  _dhcpSubnetMask[4];

+  uint8_t  _dhcpGatewayIp[4];

+  uint8_t  _dhcpDhcpServerIp[4];

+  uint8_t  _dhcpDnsServerIp[4];

+  UDP _dhcpUdpSocket;

+  

+  void presend_DHCP();

+  void send_DHCP_MESSAGE(uint8_t, uint16_t);

+  

+  uint8_t parseDHCPResponse(unsigned long responseTimeout, uint32_t& transactionId);

+public:

+  IPAddress getLocalIp();

+  IPAddress getSubnetMask();

+  IPAddress getGatewayIp();

+  IPAddress getDhcpServerIp();

+  IPAddress getDnsServerIp();

+  

+  int beginWithDHCP(uint8_t *, unsigned long timeout = 60000, unsigned long responseTimeout = 4000);

+};

+

+#endif

diff --git a/libraries/Ethernet/Dns.cpp b/libraries/Ethernet/Dns.cpp
new file mode 100644
index 0000000..a049c76
--- /dev/null
+++ b/libraries/Ethernet/Dns.cpp
@@ -0,0 +1,423 @@
+// Arduino DNS client for WizNet5100-based Ethernet shield
+// (c) Copyright 2009-2010 MCQN Ltd.
+// Released under Apache License, version 2.0
+
+#include "w5100.h"
+#include "Udp.h"
+#include "util.h"
+
+#include "Dns.h"
+#include <string.h>
+//#include <stdlib.h>
+#include "Arduino.h"
+
+
+#define SOCKET_NONE	255
+// Various flags and header field values for a DNS message
+#define UDP_HEADER_SIZE	8
+#define DNS_HEADER_SIZE	12
+#define TTL_SIZE        4
+#define QUERY_FLAG               (0)
+#define RESPONSE_FLAG            (1<<15)
+#define QUERY_RESPONSE_MASK      (1<<15)
+#define OPCODE_STANDARD_QUERY    (0)
+#define OPCODE_INVERSE_QUERY     (1<<11)
+#define OPCODE_STATUS_REQUEST    (2<<11)
+#define OPCODE_MASK              (15<<11)
+#define AUTHORITATIVE_FLAG       (1<<10)
+#define TRUNCATION_FLAG          (1<<9)
+#define RECURSION_DESIRED_FLAG   (1<<8)
+#define RECURSION_AVAILABLE_FLAG (1<<7)
+#define RESP_NO_ERROR            (0)
+#define RESP_FORMAT_ERROR        (1)
+#define RESP_SERVER_FAILURE      (2)
+#define RESP_NAME_ERROR          (3)
+#define RESP_NOT_IMPLEMENTED     (4)
+#define RESP_REFUSED             (5)
+#define RESP_MASK                (15)
+#define TYPE_A                   (0x0001)
+#define CLASS_IN                 (0x0001)
+#define LABEL_COMPRESSION_MASK   (0xC0)
+// Port number that DNS servers listen on
+#define DNS_PORT        53
+
+// Possible return codes from ProcessResponse
+#define SUCCESS          1
+#define TIMED_OUT        -1
+#define INVALID_SERVER   -2
+#define TRUNCATED        -3
+#define INVALID_RESPONSE -4
+
+void DNSClient::begin(const IPAddress& aDNSServer)
+{
+    iDNSServer = aDNSServer;
+    iRequestId = 0;
+}
+
+
+int DNSClient::inet_aton(const char* aIPAddrString, IPAddress& aResult)
+{
+    // See if we've been given a valid IP address
+    const char* p =aIPAddrString;
+    while (*p &&
+           ( (*p == '.') || (*p >= '0') || (*p <= '9') ))
+    {
+        p++;
+    }
+
+    if (*p == '\0')
+    {
+        // It's looking promising, we haven't found any invalid characters
+        p = aIPAddrString;
+        int segment =0;
+        int segmentValue =0;
+        while (*p && (segment < 4))
+        {
+            if (*p == '.')
+            {
+                // We've reached the end of a segment
+                if (segmentValue > 255)
+                {
+                    // You can't have IP address segments that don't fit in a byte
+                    return 0;
+                }
+                else
+                {
+                    aResult[segment] = (byte)segmentValue;
+                    segment++;
+                    segmentValue = 0;
+                }
+            }
+            else
+            {
+                // Next digit
+                segmentValue = (segmentValue*10)+(*p - '0');
+            }
+            p++;
+        }
+        // We've reached the end of address, but there'll still be the last
+        // segment to deal with
+        if ((segmentValue > 255) || (segment > 3))
+        {
+            // You can't have IP address segments that don't fit in a byte,
+            // or more than four segments
+            return 0;
+        }
+        else
+        {
+            aResult[segment] = (byte)segmentValue;
+            return 1;
+        }
+    }
+    else
+    {
+        return 0;
+    }
+}
+
+int DNSClient::getHostByName(const char* aHostname, IPAddress& aResult)
+{
+    int ret =0;
+
+    // See if it's a numeric IP address
+    if (inet_aton(aHostname, aResult))
+    {
+        // It is, our work here is done
+        return 1;
+    }
+
+    // Check we've got a valid DNS server to use
+    if (iDNSServer == INADDR_NONE)
+    {
+        return INVALID_SERVER;
+    }
+	
+    // Find a socket to use
+    if (iUdp.begin(1024+(millis() & 0xF)) == 1)
+    {
+        // Try up to three times
+        int retries = 0;
+//        while ((retries < 3) && (ret <= 0))
+        {
+            // Send DNS request
+            ret = iUdp.beginPacket(iDNSServer, DNS_PORT);
+            if (ret != 0)
+            {
+                // Now output the request data
+                ret = BuildRequest(aHostname);
+                if (ret != 0)
+                {
+                    // And finally send the request
+                    ret = iUdp.endPacket();
+                    if (ret != 0)
+                    {
+                        // Now wait for a response
+                        int wait_retries = 0;
+                        ret = TIMED_OUT;
+                        while ((wait_retries < 3) && (ret == TIMED_OUT))
+                        {
+                            ret = ProcessResponse(5000, aResult);
+                            wait_retries++;
+                        }
+                    }
+                }
+            }
+            retries++;
+        }
+
+        // We're done with the socket now
+        iUdp.stop();
+    }
+
+    return ret;
+}
+
+uint16_t DNSClient::BuildRequest(const char* aName)
+{
+    // Build header
+    //                                    1  1  1  1  1  1
+    //      0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
+    //    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+    //    |                      ID                       |
+    //    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+    //    |QR|   Opcode  |AA|TC|RD|RA|   Z    |   RCODE   |
+    //    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+    //    |                    QDCOUNT                    |
+    //    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+    //    |                    ANCOUNT                    |
+    //    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+    //    |                    NSCOUNT                    |
+    //    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+    //    |                    ARCOUNT                    |
+    //    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+    // As we only support one request at a time at present, we can simplify
+    // some of this header
+    iRequestId = millis(); // generate a random ID
+    uint16_t twoByteBuffer;
+
+    // FIXME We should also check that there's enough space available to write to, rather
+    // FIXME than assume there's enough space (as the code does at present)
+    iUdp.write((uint8_t*)&iRequestId, sizeof(iRequestId));
+
+    twoByteBuffer = htons(QUERY_FLAG | OPCODE_STANDARD_QUERY | RECURSION_DESIRED_FLAG);
+    iUdp.write((uint8_t*)&twoByteBuffer, sizeof(twoByteBuffer));
+
+    twoByteBuffer = htons(1);  // One question record
+    iUdp.write((uint8_t*)&twoByteBuffer, sizeof(twoByteBuffer));
+
+    twoByteBuffer = 0;  // Zero answer records
+    iUdp.write((uint8_t*)&twoByteBuffer, sizeof(twoByteBuffer));
+
+    iUdp.write((uint8_t*)&twoByteBuffer, sizeof(twoByteBuffer));
+    // and zero additional records
+    iUdp.write((uint8_t*)&twoByteBuffer, sizeof(twoByteBuffer));
+
+    // Build question
+    const char* start =aName;
+    const char* end =start;
+    uint8_t len;
+    // Run through the name being requested
+    while (*end)
+    {
+        // Find out how long this section of the name is
+        end = start;
+        while (*end && (*end != '.') )
+        {
+            end++;
+        }
+
+        if (end-start > 0)
+        {
+            // Write out the size of this section
+            len = end-start;
+            iUdp.write(&len, sizeof(len));
+            // And then write out the section
+            iUdp.write((uint8_t*)start, end-start);
+        }
+        start = end+1;
+    }
+
+    // We've got to the end of the question name, so
+    // terminate it with a zero-length section
+    len = 0;
+    iUdp.write(&len, sizeof(len));
+    // Finally the type and class of question
+    twoByteBuffer = htons(TYPE_A);
+    iUdp.write((uint8_t*)&twoByteBuffer, sizeof(twoByteBuffer));
+
+    twoByteBuffer = htons(CLASS_IN);  // Internet class of question
+    iUdp.write((uint8_t*)&twoByteBuffer, sizeof(twoByteBuffer));
+    // Success!  Everything buffered okay
+    return 1;
+}
+
+
+uint16_t DNSClient::ProcessResponse(int aTimeout, IPAddress& aAddress)
+{
+    uint32_t startTime = millis();
+
+    // Wait for a response packet
+    while(iUdp.parsePacket() <= 0)
+    {
+        if((millis() - startTime) > aTimeout)
+            return TIMED_OUT;
+        delay(50);
+    }
+
+    // We've had a reply!
+    // Read the UDP header
+    uint8_t header[DNS_HEADER_SIZE]; // Enough space to reuse for the DNS header
+    // Check that it's a response from the right server and the right port
+    if ( (iDNSServer != iUdp.remoteIP()) || 
+        (iUdp.remotePort() != DNS_PORT) )
+    {
+        // It's not from who we expected
+        return INVALID_SERVER;
+    }
+
+    // Read through the rest of the response
+    if (iUdp.available() < DNS_HEADER_SIZE)
+    {
+        return TRUNCATED;
+    }
+    iUdp.read(header, DNS_HEADER_SIZE);
+
+    uint16_t header_flags = htons(*((uint16_t*)&header[2]));
+    // Check that it's a response to this request
+    if ( ( iRequestId != (*((uint16_t*)&header[0])) ) ||
+        (header_flags & QUERY_RESPONSE_MASK != RESPONSE_FLAG) )
+    {
+        // Mark the entire packet as read
+        iUdp.flush();
+        return INVALID_RESPONSE;
+    }
+    // Check for any errors in the response (or in our request)
+    // although we don't do anything to get round these
+    if ( (header_flags & TRUNCATION_FLAG) || (header_flags & RESP_MASK) )
+    {
+        // Mark the entire packet as read
+        iUdp.flush();
+        return -5; //INVALID_RESPONSE;
+    }
+
+    // And make sure we've got (at least) one answer
+    uint16_t answerCount = htons(*((uint16_t*)&header[6]));
+    if (answerCount == 0 )
+    {
+        // Mark the entire packet as read
+        iUdp.flush();
+        return -6; //INVALID_RESPONSE;
+    }
+
+    // Skip over any questions
+    for (int i =0; i < htons(*((uint16_t*)&header[4])); i++)
+    {
+        // Skip over the name
+        uint8_t len;
+        do
+        {
+            iUdp.read(&len, sizeof(len));
+            if (len > 0)
+            {
+                // Don't need to actually read the data out for the string, just
+                // advance ptr to beyond it
+                while(len--)
+                {
+                    iUdp.read(); // we don't care about the returned byte
+                }
+            }
+        } while (len != 0);
+
+        // Now jump over the type and class
+        for (int i =0; i < 4; i++)
+        {
+            iUdp.read(); // we don't care about the returned byte
+        }
+    }
+
+    // Now we're up to the bit we're interested in, the answer
+    // There might be more than one answer (although we'll just use the first
+    // type A answer) and some authority and additional resource records but
+    // we're going to ignore all of them.
+
+    for (int i =0; i < answerCount; i++)
+    {
+        // Skip the name
+        uint8_t len;
+        do
+        {
+            iUdp.read(&len, sizeof(len));
+            if ((len & LABEL_COMPRESSION_MASK) == 0)
+            {
+                // It's just a normal label
+                if (len > 0)
+                {
+                    // And it's got a length
+                    // Don't need to actually read the data out for the string,
+                    // just advance ptr to beyond it
+                    while(len--)
+                    {
+                        iUdp.read(); // we don't care about the returned byte
+                    }
+                }
+            }
+            else
+            {
+                // This is a pointer to a somewhere else in the message for the
+                // rest of the name.  We don't care about the name, and RFC1035
+                // says that a name is either a sequence of labels ended with a
+                // 0 length octet or a pointer or a sequence of labels ending in
+                // a pointer.  Either way, when we get here we're at the end of
+                // the name
+                // Skip over the pointer
+                iUdp.read(); // we don't care about the returned byte
+                // And set len so that we drop out of the name loop
+                len = 0;
+            }
+        } while (len != 0);
+
+        // Check the type and class
+        uint16_t answerType;
+        uint16_t answerClass;
+        iUdp.read((uint8_t*)&answerType, sizeof(answerType));
+        iUdp.read((uint8_t*)&answerClass, sizeof(answerClass));
+
+        // Ignore the Time-To-Live as we don't do any caching
+        for (int i =0; i < TTL_SIZE; i++)
+        {
+            iUdp.read(); // we don't care about the returned byte
+        }
+
+        // And read out the length of this answer
+        // Don't need header_flags anymore, so we can reuse it here
+        iUdp.read((uint8_t*)&header_flags, sizeof(header_flags));
+
+        if ( (htons(answerType) == TYPE_A) && (htons(answerClass) == CLASS_IN) )
+        {
+            if (htons(header_flags) != 4)
+            {
+                // It's a weird size
+                // Mark the entire packet as read
+                iUdp.flush();
+                return -9;//INVALID_RESPONSE;
+            }
+            iUdp.read(aAddress.raw_address(), 4);
+            return SUCCESS;
+        }
+        else
+        {
+            // This isn't an answer type we're after, move onto the next one
+            for (int i =0; i < htons(header_flags); i++)
+            {
+                iUdp.read(); // we don't care about the returned byte
+            }
+        }
+    }
+
+    // Mark the entire packet as read
+    iUdp.flush();
+
+    // If we get here then we haven't found an answer
+    return -10;//INVALID_RESPONSE;
+}
+
diff --git a/libraries/Ethernet/Dns.h b/libraries/Ethernet/Dns.h
new file mode 100644
index 0000000..9582351
--- /dev/null
+++ b/libraries/Ethernet/Dns.h
@@ -0,0 +1,41 @@
+// Arduino DNS client for WizNet5100-based Ethernet shield

+// (c) Copyright 2009-2010 MCQN Ltd.

+// Released under Apache License, version 2.0

+

+#ifndef DNSClient_h

+#define DNSClient_h

+

+#include <Udp.h>

+

+class DNSClient

+{

+public:

+    // ctor

+    void begin(const IPAddress& aDNSServer);

+

+    /** Convert a numeric IP address string into a four-byte IP address.

+        @param aIPAddrString IP address to convert

+        @param aResult IPAddress structure to store the returned IP address

+        @result 1 if aIPAddrString was successfully converted to an IP address,

+                else error code

+    */

+    int inet_aton(const char *aIPAddrString, IPAddress& aResult);

+

+    /** Resolve the given hostname to an IP address.

+        @param aHostname Name to be resolved

+        @param aResult IPAddress structure to store the returned IP address

+        @result 1 if aIPAddrString was successfully converted to an IP address,

+                else error code

+    */

+    int getHostByName(const char* aHostname, IPAddress& aResult);

+

+protected:

+    uint16_t BuildRequest(const char* aName);

+    uint16_t ProcessResponse(int aTimeout, IPAddress& aAddress);

+

+    IPAddress iDNSServer;

+    uint16_t iRequestId;

+    UDP iUdp;

+};

+

+#endif

diff --git a/libraries/Ethernet/Ethernet.cpp b/libraries/Ethernet/Ethernet.cpp
new file mode 100644
index 0000000..937f5b4
--- /dev/null
+++ b/libraries/Ethernet/Ethernet.cpp
@@ -0,0 +1,85 @@
+#include "w5100.h"
+#include "Ethernet.h"
+#include "Dhcp.h"
+
+// XXX: don't make assumptions about the value of MAX_SOCK_NUM.
+uint8_t EthernetClass::_state[MAX_SOCK_NUM] = { 
+  0, 0, 0, 0 };
+uint16_t EthernetClass::_server_port[MAX_SOCK_NUM] = { 
+  0, 0, 0, 0 };
+
+int EthernetClass::begin(uint8_t *mac_address)
+{
+  DhcpClass dhcp;
+
+  // Initialise the basic info
+  W5100.init();
+  W5100.setMACAddress(mac_address);
+  W5100.setIPAddress(IPAddress(0,0,0,0).raw_address());
+
+  // Now try to get our config info from a DHCP server
+  int ret = dhcp.beginWithDHCP(mac_address);
+  if(ret == 1)
+  {
+    // We've successfully found a DHCP server and got our configuration info, so set things
+    // accordingly
+    W5100.setIPAddress(dhcp.getLocalIp().raw_address());
+    W5100.setGatewayIp(dhcp.getGatewayIp().raw_address());
+    W5100.setSubnetMask(dhcp.getSubnetMask().raw_address());
+    _dnsServerAddress = dhcp.getDnsServerIp();
+  }
+
+  return ret;
+}
+
+void EthernetClass::begin(uint8_t *mac_address, IPAddress local_ip)
+{
+  // Assume the gateway will be the machine on the same network as the local IP
+  // but with last octet being '1'
+  IPAddress gateway = local_ip;
+  gateway[3] = 1;
+  begin(mac_address, local_ip, gateway);
+}
+
+void EthernetClass::begin(uint8_t *mac_address, IPAddress local_ip, IPAddress gateway)
+{
+  IPAddress subnet(255, 255, 255, 0);
+  begin(mac_address, local_ip, gateway, subnet);
+}
+
+void EthernetClass::begin(uint8_t *mac, IPAddress local_ip, IPAddress gateway, IPAddress subnet)
+{
+  W5100.init();
+  W5100.setMACAddress(mac);
+  W5100.setIPAddress(local_ip._address);
+  W5100.setGatewayIp(gateway._address);
+  W5100.setSubnetMask(subnet._address);
+}
+
+IPAddress EthernetClass::localIP()
+{
+  IPAddress ret;
+  W5100.getIPAddress(ret.raw_address());
+  return ret;
+}
+
+IPAddress EthernetClass::subnetMask()
+{
+  IPAddress ret;
+  W5100.getSubnetMask(ret.raw_address());
+  return ret;
+}
+
+IPAddress EthernetClass::gatewayIP()
+{
+  IPAddress ret;
+  W5100.getGatewayIp(ret.raw_address());
+  return ret;
+}
+
+IPAddress EthernetClass::dnsServerIP()
+{
+  return _dnsServerAddress;
+}
+
+EthernetClass Ethernet;
diff --git a/libraries/Ethernet/Ethernet.h b/libraries/Ethernet/Ethernet.h
new file mode 100644
index 0000000..fdf0b7f
--- /dev/null
+++ b/libraries/Ethernet/Ethernet.h
@@ -0,0 +1,37 @@
+#ifndef ethernet_h
+#define ethernet_h
+
+#include <inttypes.h>
+//#include "w5100.h"
+#include "IPAddress.h"
+#include "Client.h"
+#include "Server.h"
+
+#define MAX_SOCK_NUM 4
+
+class EthernetClass {
+private:
+  IPAddress _dnsServerAddress;
+public:
+  static uint8_t _state[MAX_SOCK_NUM];
+  static uint16_t _server_port[MAX_SOCK_NUM];
+  // Initialise the Ethernet shield to use the provided MAC address and gain the rest of the
+  // configuration through DHCP.
+  // Returns 0 if the DHCP configuration failed, and 1 if it succeeded
+  int begin(uint8_t *mac_address);
+  void begin(uint8_t *mac_address, IPAddress local_ip);
+  void begin(uint8_t *mac_address, IPAddress local_ip, IPAddress gateway);
+  void begin(uint8_t *mac_address, IPAddress local_ip, IPAddress gateway, IPAddress subnet);
+
+  IPAddress localIP();
+  IPAddress subnetMask();
+  IPAddress gatewayIP();
+  IPAddress dnsServerIP();
+
+  friend class Client;
+  friend class Server;
+};
+
+extern EthernetClass Ethernet;
+
+#endif
diff --git a/libraries/Ethernet/IPAddress.cpp b/libraries/Ethernet/IPAddress.cpp
new file mode 100644
index 0000000..610ff4c
--- /dev/null
+++ b/libraries/Ethernet/IPAddress.cpp
@@ -0,0 +1,44 @@
+
+#include <Arduino.h>
+#include <IPAddress.h>
+
+IPAddress::IPAddress()
+{
+    memset(_address, 0, sizeof(_address));
+}
+
+IPAddress::IPAddress(uint8_t first_octet, uint8_t second_octet, uint8_t third_octet, uint8_t fourth_octet)
+{
+    _address[0] = first_octet;
+    _address[1] = second_octet;
+    _address[2] = third_octet;
+    _address[3] = fourth_octet;
+}
+
+IPAddress::IPAddress(uint32_t address)
+{
+    memcpy(_address, &address, sizeof(_address));
+}
+
+IPAddress::IPAddress(const uint8_t *address)
+{
+    memcpy(_address, address, sizeof(_address));
+}
+
+IPAddress& IPAddress::operator=(const uint8_t *address)
+{
+    memcpy(_address, address, sizeof(_address));
+    return *this;
+}
+
+IPAddress& IPAddress::operator=(uint32_t address)
+{
+    memcpy(_address, (const uint8_t *)&address, sizeof(_address));
+    return *this;
+}
+
+bool IPAddress::operator==(const uint8_t* addr)
+{
+    return memcmp(addr, _address, sizeof(_address)) == 0;
+}
+
diff --git a/libraries/Ethernet/IPAddress.h b/libraries/Ethernet/IPAddress.h
new file mode 100644
index 0000000..487e420
--- /dev/null
+++ b/libraries/Ethernet/IPAddress.h
@@ -0,0 +1,72 @@
+/*
+ *
+ * MIT License:
+ * Copyright (c) 2011 Adrian McEwen
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ * adrianm@mcqn.com 1/1/2011
+ */
+
+#ifndef IPAddress_h
+#define IPAddress_h
+
+// A class to make it easier to handle and pass around IP addresses
+
+class IPAddress {
+private:
+    uint8_t _address[4];  // IPv4 address
+    // Access the raw byte array containing the address.  Because this returns a pointer
+    // to the internal structure rather than a copy of the address this function should only
+    // be used when you know that the usage of the returned uint8_t* will be transient and not
+    // stored.
+    uint8_t* raw_address() { return _address; };
+
+public:
+    // Constructors
+    IPAddress();
+    IPAddress(uint8_t first_octet, uint8_t second_octet, uint8_t third_octet, uint8_t fourth_octet);
+    IPAddress(uint32_t address);
+    IPAddress(const uint8_t *address);
+
+    // Overloaded cast operator to allow IPAddress objects to be used where a pointer
+    // to a four-byte uint8_t array is expected
+    operator uint32_t() { return *((uint32_t*)_address); };
+    bool operator==(const IPAddress& addr) { return (*((uint32_t*)_address)) == (*((uint32_t*)addr._address)); };
+    bool operator==(const uint8_t* addr);
+
+    // Overloaded index operator to allow getting and setting individual octets of the address
+    uint8_t operator[](int index) const { return _address[index]; };
+    uint8_t& operator[](int index) { return _address[index]; };
+
+    // Overloaded copy operators to allow initialisation of IPAddress objects from other types
+    IPAddress& operator=(const uint8_t *address);
+    IPAddress& operator=(uint32_t address);
+
+    friend class EthernetClass;
+    friend class UDP;
+    friend class Client;
+    friend class Server;
+    friend class DhcpClass;
+    friend class DNSClient;
+};
+
+const IPAddress INADDR_NONE(0,0,0,0);
+
+
+#endif
diff --git a/libraries/Ethernet/Server.cpp b/libraries/Ethernet/Server.cpp
new file mode 100644
index 0000000..4271741
--- /dev/null
+++ b/libraries/Ethernet/Server.cpp
@@ -0,0 +1,92 @@
+#include "w5100.h"
+#include "socket.h"
+extern "C" {
+#include "string.h"
+}
+
+#include "Ethernet.h"
+#include "Client.h"
+#include "Server.h"
+
+Server::Server(uint16_t port)
+{
+  _port = port;
+}
+
+void Server::begin()
+{
+  for (int sock = 0; sock < MAX_SOCK_NUM; sock++) {
+    Client client(sock);
+    if (client.status() == SnSR::CLOSED) {
+      socket(sock, SnMR::TCP, _port, 0);
+      listen(sock);
+      EthernetClass::_server_port[sock] = _port;
+      break;
+    }
+  }  
+}
+
+void Server::accept()
+{
+  int listening = 0;
+
+  for (int sock = 0; sock < MAX_SOCK_NUM; sock++) {
+    Client client(sock);
+
+    if (EthernetClass::_server_port[sock] == _port) {
+      if (client.status() == SnSR::LISTEN) {
+        listening = 1;
+      } 
+      else if (client.status() == SnSR::CLOSE_WAIT && !client.available()) {
+        client.stop();
+      }
+    } 
+  }
+
+  if (!listening) {
+    begin();
+  }
+}
+
+Client Server::available()
+{
+  accept();
+
+  for (int sock = 0; sock < MAX_SOCK_NUM; sock++) {
+    Client client(sock);
+    if (EthernetClass::_server_port[sock] == _port &&
+        (client.status() == SnSR::ESTABLISHED ||
+         client.status() == SnSR::CLOSE_WAIT)) {
+      if (client.available()) {
+        // XXX: don't always pick the lowest numbered socket.
+        return client;
+      }
+    }
+  }
+
+  return Client(MAX_SOCK_NUM);
+}
+
+void Server::write(uint8_t b) 
+{
+  write(&b, 1);
+}
+
+void Server::write(const char *str) 
+{
+  write((const uint8_t *)str, strlen(str));
+}
+
+void Server::write(const uint8_t *buffer, size_t size) 
+{
+  accept();
+
+  for (int sock = 0; sock < MAX_SOCK_NUM; sock++) {
+    Client client(sock);
+
+    if (EthernetClass::_server_port[sock] == _port &&
+      client.status() == SnSR::ESTABLISHED) {
+      client.write(buffer, size);
+    }
+  }
+}
diff --git a/libraries/Ethernet/Server.h b/libraries/Ethernet/Server.h
new file mode 100644
index 0000000..6aa5d3a
--- /dev/null
+++ b/libraries/Ethernet/Server.h
@@ -0,0 +1,22 @@
+#ifndef server_h
+#define server_h
+
+#include "Print.h"
+
+class Client;
+
+class Server : 
+public Print {
+private:
+  uint16_t _port;
+  void accept();
+public:
+  Server(uint16_t);
+  Client available();
+  void begin();
+  virtual void write(uint8_t);
+  virtual void write(const char *str);
+  virtual void write(const uint8_t *buf, size_t size);
+};
+
+#endif
diff --git a/libraries/Ethernet/Udp.cpp b/libraries/Ethernet/Udp.cpp
new file mode 100644
index 0000000..aed5d98
--- /dev/null
+++ b/libraries/Ethernet/Udp.cpp
@@ -0,0 +1,188 @@
+/*
+ *  Udp.cpp: Library to send/receive UDP packets with the Arduino ethernet shield.
+ *  This version only offers minimal wrapping of socket.c/socket.h
+ *  Drop Udp.h/.cpp into the Ethernet library directory at hardware/libraries/Ethernet/ 
+ *
+ * MIT License:
+ * Copyright (c) 2008 Bjoern Hartmann
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ * bjoern@cs.stanford.edu 12/30/2008
+ */
+
+#include "w5100.h"
+#include "socket.h"
+#include "Ethernet.h"
+#include "Udp.h"
+#include "Dns.h"
+
+/* Constructor */
+UDP::UDP() : _sock(MAX_SOCK_NUM) {}
+
+/* Start UDP socket, listening at local port PORT */
+uint8_t UDP::begin(uint16_t port) {
+  if (_sock != MAX_SOCK_NUM)
+    return 0;
+
+  for (int i = 0; i < MAX_SOCK_NUM; i++) {
+    uint8_t s = W5100.readSnSR(i);
+    if (s == SnSR::CLOSED || s == SnSR::FIN_WAIT) {
+      _sock = i;
+      break;
+    }
+  }
+
+  if (_sock == MAX_SOCK_NUM)
+    return 0;
+
+  _port = port;
+  socket(_sock, SnMR::UDP, _port, 0);
+
+  return 1;
+}
+
+/* Is data available in rx buffer? Returns 0 if no, number of available bytes if yes. 
+ * returned value includes 8 byte UDP header!*/
+int UDP::available() {
+  return W5100.getRXReceivedSize(_sock);
+}
+
+/* Release any resources being used by this UDP instance */
+void UDP::stop()
+{
+  if (_sock == MAX_SOCK_NUM)
+    return;
+
+  close(_sock);
+
+  EthernetClass::_server_port[_sock] = 0;
+  _sock = MAX_SOCK_NUM;
+}
+
+int UDP::beginPacket(const char *host, uint16_t port)
+{
+  // Look up the host first
+  int ret = 0;
+  DNSClient dns;
+  IPAddress remote_addr;
+
+  dns.begin(Ethernet.dnsServerIP());
+  ret = dns.getHostByName(host, remote_addr);
+  if (ret == 1) {
+    return beginPacket(remote_addr, port);
+  } else {
+    return ret;
+  }
+}
+
+int UDP::beginPacket(IPAddress ip, uint16_t port)
+{
+  _offset = 0;
+  return startUDP(_sock, ip.raw_address(), port);
+}
+
+int UDP::endPacket()
+{
+  return sendUDP(_sock);
+}
+
+void UDP::write(uint8_t byte)
+{
+  write(&byte, 1);
+}
+
+void UDP::write(const char *str)
+{
+  size_t len = strlen(str);
+  write((const uint8_t *)str, len);
+}
+
+void UDP::write(const uint8_t *buffer, size_t size)
+{
+  uint16_t bytes_written = bufferData(_sock, _offset, buffer, size);
+  _offset += bytes_written;
+}
+
+int UDP::parsePacket()
+{
+  if (available() > 0)
+  {
+    //HACK - hand-parse the UDP packet using TCP recv method
+    uint8_t tmpBuf[8];
+    int ret =0;	
+    //read 8 header bytes and get IP and port from it
+    ret = recv(_sock,tmpBuf,8);
+    if (ret > 0)
+    {
+      _remoteIP = tmpBuf;
+      _remotePort = tmpBuf[4];
+      _remotePort = (_remotePort << 8) + tmpBuf[5];
+      // When we get here, any remaining bytes are the data
+      ret = available();
+    }
+    return ret;
+  }
+  // There aren't any packets available
+  return 0;
+}
+
+int UDP::read()
+{
+  uint8_t byte;
+  if (recv(_sock, &byte, 1) > 0)
+  {
+    // We read things without any problems
+    return byte;
+  }
+  // If we get here, there's no data available
+  return -1;
+}
+
+int UDP::read(unsigned char* buffer, size_t len)
+{
+  /* In the readPacket that copes with truncating packets, the buffer was
+     filled with this code.  Not sure why it loops round reading out a byte
+     at a time.
+  int i;
+  for(i=0;i<(int)bufLen;i++) {
+    recv(_sock,tmpBuf,1);
+    buf[i]=tmpBuf[0];
+  }
+  */
+  return recv(_sock, buffer, len);
+}
+
+int UDP::peek()
+{
+  uint8_t b;
+  // Unlike recv, peek doesn't check to see if there's any data available, so we must
+  if (!available())
+    return -1;
+  ::peek(_sock, &b);
+  return b;
+}
+
+void UDP::flush()
+{
+  while (available())
+  {
+    read();
+  }
+}
+
diff --git a/libraries/Ethernet/Udp.h b/libraries/Ethernet/Udp.h
new file mode 100644
index 0000000..99df53f
--- /dev/null
+++ b/libraries/Ethernet/Udp.h
@@ -0,0 +1,99 @@
+/*
+ *  Udp.cpp: Library to send/receive UDP packets with the Arduino ethernet shield.
+ *  This version only offers minimal wrapping of socket.c/socket.h
+ *  Drop Udp.h/.cpp into the Ethernet library directory at hardware/libraries/Ethernet/ 
+ *
+ * NOTE: UDP is fast, but has some important limitations (thanks to Warren Gray for mentioning these)
+ * 1) UDP does not guarantee the order in which assembled UDP packets are received. This
+ * might not happen often in practice, but in larger network topologies, a UDP
+ * packet can be received out of sequence. 
+ * 2) UDP does not guard against lost packets - so packets *can* disappear without the sender being
+ * aware of it. Again, this may not be a concern in practice on small local networks.
+ * For more information, see http://www.cafeaulait.org/course/week12/35.html
+ *
+ * MIT License:
+ * Copyright (c) 2008 Bjoern Hartmann
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ * bjoern@cs.stanford.edu 12/30/2008
+ */
+
+#ifndef udp_h
+#define udp_h
+
+#include <Stream.h>
+#include <IPAddress.h>
+
+#define UDP_TX_PACKET_MAX_SIZE 24
+
+class UDP : public Stream {
+private:
+  uint8_t _sock;  // socket ID for Wiz5100
+  uint16_t _port; // local port to listen on
+  IPAddress _remoteIP; // remote IP address for the incoming packet whilst it's being processed
+  uint16_t _remotePort; // remote port for the incoming packet whilst it's being processed
+  uint16_t _offset; // offset into the packet being sent
+
+public:
+  UDP();  // Constructor
+  uint8_t begin(uint16_t);	// initialize, start listening on specified port. Returns 1 if successful, 0 if there are no sockets available to use
+  void stop();  // Finish with the UDP socket
+
+  // Sending UDP packets
+  
+  // Start building up a packet to send to the remote host specific in ip and port
+  // Returns 1 if successful, 0 if there was a problem with the supplied IP address or port
+  int beginPacket(IPAddress ip, uint16_t port);
+  // Start building up a packet to send to the remote host specific in host and port
+  // Returns 1 if successful, 0 if there was a problem resolving the hostname or port
+  int beginPacket(const char *host, uint16_t port);
+  // Finish off this packet and send it
+  // Returns 1 if the packet was sent successfully, 0 if there was an error
+  int endPacket();
+  // Write a single byte into the packet
+  virtual void write(uint8_t);
+  // Write a string of characters into the packet
+  virtual void write(const char *str);
+  // Write size bytes from buffer into the packet
+  virtual void write(const uint8_t *buffer, size_t size);
+
+  // Start processing the next available incoming packet
+  // Returns the size of the packet in bytes, or 0 if no packets are available
+  int parsePacket();
+  // Number of bytes remaining in the current packet
+  virtual int available();
+  // Read a single byte from the current packet
+  virtual int read();
+  // Read up to len bytes from the current packet and place them into buffer
+  // Returns the number of bytes read, or 0 if none are available
+  virtual int read(unsigned char* buffer, size_t len);
+  // Read up to len characters from the current packet and place them into buffer
+  // Returns the number of characters read, or 0 if none are available
+  virtual int read(char* buffer, size_t len) { return read((unsigned char*)buffer, len); };
+  // Return the next byte from the current packet without moving on to the next byte
+  virtual int peek();
+  virtual void flush();	// Finish reading the current packet
+
+  // Return the IP address of the host who sent the current incoming packet
+  IPAddress remoteIP() { return _remoteIP; };
+  // Return the port of the host who sent the current incoming packet
+  uint16_t remotePort() { return _remotePort; };
+};
+
+#endif
diff --git a/libraries/Ethernet/examples/BarometricPressureWebServer/BarometricPressureWebServer.pde b/libraries/Ethernet/examples/BarometricPressureWebServer/BarometricPressureWebServer.pde
new file mode 100644
index 0000000..3f43d96
--- /dev/null
+++ b/libraries/Ethernet/examples/BarometricPressureWebServer/BarometricPressureWebServer.pde
@@ -0,0 +1,222 @@
+/*
+  SCP1000 Barometric Pressure Sensor Display
+ 
+ Serves the output of a Barometric Pressure Sensor as a web page.
+ Uses the SPI library. For details on the sensor, see:
+ http://www.sparkfun.com/commerce/product_info.php?products_id=8161
+ http://www.vti.fi/en/support/obsolete_products/pressure_sensors/
+ 
+ This sketch adapted from Nathan Seidle's SCP1000 example for PIC:
+ http://www.sparkfun.com/datasheets/Sensors/SCP1000-Testing.zip
+ 
+ Circuit:
+ SCP1000 sensor attached to pins 6,7, and 11 - 13:
+ DRDY: pin 6
+ CSB: pin 7
+ MOSI: pin 11
+ MISO: pin 12
+ SCK: pin 13
+ 
+ created 31 July 2010
+ by Tom Igoe
+ */
+
+#include <Ethernet.h>
+// the sensor communicates using SPI, so include the library:
+#include <SPI.h>
+
+
+// assign a MAC address for the ethernet controller.
+// fill in your address here:
+byte mac[] = { 
+  0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED};
+// assign an IP address for the controller:
+IPAddress ip(192,168,1,20);
+IPAddress gateway(192,168,1,1);	
+IPAddress subnet(255, 255, 255, 0);
+
+
+// Initialize the Ethernet server library
+// with the IP address and port you want to use 
+// (port 80 is default for HTTP):
+Server server(80);
+
+
+//Sensor's memory register addresses:
+const int PRESSURE = 0x1F;      //3 most significant bits of pressure
+const int PRESSURE_LSB = 0x20;  //16 least significant bits of pressure
+const int TEMPERATURE = 0x21;   //16 bit temperature reading
+
+// pins used for the connection with the sensor
+// the others you need are controlled by the SPI library):
+const int dataReadyPin = 6; 
+const int chipSelectPin = 7;
+
+float temperature = 0.0;
+long pressure = 0;
+long lastReadingTime = 0;
+
+void setup() {
+  // start the SPI library:
+  SPI.begin();
+
+  // start the Ethernet connection and the server:
+  Ethernet.begin(mac, ip);
+  server.begin();
+
+  // initalize the  data ready and chip select pins:
+  pinMode(dataReadyPin, INPUT);
+  pinMode(chipSelectPin, OUTPUT);
+
+  Serial.begin(9600);
+
+  //Configure SCP1000 for low noise configuration:
+  writeRegister(0x02, 0x2D);
+  writeRegister(0x01, 0x03);
+  writeRegister(0x03, 0x02);
+
+  // give the sensor and Ethernet shield time to set up:
+  delay(1000);
+
+  //Set the sensor to high resolution mode tp start readings:
+  writeRegister(0x03, 0x0A);
+
+}
+
+void loop() { 
+  // check for a reading no more than once a second.
+  if (millis() - lastReadingTime > 1000){
+    // if there's a reading ready, read it:
+    // don't do anything until the data ready pin is high:
+    if (digitalRead(dataReadyPin) == HIGH) {
+      getData();
+      // timestamp the last time you got a reading:
+      lastReadingTime = millis();
+    }
+  }
+
+  // listen for incoming Ethernet connections:
+  listenForClients();
+}
+
+
+void getData() {
+  Serial.println("Getting reading");
+  //Read the temperature data
+  int tempData = readRegister(0x21, 2);
+
+  // convert the temperature to celsius and display it:
+  temperature = (float)tempData / 20.0;
+
+  //Read the pressure data highest 3 bits:
+  byte  pressureDataHigh = readRegister(0x1F, 1);   
+  pressureDataHigh &= 0b00000111; //you only needs bits 2 to 0
+
+  //Read the pressure data lower 16 bits:
+  unsigned int pressureDataLow = readRegister(0x20, 2);    
+  //combine the two parts into one 19-bit number:
+  pressure = ((pressureDataHigh << 16) | pressureDataLow)/4;
+
+  Serial.print("Temperature: ");
+  Serial.print(temperature);
+  Serial.println(" degrees C");
+  Serial.print("Pressure: " + String(pressure));
+  Serial.println(" Pa");
+}
+
+void listenForClients() {
+  // listen for incoming clients
+  Client client = server.available();
+  if (client) {
+    Serial.println("Got a client");
+    // an http request ends with a blank line
+    boolean currentLineIsBlank = true;
+    while (client.connected()) {
+      if (client.available()) {
+        char c = client.read();
+        // if you've gotten to the end of the line (received a newline
+        // character) and the line is blank, the http request has ended,
+        // so you can send a reply
+        if (c == '\n' && currentLineIsBlank) {
+          // send a standard http response header
+          client.println("HTTP/1.1 200 OK");
+          client.println("Content-Type: text/html");
+          client.println();
+          // print the current readings, in HTML format:
+          client.print("Temperature: ");
+          client.print(temperature);
+          client.print(" degrees C");
+          client.println("<br />");
+          client.print("Pressure: " + String(pressure));
+          client.print(" Pa");
+          client.println("<br />");  
+          break;
+        }
+        if (c == '\n') {
+          // you're starting a new line
+          currentLineIsBlank = true;
+        } 
+        else if (c != '\r') {
+          // you've gotten a character on the current line
+          currentLineIsBlank = false;
+        }
+      }
+    }
+    // give the web browser time to receive the data
+    delay(1);
+    // close the connection:
+    client.stop();
+  }
+} 
+
+
+//Send a write command to SCP1000
+void writeRegister(byte registerName, byte registerValue) {
+  // SCP1000 expects the register name in the upper 6 bits
+  // of the byte:
+  registerName <<= 2;
+  // command (read or write) goes in the lower two bits:
+  registerName |= 0b00000010; //Write command
+
+  // take the chip select low to select the device:
+  digitalWrite(chipSelectPin, LOW); 
+
+  SPI.transfer(registerName); //Send register location
+  SPI.transfer(registerValue); //Send value to record into register
+
+  // take the chip select high to de-select:
+  digitalWrite(chipSelectPin, HIGH); 
+}
+
+
+//Read register from the SCP1000:
+unsigned int readRegister(byte registerName, int numBytes) {
+  byte inByte = 0;           // incoming from  the SPI read
+  unsigned int result = 0;   // result to return 
+
+  // SCP1000 expects the register name in the upper 6 bits
+  // of the byte:
+  registerName <<=  2;
+  // command (read or write) goes in the lower two bits:
+  registerName &= 0b11111100; //Read command
+
+  // take the chip select low to select the device:
+  digitalWrite(chipSelectPin, LOW); 
+  // send the device the register you want to read:
+  int command = SPI.transfer(registerName); 
+  // send a value of 0 to read the first byte returned:
+  inByte = SPI.transfer(0x00); 
+  
+  result = inByte;
+  // if there's more than one byte returned, 
+  // shift the first byte then get the second byte:
+  if (numBytes > 1){
+    result = inByte << 8;
+    inByte = SPI.transfer(0x00); 
+    result = result |inByte;
+  }
+  // take the chip select high to de-select:
+  digitalWrite(chipSelectPin, HIGH); 
+  // return the result:
+  return(result);
+}
diff --git a/libraries/Ethernet/examples/ChatServer/ChatServer.pde b/libraries/Ethernet/examples/ChatServer/ChatServer.pde
new file mode 100644
index 0000000..8267a5d
--- /dev/null
+++ b/libraries/Ethernet/examples/ChatServer/ChatServer.pde
@@ -0,0 +1,63 @@
+/*
+ Chat  Server
+ 
+ A simple server that distributes any incoming messages to all
+ connected clients.  To use telnet to  your device's IP address and type.
+ You can see the client's input in the serial monitor as well.
+ Using an Arduino Wiznet Ethernet shield. 
+ 
+ Circuit:
+ * Ethernet shield attached to pins 10, 11, 12, 13
+ * Analog inputs attached to pins A0 through A5 (optional)
+ 
+ created 18 Dec 2009
+ by David A. Mellis
+ modified 10 August 2010
+ by Tom Igoe
+ 
+ */
+
+#include <SPI.h>
+#include <Ethernet.h>
+
+// Enter a MAC address and IP address for your controller below.
+// The IP address will be dependent on your local network.
+// gateway and subnet are optional:
+byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
+IPAddress ip(192,168,1, 177);
+IPAddress gateway(192,168,1, 1);
+IPAddress subnet(255, 255, 0, 0);
+
+// telnet defaults to port 23
+Server server(23);
+boolean gotAMessage = false; // whether or not you got a message from the client yet
+
+void setup() {
+  // initialize the ethernet device
+  Ethernet.begin(mac, ip, gateway, subnet);
+  // start listening for clients
+  server.begin();
+  // open the serial port
+  Serial.begin(9600);
+}
+
+void loop() {
+  // wait for a new client:
+  Client client = server.available();
+  
+  // when the client sends the first byte, say hello:
+  if (client) {
+    if (!gotAMessage) {
+      Serial.println("We have a new client");
+      client.println("Hello, client!"); 
+      gotAMessage = true;
+    }
+    
+    // read the bytes incoming from the client:
+    char thisChar = client.read();
+    // echo the bytes back to the client:
+    server.write(thisChar);
+    // echo the bytes to the server as well:
+    Serial.print(thisChar);
+  }
+}
diff --git a/libraries/Ethernet/examples/DhcpAddressPrinter/DhcpAddressPrinter.pde b/libraries/Ethernet/examples/DhcpAddressPrinter/DhcpAddressPrinter.pde
new file mode 100644
index 0000000..50a557d
--- /dev/null
+++ b/libraries/Ethernet/examples/DhcpAddressPrinter/DhcpAddressPrinter.pde
@@ -0,0 +1,53 @@
+/*
+  DHCP-based IP printer
+ 
+ This sketch uses the DHCP extensions to the Ethernet library
+ to get an IP address via DHCP and print the address obtained.
+ using an Arduino Wiznet Ethernet shield. 
+ 
+ Circuit:
+ * Ethernet shield attached to pins 10, 11, 12, 13
+ 
+ created 12 April 2011
+ by Tom Igoe
+ 
+ */
+
+#include <SPI.h>
+#include <Ethernet.h>
+
+// Enter a MAC address for your controller below.
+// Newer Ethernet shields have a MAC address printed on a sticker on the shield
+byte mac[] = {  
+  0x00, 0xAA, 0xBB, 0xCC, 0xDE, 0x02 };
+
+// Initialize the Ethernet client library
+// with the IP address and port of the server 
+// that you want to connect to (port 80 is default for HTTP):
+Client client;
+
+void setup() {
+  // start the serial library:
+  Serial.begin(9600);
+  // start the Ethernet connection:
+  if (Ethernet.begin(mac) == 0) {
+    Serial.println("Failed to configure Ethernet using DHCP");
+    // no point in carrying on, so do nothing forevermore:
+    for(;;)
+      ;
+  }
+  // print your local IP address:
+  Serial.print("My IP address: ");
+  for (byte thisByte = 0; thisByte < 4; thisByte++) {
+    // print the value of each byte of the IP address:
+    Serial.print(Ethernet.localIP()[thisByte], DEC);
+    Serial.print("."); 
+  }
+  Serial.println();
+}
+
+void loop() {
+
+}
+
+
diff --git a/libraries/Ethernet/examples/DnsWebClient/DnsWebClient.pde b/libraries/Ethernet/examples/DnsWebClient/DnsWebClient.pde
new file mode 100644
index 0000000..7bec73a
--- /dev/null
+++ b/libraries/Ethernet/examples/DnsWebClient/DnsWebClient.pde
@@ -0,0 +1,76 @@
+/*
+  DNS and DHCP-based Web client
+ 
+ This sketch connects to a website (http://www.google.com)
+ using an Arduino Wiznet Ethernet shield. 
+ 
+ Circuit:
+ * Ethernet shield attached to pins 10, 11, 12, 13
+ 
+ created 18 Dec 2009
+ by David A. Mellis
+ modified 12 April 2011
+ by Tom Igoe, based on work by Adrian McEwen
+ 
+ */
+
+#include <SPI.h>
+#include <Ethernet.h>
+
+// Enter a MAC address for your controller below.
+// Newer Ethernet shields have a MAC address printed on a sticker on the shield
+byte mac[] = {  0x00, 0xAA, 0xBB, 0xCC, 0xDE, 0x02 };
+char serverName[] = "www.google.com";
+
+// Initialize the Ethernet client library
+// with the IP address and port of the server 
+// that you want to connect to (port 80 is default for HTTP):
+Client client;
+
+void setup() {
+  // start the serial library:
+  Serial.begin(9600);
+  // start the Ethernet connection:
+  if (Ethernet.begin(mac) == 0) {
+    Serial.println("Failed to configure Ethernet using DHCP");
+    // no point in carrying on, so do nothing forevermore:
+    while(true);
+  }
+  // give the Ethernet shield a second to initialize:
+  delay(1000);
+  Serial.println("connecting...");
+
+  // if you get a connection, report back via serial:
+  
+  if (client.connect(serverName, 80)) {
+    Serial.println("connected");
+    // Make a HTTP request:
+    client.println("GET /search?q=arduino HTTP/1.0");
+    client.println();
+  } 
+  else {
+    // kf you didn't get a connection to the server:
+    Serial.println("connection failed");
+  }
+}
+
+void loop()
+{
+  // if there are incoming bytes available 
+  // from the server, read them and print them:
+  if (client.available()) {
+    char c = client.read();
+    Serial.print(c);
+  }
+
+  // if the server's disconnected, stop the client:
+  if (!client.connected()) {
+    Serial.println();
+    Serial.println("disconnecting.");
+    client.stop();
+
+    // do nothing forevermore:
+    while(true);
+  }
+}
+
diff --git a/libraries/Ethernet/examples/PachubeClient/PachubeClient.pde b/libraries/Ethernet/examples/PachubeClient/PachubeClient.pde
new file mode 100644
index 0000000..af9bf1f
--- /dev/null
+++ b/libraries/Ethernet/examples/PachubeClient/PachubeClient.pde
@@ -0,0 +1,135 @@
+/*
+  Pachube sensor client
+ 
+ This sketch connects an analog sensor to Pachube (http://www.pachube.com)
+ using a Wiznet Ethernet shield. You can use the Arduino Ethernet shield, or
+ the Adafruit Ethernet shield, either one will work, as long as it's got
+ a Wiznet Ethernet module on board.
+ 
+ Circuit:
+ * Analog sensor attached to analog in 0
+ * Ethernet shield attached to pins 10, 11, 12, 13
+ 
+ created 15 March 2010
+ updated 4 Sep 2010
+ by Tom Igoe
+ 
+ http://www.tigoe.net/pcomp/code/category/arduinowiring/873
+ This code is in the public domain.
+ 
+ */
+
+#include <SPI.h>
+#include <Ethernet.h>
+
+// assign a MAC address for the ethernet controller.
+// Newer Ethernet shields have a MAC address printed on a sticker on the shield
+// fill in your address here:
+byte mac[] = { 
+  0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED};
+
+// initialize the library instance:
+Client client;
+
+long lastConnectionTime = 0;        // last time you connected to the server, in milliseconds
+boolean lastConnected = false;      // state of the connection last time through the main loop
+const int postingInterval = 10000;  //delay between updates to Pachube.com
+
+void setup() {
+  // start serial port:
+  Serial.begin(9600);
+  // start the Ethernet connection:
+  if (Ethernet.begin(mac) == 0) {
+    Serial.println("Failed to configure Ethernet using DHCP");
+    // no point in carrying on, so do nothing forevermore:
+    for(;;)
+      ;
+  }
+  // give the ethernet module time to boot up:
+  delay(1000);
+}
+
+void loop() {
+  // read the analog sensor:
+  int sensorReading = analogRead(A0);   
+
+  // if there's incoming data from the net connection.
+  // send it out the serial port.  This is for debugging
+  // purposes only:
+  if (client.available()) {
+    char c = client.read();
+    Serial.print(c);
+  }
+
+  // if there's no net connection, but there was one last time
+  // through the loop, then stop the client:
+  if (!client.connected() && lastConnected) {
+    Serial.println();
+    Serial.println("disconnecting.");
+    client.stop();
+  }
+
+  // if you're not connected, and ten seconds have passed since
+  // your last connection, then connect again and send data:
+  if(!client.connected() && (millis() - lastConnectionTime > postingInterval)) {
+    sendData(sensorReading);
+  }
+  // store the state of the connection for next time through
+  // the loop:
+  lastConnected = client.connected();
+}
+
+// this method makes a HTTP connection to the server:
+void sendData(int thisData) {
+  // if there's a successful connection:
+  if (client.connect("www.pachube.com", 80)) {
+    Serial.println("connecting...");
+    // send the HTTP PUT request. 
+    // fill in your feed address here:
+    client.print("PUT /api/YOUR_FEED_HERE.csv HTTP/1.1\n");
+    client.print("Host: www.pachube.com\n");
+    // fill in your Pachube API key here:
+    client.print("X-PachubeApiKey: YOUR_KEY_HERE\n");
+    client.print("Content-Length: ");
+
+    // calculate the length of the sensor reading in bytes:
+    int thisLength = getLength(thisData);
+    client.println(thisLength, DEC);
+
+    // last pieces of the HTTP PUT request:
+    client.print("Content-Type: text/csv\n");
+    client.println("Connection: close\n");
+
+    // here's the actual content of the PUT request:
+    client.println(thisData, DEC);
+
+    // note the time that the connection was made:
+    lastConnectionTime = millis();
+  } 
+  else {
+    // if you couldn't make a connection:
+    Serial.println("connection failed");
+  }
+}
+
+
+// This method calculates the number of digits in the
+// sensor reading.  Since each digit of the ASCII decimal
+// representation is a byte, the number of digits equals
+// the number of bytes:
+
+int getLength(int someValue) {
+  // there's at least one byte:
+  int digits = 1;
+  // continually divide the value by ten, 
+  // adding one to the digit count for each
+  // time you divide, until you're at 0:
+  int dividend = someValue /10;
+  while (dividend > 0) {
+    dividend = dividend /10;
+    digits++;
+  }
+  // return the number of digits:
+  return digits;
+}
+
diff --git a/libraries/Ethernet/examples/PachubeClientString/PachubeClientString.pde b/libraries/Ethernet/examples/PachubeClientString/PachubeClientString.pde
new file mode 100644
index 0000000..e6dbf09
--- /dev/null
+++ b/libraries/Ethernet/examples/PachubeClientString/PachubeClientString.pde
@@ -0,0 +1,118 @@
+/*
+  Pachube sensor client with Strings
+ 
+ This sketch connects an analog sensor to Pachube (http://www.pachube.com)
+ using a Wiznet Ethernet shield. You can use the Arduino Ethernet shield, or
+ the Adafruit Ethernet shield, either one will work, as long as it's got
+ a Wiznet Ethernet module on board.
+ 
+ This example uses the String library, which is part of the Arduino core from
+ version 0019.  
+ 
+ Circuit:
+ * Analog sensor attached to analog in 0
+ * Ethernet shield attached to pins 10, 11, 12, 13
+ 
+ created 15 March 2010
+ updated 4 Sep 2010
+ by Tom Igoe
+ 
+ This code is in the public domain.
+ 
+ */
+
+#include <SPI.h>
+#include <Ethernet.h>
+
+// assign a MAC address for the ethernet controller.
+// fill in your address here:
+byte mac[] = { 
+  0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED};
+
+// initialize the library instance:
+Client client;
+
+long lastConnectionTime = 0;        // last time you connected to the server, in milliseconds
+boolean lastConnected = false;      // state of the connection last time through the main loop
+const int postingInterval = 10000;  //delay between updates to Pachube.com
+
+void setup() {
+  // start the ethernet connection and serial port:
+  Serial.begin(9600);
+  if (Ethernet.begin(mac) == 0) {
+    Serial.println("Failed to configure Ethernet using DHCP");
+    // no point in carrying on, so do nothing forevermore:
+    for(;;)
+      ;
+  }
+  // give the ethernet module time to boot up:
+  delay(1000);
+}
+
+void loop() {
+  // read the analog sensor:
+  int sensorReading = analogRead(A0);   
+  // convert the data to a String to send it:
+  String dataString = String(sensorReading);
+
+  // you can append multiple readings to this String if your
+  // pachube feed is set up to handle multiple values:
+  int otherSensorReading = analogRead(A1);
+  dataString += ",";
+  dataString += String(otherSensorReading);
+
+  // if there's incoming data from the net connection.
+  // send it out the serial port.  This is for debugging
+  // purposes only:
+  if (client.available()) {
+    char c = client.read();
+    Serial.print(c);
+  }
+
+  // if there's no net connection, but there was one last time
+  // through the loop, then stop the client:
+  if (!client.connected() && lastConnected) {
+    Serial.println();
+    Serial.println("disconnecting.");
+    client.stop();
+  }
+
+  // if you're not connected, and ten seconds have passed since
+  // your last connection, then connect again and send data:
+  if(!client.connected() && (millis() - lastConnectionTime > postingInterval)) {
+    sendData(dataString);
+  }
+  // store the state of the connection for next time through
+  // the loop:
+  lastConnected = client.connected();
+}
+
+// this method makes a HTTP connection to the server:
+void sendData(String thisData) {
+  // if there's a successful connection:
+  if (client.connect("www.pachube.com", 80)) {
+    Serial.println("connecting...");
+    // send the HTTP PUT request. 
+    // fill in your feed address here:
+    client.print("PUT /api/YOUR_FEED_HERE.csv HTTP/1.1\n");
+    client.print("Host: www.pachube.com\n");
+    // fill in your Pachube API key here:
+    client.print("X-PachubeApiKey: YOUR_KEY_HERE\n");
+    client.print("Content-Length: ");
+    client.println(thisData.length(), DEC);
+
+    // last pieces of the HTTP PUT request:
+    client.print("Content-Type: text/csv\n");
+    client.println("Connection: close\n");
+
+    // here's the actual content of the PUT request:
+    client.println(thisData);
+
+    // note the time that the connection was made:
+    lastConnectionTime = millis();
+  } 
+  else {
+    // if you couldn't make a connection:
+    Serial.println("connection failed");
+  }
+}
diff --git a/libraries/Ethernet/examples/TelnetClient/TelnetClient.pde b/libraries/Ethernet/examples/TelnetClient/TelnetClient.pde
new file mode 100644
index 0000000..7502d21
--- /dev/null
+++ b/libraries/Ethernet/examples/TelnetClient/TelnetClient.pde
@@ -0,0 +1,87 @@
+/*
+  Telnet client
+ 
+ This sketch connects to a a telnet server (http://www.google.com)
+ using an Arduino Wiznet Ethernet shield.  You'll need a telnet server 
+ to test this with.
+ Processing's ChatServer example (part of the network library) works well, 
+ running on port 10002. It can be found as part of the examples
+ in the Processing application, available at 
+ http://processing.org/
+ 
+ Circuit:
+ * Ethernet shield attached to pins 10, 11, 12, 13
+ 
+ created 14 Sep 2010
+ by Tom Igoe
+ 
+ */
+
+#include <SPI.h>
+#include <Ethernet.h>
+
+// Enter a MAC address and IP address for your controller below.
+// The IP address will be dependent on your local network:
+byte mac[] = {  
+  0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
+IPAddress ip(192,168,1,177);
+
+// Enter the IP address of the server you're connecting to:
+IPAddress server(1,1,1,1); 
+
+// Initialize the Ethernet client library
+// with the IP address and port of the server 
+// that you want to connect to (port 23 is default for telnet;
+// if you're using Processing's ChatServer, use  port 10002):
+Client client;
+
+void setup() {
+  // start the Ethernet connection:
+  Ethernet.begin(mac, ip);
+  // start the serial library:
+  Serial.begin(9600);
+  // give the Ethernet shield a second to initialize:
+  delay(1000);
+  Serial.println("connecting...");
+
+  // if you get a connection, report back via serial:
+  if (client.connect(server, 10002)) {
+    Serial.println("connected");
+  } 
+  else {
+    // if you didn't get a connection to the server:
+    Serial.println("connection failed");
+  }
+}
+
+void loop()
+{
+  // if there are incoming bytes available 
+  // from the server, read them and print them:
+  if (client.available()) {
+    char c = client.read();
+    Serial.print(c);
+  }
+
+  // as long as there are bytes in the serial queue,
+  // read them and send them out the socket if it's open:
+  while (Serial.available() > 0) {
+    char inChar = Serial.read();
+    if (client.connected()) {
+      client.print(inChar); 
+    }
+  }
+
+  // if the server's disconnected, stop the client:
+  if (!client.connected()) {
+    Serial.println();
+    Serial.println("disconnecting.");
+    client.stop();
+    // do nothing:
+    while(true);
+  }
+}
+
+
+
+
diff --git a/libraries/Ethernet/examples/UDPSendReceiveString/UDPSendReceiveString.pde b/libraries/Ethernet/examples/UDPSendReceiveString/UDPSendReceiveString.pde
new file mode 100644
index 0000000..081d691
--- /dev/null
+++ b/libraries/Ethernet/examples/UDPSendReceiveString/UDPSendReceiveString.pde
@@ -0,0 +1,118 @@
+/*
+  UDPSendReceive.pde:
+ This sketch receives UDP message strings, prints them to the serial port
+ and sends an "acknowledge" string back to the sender
+ 
+ A Processing sketch is included at the end of file that can be used to send 
+ and received messages for testing with a computer.
+ 
+ created 21 Aug 2010
+ by Michael Margolis
+ 
+ This code is in the public domain.
+ */
+
+
+#include <SPI.h>         // needed for Arduino versions later than 0018
+#include <Ethernet.h>
+#include <Udp.h>         // UDP library from: bjoern@cs.stanford.edu 12/30/2008
+
+
+// Enter a MAC address and IP address for your controller below.
+// The IP address will be dependent on your local network:
+byte mac[] = {  
+  0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
+IPAddress ip(192, 168, 1, 177);
+
+unsigned int localPort = 8888;      // local port to listen on
+
+// buffers for receiving and sending data
+char packetBuffer[UDP_TX_PACKET_MAX_SIZE]; //buffer to hold incoming packet,
+char  ReplyBuffer[] = "acknowledged";       // a string to send back
+
+// A UDP instance to let us send and receive packets over UDP
+UDP Udp;
+
+void setup() {
+  // start the Ethernet and UDP:
+  Ethernet.begin(mac,ip);
+  Udp.begin(localPort);
+
+  Serial.begin(9600);
+}
+
+void loop() {
+  // if there's data available, read a packet
+  int packetSize = Udp.parsePacket();
+  if(packetSize)
+  {
+    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());
+
+    // read the packet into packetBufffer
+    Udp.read(packetBuffer,UDP_TX_PACKET_MAX_SIZE);
+    Serial.println("Contents:");
+    Serial.println(packetBuffer);
+
+    // send a reply, to the IP address and port that sent us the packet we received
+    Udp.beginPacket(Udp.remoteIP(), Udp.remotePort());
+    Udp.write(ReplyBuffer);
+    Udp.endPacket();
+  }
+  delay(10);
+}
+
+
+/*
+  Processing sketch to run with this example
+ =====================================================
+ 
+ // Processing UDP example to send and receive string data from Arduino 
+ // press any key to send the "Hello Arduino" message
+ 
+ 
+ import hypermedia.net.*;
+ 
+ UDP udp;  // define the UDP object
+ 
+ 
+ void setup() {
+ udp = new UDP( this, 6000 );  // create a new datagram connection on port 6000
+ //udp.log( true ); 		// <-- printout the connection activity
+ udp.listen( true );           // and wait for incoming message  
+ }
+ 
+ void draw()
+ {
+ }
+ 
+ void keyPressed() {
+ String ip       = "192.168.1.177";	// the remote IP address
+ int port        = 8888;		// the destination port
+ 
+ udp.send("Hello World", ip, port );   // the message to send
+ 
+ }
+ 
+ void receive( byte[] data ) { 			// <-- default handler
+ //void receive( byte[] data, String ip, int port ) {	// <-- extended handler
+ 
+ for(int i=0; i < data.length; i++) 
+ print(char(data[i]));  
+ println();   
+ }
+ */
+
+
diff --git a/libraries/Ethernet/examples/UdpNtpClient/UdpNtpClient.pde b/libraries/Ethernet/examples/UdpNtpClient/UdpNtpClient.pde
new file mode 100644
index 0000000..7c2d3ea
--- /dev/null
+++ b/libraries/Ethernet/examples/UdpNtpClient/UdpNtpClient.pde
@@ -0,0 +1,136 @@
+/*
+
+ Udp NTP Client
+ 
+ Get the time from a Network Time Protocol (NTP) time server
+ Demonstrates use of UDP sendPacket and ReceivePacket 
+ For more on NTP time servers and the messages needed to communicate with them, 
+ see http://en.wikipedia.org/wiki/Network_Time_Protocol
+ 
+ created 4 Sep 2010 
+ by Michael Margolis
+ modified 17 Sep 2010
+ by Tom Igoe
+ 
+ This code is in the public domain.
+
+ */
+
+#include <SPI.h>         
+#include <Ethernet.h>
+#include <Udp.h>
+
+// Enter a MAC address for your controller below.
+// Newer Ethernet shields have a MAC address printed on a sticker on the shield
+byte mac[] = {  
+  0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
+
+unsigned int localPort = 8888;      // local port to listen for UDP packets
+
+IPAddress timeServer(192, 43, 244, 18); // time.nist.gov NTP server
+
+const int NTP_PACKET_SIZE= 48; // NTP time stamp is in the first 48 bytes of the message
+
+byte packetBuffer[ NTP_PACKET_SIZE]; //buffer to hold incoming and outgoing packets 
+
+// A UDP instance to let us send and receive packets over UDP
+UDP Udp;
+
+void setup() 
+{
+  Serial.begin(9600);
+
+  // start Ethernet and UDP
+  if (Ethernet.begin(mac) == 0) {
+    Serial.println("Failed to configure Ethernet using DHCP");
+    // no point in carrying on, so do nothing forevermore:
+    for(;;)
+      ;
+  }
+  Udp.begin(localPort);
+}
+
+void loop()
+{
+  sendNTPpacket(timeServer); // send an NTP packet to a time server
+
+    // wait to see if a reply is available
+  delay(1000);  
+  if ( Udp.parsePacket() ) {  
+    // We've received a packet, read the data from it
+    Udp.read(packetBuffer,NTP_PACKET_SIZE);  // read the packet into the buffer
+
+    //the timestamp starts at byte 40 of the received packet and is four bytes,
+    // or two words, long. First, esxtract the two words:
+
+    unsigned long highWord = word(packetBuffer[40], packetBuffer[41]);
+    unsigned long lowWord = word(packetBuffer[42], packetBuffer[43]);  
+    // combine the four bytes (two words) into a long integer
+    // this is NTP time (seconds since Jan 1 1900):
+    unsigned long secsSince1900 = highWord << 16 | lowWord;  
+    Serial.print("Seconds since Jan 1 1900 = " );
+    Serial.println(secsSince1900);               
+
+    // now convert NTP time into everyday time:
+    Serial.print("Unix time = ");
+    // Unix time starts on Jan 1 1970. In seconds, that's 2208988800:
+    const unsigned long seventyYears = 2208988800UL;     
+    // subtract seventy years:
+    unsigned long epoch = secsSince1900 - seventyYears;  
+    // print Unix time:
+    Serial.println(epoch);                               
+
+
+    // print the hour, minute and second:
+    Serial.print("The UTC time is ");       // UTC is the time at Greenwich Meridian (GMT)
+    Serial.print((epoch  % 86400L) / 3600); // print the hour (86400 equals secs per day)
+    Serial.print(':');  
+    if ( ((epoch % 3600) / 60) < 10 ) {
+      // In the first 10 minutes of each hour, we'll want a leading '0'
+      Serial.print('0');
+    }
+    Serial.print((epoch  % 3600) / 60); // print the minute (3600 equals secs per minute)
+    Serial.print(':'); 
+    if ( (epoch % 60) < 10 ) {
+      // In the first 10 seconds of each minute, we'll want a leading '0'
+      Serial.print('0');
+    }
+    Serial.println(epoch %60); // print the second
+  }
+  // wait ten seconds before asking for the time again
+  delay(10000); 
+}
+
+// send an NTP request to the time server at the given address 
+unsigned long sendNTPpacket(IPAddress& address)
+{
+  // set all bytes in the buffer to 0
+  memset(packetBuffer, 0, NTP_PACKET_SIZE); 
+  // Initialize values needed to form NTP request
+  // (see URL above for details on the packets)
+  packetBuffer[0] = 0b11100011;   // LI, Version, Mode
+  packetBuffer[1] = 0;     // Stratum, or type of clock
+  packetBuffer[2] = 6;     // Polling Interval
+  packetBuffer[3] = 0xEC;  // Peer Clock Precision
+  // 8 bytes of zero for Root Delay & Root Dispersion
+  packetBuffer[12]  = 49; 
+  packetBuffer[13]  = 0x4E;
+  packetBuffer[14]  = 49;
+  packetBuffer[15]  = 52;
+
+  // all NTP fields have been given values, now
+  // you can send a packet requesting a timestamp: 		   
+  Udp.beginPacket(address, 123); //NTP requests are to port 123
+  Udp.write(packetBuffer,NTP_PACKET_SIZE);
+  Udp.endPacket(); 
+}
+
+
+
+
+
+
+
+
+
+
diff --git a/libraries/Ethernet/examples/WebClient/WebClient.pde b/libraries/Ethernet/examples/WebClient/WebClient.pde
new file mode 100644
index 0000000..646c3aa
--- /dev/null
+++ b/libraries/Ethernet/examples/WebClient/WebClient.pde
@@ -0,0 +1,75 @@
+/*
+  Web client
+ 
+ This sketch connects to a website (http://www.google.com)
+ using an Arduino Wiznet Ethernet shield. 
+ 
+ Circuit:
+ * Ethernet shield attached to pins 10, 11, 12, 13
+ 
+ created 18 Dec 2009
+ by David A. Mellis
+ 
+ */
+
+#include <SPI.h>
+#include <Ethernet.h>
+
+// Enter a MAC address for your controller below.
+// Newer Ethernet shields have a MAC address printed on a sticker on the shield
+byte mac[] = {  0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
+IPAddress server(173,194,33,104); // Google
+
+// Initialize the Ethernet client library
+// with the IP address and port of the server 
+// that you want to connect to (port 80 is default for HTTP):
+Client client;
+
+void setup() {
+  // start the serial library:
+  Serial.begin(9600);
+  // start the Ethernet connection:
+  if (Ethernet.begin(mac) == 0) {
+    Serial.println("Failed to configure Ethernet using DHCP");
+    // no point in carrying on, so do nothing forevermore:
+    for(;;)
+      ;
+  }
+  // give the Ethernet shield a second to initialize:
+  delay(1000);
+  Serial.println("connecting...");
+
+  // if you get a connection, report back via serial:
+  if (client.connect(server, 80)) {
+    Serial.println("connected");
+    // Make a HTTP request:
+    client.println("GET /search?q=arduino HTTP/1.0");
+    client.println();
+  } 
+  else {
+    // kf you didn't get a connection to the server:
+    Serial.println("connection failed");
+  }
+}
+
+void loop()
+{
+  // if there are incoming bytes available 
+  // from the server, read them and print them:
+  if (client.available()) {
+    char c = client.read();
+    Serial.print(c);
+  }
+
+  // if the server's disconnected, stop the client:
+  if (!client.connected()) {
+    Serial.println();
+    Serial.println("disconnecting.");
+    client.stop();
+
+    // do nothing forevermore:
+    for(;;)
+      ;
+  }
+}
+
diff --git a/libraries/Ethernet/examples/WebServer/WebServer.pde b/libraries/Ethernet/examples/WebServer/WebServer.pde
new file mode 100644
index 0000000..c69a56a
--- /dev/null
+++ b/libraries/Ethernet/examples/WebServer/WebServer.pde
@@ -0,0 +1,82 @@
+/*
+  Web  Server
+ 
+ A simple web server that shows the value of the analog input pins.
+ using an Arduino Wiznet Ethernet shield. 
+ 
+ Circuit:
+ * Ethernet shield attached to pins 10, 11, 12, 13
+ * Analog inputs attached to pins A0 through A5 (optional)
+ 
+ created 18 Dec 2009
+ by David A. Mellis
+ modified 4 Sep 2010
+ by Tom Igoe
+ 
+ */
+
+#include <SPI.h>
+#include <Ethernet.h>
+
+// Enter a MAC address and IP address for your controller below.
+// The IP address will be dependent on your local network:
+byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
+IPAddress ip(192,168,1, 177);
+
+// Initialize the Ethernet server library
+// with the IP address and port you want to use 
+// (port 80 is default for HTTP):
+Server server(80);
+
+void setup()
+{
+  // start the Ethernet connection and the server:
+  Ethernet.begin(mac, ip);
+  server.begin();
+}
+
+void loop()
+{
+  // listen for incoming clients
+  Client client = server.available();
+  if (client) {
+    // an http request ends with a blank line
+    boolean currentLineIsBlank = true;
+    while (client.connected()) {
+      if (client.available()) {
+        char c = client.read();
+        // if you've gotten to the end of the line (received a newline
+        // character) and the line is blank, the http request has ended,
+        // so you can send a reply
+        if (c == '\n' && currentLineIsBlank) {
+          // send a standard http response header
+          client.println("HTTP/1.1 200 OK");
+          client.println("Content-Type: text/html");
+          client.println();
+
+          // output the value of each analog input pin
+          for (int analogChannel = 0; analogChannel < 6; analogChannel++) {
+            client.print("analog input ");
+            client.print(analogChannel);
+            client.print(" is ");
+            client.print(analogRead(analogChannel));
+            client.println("<br />");
+          }
+          break;
+        }
+        if (c == '\n') {
+          // you're starting a new line
+          currentLineIsBlank = true;
+        } 
+        else if (c != '\r') {
+          // you've gotten a character on the current line
+          currentLineIsBlank = false;
+        }
+      }
+    }
+    // give the web browser time to receive the data
+    delay(1);
+    // close the connection:
+    client.stop();
+  }
+}
diff --git a/libraries/Ethernet/keywords.txt b/libraries/Ethernet/keywords.txt
new file mode 100644
index 0000000..7fdcedf
--- /dev/null
+++ b/libraries/Ethernet/keywords.txt
@@ -0,0 +1,37 @@
+#######################################
+# Syntax Coloring Map For Ethernet
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+Ethernet	KEYWORD1
+Client	KEYWORD1
+Server	KEYWORD1
+IPAddress	KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+
+status	KEYWORD2
+connect	KEYWORD2
+write	KEYWORD2
+available	KEYWORD2
+read	KEYWORD2
+peek	KEYWORD2
+flush	KEYWORD2
+stop	KEYWORD2
+connected	KEYWORD2
+begin	KEYWORD2
+beginPacket	KEYWORD2
+endPacket	KEYWORD2
+parsePacket	KEYWORD2
+remoteIP	KEYWORD2
+remotePort	KEYWORD2
+
+#######################################
+# Constants (LITERAL1)
+#######################################
+
diff --git a/libraries/Ethernet/util.h b/libraries/Ethernet/util.h
new file mode 100644
index 0000000..220011b
--- /dev/null
+++ b/libraries/Ethernet/util.h
@@ -0,0 +1,13 @@
+#ifndef UTIL_H
+#define UTIL_H
+
+#define htons(x) ( (x)<<8 | ((x)>>8)&0xFF )
+#define ntohs(x) htons(x)
+
+#define htonl(x) ( ((x)<<24 & 0xFF000000UL) | \
+                   ((x)<< 8 & 0x00FF0000UL) | \
+                   ((x)>> 8 & 0x0000FF00UL) | \
+                   ((x)>>24 & 0x000000FFUL) )
+#define ntohl(x) htonl(x)
+
+#endif
diff --git a/libraries/Ethernet/utility/socket.cpp b/libraries/Ethernet/utility/socket.cpp
new file mode 100644
index 0000000..4875845
--- /dev/null
+++ b/libraries/Ethernet/utility/socket.cpp
@@ -0,0 +1,401 @@
+#include "w5100.h"
+#include "socket.h"
+
+static uint16_t local_port;
+
+/**
+ * @brief	This Socket function initialize the channel in perticular mode, and set the port and wait for W5100 done it.
+ * @return 	1 for success else 0.
+ */
+uint8_t socket(SOCKET s, uint8_t protocol, uint16_t port, uint8_t flag)
+{
+  uint8_t ret;
+  if ((protocol == SnMR::TCP) || (protocol == SnMR::UDP) || (protocol == SnMR::IPRAW) || (protocol == SnMR::MACRAW) || (protocol == SnMR::PPPOE))
+  {
+    close(s);
+    W5100.writeSnMR(s, protocol | flag);
+    if (port != 0) {
+      W5100.writeSnPORT(s, port);
+    } 
+    else {
+      local_port++; // if don't set the source port, set local_port number.
+      W5100.writeSnPORT(s, local_port);
+    }
+
+    W5100.execCmdSn(s, Sock_OPEN);
+    
+    return 1;
+  }
+
+  return 0;
+}
+
+
+/**
+ * @brief	This function close the socket and parameter is "s" which represent the socket number
+ */
+void close(SOCKET s)
+{
+  W5100.execCmdSn(s, Sock_CLOSE);
+  W5100.writeSnIR(s, 0xFF);
+}
+
+
+/**
+ * @brief	This function established  the connection for the channel in passive (server) mode. This function waits for the request from the peer.
+ * @return	1 for success else 0.
+ */
+uint8_t listen(SOCKET s)
+{
+  if (W5100.readSnSR(s) != SnSR::INIT)
+    return 0;
+  W5100.execCmdSn(s, Sock_LISTEN);
+  return 1;
+}
+
+
+/**
+ * @brief	This function established  the connection for the channel in Active (client) mode. 
+ * 		This function waits for the untill the connection is established.
+ * 		
+ * @return	1 for success else 0.
+ */
+uint8_t connect(SOCKET s, uint8_t * addr, uint16_t port)
+{
+  if 
+    (
+  ((addr[0] == 0xFF) && (addr[1] == 0xFF) && (addr[2] == 0xFF) && (addr[3] == 0xFF)) ||
+    ((addr[0] == 0x00) && (addr[1] == 0x00) && (addr[2] == 0x00) && (addr[3] == 0x00)) ||
+    (port == 0x00) 
+    ) 
+    return 0;
+
+  // set destination IP
+  W5100.writeSnDIPR(s, addr);
+  W5100.writeSnDPORT(s, port);
+  W5100.execCmdSn(s, Sock_CONNECT);
+
+  return 1;
+}
+
+
+
+/**
+ * @brief	This function used for disconnect the socket and parameter is "s" which represent the socket number
+ * @return	1 for success else 0.
+ */
+void disconnect(SOCKET s)
+{
+  W5100.execCmdSn(s, Sock_DISCON);
+}
+
+
+/**
+ * @brief	This function used to send the data in TCP mode
+ * @return	1 for success else 0.
+ */
+uint16_t send(SOCKET s, const uint8_t * buf, uint16_t len)
+{
+  uint8_t status=0;
+  uint16_t ret=0;
+  uint16_t freesize=0;
+
+  if (len > W5100.SSIZE) 
+    ret = W5100.SSIZE; // check size not to exceed MAX size.
+  else 
+    ret = len;
+
+  // if freebuf is available, start.
+  do 
+  {
+    freesize = W5100.getTXFreeSize(s);
+    status = W5100.readSnSR(s);
+    if ((status != SnSR::ESTABLISHED) && (status != SnSR::CLOSE_WAIT))
+    {
+      ret = 0; 
+      break;
+    }
+  } 
+  while (freesize < ret);
+
+  // copy data
+  W5100.send_data_processing(s, (uint8_t *)buf, ret);
+  W5100.execCmdSn(s, Sock_SEND);
+
+  /* +2008.01 bj */
+  while ( (W5100.readSnIR(s) & SnIR::SEND_OK) != SnIR::SEND_OK ) 
+  {
+    /* m2008.01 [bj] : reduce code */
+    if ( W5100.readSnSR(s) == SnSR::CLOSED )
+    {
+      close(s);
+      return 0;
+    }
+  }
+  /* +2008.01 bj */
+  W5100.writeSnIR(s, SnIR::SEND_OK);
+  return ret;
+}
+
+
+/**
+ * @brief	This function is an application I/F function which is used to receive the data in TCP mode.
+ * 		It continues to wait for data as much as the application wants to receive.
+ * 		
+ * @return	received data size for success else -1.
+ */
+uint16_t recv(SOCKET s, uint8_t *buf, uint16_t len)
+{
+  // Check how much data is available
+  uint16_t ret = W5100.getRXReceivedSize(s);
+  if ( ret == 0 )
+  {
+    // No data available.
+    uint8_t status = W5100.readSnSR(s);
+    if ( s == SnSR::LISTEN || s == SnSR::CLOSED || s == SnSR::CLOSE_WAIT )
+    {
+      // The remote end has closed its side of the connection, so this is the eof state
+      ret = 0;
+    }
+    else
+    {
+      // The connection is still up, but there's no data waiting to be read
+      ret = -1;
+    }
+  }
+  else if (ret > len)
+  {
+    ret = len;
+  }
+
+  if ( ret > 0 )
+  {
+    W5100.recv_data_processing(s, buf, ret);
+    W5100.execCmdSn(s, Sock_RECV);
+  }
+  return ret;
+}
+
+
+/**
+ * @brief	Returns the first byte in the receive queue (no checking)
+ * 		
+ * @return
+ */
+uint16_t peek(SOCKET s, uint8_t *buf)
+{
+  W5100.recv_data_processing(s, buf, 1, 1);
+
+  return 1;
+}
+
+
+/**
+ * @brief	This function is an application I/F function which is used to send the data for other then TCP mode. 
+ * 		Unlike TCP transmission, The peer's destination address and the port is needed.
+ * 		
+ * @return	This function return send data size for success else -1.
+ */
+uint16_t sendto(SOCKET s, const uint8_t *buf, uint16_t len, uint8_t *addr, uint16_t port)
+{
+  uint16_t ret=0;
+
+  if (len > W5100.SSIZE) ret = W5100.SSIZE; // check size not to exceed MAX size.
+  else ret = len;
+
+  if
+    (
+  ((addr[0] == 0x00) && (addr[1] == 0x00) && (addr[2] == 0x00) && (addr[3] == 0x00)) ||
+    ((port == 0x00)) ||(ret == 0)
+    ) 
+  {
+    /* +2008.01 [bj] : added return value */
+    ret = 0;
+  }
+  else
+  {
+    W5100.writeSnDIPR(s, addr);
+    W5100.writeSnDPORT(s, port);
+
+    // copy data
+    W5100.send_data_processing(s, (uint8_t *)buf, ret);
+    W5100.execCmdSn(s, Sock_SEND);
+
+    /* +2008.01 bj */
+    while ( (W5100.readSnIR(s) & SnIR::SEND_OK) != SnIR::SEND_OK ) 
+    {
+      if (W5100.readSnIR(s) & SnIR::TIMEOUT)
+      {
+        /* +2008.01 [bj]: clear interrupt */
+        W5100.writeSnIR(s, (SnIR::SEND_OK | SnIR::TIMEOUT)); /* clear SEND_OK & TIMEOUT */
+        return 0;
+      }
+    }
+
+    /* +2008.01 bj */
+    W5100.writeSnIR(s, SnIR::SEND_OK);
+  }
+  return ret;
+}
+
+
+/**
+ * @brief	This function is an application I/F function which is used to receive the data in other then
+ * 	TCP mode. This function is used to receive UDP, IP_RAW and MAC_RAW mode, and handle the header as well. 
+ * 	
+ * @return	This function return received data size for success else -1.
+ */
+uint16_t recvfrom(SOCKET s, uint8_t *buf, uint16_t len, uint8_t *addr, uint16_t *port)
+{
+  uint8_t head[8];
+  uint16_t data_len=0;
+  uint16_t ptr=0;
+
+  if ( len > 0 )
+  {
+    ptr = W5100.readSnRX_RD(s);
+    switch (W5100.readSnMR(s) & 0x07)
+    {
+    case SnMR::UDP :
+      W5100.read_data(s, (uint8_t *)ptr, head, 0x08);
+      ptr += 8;
+      // read peer's IP address, port number.
+      addr[0] = head[0];
+      addr[1] = head[1];
+      addr[2] = head[2];
+      addr[3] = head[3];
+      *port = head[4];
+      *port = (*port << 8) + head[5];
+      data_len = head[6];
+      data_len = (data_len << 8) + head[7];
+
+      W5100.read_data(s, (uint8_t *)ptr, buf, data_len); // data copy.
+      ptr += data_len;
+
+      W5100.writeSnRX_RD(s, ptr);
+      break;
+
+    case SnMR::IPRAW :
+      W5100.read_data(s, (uint8_t *)ptr, head, 0x06);
+      ptr += 6;
+
+      addr[0] = head[0];
+      addr[1] = head[1];
+      addr[2] = head[2];
+      addr[3] = head[3];
+      data_len = head[4];
+      data_len = (data_len << 8) + head[5];
+
+      W5100.read_data(s, (uint8_t *)ptr, buf, data_len); // data copy.
+      ptr += data_len;
+
+      W5100.writeSnRX_RD(s, ptr);
+      break;
+
+    case SnMR::MACRAW:
+      W5100.read_data(s,(uint8_t*)ptr,head,2);
+      ptr+=2;
+      data_len = head[0];
+      data_len = (data_len<<8) + head[1] - 2;
+
+      W5100.read_data(s,(uint8_t*) ptr,buf,data_len);
+      ptr += data_len;
+      W5100.writeSnRX_RD(s, ptr);
+      break;
+
+    default :
+      break;
+    }
+    W5100.execCmdSn(s, Sock_RECV);
+  }
+  return data_len;
+}
+
+
+uint16_t igmpsend(SOCKET s, const uint8_t * buf, uint16_t len)
+{
+  uint8_t status=0;
+  uint16_t ret=0;
+
+  if (len > W5100.SSIZE) 
+    ret = W5100.SSIZE; // check size not to exceed MAX size.
+  else 
+    ret = len;
+
+  if (ret == 0)
+    return 0;
+
+  W5100.send_data_processing(s, (uint8_t *)buf, ret);
+  W5100.execCmdSn(s, Sock_SEND);
+
+  while ( (W5100.readSnIR(s) & SnIR::SEND_OK) != SnIR::SEND_OK ) 
+  {
+    status = W5100.readSnSR(s);
+    if (W5100.readSnIR(s) & SnIR::TIMEOUT)
+    {
+      /* in case of igmp, if send fails, then socket closed */
+      /* if you want change, remove this code. */
+      close(s);
+      return 0;
+    }
+  }
+
+  W5100.writeSnIR(s, SnIR::SEND_OK);
+  return ret;
+}
+
+uint16_t bufferData(SOCKET s, uint16_t offset, const uint8_t* buf, uint16_t len)
+{
+  uint16_t ret =0;
+  if (len > W5100.getTXFreeSize(s))
+  {
+    ret = W5100.getTXFreeSize(s); // check size not to exceed MAX size.
+  }
+  else
+  {
+    ret = len;
+  }
+  W5100.send_data_processing_offset(s, offset, buf, ret);
+  return ret;
+}
+
+int startUDP(SOCKET s, uint8_t* addr, uint16_t port)
+{
+  if
+    (
+     ((addr[0] == 0x00) && (addr[1] == 0x00) && (addr[2] == 0x00) && (addr[3] == 0x00)) ||
+     ((port == 0x00))
+    ) 
+  {
+    return 0;
+  }
+  else
+  {
+    W5100.writeSnDIPR(s, addr);
+    W5100.writeSnDPORT(s, port);
+    return 1;
+  }
+}
+
+int sendUDP(SOCKET s)
+{
+  W5100.execCmdSn(s, Sock_SEND);
+		
+  /* +2008.01 bj */
+  while ( (W5100.readSnIR(s) & SnIR::SEND_OK) != SnIR::SEND_OK ) 
+  {
+    if (W5100.readSnIR(s) & SnIR::TIMEOUT)
+    {
+      /* +2008.01 [bj]: clear interrupt */
+      W5100.writeSnIR(s, (SnIR::SEND_OK|SnIR::TIMEOUT));
+      return 0;
+    }
+  }
+
+  /* +2008.01 bj */	
+  W5100.writeSnIR(s, SnIR::SEND_OK);
+
+  /* Sent ok */
+  return 1;
+}
+
diff --git a/libraries/Ethernet/utility/socket.h b/libraries/Ethernet/utility/socket.h
new file mode 100755
index 0000000..37ea93f
--- /dev/null
+++ b/libraries/Ethernet/utility/socket.h
@@ -0,0 +1,41 @@
+#ifndef	_SOCKET_H_
+#define	_SOCKET_H_
+
+#include "w5100.h"
+
+extern uint8_t socket(SOCKET s, uint8_t protocol, uint16_t port, uint8_t flag); // Opens a socket(TCP or UDP or IP_RAW mode)
+extern void close(SOCKET s); // Close socket
+extern uint8_t connect(SOCKET s, uint8_t * addr, uint16_t port); // Establish TCP connection (Active connection)
+extern void disconnect(SOCKET s); // disconnect the connection
+extern uint8_t listen(SOCKET s);	// Establish TCP connection (Passive connection)
+extern uint16_t send(SOCKET s, const uint8_t * buf, uint16_t len); // Send data (TCP)
+extern uint16_t recv(SOCKET s, uint8_t * buf, uint16_t len);	// Receive data (TCP)
+extern uint16_t peek(SOCKET s, uint8_t *buf);
+extern uint16_t sendto(SOCKET s, const uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t port); // Send data (UDP/IP RAW)
+extern uint16_t recvfrom(SOCKET s, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t *port); // Receive data (UDP/IP RAW)
+
+extern uint16_t igmpsend(SOCKET s, const uint8_t * buf, uint16_t len);
+
+// Functions to allow buffered UDP send (i.e. where the UDP datagram is built up over a
+// number of calls before being sent
+/*
+  @brief This function sets up a UDP datagram, the data for which will be provided by one
+  or more calls to bufferData and then finally sent with sendUDP.
+  @return 1 if the datagram was successfully set up, or 0 if there was an error
+*/
+extern int startUDP(SOCKET s, uint8_t* addr, uint16_t port);
+/*
+  @brief This function copies up to len bytes of data from buf into a UDP datagram to be
+  sent later by sendUDP.  Allows datagrams to be built up from a series of bufferData calls.
+  @return Number of bytes successfully buffered
+*/
+uint16_t bufferData(SOCKET s, uint16_t offset, const uint8_t* buf, uint16_t len);
+/*
+  @brief Send a UDP datagram built up from a sequence of startUDP followed by one or more
+  calls to bufferData.
+  @return 1 if the datagram was successfully sent, or 0 if there was an error
+*/
+int sendUDP(SOCKET s);
+
+#endif
+/* _SOCKET_H_ */
diff --git a/libraries/Ethernet/utility/w5100.cpp b/libraries/Ethernet/utility/w5100.cpp
new file mode 100644
index 0000000..aafabae
--- /dev/null
+++ b/libraries/Ethernet/utility/w5100.cpp
@@ -0,0 +1,188 @@
+/*
+ * Copyright (c) 2010 by Cristian Maglie <c.maglie@bug.st>
+ *
+ * This file is free software; you can redistribute it and/or modify
+ * it under the terms of either the GNU General Public License version 2
+ * or the GNU Lesser General Public License version 2.1, both as
+ * published by the Free Software Foundation.
+ */
+
+#include <stdio.h>
+#include <string.h>
+#include <avr/interrupt.h>
+
+#include "w5100.h"
+
+// W5100 controller instance
+W5100Class W5100;
+
+#define TX_RX_MAX_BUF_SIZE 2048
+#define TX_BUF 0x1100
+#define RX_BUF (TX_BUF + TX_RX_MAX_BUF_SIZE)
+
+#define TXBUF_BASE 0x4000
+#define RXBUF_BASE 0x6000
+
+void W5100Class::init(void)
+{
+  delay(300);
+
+  SPI.begin();
+  initSS();
+  
+  writeMR(1<<RST);
+  writeTMSR(0x55);
+  writeRMSR(0x55);
+
+  for (int i=0; i<MAX_SOCK_NUM; i++) {
+    SBASE[i] = TXBUF_BASE + SSIZE * i;
+    RBASE[i] = RXBUF_BASE + RSIZE * i;
+  }
+}
+
+uint16_t W5100Class::getTXFreeSize(SOCKET s)
+{
+  uint16_t val=0, val1=0;
+  do {
+    val1 = readSnTX_FSR(s);
+    if (val1 != 0)
+      val = readSnTX_FSR(s);
+  } 
+  while (val != val1);
+  return val;
+}
+
+uint16_t W5100Class::getRXReceivedSize(SOCKET s)
+{
+  uint16_t val=0,val1=0;
+  do {
+    val1 = readSnRX_RSR(s);
+    if (val1 != 0)
+      val = readSnRX_RSR(s);
+  } 
+  while (val != val1);
+  return val;
+}
+
+
+void W5100Class::send_data_processing(SOCKET s, const uint8_t *data, uint16_t len)
+{
+  // This is same as having no offset in a call to send_data_processing_offset
+  send_data_processing_offset(s, 0, data, len);
+}
+
+void W5100Class::send_data_processing_offset(SOCKET s, uint16_t data_offset, const uint8_t *data, uint16_t len)
+{
+  uint16_t ptr = readSnTX_WR(s);
+  ptr += data_offset;
+  uint16_t offset = ptr & SMASK;
+  uint16_t dstAddr = offset + SBASE[s];
+
+  if (offset + len > SSIZE) 
+  {
+    // Wrap around circular buffer
+    uint16_t size = SSIZE - offset;
+    write(dstAddr, data, size);
+    write(SBASE[s], data + size, len - size);
+  } 
+  else {
+    write(dstAddr, data, len);
+  }
+
+  ptr += len;
+  writeSnTX_WR(s, ptr);
+}
+
+
+void W5100Class::recv_data_processing(SOCKET s, uint8_t *data, uint16_t len, uint8_t peek)
+{
+  uint16_t ptr;
+  ptr = readSnRX_RD(s);
+  read_data(s, (uint8_t *)ptr, data, len);
+  if (!peek)
+  {
+    ptr += len;
+    writeSnRX_RD(s, ptr);
+  }
+}
+
+void W5100Class::read_data(SOCKET s, volatile uint8_t *src, volatile uint8_t *dst, uint16_t len)
+{
+  uint16_t size;
+  uint16_t src_mask;
+  uint16_t src_ptr;
+
+  src_mask = (uint16_t)src & RMASK;
+  src_ptr = RBASE[s] + src_mask;
+
+  if( (src_mask + len) > RSIZE ) 
+  {
+    size = RSIZE - src_mask;
+    read(src_ptr, (uint8_t *)dst, size);
+    dst += size;
+    read(RBASE[s], (uint8_t *) dst, len - size);
+  } 
+  else
+    read(src_ptr, (uint8_t *) dst, len);
+}
+
+
+uint8_t W5100Class::write(uint16_t _addr, uint8_t _data)
+{
+  setSS();  
+  SPI.transfer(0xF0);
+  SPI.transfer(_addr >> 8);
+  SPI.transfer(_addr & 0xFF);
+  SPI.transfer(_data);
+  resetSS();
+  return 1;
+}
+
+uint16_t W5100Class::write(uint16_t _addr, const uint8_t *_buf, uint16_t _len)
+{
+  for (int i=0; i<_len; i++)
+  {
+    setSS();    
+    SPI.transfer(0xF0);
+    SPI.transfer(_addr >> 8);
+    SPI.transfer(_addr & 0xFF);
+    _addr++;
+    SPI.transfer(_buf[i]);
+    resetSS();
+  }
+  return _len;
+}
+
+uint8_t W5100Class::read(uint16_t _addr)
+{
+  setSS();  
+  SPI.transfer(0x0F);
+  SPI.transfer(_addr >> 8);
+  SPI.transfer(_addr & 0xFF);
+  uint8_t _data = SPI.transfer(0);
+  resetSS();
+  return _data;
+}
+
+uint16_t W5100Class::read(uint16_t _addr, uint8_t *_buf, uint16_t _len)
+{
+  for (int i=0; i<_len; i++)
+  {
+    setSS();
+    SPI.transfer(0x0F);
+    SPI.transfer(_addr >> 8);
+    SPI.transfer(_addr & 0xFF);
+    _addr++;
+    _buf[i] = SPI.transfer(0);
+    resetSS();
+  }
+  return _len;
+}
+
+void W5100Class::execCmdSn(SOCKET s, SockCMD _cmd) {
+  // Send command to socket
+  writeSnCR(s, _cmd);
+  // Wait for command to complete
+  while (readSnCR(s))
+    ;
+}
diff --git a/libraries/Ethernet/utility/w5100.h b/libraries/Ethernet/utility/w5100.h
new file mode 100755
index 0000000..9872c7c
--- /dev/null
+++ b/libraries/Ethernet/utility/w5100.h
@@ -0,0 +1,393 @@
+/*
+ * Copyright (c) 2010 by Cristian Maglie <c.maglie@bug.st>
+ *
+ * This file is free software; you can redistribute it and/or modify
+ * it under the terms of either the GNU General Public License version 2
+ * or the GNU Lesser General Public License version 2.1, both as
+ * published by the Free Software Foundation.
+ */
+
+#ifndef	W5100_H_INCLUDED
+#define	W5100_H_INCLUDED
+
+#include <avr/pgmspace.h>
+#include <SPI.h>
+
+#define MAX_SOCK_NUM 4
+
+typedef uint8_t SOCKET;
+
+#define IDM_OR  0x8000
+#define IDM_AR0 0x8001
+#define IDM_AR1 0x8002
+#define IDM_DR  0x8003
+/*
+class MR {
+public:
+  static const uint8_t RST   = 0x80;
+  static const uint8_t PB    = 0x10;
+  static const uint8_t PPPOE = 0x08;
+  static const uint8_t LB    = 0x04;
+  static const uint8_t AI    = 0x02;
+  static const uint8_t IND   = 0x01;
+};
+*/
+/*
+class IR {
+public:
+  static const uint8_t CONFLICT = 0x80;
+  static const uint8_t UNREACH  = 0x40;
+  static const uint8_t PPPoE    = 0x20;
+  static const uint8_t SOCK0    = 0x01;
+  static const uint8_t SOCK1    = 0x02;
+  static const uint8_t SOCK2    = 0x04;
+  static const uint8_t SOCK3    = 0x08;
+  static inline uint8_t SOCK(SOCKET ch) { return (0x01 << ch); };
+};
+*/
+
+class SnMR {
+public:
+  static const uint8_t CLOSE  = 0x00;
+  static const uint8_t TCP    = 0x01;
+  static const uint8_t UDP    = 0x02;
+  static const uint8_t IPRAW  = 0x03;
+  static const uint8_t MACRAW = 0x04;
+  static const uint8_t PPPOE  = 0x05;
+  static const uint8_t ND     = 0x20;
+  static const uint8_t MULTI  = 0x80;
+};
+
+enum SockCMD {
+  Sock_OPEN      = 0x01,
+  Sock_LISTEN    = 0x02,
+  Sock_CONNECT   = 0x04,
+  Sock_DISCON    = 0x08,
+  Sock_CLOSE     = 0x10,
+  Sock_SEND      = 0x20,
+  Sock_SEND_MAC  = 0x21,
+  Sock_SEND_KEEP = 0x22,
+  Sock_RECV      = 0x40
+};
+
+/*class SnCmd {
+public:
+  static const uint8_t OPEN      = 0x01;
+  static const uint8_t LISTEN    = 0x02;
+  static const uint8_t CONNECT   = 0x04;
+  static const uint8_t DISCON    = 0x08;
+  static const uint8_t CLOSE     = 0x10;
+  static const uint8_t SEND      = 0x20;
+  static const uint8_t SEND_MAC  = 0x21;
+  static const uint8_t SEND_KEEP = 0x22;
+  static const uint8_t RECV      = 0x40;
+};
+*/
+
+class SnIR {
+public:
+  static const uint8_t SEND_OK = 0x10;
+  static const uint8_t TIMEOUT = 0x08;
+  static const uint8_t RECV    = 0x04;
+  static const uint8_t DISCON  = 0x02;
+  static const uint8_t CON     = 0x01;
+};
+
+class SnSR {
+public:
+  static const uint8_t CLOSED      = 0x00;
+  static const uint8_t INIT        = 0x13;
+  static const uint8_t LISTEN      = 0x14;
+  static const uint8_t SYNSENT     = 0x15;
+  static const uint8_t SYNRECV     = 0x16;
+  static const uint8_t ESTABLISHED = 0x17;
+  static const uint8_t FIN_WAIT    = 0x18;
+  static const uint8_t CLOSING     = 0x1A;
+  static const uint8_t TIME_WAIT   = 0x1B;
+  static const uint8_t CLOSE_WAIT  = 0x1C;
+  static const uint8_t LAST_ACK    = 0x1D;
+  static const uint8_t UDP         = 0x22;
+  static const uint8_t IPRAW       = 0x32;
+  static const uint8_t MACRAW      = 0x42;
+  static const uint8_t PPPOE       = 0x5F;
+};
+
+class IPPROTO {
+public:
+  static const uint8_t IP   = 0;
+  static const uint8_t ICMP = 1;
+  static const uint8_t IGMP = 2;
+  static const uint8_t GGP  = 3;
+  static const uint8_t TCP  = 6;
+  static const uint8_t PUP  = 12;
+  static const uint8_t UDP  = 17;
+  static const uint8_t IDP  = 22;
+  static const uint8_t ND   = 77;
+  static const uint8_t RAW  = 255;
+};
+
+class W5100Class {
+
+public:
+  void init();
+
+  /**
+   * @brief	This function is being used for copy the data form Receive buffer of the chip to application buffer.
+   * 
+   * It calculate the actual physical address where one has to read
+   * the data from Receive buffer. Here also take care of the condition while it exceed
+   * the Rx memory uper-bound of socket.
+   */
+  void read_data(SOCKET s, volatile uint8_t * src, volatile uint8_t * dst, uint16_t len);
+  
+  /**
+   * @brief	 This function is being called by send() and sendto() function also. 
+   * 
+   * This function read the Tx write pointer register and after copy the data in buffer update the Tx write pointer
+   * register. User should read upper byte first and lower byte later to get proper value.
+   */
+  void send_data_processing(SOCKET s, const uint8_t *data, uint16_t len);
+  /**
+   * @brief A copy of send_data_processing that uses the provided ptr for the
+   *        write offset.  Only needed for the "streaming" UDP API, where
+   *        a single UDP packet is built up over a number of calls to
+   *        send_data_processing_ptr, because TX_WR doesn't seem to get updated
+   *        correctly in those scenarios
+   * @param ptr value to use in place of TX_WR.  If 0, then the value is read
+   *        in from TX_WR
+   * @return New value for ptr, to be used in the next call
+   */
+// FIXME Update documentation
+  void send_data_processing_offset(SOCKET s, uint16_t data_offset, const uint8_t *data, uint16_t len);
+
+  /**
+   * @brief	This function is being called by recv() also.
+   * 
+   * This function read the Rx read pointer register
+   * and after copy the data from receive buffer update the Rx write pointer register.
+   * User should read upper byte first and lower byte later to get proper value.
+   */
+  void recv_data_processing(SOCKET s, uint8_t *data, uint16_t len, uint8_t peek = 0);
+
+  inline void setGatewayIp(uint8_t *_addr);
+  inline void getGatewayIp(uint8_t *_addr);
+
+  inline void setSubnetMask(uint8_t *_addr);
+  inline void getSubnetMask(uint8_t *_addr);
+
+  inline void setMACAddress(uint8_t * addr);
+  inline void getMACAddress(uint8_t * addr);
+
+  inline void setIPAddress(uint8_t * addr);
+  inline void getIPAddress(uint8_t * addr);
+
+  inline void setRetransmissionTime(uint16_t timeout);
+  inline void setRetransmissionCount(uint8_t _retry);
+
+  void execCmdSn(SOCKET s, SockCMD _cmd);
+  
+  uint16_t getTXFreeSize(SOCKET s);
+  uint16_t getRXReceivedSize(SOCKET s);
+  
+
+  // W5100 Registers
+  // ---------------
+private:
+  static uint8_t write(uint16_t _addr, uint8_t _data);
+  static uint16_t write(uint16_t addr, const uint8_t *buf, uint16_t len);
+  static uint8_t read(uint16_t addr);
+  static uint16_t read(uint16_t addr, uint8_t *buf, uint16_t len);
+  
+#define __GP_REGISTER8(name, address)             \
+  static inline void write##name(uint8_t _data) { \
+    write(address, _data);                        \
+  }                                               \
+  static inline uint8_t read##name() {            \
+    return read(address);                         \
+  }
+#define __GP_REGISTER16(name, address)            \
+  static void write##name(uint16_t _data) {       \
+    write(address,   _data >> 8);                 \
+    write(address+1, _data & 0xFF);               \
+  }                                               \
+  static uint16_t read##name() {                  \
+    uint16_t res = read(address);                 \
+    res = (res << 8) + read(address + 1);         \
+    return res;                                   \
+  }
+#define __GP_REGISTER_N(name, address, size)      \
+  static uint16_t write##name(uint8_t *_buff) {   \
+    return write(address, _buff, size);           \
+  }                                               \
+  static uint16_t read##name(uint8_t *_buff) {    \
+    return read(address, _buff, size);            \
+  }
+
+public:
+  __GP_REGISTER8 (MR,     0x0000);    // Mode
+  __GP_REGISTER_N(GAR,    0x0001, 4); // Gateway IP address
+  __GP_REGISTER_N(SUBR,   0x0005, 4); // Subnet mask address
+  __GP_REGISTER_N(SHAR,   0x0009, 6); // Source MAC address
+  __GP_REGISTER_N(SIPR,   0x000F, 4); // Source IP address
+  __GP_REGISTER8 (IR,     0x0015);    // Interrupt
+  __GP_REGISTER8 (IMR,    0x0016);    // Interrupt Mask
+  __GP_REGISTER16(RTR,    0x0017);    // Timeout address
+  __GP_REGISTER8 (RCR,    0x0019);    // Retry count
+  __GP_REGISTER8 (RMSR,   0x001A);    // Receive memory size
+  __GP_REGISTER8 (TMSR,   0x001B);    // Transmit memory size
+  __GP_REGISTER8 (PATR,   0x001C);    // Authentication type address in PPPoE mode
+  __GP_REGISTER8 (PTIMER, 0x0028);    // PPP LCP Request Timer
+  __GP_REGISTER8 (PMAGIC, 0x0029);    // PPP LCP Magic Number
+  __GP_REGISTER_N(UIPR,   0x002A, 4); // Unreachable IP address in UDP mode
+  __GP_REGISTER16(UPORT,  0x002E);    // Unreachable Port address in UDP mode
+  
+#undef __GP_REGISTER8
+#undef __GP_REGISTER16
+#undef __GP_REGISTER_N
+
+  // W5100 Socket registers
+  // ----------------------
+private:
+  static inline uint8_t readSn(SOCKET _s, uint16_t _addr);
+  static inline uint8_t writeSn(SOCKET _s, uint16_t _addr, uint8_t _data);
+  static inline uint16_t readSn(SOCKET _s, uint16_t _addr, uint8_t *_buf, uint16_t len);
+  static inline uint16_t writeSn(SOCKET _s, uint16_t _addr, uint8_t *_buf, uint16_t len);
+
+  static const uint16_t CH_BASE = 0x0400;
+  static const uint16_t CH_SIZE = 0x0100;
+
+#define __SOCKET_REGISTER8(name, address)                    \
+  static inline void write##name(SOCKET _s, uint8_t _data) { \
+    writeSn(_s, address, _data);                             \
+  }                                                          \
+  static inline uint8_t read##name(SOCKET _s) {              \
+    return readSn(_s, address);                              \
+  }
+#define __SOCKET_REGISTER16(name, address)                   \
+  static void write##name(SOCKET _s, uint16_t _data) {       \
+    writeSn(_s, address,   _data >> 8);                      \
+    writeSn(_s, address+1, _data & 0xFF);                    \
+  }                                                          \
+  static uint16_t read##name(SOCKET _s) {                    \
+    uint16_t res = readSn(_s, address);                      \
+    res = (res << 8) + readSn(_s, address + 1);              \
+    return res;                                              \
+  }
+#define __SOCKET_REGISTER_N(name, address, size)             \
+  static uint16_t write##name(SOCKET _s, uint8_t *_buff) {   \
+    return writeSn(_s, address, _buff, size);                \
+  }                                                          \
+  static uint16_t read##name(SOCKET _s, uint8_t *_buff) {    \
+    return readSn(_s, address, _buff, size);                 \
+  }
+  
+public:
+  __SOCKET_REGISTER8(SnMR,        0x0000)        // Mode
+  __SOCKET_REGISTER8(SnCR,        0x0001)        // Command
+  __SOCKET_REGISTER8(SnIR,        0x0002)        // Interrupt
+  __SOCKET_REGISTER8(SnSR,        0x0003)        // Status
+  __SOCKET_REGISTER16(SnPORT,     0x0004)        // Source Port
+  __SOCKET_REGISTER_N(SnDHAR,     0x0006, 6)     // Destination Hardw Addr
+  __SOCKET_REGISTER_N(SnDIPR,     0x000C, 4)     // Destination IP Addr
+  __SOCKET_REGISTER16(SnDPORT,    0x0010)        // Destination Port
+  __SOCKET_REGISTER16(SnMSSR,     0x0012)        // Max Segment Size
+  __SOCKET_REGISTER8(SnPROTO,     0x0014)        // Protocol in IP RAW Mode
+  __SOCKET_REGISTER8(SnTOS,       0x0015)        // IP TOS
+  __SOCKET_REGISTER8(SnTTL,       0x0016)        // IP TTL
+  __SOCKET_REGISTER16(SnTX_FSR,   0x0020)        // TX Free Size
+  __SOCKET_REGISTER16(SnTX_RD,    0x0022)        // TX Read Pointer
+  __SOCKET_REGISTER16(SnTX_WR,    0x0024)        // TX Write Pointer
+  __SOCKET_REGISTER16(SnRX_RSR,   0x0026)        // RX Free Size
+  __SOCKET_REGISTER16(SnRX_RD,    0x0028)        // RX Read Pointer
+  __SOCKET_REGISTER16(SnRX_WR,    0x002A)        // RX Write Pointer (supported?)
+  
+#undef __SOCKET_REGISTER8
+#undef __SOCKET_REGISTER16
+#undef __SOCKET_REGISTER_N
+
+
+private:
+  static const uint8_t  RST = 7; // Reset BIT
+
+  static const int SOCKETS = 4;
+  static const uint16_t SMASK = 0x07FF; // Tx buffer MASK
+  static const uint16_t RMASK = 0x07FF; // Rx buffer MASK
+public:
+  static const uint16_t SSIZE = 2048; // Max Tx buffer size
+private:
+  static const uint16_t RSIZE = 2048; // Max Rx buffer size
+  uint16_t SBASE[SOCKETS]; // Tx buffer base address
+  uint16_t RBASE[SOCKETS]; // Rx buffer base address
+
+private:
+#if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
+  inline static void initSS()    { DDRB  |=  _BV(4); };
+  inline static void setSS()     { PORTB &= ~_BV(4); };
+  inline static void resetSS()   { PORTB |=  _BV(4); };
+#else
+  inline static void initSS()    { DDRB  |=  _BV(2); };
+  inline static void setSS()     { PORTB &= ~_BV(2); };
+  inline static void resetSS()   { PORTB |=  _BV(2); };
+#endif
+
+};
+
+extern W5100Class W5100;
+
+uint8_t W5100Class::readSn(SOCKET _s, uint16_t _addr) {
+  return read(CH_BASE + _s * CH_SIZE + _addr);
+}
+
+uint8_t W5100Class::writeSn(SOCKET _s, uint16_t _addr, uint8_t _data) {
+  return write(CH_BASE + _s * CH_SIZE + _addr, _data);
+}
+
+uint16_t W5100Class::readSn(SOCKET _s, uint16_t _addr, uint8_t *_buf, uint16_t _len) {
+  return read(CH_BASE + _s * CH_SIZE + _addr, _buf, _len);
+}
+
+uint16_t W5100Class::writeSn(SOCKET _s, uint16_t _addr, uint8_t *_buf, uint16_t _len) {
+  return write(CH_BASE + _s * CH_SIZE + _addr, _buf, _len);
+}
+
+void W5100Class::getGatewayIp(uint8_t *_addr) {
+  readGAR(_addr);
+}
+
+void W5100Class::setGatewayIp(uint8_t *_addr) {
+  writeGAR(_addr);
+}
+
+void W5100Class::getSubnetMask(uint8_t *_addr) {
+  readSUBR(_addr);
+}
+
+void W5100Class::setSubnetMask(uint8_t *_addr) {
+  writeSUBR(_addr);
+}
+
+void W5100Class::getMACAddress(uint8_t *_addr) {
+  readSHAR(_addr);
+}
+
+void W5100Class::setMACAddress(uint8_t *_addr) {
+  writeSHAR(_addr);
+}
+
+void W5100Class::getIPAddress(uint8_t *_addr) {
+  readSIPR(_addr);
+}
+
+void W5100Class::setIPAddress(uint8_t *_addr) {
+  writeSIPR(_addr);
+}
+
+void W5100Class::setRetransmissionTime(uint16_t _timeout) {
+  writeRTR(_timeout);
+}
+
+void W5100Class::setRetransmissionCount(uint8_t _retry) {
+  writeRCR(_retry);
+}
+
+#endif
diff --git a/libraries/Firmata/Boards.h b/libraries/Firmata/Boards.h
new file mode 100644
index 0000000..f716320
--- /dev/null
+++ b/libraries/Firmata/Boards.h
@@ -0,0 +1,335 @@
+/* Boards.h - Hardware Abstraction Layer for Firmata library */
+
+#ifndef Firmata_Boards_h
+#define Firmata_Boards_h
+
+#include <Arduino.h>	// for digitalRead, digitalWrite, etc
+
+// Normally Servo.h must be included before Firmata.h (which then includes
+// this file).  If Servo.h wasn't included, this allows the code to still
+// compile, but without support for any Servos.  Hopefully that's what the
+// user intended by not including Servo.h
+#ifndef MAX_SERVOS
+#define MAX_SERVOS 0
+#endif
+
+/*
+    Firmata Hardware Abstraction Layer
+
+Firmata is built on top of the hardware abstraction functions of Arduino,
+specifically digitalWrite, digitalRead, analogWrite, analogRead, and 
+pinMode.  While these functions offer simple integer pin numbers, Firmata
+needs more information than is provided by Arduino.  This file provides
+all other hardware specific details.  To make Firmata support a new board,
+only this file should require editing.
+
+The key concept is every "pin" implemented by Firmata may be mapped to
+any pin as implemented by Arduino.  Usually a simple 1-to-1 mapping is
+best, but such mapping should not be assumed.  This hardware abstraction
+layer allows Firmata to implement any number of pins which map onto the
+Arduino implemented pins in almost any arbitrary way.
+
+
+General Constants:
+
+These constants provide basic information Firmata requires.
+
+TOTAL_PINS: The total number of pins Firmata implemented by Firmata.
+    Usually this will match the number of pins the Arduino functions
+    implement, including any pins pins capable of analog or digital.
+    However, Firmata may implement any number of pins.  For example,
+    on Arduino Mini with 8 analog inputs, 6 of these may be used
+    for digital functions, and 2 are analog only.  On such boards,
+    Firmata can implement more pins than Arduino's pinMode()
+    function, in order to accommodate those special pins.  The
+    Firmata protocol supports a maximum of 128 pins, so this
+    constant must not exceed 128.
+
+TOTAL_ANALOG_PINS: The total number of analog input pins implemented.
+    The Firmata protocol allows up to 16 analog inputs, accessed
+    using offsets 0 to 15.  Because Firmata presents the analog
+    inputs using different offsets than the actual pin numbers
+    (a legacy of Arduino's analogRead function, and the way the
+    analog input capable pins are physically labeled on all
+    Arduino boards), the total number of analog input signals
+    must be specified.  16 is the maximum.
+
+VERSION_BLINK_PIN: When Firmata starts up, it will blink the version
+    number.  This constant is the Arduino pin number where a
+    LED is connected.
+
+
+Pin Mapping Macros:
+
+These macros provide the mapping between pins as implemented by
+Firmata protocol and the actual pin numbers used by the Arduino
+functions.  Even though such mappings are often simple, pin
+numbers received by Firmata protocol should always be used as
+input to these macros, and the result of the macro should be
+used with with any Arduino function.
+
+When Firmata is extended to support a new pin mode or feature,
+a pair of macros should be added and used for all hardware
+access.  For simple 1:1 mapping, these macros add no actual
+overhead, yet their consistent use allows source code which
+uses them consistently to be easily adapted to all other boards
+with different requirements.
+
+IS_PIN_XXXX(pin): The IS_PIN macros resolve to true or non-zero
+    if a pin as implemented by Firmata corresponds to a pin
+    that actually implements the named feature.
+
+PIN_TO_XXXX(pin): The PIN_TO macros translate pin numbers as
+    implemented by Firmata to the pin numbers needed as inputs
+    to the Arduino functions.  The corresponding IS_PIN macro
+    should always be tested before using a PIN_TO macro, so
+    these macros only need to handle valid Firmata pin
+    numbers for the named feature.
+
+
+Port Access Inline Funtions:
+
+For efficiency, Firmata protocol provides access to digital
+input and output pins grouped by 8 bit ports.  When these
+groups of 8 correspond to actual 8 bit ports as implemented
+by the hardware, these inline functions can provide high
+speed direct port access.  Otherwise, a default implementation
+using 8 calls to digitalWrite or digitalRead is used.
+
+When porting Firmata to a new board, it is recommended to
+use the default functions first and focus only on the constants
+and macros above.  When those are working, if optimized port
+access is desired, these inline functions may be extended.
+The recommended approach defines a symbol indicating which
+optimization to use, and then conditional complication is
+used within these functions.
+
+readPort(port, bitmask):  Read an 8 bit port, returning the value.
+   port:    The port number, Firmata pins port*8 to port*8+7
+   bitmask: The actual pins to read, indicated by 1 bits.
+
+writePort(port, value, bitmask):  Write an 8 bit port.
+   port:    The port number, Firmata pins port*8 to port*8+7
+   value:   The 8 bit value to write
+   bitmask: The actual pins to write, indicated by 1 bits.
+*/
+
+/*==============================================================================
+ * Board Specific Configuration
+ *============================================================================*/
+
+// Arduino Duemilanove, Diecimila, and NG
+#if defined(__AVR_ATmega168__) || defined(__AVR_ATmega328P__)
+#define TOTAL_ANALOG_PINS       8
+#define TOTAL_PINS              24 // 14 digital + 2 unused + 8 analog
+#define VERSION_BLINK_PIN       13
+#define IS_PIN_DIGITAL(p)       (((p) >= 2 && (p) <= 13) || ((p) >= 16 && (p) <= 21))
+#define IS_PIN_ANALOG(p)        ((p) >= 16 && (p) <= 23)
+#define IS_PIN_PWM(p)           IS_PIN_DIGITAL(p)
+#define IS_PIN_SERVO(p)         ((p) >= 2 && (p) <= 13 && (p) - 2 < MAX_SERVOS)
+#define IS_PIN_I2C(p)           (0)
+#define PIN_TO_DIGITAL(p)       (((p) < 16) ? (p) : (p) - 2)
+#define PIN_TO_ANALOG(p)        ((p) - 16)
+#define PIN_TO_PWM(p)           PIN_TO_DIGITAL(p)
+#define PIN_TO_SERVO(p)         ((p) - 2)
+#define ARDUINO_PINOUT_OPTIMIZE 1
+
+
+// old Arduinos
+#elif defined(__AVR_ATmega8__)
+#define TOTAL_ANALOG_PINS       6
+#define TOTAL_PINS              22 // 14 digital + 2 unused + 6 analog
+#define VERSION_BLINK_PIN       13
+#define IS_PIN_DIGITAL(p)       (((p) >= 2 && (p) <= 13) || ((p) >= 16 && (p) <= 21))
+#define IS_PIN_ANALOG(p)        ((p) >= 16 && (p) <= 21)
+#define IS_PIN_PWM(p)           IS_PIN_DIGITAL(p)
+#define IS_PIN_SERVO(p)         ((p) >= 2 && (p) <= 13 && (p) - 2 < MAX_SERVOS)
+#define IS_PIN_I2C(p)           (0)
+#define PIN_TO_DIGITAL(p)       (((p) < 16) ? (p) : (p) - 2)
+#define PIN_TO_ANALOG(p)        ((p) - 16)
+#define PIN_TO_PWM(p)           PIN_TO_DIGITAL(p)
+#define PIN_TO_SERVO(p)         ((p) - 2)
+#define ARDUINO_PINOUT_OPTIMIZE 1
+
+
+// Arduino Mega
+#elif defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
+#define TOTAL_ANALOG_PINS       16
+#define TOTAL_PINS              70 // 54 digital + 16 analog
+#define VERSION_BLINK_PIN       13
+#define IS_PIN_DIGITAL(p)       ((p) >= 2 && (p) < TOTAL_PINS)
+#define IS_PIN_ANALOG(p)        ((p) >= 54 && (p) < TOTAL_PINS)
+#define IS_PIN_PWM(p)           IS_PIN_DIGITAL(p)
+#define IS_PIN_SERVO(p)         ((p) >= 2 && (p) - 2 < MAX_SERVOS)
+#define IS_PIN_I2C(p)           (0)
+#define PIN_TO_DIGITAL(p)       (p)
+#define PIN_TO_ANALOG(p)        ((p) - 54)
+#define PIN_TO_PWM(p)           PIN_TO_DIGITAL(p)
+#define PIN_TO_SERVO(p)         ((p) - 2)
+
+
+// Wiring
+#elif defined(__AVR_ATmega128__)
+#define TOTAL_ANALOG_PINS       8
+#define TOTAL_PINS              51
+#define VERSION_BLINK_PIN       48
+// TODO: hardware abstraction for wiring board
+
+
+// Teensy 1.0
+#elif defined(__AVR_AT90USB162__)
+#define TOTAL_ANALOG_PINS       0
+#define TOTAL_PINS              21 // 21 digital + no analog
+#define VERSION_BLINK_PIN       6
+#define IS_PIN_DIGITAL(p)       ((p) >= 0 && (p) < TOTAL_PINS)
+#define IS_PIN_ANALOG(p)        (0)
+#define IS_PIN_PWM(p)           IS_PIN_DIGITAL(p)
+#define IS_PIN_SERVO(p)         ((p) >= 0 && (p) < MAX_SERVOS)
+#define IS_PIN_I2C(p)           (0)
+#define PIN_TO_DIGITAL(p)       (p)
+#define PIN_TO_ANALOG(p)        (0)
+#define PIN_TO_PWM(p)           PIN_TO_DIGITAL(p)
+#define PIN_TO_SERVO(p)         (p)
+
+
+// Teensy 2.0
+#elif defined(__AVR_ATmega32U4__)
+#define TOTAL_ANALOG_PINS       12
+#define TOTAL_PINS              25 // 11 digital + 12 analog
+#define VERSION_BLINK_PIN       11
+#define IS_PIN_DIGITAL(p)       ((p) >= 0 && (p) < TOTAL_PINS)
+#define IS_PIN_ANALOG(p)        ((p) >= 11 && (p) <= 22)
+#define IS_PIN_PWM(p)           IS_PIN_DIGITAL(p)
+#define IS_PIN_SERVO(p)         ((p) >= 0 && (p) < MAX_SERVOS)
+#define IS_PIN_I2C(p)           (0)
+#define PIN_TO_DIGITAL(p)       (p)
+#define PIN_TO_ANALOG(p)        (((p)<22)?21-(p):11)
+#define PIN_TO_PWM(p)           PIN_TO_DIGITAL(p)
+#define PIN_TO_SERVO(p)         (p)
+
+
+// Teensy++ 1.0 and 2.0
+#elif defined(__AVR_AT90USB646__) || defined(__AVR_AT90USB1286__)
+#define TOTAL_ANALOG_PINS       8
+#define TOTAL_PINS              46 // 38 digital + 8 analog
+#define VERSION_BLINK_PIN       6
+#define IS_PIN_DIGITAL(p)       ((p) >= 0 && (p) < TOTAL_PINS)
+#define IS_PIN_ANALOG(p)        ((p) >= 38 && (p) < TOTAL_PINS)
+#define IS_PIN_PWM(p)           IS_PIN_DIGITAL(p)
+#define IS_PIN_SERVO(p)         ((p) >= 0 && (p) < MAX_SERVOS)
+#define IS_PIN_I2C(p)           (0)
+#define PIN_TO_DIGITAL(p)       (p)
+#define PIN_TO_ANALOG(p)        ((p) - 38)
+#define PIN_TO_PWM(p)           PIN_TO_DIGITAL(p)
+#define PIN_TO_SERVO(p)         (p)
+
+
+// Sanguino
+#elif defined(__AVR_ATmega644P__) || defined(__AVR_ATmega644__)
+#define TOTAL_ANALOG_PINS       8
+#define TOTAL_PINS              32 // 24 digital + 8 analog
+#define VERSION_BLINK_PIN       0
+#define IS_PIN_DIGITAL(p)       ((p) >= 2 && (p) < TOTAL_PINS)
+#define IS_PIN_ANALOG(p)        ((p) >= 24 && (p) < TOTAL_PINS)
+#define IS_PIN_PWM(p)           IS_PIN_DIGITAL(p)
+#define IS_PIN_SERVO(p)         ((p) >= 0 && (p) < MAX_SERVOS)
+#define IS_PIN_I2C(p)           (0)
+#define PIN_TO_DIGITAL(p)       (p)
+#define PIN_TO_ANALOG(p)        ((p) - 24)
+#define PIN_TO_PWM(p)           PIN_TO_DIGITAL(p)
+#define PIN_TO_SERVO(p)         ((p) - 2)
+
+
+// Illuminato
+#elif defined(__AVR_ATmega645__)
+#define TOTAL_ANALOG_PINS       6
+#define TOTAL_PINS              42 // 36 digital + 6 analog
+#define VERSION_BLINK_PIN       13
+#define IS_PIN_DIGITAL(p)       ((p) >= 2 && (p) < TOTAL_PINS)
+#define IS_PIN_ANALOG(p)        ((p) >= 36 && (p) < TOTAL_PINS)
+#define IS_PIN_PWM(p)           IS_PIN_DIGITAL(p)
+#define IS_PIN_SERVO(p)         ((p) >= 0 && (p) < MAX_SERVOS)
+#define IS_PIN_I2C(p)           (0)
+#define PIN_TO_DIGITAL(p)       (p)
+#define PIN_TO_ANALOG(p)        ((p) - 36)
+#define PIN_TO_PWM(p)           PIN_TO_DIGITAL(p)
+#define PIN_TO_SERVO(p)         ((p) - 2)
+
+
+// anything else
+#else
+#error "Please edit Boards.h with a hardware abstraction for this board"
+#endif
+
+
+/*==============================================================================
+ * readPort() - Read an 8 bit port
+ *============================================================================*/
+
+static inline unsigned char readPort(byte, byte) __attribute__((always_inline, unused));
+static inline unsigned char readPort(byte port, byte bitmask)
+{
+#if defined(ARDUINO_PINOUT_OPTIMIZE)
+	if (port == 0) return PIND & B11111100 & bitmask; // ignore Rx/Tx 0/1
+	if (port == 1) return PINB & B00111111 & bitmask; // pins 8-13 (14,15 are disabled for the crystal)
+	if (port == 2) return PINC & bitmask;
+	return 0;
+#else
+	unsigned char out=0, pin=port*8;
+	if (IS_PIN_DIGITAL(pin+0) && (bitmask & 0x01) && digitalRead(PIN_TO_DIGITAL(pin+0))) out |= 0x01;
+	if (IS_PIN_DIGITAL(pin+1) && (bitmask & 0x02) && digitalRead(PIN_TO_DIGITAL(pin+1))) out |= 0x02;
+	if (IS_PIN_DIGITAL(pin+2) && (bitmask & 0x04) && digitalRead(PIN_TO_DIGITAL(pin+2))) out |= 0x04;
+	if (IS_PIN_DIGITAL(pin+3) && (bitmask & 0x08) && digitalRead(PIN_TO_DIGITAL(pin+3))) out |= 0x08;
+	if (IS_PIN_DIGITAL(pin+4) && (bitmask & 0x10) && digitalRead(PIN_TO_DIGITAL(pin+4))) out |= 0x10;
+	if (IS_PIN_DIGITAL(pin+5) && (bitmask & 0x20) && digitalRead(PIN_TO_DIGITAL(pin+5))) out |= 0x20;
+	if (IS_PIN_DIGITAL(pin+6) && (bitmask & 0x40) && digitalRead(PIN_TO_DIGITAL(pin+6))) out |= 0x40;
+	if (IS_PIN_DIGITAL(pin+7) && (bitmask & 0x80) && digitalRead(PIN_TO_DIGITAL(pin+7))) out |= 0x80;
+	return out;
+#endif
+}
+
+/*==============================================================================
+ * writePort() - Write an 8 bit port, only touch pins specified by a bitmask
+ *============================================================================*/
+
+static inline unsigned char writePort(byte, byte, byte) __attribute__((always_inline, unused));
+static inline unsigned char writePort(byte port, byte value, byte bitmask)
+{
+#if defined(ARDUINO_PINOUT_OPTIMIZE)
+	if (port == 0) {
+		bitmask = bitmask & 0xFC;  // Tx & Rx pins
+		cli();
+		PORTD = (PORTD & ~bitmask) | (bitmask & value);
+		sei();
+	} else if (port == 1) {
+		cli();
+		PORTB = (PORTB & ~bitmask) | (bitmask & value);
+		sei();
+	} else if (port == 2) {
+		cli();
+		PORTC = (PORTC & ~bitmask) | (bitmask & value);
+		sei();
+	}
+#else
+	byte pin=port*8;
+	if ((bitmask & 0x01)) digitalWrite(PIN_TO_DIGITAL(pin+0), (value & 0x01));
+	if ((bitmask & 0x02)) digitalWrite(PIN_TO_DIGITAL(pin+1), (value & 0x02));
+	if ((bitmask & 0x04)) digitalWrite(PIN_TO_DIGITAL(pin+2), (value & 0x04));
+	if ((bitmask & 0x08)) digitalWrite(PIN_TO_DIGITAL(pin+3), (value & 0x08));
+	if ((bitmask & 0x10)) digitalWrite(PIN_TO_DIGITAL(pin+4), (value & 0x10));
+	if ((bitmask & 0x20)) digitalWrite(PIN_TO_DIGITAL(pin+5), (value & 0x20));
+	if ((bitmask & 0x40)) digitalWrite(PIN_TO_DIGITAL(pin+6), (value & 0x40));
+	if ((bitmask & 0x80)) digitalWrite(PIN_TO_DIGITAL(pin+7), (value & 0x80));
+#endif
+}
+
+
+
+
+#ifndef TOTAL_PORTS
+#define TOTAL_PORTS             ((TOTAL_PINS + 7) / 8)
+#endif
+
+
+#endif /* Firmata_Boards_h */
+
diff --git a/libraries/Firmata/Firmata.cpp b/libraries/Firmata/Firmata.cpp
new file mode 100644
index 0000000..e30deae
--- /dev/null
+++ b/libraries/Firmata/Firmata.cpp
@@ -0,0 +1,442 @@
+/*
+  Firmata.cpp - Firmata library
+  Copyright (C) 2006-2008 Hans-Christoph Steiner.  All rights reserved.
+ 
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  See file LICENSE.txt for further informations on licensing terms.
+*/
+
+//******************************************************************************
+//* Includes
+//******************************************************************************
+
+#include "Arduino.h"
+#include "HardwareSerial.h"
+#include "Firmata.h"
+
+extern "C" {
+#include <string.h>
+#include <stdlib.h>
+}
+
+//******************************************************************************
+//* Support Functions
+//******************************************************************************
+
+void sendValueAsTwo7bitBytes(int value)
+{
+  Serial.print(value & B01111111, BYTE); // LSB
+  Serial.print(value >> 7 & B01111111, BYTE); // MSB
+}
+
+void startSysex(void)
+{
+  Serial.print(START_SYSEX, BYTE);
+}
+
+void endSysex(void)
+{
+  Serial.print(END_SYSEX, BYTE);
+}
+
+//******************************************************************************
+//* Constructors
+//******************************************************************************
+
+FirmataClass::FirmataClass(void)
+{
+  firmwareVersionCount = 0;
+  systemReset();
+}
+
+//******************************************************************************
+//* Public Methods
+//******************************************************************************
+
+/* begin method for overriding default serial bitrate */
+void FirmataClass::begin(void)
+{
+  begin(57600);
+}
+
+/* begin method for overriding default serial bitrate */
+void FirmataClass::begin(long speed)
+{
+#if defined(__AVR_ATmega128__)  // Wiring
+  Serial.begin((uint32_t)speed);
+#else
+  Serial.begin(speed);
+#endif
+  blinkVersion();
+  delay(300);
+  printVersion();
+  printFirmwareVersion();
+}
+
+// output the protocol version message to the serial port
+void FirmataClass::printVersion(void) {
+  Serial.print(REPORT_VERSION, BYTE);
+  Serial.print(FIRMATA_MAJOR_VERSION, BYTE);
+  Serial.print(FIRMATA_MINOR_VERSION, BYTE);
+}
+
+void FirmataClass::blinkVersion(void)
+{
+  // flash the pin with the protocol version
+  pinMode(VERSION_BLINK_PIN,OUTPUT);
+  pin13strobe(FIRMATA_MAJOR_VERSION, 200, 400);
+  delay(300);
+  pin13strobe(2,1,4); // separator, a quick burst
+  delay(300);
+  pin13strobe(FIRMATA_MINOR_VERSION, 200, 400);
+}
+
+void FirmataClass::printFirmwareVersion(void)
+{
+  byte i;
+
+  if(firmwareVersionCount) { // make sure that the name has been set before reporting
+    startSysex();
+    Serial.print(REPORT_FIRMWARE, BYTE);
+    Serial.print(firmwareVersionVector[0]); // major version number
+    Serial.print(firmwareVersionVector[1]); // minor version number
+    for(i=2; i<firmwareVersionCount; ++i) {
+      sendValueAsTwo7bitBytes(firmwareVersionVector[i]);
+    }
+    endSysex();
+  }
+}
+
+void FirmataClass::setFirmwareNameAndVersion(const char *name, byte major, byte minor)
+{
+  const char *filename;
+  char *extension;
+
+  // parse out ".cpp" and "applet/" that comes from using __FILE__
+  extension = strstr(name, ".cpp");
+  filename = strrchr(name, '/') + 1; //points to slash, +1 gets to start of filename
+  // add two bytes for version numbers
+  if(extension && filename) {
+    firmwareVersionCount = extension - filename + 2;
+  } else {
+    firmwareVersionCount = strlen(name) + 2;
+    filename = name;
+  }
+  firmwareVersionVector = (byte *) malloc(firmwareVersionCount);
+  firmwareVersionVector[firmwareVersionCount] = 0;
+  firmwareVersionVector[0] = major;
+  firmwareVersionVector[1] = minor;
+  strncpy((char*)firmwareVersionVector + 2, filename, firmwareVersionCount - 2);
+  // alas, no snprintf on Arduino
+  //    snprintf(firmwareVersionVector, MAX_DATA_BYTES, "%c%c%s", 
+  //             (char)major, (char)minor, firmwareVersionVector);
+}
+
+//------------------------------------------------------------------------------
+// Serial Receive Handling
+
+int FirmataClass::available(void)
+{
+  return Serial.available();
+}
+
+
+void FirmataClass::processSysexMessage(void)
+{
+  switch(storedInputData[0]) { //first byte in buffer is command
+  case REPORT_FIRMWARE:
+    printFirmwareVersion();
+    break;
+  case STRING_DATA:
+    if(currentStringCallback) {
+      byte bufferLength = (sysexBytesRead - 1) / 2;
+      char *buffer = (char*)malloc(bufferLength * sizeof(char));
+      byte i = 1;
+      byte j = 0;
+      while(j < bufferLength) {
+        buffer[j] = (char)storedInputData[i];
+        i++;
+        buffer[j] += (char)(storedInputData[i] << 7);
+        i++;
+        j++;
+      }
+      (*currentStringCallback)(buffer);
+    }
+    break;
+  default:
+    if(currentSysexCallback)
+      (*currentSysexCallback)(storedInputData[0], sysexBytesRead - 1, storedInputData + 1);
+  }
+}
+
+void FirmataClass::processInput(void)
+{
+  int inputData = Serial.read(); // this is 'int' to handle -1 when no data
+  int command;
+    
+  // TODO make sure it handles -1 properly
+
+  if (parsingSysex) {
+    if(inputData == END_SYSEX) {
+      //stop sysex byte      
+      parsingSysex = false;
+      //fire off handler function
+      processSysexMessage();
+    } else {
+      //normal data byte - add to buffer
+      storedInputData[sysexBytesRead] = inputData;
+      sysexBytesRead++;
+    }
+  } else if( (waitForData > 0) && (inputData < 128) ) {  
+    waitForData--;
+    storedInputData[waitForData] = inputData;
+    if( (waitForData==0) && executeMultiByteCommand ) { // got the whole message
+      switch(executeMultiByteCommand) {
+      case ANALOG_MESSAGE:
+        if(currentAnalogCallback) {
+          (*currentAnalogCallback)(multiByteChannel,
+                                   (storedInputData[0] << 7)
+                                   + storedInputData[1]);
+        }
+        break;
+      case DIGITAL_MESSAGE:
+        if(currentDigitalCallback) {
+          (*currentDigitalCallback)(multiByteChannel,
+                                    (storedInputData[0] << 7)
+                                    + storedInputData[1]);
+        }
+        break;
+      case SET_PIN_MODE:
+        if(currentPinModeCallback)
+          (*currentPinModeCallback)(storedInputData[1], storedInputData[0]);
+        break;
+      case REPORT_ANALOG:
+        if(currentReportAnalogCallback)
+          (*currentReportAnalogCallback)(multiByteChannel,storedInputData[0]);
+        break;
+      case REPORT_DIGITAL:
+        if(currentReportDigitalCallback)
+          (*currentReportDigitalCallback)(multiByteChannel,storedInputData[0]);
+        break;
+      }
+      executeMultiByteCommand = 0;
+    }	
+  } else {
+    // remove channel info from command byte if less than 0xF0
+    if(inputData < 0xF0) {
+      command = inputData & 0xF0;
+      multiByteChannel = inputData & 0x0F;
+    } else {
+      command = inputData;
+      // commands in the 0xF* range don't use channel data
+    }
+    switch (command) {
+    case ANALOG_MESSAGE:
+    case DIGITAL_MESSAGE:
+    case SET_PIN_MODE:
+      waitForData = 2; // two data bytes needed
+      executeMultiByteCommand = command;
+      break;
+    case REPORT_ANALOG:
+    case REPORT_DIGITAL:
+      waitForData = 1; // two data bytes needed
+      executeMultiByteCommand = command;
+      break;
+    case START_SYSEX:
+      parsingSysex = true;
+      sysexBytesRead = 0;
+      break;
+    case SYSTEM_RESET:
+      systemReset();
+      break;
+    case REPORT_VERSION:
+      Firmata.printVersion();
+      break;
+    }
+  }
+}
+
+//------------------------------------------------------------------------------
+// Serial Send Handling
+
+// send an analog message
+void FirmataClass::sendAnalog(byte pin, int value) 
+{
+  // pin can only be 0-15, so chop higher bits
+  Serial.print(ANALOG_MESSAGE | (pin & 0xF), BYTE);
+  sendValueAsTwo7bitBytes(value);
+}
+
+// send a single digital pin in a digital message
+void FirmataClass::sendDigital(byte pin, int value) 
+{
+  /* TODO add single pin digital messages to the protocol, this needs to
+   * track the last digital data sent so that it can be sure to change just
+   * one bit in the packet.  This is complicated by the fact that the
+   * numbering of the pins will probably differ on Arduino, Wiring, and
+   * other boards.  The DIGITAL_MESSAGE sends 14 bits at a time, but it is
+   * probably easier to send 8 bit ports for any board with more than 14
+   * digital pins.
+   */
+
+  // TODO: the digital message should not be sent on the serial port every
+  // time sendDigital() is called.  Instead, it should add it to an int
+  // which will be sent on a schedule.  If a pin changes more than once
+  // before the digital message is sent on the serial port, it should send a
+  // digital message for each change.
+
+  //    if(value == 0)
+  //        sendDigitalPortPair();
+}
+
+
+// send 14-bits in a single digital message (protocol v1)
+// send an 8-bit port in a single digital message (protocol v2)
+void FirmataClass::sendDigitalPort(byte portNumber, int portData)
+{
+  Serial.print(DIGITAL_MESSAGE | (portNumber & 0xF),BYTE);
+  Serial.print((byte)portData % 128, BYTE); // Tx bits 0-6
+  Serial.print(portData >> 7, BYTE);  // Tx bits 7-13
+}
+
+
+void FirmataClass::sendSysex(byte command, byte bytec, byte* bytev) 
+{
+  byte i;
+  startSysex();
+  Serial.print(command, BYTE);
+  for(i=0; i<bytec; i++) {
+    sendValueAsTwo7bitBytes(bytev[i]);        
+  }
+  endSysex();
+}
+
+void FirmataClass::sendString(byte command, const char* string) 
+{
+  sendSysex(command, strlen(string), (byte *)string);
+}
+
+
+// send a string as the protocol string type
+void FirmataClass::sendString(const char* string) 
+{
+  sendString(STRING_DATA, string);
+}
+
+
+// Internal Actions/////////////////////////////////////////////////////////////
+
+// generic callbacks
+void FirmataClass::attach(byte command, callbackFunction newFunction)
+{
+  switch(command) {
+  case ANALOG_MESSAGE: currentAnalogCallback = newFunction; break;
+  case DIGITAL_MESSAGE: currentDigitalCallback = newFunction; break;
+  case REPORT_ANALOG: currentReportAnalogCallback = newFunction; break;
+  case REPORT_DIGITAL: currentReportDigitalCallback = newFunction; break;
+  case SET_PIN_MODE: currentPinModeCallback = newFunction; break;
+  }
+}
+
+void FirmataClass::attach(byte command, systemResetCallbackFunction newFunction)
+{
+  switch(command) {
+  case SYSTEM_RESET: currentSystemResetCallback = newFunction; break;
+  }
+}
+
+void FirmataClass::attach(byte command, stringCallbackFunction newFunction)
+{
+  switch(command) {
+  case STRING_DATA: currentStringCallback = newFunction; break;
+  }
+}
+
+void FirmataClass::attach(byte command, sysexCallbackFunction newFunction)
+{
+  currentSysexCallback = newFunction;
+}
+
+void FirmataClass::detach(byte command)
+{
+  switch(command) {
+  case SYSTEM_RESET: currentSystemResetCallback = NULL; break;
+  case STRING_DATA: currentStringCallback = NULL; break;
+  case START_SYSEX: currentSysexCallback = NULL; break;
+  default:
+    attach(command, (callbackFunction)NULL);
+  }
+}
+
+// sysex callbacks
+/*
+ * this is too complicated for analogReceive, but maybe for Sysex?
+ void FirmataClass::attachSysex(sysexFunction newFunction)
+ {
+ byte i;
+ byte tmpCount = analogReceiveFunctionCount;
+ analogReceiveFunction* tmpArray = analogReceiveFunctionArray;
+ analogReceiveFunctionCount++;
+ analogReceiveFunctionArray = (analogReceiveFunction*) calloc(analogReceiveFunctionCount, sizeof(analogReceiveFunction));
+ for(i = 0; i < tmpCount; i++) {
+ analogReceiveFunctionArray[i] = tmpArray[i];
+ }
+ analogReceiveFunctionArray[tmpCount] = newFunction;
+ free(tmpArray);
+ }
+*/
+
+//******************************************************************************
+//* Private Methods
+//******************************************************************************
+
+
+
+// resets the system state upon a SYSTEM_RESET message from the host software
+void FirmataClass::systemReset(void)
+{
+  byte i;
+
+  waitForData = 0; // this flag says the next serial input will be data
+  executeMultiByteCommand = 0; // execute this after getting multi-byte data
+  multiByteChannel = 0; // channel data for multiByteCommands
+
+
+  for(i=0; i<MAX_DATA_BYTES; i++) {
+    storedInputData[i] = 0;
+  }
+
+  parsingSysex = false;
+  sysexBytesRead = 0;
+
+  if(currentSystemResetCallback)
+    (*currentSystemResetCallback)();
+
+  //flush(); //TODO uncomment when Firmata is a subclass of HardwareSerial
+}
+
+
+
+// =============================================================================
+// used for flashing the pin for the version number
+void FirmataClass::pin13strobe(int count, int onInterval, int offInterval) 
+{
+  byte i;
+  pinMode(VERSION_BLINK_PIN, OUTPUT);
+  for(i=0; i<count; i++) {
+    delay(offInterval);
+    digitalWrite(VERSION_BLINK_PIN, HIGH);
+    delay(onInterval);
+    digitalWrite(VERSION_BLINK_PIN, LOW);
+  }
+}
+
+
+// make one instance for the user to use
+FirmataClass Firmata;
+
+
diff --git a/libraries/Firmata/Firmata.h b/libraries/Firmata/Firmata.h
new file mode 100644
index 0000000..86535d9
--- /dev/null
+++ b/libraries/Firmata/Firmata.h
@@ -0,0 +1,162 @@
+/*
+  Firmata.h - Firmata library
+  Copyright (C) 2006-2008 Hans-Christoph Steiner.  All rights reserved.
+ 
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  See file LICENSE.txt for further informations on licensing terms.
+*/
+
+#ifndef Firmata_h
+#define Firmata_h
+
+#include <Arduino.h>
+#include <inttypes.h>
+
+
+/* Version numbers for the protocol.  The protocol is still changing, so these
+ * version numbers are important.  This number can be queried so that host
+ * software can test whether it will be compatible with the currently
+ * installed firmware. */
+#define FIRMATA_MAJOR_VERSION   2 // for non-compatible changes
+#define FIRMATA_MINOR_VERSION   2 // for backwards compatible changes
+
+#define MAX_DATA_BYTES 32 // max number of data bytes in non-Sysex messages
+
+// message command bytes (128-255/0x80-0xFF)
+#define DIGITAL_MESSAGE         0x90 // send data for a digital pin
+#define ANALOG_MESSAGE          0xE0 // send data for an analog pin (or PWM)
+#define REPORT_ANALOG           0xC0 // enable analog input by pin #
+#define REPORT_DIGITAL          0xD0 // enable digital input by port pair
+//
+#define SET_PIN_MODE            0xF4 // set a pin to INPUT/OUTPUT/PWM/etc
+//
+#define REPORT_VERSION          0xF9 // report protocol version
+#define SYSTEM_RESET            0xFF // reset from MIDI
+//
+#define START_SYSEX             0xF0 // start a MIDI Sysex message
+#define END_SYSEX               0xF7 // end a MIDI Sysex message
+
+// extended command set using sysex (0-127/0x00-0x7F)
+/* 0x00-0x0F reserved for user-defined commands */
+#define SERVO_CONFIG            0x70 // set max angle, minPulse, maxPulse, freq
+#define STRING_DATA             0x71 // a string message with 14-bits per char
+#define SHIFT_DATA              0x75 // a bitstream to/from a shift register
+#define I2C_REQUEST             0x76 // send an I2C read/write request
+#define I2C_REPLY               0x77 // a reply to an I2C read request
+#define I2C_CONFIG              0x78 // config I2C settings such as delay times and power pins
+#define EXTENDED_ANALOG         0x6F // analog write (PWM, Servo, etc) to any pin
+#define PIN_STATE_QUERY         0x6D // ask for a pin's current mode and value
+#define PIN_STATE_RESPONSE      0x6E // reply with pin's current mode and value
+#define CAPABILITY_QUERY        0x6B // ask for supported modes and resolution of all pins
+#define CAPABILITY_RESPONSE     0x6C // reply with supported modes and resolution
+#define ANALOG_MAPPING_QUERY    0x69 // ask for mapping of analog to pin numbers
+#define ANALOG_MAPPING_RESPONSE 0x6A // reply with mapping info
+#define REPORT_FIRMWARE         0x79 // report name and version of the firmware
+#define SAMPLING_INTERVAL       0x7A // set the poll rate of the main loop
+#define SYSEX_NON_REALTIME      0x7E // MIDI Reserved for non-realtime messages
+#define SYSEX_REALTIME          0x7F // MIDI Reserved for realtime messages
+// these are DEPRECATED to make the naming more consistent
+#define FIRMATA_STRING          0x71 // same as STRING_DATA
+#define SYSEX_I2C_REQUEST       0x76 // same as I2C_REQUEST
+#define SYSEX_I2C_REPLY         0x77 // same as I2C_REPLY
+#define SYSEX_SAMPLING_INTERVAL 0x7A // same as SAMPLING_INTERVAL
+
+// pin modes
+//#define INPUT                 0x00 // defined in Arduino.h
+//#define OUTPUT                0x01 // defined in Arduino.h
+#define ANALOG                  0x02 // analog pin in analogInput mode
+#define PWM                     0x03 // digital pin in PWM output mode
+#define SERVO                   0x04 // digital pin in Servo output mode
+#define SHIFT                   0x05 // shiftIn/shiftOut mode
+#define I2C                     0x06 // pin included in I2C setup
+#define TOTAL_PIN_MODES         7
+
+extern "C" {
+// callback function types
+    typedef void (*callbackFunction)(byte, int);
+    typedef void (*systemResetCallbackFunction)(void);
+    typedef void (*stringCallbackFunction)(char*);
+    typedef void (*sysexCallbackFunction)(byte command, byte argc, byte*argv);
+}
+
+
+// TODO make it a subclass of a generic Serial/Stream base class
+class FirmataClass
+{
+public:
+	FirmataClass();
+/* Arduino constructors */
+    void begin();
+    void begin(long);
+/* querying functions */
+	void printVersion(void);
+    void blinkVersion(void);
+    void printFirmwareVersion(void);
+  //void setFirmwareVersion(byte major, byte minor);  // see macro below
+    void setFirmwareNameAndVersion(const char *name, byte major, byte minor);
+/* serial receive handling */
+    int available(void);
+    void processInput(void);
+/* serial send handling */
+	void sendAnalog(byte pin, int value);
+	void sendDigital(byte pin, int value); // TODO implement this
+	void sendDigitalPort(byte portNumber, int portData);
+    void sendString(const char* string);
+    void sendString(byte command, const char* string);
+	void sendSysex(byte command, byte bytec, byte* bytev);
+/* attach & detach callback functions to messages */
+    void attach(byte command, callbackFunction newFunction);
+    void attach(byte command, systemResetCallbackFunction newFunction);
+    void attach(byte command, stringCallbackFunction newFunction);
+    void attach(byte command, sysexCallbackFunction newFunction);
+    void detach(byte command);
+
+private:
+/* firmware name and version */
+    byte firmwareVersionCount;
+    byte *firmwareVersionVector;
+/* input message handling */
+    byte waitForData; // this flag says the next serial input will be data
+    byte executeMultiByteCommand; // execute this after getting multi-byte data
+    byte multiByteChannel; // channel data for multiByteCommands
+    byte storedInputData[MAX_DATA_BYTES]; // multi-byte data
+/* sysex */
+    boolean parsingSysex;
+    int sysexBytesRead;
+/* callback functions */
+    callbackFunction currentAnalogCallback;
+    callbackFunction currentDigitalCallback;
+    callbackFunction currentReportAnalogCallback;
+    callbackFunction currentReportDigitalCallback;
+    callbackFunction currentPinModeCallback;
+    systemResetCallbackFunction currentSystemResetCallback;
+    stringCallbackFunction currentStringCallback;
+    sysexCallbackFunction currentSysexCallback;
+
+/* private methods ------------------------------ */
+    void processSysexMessage(void);
+	void systemReset(void);
+    void pin13strobe(int count, int onInterval, int offInterval);
+};
+
+extern FirmataClass Firmata;
+
+/*==============================================================================
+ * MACROS
+ *============================================================================*/
+
+/* shortcut for setFirmwareNameAndVersion() that uses __FILE__ to set the
+ * firmware name.  It needs to be a macro so that __FILE__ is included in the
+ * firmware source file rather than the library source file.
+ */
+#define setFirmwareVersion(x, y)   setFirmwareNameAndVersion(__FILE__, x, y)
+
+/* Hardware Abstraction Layer */
+#include "Boards.h"
+
+#endif /* Firmata_h */
+
diff --git a/libraries/Firmata/LICENSE.txt b/libraries/Firmata/LICENSE.txt
new file mode 100644
index 0000000..77cec6d
--- /dev/null
+++ b/libraries/Firmata/LICENSE.txt
@@ -0,0 +1,458 @@
+
+		  GNU LESSER GENERAL PUBLIC LICENSE
+		       Version 2.1, February 1999
+
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+ 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL.  It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+			    Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+  This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it.  You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+  When we speak of free software, we are referring to freedom of use,
+not price.  Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+  To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights.  These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+  For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you.  You must make sure that they, too, receive or can get the source
+code.  If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it.  And you must show them these terms so they know their rights.
+
+  We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+  To protect each distributor, we want to make it very clear that
+there is no warranty for the free library.  Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+  Finally, software patents pose a constant threat to the existence of
+any free program.  We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder.  Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+  Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License.  This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License.  We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+  When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library.  The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom.  The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+  We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License.  It also provides other free software developers Less
+of an advantage over competing non-free programs.  These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries.  However, the Lesser license provides advantages in certain
+special circumstances.
+
+  For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard.  To achieve this, non-free programs must be
+allowed to use the library.  A more frequent case is that a free
+library does the same job as widely used non-free libraries.  In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+  In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software.  For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+  Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.  Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library".  The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+		  GNU LESSER GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+  A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+  The "Library", below, refers to any such software library or work
+which has been distributed under these terms.  A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language.  (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+  "Source code" for a work means the preferred form of the work for
+making modifications to it.  For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control compilation
+and installation of the library.
+
+  Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it).  Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+  
+  1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+
+  You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+
+  2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) The modified work must itself be a software library.
+
+    b) You must cause the files modified to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    c) You must cause the whole of the work to be licensed at no
+    charge to all third parties under the terms of this License.
+
+    d) If a facility in the modified Library refers to a function or a
+    table of data to be supplied by an application program that uses
+    the facility, other than as an argument passed when the facility
+    is invoked, then you must make a good faith effort to ensure that,
+    in the event an application does not supply such function or
+    table, the facility still operates, and performs whatever part of
+    its purpose remains meaningful.
+
+    (For example, a function in a library to compute square roots has
+    a purpose that is entirely well-defined independent of the
+    application.  Therefore, Subsection 2d requires that any
+    application-supplied function or table used by this function must
+    be optional: if the application does not supply it, the square
+    root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library.  To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License.  (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.)  Do not make any other change in
+these notices.
+
+  Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+  This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+  4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+  If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library".  Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+  However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library".  The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+  When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library.  The
+threshold for this to be true is not precisely defined by law.
+
+  If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work.  (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+  Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+
+  6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+  You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License.  You must supply a copy of this License.  If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License.  Also, you must do one
+of these things:
+
+    a) Accompany the work with the complete corresponding
+    machine-readable source code for the Library including whatever
+    changes were used in the work (which must be distributed under
+    Sections 1 and 2 above); and, if the work is an executable linked
+    with the Library, with the complete machine-readable "work that
+    uses the Library", as object code and/or source code, so that the
+    user can modify the Library and then relink to produce a modified
+    executable containing the modified Library.  (It is understood
+    that the user who changes the contents of definitions files in the
+    Library will not necessarily be able to recompile the application
+    to use the modified definitions.)
+
+    b) Use a suitable shared library mechanism for linking with the
+    Library.  A suitable mechanism is one that (1) uses at run time a
+    copy of the library already present on the user's computer system,
+    rather than copying library functions into the executable, and (2)
+    will operate properly with a modified version of the library, if
+    the user installs one, as long as the modified version is
+    interface-compatible with the version that the work was made with.
+
+    c) Accompany the work with a written offer, valid for at
+    least three years, to give the same user the materials
+    specified in Subsection 6a, above, for a charge no more
+    than the cost of performing this distribution.
+
+    d) If distribution of the work is made by offering access to copy
+    from a designated place, offer equivalent access to copy the above
+    specified materials from the same place.
+
+    e) Verify that the user has already received a copy of these
+    materials or that you have already sent this user a copy.
+
+  For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it.  However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+  It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system.  Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+
+  7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+    a) Accompany the combined library with a copy of the same work
+    based on the Library, uncombined with any other library
+    facilities.  This must be distributed under the terms of the
+    Sections above.
+
+    b) Give prominent notice with the combined library of the fact
+    that part of it is a work based on the Library, and explaining
+    where to find the accompanying uncombined form of the same work.
+
+  8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License.  Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License.  However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+  9. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Library or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+  10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+
+  11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply,
+and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License may add
+an explicit geographical distribution limitation excluding those countries,
+so that distribution is permitted only in or among countries not thus
+excluded.  In such case, this License incorporates the limitation as if
+written in the body of this License.
+
+  13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation.  If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+
+  14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission.  For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this.  Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+			    NO WARRANTY
+
+  15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
diff --git a/libraries/Firmata/TODO.txt b/libraries/Firmata/TODO.txt
new file mode 100644
index 0000000..86c9858
--- /dev/null
+++ b/libraries/Firmata/TODO.txt
@@ -0,0 +1,14 @@
+
+- make Firmata a subclass of HardwareSerial
+
+- per-pin digital callback, since the per-port callback is a bit complicated
+  for beginners (maybe Firmata is not for beginners...)
+
+- simplify SimpleDigitalFirmata, take out the code that checks to see if the
+  data has changed, since it is a bit complicated for this example.  Ideally
+  this example would be based on a call
+
+- turn current SimpleDigitalFirmata into DigitalPortFirmata for a more complex
+  example using the code which checks for changes before doing anything
+
+- test integration with Wiring
diff --git a/libraries/Firmata/examples/AllInputsFirmata/AllInputsFirmata.pde b/libraries/Firmata/examples/AllInputsFirmata/AllInputsFirmata.pde
new file mode 100644
index 0000000..5bca72a
--- /dev/null
+++ b/libraries/Firmata/examples/AllInputsFirmata/AllInputsFirmata.pde
@@ -0,0 +1,79 @@
+/* 
+ * This firmware reads all inputs and sends them as fast as it can.  It was
+ * inspired by the ease-of-use of the Arduino2Max program.
+ *
+ * This example code is in the public domain.
+ */
+#include <Firmata.h>
+
+byte pin;
+
+int analogValue;
+int previousAnalogValues[TOTAL_ANALOG_PINS];
+
+byte portStatus[TOTAL_PORTS];	// each bit: 1=pin is digital input, 0=other/ignore
+byte previousPINs[TOTAL_PORTS];
+
+/* timer variables */
+unsigned long currentMillis;     // store the current value from millis()
+unsigned long previousMillis;    // for comparison with currentMillis
+/* make sure that the FTDI buffer doesn't go over 60 bytes, otherwise you
+   get long, random delays.  So only read analogs every 20ms or so */
+int samplingInterval = 19;      // how often to run the main loop (in ms)
+
+void sendPort(byte portNumber, byte portValue)
+{
+  portValue = portValue & portStatus[portNumber];
+  if(previousPINs[portNumber] != portValue) {
+    Firmata.sendDigitalPort(portNumber, portValue);
+    previousPINs[portNumber] = portValue;
+  }
+}
+
+void setup()
+{
+  byte i, port, status;
+
+  Firmata.setFirmwareVersion(0, 1);
+
+  for(pin = 0; pin < TOTAL_PINS; pin++) {
+    if IS_PIN_DIGITAL(pin) pinMode(PIN_TO_DIGITAL(pin), INPUT);
+  }
+
+  for (port=0; port<TOTAL_PORTS; port++) {
+    status = 0;
+    for (i=0; i<8; i++) {
+      if (IS_PIN_DIGITAL(port * 8 + i)) status |= (1 << i);
+    }
+    portStatus[port] = status;
+  }
+
+  Firmata.begin(57600);
+}
+
+void loop()
+{
+  byte i;
+
+  for (i=0; i<TOTAL_PORTS; i++) {
+    sendPort(i, readPort(i));
+  }
+  /* make sure that the FTDI buffer doesn't go over 60 bytes, otherwise you
+     get long, random delays.  So only read analogs every 20ms or so */
+  currentMillis = millis();
+  if(currentMillis - previousMillis > samplingInterval) {
+    previousMillis += samplingInterval;
+    while(Firmata.available()) {
+      Firmata.processInput();
+    }
+    for(pin = 0; pin < TOTAL_ANALOG_PINS; pin++) {
+      analogValue = analogRead(pin);
+      if(analogValue != previousAnalogValues[pin]) {
+        Firmata.sendAnalog(pin, analogValue); 
+        previousAnalogValues[pin] = analogValue;
+      }
+    }
+  }
+}
+
+
diff --git a/libraries/Firmata/examples/AnalogFirmata/AnalogFirmata.pde b/libraries/Firmata/examples/AnalogFirmata/AnalogFirmata.pde
new file mode 100644
index 0000000..df8b674
--- /dev/null
+++ b/libraries/Firmata/examples/AnalogFirmata/AnalogFirmata.pde
@@ -0,0 +1,83 @@
+/* This firmware supports as many analog ports as possible, all analog inputs,
+ * four PWM outputs, and two with servo support.
+ *
+ * This example code is in the public domain.
+ */
+#include <Servo.h>
+#include <Firmata.h>
+
+/*==============================================================================
+ * GLOBAL VARIABLES
+ *============================================================================*/
+
+/* servos */
+Servo servo9, servo10; // one instance per pin
+/* analog inputs */
+int analogInputsToReport = 0; // bitwise array to store pin reporting
+int analogPin = 0; // counter for reading analog pins
+/* timer variables */
+unsigned long currentMillis;     // store the current value from millis()
+unsigned long previousMillis;    // for comparison with currentMillis
+
+
+/*==============================================================================
+ * FUNCTIONS                                                                
+ *============================================================================*/
+
+void analogWriteCallback(byte pin, int value)
+{
+    switch(pin) {
+    case 9: servo9.write(value); break;
+    case 10: servo10.write(value); break;
+    case 3: 
+    case 5: 
+    case 6: 
+    case 11: // PWM pins
+        analogWrite(pin, value); 
+        break;
+    }
+}
+// -----------------------------------------------------------------------------
+// sets bits in a bit array (int) to toggle the reporting of the analogIns
+void reportAnalogCallback(byte pin, int value)
+{
+    if(value == 0) {
+        analogInputsToReport = analogInputsToReport &~ (1 << pin);
+    }
+    else { // everything but 0 enables reporting of that pin
+        analogInputsToReport = analogInputsToReport | (1 << pin);
+    }
+    // TODO: save status to EEPROM here, if changed
+}
+
+/*==============================================================================
+ * SETUP()
+ *============================================================================*/
+void setup() 
+{
+    Firmata.setFirmwareVersion(0, 2);
+    Firmata.attach(ANALOG_MESSAGE, analogWriteCallback);
+    Firmata.attach(REPORT_ANALOG, reportAnalogCallback);
+
+    servo9.attach(9);
+    servo10.attach(10);
+    Firmata.begin(57600);
+}
+
+/*==============================================================================
+ * LOOP()
+ *============================================================================*/
+void loop() 
+{
+    while(Firmata.available())
+        Firmata.processInput();
+    currentMillis = millis();
+    if(currentMillis - previousMillis > 20) {  
+        previousMillis += 20;                   // run this every 20ms
+        for(analogPin=0;analogPin<TOTAL_ANALOG_PINS;analogPin++) {
+            if( analogInputsToReport & (1 << analogPin) ) 
+                Firmata.sendAnalog(analogPin, analogRead(analogPin));
+        }
+    }
+}
+
diff --git a/libraries/Firmata/examples/AnalogFirmata/Makefile b/libraries/Firmata/examples/AnalogFirmata/Makefile
new file mode 100644
index 0000000..e968c0a
--- /dev/null
+++ b/libraries/Firmata/examples/AnalogFirmata/Makefile
@@ -0,0 +1,263 @@
+# Arduino makefile
+#
+# This makefile allows you to build sketches from the command line
+# without the Arduino environment (or Java).
+#
+# The Arduino environment does preliminary processing on a sketch before
+# compiling it.  If you're using this makefile instead, you'll need to do
+# a few things differently:
+#
+#   - Give your program's file a .cpp extension (e.g. foo.cpp).
+#
+#   - Put this line at top of your code: #include <WProgram.h>
+#
+#   - Write prototypes for all your functions (or define them before you
+#     call them).  A prototype declares the types of parameters a
+#     function will take and what type of value it will return.  This
+#     means that you can have a call to a function before the definition
+#     of the function.  A function prototype looks like the first line of
+#     the function, with a semi-colon at the end.  For example:
+#     int digitalRead(int pin);
+#
+# Instructions for using the makefile:
+#
+#  1. Copy this file into the folder with your sketch.
+#
+#  2. Below, modify the line containing "TARGET" to refer to the name of
+#     of your program's file without an extension (e.g. TARGET = foo).
+#
+#  3. Modify the line containg "ARDUINO" to point the directory that
+#     contains the Arduino core (for normal Arduino installations, this
+#     is the hardware/cores/arduino sub-directory).
+#
+#  4. Modify the line containing "PORT" to refer to the filename
+#     representing the USB or serial connection to your Arduino board
+#     (e.g. PORT = /dev/tty.USB0).  If the exact name of this file
+#     changes, you can use * as a wildcard (e.g. PORT = /dev/tty.USB*).
+#
+#  5. At the command line, change to the directory containing your
+#     program's file and the makefile.
+#
+#  6. Type "make" and press enter to compile/verify your program.
+#
+#  7. Type "make upload", reset your Arduino board, and press enter  to
+#     upload your program to the Arduino board.
+#
+# $Id: Makefile,v 1.7 2007/04/13 05:28:23 eighthave Exp $
+
+PORT = /dev/tty.usbserial-*
+TARGET := $(shell pwd | sed 's|.*/\(.*\)|\1|')
+ARDUINO = /Applications/arduino
+ARDUINO_SRC = $(ARDUINO)/hardware/cores/arduino
+ARDUINO_LIB_SRC = $(ARDUINO)/hardware/libraries
+INCLUDE = -I$(ARDUINO_SRC) -I$(ARDUINO)/hardware/tools/avr/avr/include \
+	-I$(ARDUINO_LIB_SRC)/EEPROM \
+	-I$(ARDUINO_LIB_SRC)/Firmata \
+	-I$(ARDUINO_LIB_SRC)/Servo \
+	-I$(ARDUINO_LIB_SRC)
+SRC = $(wildcard $(ARDUINO_SRC)/*.c)
+CXXSRC = applet/$(TARGET).cpp $(ARDUINO_SRC)/HardwareSerial.cpp \
+	$(ARDUINO_LIB_SRC)/EEPROM/EEPROM.cpp \
+	$(ARDUINO_LIB_SRC)/Firmata/Firmata.cpp \
+	$(ARDUINO_LIB_SRC)/Servo/Servo.cpp \
+	$(ARDUINO_SRC)/WMath.cpp
+HEADERS = $(wildcard $(ARDUINO_SRC)/*.h) $(wildcard $(ARDUINO_LIB_SRC)/*/*.h)
+
+MCU = atmega168
+#MCU = atmega8
+F_CPU = 16000000
+FORMAT = ihex
+UPLOAD_RATE = 19200
+
+# Name of this Makefile (used for "make depend").
+MAKEFILE = Makefile
+
+# Debugging format.
+# Native formats for AVR-GCC's -g are stabs [default], or dwarf-2.
+# AVR (extended) COFF requires stabs, plus an avr-objcopy run.
+DEBUG = stabs
+
+OPT = s
+
+# Place -D or -U options here
+CDEFS = -DF_CPU=$(F_CPU)
+CXXDEFS = -DF_CPU=$(F_CPU)
+
+# Compiler flag to set the C Standard level.
+# c89   - "ANSI" C
+# gnu89 - c89 plus GCC extensions
+# c99   - ISO C99 standard (not yet fully implemented)
+# gnu99 - c99 plus GCC extensions
+CSTANDARD = -std=gnu99
+CDEBUG = -g$(DEBUG)
+CWARN = -Wall -Wstrict-prototypes
+CTUNING = -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
+#CEXTRA = -Wa,-adhlns=$(<:.c=.lst)
+
+CFLAGS = $(CDEBUG) $(CDEFS) $(INCLUDE) -O$(OPT) $(CWARN) $(CSTANDARD) $(CEXTRA)
+CXXFLAGS = $(CDEFS) $(INCLUDE) -O$(OPT)
+#ASFLAGS = -Wa,-adhlns=$(<:.S=.lst),-gstabs 
+LDFLAGS = 
+
+
+# Programming support using avrdude. Settings and variables.
+AVRDUDE_PROGRAMMER = stk500
+AVRDUDE_PORT = $(PORT)
+AVRDUDE_WRITE_FLASH = -U flash:w:applet/$(TARGET).hex
+AVRDUDE_FLAGS = -F -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER) \
+  -b $(UPLOAD_RATE) -q -V
+
+# Program settings
+CC = avr-gcc
+CXX = avr-g++
+OBJCOPY = avr-objcopy
+OBJDUMP = avr-objdump
+SIZE = avr-size
+NM = avr-nm
+AVRDUDE = avrdude
+REMOVE = rm -f
+MV = mv -f
+
+# Define all object files.
+OBJ = $(SRC:.c=.o) $(CXXSRC:.cpp=.o) $(ASRC:.S=.o)
+
+# Define all listing files.
+LST = $(ASRC:.S=.lst) $(CXXSRC:.cpp=.lst) $(SRC:.c=.lst)
+
+# Combine all necessary flags and optional flags.
+# Add target processor to flags.
+ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS)
+ALL_CXXFLAGS = -mmcu=$(MCU) -I. $(CXXFLAGS)
+ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
+
+
+# Default target.
+all: build
+
+build: applet/$(TARGET).hex
+
+eep: applet/$(TARGET).eep
+lss: applet/$(TARGET).lss 
+sym: applet/$(TARGET).sym
+
+
+# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
+COFFCONVERT=$(OBJCOPY) --debugging \
+--change-section-address .data-0x800000 \
+--change-section-address .bss-0x800000 \
+--change-section-address .noinit-0x800000 \
+--change-section-address .eeprom-0x810000 
+
+
+coff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+extcoff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-ext-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+.SUFFIXES: .elf .hex .eep .lss .sym .pde
+
+.elf.hex:
+	$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@
+
+.elf.eep:
+	-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
+	--change-section-lma .eeprom=0 -O $(FORMAT) $< $@
+
+# Create extended listing file from ELF output file.
+.elf.lss:
+	$(OBJDUMP) -h -S $< > $@
+
+# Create a symbol table from ELF output file.
+.elf.sym:
+	$(NM) -n $< > $@
+
+
+# Compile: create object files from C++ source files.
+.cpp.o: $(HEADERS)
+	$(CXX) -c $(ALL_CXXFLAGS) $< -o $@ 
+
+# Compile: create object files from C source files.
+.c.o: $(HEADERS)
+	$(CC)  -c $(ALL_CFLAGS) $< -o $@ 
+
+
+# Compile: create assembler files from C source files.
+.c.s:
+	$(CC) -S $(ALL_CFLAGS) $< -o $@
+
+
+# Assemble: create object files from assembler source files.
+.S.o:
+	$(CC) -c $(ALL_ASFLAGS) $< -o $@
+
+
+
+applet/$(TARGET).cpp: $(TARGET).pde
+	test -d applet || mkdir applet
+	echo '#include "WProgram.h"' > applet/$(TARGET).cpp
+	echo '#include "avr/interrupt.h"' >> applet/$(TARGET).cpp
+	sed -n 's|^\(void .*)\).*|\1;|p' $(TARGET).pde | grep -v 'setup()' | \
+		grep -v 'loop()' >> applet/$(TARGET).cpp
+	cat $(TARGET).pde >> applet/$(TARGET).cpp
+	cat $(ARDUINO_SRC)/main.cxx >> applet/$(TARGET).cpp
+
+# Link: create ELF output file from object files.
+applet/$(TARGET).elf: applet/$(TARGET).cpp $(OBJ)
+	$(CC) $(ALL_CFLAGS) $(OBJ) --output $@ $(LDFLAGS)
+
+pd_close_serial:
+	echo 'close;' | /Applications/Pd-extended.app/Contents/Resources/bin/pdsend 34567 || true
+
+# Program the device.  
+upload: applet/$(TARGET).hex
+	$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH)
+
+
+pd_test: build pd_close_serial upload
+
+# Target: clean project.
+clean:
+	$(REMOVE) -- applet/$(TARGET).hex applet/$(TARGET).eep \
+	applet/$(TARGET).cof applet/$(TARGET).elf $(TARGET).map \
+	applet/$(TARGET).sym applet/$(TARGET).lss applet/$(TARGET).cpp \
+	$(OBJ) $(LST) $(SRC:.c=.s) $(SRC:.c=.d) $(CXXSRC:.cpp=.s) $(CXXSRC:.cpp=.d)
+	rmdir -- applet
+
+depend:
+	if grep '^# DO NOT DELETE' $(MAKEFILE) >/dev/null; \
+	then \
+		sed -e '/^# DO NOT DELETE/,$$d' $(MAKEFILE) > \
+			$(MAKEFILE).$$$$ && \
+		$(MV) $(MAKEFILE).$$$$ $(MAKEFILE); \
+	fi
+	echo '# DO NOT DELETE THIS LINE -- make depend depends on it.' \
+		>> $(MAKEFILE); \
+	$(CC) -M -mmcu=$(MCU) $(CDEFS) $(INCLUDE) $(SRC) $(ASRC) >> $(MAKEFILE)
+
+.PHONY:	all build eep lss sym coff extcoff clean depend pd_close_serial pd_test
+
+# for emacs
+etags:
+	make etags_`uname -s`
+	etags *.pde \
+		$(ARDUINO_SRC)/*.[ch] \
+		$(ARDUINO_SRC)/*.cpp \
+		$(ARDUINO_LIB_SRC)/*/*.[ch] \
+		$(ARDUINO_LIB_SRC)/*/*.cpp \
+		$(ARDUINO)/hardware/tools/avr/avr/include/avr/*.[ch] \
+		$(ARDUINO)/hardware/tools/avr/avr/include/*.[ch]
+
+etags_Darwin:
+#	etags -a 
+
+etags_Linux:
+#	etags -a /usr/include/*.h linux/input.h /usr/include/sys/*.h
+
+etags_MINGW:
+#	etags -a /usr/include/*.h /usr/include/sys/*.h 
+
+
+
diff --git a/libraries/Firmata/examples/EchoString/EchoString.pde b/libraries/Firmata/examples/EchoString/EchoString.pde
new file mode 100644
index 0000000..e5c4e6f
--- /dev/null
+++ b/libraries/Firmata/examples/EchoString/EchoString.pde
@@ -0,0 +1,40 @@
+/* This sketch accepts strings and raw sysex messages and echos them back.
+ *
+ * This example code is in the public domain.
+ */
+#include <Firmata.h>
+
+byte analogPin;
+
+void stringCallback(char *myString)
+{
+    Firmata.sendString(myString);
+}
+
+
+void sysexCallback(byte command, byte argc, byte*argv)
+{
+    Serial.write(START_SYSEX);
+    Serial.write(command);
+    for(byte i=0; i<argc; i++) {
+        Serial.write(argv[i]);
+    }
+    Serial.write(END_SYSEX);
+}
+
+void setup()
+{
+    Firmata.setFirmwareVersion(0, 1);
+    Firmata.attach(STRING_DATA, stringCallback);
+    Firmata.attach(START_SYSEX, sysexCallback);
+    Firmata.begin(57600);
+}
+
+void loop()
+{
+    while(Firmata.available()) {
+        Firmata.processInput();
+    }
+}
+
+
diff --git a/libraries/Firmata/examples/EchoString/Makefile b/libraries/Firmata/examples/EchoString/Makefile
new file mode 100644
index 0000000..e968c0a
--- /dev/null
+++ b/libraries/Firmata/examples/EchoString/Makefile
@@ -0,0 +1,263 @@
+# Arduino makefile
+#
+# This makefile allows you to build sketches from the command line
+# without the Arduino environment (or Java).
+#
+# The Arduino environment does preliminary processing on a sketch before
+# compiling it.  If you're using this makefile instead, you'll need to do
+# a few things differently:
+#
+#   - Give your program's file a .cpp extension (e.g. foo.cpp).
+#
+#   - Put this line at top of your code: #include <WProgram.h>
+#
+#   - Write prototypes for all your functions (or define them before you
+#     call them).  A prototype declares the types of parameters a
+#     function will take and what type of value it will return.  This
+#     means that you can have a call to a function before the definition
+#     of the function.  A function prototype looks like the first line of
+#     the function, with a semi-colon at the end.  For example:
+#     int digitalRead(int pin);
+#
+# Instructions for using the makefile:
+#
+#  1. Copy this file into the folder with your sketch.
+#
+#  2. Below, modify the line containing "TARGET" to refer to the name of
+#     of your program's file without an extension (e.g. TARGET = foo).
+#
+#  3. Modify the line containg "ARDUINO" to point the directory that
+#     contains the Arduino core (for normal Arduino installations, this
+#     is the hardware/cores/arduino sub-directory).
+#
+#  4. Modify the line containing "PORT" to refer to the filename
+#     representing the USB or serial connection to your Arduino board
+#     (e.g. PORT = /dev/tty.USB0).  If the exact name of this file
+#     changes, you can use * as a wildcard (e.g. PORT = /dev/tty.USB*).
+#
+#  5. At the command line, change to the directory containing your
+#     program's file and the makefile.
+#
+#  6. Type "make" and press enter to compile/verify your program.
+#
+#  7. Type "make upload", reset your Arduino board, and press enter  to
+#     upload your program to the Arduino board.
+#
+# $Id: Makefile,v 1.7 2007/04/13 05:28:23 eighthave Exp $
+
+PORT = /dev/tty.usbserial-*
+TARGET := $(shell pwd | sed 's|.*/\(.*\)|\1|')
+ARDUINO = /Applications/arduino
+ARDUINO_SRC = $(ARDUINO)/hardware/cores/arduino
+ARDUINO_LIB_SRC = $(ARDUINO)/hardware/libraries
+INCLUDE = -I$(ARDUINO_SRC) -I$(ARDUINO)/hardware/tools/avr/avr/include \
+	-I$(ARDUINO_LIB_SRC)/EEPROM \
+	-I$(ARDUINO_LIB_SRC)/Firmata \
+	-I$(ARDUINO_LIB_SRC)/Servo \
+	-I$(ARDUINO_LIB_SRC)
+SRC = $(wildcard $(ARDUINO_SRC)/*.c)
+CXXSRC = applet/$(TARGET).cpp $(ARDUINO_SRC)/HardwareSerial.cpp \
+	$(ARDUINO_LIB_SRC)/EEPROM/EEPROM.cpp \
+	$(ARDUINO_LIB_SRC)/Firmata/Firmata.cpp \
+	$(ARDUINO_LIB_SRC)/Servo/Servo.cpp \
+	$(ARDUINO_SRC)/WMath.cpp
+HEADERS = $(wildcard $(ARDUINO_SRC)/*.h) $(wildcard $(ARDUINO_LIB_SRC)/*/*.h)
+
+MCU = atmega168
+#MCU = atmega8
+F_CPU = 16000000
+FORMAT = ihex
+UPLOAD_RATE = 19200
+
+# Name of this Makefile (used for "make depend").
+MAKEFILE = Makefile
+
+# Debugging format.
+# Native formats for AVR-GCC's -g are stabs [default], or dwarf-2.
+# AVR (extended) COFF requires stabs, plus an avr-objcopy run.
+DEBUG = stabs
+
+OPT = s
+
+# Place -D or -U options here
+CDEFS = -DF_CPU=$(F_CPU)
+CXXDEFS = -DF_CPU=$(F_CPU)
+
+# Compiler flag to set the C Standard level.
+# c89   - "ANSI" C
+# gnu89 - c89 plus GCC extensions
+# c99   - ISO C99 standard (not yet fully implemented)
+# gnu99 - c99 plus GCC extensions
+CSTANDARD = -std=gnu99
+CDEBUG = -g$(DEBUG)
+CWARN = -Wall -Wstrict-prototypes
+CTUNING = -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
+#CEXTRA = -Wa,-adhlns=$(<:.c=.lst)
+
+CFLAGS = $(CDEBUG) $(CDEFS) $(INCLUDE) -O$(OPT) $(CWARN) $(CSTANDARD) $(CEXTRA)
+CXXFLAGS = $(CDEFS) $(INCLUDE) -O$(OPT)
+#ASFLAGS = -Wa,-adhlns=$(<:.S=.lst),-gstabs 
+LDFLAGS = 
+
+
+# Programming support using avrdude. Settings and variables.
+AVRDUDE_PROGRAMMER = stk500
+AVRDUDE_PORT = $(PORT)
+AVRDUDE_WRITE_FLASH = -U flash:w:applet/$(TARGET).hex
+AVRDUDE_FLAGS = -F -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER) \
+  -b $(UPLOAD_RATE) -q -V
+
+# Program settings
+CC = avr-gcc
+CXX = avr-g++
+OBJCOPY = avr-objcopy
+OBJDUMP = avr-objdump
+SIZE = avr-size
+NM = avr-nm
+AVRDUDE = avrdude
+REMOVE = rm -f
+MV = mv -f
+
+# Define all object files.
+OBJ = $(SRC:.c=.o) $(CXXSRC:.cpp=.o) $(ASRC:.S=.o)
+
+# Define all listing files.
+LST = $(ASRC:.S=.lst) $(CXXSRC:.cpp=.lst) $(SRC:.c=.lst)
+
+# Combine all necessary flags and optional flags.
+# Add target processor to flags.
+ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS)
+ALL_CXXFLAGS = -mmcu=$(MCU) -I. $(CXXFLAGS)
+ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
+
+
+# Default target.
+all: build
+
+build: applet/$(TARGET).hex
+
+eep: applet/$(TARGET).eep
+lss: applet/$(TARGET).lss 
+sym: applet/$(TARGET).sym
+
+
+# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
+COFFCONVERT=$(OBJCOPY) --debugging \
+--change-section-address .data-0x800000 \
+--change-section-address .bss-0x800000 \
+--change-section-address .noinit-0x800000 \
+--change-section-address .eeprom-0x810000 
+
+
+coff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+extcoff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-ext-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+.SUFFIXES: .elf .hex .eep .lss .sym .pde
+
+.elf.hex:
+	$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@
+
+.elf.eep:
+	-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
+	--change-section-lma .eeprom=0 -O $(FORMAT) $< $@
+
+# Create extended listing file from ELF output file.
+.elf.lss:
+	$(OBJDUMP) -h -S $< > $@
+
+# Create a symbol table from ELF output file.
+.elf.sym:
+	$(NM) -n $< > $@
+
+
+# Compile: create object files from C++ source files.
+.cpp.o: $(HEADERS)
+	$(CXX) -c $(ALL_CXXFLAGS) $< -o $@ 
+
+# Compile: create object files from C source files.
+.c.o: $(HEADERS)
+	$(CC)  -c $(ALL_CFLAGS) $< -o $@ 
+
+
+# Compile: create assembler files from C source files.
+.c.s:
+	$(CC) -S $(ALL_CFLAGS) $< -o $@
+
+
+# Assemble: create object files from assembler source files.
+.S.o:
+	$(CC) -c $(ALL_ASFLAGS) $< -o $@
+
+
+
+applet/$(TARGET).cpp: $(TARGET).pde
+	test -d applet || mkdir applet
+	echo '#include "WProgram.h"' > applet/$(TARGET).cpp
+	echo '#include "avr/interrupt.h"' >> applet/$(TARGET).cpp
+	sed -n 's|^\(void .*)\).*|\1;|p' $(TARGET).pde | grep -v 'setup()' | \
+		grep -v 'loop()' >> applet/$(TARGET).cpp
+	cat $(TARGET).pde >> applet/$(TARGET).cpp
+	cat $(ARDUINO_SRC)/main.cxx >> applet/$(TARGET).cpp
+
+# Link: create ELF output file from object files.
+applet/$(TARGET).elf: applet/$(TARGET).cpp $(OBJ)
+	$(CC) $(ALL_CFLAGS) $(OBJ) --output $@ $(LDFLAGS)
+
+pd_close_serial:
+	echo 'close;' | /Applications/Pd-extended.app/Contents/Resources/bin/pdsend 34567 || true
+
+# Program the device.  
+upload: applet/$(TARGET).hex
+	$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH)
+
+
+pd_test: build pd_close_serial upload
+
+# Target: clean project.
+clean:
+	$(REMOVE) -- applet/$(TARGET).hex applet/$(TARGET).eep \
+	applet/$(TARGET).cof applet/$(TARGET).elf $(TARGET).map \
+	applet/$(TARGET).sym applet/$(TARGET).lss applet/$(TARGET).cpp \
+	$(OBJ) $(LST) $(SRC:.c=.s) $(SRC:.c=.d) $(CXXSRC:.cpp=.s) $(CXXSRC:.cpp=.d)
+	rmdir -- applet
+
+depend:
+	if grep '^# DO NOT DELETE' $(MAKEFILE) >/dev/null; \
+	then \
+		sed -e '/^# DO NOT DELETE/,$$d' $(MAKEFILE) > \
+			$(MAKEFILE).$$$$ && \
+		$(MV) $(MAKEFILE).$$$$ $(MAKEFILE); \
+	fi
+	echo '# DO NOT DELETE THIS LINE -- make depend depends on it.' \
+		>> $(MAKEFILE); \
+	$(CC) -M -mmcu=$(MCU) $(CDEFS) $(INCLUDE) $(SRC) $(ASRC) >> $(MAKEFILE)
+
+.PHONY:	all build eep lss sym coff extcoff clean depend pd_close_serial pd_test
+
+# for emacs
+etags:
+	make etags_`uname -s`
+	etags *.pde \
+		$(ARDUINO_SRC)/*.[ch] \
+		$(ARDUINO_SRC)/*.cpp \
+		$(ARDUINO_LIB_SRC)/*/*.[ch] \
+		$(ARDUINO_LIB_SRC)/*/*.cpp \
+		$(ARDUINO)/hardware/tools/avr/avr/include/avr/*.[ch] \
+		$(ARDUINO)/hardware/tools/avr/avr/include/*.[ch]
+
+etags_Darwin:
+#	etags -a 
+
+etags_Linux:
+#	etags -a /usr/include/*.h linux/input.h /usr/include/sys/*.h
+
+etags_MINGW:
+#	etags -a /usr/include/*.h /usr/include/sys/*.h 
+
+
+
diff --git a/libraries/Firmata/examples/I2CFirmata/I2CFirmata.pde b/libraries/Firmata/examples/I2CFirmata/I2CFirmata.pde
new file mode 100644
index 0000000..11202e9
--- /dev/null
+++ b/libraries/Firmata/examples/I2CFirmata/I2CFirmata.pde
@@ -0,0 +1,217 @@
+/*
+ Copyright (C) 2009 Jeff Hoefs.  All rights reserved.
+ Copyright (C) 2009 Shigeru Kobayashi.  All rights reserved.
+ 
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+ 
+ See file LICENSE.txt for further informations on licensing terms.
+ */
+
+#include <Wire.h>
+#include <Firmata.h>
+
+
+#define I2C_WRITE B00000000
+#define I2C_READ B00001000
+#define I2C_READ_CONTINUOUSLY B00010000
+#define I2C_STOP_READING B00011000
+#define I2C_READ_WRITE_MODE_MASK B00011000
+
+#define MAX_QUERIES 8
+
+unsigned long currentMillis;     // store the current value from millis()
+unsigned long previousMillis;    // for comparison with currentMillis
+unsigned int samplingInterval = 32;  // default sampling interval is 33ms
+unsigned int i2cReadDelayTime = 0;  // default delay time between i2c read request and Wire.requestFrom()
+unsigned int powerPinsEnabled = 0;  // use as boolean to prevent enablePowerPins from being called more than once
+
+#define MINIMUM_SAMPLING_INTERVAL 10
+
+#define REGISTER_NOT_SPECIFIED -1
+
+struct i2c_device_info {
+  byte addr;
+  byte reg;
+  byte bytes;
+};
+
+i2c_device_info query[MAX_QUERIES];
+
+byte i2cRxData[32];
+boolean readingContinuously = false;
+byte queryIndex = 0;
+
+void readAndReportData(byte address, int theRegister, byte numBytes)
+{
+  if (theRegister != REGISTER_NOT_SPECIFIED) {
+    Wire.beginTransmission(address);
+    Wire.send((byte)theRegister);
+    Wire.endTransmission();
+    delayMicroseconds(i2cReadDelayTime);  // delay is necessary for some devices such as WiiNunchuck
+  } 
+  else {
+    theRegister = 0;  // fill the register with a dummy value
+  }
+
+  Wire.requestFrom(address, numBytes);
+
+  // check to be sure correct number of bytes were returned by slave
+  if(numBytes == Wire.available()) {
+    i2cRxData[0] = address;
+    i2cRxData[1] = theRegister;
+    for (int i = 0; i < numBytes; i++) {
+      i2cRxData[2 + i] = Wire.receive();
+    }
+    // send slave address, register and received bytes
+    Firmata.sendSysex(I2C_REPLY, numBytes + 2, i2cRxData);
+  }
+  else {
+    if(numBytes > Wire.available()) {
+      Firmata.sendString("I2C Read Error: Too many bytes received");
+    } else {
+      Firmata.sendString("I2C Read Error: Too few bytes received"); 
+    }
+  }
+  
+}
+
+void sysexCallback(byte command, byte argc, byte *argv)
+{
+  byte mode;
+  byte slaveAddress;
+  byte slaveRegister;
+  byte data;
+  int  delayTime;
+
+  if (command == I2C_REQUEST) {
+    mode = argv[1] & I2C_READ_WRITE_MODE_MASK;
+    slaveAddress = argv[0];
+
+    switch(mode) {
+    case I2C_WRITE:
+      Wire.beginTransmission(slaveAddress);
+      for (byte i = 2; i < argc; i += 2) {
+        data = argv[i] + (argv[i + 1] << 7);
+        Wire.send(data);
+      }
+      Wire.endTransmission();
+      delayMicroseconds(70); // TODO is this needed?
+      break;
+    case I2C_READ:
+      if (argc == 6) {
+        // a slave register is specified
+        slaveRegister = argv[2] + (argv[3] << 7);
+        data = argv[4] + (argv[5] << 7);  // bytes to read
+        readAndReportData(slaveAddress, (int)slaveRegister, data);
+      } 
+      else {
+        // a slave register is NOT specified
+        data = argv[2] + (argv[3] << 7);  // bytes to read
+        readAndReportData(slaveAddress, (int)REGISTER_NOT_SPECIFIED, data);
+      }
+      break;
+    case I2C_READ_CONTINUOUSLY:
+      if ((queryIndex + 1) >= MAX_QUERIES) {
+        // too many queries, just ignore
+        Firmata.sendString("too many queries");
+        break;
+      }
+      query[queryIndex].addr = slaveAddress;
+      query[queryIndex].reg = argv[2] + (argv[3] << 7);
+      query[queryIndex].bytes = argv[4] + (argv[5] << 7);
+      readingContinuously = true;
+      queryIndex++;
+      break;
+    case I2C_STOP_READING:
+      readingContinuously = false;
+      queryIndex = 0;
+      break;
+    default:
+      break;
+    }
+  }
+  else if (command == SAMPLING_INTERVAL) {
+    samplingInterval = argv[0] + (argv[1] << 7);
+
+    if (samplingInterval < MINIMUM_SAMPLING_INTERVAL) {
+      samplingInterval = MINIMUM_SAMPLING_INTERVAL;
+    }
+
+    samplingInterval -= 1;
+    Firmata.sendString("sampling interval");
+  }
+
+  else if (command == I2C_CONFIG) {
+    delayTime = (argv[4] + (argv[5] << 7));                        // MSB
+    delayTime = (delayTime << 8) + (argv[2] + (argv[3] << 7));     // add LSB
+
+    if((argv[0] + (argv[1] << 7)) > 0) {
+      enablePowerPins(PORTC3, PORTC2);
+    }
+
+    if(delayTime > 0) {
+      i2cReadDelayTime = delayTime;
+    }
+
+    if(argc > 6) {
+      // If you extend I2C_Config, handle your data here
+    }
+
+  }
+}
+
+void systemResetCallback()
+{
+  readingContinuously = false;
+  queryIndex = 0;
+}
+
+/* reference: BlinkM_funcs.h by Tod E. Kurt, ThingM, http://thingm.com/ */
+// Enables Pins A2 and A3 to be used as GND and Power
+// so that I2C devices can be plugged directly
+// into Arduino header (pins A2 - A5)
+static void enablePowerPins(byte pwrpin, byte gndpin)
+{
+  if(powerPinsEnabled == 0) {
+    DDRC |= _BV(pwrpin) | _BV(gndpin);
+    PORTC &=~ _BV(gndpin);
+    PORTC |=  _BV(pwrpin);
+    powerPinsEnabled = 1;
+    Firmata.sendString("Power pins enabled");
+    delay(100);
+  }
+}
+
+void setup()
+{
+  Firmata.setFirmwareVersion(2, 0);
+
+  Firmata.attach(START_SYSEX, sysexCallback);
+  Firmata.attach(SYSTEM_RESET, systemResetCallback);
+
+  for (int i = 0; i < TOTAL_PINS; ++i) {
+    pinMode(i, OUTPUT);
+  }
+
+  Firmata.begin(57600);  
+  Wire.begin();
+}
+
+void loop()
+{
+  while (Firmata.available()) {
+    Firmata.processInput();
+  }
+
+  currentMillis = millis();
+  if (currentMillis - previousMillis > samplingInterval) {
+    previousMillis += samplingInterval;
+
+    for (byte i = 0; i < queryIndex; i++) {
+      readAndReportData(query[i].addr, query[i].reg, query[i].bytes);
+    }
+  }
+}
diff --git a/libraries/Firmata/examples/OldStandardFirmata/LICENSE.txt b/libraries/Firmata/examples/OldStandardFirmata/LICENSE.txt
new file mode 100644
index 0000000..77cec6d
--- /dev/null
+++ b/libraries/Firmata/examples/OldStandardFirmata/LICENSE.txt
@@ -0,0 +1,458 @@
+
+		  GNU LESSER GENERAL PUBLIC LICENSE
+		       Version 2.1, February 1999
+
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+ 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL.  It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+			    Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+  This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it.  You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+  When we speak of free software, we are referring to freedom of use,
+not price.  Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+  To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights.  These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+  For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you.  You must make sure that they, too, receive or can get the source
+code.  If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it.  And you must show them these terms so they know their rights.
+
+  We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+  To protect each distributor, we want to make it very clear that
+there is no warranty for the free library.  Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+  Finally, software patents pose a constant threat to the existence of
+any free program.  We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder.  Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+  Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License.  This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License.  We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+  When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library.  The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom.  The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+  We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License.  It also provides other free software developers Less
+of an advantage over competing non-free programs.  These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries.  However, the Lesser license provides advantages in certain
+special circumstances.
+
+  For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard.  To achieve this, non-free programs must be
+allowed to use the library.  A more frequent case is that a free
+library does the same job as widely used non-free libraries.  In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+  In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software.  For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+  Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.  Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library".  The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+		  GNU LESSER GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+  A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+  The "Library", below, refers to any such software library or work
+which has been distributed under these terms.  A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language.  (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+  "Source code" for a work means the preferred form of the work for
+making modifications to it.  For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control compilation
+and installation of the library.
+
+  Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it).  Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+  
+  1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+
+  You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+
+  2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) The modified work must itself be a software library.
+
+    b) You must cause the files modified to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    c) You must cause the whole of the work to be licensed at no
+    charge to all third parties under the terms of this License.
+
+    d) If a facility in the modified Library refers to a function or a
+    table of data to be supplied by an application program that uses
+    the facility, other than as an argument passed when the facility
+    is invoked, then you must make a good faith effort to ensure that,
+    in the event an application does not supply such function or
+    table, the facility still operates, and performs whatever part of
+    its purpose remains meaningful.
+
+    (For example, a function in a library to compute square roots has
+    a purpose that is entirely well-defined independent of the
+    application.  Therefore, Subsection 2d requires that any
+    application-supplied function or table used by this function must
+    be optional: if the application does not supply it, the square
+    root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library.  To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License.  (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.)  Do not make any other change in
+these notices.
+
+  Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+  This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+  4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+  If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library".  Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+  However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library".  The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+  When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library.  The
+threshold for this to be true is not precisely defined by law.
+
+  If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work.  (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+  Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+
+  6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+  You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License.  You must supply a copy of this License.  If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License.  Also, you must do one
+of these things:
+
+    a) Accompany the work with the complete corresponding
+    machine-readable source code for the Library including whatever
+    changes were used in the work (which must be distributed under
+    Sections 1 and 2 above); and, if the work is an executable linked
+    with the Library, with the complete machine-readable "work that
+    uses the Library", as object code and/or source code, so that the
+    user can modify the Library and then relink to produce a modified
+    executable containing the modified Library.  (It is understood
+    that the user who changes the contents of definitions files in the
+    Library will not necessarily be able to recompile the application
+    to use the modified definitions.)
+
+    b) Use a suitable shared library mechanism for linking with the
+    Library.  A suitable mechanism is one that (1) uses at run time a
+    copy of the library already present on the user's computer system,
+    rather than copying library functions into the executable, and (2)
+    will operate properly with a modified version of the library, if
+    the user installs one, as long as the modified version is
+    interface-compatible with the version that the work was made with.
+
+    c) Accompany the work with a written offer, valid for at
+    least three years, to give the same user the materials
+    specified in Subsection 6a, above, for a charge no more
+    than the cost of performing this distribution.
+
+    d) If distribution of the work is made by offering access to copy
+    from a designated place, offer equivalent access to copy the above
+    specified materials from the same place.
+
+    e) Verify that the user has already received a copy of these
+    materials or that you have already sent this user a copy.
+
+  For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it.  However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+  It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system.  Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+
+  7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+    a) Accompany the combined library with a copy of the same work
+    based on the Library, uncombined with any other library
+    facilities.  This must be distributed under the terms of the
+    Sections above.
+
+    b) Give prominent notice with the combined library of the fact
+    that part of it is a work based on the Library, and explaining
+    where to find the accompanying uncombined form of the same work.
+
+  8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License.  Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License.  However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+  9. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Library or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+  10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+
+  11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply,
+and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License may add
+an explicit geographical distribution limitation excluding those countries,
+so that distribution is permitted only in or among countries not thus
+excluded.  In such case, this License incorporates the limitation as if
+written in the body of this License.
+
+  13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation.  If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+
+  14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission.  For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this.  Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+			    NO WARRANTY
+
+  15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
diff --git a/libraries/Firmata/examples/OldStandardFirmata/OldStandardFirmata.pde b/libraries/Firmata/examples/OldStandardFirmata/OldStandardFirmata.pde
new file mode 100644
index 0000000..56a47ac
--- /dev/null
+++ b/libraries/Firmata/examples/OldStandardFirmata/OldStandardFirmata.pde
@@ -0,0 +1,228 @@
+/*
+  Copyright (C) 2006-2008 Hans-Christoph Steiner.  All rights reserved.
+ 
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+ 
+  See file LICENSE.txt for further informations on licensing terms.
+ */
+
+/* 
+ * This is an old version of StandardFirmata (v2.0).  It is kept here because
+ * its the last version that works on an ATMEGA8 chip.  Also, it can be used
+ * for host software that has not been updated to a newer version of the
+ * protocol.  It also uses the old baud rate of 115200 rather than 57600.
+ */
+
+#include <EEPROM.h>
+#include <Firmata.h>
+
+/*==============================================================================
+ * GLOBAL VARIABLES
+ *============================================================================*/
+
+/* analog inputs */
+int analogInputsToReport = 0; // bitwise array to store pin reporting
+int analogPin = 0; // counter for reading analog pins
+
+/* digital pins */
+byte reportPINs[TOTAL_PORTS];   // PIN == input port
+byte previousPINs[TOTAL_PORTS]; // PIN == input port
+byte pinStatus[TOTAL_PINS]; // store pin status, default OUTPUT
+byte portStatus[TOTAL_PORTS];
+
+/* timer variables */
+unsigned long currentMillis;     // store the current value from millis()
+unsigned long previousMillis;    // for comparison with currentMillis
+
+
+/*==============================================================================
+ * FUNCTIONS                                                                
+ *============================================================================*/
+
+void outputPort(byte portNumber, byte portValue)
+{
+  portValue = portValue &~ portStatus[portNumber];
+  if(previousPINs[portNumber] != portValue) {
+        Firmata.sendDigitalPort(portNumber, portValue); 
+        previousPINs[portNumber] = portValue;
+        Firmata.sendDigitalPort(portNumber, portValue); 
+    }
+}
+
+/* -----------------------------------------------------------------------------
+ * check all the active digital inputs for change of state, then add any events
+ * to the Serial output queue using Serial.print() */
+void checkDigitalInputs(void) 
+{
+    byte i, tmp;
+    for(i=0; i < TOTAL_PORTS; i++) {
+        if(reportPINs[i]) {
+            switch(i) {
+            case 0: outputPort(0, PIND &~ B00000011); break; // ignore Rx/Tx 0/1
+            case 1: outputPort(1, PINB); break;
+            case 2: outputPort(2, PINC); break;
+            }
+        }
+    }
+}
+
+// -----------------------------------------------------------------------------
+/* sets the pin mode to the correct state and sets the relevant bits in the
+ * two bit-arrays that track Digital I/O and PWM status
+ */
+void setPinModeCallback(byte pin, int mode) {
+    byte port = 0;
+    byte offset = 0;
+
+    if (pin < 8) {
+      port = 0;
+      offset = 0;
+    } else if (pin < 14) {
+      port = 1;
+      offset = 8;     
+    } else if (pin < 22) {
+      port = 2;
+      offset = 14;
+    }
+
+    if(pin > 1) { // ignore RxTx (pins 0 and 1)
+        pinStatus[pin] = mode;
+        switch(mode) {
+        case INPUT:
+            pinMode(pin, INPUT);
+            portStatus[port] = portStatus[port] &~ (1 << (pin - offset));
+            break;
+        case OUTPUT:
+            digitalWrite(pin, LOW); // disable PWM
+        case PWM:
+            pinMode(pin, OUTPUT);
+            portStatus[port] = portStatus[port] | (1 << (pin - offset));
+            break;
+        //case ANALOG: // TODO figure this out
+        default:
+            Firmata.sendString("");
+        }
+        // TODO: save status to EEPROM here, if changed
+    }
+}
+
+void analogWriteCallback(byte pin, int value)
+{
+    setPinModeCallback(pin,PWM);
+    analogWrite(pin, value);
+}
+
+void digitalWriteCallback(byte port, int value)
+{
+    switch(port) {
+    case 0: // pins 2-7 (don't change Rx/Tx, pins 0 and 1)
+        // 0xFF03 == B1111111100000011    0x03 == B00000011
+        PORTD = (value &~ 0xFF03) | (PORTD & 0x03);
+        break;
+    case 1: // pins 8-13 (14,15 are disabled for the crystal) 
+        PORTB = (byte)value;
+        break;
+    case 2: // analog pins used as digital
+        PORTC = (byte)value;
+        break;
+    }
+}
+
+// -----------------------------------------------------------------------------
+/* sets bits in a bit array (int) to toggle the reporting of the analogIns
+ */
+//void FirmataClass::setAnalogPinReporting(byte pin, byte state) {
+//}
+void reportAnalogCallback(byte pin, int value)
+{
+    if(value == 0) {
+        analogInputsToReport = analogInputsToReport &~ (1 << pin);
+    }
+    else { // everything but 0 enables reporting of that pin
+        analogInputsToReport = analogInputsToReport | (1 << pin);
+    }
+    // TODO: save status to EEPROM here, if changed
+}
+
+void reportDigitalCallback(byte port, int value)
+{
+    reportPINs[port] = (byte)value;
+    if(port == 2) // turn off analog reporting when used as digital
+        analogInputsToReport = 0;
+}
+
+/*==============================================================================
+ * SETUP()
+ *============================================================================*/
+void setup() 
+{
+    byte i;
+
+    Firmata.setFirmwareVersion(2, 0);
+
+    Firmata.attach(ANALOG_MESSAGE, analogWriteCallback);
+    Firmata.attach(DIGITAL_MESSAGE, digitalWriteCallback);
+    Firmata.attach(REPORT_ANALOG, reportAnalogCallback);
+    Firmata.attach(REPORT_DIGITAL, reportDigitalCallback);
+    Firmata.attach(SET_PIN_MODE, setPinModeCallback);
+
+    portStatus[0] = B00000011;  // ignore Tx/RX pins
+    portStatus[1] = B11000000;  // ignore 14/15 pins 
+    portStatus[2] = B00000000;
+
+//    for(i=0; i<TOTAL_PINS; ++i) { // TODO make this work with analogs
+    for(i=0; i<14; ++i) {
+        setPinModeCallback(i,OUTPUT);
+    }
+    // set all outputs to 0 to make sure internal pull-up resistors are off
+    PORTB = 0; // pins 8-15
+    PORTC = 0; // analog port
+    PORTD = 0; // pins 0-7
+
+    // TODO rethink the init, perhaps it should report analog on default
+    for(i=0; i<TOTAL_PORTS; ++i) {
+        reportPINs[i] = false;
+    }
+    // TODO: load state from EEPROM here
+
+    /* send digital inputs here, if enabled, to set the initial state on the
+     * host computer, since once in the loop(), this firmware will only send
+     * digital data on change. */
+    if(reportPINs[0]) outputPort(0, PIND &~ B00000011); // ignore Rx/Tx 0/1
+    if(reportPINs[1]) outputPort(1, PINB);
+    if(reportPINs[2]) outputPort(2, PINC);
+
+    Firmata.begin(115200);
+}
+
+/*==============================================================================
+ * LOOP()
+ *============================================================================*/
+void loop() 
+{
+/* DIGITALREAD - as fast as possible, check for changes and output them to the
+ * FTDI buffer using Serial.print()  */
+    checkDigitalInputs();  
+    currentMillis = millis();
+    if(currentMillis - previousMillis > 20) {  
+        previousMillis += 20;     // run this every 20ms
+        /* SERIALREAD - Serial.read() uses a 128 byte circular buffer, so handle
+         * all serialReads at once, i.e. empty the buffer */
+        while(Firmata.available())
+            Firmata.processInput();
+        /* SEND FTDI WRITE BUFFER - make sure that the FTDI buffer doesn't go over
+         * 60 bytes. use a timer to sending an event character every 4 ms to
+         * trigger the buffer to dump. */
+	
+        /* ANALOGREAD - right after the event character, do all of the
+         * analogReads().  These only need to be done every 4ms. */
+        for(analogPin=0;analogPin<TOTAL_ANALOG_PINS;analogPin++) {
+            if( analogInputsToReport & (1 << analogPin) ) {
+                Firmata.sendAnalog(analogPin, analogRead(analogPin));
+            }
+        }
+    }
+}
diff --git a/libraries/Firmata/examples/ServoFirmata/Makefile b/libraries/Firmata/examples/ServoFirmata/Makefile
new file mode 100644
index 0000000..e968c0a
--- /dev/null
+++ b/libraries/Firmata/examples/ServoFirmata/Makefile
@@ -0,0 +1,263 @@
+# Arduino makefile
+#
+# This makefile allows you to build sketches from the command line
+# without the Arduino environment (or Java).
+#
+# The Arduino environment does preliminary processing on a sketch before
+# compiling it.  If you're using this makefile instead, you'll need to do
+# a few things differently:
+#
+#   - Give your program's file a .cpp extension (e.g. foo.cpp).
+#
+#   - Put this line at top of your code: #include <WProgram.h>
+#
+#   - Write prototypes for all your functions (or define them before you
+#     call them).  A prototype declares the types of parameters a
+#     function will take and what type of value it will return.  This
+#     means that you can have a call to a function before the definition
+#     of the function.  A function prototype looks like the first line of
+#     the function, with a semi-colon at the end.  For example:
+#     int digitalRead(int pin);
+#
+# Instructions for using the makefile:
+#
+#  1. Copy this file into the folder with your sketch.
+#
+#  2. Below, modify the line containing "TARGET" to refer to the name of
+#     of your program's file without an extension (e.g. TARGET = foo).
+#
+#  3. Modify the line containg "ARDUINO" to point the directory that
+#     contains the Arduino core (for normal Arduino installations, this
+#     is the hardware/cores/arduino sub-directory).
+#
+#  4. Modify the line containing "PORT" to refer to the filename
+#     representing the USB or serial connection to your Arduino board
+#     (e.g. PORT = /dev/tty.USB0).  If the exact name of this file
+#     changes, you can use * as a wildcard (e.g. PORT = /dev/tty.USB*).
+#
+#  5. At the command line, change to the directory containing your
+#     program's file and the makefile.
+#
+#  6. Type "make" and press enter to compile/verify your program.
+#
+#  7. Type "make upload", reset your Arduino board, and press enter  to
+#     upload your program to the Arduino board.
+#
+# $Id: Makefile,v 1.7 2007/04/13 05:28:23 eighthave Exp $
+
+PORT = /dev/tty.usbserial-*
+TARGET := $(shell pwd | sed 's|.*/\(.*\)|\1|')
+ARDUINO = /Applications/arduino
+ARDUINO_SRC = $(ARDUINO)/hardware/cores/arduino
+ARDUINO_LIB_SRC = $(ARDUINO)/hardware/libraries
+INCLUDE = -I$(ARDUINO_SRC) -I$(ARDUINO)/hardware/tools/avr/avr/include \
+	-I$(ARDUINO_LIB_SRC)/EEPROM \
+	-I$(ARDUINO_LIB_SRC)/Firmata \
+	-I$(ARDUINO_LIB_SRC)/Servo \
+	-I$(ARDUINO_LIB_SRC)
+SRC = $(wildcard $(ARDUINO_SRC)/*.c)
+CXXSRC = applet/$(TARGET).cpp $(ARDUINO_SRC)/HardwareSerial.cpp \
+	$(ARDUINO_LIB_SRC)/EEPROM/EEPROM.cpp \
+	$(ARDUINO_LIB_SRC)/Firmata/Firmata.cpp \
+	$(ARDUINO_LIB_SRC)/Servo/Servo.cpp \
+	$(ARDUINO_SRC)/WMath.cpp
+HEADERS = $(wildcard $(ARDUINO_SRC)/*.h) $(wildcard $(ARDUINO_LIB_SRC)/*/*.h)
+
+MCU = atmega168
+#MCU = atmega8
+F_CPU = 16000000
+FORMAT = ihex
+UPLOAD_RATE = 19200
+
+# Name of this Makefile (used for "make depend").
+MAKEFILE = Makefile
+
+# Debugging format.
+# Native formats for AVR-GCC's -g are stabs [default], or dwarf-2.
+# AVR (extended) COFF requires stabs, plus an avr-objcopy run.
+DEBUG = stabs
+
+OPT = s
+
+# Place -D or -U options here
+CDEFS = -DF_CPU=$(F_CPU)
+CXXDEFS = -DF_CPU=$(F_CPU)
+
+# Compiler flag to set the C Standard level.
+# c89   - "ANSI" C
+# gnu89 - c89 plus GCC extensions
+# c99   - ISO C99 standard (not yet fully implemented)
+# gnu99 - c99 plus GCC extensions
+CSTANDARD = -std=gnu99
+CDEBUG = -g$(DEBUG)
+CWARN = -Wall -Wstrict-prototypes
+CTUNING = -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
+#CEXTRA = -Wa,-adhlns=$(<:.c=.lst)
+
+CFLAGS = $(CDEBUG) $(CDEFS) $(INCLUDE) -O$(OPT) $(CWARN) $(CSTANDARD) $(CEXTRA)
+CXXFLAGS = $(CDEFS) $(INCLUDE) -O$(OPT)
+#ASFLAGS = -Wa,-adhlns=$(<:.S=.lst),-gstabs 
+LDFLAGS = 
+
+
+# Programming support using avrdude. Settings and variables.
+AVRDUDE_PROGRAMMER = stk500
+AVRDUDE_PORT = $(PORT)
+AVRDUDE_WRITE_FLASH = -U flash:w:applet/$(TARGET).hex
+AVRDUDE_FLAGS = -F -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER) \
+  -b $(UPLOAD_RATE) -q -V
+
+# Program settings
+CC = avr-gcc
+CXX = avr-g++
+OBJCOPY = avr-objcopy
+OBJDUMP = avr-objdump
+SIZE = avr-size
+NM = avr-nm
+AVRDUDE = avrdude
+REMOVE = rm -f
+MV = mv -f
+
+# Define all object files.
+OBJ = $(SRC:.c=.o) $(CXXSRC:.cpp=.o) $(ASRC:.S=.o)
+
+# Define all listing files.
+LST = $(ASRC:.S=.lst) $(CXXSRC:.cpp=.lst) $(SRC:.c=.lst)
+
+# Combine all necessary flags and optional flags.
+# Add target processor to flags.
+ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS)
+ALL_CXXFLAGS = -mmcu=$(MCU) -I. $(CXXFLAGS)
+ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
+
+
+# Default target.
+all: build
+
+build: applet/$(TARGET).hex
+
+eep: applet/$(TARGET).eep
+lss: applet/$(TARGET).lss 
+sym: applet/$(TARGET).sym
+
+
+# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
+COFFCONVERT=$(OBJCOPY) --debugging \
+--change-section-address .data-0x800000 \
+--change-section-address .bss-0x800000 \
+--change-section-address .noinit-0x800000 \
+--change-section-address .eeprom-0x810000 
+
+
+coff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+extcoff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-ext-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+.SUFFIXES: .elf .hex .eep .lss .sym .pde
+
+.elf.hex:
+	$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@
+
+.elf.eep:
+	-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
+	--change-section-lma .eeprom=0 -O $(FORMAT) $< $@
+
+# Create extended listing file from ELF output file.
+.elf.lss:
+	$(OBJDUMP) -h -S $< > $@
+
+# Create a symbol table from ELF output file.
+.elf.sym:
+	$(NM) -n $< > $@
+
+
+# Compile: create object files from C++ source files.
+.cpp.o: $(HEADERS)
+	$(CXX) -c $(ALL_CXXFLAGS) $< -o $@ 
+
+# Compile: create object files from C source files.
+.c.o: $(HEADERS)
+	$(CC)  -c $(ALL_CFLAGS) $< -o $@ 
+
+
+# Compile: create assembler files from C source files.
+.c.s:
+	$(CC) -S $(ALL_CFLAGS) $< -o $@
+
+
+# Assemble: create object files from assembler source files.
+.S.o:
+	$(CC) -c $(ALL_ASFLAGS) $< -o $@
+
+
+
+applet/$(TARGET).cpp: $(TARGET).pde
+	test -d applet || mkdir applet
+	echo '#include "WProgram.h"' > applet/$(TARGET).cpp
+	echo '#include "avr/interrupt.h"' >> applet/$(TARGET).cpp
+	sed -n 's|^\(void .*)\).*|\1;|p' $(TARGET).pde | grep -v 'setup()' | \
+		grep -v 'loop()' >> applet/$(TARGET).cpp
+	cat $(TARGET).pde >> applet/$(TARGET).cpp
+	cat $(ARDUINO_SRC)/main.cxx >> applet/$(TARGET).cpp
+
+# Link: create ELF output file from object files.
+applet/$(TARGET).elf: applet/$(TARGET).cpp $(OBJ)
+	$(CC) $(ALL_CFLAGS) $(OBJ) --output $@ $(LDFLAGS)
+
+pd_close_serial:
+	echo 'close;' | /Applications/Pd-extended.app/Contents/Resources/bin/pdsend 34567 || true
+
+# Program the device.  
+upload: applet/$(TARGET).hex
+	$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH)
+
+
+pd_test: build pd_close_serial upload
+
+# Target: clean project.
+clean:
+	$(REMOVE) -- applet/$(TARGET).hex applet/$(TARGET).eep \
+	applet/$(TARGET).cof applet/$(TARGET).elf $(TARGET).map \
+	applet/$(TARGET).sym applet/$(TARGET).lss applet/$(TARGET).cpp \
+	$(OBJ) $(LST) $(SRC:.c=.s) $(SRC:.c=.d) $(CXXSRC:.cpp=.s) $(CXXSRC:.cpp=.d)
+	rmdir -- applet
+
+depend:
+	if grep '^# DO NOT DELETE' $(MAKEFILE) >/dev/null; \
+	then \
+		sed -e '/^# DO NOT DELETE/,$$d' $(MAKEFILE) > \
+			$(MAKEFILE).$$$$ && \
+		$(MV) $(MAKEFILE).$$$$ $(MAKEFILE); \
+	fi
+	echo '# DO NOT DELETE THIS LINE -- make depend depends on it.' \
+		>> $(MAKEFILE); \
+	$(CC) -M -mmcu=$(MCU) $(CDEFS) $(INCLUDE) $(SRC) $(ASRC) >> $(MAKEFILE)
+
+.PHONY:	all build eep lss sym coff extcoff clean depend pd_close_serial pd_test
+
+# for emacs
+etags:
+	make etags_`uname -s`
+	etags *.pde \
+		$(ARDUINO_SRC)/*.[ch] \
+		$(ARDUINO_SRC)/*.cpp \
+		$(ARDUINO_LIB_SRC)/*/*.[ch] \
+		$(ARDUINO_LIB_SRC)/*/*.cpp \
+		$(ARDUINO)/hardware/tools/avr/avr/include/avr/*.[ch] \
+		$(ARDUINO)/hardware/tools/avr/avr/include/*.[ch]
+
+etags_Darwin:
+#	etags -a 
+
+etags_Linux:
+#	etags -a /usr/include/*.h linux/input.h /usr/include/sys/*.h
+
+etags_MINGW:
+#	etags -a /usr/include/*.h /usr/include/sys/*.h 
+
+
+
diff --git a/libraries/Firmata/examples/ServoFirmata/ServoFirmata.pde b/libraries/Firmata/examples/ServoFirmata/ServoFirmata.pde
new file mode 100644
index 0000000..6f78ccd
--- /dev/null
+++ b/libraries/Firmata/examples/ServoFirmata/ServoFirmata.pde
@@ -0,0 +1,42 @@
+/* This firmware supports as many servos as possible using the Servo library 
+ * included in Arduino 0017
+ *
+ * TODO add message to configure minPulse/maxPulse/degrees
+ *
+ * This example code is in the public domain.
+ */
+ 
+#include <Servo.h>
+#include <Firmata.h>
+
+Servo servos[MAX_SERVOS];
+
+void analogWriteCallback(byte pin, int value)
+{
+    if (IS_PIN_SERVO(pin)) {
+        servos[PIN_TO_SERVO(pin)].write(value);
+    }
+}
+
+void setup() 
+{
+    byte pin;
+
+    Firmata.setFirmwareVersion(0, 2);
+    Firmata.attach(ANALOG_MESSAGE, analogWriteCallback);
+
+    for (pin=0; pin < TOTAL_PINS; pin++) {
+        if (IS_PIN_SERVO(pin)) {
+	    servos[PIN_TO_SERVO(pin)].attach(PIN_TO_DIGITAL(pin));
+        }
+    }
+   
+    Firmata.begin(57600);
+}
+
+void loop() 
+{
+    while(Firmata.available())
+        Firmata.processInput();
+}
+
diff --git a/libraries/Firmata/examples/SimpleAnalogFirmata/Makefile b/libraries/Firmata/examples/SimpleAnalogFirmata/Makefile
new file mode 100644
index 0000000..e968c0a
--- /dev/null
+++ b/libraries/Firmata/examples/SimpleAnalogFirmata/Makefile
@@ -0,0 +1,263 @@
+# Arduino makefile
+#
+# This makefile allows you to build sketches from the command line
+# without the Arduino environment (or Java).
+#
+# The Arduino environment does preliminary processing on a sketch before
+# compiling it.  If you're using this makefile instead, you'll need to do
+# a few things differently:
+#
+#   - Give your program's file a .cpp extension (e.g. foo.cpp).
+#
+#   - Put this line at top of your code: #include <WProgram.h>
+#
+#   - Write prototypes for all your functions (or define them before you
+#     call them).  A prototype declares the types of parameters a
+#     function will take and what type of value it will return.  This
+#     means that you can have a call to a function before the definition
+#     of the function.  A function prototype looks like the first line of
+#     the function, with a semi-colon at the end.  For example:
+#     int digitalRead(int pin);
+#
+# Instructions for using the makefile:
+#
+#  1. Copy this file into the folder with your sketch.
+#
+#  2. Below, modify the line containing "TARGET" to refer to the name of
+#     of your program's file without an extension (e.g. TARGET = foo).
+#
+#  3. Modify the line containg "ARDUINO" to point the directory that
+#     contains the Arduino core (for normal Arduino installations, this
+#     is the hardware/cores/arduino sub-directory).
+#
+#  4. Modify the line containing "PORT" to refer to the filename
+#     representing the USB or serial connection to your Arduino board
+#     (e.g. PORT = /dev/tty.USB0).  If the exact name of this file
+#     changes, you can use * as a wildcard (e.g. PORT = /dev/tty.USB*).
+#
+#  5. At the command line, change to the directory containing your
+#     program's file and the makefile.
+#
+#  6. Type "make" and press enter to compile/verify your program.
+#
+#  7. Type "make upload", reset your Arduino board, and press enter  to
+#     upload your program to the Arduino board.
+#
+# $Id: Makefile,v 1.7 2007/04/13 05:28:23 eighthave Exp $
+
+PORT = /dev/tty.usbserial-*
+TARGET := $(shell pwd | sed 's|.*/\(.*\)|\1|')
+ARDUINO = /Applications/arduino
+ARDUINO_SRC = $(ARDUINO)/hardware/cores/arduino
+ARDUINO_LIB_SRC = $(ARDUINO)/hardware/libraries
+INCLUDE = -I$(ARDUINO_SRC) -I$(ARDUINO)/hardware/tools/avr/avr/include \
+	-I$(ARDUINO_LIB_SRC)/EEPROM \
+	-I$(ARDUINO_LIB_SRC)/Firmata \
+	-I$(ARDUINO_LIB_SRC)/Servo \
+	-I$(ARDUINO_LIB_SRC)
+SRC = $(wildcard $(ARDUINO_SRC)/*.c)
+CXXSRC = applet/$(TARGET).cpp $(ARDUINO_SRC)/HardwareSerial.cpp \
+	$(ARDUINO_LIB_SRC)/EEPROM/EEPROM.cpp \
+	$(ARDUINO_LIB_SRC)/Firmata/Firmata.cpp \
+	$(ARDUINO_LIB_SRC)/Servo/Servo.cpp \
+	$(ARDUINO_SRC)/WMath.cpp
+HEADERS = $(wildcard $(ARDUINO_SRC)/*.h) $(wildcard $(ARDUINO_LIB_SRC)/*/*.h)
+
+MCU = atmega168
+#MCU = atmega8
+F_CPU = 16000000
+FORMAT = ihex
+UPLOAD_RATE = 19200
+
+# Name of this Makefile (used for "make depend").
+MAKEFILE = Makefile
+
+# Debugging format.
+# Native formats for AVR-GCC's -g are stabs [default], or dwarf-2.
+# AVR (extended) COFF requires stabs, plus an avr-objcopy run.
+DEBUG = stabs
+
+OPT = s
+
+# Place -D or -U options here
+CDEFS = -DF_CPU=$(F_CPU)
+CXXDEFS = -DF_CPU=$(F_CPU)
+
+# Compiler flag to set the C Standard level.
+# c89   - "ANSI" C
+# gnu89 - c89 plus GCC extensions
+# c99   - ISO C99 standard (not yet fully implemented)
+# gnu99 - c99 plus GCC extensions
+CSTANDARD = -std=gnu99
+CDEBUG = -g$(DEBUG)
+CWARN = -Wall -Wstrict-prototypes
+CTUNING = -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
+#CEXTRA = -Wa,-adhlns=$(<:.c=.lst)
+
+CFLAGS = $(CDEBUG) $(CDEFS) $(INCLUDE) -O$(OPT) $(CWARN) $(CSTANDARD) $(CEXTRA)
+CXXFLAGS = $(CDEFS) $(INCLUDE) -O$(OPT)
+#ASFLAGS = -Wa,-adhlns=$(<:.S=.lst),-gstabs 
+LDFLAGS = 
+
+
+# Programming support using avrdude. Settings and variables.
+AVRDUDE_PROGRAMMER = stk500
+AVRDUDE_PORT = $(PORT)
+AVRDUDE_WRITE_FLASH = -U flash:w:applet/$(TARGET).hex
+AVRDUDE_FLAGS = -F -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER) \
+  -b $(UPLOAD_RATE) -q -V
+
+# Program settings
+CC = avr-gcc
+CXX = avr-g++
+OBJCOPY = avr-objcopy
+OBJDUMP = avr-objdump
+SIZE = avr-size
+NM = avr-nm
+AVRDUDE = avrdude
+REMOVE = rm -f
+MV = mv -f
+
+# Define all object files.
+OBJ = $(SRC:.c=.o) $(CXXSRC:.cpp=.o) $(ASRC:.S=.o)
+
+# Define all listing files.
+LST = $(ASRC:.S=.lst) $(CXXSRC:.cpp=.lst) $(SRC:.c=.lst)
+
+# Combine all necessary flags and optional flags.
+# Add target processor to flags.
+ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS)
+ALL_CXXFLAGS = -mmcu=$(MCU) -I. $(CXXFLAGS)
+ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
+
+
+# Default target.
+all: build
+
+build: applet/$(TARGET).hex
+
+eep: applet/$(TARGET).eep
+lss: applet/$(TARGET).lss 
+sym: applet/$(TARGET).sym
+
+
+# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
+COFFCONVERT=$(OBJCOPY) --debugging \
+--change-section-address .data-0x800000 \
+--change-section-address .bss-0x800000 \
+--change-section-address .noinit-0x800000 \
+--change-section-address .eeprom-0x810000 
+
+
+coff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+extcoff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-ext-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+.SUFFIXES: .elf .hex .eep .lss .sym .pde
+
+.elf.hex:
+	$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@
+
+.elf.eep:
+	-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
+	--change-section-lma .eeprom=0 -O $(FORMAT) $< $@
+
+# Create extended listing file from ELF output file.
+.elf.lss:
+	$(OBJDUMP) -h -S $< > $@
+
+# Create a symbol table from ELF output file.
+.elf.sym:
+	$(NM) -n $< > $@
+
+
+# Compile: create object files from C++ source files.
+.cpp.o: $(HEADERS)
+	$(CXX) -c $(ALL_CXXFLAGS) $< -o $@ 
+
+# Compile: create object files from C source files.
+.c.o: $(HEADERS)
+	$(CC)  -c $(ALL_CFLAGS) $< -o $@ 
+
+
+# Compile: create assembler files from C source files.
+.c.s:
+	$(CC) -S $(ALL_CFLAGS) $< -o $@
+
+
+# Assemble: create object files from assembler source files.
+.S.o:
+	$(CC) -c $(ALL_ASFLAGS) $< -o $@
+
+
+
+applet/$(TARGET).cpp: $(TARGET).pde
+	test -d applet || mkdir applet
+	echo '#include "WProgram.h"' > applet/$(TARGET).cpp
+	echo '#include "avr/interrupt.h"' >> applet/$(TARGET).cpp
+	sed -n 's|^\(void .*)\).*|\1;|p' $(TARGET).pde | grep -v 'setup()' | \
+		grep -v 'loop()' >> applet/$(TARGET).cpp
+	cat $(TARGET).pde >> applet/$(TARGET).cpp
+	cat $(ARDUINO_SRC)/main.cxx >> applet/$(TARGET).cpp
+
+# Link: create ELF output file from object files.
+applet/$(TARGET).elf: applet/$(TARGET).cpp $(OBJ)
+	$(CC) $(ALL_CFLAGS) $(OBJ) --output $@ $(LDFLAGS)
+
+pd_close_serial:
+	echo 'close;' | /Applications/Pd-extended.app/Contents/Resources/bin/pdsend 34567 || true
+
+# Program the device.  
+upload: applet/$(TARGET).hex
+	$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH)
+
+
+pd_test: build pd_close_serial upload
+
+# Target: clean project.
+clean:
+	$(REMOVE) -- applet/$(TARGET).hex applet/$(TARGET).eep \
+	applet/$(TARGET).cof applet/$(TARGET).elf $(TARGET).map \
+	applet/$(TARGET).sym applet/$(TARGET).lss applet/$(TARGET).cpp \
+	$(OBJ) $(LST) $(SRC:.c=.s) $(SRC:.c=.d) $(CXXSRC:.cpp=.s) $(CXXSRC:.cpp=.d)
+	rmdir -- applet
+
+depend:
+	if grep '^# DO NOT DELETE' $(MAKEFILE) >/dev/null; \
+	then \
+		sed -e '/^# DO NOT DELETE/,$$d' $(MAKEFILE) > \
+			$(MAKEFILE).$$$$ && \
+		$(MV) $(MAKEFILE).$$$$ $(MAKEFILE); \
+	fi
+	echo '# DO NOT DELETE THIS LINE -- make depend depends on it.' \
+		>> $(MAKEFILE); \
+	$(CC) -M -mmcu=$(MCU) $(CDEFS) $(INCLUDE) $(SRC) $(ASRC) >> $(MAKEFILE)
+
+.PHONY:	all build eep lss sym coff extcoff clean depend pd_close_serial pd_test
+
+# for emacs
+etags:
+	make etags_`uname -s`
+	etags *.pde \
+		$(ARDUINO_SRC)/*.[ch] \
+		$(ARDUINO_SRC)/*.cpp \
+		$(ARDUINO_LIB_SRC)/*/*.[ch] \
+		$(ARDUINO_LIB_SRC)/*/*.cpp \
+		$(ARDUINO)/hardware/tools/avr/avr/include/avr/*.[ch] \
+		$(ARDUINO)/hardware/tools/avr/avr/include/*.[ch]
+
+etags_Darwin:
+#	etags -a 
+
+etags_Linux:
+#	etags -a /usr/include/*.h linux/input.h /usr/include/sys/*.h
+
+etags_MINGW:
+#	etags -a /usr/include/*.h /usr/include/sys/*.h 
+
+
+
diff --git a/libraries/Firmata/examples/SimpleAnalogFirmata/SimpleAnalogFirmata.pde b/libraries/Firmata/examples/SimpleAnalogFirmata/SimpleAnalogFirmata.pde
new file mode 100644
index 0000000..b505b33
--- /dev/null
+++ b/libraries/Firmata/examples/SimpleAnalogFirmata/SimpleAnalogFirmata.pde
@@ -0,0 +1,35 @@
+/* Supports as many analog inputs and analog PWM outputs as possible.
+ *
+ * This example code is in the public domain.
+ */
+#include <Firmata.h>
+
+byte analogPin = 0;
+
+void analogWriteCallback(byte pin, int value)
+{
+    if (IS_PIN_PWM(pin)) {
+        pinMode(PIN_TO_DIGITAL(pin), OUTPUT);
+        analogWrite(PIN_TO_PWM(pin), value);
+    }
+}
+
+void setup()
+{
+    Firmata.setFirmwareVersion(0, 1);
+    Firmata.attach(ANALOG_MESSAGE, analogWriteCallback);
+    Firmata.begin(57600);
+}
+
+void loop()
+{
+    while(Firmata.available()) {
+        Firmata.processInput();
+    }
+    // do one analogRead per loop, so if PC is sending a lot of
+    // analog write messages, we will only delay 1 analogRead
+    Firmata.sendAnalog(analogPin, analogRead(analogPin)); 
+    analogPin = analogPin + 1;
+    if (analogPin >= TOTAL_ANALOG_PINS) analogPin = 0;
+}
+
diff --git a/libraries/Firmata/examples/SimpleDigitalFirmata/Makefile b/libraries/Firmata/examples/SimpleDigitalFirmata/Makefile
new file mode 100644
index 0000000..e968c0a
--- /dev/null
+++ b/libraries/Firmata/examples/SimpleDigitalFirmata/Makefile
@@ -0,0 +1,263 @@
+# Arduino makefile
+#
+# This makefile allows you to build sketches from the command line
+# without the Arduino environment (or Java).
+#
+# The Arduino environment does preliminary processing on a sketch before
+# compiling it.  If you're using this makefile instead, you'll need to do
+# a few things differently:
+#
+#   - Give your program's file a .cpp extension (e.g. foo.cpp).
+#
+#   - Put this line at top of your code: #include <WProgram.h>
+#
+#   - Write prototypes for all your functions (or define them before you
+#     call them).  A prototype declares the types of parameters a
+#     function will take and what type of value it will return.  This
+#     means that you can have a call to a function before the definition
+#     of the function.  A function prototype looks like the first line of
+#     the function, with a semi-colon at the end.  For example:
+#     int digitalRead(int pin);
+#
+# Instructions for using the makefile:
+#
+#  1. Copy this file into the folder with your sketch.
+#
+#  2. Below, modify the line containing "TARGET" to refer to the name of
+#     of your program's file without an extension (e.g. TARGET = foo).
+#
+#  3. Modify the line containg "ARDUINO" to point the directory that
+#     contains the Arduino core (for normal Arduino installations, this
+#     is the hardware/cores/arduino sub-directory).
+#
+#  4. Modify the line containing "PORT" to refer to the filename
+#     representing the USB or serial connection to your Arduino board
+#     (e.g. PORT = /dev/tty.USB0).  If the exact name of this file
+#     changes, you can use * as a wildcard (e.g. PORT = /dev/tty.USB*).
+#
+#  5. At the command line, change to the directory containing your
+#     program's file and the makefile.
+#
+#  6. Type "make" and press enter to compile/verify your program.
+#
+#  7. Type "make upload", reset your Arduino board, and press enter  to
+#     upload your program to the Arduino board.
+#
+# $Id: Makefile,v 1.7 2007/04/13 05:28:23 eighthave Exp $
+
+PORT = /dev/tty.usbserial-*
+TARGET := $(shell pwd | sed 's|.*/\(.*\)|\1|')
+ARDUINO = /Applications/arduino
+ARDUINO_SRC = $(ARDUINO)/hardware/cores/arduino
+ARDUINO_LIB_SRC = $(ARDUINO)/hardware/libraries
+INCLUDE = -I$(ARDUINO_SRC) -I$(ARDUINO)/hardware/tools/avr/avr/include \
+	-I$(ARDUINO_LIB_SRC)/EEPROM \
+	-I$(ARDUINO_LIB_SRC)/Firmata \
+	-I$(ARDUINO_LIB_SRC)/Servo \
+	-I$(ARDUINO_LIB_SRC)
+SRC = $(wildcard $(ARDUINO_SRC)/*.c)
+CXXSRC = applet/$(TARGET).cpp $(ARDUINO_SRC)/HardwareSerial.cpp \
+	$(ARDUINO_LIB_SRC)/EEPROM/EEPROM.cpp \
+	$(ARDUINO_LIB_SRC)/Firmata/Firmata.cpp \
+	$(ARDUINO_LIB_SRC)/Servo/Servo.cpp \
+	$(ARDUINO_SRC)/WMath.cpp
+HEADERS = $(wildcard $(ARDUINO_SRC)/*.h) $(wildcard $(ARDUINO_LIB_SRC)/*/*.h)
+
+MCU = atmega168
+#MCU = atmega8
+F_CPU = 16000000
+FORMAT = ihex
+UPLOAD_RATE = 19200
+
+# Name of this Makefile (used for "make depend").
+MAKEFILE = Makefile
+
+# Debugging format.
+# Native formats for AVR-GCC's -g are stabs [default], or dwarf-2.
+# AVR (extended) COFF requires stabs, plus an avr-objcopy run.
+DEBUG = stabs
+
+OPT = s
+
+# Place -D or -U options here
+CDEFS = -DF_CPU=$(F_CPU)
+CXXDEFS = -DF_CPU=$(F_CPU)
+
+# Compiler flag to set the C Standard level.
+# c89   - "ANSI" C
+# gnu89 - c89 plus GCC extensions
+# c99   - ISO C99 standard (not yet fully implemented)
+# gnu99 - c99 plus GCC extensions
+CSTANDARD = -std=gnu99
+CDEBUG = -g$(DEBUG)
+CWARN = -Wall -Wstrict-prototypes
+CTUNING = -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
+#CEXTRA = -Wa,-adhlns=$(<:.c=.lst)
+
+CFLAGS = $(CDEBUG) $(CDEFS) $(INCLUDE) -O$(OPT) $(CWARN) $(CSTANDARD) $(CEXTRA)
+CXXFLAGS = $(CDEFS) $(INCLUDE) -O$(OPT)
+#ASFLAGS = -Wa,-adhlns=$(<:.S=.lst),-gstabs 
+LDFLAGS = 
+
+
+# Programming support using avrdude. Settings and variables.
+AVRDUDE_PROGRAMMER = stk500
+AVRDUDE_PORT = $(PORT)
+AVRDUDE_WRITE_FLASH = -U flash:w:applet/$(TARGET).hex
+AVRDUDE_FLAGS = -F -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER) \
+  -b $(UPLOAD_RATE) -q -V
+
+# Program settings
+CC = avr-gcc
+CXX = avr-g++
+OBJCOPY = avr-objcopy
+OBJDUMP = avr-objdump
+SIZE = avr-size
+NM = avr-nm
+AVRDUDE = avrdude
+REMOVE = rm -f
+MV = mv -f
+
+# Define all object files.
+OBJ = $(SRC:.c=.o) $(CXXSRC:.cpp=.o) $(ASRC:.S=.o)
+
+# Define all listing files.
+LST = $(ASRC:.S=.lst) $(CXXSRC:.cpp=.lst) $(SRC:.c=.lst)
+
+# Combine all necessary flags and optional flags.
+# Add target processor to flags.
+ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS)
+ALL_CXXFLAGS = -mmcu=$(MCU) -I. $(CXXFLAGS)
+ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
+
+
+# Default target.
+all: build
+
+build: applet/$(TARGET).hex
+
+eep: applet/$(TARGET).eep
+lss: applet/$(TARGET).lss 
+sym: applet/$(TARGET).sym
+
+
+# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
+COFFCONVERT=$(OBJCOPY) --debugging \
+--change-section-address .data-0x800000 \
+--change-section-address .bss-0x800000 \
+--change-section-address .noinit-0x800000 \
+--change-section-address .eeprom-0x810000 
+
+
+coff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+extcoff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-ext-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+.SUFFIXES: .elf .hex .eep .lss .sym .pde
+
+.elf.hex:
+	$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@
+
+.elf.eep:
+	-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
+	--change-section-lma .eeprom=0 -O $(FORMAT) $< $@
+
+# Create extended listing file from ELF output file.
+.elf.lss:
+	$(OBJDUMP) -h -S $< > $@
+
+# Create a symbol table from ELF output file.
+.elf.sym:
+	$(NM) -n $< > $@
+
+
+# Compile: create object files from C++ source files.
+.cpp.o: $(HEADERS)
+	$(CXX) -c $(ALL_CXXFLAGS) $< -o $@ 
+
+# Compile: create object files from C source files.
+.c.o: $(HEADERS)
+	$(CC)  -c $(ALL_CFLAGS) $< -o $@ 
+
+
+# Compile: create assembler files from C source files.
+.c.s:
+	$(CC) -S $(ALL_CFLAGS) $< -o $@
+
+
+# Assemble: create object files from assembler source files.
+.S.o:
+	$(CC) -c $(ALL_ASFLAGS) $< -o $@
+
+
+
+applet/$(TARGET).cpp: $(TARGET).pde
+	test -d applet || mkdir applet
+	echo '#include "WProgram.h"' > applet/$(TARGET).cpp
+	echo '#include "avr/interrupt.h"' >> applet/$(TARGET).cpp
+	sed -n 's|^\(void .*)\).*|\1;|p' $(TARGET).pde | grep -v 'setup()' | \
+		grep -v 'loop()' >> applet/$(TARGET).cpp
+	cat $(TARGET).pde >> applet/$(TARGET).cpp
+	cat $(ARDUINO_SRC)/main.cxx >> applet/$(TARGET).cpp
+
+# Link: create ELF output file from object files.
+applet/$(TARGET).elf: applet/$(TARGET).cpp $(OBJ)
+	$(CC) $(ALL_CFLAGS) $(OBJ) --output $@ $(LDFLAGS)
+
+pd_close_serial:
+	echo 'close;' | /Applications/Pd-extended.app/Contents/Resources/bin/pdsend 34567 || true
+
+# Program the device.  
+upload: applet/$(TARGET).hex
+	$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH)
+
+
+pd_test: build pd_close_serial upload
+
+# Target: clean project.
+clean:
+	$(REMOVE) -- applet/$(TARGET).hex applet/$(TARGET).eep \
+	applet/$(TARGET).cof applet/$(TARGET).elf $(TARGET).map \
+	applet/$(TARGET).sym applet/$(TARGET).lss applet/$(TARGET).cpp \
+	$(OBJ) $(LST) $(SRC:.c=.s) $(SRC:.c=.d) $(CXXSRC:.cpp=.s) $(CXXSRC:.cpp=.d)
+	rmdir -- applet
+
+depend:
+	if grep '^# DO NOT DELETE' $(MAKEFILE) >/dev/null; \
+	then \
+		sed -e '/^# DO NOT DELETE/,$$d' $(MAKEFILE) > \
+			$(MAKEFILE).$$$$ && \
+		$(MV) $(MAKEFILE).$$$$ $(MAKEFILE); \
+	fi
+	echo '# DO NOT DELETE THIS LINE -- make depend depends on it.' \
+		>> $(MAKEFILE); \
+	$(CC) -M -mmcu=$(MCU) $(CDEFS) $(INCLUDE) $(SRC) $(ASRC) >> $(MAKEFILE)
+
+.PHONY:	all build eep lss sym coff extcoff clean depend pd_close_serial pd_test
+
+# for emacs
+etags:
+	make etags_`uname -s`
+	etags *.pde \
+		$(ARDUINO_SRC)/*.[ch] \
+		$(ARDUINO_SRC)/*.cpp \
+		$(ARDUINO_LIB_SRC)/*/*.[ch] \
+		$(ARDUINO_LIB_SRC)/*/*.cpp \
+		$(ARDUINO)/hardware/tools/avr/avr/include/avr/*.[ch] \
+		$(ARDUINO)/hardware/tools/avr/avr/include/*.[ch]
+
+etags_Darwin:
+#	etags -a 
+
+etags_Linux:
+#	etags -a /usr/include/*.h linux/input.h /usr/include/sys/*.h
+
+etags_MINGW:
+#	etags -a /usr/include/*.h /usr/include/sys/*.h 
+
+
+
diff --git a/libraries/Firmata/examples/SimpleDigitalFirmata/SimpleDigitalFirmata.pde b/libraries/Firmata/examples/SimpleDigitalFirmata/SimpleDigitalFirmata.pde
new file mode 100644
index 0000000..64b566e
--- /dev/null
+++ b/libraries/Firmata/examples/SimpleDigitalFirmata/SimpleDigitalFirmata.pde
@@ -0,0 +1,61 @@
+/* Supports as many digital inputs and outputs as possible.
+ *
+ * This example code is in the public domain.
+ */
+#include <Firmata.h>
+
+byte previousPIN[TOTAL_PORTS];  // PIN means PORT for input
+byte previousPORT[TOTAL_PORTS]; 
+
+void outputPort(byte portNumber, byte portValue)
+{
+    // only send the data when it changes, otherwise you get too many messages!
+    if (previousPIN[portNumber] != portValue) {
+        Firmata.sendDigitalPort(portNumber, portValue); 
+        previousPIN[portNumber] = portValue;
+    }
+}
+
+void setPinModeCallback(byte pin, int mode) {
+    if (IS_PIN_DIGITAL(pin)) {
+        pinMode(PIN_TO_DIGITAL(pin), mode);
+    }
+}
+
+void digitalWriteCallback(byte port, int value)
+{
+    byte i;
+    byte currentPinValue, previousPinValue;
+
+    if (port < TOTAL_PORTS && value != previousPORT[port]) {
+        for(i=0; i<8; i++) {
+            currentPinValue = (byte) value & (1 << i);
+            previousPinValue = previousPORT[port] & (1 << i);
+            if(currentPinValue != previousPinValue) {
+                digitalWrite(i + (port*8), currentPinValue);
+            }
+        }
+        previousPORT[port] = value;
+    }
+}
+
+void setup()
+{
+    Firmata.setFirmwareVersion(0, 1);
+    Firmata.attach(DIGITAL_MESSAGE, digitalWriteCallback);
+    Firmata.attach(SET_PIN_MODE, setPinModeCallback);
+    Firmata.begin(57600);
+}
+
+void loop()
+{
+    byte i;
+
+    for (i=0; i<TOTAL_PORTS; i++) {
+        outputPort(i, readPort(i));
+    }
+
+    while(Firmata.available()) {
+        Firmata.processInput();
+    }
+}
diff --git a/libraries/Firmata/examples/StandardFirmata/LICENSE.txt b/libraries/Firmata/examples/StandardFirmata/LICENSE.txt
new file mode 100644
index 0000000..77cec6d
--- /dev/null
+++ b/libraries/Firmata/examples/StandardFirmata/LICENSE.txt
@@ -0,0 +1,458 @@
+
+		  GNU LESSER GENERAL PUBLIC LICENSE
+		       Version 2.1, February 1999
+
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+ 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL.  It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+			    Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+  This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it.  You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+  When we speak of free software, we are referring to freedom of use,
+not price.  Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+  To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights.  These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+  For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you.  You must make sure that they, too, receive or can get the source
+code.  If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it.  And you must show them these terms so they know their rights.
+
+  We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+  To protect each distributor, we want to make it very clear that
+there is no warranty for the free library.  Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+  Finally, software patents pose a constant threat to the existence of
+any free program.  We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder.  Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+  Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License.  This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License.  We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+  When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library.  The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom.  The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+  We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License.  It also provides other free software developers Less
+of an advantage over competing non-free programs.  These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries.  However, the Lesser license provides advantages in certain
+special circumstances.
+
+  For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard.  To achieve this, non-free programs must be
+allowed to use the library.  A more frequent case is that a free
+library does the same job as widely used non-free libraries.  In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+  In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software.  For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+  Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.  Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library".  The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+		  GNU LESSER GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+  A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+  The "Library", below, refers to any such software library or work
+which has been distributed under these terms.  A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language.  (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+  "Source code" for a work means the preferred form of the work for
+making modifications to it.  For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control compilation
+and installation of the library.
+
+  Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it).  Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+  
+  1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+
+  You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+
+  2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) The modified work must itself be a software library.
+
+    b) You must cause the files modified to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    c) You must cause the whole of the work to be licensed at no
+    charge to all third parties under the terms of this License.
+
+    d) If a facility in the modified Library refers to a function or a
+    table of data to be supplied by an application program that uses
+    the facility, other than as an argument passed when the facility
+    is invoked, then you must make a good faith effort to ensure that,
+    in the event an application does not supply such function or
+    table, the facility still operates, and performs whatever part of
+    its purpose remains meaningful.
+
+    (For example, a function in a library to compute square roots has
+    a purpose that is entirely well-defined independent of the
+    application.  Therefore, Subsection 2d requires that any
+    application-supplied function or table used by this function must
+    be optional: if the application does not supply it, the square
+    root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library.  To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License.  (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.)  Do not make any other change in
+these notices.
+
+  Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+  This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+  4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+  If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library".  Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+  However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library".  The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+  When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library.  The
+threshold for this to be true is not precisely defined by law.
+
+  If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work.  (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+  Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+
+  6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+  You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License.  You must supply a copy of this License.  If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License.  Also, you must do one
+of these things:
+
+    a) Accompany the work with the complete corresponding
+    machine-readable source code for the Library including whatever
+    changes were used in the work (which must be distributed under
+    Sections 1 and 2 above); and, if the work is an executable linked
+    with the Library, with the complete machine-readable "work that
+    uses the Library", as object code and/or source code, so that the
+    user can modify the Library and then relink to produce a modified
+    executable containing the modified Library.  (It is understood
+    that the user who changes the contents of definitions files in the
+    Library will not necessarily be able to recompile the application
+    to use the modified definitions.)
+
+    b) Use a suitable shared library mechanism for linking with the
+    Library.  A suitable mechanism is one that (1) uses at run time a
+    copy of the library already present on the user's computer system,
+    rather than copying library functions into the executable, and (2)
+    will operate properly with a modified version of the library, if
+    the user installs one, as long as the modified version is
+    interface-compatible with the version that the work was made with.
+
+    c) Accompany the work with a written offer, valid for at
+    least three years, to give the same user the materials
+    specified in Subsection 6a, above, for a charge no more
+    than the cost of performing this distribution.
+
+    d) If distribution of the work is made by offering access to copy
+    from a designated place, offer equivalent access to copy the above
+    specified materials from the same place.
+
+    e) Verify that the user has already received a copy of these
+    materials or that you have already sent this user a copy.
+
+  For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it.  However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+  It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system.  Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+
+  7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+    a) Accompany the combined library with a copy of the same work
+    based on the Library, uncombined with any other library
+    facilities.  This must be distributed under the terms of the
+    Sections above.
+
+    b) Give prominent notice with the combined library of the fact
+    that part of it is a work based on the Library, and explaining
+    where to find the accompanying uncombined form of the same work.
+
+  8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License.  Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License.  However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+  9. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Library or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+  10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+
+  11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply,
+and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License may add
+an explicit geographical distribution limitation excluding those countries,
+so that distribution is permitted only in or among countries not thus
+excluded.  In such case, this License incorporates the limitation as if
+written in the body of this License.
+
+  13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation.  If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+
+  14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission.  For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this.  Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+			    NO WARRANTY
+
+  15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
diff --git a/libraries/Firmata/examples/StandardFirmata/Makefile b/libraries/Firmata/examples/StandardFirmata/Makefile
new file mode 100644
index 0000000..835187a
--- /dev/null
+++ b/libraries/Firmata/examples/StandardFirmata/Makefile
@@ -0,0 +1,273 @@
+# Arduino makefile
+#
+# This makefile allows you to build sketches from the command line
+# without the Arduino environment (or Java).
+#
+# The Arduino environment does preliminary processing on a sketch before
+# compiling it.  If you're using this makefile instead, you'll need to do
+# a few things differently:
+#
+#   - Give your program's file a .cpp extension (e.g. foo.cpp).
+#
+#   - Put this line at top of your code: #include <WProgram.h>
+#
+#   - Write prototypes for all your functions (or define them before you
+#     call them).  A prototype declares the types of parameters a
+#     function will take and what type of value it will return.  This
+#     means that you can have a call to a function before the definition
+#     of the function.  A function prototype looks like the first line of
+#     the function, with a semi-colon at the end.  For example:
+#     int digitalRead(int pin);
+#
+# Instructions for using the makefile:
+#
+#  1. Copy this file into the folder with your sketch.
+#
+#  2. Below, modify the line containing "TARGET" to refer to the name of
+#     of your program's file without an extension (e.g. TARGET = foo).
+#
+#  3. Modify the line containg "ARDUINO" to point the directory that
+#     contains the Arduino core (for normal Arduino installations, this
+#     is the hardware/cores/arduino sub-directory).
+#
+#  4. Modify the line containing "PORT" to refer to the filename
+#     representing the USB or serial connection to your Arduino board
+#     (e.g. PORT = /dev/tty.USB0).  If the exact name of this file
+#     changes, you can use * as a wildcard (e.g. PORT = /dev/tty.USB*).
+#
+#  5. At the command line, change to the directory containing your
+#     program's file and the makefile.
+#
+#  6. Type "make" and press enter to compile/verify your program.
+#
+#  7. Type "make upload", reset your Arduino board, and press enter  to
+#     upload your program to the Arduino board.
+#
+# $Id: Makefile,v 1.7 2007/04/13 05:28:23 eighthave Exp $
+
+PORT = /dev/tty.usbserial-*
+TARGET := $(shell pwd | sed 's|.*/\(.*\)|\1|')
+ARDUINO = /Applications/arduino
+ARDUINO_SRC = $(ARDUINO)/hardware/cores/arduino
+ARDUINO_LIB_SRC = $(ARDUINO)/hardware/libraries
+ARDUINO_TOOLS = $(ARDUINO)/hardware/tools
+INCLUDE = -I$(ARDUINO_SRC) -I$(ARDUINO)/hardware/tools/avr/avr/include \
+	-I$(ARDUINO_LIB_SRC)/EEPROM \
+	-I$(ARDUINO_LIB_SRC)/Firmata \
+	-I$(ARDUINO_LIB_SRC)/Matrix \
+	-I$(ARDUINO_LIB_SRC)/Servo \
+	-I$(ARDUINO_LIB_SRC)/Wire \
+	-I$(ARDUINO_LIB_SRC)
+SRC = $(wildcard $(ARDUINO_SRC)/*.c)
+CXXSRC = applet/$(TARGET).cpp $(ARDUINO_SRC)/HardwareSerial.cpp \
+	$(ARDUINO_LIB_SRC)/EEPROM/EEPROM.cpp \
+	$(ARDUINO_LIB_SRC)/Firmata/Firmata.cpp \
+	$(ARDUINO_LIB_SRC)/Servo/Servo.cpp \
+	$(ARDUINO_SRC)/Print.cpp \
+	$(ARDUINO_SRC)/WMath.cpp
+HEADERS = $(wildcard $(ARDUINO_SRC)/*.h) $(wildcard $(ARDUINO_LIB_SRC)/*/*.h)
+
+MCU = atmega168
+#MCU = atmega8
+F_CPU = 16000000
+FORMAT = ihex
+UPLOAD_RATE = 19200
+
+# Name of this Makefile (used for "make depend").
+MAKEFILE = Makefile
+
+# Debugging format.
+# Native formats for AVR-GCC's -g are stabs [default], or dwarf-2.
+# AVR (extended) COFF requires stabs, plus an avr-objcopy run.
+DEBUG = stabs
+
+OPT = s
+
+# Place -D or -U options here
+CDEFS = -DF_CPU=$(F_CPU)
+CXXDEFS = -DF_CPU=$(F_CPU)
+
+# Compiler flag to set the C Standard level.
+# c89   - "ANSI" C
+# gnu89 - c89 plus GCC extensions
+# c99   - ISO C99 standard (not yet fully implemented)
+# gnu99 - c99 plus GCC extensions
+CSTANDARD = -std=gnu99
+CDEBUG = -g$(DEBUG)
+CWARN = -Wall -Wstrict-prototypes
+CTUNING = -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
+#CEXTRA = -Wa,-adhlns=$(<:.c=.lst)
+
+CFLAGS = $(CDEBUG) $(CDEFS) $(INCLUDE) -O$(OPT) $(CWARN) $(CSTANDARD) $(CEXTRA)
+CXXFLAGS = $(CDEFS) $(INCLUDE) -O$(OPT)
+#ASFLAGS = -Wa,-adhlns=$(<:.S=.lst),-gstabs 
+LDFLAGS = 
+
+
+# Programming support using avrdude. Settings and variables.
+AVRDUDE_PROGRAMMER = stk500
+AVRDUDE_PORT = $(PORT)
+AVRDUDE_WRITE_FLASH = -U flash:w:applet/$(TARGET).hex
+AVRDUDE_FLAGS = -F -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER) \
+  -b $(UPLOAD_RATE) -q -V
+
+# Program settings
+ARDUINO_AVR_BIN = $(ARDUINO_TOOLS)/avr/bin
+CC = $(ARDUINO_AVR_BIN)/avr-gcc 
+CXX = $(ARDUINO_AVR_BIN)/avr-g++
+OBJCOPY = $(ARDUINO_AVR_BIN)/avr-objcopy
+OBJDUMP = $(ARDUINO_AVR_BIN)/avr-objdump
+SIZE = $(ARDUINO_AVR_BIN)/avr-size
+NM = $(ARDUINO_AVR_BIN)/avr-nm
+#AVRDUDE = $(ARDUINO_AVR_BIN)/avrdude
+AVRDUDE = avrdude
+REMOVE = rm -f
+MV = mv -f
+
+# Define all object files.
+OBJ = $(SRC:.c=.o) $(CXXSRC:.cpp=.o) $(ASRC:.S=.o)
+
+# Define all listing files.
+LST = $(ASRC:.S=.lst) $(CXXSRC:.cpp=.lst) $(SRC:.c=.lst)
+
+# Combine all necessary flags and optional flags.
+# Add target processor to flags.
+ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS)
+ALL_CXXFLAGS = -mmcu=$(MCU) -I. $(CXXFLAGS)
+ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
+
+
+# Default target.
+all: build
+
+build: applet/$(TARGET).hex
+
+eep: applet/$(TARGET).eep
+lss: applet/$(TARGET).lss 
+sym: applet/$(TARGET).sym
+
+
+# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
+COFFCONVERT=$(OBJCOPY) --debugging \
+--change-section-address .data-0x800000 \
+--change-section-address .bss-0x800000 \
+--change-section-address .noinit-0x800000 \
+--change-section-address .eeprom-0x810000 
+
+
+coff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+extcoff: applet/$(TARGET).elf
+	$(COFFCONVERT) -O coff-ext-avr applet/$(TARGET).elf applet/$(TARGET).cof
+
+
+.SUFFIXES: .elf .hex .eep .lss .sym .pde
+
+.elf.hex:
+	$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@
+
+.elf.eep:
+	-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
+	--change-section-lma .eeprom=0 -O $(FORMAT) $< $@
+
+# Create extended listing file from ELF output file.
+.elf.lss:
+	$(OBJDUMP) -h -S $< > $@
+
+# Create a symbol table from ELF output file.
+.elf.sym:
+	$(NM) -n $< > $@
+
+
+# Compile: create object files from C++ source files.
+.cpp.o: $(HEADERS)
+	$(CXX) -c $(ALL_CXXFLAGS) $< -o $@ 
+
+# Compile: create object files from C source files.
+.c.o: $(HEADERS)
+	$(CC)  -c $(ALL_CFLAGS) $< -o $@ 
+
+
+# Compile: create assembler files from C source files.
+.c.s:
+	$(CC) -S $(ALL_CFLAGS) $< -o $@
+
+
+# Assemble: create object files from assembler source files.
+.S.o:
+	$(CC) -c $(ALL_ASFLAGS) $< -o $@
+
+
+
+applet/$(TARGET).cpp: $(TARGET).pde
+	test -d applet || mkdir applet
+	echo '#include "WProgram.h"' > applet/$(TARGET).cpp
+	echo '#include "avr/interrupt.h"' >> applet/$(TARGET).cpp
+	sed -n 's|^\(void .*)\).*|\1;|p' $(TARGET).pde | grep -v 'setup()' | \
+		grep -v 'loop()' >> applet/$(TARGET).cpp
+	cat $(TARGET).pde >> applet/$(TARGET).cpp
+	cat $(ARDUINO_SRC)/main.cxx >> applet/$(TARGET).cpp
+
+# Link: create ELF output file from object files.
+applet/$(TARGET).elf: applet/$(TARGET).cpp $(OBJ)
+	$(CC) $(ALL_CFLAGS) $(OBJ) -lm --output $@ $(LDFLAGS)
+#	$(CC) $(ALL_CFLAGS) $(OBJ) $(ARDUINO_TOOLS)/avr/avr/lib/avr5/crtm168.o --output $@ $(LDFLAGS)
+
+pd_close_serial:
+	echo 'close;' | /Applications/Pd-extended.app/Contents/Resources/bin/pdsend 34567 || true
+
+# Program the device.  
+upload: applet/$(TARGET).hex
+	$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH)
+
+
+pd_test: build pd_close_serial upload
+
+# Target: clean project.
+clean:
+	$(REMOVE) -- applet/$(TARGET).hex applet/$(TARGET).eep \
+	applet/$(TARGET).cof applet/$(TARGET).elf $(TARGET).map \
+	applet/$(TARGET).sym applet/$(TARGET).lss applet/$(TARGET).cpp \
+	$(OBJ) $(LST) $(SRC:.c=.s) $(SRC:.c=.d) $(CXXSRC:.cpp=.s) $(CXXSRC:.cpp=.d)
+	rmdir -- applet
+
+depend:
+	if grep '^# DO NOT DELETE' $(MAKEFILE) >/dev/null; \
+	then \
+		sed -e '/^# DO NOT DELETE/,$$d' $(MAKEFILE) > \
+			$(MAKEFILE).$$$$ && \
+		$(MV) $(MAKEFILE).$$$$ $(MAKEFILE); \
+	fi
+	echo '# DO NOT DELETE THIS LINE -- make depend depends on it.' \
+		>> $(MAKEFILE); \
+	$(CC) -M -mmcu=$(MCU) $(CDEFS) $(INCLUDE) $(SRC) $(ASRC) >> $(MAKEFILE)
+
+.PHONY:	all build eep lss sym coff extcoff clean depend pd_close_serial pd_test
+
+# for emacs
+etags:
+	make etags_`uname -s`
+	etags *.pde \
+		$(ARDUINO_SRC)/*.[ch] \
+		$(ARDUINO_SRC)/*.cpp \
+		$(ARDUINO_LIB_SRC)/*/*.[ch] \
+		$(ARDUINO_LIB_SRC)/*/*.cpp \
+		$(ARDUINO)/hardware/tools/avr/avr/include/avr/*.[ch] \
+		$(ARDUINO)/hardware/tools/avr/avr/include/*.[ch]
+
+etags_Darwin:
+#	etags -a 
+
+etags_Linux:
+#	etags -a /usr/include/*.h linux/input.h /usr/include/sys/*.h
+
+etags_MINGW:
+#	etags -a /usr/include/*.h /usr/include/sys/*.h 
+
+
+path:
+	echo $(PATH)
+	echo $$PATH
+
diff --git a/libraries/Firmata/examples/StandardFirmata/StandardFirmata.pde b/libraries/Firmata/examples/StandardFirmata/StandardFirmata.pde
new file mode 100644
index 0000000..cd43366
--- /dev/null
+++ b/libraries/Firmata/examples/StandardFirmata/StandardFirmata.pde
@@ -0,0 +1,398 @@
+/*
+  Copyright (C) 2006-2008 Hans-Christoph Steiner.  All rights reserved.
+  
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+ 
+  See file LICENSE.txt for further informations on licensing terms.
+
+  formatted using the GNU C formatting and indenting
+*/
+
+/* 
+ * TODO: use Program Control to load stored profiles from EEPROM
+ */
+
+#include <Servo.h>
+#include <Firmata.h>
+
+/*==============================================================================
+ * GLOBAL VARIABLES
+ *============================================================================*/
+
+/* analog inputs */
+int analogInputsToReport = 0; // bitwise array to store pin reporting
+
+/* digital input ports */
+byte reportPINs[TOTAL_PORTS];       // 1 = report this port, 0 = silence
+byte previousPINs[TOTAL_PORTS];     // previous 8 bits sent
+
+/* pins configuration */
+byte pinConfig[TOTAL_PINS];         // configuration of every pin
+byte portConfigInputs[TOTAL_PORTS]; // each bit: 1 = pin in INPUT, 0 = anything else
+int pinState[TOTAL_PINS];           // any value that has been written
+
+/* timer variables */
+unsigned long currentMillis;        // store the current value from millis()
+unsigned long previousMillis;       // for comparison with currentMillis
+int samplingInterval = 19;          // how often to run the main loop (in ms)
+
+Servo servos[MAX_SERVOS];
+
+/*==============================================================================
+ * FUNCTIONS
+ *============================================================================*/
+
+void outputPort(byte portNumber, byte portValue, byte forceSend)
+{
+  // pins not configured as INPUT are cleared to zeros
+  portValue = portValue & portConfigInputs[portNumber];
+  // only send if the value is different than previously sent
+  if(forceSend || previousPINs[portNumber] != portValue) {
+    Firmata.sendDigitalPort(portNumber, portValue);
+    previousPINs[portNumber] = portValue;
+  }
+}
+
+/* -----------------------------------------------------------------------------
+ * check all the active digital inputs for change of state, then add any events
+ * to the Serial output queue using Serial.print() */
+void checkDigitalInputs(void)
+{
+  /* Using non-looping code allows constants to be given to readPort().
+   * The compiler will apply substantial optimizations if the inputs
+   * to readPort() are compile-time constants. */
+  if (TOTAL_PORTS > 0 && reportPINs[0]) outputPort(0, readPort(0, portConfigInputs[0]), false);
+  if (TOTAL_PORTS > 1 && reportPINs[1]) outputPort(1, readPort(1, portConfigInputs[1]), false);
+  if (TOTAL_PORTS > 2 && reportPINs[2]) outputPort(2, readPort(2, portConfigInputs[2]), false);
+  if (TOTAL_PORTS > 3 && reportPINs[3]) outputPort(3, readPort(3, portConfigInputs[3]), false);
+  if (TOTAL_PORTS > 4 && reportPINs[4]) outputPort(4, readPort(4, portConfigInputs[4]), false);
+  if (TOTAL_PORTS > 5 && reportPINs[5]) outputPort(5, readPort(5, portConfigInputs[5]), false);
+  if (TOTAL_PORTS > 6 && reportPINs[6]) outputPort(6, readPort(6, portConfigInputs[6]), false);
+  if (TOTAL_PORTS > 7 && reportPINs[7]) outputPort(7, readPort(7, portConfigInputs[7]), false);
+  if (TOTAL_PORTS > 8 && reportPINs[8]) outputPort(8, readPort(8, portConfigInputs[8]), false);
+  if (TOTAL_PORTS > 9 && reportPINs[9]) outputPort(9, readPort(9, portConfigInputs[9]), false);
+  if (TOTAL_PORTS > 10 && reportPINs[10]) outputPort(10, readPort(10, portConfigInputs[10]), false);
+  if (TOTAL_PORTS > 11 && reportPINs[11]) outputPort(11, readPort(11, portConfigInputs[11]), false);
+  if (TOTAL_PORTS > 12 && reportPINs[12]) outputPort(12, readPort(12, portConfigInputs[12]), false);
+  if (TOTAL_PORTS > 13 && reportPINs[13]) outputPort(13, readPort(13, portConfigInputs[13]), false);
+  if (TOTAL_PORTS > 14 && reportPINs[14]) outputPort(14, readPort(14, portConfigInputs[14]), false);
+  if (TOTAL_PORTS > 15 && reportPINs[15]) outputPort(15, readPort(15, portConfigInputs[15]), false);
+}
+
+// -----------------------------------------------------------------------------
+/* sets the pin mode to the correct state and sets the relevant bits in the
+ * two bit-arrays that track Digital I/O and PWM status
+ */
+void setPinModeCallback(byte pin, int mode)
+{
+  if (IS_PIN_SERVO(pin) && mode != SERVO && servos[PIN_TO_SERVO(pin)].attached()) {
+    servos[PIN_TO_SERVO(pin)].detach();
+  }
+  if (IS_PIN_ANALOG(pin)) {
+    reportAnalogCallback(PIN_TO_ANALOG(pin), mode == ANALOG ? 1 : 0); // turn on/off reporting
+  }
+  if (IS_PIN_DIGITAL(pin)) {
+    if (mode == INPUT) {
+      portConfigInputs[pin/8] |= (1 << (pin & 7));
+    } else {
+      portConfigInputs[pin/8] &= ~(1 << (pin & 7));
+    }
+  }
+  pinState[pin] = 0;
+  switch(mode) {
+  case ANALOG:
+    if (IS_PIN_ANALOG(pin)) {
+      if (IS_PIN_DIGITAL(pin)) {
+        pinMode(PIN_TO_DIGITAL(pin), INPUT); // disable output driver
+        digitalWrite(PIN_TO_DIGITAL(pin), LOW); // disable internal pull-ups
+      }
+      pinConfig[pin] = ANALOG;
+    }
+    break;
+  case INPUT:
+    if (IS_PIN_DIGITAL(pin)) {
+      pinMode(PIN_TO_DIGITAL(pin), INPUT); // disable output driver
+      digitalWrite(PIN_TO_DIGITAL(pin), LOW); // disable internal pull-ups
+      pinConfig[pin] = INPUT;
+    }
+    break;
+  case OUTPUT:
+    if (IS_PIN_DIGITAL(pin)) {
+      digitalWrite(PIN_TO_DIGITAL(pin), LOW); // disable PWM
+      pinMode(PIN_TO_DIGITAL(pin), OUTPUT);
+      pinConfig[pin] = OUTPUT;
+    }
+    break;
+  case PWM:
+    if (IS_PIN_PWM(pin)) {
+      pinMode(PIN_TO_PWM(pin), OUTPUT);
+      analogWrite(PIN_TO_PWM(pin), 0);
+      pinConfig[pin] = PWM;
+    }
+    break;
+  case SERVO:
+    if (IS_PIN_SERVO(pin)) {
+      pinConfig[pin] = SERVO;
+      if (!servos[PIN_TO_SERVO(pin)].attached()) {
+          servos[PIN_TO_SERVO(pin)].attach(PIN_TO_DIGITAL(pin));
+      } else {
+        Firmata.sendString("Servo only on pins from 2 to 13");
+      }
+    }
+    break;
+  case I2C:
+    pinConfig[pin] = mode;
+    Firmata.sendString("I2C mode not yet supported");
+    break;
+  default:
+    Firmata.sendString("Unknown pin mode"); // TODO: put error msgs in EEPROM
+  }
+  // TODO: save status to EEPROM here, if changed
+}
+
+void analogWriteCallback(byte pin, int value)
+{
+  if (pin < TOTAL_PINS) {
+    switch(pinConfig[pin]) {
+    case SERVO:
+      if (IS_PIN_SERVO(pin))
+        servos[PIN_TO_SERVO(pin)].write(value);
+        pinState[pin] = value;
+      break;
+    case PWM:
+      if (IS_PIN_PWM(pin))
+        analogWrite(PIN_TO_PWM(pin), value);
+        pinState[pin] = value;
+      break;
+    }
+  }
+}
+
+void digitalWriteCallback(byte port, int value)
+{
+  byte pin, lastPin, mask=1, pinWriteMask=0;
+
+  if (port < TOTAL_PORTS) {
+    // create a mask of the pins on this port that are writable.
+    lastPin = port*8+8;
+    if (lastPin > TOTAL_PINS) lastPin = TOTAL_PINS;
+    for (pin=port*8; pin < lastPin; pin++) {
+      // do not disturb non-digital pins (eg, Rx & Tx)
+      if (IS_PIN_DIGITAL(pin)) {
+        // only write to OUTPUT and INPUT (enables pullup)
+        // do not touch pins in PWM, ANALOG, SERVO or other modes
+        if (pinConfig[pin] == OUTPUT || pinConfig[pin] == INPUT) {
+          pinWriteMask |= mask;
+          pinState[pin] = ((byte)value & mask) ? 1 : 0;
+        }
+      }
+      mask = mask << 1;
+    }
+    writePort(port, (byte)value, pinWriteMask);
+  }
+}
+
+
+// -----------------------------------------------------------------------------
+/* sets bits in a bit array (int) to toggle the reporting of the analogIns
+ */
+//void FirmataClass::setAnalogPinReporting(byte pin, byte state) {
+//}
+void reportAnalogCallback(byte analogPin, int value)
+{
+  if (analogPin < TOTAL_ANALOG_PINS) {
+    if(value == 0) {
+      analogInputsToReport = analogInputsToReport &~ (1 << analogPin);
+    } else {
+      analogInputsToReport = analogInputsToReport | (1 << analogPin);
+    }
+  }
+  // TODO: save status to EEPROM here, if changed
+}
+
+void reportDigitalCallback(byte port, int value)
+{
+  if (port < TOTAL_PORTS) {
+    reportPINs[port] = (byte)value;
+  }
+  // do not disable analog reporting on these 8 pins, to allow some
+  // pins used for digital, others analog.  Instead, allow both types
+  // of reporting to be enabled, but check if the pin is configured
+  // as analog when sampling the analog inputs.  Likewise, while
+  // scanning digital pins, portConfigInputs will mask off values from any
+  // pins configured as analog
+}
+
+/*==============================================================================
+ * SYSEX-BASED commands
+ *============================================================================*/
+
+void sysexCallback(byte command, byte argc, byte *argv)
+{
+  switch(command) {
+  case SERVO_CONFIG:
+    if(argc > 4) {
+      // these vars are here for clarity, they'll optimized away by the compiler
+      byte pin = argv[0];
+      int minPulse = argv[1] + (argv[2] << 7);
+      int maxPulse = argv[3] + (argv[4] << 7);
+
+      if (IS_PIN_SERVO(pin)) {
+        // servos are pins from 2 to 13, so offset for array
+        if (servos[PIN_TO_SERVO(pin)].attached())
+          servos[PIN_TO_SERVO(pin)].detach();
+        servos[PIN_TO_SERVO(pin)].attach(PIN_TO_DIGITAL(pin), minPulse, maxPulse);
+        setPinModeCallback(pin, SERVO);
+      }
+    }
+    break;
+  case SAMPLING_INTERVAL:
+    if (argc > 1)
+      samplingInterval = argv[0] + (argv[1] << 7);
+    else
+      Firmata.sendString("Not enough data");
+    break;
+  case EXTENDED_ANALOG:
+    if (argc > 1) {
+      int val = argv[1];
+      if (argc > 2) val |= (argv[2] << 7);
+      if (argc > 3) val |= (argv[3] << 14);
+      analogWriteCallback(argv[0], val);
+    }
+    break;
+  case CAPABILITY_QUERY:
+    Serial.write(START_SYSEX);
+    Serial.write(CAPABILITY_RESPONSE);
+    for (byte pin=0; pin < TOTAL_PINS; pin++) {
+      if (IS_PIN_DIGITAL(pin)) {
+        Serial.write((byte)INPUT);
+        Serial.write(1);
+        Serial.write((byte)OUTPUT);
+        Serial.write(1);
+      }
+      if (IS_PIN_ANALOG(pin)) {
+        Serial.write(ANALOG);
+        Serial.write(10);
+      }
+      if (IS_PIN_PWM(pin)) {
+        Serial.write(PWM);
+        Serial.write(8);
+      }
+      if (IS_PIN_SERVO(pin)) {
+        Serial.write(SERVO);
+        Serial.write(14);
+      }
+      Serial.write(127);
+    }
+    Serial.write(END_SYSEX);
+    break;
+  case PIN_STATE_QUERY:
+    if (argc > 0) {
+      byte pin=argv[0];
+      Serial.write(START_SYSEX);
+      Serial.write(PIN_STATE_RESPONSE);
+      Serial.write(pin);
+      if (pin < TOTAL_PINS) {
+        Serial.write((byte)pinConfig[pin]);
+	Serial.write((byte)pinState[pin] & 0x7F);
+	if (pinState[pin] & 0xFF80) Serial.write((byte)(pinState[pin] >> 7) & 0x7F);
+	if (pinState[pin] & 0xC000) Serial.write((byte)(pinState[pin] >> 14) & 0x7F);
+      }
+      Serial.write(END_SYSEX);
+    }
+    break;
+  case ANALOG_MAPPING_QUERY:
+    Serial.write(START_SYSEX);
+    Serial.write(ANALOG_MAPPING_RESPONSE);
+    for (byte pin=0; pin < TOTAL_PINS; pin++) {
+      Serial.write(IS_PIN_ANALOG(pin) ? PIN_TO_ANALOG(pin) : 127);
+    }
+    Serial.write(END_SYSEX);
+    break;
+  }
+}
+
+
+/*==============================================================================
+ * SETUP()
+ *============================================================================*/
+void setup() 
+{
+  byte i;
+
+  Firmata.setFirmwareVersion(2, 2);
+
+  Firmata.attach(ANALOG_MESSAGE, analogWriteCallback);
+  Firmata.attach(DIGITAL_MESSAGE, digitalWriteCallback);
+  Firmata.attach(REPORT_ANALOG, reportAnalogCallback);
+  Firmata.attach(REPORT_DIGITAL, reportDigitalCallback);
+  Firmata.attach(SET_PIN_MODE, setPinModeCallback);
+  Firmata.attach(START_SYSEX, sysexCallback);
+
+  // TODO: load state from EEPROM here
+
+  /* these are initialized to zero by the compiler startup code
+  for (i=0; i < TOTAL_PORTS; i++) {
+    reportPINs[i] = false;
+    portConfigInputs[i] = 0;
+    previousPINs[i] = 0;
+  }
+  */
+  for (i=0; i < TOTAL_PINS; i++) {
+    if (IS_PIN_ANALOG(i)) {
+      // turns off pullup, configures everything
+      setPinModeCallback(i, ANALOG);
+    } else {
+      // sets the output to 0, configures portConfigInputs
+      setPinModeCallback(i, OUTPUT);
+    }
+  }
+  // by defult, do not report any analog inputs
+  analogInputsToReport = 0;
+
+  Firmata.begin(57600);
+
+  /* send digital inputs to set the initial state on the host computer,
+   * since once in the loop(), this firmware will only send on change */
+  for (i=0; i < TOTAL_PORTS; i++) {
+    outputPort(i, readPort(i, portConfigInputs[i]), true);
+  }
+}
+
+/*==============================================================================
+ * LOOP()
+ *============================================================================*/
+void loop() 
+{
+  byte pin, analogPin;
+
+  /* DIGITALREAD - as fast as possible, check for changes and output them to the
+   * FTDI buffer using Serial.print()  */
+  checkDigitalInputs();  
+
+  /* SERIALREAD - processing incoming messagse as soon as possible, while still
+   * checking digital inputs.  */
+  while(Firmata.available())
+    Firmata.processInput();
+
+  /* SEND FTDI WRITE BUFFER - make sure that the FTDI buffer doesn't go over
+   * 60 bytes. use a timer to sending an event character every 4 ms to
+   * trigger the buffer to dump. */
+
+  currentMillis = millis();
+  if (currentMillis - previousMillis > samplingInterval) {
+    previousMillis += samplingInterval;
+    /* ANALOGREAD - do all analogReads() at the configured sampling interval */
+    for(pin=0; pin<TOTAL_PINS; pin++) {
+      if (IS_PIN_ANALOG(pin) && pinConfig[pin] == ANALOG) {
+        analogPin = PIN_TO_ANALOG(pin);
+        if (analogInputsToReport & (1 << analogPin)) {
+          Firmata.sendAnalog(analogPin, analogRead(analogPin));
+        }
+      }
+    }
+  }
+}
diff --git a/libraries/Firmata/examples/StandardFirmata_2_2_forUNO_0_3/StandardFirmata_2_2_forUNO_0_3.pde b/libraries/Firmata/examples/StandardFirmata_2_2_forUNO_0_3/StandardFirmata_2_2_forUNO_0_3.pde
new file mode 100644
index 0000000..4cfa658
--- /dev/null
+++ b/libraries/Firmata/examples/StandardFirmata_2_2_forUNO_0_3/StandardFirmata_2_2_forUNO_0_3.pde
@@ -0,0 +1,436 @@
+/*
+  This introduces modifications on the normal Firmata made for Arduino so that the LED 
+  blinks until receiving the first command over serial.
+
+  Copyright (C) 2010 David Cuartielles.  All rights reserved.
+  
+  based at 99.9% on Firmata by HC Steiner according to the following license terms:
+  
+  Copyright (C) 2006-2008 Hans-Christoph Steiner.  All rights reserved.
+  
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+ 
+  See file LICENSE.txt for further informations on licensing terms.
+
+  formatted using the GNU C formatting and indenting
+*/
+
+/* 
+ * TODO: use Program Control to load stored profiles from EEPROM
+ */
+
+#include <Servo.h>
+#include <Firmata.h>
+
+/*==============================================================================
+ * GLOBAL VARIABLES
+ *============================================================================*/
+
+/* has the command arrived? */
+boolean firstCommand = false;
+int dataOnSerial = 0;
+boolean statusLed = false;
+
+/* analog inputs */
+int analogInputsToReport = 0; // bitwise array to store pin reporting
+
+/* digital input ports */
+byte reportPINs[TOTAL_PORTS];       // 1 = report this port, 0 = silence
+byte previousPINs[TOTAL_PORTS];     // previous 8 bits sent
+
+/* pins configuration */
+byte pinConfig[TOTAL_PINS];         // configuration of every pin
+byte portConfigInputs[TOTAL_PORTS]; // each bit: 1 = pin in INPUT, 0 = anything else
+int pinState[TOTAL_PINS];           // any value that has been written
+
+/* timer variables */
+unsigned long currentMillis;        // store the current value from millis()
+unsigned long previousMillis;       // for comparison with currentMillis
+int samplingInterval = 19;          // how often to run the main loop (in ms)
+unsigned long toggleMillis;
+
+Servo servos[MAX_SERVOS];
+
+/*==============================================================================
+ * FUNCTIONS
+ *============================================================================*/
+
+void toggleLed() 
+{
+  if (millis() - toggleMillis > 500) {
+    statusLed = !statusLed;
+    digitalWrite(13, statusLed);
+    toggleMillis = millis();
+  }
+}
+
+void outputPort(byte portNumber, byte portValue, byte forceSend)
+{
+  // pins not configured as INPUT are cleared to zeros
+  portValue = portValue & portConfigInputs[portNumber];
+  // only send if the value is different than previously sent
+  if(forceSend || previousPINs[portNumber] != portValue) {
+    Firmata.sendDigitalPort(portNumber, portValue);
+    previousPINs[portNumber] = portValue;
+  }
+}
+
+/* -----------------------------------------------------------------------------
+ * check all the active digital inputs for change of state, then add any events
+ * to the Serial output queue using Serial.print() */
+void checkDigitalInputs(void)
+{
+  /* Using non-looping code allows constants to be given to readPort().
+   * The compiler will apply substantial optimizations if the inputs
+   * to readPort() are compile-time constants. */
+  if (TOTAL_PORTS > 0 && reportPINs[0]) outputPort(0, readPort(0, portConfigInputs[0]), false);
+  if (TOTAL_PORTS > 1 && reportPINs[1]) outputPort(1, readPort(1, portConfigInputs[1]), false);
+  if (TOTAL_PORTS > 2 && reportPINs[2]) outputPort(2, readPort(2, portConfigInputs[2]), false);
+  if (TOTAL_PORTS > 3 && reportPINs[3]) outputPort(3, readPort(3, portConfigInputs[3]), false);
+  if (TOTAL_PORTS > 4 && reportPINs[4]) outputPort(4, readPort(4, portConfigInputs[4]), false);
+  if (TOTAL_PORTS > 5 && reportPINs[5]) outputPort(5, readPort(5, portConfigInputs[5]), false);
+  if (TOTAL_PORTS > 6 && reportPINs[6]) outputPort(6, readPort(6, portConfigInputs[6]), false);
+  if (TOTAL_PORTS > 7 && reportPINs[7]) outputPort(7, readPort(7, portConfigInputs[7]), false);
+  if (TOTAL_PORTS > 8 && reportPINs[8]) outputPort(8, readPort(8, portConfigInputs[8]), false);
+  if (TOTAL_PORTS > 9 && reportPINs[9]) outputPort(9, readPort(9, portConfigInputs[9]), false);
+  if (TOTAL_PORTS > 10 && reportPINs[10]) outputPort(10, readPort(10, portConfigInputs[10]), false);
+  if (TOTAL_PORTS > 11 && reportPINs[11]) outputPort(11, readPort(11, portConfigInputs[11]), false);
+  if (TOTAL_PORTS > 12 && reportPINs[12]) outputPort(12, readPort(12, portConfigInputs[12]), false);
+  if (TOTAL_PORTS > 13 && reportPINs[13]) outputPort(13, readPort(13, portConfigInputs[13]), false);
+  if (TOTAL_PORTS > 14 && reportPINs[14]) outputPort(14, readPort(14, portConfigInputs[14]), false);
+  if (TOTAL_PORTS > 15 && reportPINs[15]) outputPort(15, readPort(15, portConfigInputs[15]), false);
+}
+
+// -----------------------------------------------------------------------------
+/* sets the pin mode to the correct state and sets the relevant bits in the
+ * two bit-arrays that track Digital I/O and PWM status
+ */
+void setPinModeCallback(byte pin, int mode)
+{
+  if (IS_PIN_SERVO(pin) && mode != SERVO && servos[PIN_TO_SERVO(pin)].attached()) {
+    servos[PIN_TO_SERVO(pin)].detach();
+  }
+  if (IS_PIN_ANALOG(pin)) {
+    reportAnalogCallback(PIN_TO_ANALOG(pin), mode == ANALOG ? 1 : 0); // turn on/off reporting
+  }
+  if (IS_PIN_DIGITAL(pin)) {
+    if (mode == INPUT) {
+      portConfigInputs[pin/8] |= (1 << (pin & 7));
+    } else {
+      portConfigInputs[pin/8] &= ~(1 << (pin & 7));
+    }
+  }
+  pinState[pin] = 0;
+  switch(mode) {
+  case ANALOG:
+    if (IS_PIN_ANALOG(pin)) {
+      if (IS_PIN_DIGITAL(pin)) {
+        pinMode(PIN_TO_DIGITAL(pin), INPUT); // disable output driver
+        digitalWrite(PIN_TO_DIGITAL(pin), LOW); // disable internal pull-ups
+      }
+      pinConfig[pin] = ANALOG;
+    }
+    break;
+  case INPUT:
+    if (IS_PIN_DIGITAL(pin)) {
+      pinMode(PIN_TO_DIGITAL(pin), INPUT); // disable output driver
+      digitalWrite(PIN_TO_DIGITAL(pin), LOW); // disable internal pull-ups
+      pinConfig[pin] = INPUT;
+    }
+    break;
+  case OUTPUT:
+    if (IS_PIN_DIGITAL(pin)) {
+      digitalWrite(PIN_TO_DIGITAL(pin), LOW); // disable PWM
+      pinMode(PIN_TO_DIGITAL(pin), OUTPUT);
+      pinConfig[pin] = OUTPUT;
+    }
+    break;
+  case PWM:
+    if (IS_PIN_PWM(pin)) {
+      pinMode(PIN_TO_PWM(pin), OUTPUT);
+      analogWrite(PIN_TO_PWM(pin), 0);
+      pinConfig[pin] = PWM;
+    }
+    break;
+  case SERVO:
+    if (IS_PIN_SERVO(pin)) {
+      pinConfig[pin] = SERVO;
+      if (!servos[PIN_TO_SERVO(pin)].attached()) {
+          servos[PIN_TO_SERVO(pin)].attach(PIN_TO_DIGITAL(pin));
+      } else {
+        Firmata.sendString("Servo only on pins from 2 to 13");
+      }
+    }
+    break;
+  case I2C:
+    pinConfig[pin] = mode;
+    Firmata.sendString("I2C mode not yet supported");
+    break;
+  default:
+    Firmata.sendString("Unknown pin mode"); // TODO: put error msgs in EEPROM
+  }
+  // TODO: save status to EEPROM here, if changed
+}
+
+void analogWriteCallback(byte pin, int value)
+{
+  if (pin < TOTAL_PINS) {
+    switch(pinConfig[pin]) {
+    case SERVO:
+      if (IS_PIN_SERVO(pin))
+        servos[PIN_TO_SERVO(pin)].write(value);
+        pinState[pin] = value;
+      break;
+    case PWM:
+      if (IS_PIN_PWM(pin))
+        analogWrite(PIN_TO_PWM(pin), value);
+        pinState[pin] = value;
+      break;
+    }
+  }
+}
+
+void digitalWriteCallback(byte port, int value)
+{
+  byte pin, lastPin, mask=1, pinWriteMask=0;
+
+  if (port < TOTAL_PORTS) {
+    // create a mask of the pins on this port that are writable.
+    lastPin = port*8+8;
+    if (lastPin > TOTAL_PINS) lastPin = TOTAL_PINS;
+    for (pin=port*8; pin < lastPin; pin++) {
+      // do not disturb non-digital pins (eg, Rx & Tx)
+      if (IS_PIN_DIGITAL(pin)) {
+        // only write to OUTPUT and INPUT (enables pullup)
+        // do not touch pins in PWM, ANALOG, SERVO or other modes
+        if (pinConfig[pin] == OUTPUT || pinConfig[pin] == INPUT) {
+          pinWriteMask |= mask;
+          pinState[pin] = ((byte)value & mask) ? 1 : 0;
+        }
+      }
+      mask = mask << 1;
+    }
+    writePort(port, (byte)value, pinWriteMask);
+  }
+}
+
+
+// -----------------------------------------------------------------------------
+/* sets bits in a bit array (int) to toggle the reporting of the analogIns
+ */
+//void FirmataClass::setAnalogPinReporting(byte pin, byte state) {
+//}
+void reportAnalogCallback(byte analogPin, int value)
+{
+  if (analogPin < TOTAL_ANALOG_PINS) {
+    if(value == 0) {
+      analogInputsToReport = analogInputsToReport &~ (1 << analogPin);
+    } else {
+      analogInputsToReport = analogInputsToReport | (1 << analogPin);
+    }
+  }
+  // TODO: save status to EEPROM here, if changed
+}
+
+void reportDigitalCallback(byte port, int value)
+{
+  if (port < TOTAL_PORTS) {
+    reportPINs[port] = (byte)value;
+  }
+  // do not disable analog reporting on these 8 pins, to allow some
+  // pins used for digital, others analog.  Instead, allow both types
+  // of reporting to be enabled, but check if the pin is configured
+  // as analog when sampling the analog inputs.  Likewise, while
+  // scanning digital pins, portConfigInputs will mask off values from any
+  // pins configured as analog
+}
+
+/*==============================================================================
+ * SYSEX-BASED commands
+ *============================================================================*/
+
+void sysexCallback(byte command, byte argc, byte *argv)
+{
+  switch(command) {
+  case SERVO_CONFIG:
+    if(argc > 4) {
+      // these vars are here for clarity, they'll optimized away by the compiler
+      byte pin = argv[0];
+      int minPulse = argv[1] + (argv[2] << 7);
+      int maxPulse = argv[3] + (argv[4] << 7);
+
+      if (IS_PIN_SERVO(pin)) {
+        // servos are pins from 2 to 13, so offset for array
+        if (servos[PIN_TO_SERVO(pin)].attached())
+          servos[PIN_TO_SERVO(pin)].detach();
+        servos[PIN_TO_SERVO(pin)].attach(PIN_TO_DIGITAL(pin), minPulse, maxPulse);
+        setPinModeCallback(pin, SERVO);
+      }
+    }
+    break;
+  case SAMPLING_INTERVAL:
+    if (argc > 1)
+      samplingInterval = argv[0] + (argv[1] << 7);
+    else
+      Firmata.sendString("Not enough data");
+    break;
+  case EXTENDED_ANALOG:
+    if (argc > 1) {
+      int val = argv[1];
+      if (argc > 2) val |= (argv[2] << 7);
+      if (argc > 3) val |= (argv[3] << 14);
+      analogWriteCallback(argv[0], val);
+    }
+    break;
+  case CAPABILITY_QUERY:
+    Serial.write(START_SYSEX);
+    Serial.write(CAPABILITY_RESPONSE);
+    for (byte pin=0; pin < TOTAL_PINS; pin++) {
+      if (IS_PIN_DIGITAL(pin)) {
+        Serial.write((byte)INPUT);
+        Serial.write(1);
+        Serial.write((byte)OUTPUT);
+        Serial.write(1);
+      }
+      if (IS_PIN_ANALOG(pin)) {
+        Serial.write(ANALOG);
+        Serial.write(10);
+      }
+      if (IS_PIN_PWM(pin)) {
+        Serial.write(PWM);
+        Serial.write(8);
+      }
+      if (IS_PIN_SERVO(pin)) {
+        Serial.write(SERVO);
+        Serial.write(14);
+      }
+      Serial.write(127);
+    }
+    Serial.write(END_SYSEX);
+    break;
+  case PIN_STATE_QUERY:
+    if (argc > 0) {
+      byte pin=argv[0];
+      Serial.write(START_SYSEX);
+      Serial.write(PIN_STATE_RESPONSE);
+      Serial.write(pin);
+      if (pin < TOTAL_PINS) {
+        Serial.write((byte)pinConfig[pin]);
+	Serial.write((byte)pinState[pin] & 0x7F);
+	if (pinState[pin] & 0xFF80) Serial.write((byte)(pinState[pin] >> 7) & 0x7F);
+	if (pinState[pin] & 0xC000) Serial.write((byte)(pinState[pin] >> 14) & 0x7F);
+      }
+      Serial.write(END_SYSEX);
+    }
+    break;
+  case ANALOG_MAPPING_QUERY:
+    Serial.write(START_SYSEX);
+    Serial.write(ANALOG_MAPPING_RESPONSE);
+    for (byte pin=0; pin < TOTAL_PINS; pin++) {
+      Serial.write(IS_PIN_ANALOG(pin) ? PIN_TO_ANALOG(pin) : 127);
+    }
+    Serial.write(END_SYSEX);
+    break;
+  }
+}
+
+/*==============================================================================
+ * SETUP()
+ *============================================================================*/
+void setup() 
+{
+  byte i;
+
+  Firmata.setFirmwareVersion(2, 2);
+
+  Firmata.attach(ANALOG_MESSAGE, analogWriteCallback);
+  Firmata.attach(DIGITAL_MESSAGE, digitalWriteCallback);
+  Firmata.attach(REPORT_ANALOG, reportAnalogCallback);
+  Firmata.attach(REPORT_DIGITAL, reportDigitalCallback);
+  Firmata.attach(SET_PIN_MODE, setPinModeCallback);
+  Firmata.attach(START_SYSEX, sysexCallback);
+
+  // TODO: load state from EEPROM here
+
+  /* these are initialized to zero by the compiler startup code
+  for (i=0; i < TOTAL_PORTS; i++) {
+    reportPINs[i] = false;
+    portConfigInputs[i] = 0;
+    previousPINs[i] = 0;
+  }
+  */
+  for (i=0; i < TOTAL_PINS; i++) {
+    if (IS_PIN_ANALOG(i)) {
+      // turns off pullup, configures everything
+      setPinModeCallback(i, ANALOG);
+    } else {
+      // sets the output to 0, configures portConfigInputs
+      setPinModeCallback(i, OUTPUT);
+    }
+  }
+  // by defult, do not report any analog inputs
+  analogInputsToReport = 0;
+
+  Firmata.begin(57600);
+
+  /* send digital inputs to set the initial state on the host computer,
+   * since once in the loop(), this firmware will only send on change */
+  for (i=0; i < TOTAL_PORTS; i++) {
+    outputPort(i, readPort(i, portConfigInputs[i]), true);
+  }
+  
+  /* init the toggleLed counter */
+  toggleMillis = millis();
+  pinMode(13, OUTPUT);
+}
+
+/*==============================================================================
+ * LOOP()
+ *============================================================================*/
+void loop() 
+{
+  byte pin, analogPin;
+
+  /* DIGITALREAD - as fast as possible, check for changes and output them to the
+   * FTDI buffer using Serial.print()  */
+  checkDigitalInputs();  
+
+  //XXX: hack Firmata to blink until serial command arrives 
+  dataOnSerial = Firmata.available();
+  if (dataOnSerial > 0 && !firstCommand) {
+    firstCommand = true;
+  }
+  //XXX: do the blink if the first command hasn't arrived yet
+  //     configures pin 13 as output and then back as input
+  if (!firstCommand) {
+    toggleLed();
+  }
+  
+  /* SERIALREAD - processing incoming messagse as soon as possible, while still
+   * checking digital inputs.  */
+  while(dataOnSerial) {
+    Firmata.processInput();
+    dataOnSerial = Firmata.available();
+  }
+  
+  /* SEND FTDI WRITE BUFFER - make sure that the FTDI buffer doesn't go over
+   * 60 bytes. use a timer to sending an event character every 4 ms to
+   * trigger the buffer to dump. */
+
+  currentMillis = millis();
+  if (currentMillis - previousMillis > samplingInterval) {
+    previousMillis += samplingInterval;
+    /* ANALOGREAD - do all analogReads() at the configured sampling interval */
+    for(pin=0; pin<TOTAL_PINS; pin++) {
+      if (IS_PIN_ANALOG(pin) && pinConfig[pin] == ANALOG) {
+        analogPin = PIN_TO_ANALOG(pin);
+        if (analogInputsToReport & (1 << analogPin)) {
+          Firmata.sendAnalog(analogPin, analogRead(analogPin));
+        }
+      }
+    }
+  }
+}
diff --git a/libraries/Firmata/keywords.txt b/libraries/Firmata/keywords.txt
new file mode 100644
index 0000000..52e0a9c
--- /dev/null
+++ b/libraries/Firmata/keywords.txt
@@ -0,0 +1,62 @@
+#######################################
+# Syntax Coloring Map For Firmata
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+Firmata	KEYWORD1
+callbackFunction	KEYWORD1
+systemResetCallbackFunction	KEYWORD1
+stringCallbackFunction	KEYWORD1
+sysexCallbackFunction	KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+
+begin	KEYWORD2
+begin	KEYWORD2
+printVersion	KEYWORD2
+blinkVersion	KEYWORD2
+printFirmwareVersion	KEYWORD2
+setFirmwareVersion	KEYWORD2
+setFirmwareNameAndVersion	KEYWORD2
+available	KEYWORD2
+processInput	KEYWORD2
+sendAnalog	KEYWORD2
+sendDigital	KEYWORD2
+sendDigitalPortPair	KEYWORD2
+sendDigitalPort	KEYWORD2
+sendString	KEYWORD2
+sendString	KEYWORD2
+sendSysex	KEYWORD2
+attach	KEYWORD2
+detach	KEYWORD2
+flush	KEYWORD2
+
+
+#######################################
+# Constants (LITERAL1)
+#######################################
+
+MAX_DATA_BYTES	LITERAL1
+
+DIGITAL_MESSAGE	LITERAL1
+ANALOG_MESSAGE	LITERAL1
+REPORT_ANALOG	LITERAL1
+REPORT_DIGITAL	LITERAL1
+REPORT_VERSION	LITERAL1
+SET_PIN_MODE	LITERAL1
+SYSTEM_RESET	LITERAL1
+
+START_SYSEX	LITERAL1
+END_SYSEX	LITERAL1
+
+PWM	LITERAL1
+
+TOTAL_ANALOG_PINS	LITERAL1
+TOTAL_DIGITAL_PINS	LITERAL1
+TOTAL_PORTS			LITERAL1
+ANALOG_PORT			LITERAL1
diff --git a/libraries/SD/File.cpp b/libraries/SD/File.cpp
new file mode 100644
index 0000000..9ef8196
--- /dev/null
+++ b/libraries/SD/File.cpp
@@ -0,0 +1,143 @@
+/*
+
+ SD - a slightly more friendly wrapper for sdfatlib
+
+ This library aims to expose a subset of SD card functionality
+ in the form of a higher level "wrapper" object.
+
+ License: GNU General Public License V3
+          (Because sdfatlib is licensed with this.)
+
+ (C) Copyright 2010 SparkFun Electronics
+
+ */
+
+#include <SD.h>
+
+/* for debugging file open/close leaks
+   uint8_t nfilecount=0;
+*/
+
+File::File(SdFile f, char *n) {
+  // oh man you are kidding me, new() doesnt exist? Ok we do it by hand!
+  _file = (SdFile *)malloc(sizeof(SdFile)); 
+  if (_file) {
+    memcpy(_file, &f, sizeof(SdFile));
+    
+    strncpy(_name, n, 12);
+    _name[12] = 0;
+    
+    /* for debugging file open/close leaks
+       nfilecount++;
+       Serial.print("Created \"");
+       Serial.print(n);
+       Serial.print("\": ");
+       Serial.println(nfilecount, DEC);
+    */
+  }
+}
+
+File::File(void) {
+  _file = 0;
+  _name[0] = 0;
+  //Serial.print("Created empty file object");
+}
+
+File::~File(void) {
+  //  Serial.print("Deleted file object");
+}
+
+// returns a pointer to the file name
+char *File::name(void) {
+  return _name;
+}
+
+// a directory is a special type of file
+boolean File::isDirectory(void) {
+  return (_file && _file->isDir());
+}
+
+
+void File::write(uint8_t val) {
+  if (_file)
+    _file->write(val);
+}
+
+void File::write(const char *str) {
+  if (_file) 
+    _file->write(str);
+}
+
+void File::write(const uint8_t *buf, size_t size) {
+  if (_file)
+    _file->write(buf, size);
+}
+
+int File::peek() {
+  if (! _file) 
+    return 0;
+
+  int c = _file->read();
+  if (c != -1) _file->seekCur(-1);
+  return c;
+}
+
+int File::read() {
+  if (_file) 
+    return _file->read();
+  return -1;
+}
+
+// buffered read for more efficient, high speed reading
+int File::read(void *buf, uint16_t nbyte) {
+  if (_file) 
+    return _file->read(buf, nbyte);
+  return 0;
+}
+
+int File::available() {
+  if (! _file) return 0;
+  return size() - position();
+}
+
+void File::flush() {
+  if (_file)
+    _file->sync();
+}
+
+boolean File::seek(uint32_t pos) {
+  if (! _file) return false;
+
+  return _file->seekSet(pos);
+}
+
+uint32_t File::position() {
+  if (! _file) return -1;
+  return _file->curPosition();
+}
+
+uint32_t File::size() {
+  if (! _file) return 0;
+  return _file->fileSize();
+}
+
+void File::close() {
+  if (_file) {
+    _file->close();
+    free(_file); 
+    _file = 0;
+
+    /* for debugging file open/close leaks
+    nfilecount--;
+    Serial.print("Deleted ");
+    Serial.println(nfilecount, DEC);
+    */
+  }
+}
+
+File::operator bool() {
+  if (_file) 
+    return  _file->isOpen();
+  return false;
+}
+
diff --git a/libraries/SD/README.txt b/libraries/SD/README.txt
new file mode 100644
index 0000000..495ea4c
--- /dev/null
+++ b/libraries/SD/README.txt
@@ -0,0 +1,13 @@
+
+** SD - a slightly more friendly wrapper for sdfatlib **
+
+This library aims to expose a subset of SD card functionality in the
+form of a higher level "wrapper" object.
+
+License: GNU General Public License V3
+         (Because sdfatlib is licensed with this.)
+
+(C) Copyright 2010 SparkFun Electronics
+
+Now better than ever with optimization, multiple file support, directory handling, etc - ladyada!
+
diff --git a/libraries/SD/SD.cpp b/libraries/SD/SD.cpp
new file mode 100644
index 0000000..64dc40b
--- /dev/null
+++ b/libraries/SD/SD.cpp
@@ -0,0 +1,616 @@
+/*
+
+ SD - a slightly more friendly wrapper for sdfatlib
+
+ This library aims to expose a subset of SD card functionality
+ in the form of a higher level "wrapper" object.
+
+ License: GNU General Public License V3
+          (Because sdfatlib is licensed with this.)
+
+ (C) Copyright 2010 SparkFun Electronics
+
+
+ This library provides four key benefits:
+
+   * Including `SD.h` automatically creates a global
+     `SD` object which can be interacted with in a similar
+     manner to other standard global objects like `Serial` and `Ethernet`.
+
+   * Boilerplate initialisation code is contained in one method named 
+     `begin` and no further objects need to be created in order to access
+     the SD card.
+
+   * Calls to `open` can supply a full path name including parent 
+     directories which simplifies interacting with files in subdirectories.
+
+   * Utility methods are provided to determine whether a file exists
+     and to create a directory heirarchy.
+
+
+  Note however that not all functionality provided by the underlying
+  sdfatlib library is exposed.
+
+ */
+
+/*
+
+  Implementation Notes
+
+  In order to handle multi-directory path traversal, functionality that 
+  requires this ability is implemented as callback functions.
+
+  Individual methods call the `walkPath` function which performs the actual
+  directory traversal (swapping between two different directory/file handles
+  along the way) and at each level calls the supplied callback function.
+
+  Some types of functionality will take an action at each level (e.g. exists
+  or make directory) which others will only take an action at the bottom
+  level (e.g. open).
+
+ */
+
+#include "SD.h"
+
+// Used by `getNextPathComponent`
+#define MAX_COMPONENT_LEN 12 // What is max length?
+#define PATH_COMPONENT_BUFFER_LEN MAX_COMPONENT_LEN+1
+
+bool getNextPathComponent(char *path, unsigned int *p_offset,
+			  char *buffer) {
+  /*
+
+    Parse individual path components from a path.
+
+      e.g. after repeated calls '/foo/bar/baz' will be split
+           into 'foo', 'bar', 'baz'.
+
+    This is similar to `strtok()` but copies the component into the
+    supplied buffer rather than modifying the original string.
+
+
+    `buffer` needs to be PATH_COMPONENT_BUFFER_LEN in size.
+
+    `p_offset` needs to point to an integer of the offset at
+    which the previous path component finished.
+
+    Returns `true` if more components remain.
+
+    Returns `false` if this is the last component.
+      (This means path ended with 'foo' or 'foo/'.)
+
+   */
+
+  // TODO: Have buffer local to this function, so we know it's the
+  //       correct length?
+
+  int bufferOffset = 0;
+
+  int offset = *p_offset;
+
+  // Skip root or other separator
+  if (path[offset] == '/') {
+    offset++;
+  }
+  
+  // Copy the next next path segment
+  while (bufferOffset < MAX_COMPONENT_LEN
+	 && (path[offset] != '/')
+	 && (path[offset] != '\0')) {
+    buffer[bufferOffset++] = path[offset++];
+  }
+
+  buffer[bufferOffset] = '\0';
+
+  // Skip trailing separator so we can determine if this
+  // is the last component in the path or not.
+  if (path[offset] == '/') {
+    offset++;
+  }
+
+  *p_offset = offset;
+
+  return (path[offset] != '\0');
+}
+
+
+
+boolean walkPath(char *filepath, SdFile& parentDir,
+		 boolean (*callback)(SdFile& parentDir,
+				     char *filePathComponent,
+				     boolean isLastComponent,
+				     void *object),
+		 void *object = NULL) {
+  /*
+     
+     When given a file path (and parent directory--normally root),
+     this function traverses the directories in the path and at each
+     level calls the supplied callback function while also providing
+     the supplied object for context if required.
+
+       e.g. given the path '/foo/bar/baz'
+            the callback would be called at the equivalent of
+	    '/foo', '/foo/bar' and '/foo/bar/baz'.
+
+     The implementation swaps between two different directory/file
+     handles as it traverses the directories and does not use recursion
+     in an attempt to use memory efficiently.
+
+     If a callback wishes to stop the directory traversal it should
+     return false--in this case the function will stop the traversal,
+     tidy up and return false.
+
+     If a directory path doesn't exist at some point this function will
+     also return false and not subsequently call the callback.
+
+     If a directory path specified is complete, valid and the callback
+     did not indicate the traversal should be interrupted then this
+     function will return true.
+
+   */
+
+
+  SdFile subfile1;
+  SdFile subfile2;
+
+  char buffer[PATH_COMPONENT_BUFFER_LEN]; 
+
+  unsigned int offset = 0;
+
+  SdFile *p_parent;
+  SdFile *p_child;
+
+  SdFile *p_tmp_sdfile;  
+  
+  p_child = &subfile1;
+  
+  p_parent = &parentDir;
+
+  while (true) {
+
+    boolean moreComponents = getNextPathComponent(filepath, &offset, buffer);
+
+    boolean shouldContinue = callback((*p_parent), buffer, !moreComponents, object);
+
+    if (!shouldContinue) {
+      // TODO: Don't repeat this code?
+      // If it's one we've created then we
+      // don't need the parent handle anymore.
+      if (p_parent != &parentDir) {
+        (*p_parent).close();
+      }
+      return false;
+    }
+    
+    if (!moreComponents) {
+      break;
+    }
+    
+    boolean exists = (*p_child).open(*p_parent, buffer, O_RDONLY);
+
+    // If it's one we've created then we
+    // don't need the parent handle anymore.
+    if (p_parent != &parentDir) {
+      (*p_parent).close();
+    }
+    
+    // Handle case when it doesn't exist and we can't continue...
+    if (exists) {
+      // We alternate between two file handles as we go down
+      // the path.
+      if (p_parent == &parentDir) {
+        p_parent = &subfile2;
+      }
+
+      p_tmp_sdfile = p_parent;
+      p_parent = p_child;
+      p_child = p_tmp_sdfile;
+    } else {
+      return false;
+    }
+  }
+  
+  if (p_parent != &parentDir) {
+    (*p_parent).close(); // TODO: Return/ handle different?
+  }
+
+  return true;
+}
+
+
+
+/*
+
+   The callbacks used to implement various functionality follow.
+
+   Each callback is supplied with a parent directory handle,
+   character string with the name of the current file path component,
+   a flag indicating if this component is the last in the path and
+   a pointer to an arbitrary object used for context.
+
+ */
+
+boolean callback_pathExists(SdFile& parentDir, char *filePathComponent, 
+			    boolean isLastComponent, void *object) {
+  /*
+
+    Callback used to determine if a file/directory exists in parent
+    directory.
+
+    Returns true if file path exists.
+
+  */
+  SdFile child;
+
+  boolean exists = child.open(parentDir, filePathComponent, O_RDONLY);
+  
+  if (exists) {
+     child.close(); 
+  }
+  
+  return exists;
+}
+
+
+
+boolean callback_makeDirPath(SdFile& parentDir, char *filePathComponent, 
+			     boolean isLastComponent, void *object) {
+  /*
+
+    Callback used to create a directory in the parent directory if
+    it does not already exist.
+
+    Returns true if a directory was created or it already existed.
+
+  */
+  boolean result = false;
+  SdFile child;
+  
+  result = callback_pathExists(parentDir, filePathComponent, isLastComponent, object);
+  if (!result) {
+    result = child.makeDir(parentDir, filePathComponent);
+  } 
+  
+  return result;
+}
+
+
+  /*
+
+boolean callback_openPath(SdFile& parentDir, char *filePathComponent, 
+			  boolean isLastComponent, void *object) {
+
+    Callback used to open a file specified by a filepath that may
+    specify one or more directories above it.
+
+    Expects the context object to be an instance of `SDClass` and
+    will use the `file` property of the instance to open the requested
+    file/directory with the associated file open mode property.
+
+    Always returns true if the directory traversal hasn't reached the
+    bottom of the directory heirarchy.
+
+    Returns false once the file has been opened--to prevent the traversal
+    from descending further. (This may be unnecessary.)
+
+  if (isLastComponent) {
+    SDClass *p_SD = static_cast<SDClass*>(object);
+    p_SD->file.open(parentDir, filePathComponent, p_SD->fileOpenMode);
+    if (p_SD->fileOpenMode == FILE_WRITE) {
+      p_SD->file.seekSet(p_SD->file.fileSize());
+    }
+    // TODO: Return file open result?
+    return false;
+  }
+  return true;
+}
+  */
+
+
+
+boolean callback_remove(SdFile& parentDir, char *filePathComponent, 
+			boolean isLastComponent, void *object) {
+  if (isLastComponent) {
+    return SdFile::remove(parentDir, filePathComponent);
+  }
+  return true;
+}
+
+boolean callback_rmdir(SdFile& parentDir, char *filePathComponent, 
+			boolean isLastComponent, void *object) {
+  if (isLastComponent) {
+    SdFile f;
+    if (!f.open(parentDir, filePathComponent, O_READ)) return false;
+    return f.rmDir();
+  }
+  return true;
+}
+
+
+
+/* Implementation of class used to create `SDCard` object. */
+
+
+
+boolean SDClass::begin(uint8_t csPin) {
+  /*
+
+    Performs the initialisation required by the sdfatlib library.
+
+    Return true if initialization succeeds, false otherwise.
+
+   */
+  return card.init(SPI_HALF_SPEED, csPin) &&
+         volume.init(card) &&
+         root.openRoot(volume);
+}
+
+
+
+// this little helper is used to traverse paths
+SdFile SDClass::getParentDir(char *filepath, int *index) {
+  // get parent directory
+  SdFile d1 = root; // start with the mostparent, root!
+  SdFile d2;
+
+  // we'll use the pointers to swap between the two objects
+  SdFile *parent = &d1;
+  SdFile *subdir = &d2;
+  
+  char *origpath = filepath;
+
+  while (strchr(filepath, '/')) {
+
+    // get rid of leading /'s
+    if (filepath[0] == '/') {
+      filepath++;
+      continue;
+    }
+    
+    if (! strchr(filepath, '/')) {
+      // it was in the root directory, so leave now
+      break;
+    }
+
+    // extract just the name of the next subdirectory
+    uint8_t idx = strchr(filepath, '/') - filepath;
+    if (idx > 12)
+      idx = 12;    // dont let them specify long names
+    char subdirname[13];
+    strncpy(subdirname, filepath, idx);
+    subdirname[idx] = 0;
+
+    // close the subdir (we reuse them) if open
+    subdir->close();
+    if (! subdir->open(parent, subdirname, O_READ)) {
+      // failed to open one of the subdirectories
+      return SdFile();
+    }
+    // move forward to the next subdirectory
+    filepath += idx;
+
+    // we reuse the objects, close it.
+    parent->close();
+
+    // swap the pointers
+    SdFile *t = parent;
+    parent = subdir;
+    subdir = t;
+  }
+
+  *index = (int)(filepath - origpath);
+  // parent is now the parent diretory of the file!
+  return *parent;
+}
+
+
+File SDClass::open(char *filepath, uint8_t mode) {
+  /*
+
+     Open the supplied file path for reading or writing.
+
+     The file content can be accessed via the `file` property of
+     the `SDClass` object--this property is currently
+     a standard `SdFile` object from `sdfatlib`.
+
+     Defaults to read only.
+
+     If `write` is true, default action (when `append` is true) is to
+     append data to the end of the file.
+
+     If `append` is false then the file will be truncated first.
+
+     If the file does not exist and it is opened for writing the file
+     will be created.
+
+     An attempt to open a file for reading that does not exist is an
+     error.
+
+   */
+
+  int pathidx;
+
+  // do the interative search
+  SdFile parentdir = getParentDir(filepath, &pathidx);
+  // no more subdirs!
+
+  filepath += pathidx;
+
+  if (! filepath[0]) {
+    // it was the directory itself!
+    return File(parentdir, "/");
+  }
+
+  // Open the file itself
+  SdFile file;
+
+  // failed to open a subdir!
+  if (!parentdir.isOpen())
+    return File();
+
+  // there is a special case for the Root directory since its a static dir
+  if (parentdir.isRoot()) {
+    if ( ! file.open(SD.root, filepath, mode)) {
+      // failed to open the file :(
+      return File();
+    }
+    // dont close the root!
+  } else {
+    if ( ! file.open(parentdir, filepath, mode)) {
+      return File();
+    }
+    // close the parent
+    parentdir.close();
+  }
+
+  if (mode & (O_APPEND | O_WRITE)) 
+    file.seekSet(file.fileSize());
+  return File(file, filepath);
+}
+
+
+/*
+File SDClass::open(char *filepath, uint8_t mode) {
+  //
+
+     Open the supplied file path for reading or writing.
+
+     The file content can be accessed via the `file` property of
+     the `SDClass` object--this property is currently
+     a standard `SdFile` object from `sdfatlib`.
+
+     Defaults to read only.
+
+     If `write` is true, default action (when `append` is true) is to
+     append data to the end of the file.
+
+     If `append` is false then the file will be truncated first.
+
+     If the file does not exist and it is opened for writing the file
+     will be created.
+
+     An attempt to open a file for reading that does not exist is an
+     error.
+
+   //
+
+  // TODO: Allow for read&write? (Possibly not, as it requires seek.)
+
+  fileOpenMode = mode;
+  walkPath(filepath, root, callback_openPath, this);
+
+  return File();
+
+}
+*/
+
+
+//boolean SDClass::close() {
+//  /*
+//
+//    Closes the file opened by the `open` method.
+//
+//   */
+//  file.close();
+//}
+
+
+boolean SDClass::exists(char *filepath) {
+  /*
+
+     Returns true if the supplied file path exists.
+
+   */
+  return walkPath(filepath, root, callback_pathExists);
+}
+
+
+//boolean SDClass::exists(char *filepath, SdFile& parentDir) {
+//  /*
+//
+//     Returns true if the supplied file path rooted at `parentDir`
+//     exists.
+//
+//   */
+//  return walkPath(filepath, parentDir, callback_pathExists);
+//}
+
+
+boolean SDClass::mkdir(char *filepath) {
+  /*
+  
+    Makes a single directory or a heirarchy of directories.
+
+    A rough equivalent to `mkdir -p`.
+  
+   */
+  return walkPath(filepath, root, callback_makeDirPath);
+}
+
+boolean SDClass::rmdir(char *filepath) {
+  /*
+  
+    Makes a single directory or a heirarchy of directories.
+
+    A rough equivalent to `mkdir -p`.
+  
+   */
+  return walkPath(filepath, root, callback_rmdir);
+}
+
+boolean SDClass::remove(char *filepath) {
+  return walkPath(filepath, root, callback_remove);
+}
+
+
+// allows you to recurse into a directory
+File File::openNextFile(uint8_t mode) {
+  dir_t p;
+
+  //Serial.print("\t\treading dir...");
+  while (_file->readDir(&p) > 0) {
+
+    // done if past last used entry
+    if (p.name[0] == DIR_NAME_FREE) {
+      //Serial.println("end");
+      return File();
+    }
+
+    // skip deleted entry and entries for . and  ..
+    if (p.name[0] == DIR_NAME_DELETED || p.name[0] == '.') {
+      //Serial.println("dots");
+      continue;
+    }
+
+    // only list subdirectories and files
+    if (!DIR_IS_FILE_OR_SUBDIR(&p)) {
+      //Serial.println("notafile");
+      continue;
+    }
+
+    // print file name with possible blank fill
+    SdFile f;
+    char name[13];
+    _file->dirName(p, name);
+    //Serial.print("try to open file ");
+    //Serial.println(name);
+
+    if (f.open(_file, name, mode)) {
+      //Serial.println("OK!");
+      return File(f, name);    
+    } else {
+      //Serial.println("ugh");
+      return File();
+    }
+  }
+
+  //Serial.println("nothing");
+  return File();
+}
+
+void File::rewindDirectory(void) {  
+  if (isDirectory())
+    _file->rewind();
+}
+
+SDClass SD;
diff --git a/libraries/SD/SD.h b/libraries/SD/SD.h
new file mode 100644
index 0000000..584e2ae
--- /dev/null
+++ b/libraries/SD/SD.h
@@ -0,0 +1,102 @@
+/*
+
+ SD - a slightly more friendly wrapper for sdfatlib
+
+ This library aims to expose a subset of SD card functionality
+ in the form of a higher level "wrapper" object.
+
+ License: GNU General Public License V3
+          (Because sdfatlib is licensed with this.)
+
+ (C) Copyright 2010 SparkFun Electronics
+
+ */
+
+#ifndef __SD_H__
+#define __SD_H__
+
+#include <Arduino.h>
+
+#include <utility/SdFat.h>
+#include <utility/SdFatUtil.h>
+
+#define FILE_READ O_READ
+#define FILE_WRITE (O_READ | O_WRITE | O_CREAT)
+
+class File : public Stream {
+ private:
+  char _name[13]; // our name
+  SdFile *_file;  // underlying file pointer
+
+public:
+  File(SdFile f, char *name);     // wraps an underlying SdFile
+  File(void);      // 'empty' constructor
+  ~File(void);     // destructor
+  virtual void write(uint8_t);
+  virtual void write(const char *str);
+  virtual void write(const uint8_t *buf, size_t size);
+  virtual int read();
+  virtual int peek();
+  virtual int available();
+  virtual void flush();
+  int read(void *buf, uint16_t nbyte);
+  boolean seek(uint32_t pos);
+  uint32_t position();
+  uint32_t size();
+  void close();
+  operator bool();
+  char * name();
+
+  boolean isDirectory(void);
+  File openNextFile(uint8_t mode = O_RDONLY);
+  void rewindDirectory(void);
+};
+
+class SDClass {
+
+private:
+  // These are required for initialisation and use of sdfatlib
+  Sd2Card card;
+  SdVolume volume;
+  SdFile root;
+  
+  // my quick&dirty iterator, should be replaced
+  SdFile getParentDir(char *filepath, int *indx);
+public:
+  // This needs to be called to set up the connection to the SD card
+  // before other methods are used.
+  boolean begin(uint8_t csPin = SD_CHIP_SELECT_PIN);
+  
+  // Open the specified file/directory with the supplied mode (e.g. read or
+  // write, etc). Returns a File object for interacting with the file.
+  // Note that currently only one file can be open at a time.
+  File open(char *filename, uint8_t mode = FILE_READ);
+
+  // Methods to determine if the requested file path exists.
+  boolean exists(char *filepath);
+
+  // Create the requested directory heirarchy--if intermediate directories
+  // do not exist they will be created.
+  boolean mkdir(char *filepath);
+  
+  // Delete the file.
+  boolean remove(char *filepath);
+  
+  boolean rmdir(char *filepath);
+
+private:
+
+  // This is used to determine the mode used to open a file
+  // it's here because it's the easiest place to pass the 
+  // information through the directory walking function. But
+  // it's probably not the best place for it.
+  // It shouldn't be set directly--it is set via the parameters to `open`.
+  int fileOpenMode;
+  
+  friend class File;
+  friend boolean callback_openPath(SdFile&, char *, boolean, void *); 
+};
+
+extern SDClass SD;
+
+#endif
diff --git a/libraries/SD/examples/CardInfo/CardInfo.pde b/libraries/SD/examples/CardInfo/CardInfo.pde
new file mode 100644
index 0000000..7abfd33
--- /dev/null
+++ b/libraries/SD/examples/CardInfo/CardInfo.pde
@@ -0,0 +1,111 @@
+/*
+  SD card test 
+   
+ This example shows how use the utility libraries on which the'
+ SD library is based in order to get info about your SD card.
+ Very useful for testing a card when you're not sure whether its working or not.
+ 	
+ The circuit:
+  * SD card attached to SPI bus as follows:
+ ** MOSI - pin 11 on Arduino Uno/Duemilanove/Diecimila
+ ** MISO - pin 12 on Arduino Uno/Duemilanove/Diecimila
+ ** CLK - pin 13 on Arduino Uno/Duemilanove/Diecimila
+ ** CS - depends on your SD card shield or module. 
+ 		Pin 4 used here for consistency with other Arduino examples
+
+ 
+ created  28 Mar 2011
+ by Limor Fried 
+ modified 16 Mar 2011
+ by Tom Igoe
+ */
+ // include the SD library:
+#include <SD.h>
+
+// set up variables using the SD utility library functions:
+Sd2Card card;
+SdVolume volume;
+SdFile root;
+
+// change this to match your SD shield or module;
+// Arduino Ethernet shield: pin 4
+// Adafruit SD shields and modules: pin 10
+// Sparkfun SD shield: pin 8
+const int chipSelect = 4;    
+
+void setup()
+{
+  Serial.begin(9600);
+  Serial.print("\nInitializing SD card...");
+  // On the Ethernet Shield, CS is pin 4. It's set as an output by default.
+  // Note that even if it's not used as the CS pin, the hardware SS pin 
+  // (10 on most Arduino boards, 53 on the Mega) must be left as an output 
+  // or the SD library functions will not work. 
+  pinMode(10, OUTPUT);     // change this to 53 on a mega
+
+
+  // we'll use the initialization code from the utility libraries
+  // since we're just testing if the card is working!
+  if (!card.init(SPI_HALF_SPEED, chipSelect)) {
+    Serial.println("initialization failed. Things to check:");
+    Serial.println("* is a card is inserted?");
+    Serial.println("* Is your wiring correct?");
+    Serial.println("* did you change the chipSelect pin to match your shield or module?");
+    return;
+  } else {
+   Serial.println("Wiring is correct and a card is present."); 
+  }
+
+  // print the type of card
+  Serial.print("\nCard type: ");
+  switch(card.type()) {
+    case SD_CARD_TYPE_SD1:
+      Serial.println("SD1");
+      break;
+    case SD_CARD_TYPE_SD2:
+      Serial.println("SD2");
+      break;
+    case SD_CARD_TYPE_SDHC:
+      Serial.println("SDHC");
+      break;
+    default:
+      Serial.println("Unknown");
+  }
+
+  // Now we will try to open the 'volume'/'partition' - it should be FAT16 or FAT32
+  if (!volume.init(card)) {
+    Serial.println("Could not find FAT16/FAT32 partition.\nMake sure you've formatted the card");
+    return;
+  }
+
+
+  // print the type and size of the first FAT-type volume
+  long volumesize;
+  Serial.print("\nVolume type is FAT");
+  Serial.println(volume.fatType(), DEC);
+  Serial.println();
+  
+  volumesize = volume.blocksPerCluster();    // clusters are collections of blocks
+  volumesize *= volume.clusterCount();       // we'll have a lot of clusters
+  volumesize *= 512;                            // SD card blocks are always 512 bytes
+  Serial.print("Volume size (bytes): ");
+  Serial.println(volumesize);
+  Serial.print("Volume size (Kbytes): ");
+  volumesize /= 1024;
+  Serial.println(volumesize);
+  Serial.print("Volume size (Mbytes): ");
+  volumesize /= 1024;
+  Serial.println(volumesize);
+
+  
+  Serial.println("\nFiles found on the card (name, date and size in bytes): ");
+  root.openRoot(volume);
+  
+  // list all files in the card with date and size
+  root.ls(LS_R | LS_DATE | LS_SIZE);
+}
+
+
+void loop(void) {
+  
+}
diff --git a/libraries/SD/examples/Datalogger/Datalogger.pde b/libraries/SD/examples/Datalogger/Datalogger.pde
new file mode 100644
index 0000000..73d81af
--- /dev/null
+++ b/libraries/SD/examples/Datalogger/Datalogger.pde
@@ -0,0 +1,86 @@
+/*
+  SD card datalogger
+ 
+ This example shows how to log data from three analog sensors 
+ to an SD card using the SD library.
+ 	
+ The circuit:
+ * analog sensors on analog ins 0, 1, and 2
+ * SD card attached to SPI bus as follows:
+ ** MOSI - pin 11
+ ** MISO - pin 12
+ ** CLK - pin 13
+ ** CS - pin 4
+ 
+ created  24 Nov 2010
+ updated 2 Dec 2010
+ by Tom Igoe
+ 
+ This example code is in the public domain.
+ 	 
+ */
+
+#include <SD.h>
+
+// On the Ethernet Shield, CS is pin 4. Note that even if it's not
+// used as the CS pin, the hardware CS pin (10 on most Arduino boards,
+// 53 on the Mega) must be left as an output or the SD library
+// functions will not work.
+const int chipSelect = 4;
+
+void setup()
+{
+  Serial.begin(9600);
+  Serial.print("Initializing SD card...");
+  // make sure that the default chip select pin is set to
+  // output, even if you don't use it:
+  pinMode(10, OUTPUT);
+  
+  // see if the card is present and can be initialized:
+  if (!SD.begin(chipSelect)) {
+    Serial.println("Card failed, or not present");
+    // don't do anything more:
+    return;
+  }
+  Serial.println("card initialized.");
+}
+
+void loop()
+{
+  // make a string for assembling the data to log:
+  String dataString = "";
+
+  // read three sensors and append to the string:
+  for (int analogPin = 0; analogPin < 3; analogPin++) {
+    int sensor = analogRead(analogPin);
+    dataString += String(sensor);
+    if (analogPin < 2) {
+      dataString += ","; 
+    }
+  }
+
+  // open the file. note that only one file can be open at a time,
+  // so you have to close this one before opening another.
+  File dataFile = SD.open("datalog.txt", FILE_WRITE);
+
+  // if the file is available, write to it:
+  if (dataFile) {
+    dataFile.println(dataString);
+    dataFile.close();
+    // print to the serial port too:
+    Serial.println(dataString);
+  }  
+  // if the file isn't open, pop up an error:
+  else {
+    Serial.println("error opening datalog.txt");
+  } 
+}
+
+
+
+
+
+
+
+
+
diff --git a/libraries/SD/examples/DumpFile/DumpFile.pde b/libraries/SD/examples/DumpFile/DumpFile.pde
new file mode 100644
index 0000000..961717f
--- /dev/null
+++ b/libraries/SD/examples/DumpFile/DumpFile.pde
@@ -0,0 +1,64 @@
+/*
+  SD card file dump
+ 
+ This example shows how to read a file from the SD card using the
+ SD library and send it over the serial port.
+ 	
+ The circuit:
+ * SD card attached to SPI bus as follows:
+ ** MOSI - pin 11
+ ** MISO - pin 12
+ ** CLK - pin 13
+ ** CS - pin 4
+ 
+ created  22 December 2010
+ 
+ This example code is in the public domain.
+ 	 
+ */
+
+#include <SD.h>
+
+// On the Ethernet Shield, CS is pin 4. Note that even if it's not
+// used as the CS pin, the hardware CS pin (10 on most Arduino boards,
+// 53 on the Mega) must be left as an output or the SD library
+// functions will not work.
+const int chipSelect = 4;
+
+void setup()
+{
+  Serial.begin(9600);
+  Serial.print("Initializing SD card...");
+  // make sure that the default chip select pin is set to
+  // output, even if you don't use it:
+  pinMode(10, OUTPUT);
+  
+  // see if the card is present and can be initialized:
+  if (!SD.begin(chipSelect)) {
+    Serial.println("Card failed, or not present");
+    // don't do anything more:
+    return;
+  }
+  Serial.println("card initialized.");
+  
+  // open the file. note that only one file can be open at a time,
+  // so you have to close this one before opening another.
+  File dataFile = SD.open("datalog.txt");
+
+  // if the file is available, write to it:
+  if (dataFile) {
+    while (dataFile.available()) {
+      Serial.write(dataFile.read());
+    }
+    dataFile.close();
+  }  
+  // if the file isn't open, pop up an error:
+  else {
+    Serial.println("error opening datalog.txt");
+  } 
+}
+
+void loop()
+{
+}
+
diff --git a/libraries/SD/examples/Files/Files.pde b/libraries/SD/examples/Files/Files.pde
new file mode 100644
index 0000000..5ed9fea
--- /dev/null
+++ b/libraries/SD/examples/Files/Files.pde
@@ -0,0 +1,78 @@
+/*
+  SD card basic file example
+ 
+ This example shows how to create and destroy an SD card file 	
+ The circuit:
+ * SD card attached to SPI bus as follows:
+ ** MOSI - pin 11
+ ** MISO - pin 12
+ ** CLK - pin 13
+ ** CS - pin 4
+ 
+ created   Nov 2010
+ by David A. Mellis
+ updated 2 Dec 2010
+ by Tom Igoe
+ 
+ This example code is in the public domain.
+ 	 
+ */
+#include <SD.h>
+
+File myFile;
+
+void setup()
+{
+  Serial.begin(9600);
+  Serial.print("Initializing SD card...");
+  // On the Ethernet Shield, CS is pin 4. It's set as an output by default.
+  // Note that even if it's not used as the CS pin, the hardware SS pin 
+  // (10 on most Arduino boards, 53 on the Mega) must be left as an output 
+  // or the SD library functions will not work. 
+  pinMode(10, OUTPUT);
+
+  if (!SD.begin(4)) {
+    Serial.println("initialization failed!");
+    return;
+  }
+  Serial.println("initialization done.");
+
+  if (SD.exists("example.txt")) {
+    Serial.println("example.txt exists.");
+  }
+  else {
+    Serial.println("example.txt doesn't exist.");
+  }
+
+  // open a new file and immediately close it:
+  Serial.println("Creating example.txt...");
+  myFile = SD.open("example.txt", FILE_WRITE);
+  myFile.close();
+
+  // Check to see if the file exists: 
+  if (SD.exists("example.txt")) {
+    Serial.println("example.txt exists.");
+  }
+  else {
+    Serial.println("example.txt doesn't exist.");  
+  }
+
+  // delete the file:
+  Serial.println("Removing example.txt...");
+  SD.remove("example.txt");
+
+  if (SD.exists("example.txt")){ 
+    Serial.println("example.txt exists.");
+  }
+  else {
+    Serial.println("example.txt doesn't exist.");  
+  }
+}
+
+void loop()
+{
+  // nothing happens after setup finishes.
+}
+
+
+
diff --git a/libraries/SD/examples/ReadWrite/ReadWrite.pde b/libraries/SD/examples/ReadWrite/ReadWrite.pde
new file mode 100644
index 0000000..9957218
--- /dev/null
+++ b/libraries/SD/examples/ReadWrite/ReadWrite.pde
@@ -0,0 +1,79 @@
+/*
+  SD card read/write
+ 
+ This example shows how to read and write data to and from an SD card file 	
+ The circuit:
+ * SD card attached to SPI bus as follows:
+ ** MOSI - pin 11
+ ** MISO - pin 12
+ ** CLK - pin 13
+ ** CS - pin 4
+ 
+ created   Nov 2010
+ by David A. Mellis
+ updated 2 Dec 2010
+ by Tom Igoe
+ 
+ This example code is in the public domain.
+ 	 
+ */
+ 
+#include <SD.h>
+
+File myFile;
+
+void setup()
+{
+  Serial.begin(9600);
+  Serial.print("Initializing SD card...");
+  // On the Ethernet Shield, CS is pin 4. It's set as an output by default.
+  // Note that even if it's not used as the CS pin, the hardware SS pin 
+  // (10 on most Arduino boards, 53 on the Mega) must be left as an output 
+  // or the SD library functions will not work. 
+   pinMode(10, OUTPUT);
+   
+  if (!SD.begin(4)) {
+    Serial.println("initialization failed!");
+    return;
+  }
+  Serial.println("initialization done.");
+  
+  // open the file. note that only one file can be open at a time,
+  // so you have to close this one before opening another.
+  myFile = SD.open("test.txt", FILE_WRITE);
+  
+  // if the file opened okay, write to it:
+  if (myFile) {
+    Serial.print("Writing to test.txt...");
+    myFile.println("testing 1, 2, 3.");
+	// close the file:
+    myFile.close();
+    Serial.println("done.");
+  } else {
+    // if the file didn't open, print an error:
+    Serial.println("error opening test.txt");
+  }
+  
+  // re-open the file for reading:
+  myFile = SD.open("test.txt");
+  if (myFile) {
+    Serial.println("test.txt:");
+    
+    // read from the file until there's nothing else in it:
+    while (myFile.available()) {
+    	Serial.write(myFile.read());
+    }
+    // close the file:
+    myFile.close();
+  } else {
+  	// if the file didn't open, print an error:
+    Serial.println("error opening test.txt");
+  }
+}
+
+void loop()
+{
+	// nothing happens after setup
+}
+
+
diff --git a/libraries/SD/examples/listfiles/listfiles.pde b/libraries/SD/examples/listfiles/listfiles.pde
new file mode 100644
index 0000000..b2435a2
--- /dev/null
+++ b/libraries/SD/examples/listfiles/listfiles.pde
@@ -0,0 +1,77 @@
+/*
+  SD card basic file example
+ 
+ This example shows how to create and destroy an SD card file 	
+ The circuit:
+ * SD card attached to SPI bus as follows:
+ ** MOSI - pin 11
+ ** MISO - pin 12
+ ** CLK - pin 13
+ ** CS - pin 4
+ 
+ created   Nov 2010
+ by David A. Mellis
+ updated 2 Dec 2010
+ by Tom Igoe
+ 
+ This example code is in the public domain.
+ 	 
+ */
+#include <SD.h>
+
+File root;
+
+void setup()
+{
+  Serial.begin(9600);
+  Serial.print("Initializing SD card...");
+  // On the Ethernet Shield, CS is pin 4. It's set as an output by default.
+  // Note that even if it's not used as the CS pin, the hardware SS pin 
+  // (10 on most Arduino boards, 53 on the Mega) must be left as an output 
+  // or the SD library functions will not work. 
+  pinMode(10, OUTPUT);
+
+  if (!SD.begin(10)) {
+    Serial.println("initialization failed!");
+    return;
+  }
+  Serial.println("initialization done.");
+
+  root = SD.open("/");
+  
+  printDirectory(root, 0);
+  
+  Serial.println("done!");
+}
+
+void loop()
+{
+  // nothing happens after setup finishes.
+}
+
+void printDirectory(File dir, int numTabs) {
+   while(true) {
+     
+     File entry =  dir.openNextFile();
+     if (! entry) {
+       // no more files
+       //Serial.println("**nomorefiles**");
+       break;
+     }
+     for (uint8_t i=0; i<numTabs; i++) {
+       Serial.print('\t');
+     }
+     Serial.print(entry.name());
+     if (entry.isDirectory()) {
+       Serial.println("/");
+       printDirectory(entry, numTabs+1);
+     } else {
+       // files have sizes, directories do not
+       Serial.print("\t\t");
+       Serial.println(entry.size(), DEC);
+     }
+   }
+}
+
+
+
diff --git a/libraries/SD/keywords.txt b/libraries/SD/keywords.txt
new file mode 100644
index 0000000..419fe04
--- /dev/null
+++ b/libraries/SD/keywords.txt
@@ -0,0 +1,30 @@
+#######################################
+# Syntax Coloring Map SD
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+SD	KEYWORD1
+File	KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+begin	KEYWORD2
+exists	KEYWORD2
+mkdir	KEYWORD2
+remove	KEYWORD2
+rmdir	KEYWORD2
+open	KEYWORD2
+close	KEYWORD2
+seek	KEYWORD2
+position	KEYWORD2
+size	KEYWORD2	
+
+#######################################
+# Constants (LITERAL1)
+#######################################
+FILE_READ	LITERAL1
+FILE_WRITE	LITERAL1
diff --git a/libraries/SD/utility/FatStructs.h b/libraries/SD/utility/FatStructs.h
new file mode 100644
index 0000000..f5bdaa5
--- /dev/null
+++ b/libraries/SD/utility/FatStructs.h
@@ -0,0 +1,418 @@
+/* Arduino SdFat Library

+ * Copyright (C) 2009 by William Greiman

+ *

+ * This file is part of the Arduino SdFat Library

+ *

+ * This Library is free software: you can redistribute it and/or modify

+ * it under the terms of the GNU General Public License as published by

+ * the Free Software Foundation, either version 3 of the License, or

+ * (at your option) any later version.

+ *

+ * This Library is distributed in the hope that it will be useful,

+ * but WITHOUT ANY WARRANTY; without even the implied warranty of

+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+ * GNU General Public License for more details.

+ *

+ * You should have received a copy of the GNU General Public License

+ * along with the Arduino SdFat Library.  If not, see

+ * <http://www.gnu.org/licenses/>.

+ */

+#ifndef FatStructs_h

+#define FatStructs_h

+/**

+ * \file

+ * FAT file structures

+ */

+/*

+ * mostly from Microsoft document fatgen103.doc

+ * http://www.microsoft.com/whdc/system/platform/firmware/fatgen.mspx

+ */

+//------------------------------------------------------------------------------

+/** Value for byte 510 of boot block or MBR */

+uint8_t const BOOTSIG0 = 0X55;

+/** Value for byte 511 of boot block or MBR */

+uint8_t const BOOTSIG1 = 0XAA;

+//------------------------------------------------------------------------------

+/**

+ * \struct partitionTable

+ * \brief MBR partition table entry

+ *

+ * A partition table entry for a MBR formatted storage device.

+ * The MBR partition table has four entries.

+ */

+struct partitionTable {

+          /**

+           * Boot Indicator . Indicates whether the volume is the active

+           * partition.  Legal values include: 0X00. Do not use for booting.

+           * 0X80 Active partition.

+           */

+  uint8_t  boot;

+          /**

+            * Head part of Cylinder-head-sector address of the first block in

+            * the partition. Legal values are 0-255. Only used in old PC BIOS.

+            */

+  uint8_t  beginHead;

+          /**

+           * Sector part of Cylinder-head-sector address of the first block in

+           * the partition. Legal values are 1-63. Only used in old PC BIOS.

+           */

+  unsigned beginSector : 6;

+           /** High bits cylinder for first block in partition. */

+  unsigned beginCylinderHigh : 2;

+          /**

+           * Combine beginCylinderLow with beginCylinderHigh. Legal values

+           * are 0-1023.  Only used in old PC BIOS.

+           */

+  uint8_t  beginCylinderLow;

+          /**

+           * Partition type. See defines that begin with PART_TYPE_ for

+           * some Microsoft partition types.

+           */

+  uint8_t  type;

+          /**

+           * head part of cylinder-head-sector address of the last sector in the

+           * partition.  Legal values are 0-255. Only used in old PC BIOS.

+           */

+  uint8_t  endHead;

+          /**

+           * Sector part of cylinder-head-sector address of the last sector in

+           * the partition.  Legal values are 1-63. Only used in old PC BIOS.

+           */

+  unsigned endSector : 6;

+           /** High bits of end cylinder */

+  unsigned endCylinderHigh : 2;

+          /**

+           * Combine endCylinderLow with endCylinderHigh. Legal values

+           * are 0-1023.  Only used in old PC BIOS.

+           */

+  uint8_t  endCylinderLow;

+           /** Logical block address of the first block in the partition. */

+  uint32_t firstSector;

+           /** Length of the partition, in blocks. */

+  uint32_t totalSectors;

+};

+/** Type name for partitionTable */

+typedef struct partitionTable part_t;

+//------------------------------------------------------------------------------

+/**

+ * \struct masterBootRecord

+ *

+ * \brief Master Boot Record

+ *

+ * The first block of a storage device that is formatted with a MBR.

+ */

+struct masterBootRecord {

+           /** Code Area for master boot program. */

+  uint8_t  codeArea[440];

+           /** Optional WindowsNT disk signature. May contain more boot code. */

+  uint32_t diskSignature;

+           /** Usually zero but may be more boot code. */

+  uint16_t usuallyZero;

+           /** Partition tables. */

+  part_t   part[4];

+           /** First MBR signature byte. Must be 0X55 */

+  uint8_t  mbrSig0;

+           /** Second MBR signature byte. Must be 0XAA */

+  uint8_t  mbrSig1;

+};

+/** Type name for masterBootRecord */

+typedef struct masterBootRecord mbr_t;

+//------------------------------------------------------------------------------

+/** 

+ * \struct biosParmBlock

+ *

+ * \brief BIOS parameter block

+ * 

+ *  The BIOS parameter block describes the physical layout of a FAT volume.

+ */

+struct biosParmBlock {

+          /**

+           * Count of bytes per sector. This value may take on only the

+           * following values: 512, 1024, 2048 or 4096

+           */

+  uint16_t bytesPerSector;

+          /**

+           * Number of sectors per allocation unit. This value must be a

+           * power of 2 that is greater than 0. The legal values are

+           * 1, 2, 4, 8, 16, 32, 64, and 128.

+           */

+  uint8_t  sectorsPerCluster;

+          /**

+           * Number of sectors before the first FAT.

+           * This value must not be zero.

+           */

+  uint16_t reservedSectorCount;

+          /** The count of FAT data structures on the volume. This field should

+           *  always contain the value 2 for any FAT volume of any type.

+           */

+  uint8_t  fatCount;

+          /**

+          * For FAT12 and FAT16 volumes, this field contains the count of

+          * 32-byte directory entries in the root directory. For FAT32 volumes,

+          * this field must be set to 0. For FAT12 and FAT16 volumes, this

+          * value should always specify a count that when multiplied by 32

+          * results in a multiple of bytesPerSector.  FAT16 volumes should

+          * use the value 512.

+          */

+  uint16_t rootDirEntryCount;

+          /**

+           * This field is the old 16-bit total count of sectors on the volume.

+           * This count includes the count of all sectors in all four regions

+           * of the volume. This field can be 0; if it is 0, then totalSectors32

+           * must be non-zero.  For FAT32 volumes, this field must be 0. For

+           * FAT12 and FAT16 volumes, this field contains the sector count, and

+           * totalSectors32 is 0 if the total sector count fits

+           * (is less than 0x10000).

+           */

+  uint16_t totalSectors16;

+          /**

+           * This dates back to the old MS-DOS 1.x media determination and is

+           * no longer usually used for anything.  0xF8 is the standard value

+           * for fixed (non-removable) media. For removable media, 0xF0 is

+           * frequently used. Legal values are 0xF0 or 0xF8-0xFF.

+           */

+  uint8_t  mediaType;

+          /**

+           * Count of sectors occupied by one FAT on FAT12/FAT16 volumes.

+           * On FAT32 volumes this field must be 0, and sectorsPerFat32

+           * contains the FAT size count.

+           */

+  uint16_t sectorsPerFat16;

+           /** Sectors per track for interrupt 0x13. Not used otherwise. */

+  uint16_t sectorsPerTrtack;

+           /** Number of heads for interrupt 0x13.  Not used otherwise. */

+  uint16_t headCount;

+          /**

+           * Count of hidden sectors preceding the partition that contains this

+           * FAT volume. This field is generally only relevant for media

+           *  visible on interrupt 0x13.

+           */

+  uint32_t hidddenSectors;

+          /**

+           * This field is the new 32-bit total count of sectors on the volume.

+           * This count includes the count of all sectors in all four regions

+           * of the volume.  This field can be 0; if it is 0, then

+           * totalSectors16 must be non-zero.

+           */

+  uint32_t totalSectors32;

+          /**

+           * Count of sectors occupied by one FAT on FAT32 volumes.

+           */

+  uint32_t sectorsPerFat32;

+          /**

+           * This field is only defined for FAT32 media and does not exist on

+           * FAT12 and FAT16 media.

+           * Bits 0-3 -- Zero-based number of active FAT.

+           *             Only valid if mirroring is disabled.

+           * Bits 4-6 -- Reserved.

+           * Bit 7	-- 0 means the FAT is mirrored at runtime into all FATs.

+	         *        -- 1 means only one FAT is active; it is the one referenced in bits 0-3.

+           * Bits 8-15 	-- Reserved.

+           */

+  uint16_t fat32Flags;

+          /**

+           * FAT32 version. High byte is major revision number.

+           * Low byte is minor revision number. Only 0.0 define.

+           */

+  uint16_t fat32Version;

+          /**

+           * Cluster number of the first cluster of the root directory for FAT32.

+           * This usually 2 but not required to be 2.

+           */

+  uint32_t fat32RootCluster;

+          /**

+           * Sector number of FSINFO structure in the reserved area of the

+           * FAT32 volume. Usually 1.

+           */

+  uint16_t fat32FSInfo;

+          /**

+           * If non-zero, indicates the sector number in the reserved area

+           * of the volume of a copy of the boot record. Usually 6.

+           * No value other than 6 is recommended.

+           */

+  uint16_t fat32BackBootBlock;

+          /**

+           * Reserved for future expansion. Code that formats FAT32 volumes

+           * should always set all of the bytes of this field to 0.

+           */

+  uint8_t  fat32Reserved[12];

+};

+/** Type name for biosParmBlock */

+typedef struct biosParmBlock bpb_t;

+//------------------------------------------------------------------------------

+/**

+ * \struct fat32BootSector

+ *

+ * \brief Boot sector for a FAT16 or FAT32 volume.

+ * 

+ */  

+struct fat32BootSector {

+           /** X86 jmp to boot program */

+  uint8_t  jmpToBootCode[3];

+           /** informational only - don't depend on it */

+  char     oemName[8];

+           /** BIOS Parameter Block */

+  bpb_t    bpb;

+           /** for int0x13 use value 0X80 for hard drive */

+  uint8_t  driveNumber;

+           /** used by Windows NT - should be zero for FAT */

+  uint8_t  reserved1;

+           /** 0X29 if next three fields are valid */

+  uint8_t  bootSignature;

+           /** usually generated by combining date and time */

+  uint32_t volumeSerialNumber;

+           /** should match volume label in root dir */

+  char     volumeLabel[11];

+           /** informational only - don't depend on it */

+  char     fileSystemType[8];

+           /** X86 boot code */

+  uint8_t  bootCode[420];

+           /** must be 0X55 */

+  uint8_t  bootSectorSig0;

+           /** must be 0XAA */

+  uint8_t  bootSectorSig1;

+};

+//------------------------------------------------------------------------------

+// End Of Chain values for FAT entries

+/** FAT16 end of chain value used by Microsoft. */

+uint16_t const FAT16EOC = 0XFFFF;

+/** Minimum value for FAT16 EOC.  Use to test for EOC. */

+uint16_t const FAT16EOC_MIN = 0XFFF8;

+/** FAT32 end of chain value used by Microsoft. */

+uint32_t const FAT32EOC = 0X0FFFFFFF;

+/** Minimum value for FAT32 EOC.  Use to test for EOC. */

+uint32_t const FAT32EOC_MIN = 0X0FFFFFF8;

+/** Mask a for FAT32 entry. Entries are 28 bits. */

+uint32_t const FAT32MASK = 0X0FFFFFFF;

+

+/** Type name for fat32BootSector */

+typedef struct fat32BootSector fbs_t;

+//------------------------------------------------------------------------------

+/**

+ * \struct directoryEntry

+ * \brief FAT short directory entry

+ *

+ * Short means short 8.3 name, not the entry size.

+ *  

+ * Date Format. A FAT directory entry date stamp is a 16-bit field that is 

+ * basically a date relative to the MS-DOS epoch of 01/01/1980. Here is the

+ * format (bit 0 is the LSB of the 16-bit word, bit 15 is the MSB of the 

+ * 16-bit word):

+ *   

+ * Bits 9-15: Count of years from 1980, valid value range 0-127 

+ * inclusive (1980-2107).

+ *   

+ * Bits 5-8: Month of year, 1 = January, valid value range 1-12 inclusive.

+ *

+ * Bits 0-4: Day of month, valid value range 1-31 inclusive.

+ *

+ * Time Format. A FAT directory entry time stamp is a 16-bit field that has

+ * a granularity of 2 seconds. Here is the format (bit 0 is the LSB of the 

+ * 16-bit word, bit 15 is the MSB of the 16-bit word).

+ *   

+ * Bits 11-15: Hours, valid value range 0-23 inclusive.

+ * 

+ * Bits 5-10: Minutes, valid value range 0-59 inclusive.

+ *      

+ * Bits 0-4: 2-second count, valid value range 0-29 inclusive (0 - 58 seconds).

+ *   

+ * The valid time range is from Midnight 00:00:00 to 23:59:58.

+ */

+struct directoryEntry {

+           /**

+            * Short 8.3 name.

+            * The first eight bytes contain the file name with blank fill.

+            * The last three bytes contain the file extension with blank fill.

+            */

+  uint8_t  name[11];

+          /** Entry attributes.

+           *

+           * The upper two bits of the attribute byte are reserved and should

+           * always be set to 0 when a file is created and never modified or

+           * looked at after that.  See defines that begin with DIR_ATT_.

+           */

+  uint8_t  attributes;

+          /**

+           * Reserved for use by Windows NT. Set value to 0 when a file is

+           * created and never modify or look at it after that.

+           */

+  uint8_t  reservedNT;

+          /**

+           * The granularity of the seconds part of creationTime is 2 seconds

+           * so this field is a count of tenths of a second and its valid

+           * value range is 0-199 inclusive. (WHG note - seems to be hundredths)

+           */

+  uint8_t  creationTimeTenths;

+           /** Time file was created. */

+  uint16_t creationTime;

+           /** Date file was created. */

+  uint16_t creationDate;

+          /**

+           * Last access date. Note that there is no last access time, only

+           * a date.  This is the date of last read or write. In the case of

+           * a write, this should be set to the same date as lastWriteDate.

+           */

+  uint16_t lastAccessDate;

+          /**

+           * High word of this entry's first cluster number (always 0 for a

+           * FAT12 or FAT16 volume).

+           */

+  uint16_t firstClusterHigh;

+           /** Time of last write. File creation is considered a write. */

+  uint16_t lastWriteTime;

+           /** Date of last write. File creation is considered a write. */

+  uint16_t lastWriteDate;

+           /** Low word of this entry's first cluster number. */

+  uint16_t firstClusterLow;

+           /** 32-bit unsigned holding this file's size in bytes. */

+  uint32_t fileSize;

+};

+//------------------------------------------------------------------------------

+// Definitions for directory entries

+//

+/** Type name for directoryEntry */

+typedef struct directoryEntry dir_t;

+/** escape for name[0] = 0XE5 */

+uint8_t const DIR_NAME_0XE5 = 0X05;

+/** name[0] value for entry that is free after being "deleted" */

+uint8_t const DIR_NAME_DELETED = 0XE5;

+/** name[0] value for entry that is free and no allocated entries follow */

+uint8_t const DIR_NAME_FREE = 0X00;

+/** file is read-only */

+uint8_t const DIR_ATT_READ_ONLY = 0X01;

+/** File should hidden in directory listings */

+uint8_t const DIR_ATT_HIDDEN = 0X02;

+/** Entry is for a system file */

+uint8_t const DIR_ATT_SYSTEM = 0X04;

+/** Directory entry contains the volume label */

+uint8_t const DIR_ATT_VOLUME_ID = 0X08;

+/** Entry is for a directory */

+uint8_t const DIR_ATT_DIRECTORY = 0X10;

+/** Old DOS archive bit for backup support */

+uint8_t const DIR_ATT_ARCHIVE = 0X20;

+/** Test value for long name entry.  Test is

+  (d->attributes & DIR_ATT_LONG_NAME_MASK) == DIR_ATT_LONG_NAME. */

+uint8_t const DIR_ATT_LONG_NAME = 0X0F;

+/** Test mask for long name entry */

+uint8_t const DIR_ATT_LONG_NAME_MASK = 0X3F;

+/** defined attribute bits */

+uint8_t const DIR_ATT_DEFINED_BITS = 0X3F;

+/** Directory entry is part of a long name */

+static inline uint8_t DIR_IS_LONG_NAME(const dir_t* dir) {

+  return (dir->attributes & DIR_ATT_LONG_NAME_MASK) == DIR_ATT_LONG_NAME;

+}

+/** Mask for file/subdirectory tests */

+uint8_t const DIR_ATT_FILE_TYPE_MASK = (DIR_ATT_VOLUME_ID | DIR_ATT_DIRECTORY);

+/** Directory entry is for a file */

+static inline uint8_t DIR_IS_FILE(const dir_t* dir) {

+  return (dir->attributes & DIR_ATT_FILE_TYPE_MASK) == 0;

+}

+/** Directory entry is for a subdirectory */

+static inline uint8_t DIR_IS_SUBDIR(const dir_t* dir) {

+  return (dir->attributes & DIR_ATT_FILE_TYPE_MASK) == DIR_ATT_DIRECTORY;

+}

+/** Directory entry is for a file or subdirectory */

+static inline uint8_t DIR_IS_FILE_OR_SUBDIR(const dir_t* dir) {

+  return (dir->attributes & DIR_ATT_VOLUME_ID) == 0;

+}

+#endif  // FatStructs_h

diff --git a/libraries/SD/utility/Sd2Card.cpp b/libraries/SD/utility/Sd2Card.cpp
new file mode 100644
index 0000000..361cd0a
--- /dev/null
+++ b/libraries/SD/utility/Sd2Card.cpp
@@ -0,0 +1,644 @@
+/* Arduino Sd2Card Library

+ * Copyright (C) 2009 by William Greiman

+ *

+ * This file is part of the Arduino Sd2Card Library

+ *

+ * This Library is free software: you can redistribute it and/or modify

+ * it under the terms of the GNU General Public License as published by

+ * the Free Software Foundation, either version 3 of the License, or

+ * (at your option) any later version.

+ *

+ * This Library is distributed in the hope that it will be useful,

+ * but WITHOUT ANY WARRANTY; without even the implied warranty of

+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+ * GNU General Public License for more details.

+ *

+ * You should have received a copy of the GNU General Public License

+ * along with the Arduino Sd2Card Library.  If not, see

+ * <http://www.gnu.org/licenses/>.

+ */

+#include <Arduino.h>

+#include "Sd2Card.h"

+//------------------------------------------------------------------------------

+#ifndef SOFTWARE_SPI

+// functions for hardware SPI

+/** Send a byte to the card */

+static void spiSend(uint8_t b) {

+  SPDR = b;

+  while (!(SPSR & (1 << SPIF)));

+}

+/** Receive a byte from the card */

+static  uint8_t spiRec(void) {

+  spiSend(0XFF);

+  return SPDR;

+}

+#else  // SOFTWARE_SPI

+//------------------------------------------------------------------------------

+/** nop to tune soft SPI timing */

+#define nop asm volatile ("nop\n\t")

+//------------------------------------------------------------------------------

+/** Soft SPI receive */

+uint8_t spiRec(void) {

+  uint8_t data = 0;

+  // no interrupts during byte receive - about 8 us

+  cli();

+  // output pin high - like sending 0XFF

+  fastDigitalWrite(SPI_MOSI_PIN, HIGH);

+

+  for (uint8_t i = 0; i < 8; i++) {

+    fastDigitalWrite(SPI_SCK_PIN, HIGH);

+

+    // adjust so SCK is nice

+    nop;

+    nop;

+

+    data <<= 1;

+

+    if (fastDigitalRead(SPI_MISO_PIN)) data |= 1;

+

+    fastDigitalWrite(SPI_SCK_PIN, LOW);

+  }

+  // enable interrupts

+  sei();

+  return data;

+}

+//------------------------------------------------------------------------------

+/** Soft SPI send */

+void spiSend(uint8_t data) {

+  // no interrupts during byte send - about 8 us

+  cli();

+  for (uint8_t i = 0; i < 8; i++) {

+    fastDigitalWrite(SPI_SCK_PIN, LOW);

+

+    fastDigitalWrite(SPI_MOSI_PIN, data & 0X80);

+

+    data <<= 1;

+

+    fastDigitalWrite(SPI_SCK_PIN, HIGH);

+  }

+  // hold SCK high for a few ns

+  nop;

+  nop;

+  nop;

+  nop;

+

+  fastDigitalWrite(SPI_SCK_PIN, LOW);

+  // enable interrupts

+  sei();

+}

+#endif  // SOFTWARE_SPI

+//------------------------------------------------------------------------------

+// send command and return error code.  Return zero for OK

+uint8_t Sd2Card::cardCommand(uint8_t cmd, uint32_t arg) {

+  // end read if in partialBlockRead mode

+  readEnd();

+

+  // select card

+  chipSelectLow();

+

+  // wait up to 300 ms if busy

+  waitNotBusy(300);

+

+  // send command

+  spiSend(cmd | 0x40);

+

+  // send argument

+  for (int8_t s = 24; s >= 0; s -= 8) spiSend(arg >> s);

+

+  // send CRC

+  uint8_t crc = 0XFF;

+  if (cmd == CMD0) crc = 0X95;  // correct crc for CMD0 with arg 0

+  if (cmd == CMD8) crc = 0X87;  // correct crc for CMD8 with arg 0X1AA

+  spiSend(crc);

+

+  // wait for response

+  for (uint8_t i = 0; ((status_ = spiRec()) & 0X80) && i != 0XFF; i++);

+  return status_;

+}

+//------------------------------------------------------------------------------

+/**

+ * Determine the size of an SD flash memory card.

+ *

+ * \return The number of 512 byte data blocks in the card

+ *         or zero if an error occurs.

+ */

+uint32_t Sd2Card::cardSize(void) {

+  csd_t csd;

+  if (!readCSD(&csd)) return 0;

+  if (csd.v1.csd_ver == 0) {

+    uint8_t read_bl_len = csd.v1.read_bl_len;

+    uint16_t c_size = (csd.v1.c_size_high << 10)

+                      | (csd.v1.c_size_mid << 2) | csd.v1.c_size_low;

+    uint8_t c_size_mult = (csd.v1.c_size_mult_high << 1)

+                          | csd.v1.c_size_mult_low;

+    return (uint32_t)(c_size + 1) << (c_size_mult + read_bl_len - 7);

+  } else if (csd.v2.csd_ver == 1) {

+    uint32_t c_size = ((uint32_t)csd.v2.c_size_high << 16)

+                      | (csd.v2.c_size_mid << 8) | csd.v2.c_size_low;

+    return (c_size + 1) << 10;

+  } else {

+    error(SD_CARD_ERROR_BAD_CSD);

+    return 0;

+  }

+}

+//------------------------------------------------------------------------------

+void Sd2Card::chipSelectHigh(void) {

+  digitalWrite(chipSelectPin_, HIGH);

+}

+//------------------------------------------------------------------------------

+void Sd2Card::chipSelectLow(void) {

+  digitalWrite(chipSelectPin_, LOW);

+}

+//------------------------------------------------------------------------------

+/** Erase a range of blocks.

+ *

+ * \param[in] firstBlock The address of the first block in the range.

+ * \param[in] lastBlock The address of the last block in the range.

+ *

+ * \note This function requests the SD card to do a flash erase for a

+ * range of blocks.  The data on the card after an erase operation is

+ * either 0 or 1, depends on the card vendor.  The card must support

+ * single block erase.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ */

+uint8_t Sd2Card::erase(uint32_t firstBlock, uint32_t lastBlock) {

+  if (!eraseSingleBlockEnable()) {

+    error(SD_CARD_ERROR_ERASE_SINGLE_BLOCK);

+    goto fail;

+  }

+  if (type_ != SD_CARD_TYPE_SDHC) {

+    firstBlock <<= 9;

+    lastBlock <<= 9;

+  }

+  if (cardCommand(CMD32, firstBlock)

+    || cardCommand(CMD33, lastBlock)

+    || cardCommand(CMD38, 0)) {

+      error(SD_CARD_ERROR_ERASE);

+      goto fail;

+  }

+  if (!waitNotBusy(SD_ERASE_TIMEOUT)) {

+    error(SD_CARD_ERROR_ERASE_TIMEOUT);

+    goto fail;

+  }

+  chipSelectHigh();

+  return true;

+

+ fail:

+  chipSelectHigh();

+  return false;

+}

+//------------------------------------------------------------------------------

+/** Determine if card supports single block erase.

+ *

+ * \return The value one, true, is returned if single block erase is supported.

+ * The value zero, false, is returned if single block erase is not supported.

+ */

+uint8_t Sd2Card::eraseSingleBlockEnable(void) {

+  csd_t csd;

+  return readCSD(&csd) ? csd.v1.erase_blk_en : 0;

+}

+//------------------------------------------------------------------------------

+/**

+ * Initialize an SD flash memory card.

+ *

+ * \param[in] sckRateID SPI clock rate selector. See setSckRate().

+ * \param[in] chipSelectPin SD chip select pin number.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.  The reason for failure

+ * can be determined by calling errorCode() and errorData().

+ */

+uint8_t Sd2Card::init(uint8_t sckRateID, uint8_t chipSelectPin) {

+  errorCode_ = inBlock_ = partialBlockRead_ = type_ = 0;

+  chipSelectPin_ = chipSelectPin;

+  // 16-bit init start time allows over a minute

+  uint16_t t0 = (uint16_t)millis();

+  uint32_t arg;

+

+  // set pin modes

+  pinMode(chipSelectPin_, OUTPUT);

+  chipSelectHigh();

+  pinMode(SPI_MISO_PIN, INPUT);

+  pinMode(SPI_MOSI_PIN, OUTPUT);

+  pinMode(SPI_SCK_PIN, OUTPUT);

+

+#ifndef SOFTWARE_SPI

+  // SS must be in output mode even it is not chip select

+  pinMode(SS_PIN, OUTPUT);

+  digitalWrite(SS_PIN, HIGH); // disable any SPI device using hardware SS pin

+  // Enable SPI, Master, clock rate f_osc/128

+  SPCR = (1 << SPE) | (1 << MSTR) | (1 << SPR1) | (1 << SPR0);

+  // clear double speed

+  SPSR &= ~(1 << SPI2X);

+#endif  // SOFTWARE_SPI

+

+  // must supply min of 74 clock cycles with CS high.

+  for (uint8_t i = 0; i < 10; i++) spiSend(0XFF);

+

+  chipSelectLow();

+

+  // command to go idle in SPI mode

+  while ((status_ = cardCommand(CMD0, 0)) != R1_IDLE_STATE) {

+    if (((uint16_t)millis() - t0) > SD_INIT_TIMEOUT) {

+      error(SD_CARD_ERROR_CMD0);

+      goto fail;

+    }

+  }

+  // check SD version

+  if ((cardCommand(CMD8, 0x1AA) & R1_ILLEGAL_COMMAND)) {

+    type(SD_CARD_TYPE_SD1);

+  } else {

+    // only need last byte of r7 response

+    for (uint8_t i = 0; i < 4; i++) status_ = spiRec();

+    if (status_ != 0XAA) {

+      error(SD_CARD_ERROR_CMD8);

+      goto fail;

+    }

+    type(SD_CARD_TYPE_SD2);

+  }

+  // initialize card and send host supports SDHC if SD2

+  arg = type() == SD_CARD_TYPE_SD2 ? 0X40000000 : 0;

+

+  while ((status_ = cardAcmd(ACMD41, arg)) != R1_READY_STATE) {

+    // check for timeout

+    if (((uint16_t)millis() - t0) > SD_INIT_TIMEOUT) {

+      error(SD_CARD_ERROR_ACMD41);

+      goto fail;

+    }

+  }

+  // if SD2 read OCR register to check for SDHC card

+  if (type() == SD_CARD_TYPE_SD2) {

+    if (cardCommand(CMD58, 0)) {

+      error(SD_CARD_ERROR_CMD58);

+      goto fail;

+    }

+    if ((spiRec() & 0XC0) == 0XC0) type(SD_CARD_TYPE_SDHC);

+    // discard rest of ocr - contains allowed voltage range

+    for (uint8_t i = 0; i < 3; i++) spiRec();

+  }

+  chipSelectHigh();

+

+#ifndef SOFTWARE_SPI

+  return setSckRate(sckRateID);

+#else  // SOFTWARE_SPI

+  return true;

+#endif  // SOFTWARE_SPI

+

+ fail:

+  chipSelectHigh();

+  return false;

+}

+//------------------------------------------------------------------------------

+/**

+ * Enable or disable partial block reads.

+ *

+ * Enabling partial block reads improves performance by allowing a block

+ * to be read over the SPI bus as several sub-blocks.  Errors may occur

+ * if the time between reads is too long since the SD card may timeout.

+ * The SPI SS line will be held low until the entire block is read or

+ * readEnd() is called.

+ *

+ * Use this for applications like the Adafruit Wave Shield.

+ *

+ * \param[in] value The value TRUE (non-zero) or FALSE (zero).)

+ */

+void Sd2Card::partialBlockRead(uint8_t value) {

+  readEnd();

+  partialBlockRead_ = value;

+}

+//------------------------------------------------------------------------------

+/**

+ * Read a 512 byte block from an SD card device.

+ *

+ * \param[in] block Logical block to be read.

+ * \param[out] dst Pointer to the location that will receive the data.

+

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ */

+uint8_t Sd2Card::readBlock(uint32_t block, uint8_t* dst) {

+  return readData(block, 0, 512, dst);

+}

+//------------------------------------------------------------------------------

+/**

+ * Read part of a 512 byte block from an SD card.

+ *

+ * \param[in] block Logical block to be read.

+ * \param[in] offset Number of bytes to skip at start of block

+ * \param[out] dst Pointer to the location that will receive the data.

+ * \param[in] count Number of bytes to read

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ */

+uint8_t Sd2Card::readData(uint32_t block,

+        uint16_t offset, uint16_t count, uint8_t* dst) {

+  uint16_t n;

+  if (count == 0) return true;

+  if ((count + offset) > 512) {

+    goto fail;

+  }

+  if (!inBlock_ || block != block_ || offset < offset_) {

+    block_ = block;

+    // use address if not SDHC card

+    if (type()!= SD_CARD_TYPE_SDHC) block <<= 9;

+    if (cardCommand(CMD17, block)) {

+      error(SD_CARD_ERROR_CMD17);

+      goto fail;

+    }

+    if (!waitStartBlock()) {

+      goto fail;

+    }

+    offset_ = 0;

+    inBlock_ = 1;

+  }

+

+#ifdef OPTIMIZE_HARDWARE_SPI

+  // start first spi transfer

+  SPDR = 0XFF;

+

+  // skip data before offset

+  for (;offset_ < offset; offset_++) {

+    while (!(SPSR & (1 << SPIF)));

+    SPDR = 0XFF;

+  }

+  // transfer data

+  n = count - 1;

+  for (uint16_t i = 0; i < n; i++) {

+    while (!(SPSR & (1 << SPIF)));

+    dst[i] = SPDR;

+    SPDR = 0XFF;

+  }

+  // wait for last byte

+  while (!(SPSR & (1 << SPIF)));

+  dst[n] = SPDR;

+

+#else  // OPTIMIZE_HARDWARE_SPI

+

+  // skip data before offset

+  for (;offset_ < offset; offset_++) {

+    spiRec();

+  }

+  // transfer data

+  for (uint16_t i = 0; i < count; i++) {

+    dst[i] = spiRec();

+  }

+#endif  // OPTIMIZE_HARDWARE_SPI

+

+  offset_ += count;

+  if (!partialBlockRead_ || offset_ >= 512) {

+    // read rest of data, checksum and set chip select high

+    readEnd();

+  }

+  return true;

+

+ fail:

+  chipSelectHigh();

+  return false;

+}

+//------------------------------------------------------------------------------

+/** Skip remaining data in a block when in partial block read mode. */

+void Sd2Card::readEnd(void) {

+  if (inBlock_) {

+      // skip data and crc

+#ifdef OPTIMIZE_HARDWARE_SPI

+    // optimize skip for hardware

+    SPDR = 0XFF;

+    while (offset_++ < 513) {

+      while (!(SPSR & (1 << SPIF)));

+      SPDR = 0XFF;

+    }

+    // wait for last crc byte

+    while (!(SPSR & (1 << SPIF)));

+#else  // OPTIMIZE_HARDWARE_SPI

+    while (offset_++ < 514) spiRec();

+#endif  // OPTIMIZE_HARDWARE_SPI

+    chipSelectHigh();

+    inBlock_ = 0;

+  }

+}

+//------------------------------------------------------------------------------

+/** read CID or CSR register */

+uint8_t Sd2Card::readRegister(uint8_t cmd, void* buf) {

+  uint8_t* dst = reinterpret_cast<uint8_t*>(buf);

+  if (cardCommand(cmd, 0)) {

+    error(SD_CARD_ERROR_READ_REG);

+    goto fail;

+  }

+  if (!waitStartBlock()) goto fail;

+  // transfer data

+  for (uint16_t i = 0; i < 16; i++) dst[i] = spiRec();

+  spiRec();  // get first crc byte

+  spiRec();  // get second crc byte

+  chipSelectHigh();

+  return true;

+

+ fail:

+  chipSelectHigh();

+  return false;

+}

+//------------------------------------------------------------------------------

+/**

+ * Set the SPI clock rate.

+ *

+ * \param[in] sckRateID A value in the range [0, 6].

+ *

+ * The SPI clock will be set to F_CPU/pow(2, 1 + sckRateID). The maximum

+ * SPI rate is F_CPU/2 for \a sckRateID = 0 and the minimum rate is F_CPU/128

+ * for \a scsRateID = 6.

+ *

+ * \return The value one, true, is returned for success and the value zero,

+ * false, is returned for an invalid value of \a sckRateID.

+ */

+uint8_t Sd2Card::setSckRate(uint8_t sckRateID) {

+  if (sckRateID > 6) {

+    error(SD_CARD_ERROR_SCK_RATE);

+    return false;

+  }

+  // see avr processor datasheet for SPI register bit definitions

+  if ((sckRateID & 1) || sckRateID == 6) {

+    SPSR &= ~(1 << SPI2X);

+  } else {

+    SPSR |= (1 << SPI2X);

+  }

+  SPCR &= ~((1 <<SPR1) | (1 << SPR0));

+  SPCR |= (sckRateID & 4 ? (1 << SPR1) : 0)

+    | (sckRateID & 2 ? (1 << SPR0) : 0);

+  return true;

+}

+//------------------------------------------------------------------------------

+// wait for card to go not busy

+uint8_t Sd2Card::waitNotBusy(uint16_t timeoutMillis) {

+  uint16_t t0 = millis();

+  do {

+    if (spiRec() == 0XFF) return true;

+  }

+  while (((uint16_t)millis() - t0) < timeoutMillis);

+  return false;

+}

+//------------------------------------------------------------------------------

+/** Wait for start block token */

+uint8_t Sd2Card::waitStartBlock(void) {

+  uint16_t t0 = millis();

+  while ((status_ = spiRec()) == 0XFF) {

+    if (((uint16_t)millis() - t0) > SD_READ_TIMEOUT) {

+      error(SD_CARD_ERROR_READ_TIMEOUT);

+      goto fail;

+    }

+  }

+  if (status_ != DATA_START_BLOCK) {

+    error(SD_CARD_ERROR_READ);

+    goto fail;

+  }

+  return true;

+

+ fail:

+  chipSelectHigh();

+  return false;

+}

+//------------------------------------------------------------------------------

+/**

+ * Writes a 512 byte block to an SD card.

+ *

+ * \param[in] blockNumber Logical block to be written.

+ * \param[in] src Pointer to the location of the data to be written.

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ */

+uint8_t Sd2Card::writeBlock(uint32_t blockNumber, const uint8_t* src) {

+#if SD_PROTECT_BLOCK_ZERO

+  // don't allow write to first block

+  if (blockNumber == 0) {

+    error(SD_CARD_ERROR_WRITE_BLOCK_ZERO);

+    goto fail;

+  }

+#endif  // SD_PROTECT_BLOCK_ZERO

+

+  // use address if not SDHC card

+  if (type() != SD_CARD_TYPE_SDHC) blockNumber <<= 9;

+  if (cardCommand(CMD24, blockNumber)) {

+    error(SD_CARD_ERROR_CMD24);

+    goto fail;

+  }

+  if (!writeData(DATA_START_BLOCK, src)) goto fail;

+

+  // wait for flash programming to complete

+  if (!waitNotBusy(SD_WRITE_TIMEOUT)) {

+    error(SD_CARD_ERROR_WRITE_TIMEOUT);

+    goto fail;

+  }

+  // response is r2 so get and check two bytes for nonzero

+  if (cardCommand(CMD13, 0) || spiRec()) {

+    error(SD_CARD_ERROR_WRITE_PROGRAMMING);

+    goto fail;

+  }

+  chipSelectHigh();

+  return true;

+

+ fail:

+  chipSelectHigh();

+  return false;

+}

+//------------------------------------------------------------------------------

+/** Write one data block in a multiple block write sequence */

+uint8_t Sd2Card::writeData(const uint8_t* src) {

+  // wait for previous write to finish

+  if (!waitNotBusy(SD_WRITE_TIMEOUT)) {

+    error(SD_CARD_ERROR_WRITE_MULTIPLE);

+    chipSelectHigh();

+    return false;

+  }

+  return writeData(WRITE_MULTIPLE_TOKEN, src);

+}

+//------------------------------------------------------------------------------

+// send one block of data for write block or write multiple blocks

+uint8_t Sd2Card::writeData(uint8_t token, const uint8_t* src) {

+#ifdef OPTIMIZE_HARDWARE_SPI

+

+  // send data - optimized loop

+  SPDR = token;

+

+  // send two byte per iteration

+  for (uint16_t i = 0; i < 512; i += 2) {

+    while (!(SPSR & (1 << SPIF)));

+    SPDR = src[i];

+    while (!(SPSR & (1 << SPIF)));

+    SPDR = src[i+1];

+  }

+

+  // wait for last data byte

+  while (!(SPSR & (1 << SPIF)));

+

+#else  // OPTIMIZE_HARDWARE_SPI

+  spiSend(token);

+  for (uint16_t i = 0; i < 512; i++) {

+    spiSend(src[i]);

+  }

+#endif  // OPTIMIZE_HARDWARE_SPI

+  spiSend(0xff);  // dummy crc

+  spiSend(0xff);  // dummy crc

+

+  status_ = spiRec();

+  if ((status_ & DATA_RES_MASK) != DATA_RES_ACCEPTED) {

+    error(SD_CARD_ERROR_WRITE);

+    chipSelectHigh();

+    return false;

+  }

+  return true;

+}

+//------------------------------------------------------------------------------

+/** Start a write multiple blocks sequence.

+ *

+ * \param[in] blockNumber Address of first block in sequence.

+ * \param[in] eraseCount The number of blocks to be pre-erased.

+ *

+ * \note This function is used with writeData() and writeStop()

+ * for optimized multiple block writes.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ */

+uint8_t Sd2Card::writeStart(uint32_t blockNumber, uint32_t eraseCount) {

+#if SD_PROTECT_BLOCK_ZERO

+  // don't allow write to first block

+  if (blockNumber == 0) {

+    error(SD_CARD_ERROR_WRITE_BLOCK_ZERO);

+    goto fail;

+  }

+#endif  // SD_PROTECT_BLOCK_ZERO

+  // send pre-erase count

+  if (cardAcmd(ACMD23, eraseCount)) {

+    error(SD_CARD_ERROR_ACMD23);

+    goto fail;

+  }

+  // use address if not SDHC card

+  if (type() != SD_CARD_TYPE_SDHC) blockNumber <<= 9;

+  if (cardCommand(CMD25, blockNumber)) {

+    error(SD_CARD_ERROR_CMD25);

+    goto fail;

+  }

+  return true;

+

+ fail:

+  chipSelectHigh();

+  return false;

+}

+//------------------------------------------------------------------------------

+/** End a write multiple blocks sequence.

+ *

+* \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ */

+uint8_t Sd2Card::writeStop(void) {

+  if (!waitNotBusy(SD_WRITE_TIMEOUT)) goto fail;

+  spiSend(STOP_TRAN_TOKEN);

+  if (!waitNotBusy(SD_WRITE_TIMEOUT)) goto fail;

+  chipSelectHigh();

+  return true;

+

+ fail:

+  error(SD_CARD_ERROR_STOP_TRAN);

+  chipSelectHigh();

+  return false;

+}

diff --git a/libraries/SD/utility/Sd2Card.h b/libraries/SD/utility/Sd2Card.h
new file mode 100644
index 0000000..73b46fb
--- /dev/null
+++ b/libraries/SD/utility/Sd2Card.h
@@ -0,0 +1,233 @@
+/* Arduino Sd2Card Library

+ * Copyright (C) 2009 by William Greiman

+ *

+ * This file is part of the Arduino Sd2Card Library

+ *

+ * This Library is free software: you can redistribute it and/or modify

+ * it under the terms of the GNU General Public License as published by

+ * the Free Software Foundation, either version 3 of the License, or

+ * (at your option) any later version.

+ *

+ * This Library is distributed in the hope that it will be useful,

+ * but WITHOUT ANY WARRANTY; without even the implied warranty of

+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+ * GNU General Public License for more details.

+ *

+ * You should have received a copy of the GNU General Public License

+ * along with the Arduino Sd2Card Library.  If not, see

+ * <http://www.gnu.org/licenses/>.

+ */

+#ifndef Sd2Card_h

+#define Sd2Card_h

+/**

+ * \file

+ * Sd2Card class

+ */

+#include "Sd2PinMap.h"

+#include "SdInfo.h"

+/** Set SCK to max rate of F_CPU/2. See Sd2Card::setSckRate(). */

+uint8_t const SPI_FULL_SPEED = 0;

+/** Set SCK rate to F_CPU/4. See Sd2Card::setSckRate(). */

+uint8_t const SPI_HALF_SPEED = 1;

+/** Set SCK rate to F_CPU/8. Sd2Card::setSckRate(). */

+uint8_t const SPI_QUARTER_SPEED = 2;

+/**

+ * Define MEGA_SOFT_SPI non-zero to use software SPI on Mega Arduinos.

+ * Pins used are SS 10, MOSI 11, MISO 12, and SCK 13.

+ *

+ * MEGA_SOFT_SPI allows an unmodified Adafruit GPS Shield to be used

+ * on Mega Arduinos.  Software SPI works well with GPS Shield V1.1

+ * but many SD cards will fail with GPS Shield V1.0.

+ */

+#define MEGA_SOFT_SPI 0

+//------------------------------------------------------------------------------

+#if MEGA_SOFT_SPI && (defined(__AVR_ATmega1280__)||defined(__AVR_ATmega2560__))

+#define SOFTWARE_SPI

+#endif  // MEGA_SOFT_SPI

+//------------------------------------------------------------------------------

+// SPI pin definitions

+//

+#ifndef SOFTWARE_SPI

+// hardware pin defs

+/**

+ * SD Chip Select pin

+ *

+ * Warning if this pin is redefined the hardware SS will pin will be enabled

+ * as an output by init().  An avr processor will not function as an SPI

+ * master unless SS is set to output mode.

+ */

+/** The default chip select pin for the SD card is SS. */

+uint8_t const  SD_CHIP_SELECT_PIN = SS_PIN;

+// The following three pins must not be redefined for hardware SPI.

+/** SPI Master Out Slave In pin */

+uint8_t const  SPI_MOSI_PIN = MOSI_PIN;

+/** SPI Master In Slave Out pin */

+uint8_t const  SPI_MISO_PIN = MISO_PIN;

+/** SPI Clock pin */

+uint8_t const  SPI_SCK_PIN = SCK_PIN;

+/** optimize loops for hardware SPI */

+#define OPTIMIZE_HARDWARE_SPI

+

+#else  // SOFTWARE_SPI

+// define software SPI pins so Mega can use unmodified GPS Shield

+/** SPI chip select pin */

+uint8_t const SD_CHIP_SELECT_PIN = 10;

+/** SPI Master Out Slave In pin */

+uint8_t const SPI_MOSI_PIN = 11;

+/** SPI Master In Slave Out pin */

+uint8_t const SPI_MISO_PIN = 12;

+/** SPI Clock pin */

+uint8_t const SPI_SCK_PIN = 13;

+#endif  // SOFTWARE_SPI

+//------------------------------------------------------------------------------

+/** Protect block zero from write if nonzero */

+#define SD_PROTECT_BLOCK_ZERO 1

+/** init timeout ms */

+uint16_t const SD_INIT_TIMEOUT = 2000;

+/** erase timeout ms */

+uint16_t const SD_ERASE_TIMEOUT = 10000;

+/** read timeout ms */

+uint16_t const SD_READ_TIMEOUT = 300;

+/** write time out ms */

+uint16_t const SD_WRITE_TIMEOUT = 600;

+//------------------------------------------------------------------------------

+// SD card errors

+/** timeout error for command CMD0 */

+uint8_t const SD_CARD_ERROR_CMD0 = 0X1;

+/** CMD8 was not accepted - not a valid SD card*/

+uint8_t const SD_CARD_ERROR_CMD8 = 0X2;

+/** card returned an error response for CMD17 (read block) */

+uint8_t const SD_CARD_ERROR_CMD17 = 0X3;

+/** card returned an error response for CMD24 (write block) */

+uint8_t const SD_CARD_ERROR_CMD24 = 0X4;

+/**  WRITE_MULTIPLE_BLOCKS command failed */

+uint8_t const SD_CARD_ERROR_CMD25 = 0X05;

+/** card returned an error response for CMD58 (read OCR) */

+uint8_t const SD_CARD_ERROR_CMD58 = 0X06;

+/** SET_WR_BLK_ERASE_COUNT failed */

+uint8_t const SD_CARD_ERROR_ACMD23 = 0X07;

+/** card's ACMD41 initialization process timeout */

+uint8_t const SD_CARD_ERROR_ACMD41 = 0X08;

+/** card returned a bad CSR version field */

+uint8_t const SD_CARD_ERROR_BAD_CSD = 0X09;

+/** erase block group command failed */

+uint8_t const SD_CARD_ERROR_ERASE = 0X0A;

+/** card not capable of single block erase */

+uint8_t const SD_CARD_ERROR_ERASE_SINGLE_BLOCK = 0X0B;

+/** Erase sequence timed out */

+uint8_t const SD_CARD_ERROR_ERASE_TIMEOUT = 0X0C;

+/** card returned an error token instead of read data */

+uint8_t const SD_CARD_ERROR_READ = 0X0D;

+/** read CID or CSD failed */

+uint8_t const SD_CARD_ERROR_READ_REG = 0X0E;

+/** timeout while waiting for start of read data */

+uint8_t const SD_CARD_ERROR_READ_TIMEOUT = 0X0F;

+/** card did not accept STOP_TRAN_TOKEN */

+uint8_t const SD_CARD_ERROR_STOP_TRAN = 0X10;

+/** card returned an error token as a response to a write operation */

+uint8_t const SD_CARD_ERROR_WRITE = 0X11;

+/** attempt to write protected block zero */

+uint8_t const SD_CARD_ERROR_WRITE_BLOCK_ZERO = 0X12;

+/** card did not go ready for a multiple block write */

+uint8_t const SD_CARD_ERROR_WRITE_MULTIPLE = 0X13;

+/** card returned an error to a CMD13 status check after a write */

+uint8_t const SD_CARD_ERROR_WRITE_PROGRAMMING = 0X14;

+/** timeout occurred during write programming */

+uint8_t const SD_CARD_ERROR_WRITE_TIMEOUT = 0X15;

+/** incorrect rate selected */

+uint8_t const SD_CARD_ERROR_SCK_RATE = 0X16;

+//------------------------------------------------------------------------------

+// card types

+/** Standard capacity V1 SD card */

+uint8_t const SD_CARD_TYPE_SD1 = 1;

+/** Standard capacity V2 SD card */

+uint8_t const SD_CARD_TYPE_SD2 = 2;

+/** High Capacity SD card */

+uint8_t const SD_CARD_TYPE_SDHC = 3;

+//------------------------------------------------------------------------------

+/**

+ * \class Sd2Card

+ * \brief Raw access to SD and SDHC flash memory cards.

+ */

+class Sd2Card {

+ public:

+  /** Construct an instance of Sd2Card. */

+  Sd2Card(void) : errorCode_(0), inBlock_(0), partialBlockRead_(0), type_(0) {}

+  uint32_t cardSize(void);

+  uint8_t erase(uint32_t firstBlock, uint32_t lastBlock);

+  uint8_t eraseSingleBlockEnable(void);

+  /**

+   * \return error code for last error. See Sd2Card.h for a list of error codes.

+   */

+  uint8_t errorCode(void) const {return errorCode_;}

+  /** \return error data for last error. */

+  uint8_t errorData(void) const {return status_;}

+  /**

+   * Initialize an SD flash memory card with default clock rate and chip

+   * select pin.  See sd2Card::init(uint8_t sckRateID, uint8_t chipSelectPin).

+   */

+  uint8_t init(void) {

+    return init(SPI_FULL_SPEED, SD_CHIP_SELECT_PIN);

+  }

+  /**

+   * Initialize an SD flash memory card with the selected SPI clock rate

+   * and the default SD chip select pin.

+   * See sd2Card::init(uint8_t sckRateID, uint8_t chipSelectPin).

+   */

+  uint8_t init(uint8_t sckRateID) {

+    return init(sckRateID, SD_CHIP_SELECT_PIN);

+  }

+  uint8_t init(uint8_t sckRateID, uint8_t chipSelectPin);

+  void partialBlockRead(uint8_t value);

+  /** Returns the current value, true or false, for partial block read. */

+  uint8_t partialBlockRead(void) const {return partialBlockRead_;}

+  uint8_t readBlock(uint32_t block, uint8_t* dst);

+  uint8_t readData(uint32_t block,

+          uint16_t offset, uint16_t count, uint8_t* dst);

+  /**

+   * Read a cards CID register. The CID contains card identification

+   * information such as Manufacturer ID, Product name, Product serial

+   * number and Manufacturing date. */

+  uint8_t readCID(cid_t* cid) {

+    return readRegister(CMD10, cid);

+  }

+  /**

+   * Read a cards CSD register. The CSD contains Card-Specific Data that

+   * provides information regarding access to the card's contents. */

+  uint8_t readCSD(csd_t* csd) {

+    return readRegister(CMD9, csd);

+  }

+  void readEnd(void);

+  uint8_t setSckRate(uint8_t sckRateID);

+  /** Return the card type: SD V1, SD V2 or SDHC */

+  uint8_t type(void) const {return type_;}

+  uint8_t writeBlock(uint32_t blockNumber, const uint8_t* src);

+  uint8_t writeData(const uint8_t* src);

+  uint8_t writeStart(uint32_t blockNumber, uint32_t eraseCount);

+  uint8_t writeStop(void);

+ private:

+  uint32_t block_;

+  uint8_t chipSelectPin_;

+  uint8_t errorCode_;

+  uint8_t inBlock_;

+  uint16_t offset_;

+  uint8_t partialBlockRead_;

+  uint8_t status_;

+  uint8_t type_;

+  // private functions

+  uint8_t cardAcmd(uint8_t cmd, uint32_t arg) {

+    cardCommand(CMD55, 0);

+    return cardCommand(cmd, arg);

+  }

+  uint8_t cardCommand(uint8_t cmd, uint32_t arg);

+  void error(uint8_t code) {errorCode_ = code;}

+  uint8_t readRegister(uint8_t cmd, void* buf);

+  uint8_t sendWriteCommand(uint32_t blockNumber, uint32_t eraseCount);

+  void chipSelectHigh(void);

+  void chipSelectLow(void);

+  void type(uint8_t value) {type_ = value;}

+  uint8_t waitNotBusy(uint16_t timeoutMillis);

+  uint8_t writeData(uint8_t token, const uint8_t* src);

+  uint8_t waitStartBlock(void);

+};

+#endif  // Sd2Card_h

diff --git a/libraries/SD/utility/Sd2PinMap.h b/libraries/SD/utility/Sd2PinMap.h
new file mode 100644
index 0000000..4bd75a3
--- /dev/null
+++ b/libraries/SD/utility/Sd2PinMap.h
@@ -0,0 +1,353 @@
+/* Arduino SdFat Library

+ * Copyright (C) 2010 by William Greiman

+ *

+ * This file is part of the Arduino SdFat Library

+ *

+ * This Library is free software: you can redistribute it and/or modify

+ * it under the terms of the GNU General Public License as published by

+ * the Free Software Foundation, either version 3 of the License, or

+ * (at your option) any later version.

+ *

+ * This Library is distributed in the hope that it will be useful,

+ * but WITHOUT ANY WARRANTY; without even the implied warranty of

+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+ * GNU General Public License for more details.

+ *

+ * You should have received a copy of the GNU General Public License

+ * along with the Arduino SdFat Library.  If not, see

+ * <http://www.gnu.org/licenses/>.

+ */

+// Warning this file was generated by a program.

+#ifndef Sd2PinMap_h

+#define Sd2PinMap_h

+#include <avr/io.h>

+

+//------------------------------------------------------------------------------

+/** struct for mapping digital pins */

+struct pin_map_t {

+  volatile uint8_t* ddr;

+  volatile uint8_t* pin;

+  volatile uint8_t* port;

+  uint8_t bit;

+};

+//------------------------------------------------------------------------------

+#if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)

+// Mega

+

+// Two Wire (aka I2C) ports

+uint8_t const SDA_PIN = 20;

+uint8_t const SCL_PIN = 21;

+

+// SPI port

+uint8_t const SS_PIN = 53;

+uint8_t const MOSI_PIN = 51;

+uint8_t const MISO_PIN = 50;

+uint8_t const SCK_PIN = 52;

+

+static const pin_map_t digitalPinMap[] = {

+  {&DDRE, &PINE, &PORTE, 0},  // E0  0

+  {&DDRE, &PINE, &PORTE, 1},  // E1  1

+  {&DDRE, &PINE, &PORTE, 4},  // E4  2

+  {&DDRE, &PINE, &PORTE, 5},  // E5  3

+  {&DDRG, &PING, &PORTG, 5},  // G5  4

+  {&DDRE, &PINE, &PORTE, 3},  // E3  5

+  {&DDRH, &PINH, &PORTH, 3},  // H3  6

+  {&DDRH, &PINH, &PORTH, 4},  // H4  7

+  {&DDRH, &PINH, &PORTH, 5},  // H5  8

+  {&DDRH, &PINH, &PORTH, 6},  // H6  9

+  {&DDRB, &PINB, &PORTB, 4},  // B4 10

+  {&DDRB, &PINB, &PORTB, 5},  // B5 11

+  {&DDRB, &PINB, &PORTB, 6},  // B6 12

+  {&DDRB, &PINB, &PORTB, 7},  // B7 13

+  {&DDRJ, &PINJ, &PORTJ, 1},  // J1 14

+  {&DDRJ, &PINJ, &PORTJ, 0},  // J0 15

+  {&DDRH, &PINH, &PORTH, 1},  // H1 16

+  {&DDRH, &PINH, &PORTH, 0},  // H0 17

+  {&DDRD, &PIND, &PORTD, 3},  // D3 18

+  {&DDRD, &PIND, &PORTD, 2},  // D2 19

+  {&DDRD, &PIND, &PORTD, 1},  // D1 20

+  {&DDRD, &PIND, &PORTD, 0},  // D0 21

+  {&DDRA, &PINA, &PORTA, 0},  // A0 22

+  {&DDRA, &PINA, &PORTA, 1},  // A1 23

+  {&DDRA, &PINA, &PORTA, 2},  // A2 24

+  {&DDRA, &PINA, &PORTA, 3},  // A3 25

+  {&DDRA, &PINA, &PORTA, 4},  // A4 26

+  {&DDRA, &PINA, &PORTA, 5},  // A5 27

+  {&DDRA, &PINA, &PORTA, 6},  // A6 28

+  {&DDRA, &PINA, &PORTA, 7},  // A7 29

+  {&DDRC, &PINC, &PORTC, 7},  // C7 30

+  {&DDRC, &PINC, &PORTC, 6},  // C6 31

+  {&DDRC, &PINC, &PORTC, 5},  // C5 32

+  {&DDRC, &PINC, &PORTC, 4},  // C4 33

+  {&DDRC, &PINC, &PORTC, 3},  // C3 34

+  {&DDRC, &PINC, &PORTC, 2},  // C2 35

+  {&DDRC, &PINC, &PORTC, 1},  // C1 36

+  {&DDRC, &PINC, &PORTC, 0},  // C0 37

+  {&DDRD, &PIND, &PORTD, 7},  // D7 38

+  {&DDRG, &PING, &PORTG, 2},  // G2 39

+  {&DDRG, &PING, &PORTG, 1},  // G1 40

+  {&DDRG, &PING, &PORTG, 0},  // G0 41

+  {&DDRL, &PINL, &PORTL, 7},  // L7 42

+  {&DDRL, &PINL, &PORTL, 6},  // L6 43

+  {&DDRL, &PINL, &PORTL, 5},  // L5 44

+  {&DDRL, &PINL, &PORTL, 4},  // L4 45

+  {&DDRL, &PINL, &PORTL, 3},  // L3 46

+  {&DDRL, &PINL, &PORTL, 2},  // L2 47

+  {&DDRL, &PINL, &PORTL, 1},  // L1 48

+  {&DDRL, &PINL, &PORTL, 0},  // L0 49

+  {&DDRB, &PINB, &PORTB, 3},  // B3 50

+  {&DDRB, &PINB, &PORTB, 2},  // B2 51

+  {&DDRB, &PINB, &PORTB, 1},  // B1 52

+  {&DDRB, &PINB, &PORTB, 0},  // B0 53

+  {&DDRF, &PINF, &PORTF, 0},  // F0 54

+  {&DDRF, &PINF, &PORTF, 1},  // F1 55

+  {&DDRF, &PINF, &PORTF, 2},  // F2 56

+  {&DDRF, &PINF, &PORTF, 3},  // F3 57

+  {&DDRF, &PINF, &PORTF, 4},  // F4 58

+  {&DDRF, &PINF, &PORTF, 5},  // F5 59

+  {&DDRF, &PINF, &PORTF, 6},  // F6 60

+  {&DDRF, &PINF, &PORTF, 7},  // F7 61

+  {&DDRK, &PINK, &PORTK, 0},  // K0 62

+  {&DDRK, &PINK, &PORTK, 1},  // K1 63

+  {&DDRK, &PINK, &PORTK, 2},  // K2 64

+  {&DDRK, &PINK, &PORTK, 3},  // K3 65

+  {&DDRK, &PINK, &PORTK, 4},  // K4 66

+  {&DDRK, &PINK, &PORTK, 5},  // K5 67

+  {&DDRK, &PINK, &PORTK, 6},  // K6 68

+  {&DDRK, &PINK, &PORTK, 7}   // K7 69

+};

+//------------------------------------------------------------------------------

+#elif defined(__AVR_ATmega644P__) || defined(__AVR_ATmega644__)

+// Sanguino

+

+// Two Wire (aka I2C) ports

+uint8_t const SDA_PIN = 17;

+uint8_t const SCL_PIN = 18;

+

+// SPI port

+uint8_t const SS_PIN = 4;

+uint8_t const MOSI_PIN = 5;

+uint8_t const MISO_PIN = 6;

+uint8_t const SCK_PIN = 7;

+

+static const pin_map_t digitalPinMap[] = {

+  {&DDRB, &PINB, &PORTB, 0},  // B0  0

+  {&DDRB, &PINB, &PORTB, 1},  // B1  1

+  {&DDRB, &PINB, &PORTB, 2},  // B2  2

+  {&DDRB, &PINB, &PORTB, 3},  // B3  3

+  {&DDRB, &PINB, &PORTB, 4},  // B4  4

+  {&DDRB, &PINB, &PORTB, 5},  // B5  5

+  {&DDRB, &PINB, &PORTB, 6},  // B6  6

+  {&DDRB, &PINB, &PORTB, 7},  // B7  7

+  {&DDRD, &PIND, &PORTD, 0},  // D0  8

+  {&DDRD, &PIND, &PORTD, 1},  // D1  9

+  {&DDRD, &PIND, &PORTD, 2},  // D2 10

+  {&DDRD, &PIND, &PORTD, 3},  // D3 11

+  {&DDRD, &PIND, &PORTD, 4},  // D4 12

+  {&DDRD, &PIND, &PORTD, 5},  // D5 13

+  {&DDRD, &PIND, &PORTD, 6},  // D6 14

+  {&DDRD, &PIND, &PORTD, 7},  // D7 15

+  {&DDRC, &PINC, &PORTC, 0},  // C0 16

+  {&DDRC, &PINC, &PORTC, 1},  // C1 17

+  {&DDRC, &PINC, &PORTC, 2},  // C2 18

+  {&DDRC, &PINC, &PORTC, 3},  // C3 19

+  {&DDRC, &PINC, &PORTC, 4},  // C4 20

+  {&DDRC, &PINC, &PORTC, 5},  // C5 21

+  {&DDRC, &PINC, &PORTC, 6},  // C6 22

+  {&DDRC, &PINC, &PORTC, 7},  // C7 23

+  {&DDRA, &PINA, &PORTA, 7},  // A7 24

+  {&DDRA, &PINA, &PORTA, 6},  // A6 25

+  {&DDRA, &PINA, &PORTA, 5},  // A5 26

+  {&DDRA, &PINA, &PORTA, 4},  // A4 27

+  {&DDRA, &PINA, &PORTA, 3},  // A3 28

+  {&DDRA, &PINA, &PORTA, 2},  // A2 29

+  {&DDRA, &PINA, &PORTA, 1},  // A1 30

+  {&DDRA, &PINA, &PORTA, 0}   // A0 31

+};

+//------------------------------------------------------------------------------

+#elif defined(__AVR_ATmega32U4__)

+// Teensy 2.0

+

+// Two Wire (aka I2C) ports

+uint8_t const SDA_PIN = 6;

+uint8_t const SCL_PIN = 5;

+

+// SPI port

+uint8_t const SS_PIN = 0;

+uint8_t const MOSI_PIN = 2;

+uint8_t const MISO_PIN = 3;

+uint8_t const SCK_PIN = 1;

+

+static const pin_map_t digitalPinMap[] = {

+  {&DDRB, &PINB, &PORTB, 0},  // B0  0

+  {&DDRB, &PINB, &PORTB, 1},  // B1  1

+  {&DDRB, &PINB, &PORTB, 2},  // B2  2

+  {&DDRB, &PINB, &PORTB, 3},  // B3  3

+  {&DDRB, &PINB, &PORTB, 7},  // B7  4

+  {&DDRD, &PIND, &PORTD, 0},  // D0  5

+  {&DDRD, &PIND, &PORTD, 1},  // D1  6

+  {&DDRD, &PIND, &PORTD, 2},  // D2  7

+  {&DDRD, &PIND, &PORTD, 3},  // D3  8

+  {&DDRC, &PINC, &PORTC, 6},  // C6  9

+  {&DDRC, &PINC, &PORTC, 7},  // C7 10

+  {&DDRD, &PIND, &PORTD, 6},  // D6 11

+  {&DDRD, &PIND, &PORTD, 7},  // D7 12

+  {&DDRB, &PINB, &PORTB, 4},  // B4 13

+  {&DDRB, &PINB, &PORTB, 5},  // B5 14

+  {&DDRB, &PINB, &PORTB, 6},  // B6 15

+  {&DDRF, &PINF, &PORTF, 7},  // F7 16

+  {&DDRF, &PINF, &PORTF, 6},  // F6 17

+  {&DDRF, &PINF, &PORTF, 5},  // F5 18

+  {&DDRF, &PINF, &PORTF, 4},  // F4 19

+  {&DDRF, &PINF, &PORTF, 1},  // F1 20

+  {&DDRF, &PINF, &PORTF, 0},  // F0 21

+  {&DDRD, &PIND, &PORTD, 4},  // D4 22

+  {&DDRD, &PIND, &PORTD, 5},  // D5 23

+  {&DDRE, &PINE, &PORTE, 6}   // E6 24

+};

+//------------------------------------------------------------------------------

+#elif defined(__AVR_AT90USB646__) || defined(__AVR_AT90USB1286__)

+// Teensy++ 1.0 & 2.0

+

+// Two Wire (aka I2C) ports

+uint8_t const SDA_PIN = 1;

+uint8_t const SCL_PIN = 0;

+

+// SPI port

+uint8_t const SS_PIN = 20;

+uint8_t const MOSI_PIN = 22;

+uint8_t const MISO_PIN = 23;

+uint8_t const SCK_PIN = 21;

+

+static const pin_map_t digitalPinMap[] = {

+  {&DDRD, &PIND, &PORTD, 0},  // D0  0

+  {&DDRD, &PIND, &PORTD, 1},  // D1  1

+  {&DDRD, &PIND, &PORTD, 2},  // D2  2

+  {&DDRD, &PIND, &PORTD, 3},  // D3  3

+  {&DDRD, &PIND, &PORTD, 4},  // D4  4

+  {&DDRD, &PIND, &PORTD, 5},  // D5  5

+  {&DDRD, &PIND, &PORTD, 6},  // D6  6

+  {&DDRD, &PIND, &PORTD, 7},  // D7  7

+  {&DDRE, &PINE, &PORTE, 0},  // E0  8

+  {&DDRE, &PINE, &PORTE, 1},  // E1  9

+  {&DDRC, &PINC, &PORTC, 0},  // C0 10

+  {&DDRC, &PINC, &PORTC, 1},  // C1 11

+  {&DDRC, &PINC, &PORTC, 2},  // C2 12

+  {&DDRC, &PINC, &PORTC, 3},  // C3 13

+  {&DDRC, &PINC, &PORTC, 4},  // C4 14

+  {&DDRC, &PINC, &PORTC, 5},  // C5 15

+  {&DDRC, &PINC, &PORTC, 6},  // C6 16

+  {&DDRC, &PINC, &PORTC, 7},  // C7 17

+  {&DDRE, &PINE, &PORTE, 6},  // E6 18

+  {&DDRE, &PINE, &PORTE, 7},  // E7 19

+  {&DDRB, &PINB, &PORTB, 0},  // B0 20

+  {&DDRB, &PINB, &PORTB, 1},  // B1 21

+  {&DDRB, &PINB, &PORTB, 2},  // B2 22

+  {&DDRB, &PINB, &PORTB, 3},  // B3 23

+  {&DDRB, &PINB, &PORTB, 4},  // B4 24

+  {&DDRB, &PINB, &PORTB, 5},  // B5 25

+  {&DDRB, &PINB, &PORTB, 6},  // B6 26

+  {&DDRB, &PINB, &PORTB, 7},  // B7 27

+  {&DDRA, &PINA, &PORTA, 0},  // A0 28

+  {&DDRA, &PINA, &PORTA, 1},  // A1 29

+  {&DDRA, &PINA, &PORTA, 2},  // A2 30

+  {&DDRA, &PINA, &PORTA, 3},  // A3 31

+  {&DDRA, &PINA, &PORTA, 4},  // A4 32

+  {&DDRA, &PINA, &PORTA, 5},  // A5 33

+  {&DDRA, &PINA, &PORTA, 6},  // A6 34

+  {&DDRA, &PINA, &PORTA, 7},  // A7 35

+  {&DDRE, &PINE, &PORTE, 4},  // E4 36

+  {&DDRE, &PINE, &PORTE, 5},  // E5 37

+  {&DDRF, &PINF, &PORTF, 0},  // F0 38

+  {&DDRF, &PINF, &PORTF, 1},  // F1 39

+  {&DDRF, &PINF, &PORTF, 2},  // F2 40

+  {&DDRF, &PINF, &PORTF, 3},  // F3 41

+  {&DDRF, &PINF, &PORTF, 4},  // F4 42

+  {&DDRF, &PINF, &PORTF, 5},  // F5 43

+  {&DDRF, &PINF, &PORTF, 6},  // F6 44

+  {&DDRF, &PINF, &PORTF, 7}   // F7 45

+};

+//------------------------------------------------------------------------------

+#else  // defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)

+// 168 and 328 Arduinos

+

+// Two Wire (aka I2C) ports

+uint8_t const SDA_PIN = 18;

+uint8_t const SCL_PIN = 19;

+

+// SPI port

+uint8_t const SS_PIN = 10;

+uint8_t const MOSI_PIN = 11;

+uint8_t const MISO_PIN = 12;

+uint8_t const SCK_PIN = 13;

+

+static const pin_map_t digitalPinMap[] = {

+  {&DDRD, &PIND, &PORTD, 0},  // D0  0

+  {&DDRD, &PIND, &PORTD, 1},  // D1  1

+  {&DDRD, &PIND, &PORTD, 2},  // D2  2

+  {&DDRD, &PIND, &PORTD, 3},  // D3  3

+  {&DDRD, &PIND, &PORTD, 4},  // D4  4

+  {&DDRD, &PIND, &PORTD, 5},  // D5  5

+  {&DDRD, &PIND, &PORTD, 6},  // D6  6

+  {&DDRD, &PIND, &PORTD, 7},  // D7  7

+  {&DDRB, &PINB, &PORTB, 0},  // B0  8

+  {&DDRB, &PINB, &PORTB, 1},  // B1  9

+  {&DDRB, &PINB, &PORTB, 2},  // B2 10

+  {&DDRB, &PINB, &PORTB, 3},  // B3 11

+  {&DDRB, &PINB, &PORTB, 4},  // B4 12

+  {&DDRB, &PINB, &PORTB, 5},  // B5 13

+  {&DDRC, &PINC, &PORTC, 0},  // C0 14

+  {&DDRC, &PINC, &PORTC, 1},  // C1 15

+  {&DDRC, &PINC, &PORTC, 2},  // C2 16

+  {&DDRC, &PINC, &PORTC, 3},  // C3 17

+  {&DDRC, &PINC, &PORTC, 4},  // C4 18

+  {&DDRC, &PINC, &PORTC, 5}   // C5 19

+};

+#endif  // defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)

+//------------------------------------------------------------------------------

+static const uint8_t digitalPinCount = sizeof(digitalPinMap)/sizeof(pin_map_t);

+

+uint8_t badPinNumber(void)

+  __attribute__((error("Pin number is too large or not a constant")));

+

+static inline __attribute__((always_inline))

+  uint8_t getPinMode(uint8_t pin) {

+  if (__builtin_constant_p(pin) && pin < digitalPinCount) {

+    return (*digitalPinMap[pin].ddr >> digitalPinMap[pin].bit) & 1;

+  } else {

+    return badPinNumber();

+  }

+}

+static inline __attribute__((always_inline))

+  void setPinMode(uint8_t pin, uint8_t mode) {

+  if (__builtin_constant_p(pin) && pin < digitalPinCount) {

+    if (mode) {

+      *digitalPinMap[pin].ddr |= 1 << digitalPinMap[pin].bit;

+    } else {

+      *digitalPinMap[pin].ddr &= ~(1 << digitalPinMap[pin].bit);

+    }

+  } else {

+    badPinNumber();

+  }

+}

+static inline __attribute__((always_inline))

+  uint8_t fastDigitalRead(uint8_t pin) {

+  if (__builtin_constant_p(pin) && pin < digitalPinCount) {

+    return (*digitalPinMap[pin].pin >> digitalPinMap[pin].bit) & 1;

+  } else {

+    return badPinNumber();

+  }

+}

+static inline __attribute__((always_inline))

+  void fastDigitalWrite(uint8_t pin, uint8_t value) {

+  if (__builtin_constant_p(pin) && pin < digitalPinCount) {

+    if (value) {

+      *digitalPinMap[pin].port |= 1 << digitalPinMap[pin].bit;

+    } else {

+      *digitalPinMap[pin].port &= ~(1 << digitalPinMap[pin].bit);

+    }

+  } else {

+    badPinNumber();

+  }

+}

+#endif  // Sd2PinMap_h

diff --git a/libraries/SD/utility/SdFat.h b/libraries/SD/utility/SdFat.h
new file mode 100644
index 0000000..048fa71
--- /dev/null
+++ b/libraries/SD/utility/SdFat.h
@@ -0,0 +1,547 @@
+/* Arduino SdFat Library

+ * Copyright (C) 2009 by William Greiman

+ *

+ * This file is part of the Arduino SdFat Library

+ *

+ * This Library is free software: you can redistribute it and/or modify

+ * it under the terms of the GNU General Public License as published by

+ * the Free Software Foundation, either version 3 of the License, or

+ * (at your option) any later version.

+ *

+ * This Library is distributed in the hope that it will be useful,

+ * but WITHOUT ANY WARRANTY; without even the implied warranty of

+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+ * GNU General Public License for more details.

+ *

+ * You should have received a copy of the GNU General Public License

+ * along with the Arduino SdFat Library.  If not, see

+ * <http://www.gnu.org/licenses/>.

+ */

+#ifndef SdFat_h

+#define SdFat_h

+/**

+ * \file

+ * SdFile and SdVolume classes

+ */

+#include <avr/pgmspace.h>

+#include "Sd2Card.h"

+#include "FatStructs.h"

+#include "Print.h"

+//------------------------------------------------------------------------------

+/**

+ * Allow use of deprecated functions if non-zero

+ */

+#define ALLOW_DEPRECATED_FUNCTIONS 1

+//------------------------------------------------------------------------------

+// forward declaration since SdVolume is used in SdFile

+class SdVolume;

+//==============================================================================

+// SdFile class

+

+// flags for ls()

+/** ls() flag to print modify date */

+uint8_t const LS_DATE = 1;

+/** ls() flag to print file size */

+uint8_t const LS_SIZE = 2;

+/** ls() flag for recursive list of subdirectories */

+uint8_t const LS_R = 4;

+

+// use the gnu style oflag in open()

+/** open() oflag for reading */

+uint8_t const O_READ = 0X01;

+/** open() oflag - same as O_READ */

+uint8_t const O_RDONLY = O_READ;

+/** open() oflag for write */

+uint8_t const O_WRITE = 0X02;

+/** open() oflag - same as O_WRITE */

+uint8_t const O_WRONLY = O_WRITE;

+/** open() oflag for reading and writing */

+uint8_t const O_RDWR = (O_READ | O_WRITE);

+/** open() oflag mask for access modes */

+uint8_t const O_ACCMODE = (O_READ | O_WRITE);

+/** The file offset shall be set to the end of the file prior to each write. */

+uint8_t const O_APPEND = 0X04;

+/** synchronous writes - call sync() after each write */

+uint8_t const O_SYNC = 0X08;

+/** create the file if nonexistent */

+uint8_t const O_CREAT = 0X10;

+/** If O_CREAT and O_EXCL are set, open() shall fail if the file exists */

+uint8_t const O_EXCL = 0X20;

+/** truncate the file to zero length */

+uint8_t const O_TRUNC = 0X40;

+

+// flags for timestamp

+/** set the file's last access date */

+uint8_t const T_ACCESS = 1;

+/** set the file's creation date and time */

+uint8_t const T_CREATE = 2;

+/** Set the file's write date and time */

+uint8_t const T_WRITE = 4;

+// values for type_

+/** This SdFile has not been opened. */

+uint8_t const FAT_FILE_TYPE_CLOSED = 0;

+/** SdFile for a file */

+uint8_t const FAT_FILE_TYPE_NORMAL = 1;

+/** SdFile for a FAT16 root directory */

+uint8_t const FAT_FILE_TYPE_ROOT16 = 2;

+/** SdFile for a FAT32 root directory */

+uint8_t const FAT_FILE_TYPE_ROOT32 = 3;

+/** SdFile for a subdirectory */

+uint8_t const FAT_FILE_TYPE_SUBDIR = 4;

+/** Test value for directory type */

+uint8_t const FAT_FILE_TYPE_MIN_DIR = FAT_FILE_TYPE_ROOT16;

+

+/** date field for FAT directory entry */

+static inline uint16_t FAT_DATE(uint16_t year, uint8_t month, uint8_t day) {

+  return (year - 1980) << 9 | month << 5 | day;

+}

+/** year part of FAT directory date field */

+static inline uint16_t FAT_YEAR(uint16_t fatDate) {

+  return 1980 + (fatDate >> 9);

+}

+/** month part of FAT directory date field */

+static inline uint8_t FAT_MONTH(uint16_t fatDate) {

+  return (fatDate >> 5) & 0XF;

+}

+/** day part of FAT directory date field */

+static inline uint8_t FAT_DAY(uint16_t fatDate) {

+  return fatDate & 0X1F;

+}

+/** time field for FAT directory entry */

+static inline uint16_t FAT_TIME(uint8_t hour, uint8_t minute, uint8_t second) {

+  return hour << 11 | minute << 5 | second >> 1;

+}

+/** hour part of FAT directory time field */

+static inline uint8_t FAT_HOUR(uint16_t fatTime) {

+  return fatTime >> 11;

+}

+/** minute part of FAT directory time field */

+static inline uint8_t FAT_MINUTE(uint16_t fatTime) {

+  return(fatTime >> 5) & 0X3F;

+}

+/** second part of FAT directory time field */

+static inline uint8_t FAT_SECOND(uint16_t fatTime) {

+  return 2*(fatTime & 0X1F);

+}

+/** Default date for file timestamps is 1 Jan 2000 */

+uint16_t const FAT_DEFAULT_DATE = ((2000 - 1980) << 9) | (1 << 5) | 1;

+/** Default time for file timestamp is 1 am */

+uint16_t const FAT_DEFAULT_TIME = (1 << 11);

+//------------------------------------------------------------------------------

+/**

+ * \class SdFile

+ * \brief Access FAT16 and FAT32 files on SD and SDHC cards.

+ */

+class SdFile : public Print {

+ public:

+  /** Create an instance of SdFile. */

+  SdFile(void) : type_(FAT_FILE_TYPE_CLOSED) {}

+  /**

+   * writeError is set to true if an error occurs during a write().

+   * Set writeError to false before calling print() and/or write() and check

+   * for true after calls to print() and/or write().

+   */

+  bool writeError;

+  /**

+   * Cancel unbuffered reads for this file.

+   * See setUnbufferedRead()

+   */

+  void clearUnbufferedRead(void) {

+    flags_ &= ~F_FILE_UNBUFFERED_READ;

+  }

+  uint8_t close(void);

+  uint8_t contiguousRange(uint32_t* bgnBlock, uint32_t* endBlock);

+  uint8_t createContiguous(SdFile* dirFile,

+          const char* fileName, uint32_t size);

+  /** \return The current cluster number for a file or directory. */

+  uint32_t curCluster(void) const {return curCluster_;}

+  /** \return The current position for a file or directory. */

+  uint32_t curPosition(void) const {return curPosition_;}

+  /**

+   * Set the date/time callback function

+   *

+   * \param[in] dateTime The user's call back function.  The callback

+   * function is of the form:

+   *

+   * \code

+   * void dateTime(uint16_t* date, uint16_t* time) {

+   *   uint16_t year;

+   *   uint8_t month, day, hour, minute, second;

+   *

+   *   // User gets date and time from GPS or real-time clock here

+   *

+   *   // return date using FAT_DATE macro to format fields

+   *   *date = FAT_DATE(year, month, day);

+   *

+   *   // return time using FAT_TIME macro to format fields

+   *   *time = FAT_TIME(hour, minute, second);

+   * }

+   * \endcode

+   *

+   * Sets the function that is called when a file is created or when

+   * a file's directory entry is modified by sync(). All timestamps,

+   * access, creation, and modify, are set when a file is created.

+   * sync() maintains the last access date and last modify date/time.

+   *

+   * See the timestamp() function.

+   */

+  static void dateTimeCallback(

+    void (*dateTime)(uint16_t* date, uint16_t* time)) {

+    dateTime_ = dateTime;

+  }

+  /**

+   * Cancel the date/time callback function.

+   */

+  static void dateTimeCallbackCancel(void) {

+    // use explicit zero since NULL is not defined for Sanguino

+    dateTime_ = 0;

+  }

+  /** \return Address of the block that contains this file's directory. */

+  uint32_t dirBlock(void) const {return dirBlock_;}

+  uint8_t dirEntry(dir_t* dir);

+  /** \return Index of this file's directory in the block dirBlock. */

+  uint8_t dirIndex(void) const {return dirIndex_;}

+  static void dirName(const dir_t& dir, char* name);

+  /** \return The total number of bytes in a file or directory. */

+  uint32_t fileSize(void) const {return fileSize_;}

+  /** \return The first cluster number for a file or directory. */

+  uint32_t firstCluster(void) const {return firstCluster_;}

+  /** \return True if this is a SdFile for a directory else false. */

+  uint8_t isDir(void) const {return type_ >= FAT_FILE_TYPE_MIN_DIR;}

+  /** \return True if this is a SdFile for a file else false. */

+  uint8_t isFile(void) const {return type_ == FAT_FILE_TYPE_NORMAL;}

+  /** \return True if this is a SdFile for an open file/directory else false. */

+  uint8_t isOpen(void) const {return type_ != FAT_FILE_TYPE_CLOSED;}

+  /** \return True if this is a SdFile for a subdirectory else false. */

+  uint8_t isSubDir(void) const {return type_ == FAT_FILE_TYPE_SUBDIR;}

+  /** \return True if this is a SdFile for the root directory. */

+  uint8_t isRoot(void) const {

+    return type_ == FAT_FILE_TYPE_ROOT16 || type_ == FAT_FILE_TYPE_ROOT32;

+  }

+  void ls(uint8_t flags = 0, uint8_t indent = 0);

+  uint8_t makeDir(SdFile* dir, const char* dirName);

+  uint8_t open(SdFile* dirFile, uint16_t index, uint8_t oflag);

+  uint8_t open(SdFile* dirFile, const char* fileName, uint8_t oflag);

+

+  uint8_t openRoot(SdVolume* vol);

+  static void printDirName(const dir_t& dir, uint8_t width);

+  static void printFatDate(uint16_t fatDate);

+  static void printFatTime(uint16_t fatTime);

+  static void printTwoDigits(uint8_t v);

+  /**

+   * Read the next byte from a file.

+   *

+   * \return For success read returns the next byte in the file as an int.

+   * If an error occurs or end of file is reached -1 is returned.

+   */

+  int16_t read(void) {

+    uint8_t b;

+    return read(&b, 1) == 1 ? b : -1;

+  }

+  int16_t read(void* buf, uint16_t nbyte);

+  int8_t readDir(dir_t* dir);

+  static uint8_t remove(SdFile* dirFile, const char* fileName);

+  uint8_t remove(void);

+  /** Set the file's current position to zero. */

+  void rewind(void) {

+    curPosition_ = curCluster_ = 0;

+  }

+  uint8_t rmDir(void);

+  uint8_t rmRfStar(void);

+  /** Set the files position to current position + \a pos. See seekSet(). */

+  uint8_t seekCur(uint32_t pos) {

+    return seekSet(curPosition_ + pos);

+  }

+  /**

+   *  Set the files current position to end of file.  Useful to position

+   *  a file for append. See seekSet().

+   */

+  uint8_t seekEnd(void) {return seekSet(fileSize_);}

+  uint8_t seekSet(uint32_t pos);

+  /**

+   * Use unbuffered reads to access this file.  Used with Wave

+   * Shield ISR.  Used with Sd2Card::partialBlockRead() in WaveRP.

+   *

+   * Not recommended for normal applications.

+   */

+  void setUnbufferedRead(void) {

+    if (isFile()) flags_ |= F_FILE_UNBUFFERED_READ;

+  }

+  uint8_t timestamp(uint8_t flag, uint16_t year, uint8_t month, uint8_t day,

+          uint8_t hour, uint8_t minute, uint8_t second);

+  uint8_t sync(void);

+  /** Type of this SdFile.  You should use isFile() or isDir() instead of type()

+   * if possible.

+   *

+   * \return The file or directory type.

+   */

+  uint8_t type(void) const {return type_;}

+  uint8_t truncate(uint32_t size);

+  /** \return Unbuffered read flag. */

+  uint8_t unbufferedRead(void) const {

+    return flags_ & F_FILE_UNBUFFERED_READ;

+  }

+  /** \return SdVolume that contains this file. */

+  SdVolume* volume(void) const {return vol_;}

+  void write(uint8_t b);

+  int16_t write(const void* buf, uint16_t nbyte);

+  void write(const char* str);

+  void write_P(PGM_P str);

+  void writeln_P(PGM_P str);

+//------------------------------------------------------------------------------

+#if ALLOW_DEPRECATED_FUNCTIONS

+// Deprecated functions  - suppress cpplint warnings with NOLINT comment

+  /** \deprecated Use:

+   * uint8_t SdFile::contiguousRange(uint32_t* bgnBlock, uint32_t* endBlock);

+   */

+  uint8_t contiguousRange(uint32_t& bgnBlock, uint32_t& endBlock) {  // NOLINT

+    return contiguousRange(&bgnBlock, &endBlock);

+  }

+ /** \deprecated Use:

+   * uint8_t SdFile::createContiguous(SdFile* dirFile,

+   *   const char* fileName, uint32_t size)

+   */

+  uint8_t createContiguous(SdFile& dirFile,  // NOLINT

+    const char* fileName, uint32_t size) {

+    return createContiguous(&dirFile, fileName, size);

+  }

+

+  /**

+   * \deprecated Use:

+   * static void SdFile::dateTimeCallback(

+   *   void (*dateTime)(uint16_t* date, uint16_t* time));

+   */

+  static void dateTimeCallback(

+    void (*dateTime)(uint16_t& date, uint16_t& time)) {  // NOLINT

+    oldDateTime_ = dateTime;

+    dateTime_ = dateTime ? oldToNew : 0;

+  }

+  /** \deprecated Use: uint8_t SdFile::dirEntry(dir_t* dir); */

+  uint8_t dirEntry(dir_t& dir) {return dirEntry(&dir);}  // NOLINT

+  /** \deprecated Use:

+   * uint8_t SdFile::makeDir(SdFile* dir, const char* dirName);

+   */

+  uint8_t makeDir(SdFile& dir, const char* dirName) {  // NOLINT

+    return makeDir(&dir, dirName);

+  }

+  /** \deprecated Use:

+   * uint8_t SdFile::open(SdFile* dirFile, const char* fileName, uint8_t oflag);

+   */

+  uint8_t open(SdFile& dirFile, // NOLINT

+    const char* fileName, uint8_t oflag) {

+    return open(&dirFile, fileName, oflag);

+  }

+  /** \deprecated  Do not use in new apps */

+  uint8_t open(SdFile& dirFile, const char* fileName) {  // NOLINT

+    return open(dirFile, fileName, O_RDWR);

+  }

+  /** \deprecated Use:

+   * uint8_t SdFile::open(SdFile* dirFile, uint16_t index, uint8_t oflag);

+   */

+  uint8_t open(SdFile& dirFile, uint16_t index, uint8_t oflag) {  // NOLINT

+    return open(&dirFile, index, oflag);

+  }

+  /** \deprecated Use: uint8_t SdFile::openRoot(SdVolume* vol); */

+  uint8_t openRoot(SdVolume& vol) {return openRoot(&vol);}  // NOLINT

+

+  /** \deprecated Use: int8_t SdFile::readDir(dir_t* dir); */

+  int8_t readDir(dir_t& dir) {return readDir(&dir);}  // NOLINT

+  /** \deprecated Use:

+   * static uint8_t SdFile::remove(SdFile* dirFile, const char* fileName);

+   */

+  static uint8_t remove(SdFile& dirFile, const char* fileName) {  // NOLINT

+    return remove(&dirFile, fileName);

+  }

+//------------------------------------------------------------------------------

+// rest are private

+ private:

+  static void (*oldDateTime_)(uint16_t& date, uint16_t& time);  // NOLINT

+  static void oldToNew(uint16_t* date, uint16_t* time) {

+    uint16_t d;

+    uint16_t t;

+    oldDateTime_(d, t);

+    *date = d;

+    *time = t;

+  }

+#endif  // ALLOW_DEPRECATED_FUNCTIONS

+ private:

+  // bits defined in flags_

+  // should be 0XF

+  static uint8_t const F_OFLAG = (O_ACCMODE | O_APPEND | O_SYNC);

+  // available bits

+  static uint8_t const F_UNUSED = 0X30;

+  // use unbuffered SD read

+  static uint8_t const F_FILE_UNBUFFERED_READ = 0X40;

+  // sync of directory entry required

+  static uint8_t const F_FILE_DIR_DIRTY = 0X80;

+

+// make sure F_OFLAG is ok

+#if ((F_UNUSED | F_FILE_UNBUFFERED_READ | F_FILE_DIR_DIRTY) & F_OFLAG)

+#error flags_ bits conflict

+#endif  // flags_ bits

+

+  // private data

+  uint8_t   flags_;         // See above for definition of flags_ bits

+  uint8_t   type_;          // type of file see above for values

+  uint32_t  curCluster_;    // cluster for current file position

+  uint32_t  curPosition_;   // current file position in bytes from beginning

+  uint32_t  dirBlock_;      // SD block that contains directory entry for file

+  uint8_t   dirIndex_;      // index of entry in dirBlock 0 <= dirIndex_ <= 0XF

+  uint32_t  fileSize_;      // file size in bytes

+  uint32_t  firstCluster_;  // first cluster of file

+  SdVolume* vol_;           // volume where file is located

+

+  // private functions

+  uint8_t addCluster(void);

+  uint8_t addDirCluster(void);

+  dir_t* cacheDirEntry(uint8_t action);

+  static void (*dateTime_)(uint16_t* date, uint16_t* time);

+  static uint8_t make83Name(const char* str, uint8_t* name);

+  uint8_t openCachedEntry(uint8_t cacheIndex, uint8_t oflags);

+  dir_t* readDirCache(void);

+};

+//==============================================================================

+// SdVolume class

+/**

+ * \brief Cache for an SD data block

+ */

+union cache_t {

+           /** Used to access cached file data blocks. */

+  uint8_t  data[512];

+           /** Used to access cached FAT16 entries. */

+  uint16_t fat16[256];

+           /** Used to access cached FAT32 entries. */

+  uint32_t fat32[128];

+           /** Used to access cached directory entries. */

+  dir_t    dir[16];

+           /** Used to access a cached MasterBoot Record. */

+  mbr_t    mbr;

+           /** Used to access to a cached FAT boot sector. */

+  fbs_t    fbs;

+};

+//------------------------------------------------------------------------------

+/**

+ * \class SdVolume

+ * \brief Access FAT16 and FAT32 volumes on SD and SDHC cards.

+ */

+class SdVolume {

+ public:

+  /** Create an instance of SdVolume */

+  SdVolume(void) :allocSearchStart_(2), fatType_(0) {}

+  /** Clear the cache and returns a pointer to the cache.  Used by the WaveRP

+   *  recorder to do raw write to the SD card.  Not for normal apps.

+   */

+  static uint8_t* cacheClear(void) {

+    cacheFlush();

+    cacheBlockNumber_ = 0XFFFFFFFF;

+    return cacheBuffer_.data;

+  }

+  /**

+   * Initialize a FAT volume.  Try partition one first then try super

+   * floppy format.

+   *

+   * \param[in] dev The Sd2Card where the volume is located.

+   *

+   * \return The value one, true, is returned for success and

+   * the value zero, false, is returned for failure.  Reasons for

+   * failure include not finding a valid partition, not finding a valid

+   * FAT file system or an I/O error.

+   */

+  uint8_t init(Sd2Card* dev) { return init(dev, 1) ? true : init(dev, 0);}

+  uint8_t init(Sd2Card* dev, uint8_t part);

+

+  // inline functions that return volume info

+  /** \return The volume's cluster size in blocks. */

+  uint8_t blocksPerCluster(void) const {return blocksPerCluster_;}

+  /** \return The number of blocks in one FAT. */

+  uint32_t blocksPerFat(void)  const {return blocksPerFat_;}

+  /** \return The total number of clusters in the volume. */

+  uint32_t clusterCount(void) const {return clusterCount_;}

+  /** \return The shift count required to multiply by blocksPerCluster. */

+  uint8_t clusterSizeShift(void) const {return clusterSizeShift_;}

+  /** \return The logical block number for the start of file data. */

+  uint32_t dataStartBlock(void) const {return dataStartBlock_;}

+  /** \return The number of FAT structures on the volume. */

+  uint8_t fatCount(void) const {return fatCount_;}

+  /** \return The logical block number for the start of the first FAT. */

+  uint32_t fatStartBlock(void) const {return fatStartBlock_;}

+  /** \return The FAT type of the volume. Values are 12, 16 or 32. */

+  uint8_t fatType(void) const {return fatType_;}

+  /** \return The number of entries in the root directory for FAT16 volumes. */

+  uint32_t rootDirEntryCount(void) const {return rootDirEntryCount_;}

+  /** \return The logical block number for the start of the root directory

+       on FAT16 volumes or the first cluster number on FAT32 volumes. */

+  uint32_t rootDirStart(void) const {return rootDirStart_;}

+  /** return a pointer to the Sd2Card object for this volume */

+  static Sd2Card* sdCard(void) {return sdCard_;}

+//------------------------------------------------------------------------------

+#if ALLOW_DEPRECATED_FUNCTIONS

+  // Deprecated functions  - suppress cpplint warnings with NOLINT comment

+  /** \deprecated Use: uint8_t SdVolume::init(Sd2Card* dev); */

+  uint8_t init(Sd2Card& dev) {return init(&dev);}  // NOLINT

+

+  /** \deprecated Use: uint8_t SdVolume::init(Sd2Card* dev, uint8_t vol); */

+  uint8_t init(Sd2Card& dev, uint8_t part) {  // NOLINT

+    return init(&dev, part);

+  }

+#endif  // ALLOW_DEPRECATED_FUNCTIONS

+//------------------------------------------------------------------------------

+  private:

+  // Allow SdFile access to SdVolume private data.

+  friend class SdFile;

+

+  // value for action argument in cacheRawBlock to indicate read from cache

+  static uint8_t const CACHE_FOR_READ = 0;

+  // value for action argument in cacheRawBlock to indicate cache dirty

+  static uint8_t const CACHE_FOR_WRITE = 1;

+

+  static cache_t cacheBuffer_;        // 512 byte cache for device blocks

+  static uint32_t cacheBlockNumber_;  // Logical number of block in the cache

+  static Sd2Card* sdCard_;            // Sd2Card object for cache

+  static uint8_t cacheDirty_;         // cacheFlush() will write block if true

+  static uint32_t cacheMirrorBlock_;  // block number for mirror FAT

+//

+  uint32_t allocSearchStart_;   // start cluster for alloc search

+  uint8_t blocksPerCluster_;    // cluster size in blocks

+  uint32_t blocksPerFat_;       // FAT size in blocks

+  uint32_t clusterCount_;       // clusters in one FAT

+  uint8_t clusterSizeShift_;    // shift to convert cluster count to block count

+  uint32_t dataStartBlock_;     // first data block number

+  uint8_t fatCount_;            // number of FATs on volume

+  uint32_t fatStartBlock_;      // start block for first FAT

+  uint8_t fatType_;             // volume type (12, 16, OR 32)

+  uint16_t rootDirEntryCount_;  // number of entries in FAT16 root dir

+  uint32_t rootDirStart_;       // root start block for FAT16, cluster for FAT32

+  //----------------------------------------------------------------------------

+  uint8_t allocContiguous(uint32_t count, uint32_t* curCluster);

+  uint8_t blockOfCluster(uint32_t position) const {

+          return (position >> 9) & (blocksPerCluster_ - 1);}

+  uint32_t clusterStartBlock(uint32_t cluster) const {

+           return dataStartBlock_ + ((cluster - 2) << clusterSizeShift_);}

+  uint32_t blockNumber(uint32_t cluster, uint32_t position) const {

+           return clusterStartBlock(cluster) + blockOfCluster(position);}

+  static uint8_t cacheFlush(void);

+  static uint8_t cacheRawBlock(uint32_t blockNumber, uint8_t action);

+  static void cacheSetDirty(void) {cacheDirty_ |= CACHE_FOR_WRITE;}

+  static uint8_t cacheZeroBlock(uint32_t blockNumber);

+  uint8_t chainSize(uint32_t beginCluster, uint32_t* size) const;

+  uint8_t fatGet(uint32_t cluster, uint32_t* value) const;

+  uint8_t fatPut(uint32_t cluster, uint32_t value);

+  uint8_t fatPutEOC(uint32_t cluster) {

+    return fatPut(cluster, 0x0FFFFFFF);

+  }

+  uint8_t freeChain(uint32_t cluster);

+  uint8_t isEOC(uint32_t cluster) const {

+    return  cluster >= (fatType_ == 16 ? FAT16EOC_MIN : FAT32EOC_MIN);

+  }

+  uint8_t readBlock(uint32_t block, uint8_t* dst) {

+    return sdCard_->readBlock(block, dst);}

+  uint8_t readData(uint32_t block, uint16_t offset,

+    uint16_t count, uint8_t* dst) {

+      return sdCard_->readData(block, offset, count, dst);

+  }

+  uint8_t writeBlock(uint32_t block, const uint8_t* dst) {

+    return sdCard_->writeBlock(block, dst);

+  }

+};

+#endif  // SdFat_h

diff --git a/libraries/SD/utility/SdFatUtil.h b/libraries/SD/utility/SdFatUtil.h
new file mode 100644
index 0000000..c626bfe
--- /dev/null
+++ b/libraries/SD/utility/SdFatUtil.h
@@ -0,0 +1,70 @@
+/* Arduino SdFat Library

+ * Copyright (C) 2008 by William Greiman

+ *

+ * This file is part of the Arduino SdFat Library

+ *

+ * This Library is free software: you can redistribute it and/or modify

+ * it under the terms of the GNU General Public License as published by

+ * the Free Software Foundation, either version 3 of the License, or

+ * (at your option) any later version.

+ *

+ * This Library is distributed in the hope that it will be useful,

+ * but WITHOUT ANY WARRANTY; without even the implied warranty of

+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+ * GNU General Public License for more details.

+

+ * You should have received a copy of the GNU General Public License

+ * along with the Arduino SdFat Library.  If not, see

+ * <http://www.gnu.org/licenses/>.

+ */

+#ifndef SdFatUtil_h

+#define SdFatUtil_h

+/**

+ * \file

+ * Useful utility functions.

+ */

+#include <Arduino.h>

+#include <avr/pgmspace.h>

+/** Store and print a string in flash memory.*/

+#define PgmPrint(x) SerialPrint_P(PSTR(x))

+/** Store and print a string in flash memory followed by a CR/LF.*/

+#define PgmPrintln(x) SerialPrintln_P(PSTR(x))

+/** Defined so doxygen works for function definitions. */

+#define NOINLINE __attribute__((noinline))

+//------------------------------------------------------------------------------

+/** Return the number of bytes currently free in RAM. */

+static int FreeRam(void) {

+  extern int  __bss_end;

+  extern int* __brkval;

+  int free_memory;

+  if (reinterpret_cast<int>(__brkval) == 0) {

+    // if no heap use from end of bss section

+    free_memory = reinterpret_cast<int>(&free_memory)

+                  - reinterpret_cast<int>(&__bss_end);

+  } else {

+    // use from top of stack to heap

+    free_memory = reinterpret_cast<int>(&free_memory)

+                  - reinterpret_cast<int>(__brkval);

+  }

+  return free_memory;

+}

+//------------------------------------------------------------------------------

+/**

+ * %Print a string in flash memory to the serial port.

+ *

+ * \param[in] str Pointer to string stored in flash memory.

+ */

+static NOINLINE void SerialPrint_P(PGM_P str) {

+  for (uint8_t c; (c = pgm_read_byte(str)); str++) Serial.print(c);

+}

+//------------------------------------------------------------------------------

+/**

+ * %Print a string in flash memory followed by a CR/LF.

+ *

+ * \param[in] str Pointer to string stored in flash memory.

+ */

+static NOINLINE void SerialPrintln_P(PGM_P str) {

+  SerialPrint_P(str);

+  Serial.println();

+}

+#endif  // #define SdFatUtil_h

diff --git a/libraries/SD/utility/SdFatmainpage.h b/libraries/SD/utility/SdFatmainpage.h
new file mode 100644
index 0000000..73b3b63
--- /dev/null
+++ b/libraries/SD/utility/SdFatmainpage.h
@@ -0,0 +1,202 @@
+/* Arduino SdFat Library

+ * Copyright (C) 2009 by William Greiman

+ *  

+ * This file is part of the Arduino SdFat Library

+ *  

+ * This Library is free software: you can redistribute it and/or modify 

+ * it under the terms of the GNU General Public License as published by 

+ * the Free Software Foundation, either version 3 of the License, or

+ * (at your option) any later version.

+ * 

+ * This Library is distributed in the hope that it will be useful,

+ * but WITHOUT ANY WARRANTY; without even the implied warranty of

+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+ * GNU General Public License for more details.

+ *

+ * You should have received a copy of the GNU General Public License

+ * along with the Arduino SdFat Library.  If not, see

+ * <http://www.gnu.org/licenses/>.

+ */

+

+/**

+\mainpage Arduino SdFat Library

+<CENTER>Copyright &copy; 2009 by William Greiman

+</CENTER>

+

+\section Intro Introduction

+The Arduino SdFat Library is a minimal implementation of FAT16 and FAT32

+file systems on SD flash memory cards.  Standard SD and high capacity

+SDHC cards are supported.

+

+The SdFat only supports short 8.3 names.

+

+The main classes in SdFat are Sd2Card, SdVolume, and SdFile.

+

+The Sd2Card class supports access to standard SD cards and SDHC cards.  Most

+applications will only need to call the Sd2Card::init() member function.

+

+The SdVolume class supports FAT16 and FAT32 partitions.  Most applications

+will only need to call the SdVolume::init() member function.

+

+The SdFile class provides file access functions such as open(), read(),

+remove(), write(), close() and sync(). This class supports access to the root

+directory and subdirectories.

+

+A number of example are provided in the SdFat/examples folder.  These were

+developed to test SdFat and illustrate its use.

+

+SdFat was developed for high speed data recording.  SdFat was used to implement

+an audio record/play class, WaveRP, for the Adafruit Wave Shield.  This

+application uses special Sd2Card calls to write to contiguous files in raw mode.

+These functions reduce write latency so that audio can be recorded with the

+small amount of RAM in the Arduino.

+

+\section SDcard SD\SDHC Cards

+

+Arduinos access SD cards using the cards SPI protocol.  PCs, Macs, and

+most consumer devices use the 4-bit parallel SD protocol.  A card that

+functions well on A PC or Mac may not work well on the Arduino.

+

+Most cards have good SPI read performance but cards vary widely in SPI

+write performance.  Write performance is limited by how efficiently the

+card manages internal erase/remapping operations.  The Arduino cannot

+optimize writes to reduce erase operations because of its limit RAM.

+

+SanDisk cards generally have good write performance.  They seem to have

+more internal RAM buffering than other cards and therefore can limit

+the number of flash erase operations that the Arduino forces due to its

+limited RAM.

+

+\section Hardware Hardware Configuration

+

+SdFat was developed using an

+<A HREF = "http://www.adafruit.com/"> Adafruit Industries</A> 

+<A HREF = "http://www.ladyada.net/make/waveshield/"> Wave Shield</A>.

+

+The hardware interface to the SD card should not use a resistor based level

+shifter.  SdFat sets the SPI bus frequency to 8 MHz which results in signal

+rise times that are too slow for the edge detectors in many newer SD card

+controllers when resistor voltage dividers are used.

+

+The 5 to 3.3 V level shifter for 5 V Arduinos should be IC based like the

+74HC4050N based circuit shown in the file SdLevel.png.  The Adafruit Wave Shield

+uses a 74AHC125N.  Gravitech sells SD and MicroSD Card Adapters based on the

+74LCX245.

+

+If you are using a resistor based level shifter and are having problems try

+setting the SPI bus frequency to 4 MHz.  This can be done by using 

+card.init(SPI_HALF_SPEED) to initialize the SD card.

+

+\section comment Bugs and Comments

+

+If you wish to report bugs or have comments, send email to fat16lib@sbcglobal.net.

+

+\section SdFatClass SdFat Usage

+

+SdFat uses a slightly restricted form of short names.

+Only printable ASCII characters are supported. No characters with code point

+values greater than 127 are allowed.  Space is not allowed even though space

+was allowed in the API of early versions of DOS.

+

+Short names are limited to 8 characters followed by an optional period (.)

+and extension of up to 3 characters.  The characters may be any combination

+of letters and digits.  The following special characters are also allowed:

+

+$ % ' - _ @ ~ ` ! ( ) { } ^ # &

+

+Short names are always converted to upper case and their original case

+value is lost.

+

+\note

+  The Arduino Print class uses character

+at a time writes so it was necessary to use a \link SdFile::sync() sync() \endlink

+function to control when data is written to the SD card.

+

+\par

+An application which writes to a file using \link Print::print() print()\endlink,

+\link Print::println() println() \endlink

+or \link SdFile::write write() \endlink must call \link SdFile::sync() sync() \endlink

+at the appropriate time to force data and directory information to be written

+to the SD Card.  Data and directory information are also written to the SD card

+when \link SdFile::close() close() \endlink is called.

+

+\par

+Applications must use care calling \link SdFile::sync() sync() \endlink

+since 2048 bytes of I/O is required to update file and

+directory information.  This includes writing the current data block, reading

+the block that contains the directory entry for update, writing the directory

+block back and reading back the current data block.

+

+It is possible to open a file with two or more instances of SdFile.  A file may

+be corrupted if data is written to the file by more than one instance of SdFile.

+

+\section HowTo How to format SD Cards as FAT Volumes

+

+You should use a freshly formatted SD card for best performance.  FAT

+file systems become slower if many files have been created and deleted.

+This is because the directory entry for a deleted file is marked as deleted,

+but is not deleted.  When a new file is created, these entries must be scanned

+before creating the file, a flaw in the FAT design.  Also files can become

+fragmented which causes reads and writes to be slower.

+

+Microsoft operating systems support removable media formatted with a

+Master Boot Record, MBR, or formatted as a super floppy with a FAT Boot Sector

+in block zero.

+

+Microsoft operating systems expect MBR formatted removable media

+to have only one partition. The first partition should be used.

+

+Microsoft operating systems do not support partitioning SD flash cards.

+If you erase an SD card with a program like KillDisk, Most versions of

+Windows will format the card as a super floppy.

+

+The best way to restore an SD card's format is to use SDFormatter

+which can be downloaded from:

+

+http://www.sdcard.org/consumers/formatter/

+

+SDFormatter aligns flash erase boundaries with file

+system structures which reduces write latency and file system overhead.

+

+SDFormatter does not have an option for FAT type so it may format

+small cards as FAT12.

+

+After the MBR is restored by SDFormatter you may need to reformat small

+cards that have been formatted FAT12 to force the volume type to be FAT16.

+

+If you reformat the SD card with an OS utility, choose a cluster size that

+will result in:

+

+4084 < CountOfClusters && CountOfClusters < 65525

+

+The volume will then be FAT16.

+

+If you are formatting an SD card on OS X or Linux, be sure to use the first

+partition. Format this partition with a cluster count in above range.

+

+\section  References References

+

+Adafruit Industries:

+

+http://www.adafruit.com/

+

+http://www.ladyada.net/make/waveshield/

+

+The Arduino site:

+

+http://www.arduino.cc/

+

+For more information about FAT file systems see:

+

+http://www.microsoft.com/whdc/system/platform/firmware/fatgen.mspx

+

+For information about using SD cards as SPI devices see:

+

+http://www.sdcard.org/developers/tech/sdcard/pls/Simplified_Physical_Layer_Spec.pdf

+

+The ATmega328 datasheet:

+

+http://www.atmel.com/dyn/resources/prod_documents/doc8161.pdf

+ 

+

+ */  

diff --git a/libraries/SD/utility/SdFile.cpp b/libraries/SD/utility/SdFile.cpp
new file mode 100644
index 0000000..40444a7
--- /dev/null
+++ b/libraries/SD/utility/SdFile.cpp
@@ -0,0 +1,1252 @@
+/* Arduino SdFat Library

+ * Copyright (C) 2009 by William Greiman

+ *

+ * This file is part of the Arduino SdFat Library

+ *

+ * This Library is free software: you can redistribute it and/or modify

+ * it under the terms of the GNU General Public License as published by

+ * the Free Software Foundation, either version 3 of the License, or

+ * (at your option) any later version.

+ *

+ * This Library is distributed in the hope that it will be useful,

+ * but WITHOUT ANY WARRANTY; without even the implied warranty of

+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+ * GNU General Public License for more details.

+ *

+ * You should have received a copy of the GNU General Public License

+ * along with the Arduino SdFat Library.  If not, see

+ * <http://www.gnu.org/licenses/>.

+ */

+#include <SdFat.h>

+#include <avr/pgmspace.h>

+#include <Arduino.h>

+//------------------------------------------------------------------------------

+// callback function for date/time

+void (*SdFile::dateTime_)(uint16_t* date, uint16_t* time) = NULL;

+

+#if ALLOW_DEPRECATED_FUNCTIONS

+// suppress cpplint warnings with NOLINT comment

+void (*SdFile::oldDateTime_)(uint16_t& date, uint16_t& time) = NULL;  // NOLINT

+#endif  // ALLOW_DEPRECATED_FUNCTIONS

+//------------------------------------------------------------------------------

+// add a cluster to a file

+uint8_t SdFile::addCluster() {

+  if (!vol_->allocContiguous(1, &curCluster_)) return false;

+

+  // if first cluster of file link to directory entry

+  if (firstCluster_ == 0) {

+    firstCluster_ = curCluster_;

+    flags_ |= F_FILE_DIR_DIRTY;

+  }

+  return true;

+}

+//------------------------------------------------------------------------------

+// Add a cluster to a directory file and zero the cluster.

+// return with first block of cluster in the cache

+uint8_t SdFile::addDirCluster(void) {

+  if (!addCluster()) return false;

+

+  // zero data in cluster insure first cluster is in cache

+  uint32_t block = vol_->clusterStartBlock(curCluster_);

+  for (uint8_t i = vol_->blocksPerCluster_; i != 0; i--) {

+    if (!SdVolume::cacheZeroBlock(block + i - 1)) return false;

+  }

+  // Increase directory file size by cluster size

+  fileSize_ += 512UL << vol_->clusterSizeShift_;

+  return true;

+}

+//------------------------------------------------------------------------------

+// cache a file's directory entry

+// return pointer to cached entry or null for failure

+dir_t* SdFile::cacheDirEntry(uint8_t action) {

+  if (!SdVolume::cacheRawBlock(dirBlock_, action)) return NULL;

+  return SdVolume::cacheBuffer_.dir + dirIndex_;

+}

+//------------------------------------------------------------------------------

+/**

+ *  Close a file and force cached data and directory information

+ *  to be written to the storage device.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ * Reasons for failure include no file is open or an I/O error.

+ */

+uint8_t SdFile::close(void) {

+  if (!sync())return false;

+  type_ = FAT_FILE_TYPE_CLOSED;

+  return true;

+}

+//------------------------------------------------------------------------------

+/**

+ * Check for contiguous file and return its raw block range.

+ *

+ * \param[out] bgnBlock the first block address for the file.

+ * \param[out] endBlock the last  block address for the file.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ * Reasons for failure include file is not contiguous, file has zero length

+ * or an I/O error occurred.

+ */

+uint8_t SdFile::contiguousRange(uint32_t* bgnBlock, uint32_t* endBlock) {

+  // error if no blocks

+  if (firstCluster_ == 0) return false;

+

+  for (uint32_t c = firstCluster_; ; c++) {

+    uint32_t next;

+    if (!vol_->fatGet(c, &next)) return false;

+

+    // check for contiguous

+    if (next != (c + 1)) {

+      // error if not end of chain

+      if (!vol_->isEOC(next)) return false;

+      *bgnBlock = vol_->clusterStartBlock(firstCluster_);

+      *endBlock = vol_->clusterStartBlock(c)

+                  + vol_->blocksPerCluster_ - 1;

+      return true;

+    }

+  }

+}

+//------------------------------------------------------------------------------

+/**

+ * Create and open a new contiguous file of a specified size.

+ *

+ * \note This function only supports short DOS 8.3 names.

+ * See open() for more information.

+ *

+ * \param[in] dirFile The directory where the file will be created.

+ * \param[in] fileName A valid DOS 8.3 file name.

+ * \param[in] size The desired file size.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ * Reasons for failure include \a fileName contains

+ * an invalid DOS 8.3 file name, the FAT volume has not been initialized,

+ * a file is already open, the file already exists, the root

+ * directory is full or an I/O error.

+ *

+ */

+uint8_t SdFile::createContiguous(SdFile* dirFile,

+        const char* fileName, uint32_t size) {

+  // don't allow zero length file

+  if (size == 0) return false;

+  if (!open(dirFile, fileName, O_CREAT | O_EXCL | O_RDWR)) return false;

+

+  // calculate number of clusters needed

+  uint32_t count = ((size - 1) >> (vol_->clusterSizeShift_ + 9)) + 1;

+

+  // allocate clusters

+  if (!vol_->allocContiguous(count, &firstCluster_)) {

+    remove();

+    return false;

+  }

+  fileSize_ = size;

+

+  // insure sync() will update dir entry

+  flags_ |= F_FILE_DIR_DIRTY;

+  return sync();

+}

+//------------------------------------------------------------------------------

+/**

+ * Return a files directory entry

+ *

+ * \param[out] dir Location for return of the files directory entry.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ */

+uint8_t SdFile::dirEntry(dir_t* dir) {

+  // make sure fields on SD are correct

+  if (!sync()) return false;

+

+  // read entry

+  dir_t* p = cacheDirEntry(SdVolume::CACHE_FOR_READ);

+  if (!p) return false;

+

+  // copy to caller's struct

+  memcpy(dir, p, sizeof(dir_t));

+  return true;

+}

+//------------------------------------------------------------------------------

+/**

+ * Format the name field of \a dir into the 13 byte array

+ * \a name in standard 8.3 short name format.

+ *

+ * \param[in] dir The directory structure containing the name.

+ * \param[out] name A 13 byte char array for the formatted name.

+ */

+void SdFile::dirName(const dir_t& dir, char* name) {

+  uint8_t j = 0;

+  for (uint8_t i = 0; i < 11; i++) {

+    if (dir.name[i] == ' ')continue;

+    if (i == 8) name[j++] = '.';

+    name[j++] = dir.name[i];

+  }

+  name[j] = 0;

+}

+//------------------------------------------------------------------------------

+/** List directory contents to Serial.

+ *

+ * \param[in] flags The inclusive OR of

+ *

+ * LS_DATE - %Print file modification date

+ *

+ * LS_SIZE - %Print file size.

+ *

+ * LS_R - Recursive list of subdirectories.

+ *

+ * \param[in] indent Amount of space before file name. Used for recursive

+ * list to indicate subdirectory level.

+ */

+void SdFile::ls(uint8_t flags, uint8_t indent) {

+  dir_t* p;

+

+  rewind();

+  while ((p = readDirCache())) {

+    // done if past last used entry

+    if (p->name[0] == DIR_NAME_FREE) break;

+

+    // skip deleted entry and entries for . and  ..

+    if (p->name[0] == DIR_NAME_DELETED || p->name[0] == '.') continue;

+

+    // only list subdirectories and files

+    if (!DIR_IS_FILE_OR_SUBDIR(p)) continue;

+

+    // print any indent spaces

+    for (int8_t i = 0; i < indent; i++) Serial.print(' ');

+

+    // print file name with possible blank fill

+    printDirName(*p, flags & (LS_DATE | LS_SIZE) ? 14 : 0);

+

+    // print modify date/time if requested

+    if (flags & LS_DATE) {

+       printFatDate(p->lastWriteDate);

+       Serial.print(' ');

+       printFatTime(p->lastWriteTime);

+    }

+    // print size if requested

+    if (!DIR_IS_SUBDIR(p) && (flags & LS_SIZE)) {

+      Serial.print(' ');

+      Serial.print(p->fileSize);

+    }

+    Serial.println();

+

+    // list subdirectory content if requested

+    if ((flags & LS_R) && DIR_IS_SUBDIR(p)) {

+      uint16_t index = curPosition()/32 - 1;

+      SdFile s;

+      if (s.open(this, index, O_READ)) s.ls(flags, indent + 2);

+      seekSet(32 * (index + 1));

+    }

+  }

+}

+//------------------------------------------------------------------------------

+// format directory name field from a 8.3 name string

+uint8_t SdFile::make83Name(const char* str, uint8_t* name) {

+  uint8_t c;

+  uint8_t n = 7;  // max index for part before dot

+  uint8_t i = 0;

+  // blank fill name and extension

+  while (i < 11) name[i++] = ' ';

+  i = 0;

+  while ((c = *str++) != '\0') {

+    if (c == '.') {

+      if (n == 10) return false;  // only one dot allowed

+      n = 10;  // max index for full 8.3 name

+      i = 8;   // place for extension

+    } else {

+      // illegal FAT characters

+      PGM_P p = PSTR("|<>^+=?/[];,*\"\\");

+      uint8_t b;

+      while ((b = pgm_read_byte(p++))) if (b == c) return false;

+      // check size and only allow ASCII printable characters

+      if (i > n || c < 0X21 || c > 0X7E)return false;

+      // only upper case allowed in 8.3 names - convert lower to upper

+      name[i++] = c < 'a' || c > 'z' ?  c : c + ('A' - 'a');

+    }

+  }

+  // must have a file name, extension is optional

+  return name[0] != ' ';

+}

+//------------------------------------------------------------------------------

+/** Make a new directory.

+ *

+ * \param[in] dir An open SdFat instance for the directory that will containing

+ * the new directory.

+ *

+ * \param[in] dirName A valid 8.3 DOS name for the new directory.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ * Reasons for failure include this SdFile is already open, \a dir is not a

+ * directory, \a dirName is invalid or already exists in \a dir.

+ */

+uint8_t SdFile::makeDir(SdFile* dir, const char* dirName) {

+  dir_t d;

+

+  // create a normal file

+  if (!open(dir, dirName, O_CREAT | O_EXCL | O_RDWR)) return false;

+

+  // convert SdFile to directory

+  flags_ = O_READ;

+  type_ = FAT_FILE_TYPE_SUBDIR;

+

+  // allocate and zero first cluster

+  if (!addDirCluster())return false;

+

+  // force entry to SD

+  if (!sync()) return false;

+

+  // cache entry - should already be in cache due to sync() call

+  dir_t* p = cacheDirEntry(SdVolume::CACHE_FOR_WRITE);

+  if (!p) return false;

+

+  // change directory entry  attribute

+  p->attributes = DIR_ATT_DIRECTORY;

+

+  // make entry for '.'

+  memcpy(&d, p, sizeof(d));

+  for (uint8_t i = 1; i < 11; i++) d.name[i] = ' ';

+  d.name[0] = '.';

+

+  // cache block for '.'  and '..'

+  uint32_t block = vol_->clusterStartBlock(firstCluster_);

+  if (!SdVolume::cacheRawBlock(block, SdVolume::CACHE_FOR_WRITE)) return false;

+

+  // copy '.' to block

+  memcpy(&SdVolume::cacheBuffer_.dir[0], &d, sizeof(d));

+

+  // make entry for '..'

+  d.name[1] = '.';

+  if (dir->isRoot()) {

+    d.firstClusterLow = 0;

+    d.firstClusterHigh = 0;

+  } else {

+    d.firstClusterLow = dir->firstCluster_ & 0XFFFF;

+    d.firstClusterHigh = dir->firstCluster_ >> 16;

+  }

+  // copy '..' to block

+  memcpy(&SdVolume::cacheBuffer_.dir[1], &d, sizeof(d));

+

+  // set position after '..'

+  curPosition_ = 2 * sizeof(d);

+

+  // write first block

+  return SdVolume::cacheFlush();

+}

+//------------------------------------------------------------------------------

+/**

+ * Open a file or directory by name.

+ *

+ * \param[in] dirFile An open SdFat instance for the directory containing the

+ * file to be opened.

+ *

+ * \param[in] fileName A valid 8.3 DOS name for a file to be opened.

+ *

+ * \param[in] oflag Values for \a oflag are constructed by a bitwise-inclusive

+ * OR of flags from the following list

+ *

+ * O_READ - Open for reading.

+ *

+ * O_RDONLY - Same as O_READ.

+ *

+ * O_WRITE - Open for writing.

+ *

+ * O_WRONLY - Same as O_WRITE.

+ *

+ * O_RDWR - Open for reading and writing.

+ *

+ * O_APPEND - If set, the file offset shall be set to the end of the

+ * file prior to each write.

+ *

+ * O_CREAT - If the file exists, this flag has no effect except as noted

+ * under O_EXCL below. Otherwise, the file shall be created

+ *

+ * O_EXCL - If O_CREAT and O_EXCL are set, open() shall fail if the file exists.

+ *

+ * O_SYNC - Call sync() after each write.  This flag should not be used with

+ * write(uint8_t), write_P(PGM_P), writeln_P(PGM_P), or the Arduino Print class.

+ * These functions do character at a time writes so sync() will be called

+ * after each byte.

+ *

+ * O_TRUNC - If the file exists and is a regular file, and the file is

+ * successfully opened and is not read only, its length shall be truncated to 0.

+ *

+ * \note Directory files must be opened read only.  Write and truncation is

+ * not allowed for directory files.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ * Reasons for failure include this SdFile is already open, \a difFile is not

+ * a directory, \a fileName is invalid, the file does not exist

+ * or can't be opened in the access mode specified by oflag.

+ */

+uint8_t SdFile::open(SdFile* dirFile, const char* fileName, uint8_t oflag) {

+  uint8_t dname[11];

+  dir_t* p;

+

+  // error if already open

+  if (isOpen())return false;

+

+  if (!make83Name(fileName, dname)) return false;

+  vol_ = dirFile->vol_;

+  dirFile->rewind();

+

+  // bool for empty entry found

+  uint8_t emptyFound = false;

+

+  // search for file

+  while (dirFile->curPosition_ < dirFile->fileSize_) {

+    uint8_t index = 0XF & (dirFile->curPosition_ >> 5);

+    p = dirFile->readDirCache();

+    if (p == NULL) return false;

+

+    if (p->name[0] == DIR_NAME_FREE || p->name[0] == DIR_NAME_DELETED) {

+      // remember first empty slot

+      if (!emptyFound) {

+        emptyFound = true;

+        dirIndex_ = index;

+        dirBlock_ = SdVolume::cacheBlockNumber_;

+      }

+      // done if no entries follow

+      if (p->name[0] == DIR_NAME_FREE) break;

+    } else if (!memcmp(dname, p->name, 11)) {

+      // don't open existing file if O_CREAT and O_EXCL

+      if ((oflag & (O_CREAT | O_EXCL)) == (O_CREAT | O_EXCL)) return false;

+

+      // open found file

+      return openCachedEntry(0XF & index, oflag);

+    }

+  }

+  // only create file if O_CREAT and O_WRITE

+  if ((oflag & (O_CREAT | O_WRITE)) != (O_CREAT | O_WRITE)) return false;

+

+  // cache found slot or add cluster if end of file

+  if (emptyFound) {

+    p = cacheDirEntry(SdVolume::CACHE_FOR_WRITE);

+    if (!p) return false;

+  } else {

+    if (dirFile->type_ == FAT_FILE_TYPE_ROOT16) return false;

+

+    // add and zero cluster for dirFile - first cluster is in cache for write

+    if (!dirFile->addDirCluster()) return false;

+

+    // use first entry in cluster

+    dirIndex_ = 0;

+    p = SdVolume::cacheBuffer_.dir;

+  }

+  // initialize as empty file

+  memset(p, 0, sizeof(dir_t));

+  memcpy(p->name, dname, 11);

+

+  // set timestamps

+  if (dateTime_) {

+    // call user function

+    dateTime_(&p->creationDate, &p->creationTime);

+  } else {

+    // use default date/time

+    p->creationDate = FAT_DEFAULT_DATE;

+    p->creationTime = FAT_DEFAULT_TIME;

+  }

+  p->lastAccessDate = p->creationDate;

+  p->lastWriteDate = p->creationDate;

+  p->lastWriteTime = p->creationTime;

+

+  // force write of entry to SD

+  if (!SdVolume::cacheFlush()) return false;

+

+  // open entry in cache

+  return openCachedEntry(dirIndex_, oflag);

+}

+//------------------------------------------------------------------------------

+/**

+ * Open a file by index.

+ *

+ * \param[in] dirFile An open SdFat instance for the directory.

+ *

+ * \param[in] index The \a index of the directory entry for the file to be

+ * opened.  The value for \a index is (directory file position)/32.

+ *

+ * \param[in] oflag Values for \a oflag are constructed by a bitwise-inclusive

+ * OR of flags O_READ, O_WRITE, O_TRUNC, and O_SYNC.

+ *

+ * See open() by fileName for definition of flags and return values.

+ *

+ */

+uint8_t SdFile::open(SdFile* dirFile, uint16_t index, uint8_t oflag) {

+  // error if already open

+  if (isOpen())return false;

+

+  // don't open existing file if O_CREAT and O_EXCL - user call error

+  if ((oflag & (O_CREAT | O_EXCL)) == (O_CREAT | O_EXCL)) return false;

+

+  vol_ = dirFile->vol_;

+

+  // seek to location of entry

+  if (!dirFile->seekSet(32 * index)) return false;

+

+  // read entry into cache

+  dir_t* p = dirFile->readDirCache();

+  if (p == NULL) return false;

+

+  // error if empty slot or '.' or '..'

+  if (p->name[0] == DIR_NAME_FREE ||

+      p->name[0] == DIR_NAME_DELETED || p->name[0] == '.') {

+    return false;

+  }

+  // open cached entry

+  return openCachedEntry(index & 0XF, oflag);

+}

+//------------------------------------------------------------------------------

+// open a cached directory entry. Assumes vol_ is initializes

+uint8_t SdFile::openCachedEntry(uint8_t dirIndex, uint8_t oflag) {

+  // location of entry in cache

+  dir_t* p = SdVolume::cacheBuffer_.dir + dirIndex;

+

+  // write or truncate is an error for a directory or read-only file

+  if (p->attributes & (DIR_ATT_READ_ONLY | DIR_ATT_DIRECTORY)) {

+    if (oflag & (O_WRITE | O_TRUNC)) return false;

+  }

+  // remember location of directory entry on SD

+  dirIndex_ = dirIndex;

+  dirBlock_ = SdVolume::cacheBlockNumber_;

+

+  // copy first cluster number for directory fields

+  firstCluster_ = (uint32_t)p->firstClusterHigh << 16;

+  firstCluster_ |= p->firstClusterLow;

+

+  // make sure it is a normal file or subdirectory

+  if (DIR_IS_FILE(p)) {

+    fileSize_ = p->fileSize;

+    type_ = FAT_FILE_TYPE_NORMAL;

+  } else if (DIR_IS_SUBDIR(p)) {

+    if (!vol_->chainSize(firstCluster_, &fileSize_)) return false;

+    type_ = FAT_FILE_TYPE_SUBDIR;

+  } else {

+    return false;

+  }

+  // save open flags for read/write

+  flags_ = oflag & (O_ACCMODE | O_SYNC | O_APPEND);

+

+  // set to start of file

+  curCluster_ = 0;

+  curPosition_ = 0;

+

+  // truncate file to zero length if requested

+  if (oflag & O_TRUNC) return truncate(0);

+  return true;

+}

+//------------------------------------------------------------------------------

+/**

+ * Open a volume's root directory.

+ *

+ * \param[in] vol The FAT volume containing the root directory to be opened.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ * Reasons for failure include the FAT volume has not been initialized

+ * or it a FAT12 volume.

+ */

+uint8_t SdFile::openRoot(SdVolume* vol) {

+  // error if file is already open

+  if (isOpen()) return false;

+

+  if (vol->fatType() == 16) {

+    type_ = FAT_FILE_TYPE_ROOT16;

+    firstCluster_ = 0;

+    fileSize_ = 32 * vol->rootDirEntryCount();

+  } else if (vol->fatType() == 32) {

+    type_ = FAT_FILE_TYPE_ROOT32;

+    firstCluster_ = vol->rootDirStart();

+    if (!vol->chainSize(firstCluster_, &fileSize_)) return false;

+  } else {

+    // volume is not initialized or FAT12

+    return false;

+  }

+  vol_ = vol;

+  // read only

+  flags_ = O_READ;

+

+  // set to start of file

+  curCluster_ = 0;

+  curPosition_ = 0;

+

+  // root has no directory entry

+  dirBlock_ = 0;

+  dirIndex_ = 0;

+  return true;

+}

+//------------------------------------------------------------------------------

+/** %Print the name field of a directory entry in 8.3 format to Serial.

+ *

+ * \param[in] dir The directory structure containing the name.

+ * \param[in] width Blank fill name if length is less than \a width.

+ */

+void SdFile::printDirName(const dir_t& dir, uint8_t width) {

+  uint8_t w = 0;

+  for (uint8_t i = 0; i < 11; i++) {

+    if (dir.name[i] == ' ')continue;

+    if (i == 8) {

+      Serial.print('.');

+      w++;

+    }

+    Serial.print(dir.name[i]);

+    w++;

+  }

+  if (DIR_IS_SUBDIR(&dir)) {

+    Serial.print('/');

+    w++;

+  }

+  while (w < width) {

+    Serial.print(' ');

+    w++;

+  }

+}

+//------------------------------------------------------------------------------

+/** %Print a directory date field to Serial.

+ *

+ *  Format is yyyy-mm-dd.

+ *

+ * \param[in] fatDate The date field from a directory entry.

+ */

+void SdFile::printFatDate(uint16_t fatDate) {

+  Serial.print(FAT_YEAR(fatDate));

+  Serial.print('-');

+  printTwoDigits(FAT_MONTH(fatDate));

+  Serial.print('-');

+  printTwoDigits(FAT_DAY(fatDate));

+}

+//------------------------------------------------------------------------------

+/** %Print a directory time field to Serial.

+ *

+ * Format is hh:mm:ss.

+ *

+ * \param[in] fatTime The time field from a directory entry.

+ */

+void SdFile::printFatTime(uint16_t fatTime) {

+  printTwoDigits(FAT_HOUR(fatTime));

+  Serial.print(':');

+  printTwoDigits(FAT_MINUTE(fatTime));

+  Serial.print(':');

+  printTwoDigits(FAT_SECOND(fatTime));

+}

+//------------------------------------------------------------------------------

+/** %Print a value as two digits to Serial.

+ *

+ * \param[in] v Value to be printed, 0 <= \a v <= 99

+ */

+void SdFile::printTwoDigits(uint8_t v) {

+  char str[3];

+  str[0] = '0' + v/10;

+  str[1] = '0' + v % 10;

+  str[2] = 0;

+  Serial.print(str);

+}

+//------------------------------------------------------------------------------

+/**

+ * Read data from a file starting at the current position.

+ *

+ * \param[out] buf Pointer to the location that will receive the data.

+ *

+ * \param[in] nbyte Maximum number of bytes to read.

+ *

+ * \return For success read() returns the number of bytes read.

+ * A value less than \a nbyte, including zero, will be returned

+ * if end of file is reached.

+ * If an error occurs, read() returns -1.  Possible errors include

+ * read() called before a file has been opened, corrupt file system

+ * or an I/O error occurred.

+ */

+int16_t SdFile::read(void* buf, uint16_t nbyte) {

+  uint8_t* dst = reinterpret_cast<uint8_t*>(buf);

+

+  // error if not open or write only

+  if (!isOpen() || !(flags_ & O_READ)) return -1;

+

+  // max bytes left in file

+  if (nbyte > (fileSize_ - curPosition_)) nbyte = fileSize_ - curPosition_;

+

+  // amount left to read

+  uint16_t toRead = nbyte;

+  while (toRead > 0) {

+    uint32_t block;  // raw device block number

+    uint16_t offset = curPosition_ & 0X1FF;  // offset in block

+    if (type_ == FAT_FILE_TYPE_ROOT16) {

+      block = vol_->rootDirStart() + (curPosition_ >> 9);

+    } else {

+      uint8_t blockOfCluster = vol_->blockOfCluster(curPosition_);

+      if (offset == 0 && blockOfCluster == 0) {

+        // start of new cluster

+        if (curPosition_ == 0) {

+          // use first cluster in file

+          curCluster_ = firstCluster_;

+        } else {

+          // get next cluster from FAT

+          if (!vol_->fatGet(curCluster_, &curCluster_)) return -1;

+        }

+      }

+      block = vol_->clusterStartBlock(curCluster_) + blockOfCluster;

+    }

+    uint16_t n = toRead;

+

+    // amount to be read from current block

+    if (n > (512 - offset)) n = 512 - offset;

+

+    // no buffering needed if n == 512 or user requests no buffering

+    if ((unbufferedRead() || n == 512) &&

+      block != SdVolume::cacheBlockNumber_) {

+      if (!vol_->readData(block, offset, n, dst)) return -1;

+      dst += n;

+    } else {

+      // read block to cache and copy data to caller

+      if (!SdVolume::cacheRawBlock(block, SdVolume::CACHE_FOR_READ)) return -1;

+      uint8_t* src = SdVolume::cacheBuffer_.data + offset;

+      uint8_t* end = src + n;

+      while (src != end) *dst++ = *src++;

+    }

+    curPosition_ += n;

+    toRead -= n;

+  }

+  return nbyte;

+}

+//------------------------------------------------------------------------------

+/**

+ * Read the next directory entry from a directory file.

+ *

+ * \param[out] dir The dir_t struct that will receive the data.

+ *

+ * \return For success readDir() returns the number of bytes read.

+ * A value of zero will be returned if end of file is reached.

+ * If an error occurs, readDir() returns -1.  Possible errors include

+ * readDir() called before a directory has been opened, this is not

+ * a directory file or an I/O error occurred.

+ */

+int8_t SdFile::readDir(dir_t* dir) {

+  int8_t n;

+  // if not a directory file or miss-positioned return an error

+  if (!isDir() || (0X1F & curPosition_)) return -1;

+

+  while ((n = read(dir, sizeof(dir_t))) == sizeof(dir_t)) {

+    // last entry if DIR_NAME_FREE

+    if (dir->name[0] == DIR_NAME_FREE) break;

+    // skip empty entries and entry for .  and ..

+    if (dir->name[0] == DIR_NAME_DELETED || dir->name[0] == '.') continue;

+    // return if normal file or subdirectory

+    if (DIR_IS_FILE_OR_SUBDIR(dir)) return n;

+  }

+  // error, end of file, or past last entry

+  return n < 0 ? -1 : 0;

+}

+//------------------------------------------------------------------------------

+// Read next directory entry into the cache

+// Assumes file is correctly positioned

+dir_t* SdFile::readDirCache(void) {

+  // error if not directory

+  if (!isDir()) return NULL;

+

+  // index of entry in cache

+  uint8_t i = (curPosition_ >> 5) & 0XF;

+

+  // use read to locate and cache block

+  if (read() < 0) return NULL;

+

+  // advance to next entry

+  curPosition_ += 31;

+

+  // return pointer to entry

+  return (SdVolume::cacheBuffer_.dir + i);

+}

+//------------------------------------------------------------------------------

+/**

+ * Remove a file.

+ *

+ * The directory entry and all data for the file are deleted.

+ *

+ * \note This function should not be used to delete the 8.3 version of a

+ * file that has a long name. For example if a file has the long name

+ * "New Text Document.txt" you should not delete the 8.3 name "NEWTEX~1.TXT".

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ * Reasons for failure include the file read-only, is a directory,

+ * or an I/O error occurred.

+ */

+uint8_t SdFile::remove(void) {

+  // free any clusters - will fail if read-only or directory

+  if (!truncate(0)) return false;

+

+  // cache directory entry

+  dir_t* d = cacheDirEntry(SdVolume::CACHE_FOR_WRITE);

+  if (!d) return false;

+

+  // mark entry deleted

+  d->name[0] = DIR_NAME_DELETED;

+

+  // set this SdFile closed

+  type_ = FAT_FILE_TYPE_CLOSED;

+

+  // write entry to SD

+  return SdVolume::cacheFlush();

+}

+//------------------------------------------------------------------------------

+/**

+ * Remove a file.

+ *

+ * The directory entry and all data for the file are deleted.

+ *

+ * \param[in] dirFile The directory that contains the file.

+ * \param[in] fileName The name of the file to be removed.

+ *

+ * \note This function should not be used to delete the 8.3 version of a

+ * file that has a long name. For example if a file has the long name

+ * "New Text Document.txt" you should not delete the 8.3 name "NEWTEX~1.TXT".

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ * Reasons for failure include the file is a directory, is read only,

+ * \a dirFile is not a directory, \a fileName is not found

+ * or an I/O error occurred.

+ */

+uint8_t SdFile::remove(SdFile* dirFile, const char* fileName) {

+  SdFile file;

+  if (!file.open(dirFile, fileName, O_WRITE)) return false;

+  return file.remove();

+}

+//------------------------------------------------------------------------------

+/** Remove a directory file.

+ *

+ * The directory file will be removed only if it is empty and is not the

+ * root directory.  rmDir() follows DOS and Windows and ignores the

+ * read-only attribute for the directory.

+ *

+ * \note This function should not be used to delete the 8.3 version of a

+ * directory that has a long name. For example if a directory has the

+ * long name "New folder" you should not delete the 8.3 name "NEWFOL~1".

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ * Reasons for failure include the file is not a directory, is the root

+ * directory, is not empty, or an I/O error occurred.

+ */

+uint8_t SdFile::rmDir(void) {

+  // must be open subdirectory

+  if (!isSubDir()) return false;

+

+  rewind();

+

+  // make sure directory is empty

+  while (curPosition_ < fileSize_) {

+    dir_t* p = readDirCache();

+    if (p == NULL) return false;

+    // done if past last used entry

+    if (p->name[0] == DIR_NAME_FREE) break;

+    // skip empty slot or '.' or '..'

+    if (p->name[0] == DIR_NAME_DELETED || p->name[0] == '.') continue;

+    // error not empty

+    if (DIR_IS_FILE_OR_SUBDIR(p)) return false;

+  }

+  // convert empty directory to normal file for remove

+  type_ = FAT_FILE_TYPE_NORMAL;

+  flags_ |= O_WRITE;

+  return remove();

+}

+//------------------------------------------------------------------------------

+/** Recursively delete a directory and all contained files.

+ *

+ * This is like the Unix/Linux 'rm -rf *' if called with the root directory

+ * hence the name.

+ *

+ * Warning - This will remove all contents of the directory including

+ * subdirectories.  The directory will then be removed if it is not root.

+ * The read-only attribute for files will be ignored.

+ *

+ * \note This function should not be used to delete the 8.3 version of

+ * a directory that has a long name.  See remove() and rmDir().

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ */

+uint8_t SdFile::rmRfStar(void) {

+  rewind();

+  while (curPosition_ < fileSize_) {

+    SdFile f;

+

+    // remember position

+    uint16_t index = curPosition_/32;

+

+    dir_t* p = readDirCache();

+    if (!p) return false;

+

+    // done if past last entry

+    if (p->name[0] == DIR_NAME_FREE) break;

+

+    // skip empty slot or '.' or '..'

+    if (p->name[0] == DIR_NAME_DELETED || p->name[0] == '.') continue;

+

+    // skip if part of long file name or volume label in root

+    if (!DIR_IS_FILE_OR_SUBDIR(p)) continue;

+

+    if (!f.open(this, index, O_READ)) return false;

+    if (f.isSubDir()) {

+      // recursively delete

+      if (!f.rmRfStar()) return false;

+    } else {

+      // ignore read-only

+      f.flags_ |= O_WRITE;

+      if (!f.remove()) return false;

+    }

+    // position to next entry if required

+    if (curPosition_ != (32*(index + 1))) {

+      if (!seekSet(32*(index + 1))) return false;

+    }

+  }

+  // don't try to delete root

+  if (isRoot()) return true;

+  return rmDir();

+}

+//------------------------------------------------------------------------------

+/**

+ * Sets a file's position.

+ *

+ * \param[in] pos The new position in bytes from the beginning of the file.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ */

+uint8_t SdFile::seekSet(uint32_t pos) {

+  // error if file not open or seek past end of file

+  if (!isOpen() || pos > fileSize_) return false;

+

+  if (type_ == FAT_FILE_TYPE_ROOT16) {

+    curPosition_ = pos;

+    return true;

+  }

+  if (pos == 0) {

+    // set position to start of file

+    curCluster_ = 0;

+    curPosition_ = 0;

+    return true;

+  }

+  // calculate cluster index for cur and new position

+  uint32_t nCur = (curPosition_ - 1) >> (vol_->clusterSizeShift_ + 9);

+  uint32_t nNew = (pos - 1) >> (vol_->clusterSizeShift_ + 9);

+

+  if (nNew < nCur || curPosition_ == 0) {

+    // must follow chain from first cluster

+    curCluster_ = firstCluster_;

+  } else {

+    // advance from curPosition

+    nNew -= nCur;

+  }

+  while (nNew--) {

+    if (!vol_->fatGet(curCluster_, &curCluster_)) return false;

+  }

+  curPosition_ = pos;

+  return true;

+}

+//------------------------------------------------------------------------------

+/**

+ * The sync() call causes all modified data and directory fields

+ * to be written to the storage device.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ * Reasons for failure include a call to sync() before a file has been

+ * opened or an I/O error.

+ */

+uint8_t SdFile::sync(void) {

+  // only allow open files and directories

+  if (!isOpen()) return false;

+

+  if (flags_ & F_FILE_DIR_DIRTY) {

+    dir_t* d = cacheDirEntry(SdVolume::CACHE_FOR_WRITE);

+    if (!d) return false;

+

+    // do not set filesize for dir files

+    if (!isDir()) d->fileSize = fileSize_;

+

+    // update first cluster fields

+    d->firstClusterLow = firstCluster_ & 0XFFFF;

+    d->firstClusterHigh = firstCluster_ >> 16;

+

+    // set modify time if user supplied a callback date/time function

+    if (dateTime_) {

+      dateTime_(&d->lastWriteDate, &d->lastWriteTime);

+      d->lastAccessDate = d->lastWriteDate;

+    }

+    // clear directory dirty

+    flags_ &= ~F_FILE_DIR_DIRTY;

+  }

+  return SdVolume::cacheFlush();

+}

+//------------------------------------------------------------------------------

+/**

+ * Set a file's timestamps in its directory entry.

+ *

+ * \param[in] flags Values for \a flags are constructed by a bitwise-inclusive

+ * OR of flags from the following list

+ *

+ * T_ACCESS - Set the file's last access date.

+ *

+ * T_CREATE - Set the file's creation date and time.

+ *

+ * T_WRITE - Set the file's last write/modification date and time.

+ *

+ * \param[in] year Valid range 1980 - 2107 inclusive.

+ *

+ * \param[in] month Valid range 1 - 12 inclusive.

+ *

+ * \param[in] day Valid range 1 - 31 inclusive.

+ *

+ * \param[in] hour Valid range 0 - 23 inclusive.

+ *

+ * \param[in] minute Valid range 0 - 59 inclusive.

+ *

+ * \param[in] second Valid range 0 - 59 inclusive

+ *

+ * \note It is possible to set an invalid date since there is no check for

+ * the number of days in a month.

+ *

+ * \note

+ * Modify and access timestamps may be overwritten if a date time callback

+ * function has been set by dateTimeCallback().

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ */

+uint8_t SdFile::timestamp(uint8_t flags, uint16_t year, uint8_t month,

+         uint8_t day, uint8_t hour, uint8_t minute, uint8_t second) {

+  if (!isOpen()

+    || year < 1980

+    || year > 2107

+    || month < 1

+    || month > 12

+    || day < 1

+    || day > 31

+    || hour > 23

+    || minute > 59

+    || second > 59) {

+      return false;

+  }

+  dir_t* d = cacheDirEntry(SdVolume::CACHE_FOR_WRITE);

+  if (!d) return false;

+

+  uint16_t dirDate = FAT_DATE(year, month, day);

+  uint16_t dirTime = FAT_TIME(hour, minute, second);

+  if (flags & T_ACCESS) {

+    d->lastAccessDate = dirDate;

+  }

+  if (flags & T_CREATE) {

+    d->creationDate = dirDate;

+    d->creationTime = dirTime;

+    // seems to be units of 1/100 second not 1/10 as Microsoft states

+    d->creationTimeTenths = second & 1 ? 100 : 0;

+  }

+  if (flags & T_WRITE) {

+    d->lastWriteDate = dirDate;

+    d->lastWriteTime = dirTime;

+  }

+  SdVolume::cacheSetDirty();

+  return sync();

+}

+//------------------------------------------------------------------------------

+/**

+ * Truncate a file to a specified length.  The current file position

+ * will be maintained if it is less than or equal to \a length otherwise

+ * it will be set to end of file.

+ *

+ * \param[in] length The desired length for the file.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.

+ * Reasons for failure include file is read only, file is a directory,

+ * \a length is greater than the current file size or an I/O error occurs.

+ */

+uint8_t SdFile::truncate(uint32_t length) {

+// error if not a normal file or read-only

+  if (!isFile() || !(flags_ & O_WRITE)) return false;

+

+  // error if length is greater than current size

+  if (length > fileSize_) return false;

+

+  // fileSize and length are zero - nothing to do

+  if (fileSize_ == 0) return true;

+

+  // remember position for seek after truncation

+  uint32_t newPos = curPosition_ > length ? length : curPosition_;

+

+  // position to last cluster in truncated file

+  if (!seekSet(length)) return false;

+

+  if (length == 0) {

+    // free all clusters

+    if (!vol_->freeChain(firstCluster_)) return false;

+    firstCluster_ = 0;

+  } else {

+    uint32_t toFree;

+    if (!vol_->fatGet(curCluster_, &toFree)) return false;

+

+    if (!vol_->isEOC(toFree)) {

+      // free extra clusters

+      if (!vol_->freeChain(toFree)) return false;

+

+      // current cluster is end of chain

+      if (!vol_->fatPutEOC(curCluster_)) return false;

+    }

+  }

+  fileSize_ = length;

+

+  // need to update directory entry

+  flags_ |= F_FILE_DIR_DIRTY;

+

+  if (!sync()) return false;

+

+  // set file to correct position

+  return seekSet(newPos);

+}

+//------------------------------------------------------------------------------

+/**

+ * Write data to an open file.

+ *

+ * \note Data is moved to the cache but may not be written to the

+ * storage device until sync() is called.

+ *

+ * \param[in] buf Pointer to the location of the data to be written.

+ *

+ * \param[in] nbyte Number of bytes to write.

+ *

+ * \return For success write() returns the number of bytes written, always

+ * \a nbyte.  If an error occurs, write() returns -1.  Possible errors

+ * include write() is called before a file has been opened, write is called

+ * for a read-only file, device is full, a corrupt file system or an I/O error.

+ *

+ */

+int16_t SdFile::write(const void* buf, uint16_t nbyte) {

+  // convert void* to uint8_t*  -  must be before goto statements

+  const uint8_t* src = reinterpret_cast<const uint8_t*>(buf);

+

+  // number of bytes left to write  -  must be before goto statements

+  uint16_t nToWrite = nbyte;

+

+  // error if not a normal file or is read-only

+  if (!isFile() || !(flags_ & O_WRITE)) goto writeErrorReturn;

+

+  // seek to end of file if append flag

+  if ((flags_ & O_APPEND) && curPosition_ != fileSize_) {

+    if (!seekEnd()) goto writeErrorReturn;

+  }

+

+  while (nToWrite > 0) {

+    uint8_t blockOfCluster = vol_->blockOfCluster(curPosition_);

+    uint16_t blockOffset = curPosition_ & 0X1FF;

+    if (blockOfCluster == 0 && blockOffset == 0) {

+      // start of new cluster

+      if (curCluster_ == 0) {

+        if (firstCluster_ == 0) {

+          // allocate first cluster of file

+          if (!addCluster()) goto writeErrorReturn;

+        } else {

+          curCluster_ = firstCluster_;

+        }

+      } else {

+        uint32_t next;

+        if (!vol_->fatGet(curCluster_, &next)) return false;

+        if (vol_->isEOC(next)) {

+          // add cluster if at end of chain

+          if (!addCluster()) goto writeErrorReturn;

+        } else {

+          curCluster_ = next;

+        }

+      }

+    }

+    // max space in block

+    uint16_t n = 512 - blockOffset;

+

+    // lesser of space and amount to write

+    if (n > nToWrite) n = nToWrite;

+

+    // block for data write

+    uint32_t block = vol_->clusterStartBlock(curCluster_) + blockOfCluster;

+    if (n == 512) {

+      // full block - don't need to use cache

+      // invalidate cache if block is in cache

+      if (SdVolume::cacheBlockNumber_ == block) {

+        SdVolume::cacheBlockNumber_ = 0XFFFFFFFF;

+      }

+      if (!vol_->writeBlock(block, src)) goto writeErrorReturn;

+      src += 512;

+    } else {

+      if (blockOffset == 0 && curPosition_ >= fileSize_) {

+        // start of new block don't need to read into cache

+        if (!SdVolume::cacheFlush()) goto writeErrorReturn;

+        SdVolume::cacheBlockNumber_ = block;

+        SdVolume::cacheSetDirty();

+      } else {

+        // rewrite part of block

+        if (!SdVolume::cacheRawBlock(block, SdVolume::CACHE_FOR_WRITE)) {

+          goto writeErrorReturn;

+        }

+      }

+      uint8_t* dst = SdVolume::cacheBuffer_.data + blockOffset;

+      uint8_t* end = dst + n;

+      while (dst != end) *dst++ = *src++;

+    }

+    nToWrite -= n;

+    curPosition_ += n;

+  }

+  if (curPosition_ > fileSize_) {

+    // update fileSize and insure sync will update dir entry

+    fileSize_ = curPosition_;

+    flags_ |= F_FILE_DIR_DIRTY;

+  } else if (dateTime_ && nbyte) {

+    // insure sync will update modified date and time

+    flags_ |= F_FILE_DIR_DIRTY;

+  }

+

+  if (flags_ & O_SYNC) {

+    if (!sync()) goto writeErrorReturn;

+  }

+  return nbyte;

+

+ writeErrorReturn:

+  // return for write error

+  writeError = true;

+  return -1;

+}

+//------------------------------------------------------------------------------

+/**

+ * Write a byte to a file. Required by the Arduino Print class.

+ *

+ * Use SdFile::writeError to check for errors.

+ */

+void SdFile::write(uint8_t b) {

+  write(&b, 1);

+}

+//------------------------------------------------------------------------------

+/**

+ * Write a string to a file. Used by the Arduino Print class.

+ *

+ * Use SdFile::writeError to check for errors.

+ */

+void SdFile::write(const char* str) {

+  write(str, strlen(str));

+}

+//------------------------------------------------------------------------------

+/**

+ * Write a PROGMEM string to a file.

+ *

+ * Use SdFile::writeError to check for errors.

+ */

+void SdFile::write_P(PGM_P str) {

+  for (uint8_t c; (c = pgm_read_byte(str)); str++) write(c);

+}

+//------------------------------------------------------------------------------

+/**

+ * Write a PROGMEM string followed by CR/LF to a file.

+ *

+ * Use SdFile::writeError to check for errors.

+ */

+void SdFile::writeln_P(PGM_P str) {

+  write_P(str);

+  println();

+}

diff --git a/libraries/SD/utility/SdInfo.h b/libraries/SD/utility/SdInfo.h
new file mode 100644
index 0000000..acde74d
--- /dev/null
+++ b/libraries/SD/utility/SdInfo.h
@@ -0,0 +1,232 @@
+/* Arduino Sd2Card Library

+ * Copyright (C) 2009 by William Greiman

+ *

+ * This file is part of the Arduino Sd2Card Library

+ *

+ * This Library is free software: you can redistribute it and/or modify

+ * it under the terms of the GNU General Public License as published by

+ * the Free Software Foundation, either version 3 of the License, or

+ * (at your option) any later version.

+ *

+ * This Library is distributed in the hope that it will be useful,

+ * but WITHOUT ANY WARRANTY; without even the implied warranty of

+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+ * GNU General Public License for more details.

+ *

+ * You should have received a copy of the GNU General Public License

+ * along with the Arduino Sd2Card Library.  If not, see

+ * <http://www.gnu.org/licenses/>.

+ */

+#ifndef SdInfo_h

+#define SdInfo_h

+#include <stdint.h>

+// Based on the document:

+//

+// SD Specifications

+// Part 1

+// Physical Layer

+// Simplified Specification

+// Version 2.00

+// September 25, 2006

+//

+// www.sdcard.org/developers/tech/sdcard/pls/Simplified_Physical_Layer_Spec.pdf

+//------------------------------------------------------------------------------

+// SD card commands

+/** GO_IDLE_STATE - init card in spi mode if CS low */

+uint8_t const CMD0 = 0X00;

+/** SEND_IF_COND - verify SD Memory Card interface operating condition.*/

+uint8_t const CMD8 = 0X08;

+/** SEND_CSD - read the Card Specific Data (CSD register) */

+uint8_t const CMD9 = 0X09;

+/** SEND_CID - read the card identification information (CID register) */

+uint8_t const CMD10 = 0X0A;

+/** SEND_STATUS - read the card status register */

+uint8_t const CMD13 = 0X0D;

+/** READ_BLOCK - read a single data block from the card */

+uint8_t const CMD17 = 0X11;

+/** WRITE_BLOCK - write a single data block to the card */

+uint8_t const CMD24 = 0X18;

+/** WRITE_MULTIPLE_BLOCK - write blocks of data until a STOP_TRANSMISSION */

+uint8_t const CMD25 = 0X19;

+/** ERASE_WR_BLK_START - sets the address of the first block to be erased */

+uint8_t const CMD32 = 0X20;

+/** ERASE_WR_BLK_END - sets the address of the last block of the continuous

+    range to be erased*/

+uint8_t const CMD33 = 0X21;

+/** ERASE - erase all previously selected blocks */

+uint8_t const CMD38 = 0X26;

+/** APP_CMD - escape for application specific command */

+uint8_t const CMD55 = 0X37;

+/** READ_OCR - read the OCR register of a card */

+uint8_t const CMD58 = 0X3A;

+/** SET_WR_BLK_ERASE_COUNT - Set the number of write blocks to be

+     pre-erased before writing */

+uint8_t const ACMD23 = 0X17;

+/** SD_SEND_OP_COMD - Sends host capacity support information and

+    activates the card's initialization process */

+uint8_t const ACMD41 = 0X29;

+//------------------------------------------------------------------------------

+/** status for card in the ready state */

+uint8_t const R1_READY_STATE = 0X00;

+/** status for card in the idle state */

+uint8_t const R1_IDLE_STATE = 0X01;

+/** status bit for illegal command */

+uint8_t const R1_ILLEGAL_COMMAND = 0X04;

+/** start data token for read or write single block*/

+uint8_t const DATA_START_BLOCK = 0XFE;

+/** stop token for write multiple blocks*/

+uint8_t const STOP_TRAN_TOKEN = 0XFD;

+/** start data token for write multiple blocks*/

+uint8_t const WRITE_MULTIPLE_TOKEN = 0XFC;

+/** mask for data response tokens after a write block operation */

+uint8_t const DATA_RES_MASK = 0X1F;

+/** write data accepted token */

+uint8_t const DATA_RES_ACCEPTED = 0X05;

+//------------------------------------------------------------------------------

+typedef struct CID {

+  // byte 0

+  uint8_t mid;  // Manufacturer ID

+  // byte 1-2

+  char oid[2];  // OEM/Application ID

+  // byte 3-7

+  char pnm[5];  // Product name

+  // byte 8

+  unsigned prv_m : 4;  // Product revision n.m

+  unsigned prv_n : 4;

+  // byte 9-12

+  uint32_t psn;  // Product serial number

+  // byte 13

+  unsigned mdt_year_high : 4;  // Manufacturing date

+  unsigned reserved : 4;

+  // byte 14

+  unsigned mdt_month : 4;

+  unsigned mdt_year_low :4;

+  // byte 15

+  unsigned always1 : 1;

+  unsigned crc : 7;

+}cid_t;

+//------------------------------------------------------------------------------

+// CSD for version 1.00 cards

+typedef struct CSDV1 {

+  // byte 0

+  unsigned reserved1 : 6;

+  unsigned csd_ver : 2;

+  // byte 1

+  uint8_t taac;

+  // byte 2

+  uint8_t nsac;

+  // byte 3

+  uint8_t tran_speed;

+  // byte 4

+  uint8_t ccc_high;

+  // byte 5

+  unsigned read_bl_len : 4;

+  unsigned ccc_low : 4;

+  // byte 6

+  unsigned c_size_high : 2;

+  unsigned reserved2 : 2;

+  unsigned dsr_imp : 1;

+  unsigned read_blk_misalign :1;

+  unsigned write_blk_misalign : 1;

+  unsigned read_bl_partial : 1;

+  // byte 7

+  uint8_t c_size_mid;

+  // byte 8

+  unsigned vdd_r_curr_max : 3;

+  unsigned vdd_r_curr_min : 3;

+  unsigned c_size_low :2;

+  // byte 9

+  unsigned c_size_mult_high : 2;

+  unsigned vdd_w_cur_max : 3;

+  unsigned vdd_w_curr_min : 3;

+  // byte 10

+  unsigned sector_size_high : 6;

+  unsigned erase_blk_en : 1;

+  unsigned c_size_mult_low : 1;

+  // byte 11

+  unsigned wp_grp_size : 7;

+  unsigned sector_size_low : 1;

+  // byte 12

+  unsigned write_bl_len_high : 2;

+  unsigned r2w_factor : 3;

+  unsigned reserved3 : 2;

+  unsigned wp_grp_enable : 1;

+  // byte 13

+  unsigned reserved4 : 5;

+  unsigned write_partial : 1;

+  unsigned write_bl_len_low : 2;

+  // byte 14

+  unsigned reserved5: 2;

+  unsigned file_format : 2;

+  unsigned tmp_write_protect : 1;

+  unsigned perm_write_protect : 1;

+  unsigned copy : 1;

+  unsigned file_format_grp : 1;

+  // byte 15

+  unsigned always1 : 1;

+  unsigned crc : 7;

+}csd1_t;

+//------------------------------------------------------------------------------

+// CSD for version 2.00 cards

+typedef struct CSDV2 {

+  // byte 0

+  unsigned reserved1 : 6;

+  unsigned csd_ver : 2;

+  // byte 1

+  uint8_t taac;

+  // byte 2

+  uint8_t nsac;

+  // byte 3

+  uint8_t tran_speed;

+  // byte 4

+  uint8_t ccc_high;

+  // byte 5

+  unsigned read_bl_len : 4;

+  unsigned ccc_low : 4;

+  // byte 6

+  unsigned reserved2 : 4;

+  unsigned dsr_imp : 1;

+  unsigned read_blk_misalign :1;

+  unsigned write_blk_misalign : 1;

+  unsigned read_bl_partial : 1;

+  // byte 7

+  unsigned reserved3 : 2;

+  unsigned c_size_high : 6;

+  // byte 8

+  uint8_t c_size_mid;

+  // byte 9

+  uint8_t c_size_low;

+  // byte 10

+  unsigned sector_size_high : 6;

+  unsigned erase_blk_en : 1;

+  unsigned reserved4 : 1;

+  // byte 11

+  unsigned wp_grp_size : 7;

+  unsigned sector_size_low : 1;

+  // byte 12

+  unsigned write_bl_len_high : 2;

+  unsigned r2w_factor : 3;

+  unsigned reserved5 : 2;

+  unsigned wp_grp_enable : 1;

+  // byte 13

+  unsigned reserved6 : 5;

+  unsigned write_partial : 1;

+  unsigned write_bl_len_low : 2;

+  // byte 14

+  unsigned reserved7: 2;

+  unsigned file_format : 2;

+  unsigned tmp_write_protect : 1;

+  unsigned perm_write_protect : 1;

+  unsigned copy : 1;

+  unsigned file_format_grp : 1;

+  // byte 15

+  unsigned always1 : 1;

+  unsigned crc : 7;

+}csd2_t;

+//------------------------------------------------------------------------------

+// union of old and new style CSD register

+union csd_t {

+  csd1_t v1;

+  csd2_t v2;

+};

+#endif  // SdInfo_h

diff --git a/libraries/SD/utility/SdVolume.cpp b/libraries/SD/utility/SdVolume.cpp
new file mode 100644
index 0000000..ece4acb
--- /dev/null
+++ b/libraries/SD/utility/SdVolume.cpp
@@ -0,0 +1,295 @@
+/* Arduino SdFat Library

+ * Copyright (C) 2009 by William Greiman

+ *

+ * This file is part of the Arduino SdFat Library

+ *

+ * This Library is free software: you can redistribute it and/or modify

+ * it under the terms of the GNU General Public License as published by

+ * the Free Software Foundation, either version 3 of the License, or

+ * (at your option) any later version.

+ *

+ * This Library is distributed in the hope that it will be useful,

+ * but WITHOUT ANY WARRANTY; without even the implied warranty of

+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+ * GNU General Public License for more details.

+ *

+ * You should have received a copy of the GNU General Public License

+ * along with the Arduino SdFat Library.  If not, see

+ * <http://www.gnu.org/licenses/>.

+ */

+#include <SdFat.h>

+//------------------------------------------------------------------------------

+// raw block cache

+// init cacheBlockNumber_to invalid SD block number

+uint32_t SdVolume::cacheBlockNumber_ = 0XFFFFFFFF;

+cache_t  SdVolume::cacheBuffer_;     // 512 byte cache for Sd2Card

+Sd2Card* SdVolume::sdCard_;          // pointer to SD card object

+uint8_t  SdVolume::cacheDirty_ = 0;  // cacheFlush() will write block if true

+uint32_t SdVolume::cacheMirrorBlock_ = 0;  // mirror  block for second FAT

+//------------------------------------------------------------------------------

+// find a contiguous group of clusters

+uint8_t SdVolume::allocContiguous(uint32_t count, uint32_t* curCluster) {

+  // start of group

+  uint32_t bgnCluster;

+

+  // flag to save place to start next search

+  uint8_t setStart;

+

+  // set search start cluster

+  if (*curCluster) {

+    // try to make file contiguous

+    bgnCluster = *curCluster + 1;

+

+    // don't save new start location

+    setStart = false;

+  } else {

+    // start at likely place for free cluster

+    bgnCluster = allocSearchStart_;

+

+    // save next search start if one cluster

+    setStart = 1 == count;

+  }

+  // end of group

+  uint32_t endCluster = bgnCluster;

+

+  // last cluster of FAT

+  uint32_t fatEnd = clusterCount_ + 1;

+

+  // search the FAT for free clusters

+  for (uint32_t n = 0;; n++, endCluster++) {

+    // can't find space checked all clusters

+    if (n >= clusterCount_) return false;

+

+    // past end - start from beginning of FAT

+    if (endCluster > fatEnd) {

+      bgnCluster = endCluster = 2;

+    }

+    uint32_t f;

+    if (!fatGet(endCluster, &f)) return false;

+

+    if (f != 0) {

+      // cluster in use try next cluster as bgnCluster

+      bgnCluster = endCluster + 1;

+    } else if ((endCluster - bgnCluster + 1) == count) {

+      // done - found space

+      break;

+    }

+  }

+  // mark end of chain

+  if (!fatPutEOC(endCluster)) return false;

+

+  // link clusters

+  while (endCluster > bgnCluster) {

+    if (!fatPut(endCluster - 1, endCluster)) return false;

+    endCluster--;

+  }

+  if (*curCluster != 0) {

+    // connect chains

+    if (!fatPut(*curCluster, bgnCluster)) return false;

+  }

+  // return first cluster number to caller

+  *curCluster = bgnCluster;

+

+  // remember possible next free cluster

+  if (setStart) allocSearchStart_ = bgnCluster + 1;

+

+  return true;

+}

+//------------------------------------------------------------------------------

+uint8_t SdVolume::cacheFlush(void) {

+  if (cacheDirty_) {

+    if (!sdCard_->writeBlock(cacheBlockNumber_, cacheBuffer_.data)) {

+      return false;

+    }

+    // mirror FAT tables

+    if (cacheMirrorBlock_) {

+      if (!sdCard_->writeBlock(cacheMirrorBlock_, cacheBuffer_.data)) {

+        return false;

+      }

+      cacheMirrorBlock_ = 0;

+    }

+    cacheDirty_ = 0;

+  }

+  return true;

+}

+//------------------------------------------------------------------------------

+uint8_t SdVolume::cacheRawBlock(uint32_t blockNumber, uint8_t action) {

+  if (cacheBlockNumber_ != blockNumber) {

+    if (!cacheFlush()) return false;

+    if (!sdCard_->readBlock(blockNumber, cacheBuffer_.data)) return false;

+    cacheBlockNumber_ = blockNumber;

+  }

+  cacheDirty_ |= action;

+  return true;

+}

+//------------------------------------------------------------------------------

+// cache a zero block for blockNumber

+uint8_t SdVolume::cacheZeroBlock(uint32_t blockNumber) {

+  if (!cacheFlush()) return false;

+

+  // loop take less flash than memset(cacheBuffer_.data, 0, 512);

+  for (uint16_t i = 0; i < 512; i++) {

+    cacheBuffer_.data[i] = 0;

+  }

+  cacheBlockNumber_ = blockNumber;

+  cacheSetDirty();

+  return true;

+}

+//------------------------------------------------------------------------------

+// return the size in bytes of a cluster chain

+uint8_t SdVolume::chainSize(uint32_t cluster, uint32_t* size) const {

+  uint32_t s = 0;

+  do {

+    if (!fatGet(cluster, &cluster)) return false;

+    s += 512UL << clusterSizeShift_;

+  } while (!isEOC(cluster));

+  *size = s;

+  return true;

+}

+//------------------------------------------------------------------------------

+// Fetch a FAT entry

+uint8_t SdVolume::fatGet(uint32_t cluster, uint32_t* value) const {

+  if (cluster > (clusterCount_ + 1)) return false;

+  uint32_t lba = fatStartBlock_;

+  lba += fatType_ == 16 ? cluster >> 8 : cluster >> 7;

+  if (lba != cacheBlockNumber_) {

+    if (!cacheRawBlock(lba, CACHE_FOR_READ)) return false;

+  }

+  if (fatType_ == 16) {

+    *value = cacheBuffer_.fat16[cluster & 0XFF];

+  } else {

+    *value = cacheBuffer_.fat32[cluster & 0X7F] & FAT32MASK;

+  }

+  return true;

+}

+//------------------------------------------------------------------------------

+// Store a FAT entry

+uint8_t SdVolume::fatPut(uint32_t cluster, uint32_t value) {

+  // error if reserved cluster

+  if (cluster < 2) return false;

+

+  // error if not in FAT

+  if (cluster > (clusterCount_ + 1)) return false;

+

+  // calculate block address for entry

+  uint32_t lba = fatStartBlock_;

+  lba += fatType_ == 16 ? cluster >> 8 : cluster >> 7;

+

+  if (lba != cacheBlockNumber_) {

+    if (!cacheRawBlock(lba, CACHE_FOR_READ)) return false;

+  }

+  // store entry

+  if (fatType_ == 16) {

+    cacheBuffer_.fat16[cluster & 0XFF] = value;

+  } else {

+    cacheBuffer_.fat32[cluster & 0X7F] = value;

+  }

+  cacheSetDirty();

+

+  // mirror second FAT

+  if (fatCount_ > 1) cacheMirrorBlock_ = lba + blocksPerFat_;

+  return true;

+}

+//------------------------------------------------------------------------------

+// free a cluster chain

+uint8_t SdVolume::freeChain(uint32_t cluster) {

+  // clear free cluster location

+  allocSearchStart_ = 2;

+

+  do {

+    uint32_t next;

+    if (!fatGet(cluster, &next)) return false;

+

+    // free cluster

+    if (!fatPut(cluster, 0)) return false;

+

+    cluster = next;

+  } while (!isEOC(cluster));

+

+  return true;

+}

+//------------------------------------------------------------------------------

+/**

+ * Initialize a FAT volume.

+ *

+ * \param[in] dev The SD card where the volume is located.

+ *

+ * \param[in] part The partition to be used.  Legal values for \a part are

+ * 1-4 to use the corresponding partition on a device formatted with

+ * a MBR, Master Boot Record, or zero if the device is formatted as

+ * a super floppy with the FAT boot sector in block zero.

+ *

+ * \return The value one, true, is returned for success and

+ * the value zero, false, is returned for failure.  Reasons for

+ * failure include not finding a valid partition, not finding a valid

+ * FAT file system in the specified partition or an I/O error.

+ */

+uint8_t SdVolume::init(Sd2Card* dev, uint8_t part) {

+  uint32_t volumeStartBlock = 0;

+  sdCard_ = dev;

+  // if part == 0 assume super floppy with FAT boot sector in block zero

+  // if part > 0 assume mbr volume with partition table

+  if (part) {

+    if (part > 4)return false;

+    if (!cacheRawBlock(volumeStartBlock, CACHE_FOR_READ)) return false;

+    part_t* p = &cacheBuffer_.mbr.part[part-1];

+    if ((p->boot & 0X7F) !=0  ||

+      p->totalSectors < 100 ||

+      p->firstSector == 0) {

+      // not a valid partition

+      return false;

+    }

+    volumeStartBlock = p->firstSector;

+  }

+  if (!cacheRawBlock(volumeStartBlock, CACHE_FOR_READ)) return false;

+  bpb_t* bpb = &cacheBuffer_.fbs.bpb;

+  if (bpb->bytesPerSector != 512 ||

+    bpb->fatCount == 0 ||

+    bpb->reservedSectorCount == 0 ||

+    bpb->sectorsPerCluster == 0) {

+       // not valid FAT volume

+      return false;

+  }

+  fatCount_ = bpb->fatCount;

+  blocksPerCluster_ = bpb->sectorsPerCluster;

+

+  // determine shift that is same as multiply by blocksPerCluster_

+  clusterSizeShift_ = 0;

+  while (blocksPerCluster_ != (1 << clusterSizeShift_)) {

+    // error if not power of 2

+    if (clusterSizeShift_++ > 7) return false;

+  }

+  blocksPerFat_ = bpb->sectorsPerFat16 ?

+                    bpb->sectorsPerFat16 : bpb->sectorsPerFat32;

+

+  fatStartBlock_ = volumeStartBlock + bpb->reservedSectorCount;

+

+  // count for FAT16 zero for FAT32

+  rootDirEntryCount_ = bpb->rootDirEntryCount;

+

+  // directory start for FAT16 dataStart for FAT32

+  rootDirStart_ = fatStartBlock_ + bpb->fatCount * blocksPerFat_;

+

+  // data start for FAT16 and FAT32

+  dataStartBlock_ = rootDirStart_ + ((32 * bpb->rootDirEntryCount + 511)/512);

+

+  // total blocks for FAT16 or FAT32

+  uint32_t totalBlocks = bpb->totalSectors16 ?

+                           bpb->totalSectors16 : bpb->totalSectors32;

+  // total data blocks

+  clusterCount_ = totalBlocks - (dataStartBlock_ - volumeStartBlock);

+

+  // divide by cluster size to get cluster count

+  clusterCount_ >>= clusterSizeShift_;

+

+  // FAT type is determined by cluster count

+  if (clusterCount_ < 4085) {

+    fatType_ = 12;

+  } else if (clusterCount_ < 65525) {

+    fatType_ = 16;

+  } else {

+    rootDirStart_ = bpb->fat32RootCluster;

+    fatType_ = 32;

+  }

+  return true;

+}

diff --git a/libraries/SPI/SPI.cpp b/libraries/SPI/SPI.cpp
new file mode 100644
index 0000000..42915df
--- /dev/null
+++ b/libraries/SPI/SPI.cpp
@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2010 by Cristian Maglie <c.maglie@bug.st>
+ * SPI Master library for arduino.
+ *
+ * This file is free software; you can redistribute it and/or modify
+ * it under the terms of either the GNU General Public License version 2
+ * or the GNU Lesser General Public License version 2.1, both as
+ * published by the Free Software Foundation.
+ */
+
+#include "pins_arduino.h"
+#include "SPI.h"
+
+SPIClass SPI;
+
+void SPIClass::begin() {
+  // Set direction register for SCK and MOSI pin.
+  // MISO pin automatically overrides to INPUT.
+  // When the SS pin is set as OUTPUT, it can be used as
+  // a general purpose output port (it doesn't influence
+  // SPI operations).
+
+  pinMode(SCK, OUTPUT);
+  pinMode(MOSI, OUTPUT);
+  pinMode(SS, OUTPUT);
+  
+  digitalWrite(SCK, LOW);
+  digitalWrite(MOSI, LOW);
+  digitalWrite(SS, HIGH);
+
+  // Warning: if the SS pin ever becomes a LOW INPUT then SPI 
+  // automatically switches to Slave, so the data direction of 
+  // the SS pin MUST be kept as OUTPUT.
+  SPCR |= _BV(MSTR);
+  SPCR |= _BV(SPE);
+}
+
+void SPIClass::end() {
+  SPCR &= ~_BV(SPE);
+}
+
+void SPIClass::setBitOrder(uint8_t bitOrder)
+{
+  if(bitOrder == LSBFIRST) {
+    SPCR |= _BV(DORD);
+  } else {
+    SPCR &= ~(_BV(DORD));
+  }
+}
+
+void SPIClass::setDataMode(uint8_t mode)
+{
+  SPCR = (SPCR & ~SPI_MODE_MASK) | mode;
+}
+
+void SPIClass::setClockDivider(uint8_t rate)
+{
+  SPCR = (SPCR & ~SPI_CLOCK_MASK) | (rate & SPI_CLOCK_MASK);
+  SPSR = (SPSR & ~SPI_2XCLOCK_MASK) | ((rate >> 2) & SPI_2XCLOCK_MASK);
+}
+
diff --git a/libraries/SPI/SPI.h b/libraries/SPI/SPI.h
new file mode 100644
index 0000000..79c89d4
--- /dev/null
+++ b/libraries/SPI/SPI.h
@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2010 by Cristian Maglie <c.maglie@bug.st>
+ * SPI Master library for arduino.
+ *
+ * This file is free software; you can redistribute it and/or modify
+ * it under the terms of either the GNU General Public License version 2
+ * or the GNU Lesser General Public License version 2.1, both as
+ * published by the Free Software Foundation.
+ */
+
+#ifndef _SPI_H_INCLUDED
+#define _SPI_H_INCLUDED
+
+#include <stdio.h>
+#include <Arduino.h>
+#include <avr/pgmspace.h>
+
+#define SPI_CLOCK_DIV4 0x00
+#define SPI_CLOCK_DIV16 0x01
+#define SPI_CLOCK_DIV64 0x02
+#define SPI_CLOCK_DIV128 0x03
+#define SPI_CLOCK_DIV2 0x04
+#define SPI_CLOCK_DIV8 0x05
+#define SPI_CLOCK_DIV32 0x06
+#define SPI_CLOCK_DIV64 0x07
+
+#define SPI_MODE0 0x00
+#define SPI_MODE1 0x04
+#define SPI_MODE2 0x08
+#define SPI_MODE3 0x0C
+
+#define SPI_MODE_MASK 0x0C  // CPOL = bit 3, CPHA = bit 2 on SPCR
+#define SPI_CLOCK_MASK 0x03  // SPR1 = bit 1, SPR0 = bit 0 on SPCR
+#define SPI_2XCLOCK_MASK 0x01  // SPI2X = bit 0 on SPSR
+
+class SPIClass {
+public:
+  inline static byte transfer(byte _data);
+
+  // SPI Configuration methods
+
+  inline static void attachInterrupt();
+  inline static void detachInterrupt(); // Default
+
+  static void begin(); // Default
+  static void end();
+
+  static void setBitOrder(uint8_t);
+  static void setDataMode(uint8_t);
+  static void setClockDivider(uint8_t);
+};
+
+extern SPIClass SPI;
+
+byte SPIClass::transfer(byte _data) {
+  SPDR = _data;
+  while (!(SPSR & _BV(SPIF)))
+    ;
+  return SPDR;
+}
+
+void SPIClass::attachInterrupt() {
+  SPCR |= _BV(SPIE);
+}
+
+void SPIClass::detachInterrupt() {
+  SPCR &= ~_BV(SPIE);
+}
+
+#endif
diff --git a/libraries/SPI/examples/BarometricPressureSensor/BarometricPressureSensor.pde b/libraries/SPI/examples/BarometricPressureSensor/BarometricPressureSensor.pde
new file mode 100644
index 0000000..9d77a42
--- /dev/null
+++ b/libraries/SPI/examples/BarometricPressureSensor/BarometricPressureSensor.pde
@@ -0,0 +1,143 @@
+/*
+ SCP1000 Barometric Pressure Sensor Display
+ 
+ Shows the output of a Barometric Pressure Sensor on a
+ Uses the SPI library. For details on the sensor, see:
+ http://www.sparkfun.com/commerce/product_info.php?products_id=8161
+ http://www.vti.fi/en/support/obsolete_products/pressure_sensors/
+ 
+ This sketch adapted from Nathan Seidle's SCP1000 example for PIC:
+ http://www.sparkfun.com/datasheets/Sensors/SCP1000-Testing.zip
+ 
+ Circuit:
+ SCP1000 sensor attached to pins 6, 7, 10 - 13:
+ DRDY: pin 6
+ CSB: pin 7
+ MOSI: pin 11
+ MISO: pin 12
+ SCK: pin 13
+ 
+ created 31 July 2010
+ modified 14 August 2010
+ by Tom Igoe
+ */
+
+// the sensor communicates using SPI, so include the library:
+#include <SPI.h>
+
+//Sensor's memory register addresses:
+const int PRESSURE = 0x1F;      //3 most significant bits of pressure
+const int PRESSURE_LSB = 0x20;  //16 least significant bits of pressure
+const int TEMPERATURE = 0x21;   //16 bit temperature reading
+const byte READ = 0b11111100;     // SCP1000's read command
+const byte WRITE = 0b00000010;   // SCP1000's write command
+
+// pins used for the connection with the sensor
+// the other you need are controlled by the SPI library):
+const int dataReadyPin = 6;
+const int chipSelectPin = 7;
+
+void setup() {
+  Serial.begin(9600);
+
+  // start the SPI library:
+  SPI.begin();
+
+  // initalize the  data ready and chip select pins:
+  pinMode(dataReadyPin, INPUT);
+  pinMode(chipSelectPin, OUTPUT);
+
+  //Configure SCP1000 for low noise configuration:
+  writeRegister(0x02, 0x2D);
+  writeRegister(0x01, 0x03);
+  writeRegister(0x03, 0x02);
+  // give the sensor time to set up:
+  delay(100);
+}
+
+void loop() {
+  //Select High Resolution Mode
+  writeRegister(0x03, 0x0A);
+
+  // don't do anything until the data ready pin is high:
+  if (digitalRead(dataReadyPin) == HIGH) {
+    //Read the temperature data
+    int tempData = readRegister(0x21, 2);
+
+    // convert the temperature to celsius and display it:
+    float realTemp = (float)tempData / 20.0;
+    Serial.print("Temp[C]=");
+    Serial.print(realTemp);
+
+
+    //Read the pressure data highest 3 bits:
+    byte  pressure_data_high = readRegister(0x1F, 1);
+    pressure_data_high &= 0b00000111; //you only needs bits 2 to 0
+
+    //Read the pressure data lower 16 bits:
+    unsigned int pressure_data_low = readRegister(0x20, 2);
+    //combine the two parts into one 19-bit number:
+    long pressure = ((pressure_data_high << 16) | pressure_data_low)/4;
+
+    // display the temperature:
+    Serial.println("\tPressure [Pa]=" + String(pressure));
+  }
+}
+
+//Read from or write to register from the SCP1000:
+unsigned int readRegister(byte thisRegister, int bytesToRead ) {
+  byte inByte = 0;           // incoming byte from the SPI
+  unsigned int result = 0;   // result to return
+  Serial.print(thisRegister, BIN);
+  Serial.print("\t");
+  // SCP1000 expects the register name in the upper 6 bits
+  // of the byte. So shift the bits left by two bits:
+  thisRegister = thisRegister << 2;
+  // now combine the address and the command into one byte
+  byte dataToSend = thisRegister & READ;
+  Serial.println(thisRegister, BIN);
+  // take the chip select low to select the device:
+  digitalWrite(chipSelectPin, LOW);
+  // send the device the register you want to read:
+  SPI.transfer(dataToSend);
+  // send a value of 0 to read the first byte returned:
+  result = SPI.transfer(0x00);
+  // decrement the number of bytes left to read:
+  bytesToRead--;
+  // if you still have another byte to read:
+  if (bytesToRead > 0) {
+    // shift the first byte left, then get the second byte:
+    result = result << 8;
+    inByte = SPI.transfer(0x00);
+    // combine the byte you just got with the previous one:
+    result = result | inByte;
+    // decrement the number of bytes left to read:
+    bytesToRead--;
+  }
+  // take the chip select high to de-select:
+  digitalWrite(chipSelectPin, HIGH);
+  // return the result:
+  return(result);
+}
+
+
+//Sends a write command to SCP1000
+
+void writeRegister(byte thisRegister, byte thisValue) {
+
+  // SCP1000 expects the register address in the upper 6 bits
+  // of the byte. So shift the bits left by two bits:
+  thisRegister = thisRegister << 2;
+  // now combine the register address and the command into one byte:
+  byte dataToSend = thisRegister | WRITE;
+
+  // take the chip select low to select the device:
+  digitalWrite(chipSelectPin, LOW);
+
+  SPI.transfer(dataToSend); //Send register location
+  SPI.transfer(thisValue);  //Send value to record into register
+
+  // take the chip select high to de-select:
+  digitalWrite(chipSelectPin, HIGH);
+}
+
diff --git a/libraries/SPI/examples/BarometricPressureSensor/BarometricPressureSensor/BarometricPressureSensor.pde b/libraries/SPI/examples/BarometricPressureSensor/BarometricPressureSensor/BarometricPressureSensor.pde
new file mode 100644
index 0000000..9c9c9b6
--- /dev/null
+++ b/libraries/SPI/examples/BarometricPressureSensor/BarometricPressureSensor/BarometricPressureSensor.pde
@@ -0,0 +1,143 @@
+/*
+  SCP1000 Barometric Pressure Sensor Display
+ 
+ Shows the output of a Barometric Pressure Sensor on a
+ Uses the SPI library. For details on the sensor, see:
+ http://www.sparkfun.com/commerce/product_info.php?products_id=8161
+ http://www.vti.fi/en/support/obsolete_products/pressure_sensors/
+ 
+ This sketch adapted from Nathan Seidle's SCP1000 example for PIC:
+ http://www.sparkfun.com/datasheets/Sensors/SCP1000-Testing.zip
+ 
+ Circuit:
+ SCP1000 sensor attached to pins 6, 7, 10 - 13:
+ DRDY: pin 6
+ CSB: pin 7
+ MOSI: pin 11
+ MISO: pin 12
+ SCK: pin 13
+ 
+ created 31 July 2010
+ modified 14 August 2010
+ by Tom Igoe
+ */
+
+// the sensor communicates using SPI, so include the library:
+#include <SPI.h>
+
+//Sensor's memory register addresses:
+const int PRESSURE = 0x1F;      //3 most significant bits of pressure
+const int PRESSURE_LSB = 0x20;  //16 least significant bits of pressure
+const int TEMPERATURE = 0x21;   //16 bit temperature reading
+cont byte READ = 0b00000000;     // SCP1000's read command
+const byte WRITE = 0b00000010;   // SCP1000's write command
+// pins used for the connection with the sensor
+// the other you need are controlled by the SPI library):
+const int dataReadyPin = 6; 
+const int chipSelectPin = 7;
+
+void setup() {
+  Serial.begin(9600);
+
+  // start the SPI library:
+  SPI.begin();
+
+  // initalize the  data ready and chip select pins:
+  pinMode(dataReadyPin, INPUT);
+  pinMode(chipSelectPin, OUTPUT);
+
+  //Configure SCP1000 for low noise configuration:
+  writeRegister(0x02, 0x2D);
+  writeRegister(0x01, 0x03);
+  writeRegister(0x03, 0x02);
+  // give the sensor time to set up:
+  delay(100);
+}
+
+void loop() {
+  //Select High Resolution Mode
+  writeRegister(0x03, 0x0A);
+
+  // don't do anything until the data ready pin is high:
+  if (digitalRead(dataReadyPin) == HIGH) {
+    //Read the temperature data
+    int tempData = readRegister(0x21, 2);
+
+    // convert the temperature to celsius and display it:
+    float realTemp = (float)tempData / 20.0;
+    Serial.print("Temp[C]=");
+    Serial.print(realTemp);
+
+
+    //Read the pressure data highest 3 bits:
+    byte  pressure_data_high = readRegister(0x1F, 1);   
+    pressure_data_high &= 0b00000111; //you only needs bits 2 to 0
+
+    //Read the pressure data lower 16 bits:
+    unsigned int pressure_data_low = readRegister(0x20, 2);    
+    //combine the two parts into one 19-bit number:
+    long pressure = ((pressure_data_high << 16) | pressure_data_low)/4;
+
+    // display the temperature:
+    Serial.println("\tPressure [Pa]=" + String(pressure));
+  }
+}
+
+//Read from or write to register from the SCP1000:
+unsigned int readRegister(byte thisRegister, int bytesToRead ) {
+  byte inByte = 0;           // incoming byte from the SPI
+  unsigned int result = 0;   // result to return 
+
+  // SCP1000 expects the register name in the upper 6 bits
+  // of the byte. So shift the bits left by two bits:
+  thisRegister = thisRegister << 2;
+  // now combine the address and the command into one byte
+  dataToSend = thisRegister & READ;
+
+  // take the chip select low to select the device:
+  digitalWrite(chipSelectPin, LOW); 
+  // send the device the register you want to read:
+  SPI.transfer(dataToSend); 
+  // send a value of 0 to read the first byte returned:
+  result = SPI.transfer(0x00); 
+  // decrement the number of bytes left to read:
+  bytesToRead--;
+  // if you still have another byte to read:
+  if (bytesToRead > 0) {
+    // shift the first byte left, then get the second byte: 
+    result = result << 8;
+    inByte = SPI.transfer(0x00); 
+    // combine the byte you just got with the previous one:
+    result = result | inByte;
+    // decrement the number of bytes left to read:
+    bytesToRead--;
+  }
+  // take the chip select high to de-select:
+  digitalWrite(chipSelectPin, HIGH); 
+  // return the result:
+  return(result);
+}
+
+
+//Sends a write command to SCP1000
+
+void writeRegister(byte thisRegister, byte thisValue) {
+
+  // SCP1000 expects the register address in the upper 6 bits
+  // of the byte. So shift the bits left by two bits:
+  thisRegister = thisRegister << 2;
+  // now combine the register address and the command into one byte:
+  dataToSend = thisRegister | WRITE;
+
+  // take the chip select low to select the device:
+  digitalWrite(chipSelectPin, LOW); 
+
+  SPI.transfer(dataToSend); //Send register location
+  SPI.transfer(thisValue);  //Send value to record into register
+
+  // take the chip select high to de-select:
+  digitalWrite(chipSelectPin, HIGH); 
+}
+
+
+
diff --git a/libraries/SPI/examples/DigitalPotControl/DigitalPotControl.pde b/libraries/SPI/examples/DigitalPotControl/DigitalPotControl.pde
new file mode 100644
index 0000000..ef97dae
--- /dev/null
+++ b/libraries/SPI/examples/DigitalPotControl/DigitalPotControl.pde
@@ -0,0 +1,71 @@
+/*
+  Digital Pot Control
+  
+  This example controls an Analog Devices AD5206 digital potentiometer.
+  The AD5206 has 6 potentiometer channels. Each channel's pins are labeled
+  A - connect this to voltage
+  W - this is the pot's wiper, which changes when you set it
+  B - connect this to ground.
+ 
+ The AD5206 is SPI-compatible,and to command it, you send two bytes, 
+ one with the channel number (0 - 5) and one with the resistance value for the
+ channel (0 - 255).  
+ 
+ The circuit:
+  * All A pins  of AD5206 connected to +5V
+  * All B pins of AD5206 connected to ground
+  * An LED and a 220-ohm resisor in series connected from each W pin to ground
+  * CS - to digital pin 10  (SS pin)
+  * SDI - to digital pin 11 (MOSI pin)
+  * CLK - to digital pin 13 (SCK pin)
+ 
+ created 10 Aug 2010 
+ by Tom Igoe
+ 
+ Thanks to Heather Dewey-Hagborg for the original tutorial, 2005
+ 
+*/
+
+
+// inslude the SPI library:
+#include <SPI.h>
+
+
+// set pin 10 as the slave select for the digital pot:
+const int slaveSelectPin = 10;
+
+void setup() {
+  // set the slaveSelectPin as an output:
+  pinMode (slaveSelectPin, OUTPUT);
+  // initialize SPI:
+  SPI.begin(); 
+}
+
+void loop() {
+  // go through the six channels of the digital pot:
+  for (int channel = 0; channel < 6; channel++) { 
+    // change the resistance on this channel from min to max:
+    for (int level = 0; level < 255; level++) {
+      digitalPotWrite(channel, level);
+      delay(10);
+    }
+    // wait a second at the top:
+    delay(100);
+    // change the resistance on this channel from max to min:
+    for (int level = 0; level < 255; level++) {
+      digitalPotWrite(channel, 255 - level);
+      delay(10);
+    }
+  }
+
+}
+
+int digitalPotWrite(int address, int value) {
+  // take the SS pin low to select the chip:
+  digitalWrite(slaveSelectPin,LOW);
+  //  send in the address and value via SPI:
+  SPI.transfer(address);
+  SPI.transfer(value);
+  // take the SS pin high to de-select the chip:
+  digitalWrite(slaveSelectPin,HIGH); 
+}
\ No newline at end of file
diff --git a/libraries/SPI/keywords.txt b/libraries/SPI/keywords.txt
new file mode 100644
index 0000000..fa76165
--- /dev/null
+++ b/libraries/SPI/keywords.txt
@@ -0,0 +1,36 @@
+#######################################
+# Syntax Coloring Map SPI
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+SPI	KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+begin	KEYWORD2
+end	KEYWORD2
+transfer	KEYWORD2
+setBitOrder	KEYWORD2
+setDataMode	KEYWORD2
+setClockDivider	KEYWORD2
+
+
+#######################################
+# Constants (LITERAL1)
+#######################################
+SPI_CLOCK_DIV4	LITERAL1
+SPI_CLOCK_DIV16	LITERAL1
+SPI_CLOCK_DIV64	LITERAL1
+SPI_CLOCK_DIV128	LITERAL1
+SPI_CLOCK_DIV2	LITERAL1
+SPI_CLOCK_DIV8	LITERAL1
+SPI_CLOCK_DIV32	LITERAL1
+SPI_CLOCK_DIV64	LITERAL1
+SPI_MODE0	LITERAL1
+SPI_MODE1	LITERAL1
+SPI_MODE2	LITERAL1
+SPI_MODE3	LITERAL1
\ No newline at end of file
diff --git a/libraries/Servo/Servo.cpp b/libraries/Servo/Servo.cpp
new file mode 100755
index 0000000..acac29a
--- /dev/null
+++ b/libraries/Servo/Servo.cpp
@@ -0,0 +1,337 @@
+/*

+ Servo.cpp - Interrupt driven Servo library for Arduino using 16 bit timers- Version 2

+ Copyright (c) 2009 Michael Margolis.  All right reserved.

+ 

+ This library is free software; you can redistribute it and/or

+ modify it under the terms of the GNU Lesser General Public

+ License as published by the Free Software Foundation; either

+ version 2.1 of the License, or (at your option) any later version.

+ 

+ This library is distributed in the hope that it will be useful,

+ but WITHOUT ANY WARRANTY; without even the implied warranty of

+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

+ Lesser General Public License for more details.

+ 

+ You should have received a copy of the GNU Lesser General Public

+ License along with this library; if not, write to the Free Software

+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

+ */

+

+/* 

+ 

+ A servo is activated by creating an instance of the Servo class passing the desired pin to the attach() method.

+ The servos are pulsed in the background using the value most recently written using the write() method

+ 

+ Note that analogWrite of PWM on pins associated with the timer are disabled when the first servo is attached.

+ Timers are seized as needed in groups of 12 servos - 24 servos use two timers, 48 servos will use four.

+ 

+ The methods are:

+ 

+ Servo - Class for manipulating servo motors connected to Arduino pins.

+ 

+ attach(pin )  - Attaches a servo motor to an i/o pin.

+ attach(pin, min, max  ) - Attaches to a pin setting min and max values in microseconds

+ default min is 544, max is 2400  

+ 

+ write()     - Sets the servo angle in degrees.  (invalid angle that is valid as pulse in microseconds is treated as microseconds)

+ writeMicroseconds() - Sets the servo pulse width in microseconds 

+ read()      - Gets the last written servo pulse width as an angle between 0 and 180. 

+ readMicroseconds()   - Gets the last written servo pulse width in microseconds. (was read_us() in first release)

+ attached()  - Returns true if there is a servo attached. 

+ detach()    - Stops an attached servos from pulsing its i/o pin. 

+ 

+*/

+

+#include <avr/interrupt.h>

+#include <Arduino.h> 

+

+#include "Servo.h"

+

+#define usToTicks(_us)    (( clockCyclesPerMicrosecond()* _us) / 8)     // converts microseconds to tick (assumes prescale of 8)  // 12 Aug 2009

+#define ticksToUs(_ticks) (( (unsigned)_ticks * 8)/ clockCyclesPerMicrosecond() ) // converts from ticks back to microseconds

+

+

+#define TRIM_DURATION       2                               // compensation ticks to trim adjust for digitalWrite delays // 12 August 2009

+

+//#define NBR_TIMERS        (MAX_SERVOS / SERVOS_PER_TIMER)

+

+static servo_t servos[MAX_SERVOS];                          // static array of servo structures

+static volatile int8_t Channel[_Nbr_16timers ];             // counter for the servo being pulsed for each timer (or -1 if refresh interval)

+

+uint8_t ServoCount = 0;                                     // the total number of attached servos

+

+

+// convenience macros

+#define SERVO_INDEX_TO_TIMER(_servo_nbr) ((timer16_Sequence_t)(_servo_nbr / SERVOS_PER_TIMER)) // returns the timer controlling this servo

+#define SERVO_INDEX_TO_CHANNEL(_servo_nbr) (_servo_nbr % SERVOS_PER_TIMER)       // returns the index of the servo on this timer

+#define SERVO_INDEX(_timer,_channel)  ((_timer*SERVOS_PER_TIMER) + _channel)     // macro to access servo index by timer and channel

+#define SERVO(_timer,_channel)  (servos[SERVO_INDEX(_timer,_channel)])            // macro to access servo class by timer and channel

+

+#define SERVO_MIN() (MIN_PULSE_WIDTH - this->min * 4)  // minimum value in uS for this servo

+#define SERVO_MAX() (MAX_PULSE_WIDTH - this->max * 4)  // maximum value in uS for this servo 

+

+/************ static functions common to all instances ***********************/

+

+static inline void handle_interrupts(timer16_Sequence_t timer, volatile uint16_t *TCNTn, volatile uint16_t* OCRnA)

+{

+  if( Channel[timer] < 0 )

+    *TCNTn = 0; // channel set to -1 indicated that refresh interval completed so reset the timer 

+  else{

+    if( SERVO_INDEX(timer,Channel[timer]) < ServoCount && SERVO(timer,Channel[timer]).Pin.isActive == true )  

+      digitalWrite( SERVO(timer,Channel[timer]).Pin.nbr,LOW); // pulse this channel low if activated   

+  }

+

+  Channel[timer]++;    // increment to the next channel

+  if( SERVO_INDEX(timer,Channel[timer]) < ServoCount && Channel[timer] < SERVOS_PER_TIMER) {

+    *OCRnA = *TCNTn + SERVO(timer,Channel[timer]).ticks;

+    if(SERVO(timer,Channel[timer]).Pin.isActive == true)     // check if activated

+      digitalWrite( SERVO(timer,Channel[timer]).Pin.nbr,HIGH); // its an active channel so pulse it high   

+  }  

+  else { 

+    // finished all channels so wait for the refresh period to expire before starting over 

+    if( (unsigned)*TCNTn <  (usToTicks(REFRESH_INTERVAL) + 4) )  // allow a few ticks to ensure the next OCR1A not missed

+      *OCRnA = (unsigned int)usToTicks(REFRESH_INTERVAL);  

+    else 

+      *OCRnA = *TCNTn + 4;  // at least REFRESH_INTERVAL has elapsed

+    Channel[timer] = -1; // this will get incremented at the end of the refresh period to start again at the first channel

+  }

+}

+

+#ifndef WIRING // Wiring pre-defines signal handlers so don't define any if compiling for the Wiring platform

+// Interrupt handlers for Arduino 

+#if defined(_useTimer1)

+SIGNAL (TIMER1_COMPA_vect) 

+{ 

+  handle_interrupts(_timer1, &TCNT1, &OCR1A); 

+}

+#endif

+

+#if defined(_useTimer3)

+SIGNAL (TIMER3_COMPA_vect) 

+{ 

+  handle_interrupts(_timer3, &TCNT3, &OCR3A); 

+}

+#endif

+

+#if defined(_useTimer4)

+SIGNAL (TIMER4_COMPA_vect) 

+{

+  handle_interrupts(_timer4, &TCNT4, &OCR4A); 

+}

+#endif

+

+#if defined(_useTimer5)

+SIGNAL (TIMER5_COMPA_vect) 

+{

+  handle_interrupts(_timer5, &TCNT5, &OCR5A); 

+}

+#endif

+

+#elif defined WIRING

+// Interrupt handlers for Wiring 

+#if defined(_useTimer1)

+void Timer1Service() 

+{ 

+  handle_interrupts(_timer1, &TCNT1, &OCR1A); 

+}

+#endif

+#if defined(_useTimer3)

+void Timer3Service() 

+{ 

+  handle_interrupts(_timer3, &TCNT3, &OCR3A); 

+}

+#endif

+#endif

+

+

+static void initISR(timer16_Sequence_t timer)

+{  

+#if defined (_useTimer1)

+  if(timer == _timer1) {

+    TCCR1A = 0;             // normal counting mode 

+    TCCR1B = _BV(CS11);     // set prescaler of 8 

+    TCNT1 = 0;              // clear the timer count 

+#if defined(__AVR_ATmega8__)|| defined(__AVR_ATmega128__)

+    TIFR |= _BV(OCF1A);      // clear any pending interrupts; 

+    TIMSK |=  _BV(OCIE1A) ;  // enable the output compare interrupt  

+#else

+    // here if not ATmega8 or ATmega128

+    TIFR1 |= _BV(OCF1A);     // clear any pending interrupts; 

+    TIMSK1 |=  _BV(OCIE1A) ; // enable the output compare interrupt 

+#endif    

+#if defined(WIRING)       

+    timerAttach(TIMER1OUTCOMPAREA_INT, Timer1Service); 

+#endif	

+  } 

+#endif  

+

+#if defined (_useTimer3)

+  if(timer == _timer3) {

+    TCCR3A = 0;             // normal counting mode 

+    TCCR3B = _BV(CS31);     // set prescaler of 8  

+    TCNT3 = 0;              // clear the timer count 

+#if defined(__AVR_ATmega128__)

+    TIFR |= _BV(OCF3A);     // clear any pending interrupts;   

+	ETIMSK |= _BV(OCIE3A);  // enable the output compare interrupt     

+#else  

+    TIFR3 = _BV(OCF3A);     // clear any pending interrupts; 

+    TIMSK3 =  _BV(OCIE3A) ; // enable the output compare interrupt      

+#endif

+#if defined(WIRING)    

+    timerAttach(TIMER3OUTCOMPAREA_INT, Timer3Service);  // for Wiring platform only	

+#endif  

+  }

+#endif

+

+#if defined (_useTimer4)

+  if(timer == _timer4) {

+    TCCR4A = 0;             // normal counting mode 

+    TCCR4B = _BV(CS41);     // set prescaler of 8  

+    TCNT4 = 0;              // clear the timer count 

+    TIFR4 = _BV(OCF4A);     // clear any pending interrupts; 

+    TIMSK4 =  _BV(OCIE4A) ; // enable the output compare interrupt

+  }    

+#endif

+

+#if defined (_useTimer5)

+  if(timer == _timer5) {

+    TCCR5A = 0;             // normal counting mode 

+    TCCR5B = _BV(CS51);     // set prescaler of 8  

+    TCNT5 = 0;              // clear the timer count 

+    TIFR5 = _BV(OCF5A);     // clear any pending interrupts; 

+    TIMSK5 =  _BV(OCIE5A) ; // enable the output compare interrupt      

+  }

+#endif

+} 

+

+static void finISR(timer16_Sequence_t timer)

+{

+    //disable use of the given timer

+#if defined WIRING   // Wiring

+  if(timer == _timer1) {

+    #if defined(__AVR_ATmega1281__)||defined(__AVR_ATmega2561__)

+    TIMSK1 &=  ~_BV(OCIE1A) ;  // disable timer 1 output compare interrupt

+    #else 

+    TIMSK &=  ~_BV(OCIE1A) ;  // disable timer 1 output compare interrupt   

+    #endif

+    timerDetach(TIMER1OUTCOMPAREA_INT); 

+  }

+  else if(timer == _timer3) {     

+    #if defined(__AVR_ATmega1281__)||defined(__AVR_ATmega2561__)

+    TIMSK3 &= ~_BV(OCIE3A);    // disable the timer3 output compare A interrupt

+    #else

+    ETIMSK &= ~_BV(OCIE3A);    // disable the timer3 output compare A interrupt

+    #endif

+    timerDetach(TIMER3OUTCOMPAREA_INT);

+  }

+#else

+    //For arduino - in future: call here to a currently undefined function to reset the timer

+#endif

+}

+

+static boolean isTimerActive(timer16_Sequence_t timer)

+{

+  // returns true if any servo is active on this timer

+  for(uint8_t channel=0; channel < SERVOS_PER_TIMER; channel++) {

+    if(SERVO(timer,channel).Pin.isActive == true)

+      return true;

+  }

+  return false;

+}

+

+

+/****************** end of static functions ******************************/

+

+Servo::Servo()

+{

+  if( ServoCount < MAX_SERVOS) {

+    this->servoIndex = ServoCount++;                    // assign a servo index to this instance

+	servos[this->servoIndex].ticks = usToTicks(DEFAULT_PULSE_WIDTH);   // store default values  - 12 Aug 2009

+  }

+  else

+    this->servoIndex = INVALID_SERVO ;  // too many servos 

+}

+

+uint8_t Servo::attach(int pin)

+{

+  return this->attach(pin, MIN_PULSE_WIDTH, MAX_PULSE_WIDTH);

+}

+

+uint8_t Servo::attach(int pin, int min, int max)

+{

+  if(this->servoIndex < MAX_SERVOS ) {

+    pinMode( pin, OUTPUT) ;                                   // set servo pin to output

+    servos[this->servoIndex].Pin.nbr = pin;  

+    // todo min/max check: abs(min - MIN_PULSE_WIDTH) /4 < 128 

+    this->min  = (MIN_PULSE_WIDTH - min)/4; //resolution of min/max is 4 uS

+    this->max  = (MAX_PULSE_WIDTH - max)/4; 

+    // initialize the timer if it has not already been initialized 

+    timer16_Sequence_t timer = SERVO_INDEX_TO_TIMER(servoIndex);

+    if(isTimerActive(timer) == false)

+      initISR(timer);    

+    servos[this->servoIndex].Pin.isActive = true;  // this must be set after the check for isTimerActive

+  } 

+  return this->servoIndex ;

+}

+

+void Servo::detach()  

+{

+  servos[this->servoIndex].Pin.isActive = false;  

+  timer16_Sequence_t timer = SERVO_INDEX_TO_TIMER(servoIndex);

+  if(isTimerActive(timer) == false) {

+    finISR(timer);

+  }

+}

+

+void Servo::write(int value)

+{  

+  if(value < MIN_PULSE_WIDTH)

+  {  // treat values less than 544 as angles in degrees (valid values in microseconds are handled as microseconds)

+    if(value < 0) value = 0;

+    if(value > 180) value = 180;

+    value = map(value, 0, 180, SERVO_MIN(),  SERVO_MAX());      

+  }

+  this->writeMicroseconds(value);

+}

+

+void Servo::writeMicroseconds(int value)

+{

+  // calculate and store the values for the given channel

+  byte channel = this->servoIndex;

+  if( (channel >= 0) && (channel < MAX_SERVOS) )   // ensure channel is valid

+  {  

+    if( value < SERVO_MIN() )          // ensure pulse width is valid

+      value = SERVO_MIN();

+    else if( value > SERVO_MAX() )

+      value = SERVO_MAX();   

+    

+  	value = value - TRIM_DURATION;

+    value = usToTicks(value);  // convert to ticks after compensating for interrupt overhead - 12 Aug 2009

+

+    uint8_t oldSREG = SREG;

+    cli();

+    servos[channel].ticks = value;  

+    SREG = oldSREG;   

+  } 

+}

+

+int Servo::read() // return the value as degrees

+{

+  return  map( this->readMicroseconds()+1, SERVO_MIN(), SERVO_MAX(), 0, 180);     

+}

+

+int Servo::readMicroseconds()

+{

+  unsigned int pulsewidth;

+  if( this->servoIndex != INVALID_SERVO )

+    pulsewidth = ticksToUs(servos[this->servoIndex].ticks)  + TRIM_DURATION ;   // 12 aug 2009

+  else 

+    pulsewidth  = 0;

+

+  return pulsewidth;   

+}

+

+bool Servo::attached()

+{

+  return servos[this->servoIndex].Pin.isActive ;

+}

diff --git a/libraries/Servo/Servo.h b/libraries/Servo/Servo.h
new file mode 100755
index 0000000..bf3e012
--- /dev/null
+++ b/libraries/Servo/Servo.h
@@ -0,0 +1,127 @@
+/*
+  Servo.h - Interrupt driven Servo library for Arduino using 16 bit timers- Version 2
+  Copyright (c) 2009 Michael Margolis.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+/* 
+  
+  A servo is activated by creating an instance of the Servo class passing the desired pin to the attach() method.
+  The servos are pulsed in the background using the value most recently written using the write() method
+
+  Note that analogWrite of PWM on pins associated with the timer are disabled when the first servo is attached.
+  Timers are seized as needed in groups of 12 servos - 24 servos use two timers, 48 servos will use four.
+  The sequence used to sieze timers is defined in timers.h
+
+  The methods are:
+
+   Servo - Class for manipulating servo motors connected to Arduino pins.
+
+   attach(pin )  - Attaches a servo motor to an i/o pin.
+   attach(pin, min, max  ) - Attaches to a pin setting min and max values in microseconds
+   default min is 544, max is 2400  
+ 
+   write()     - Sets the servo angle in degrees.  (invalid angle that is valid as pulse in microseconds is treated as microseconds)
+   writeMicroseconds() - Sets the servo pulse width in microseconds 
+   read()      - Gets the last written servo pulse width as an angle between 0 and 180. 
+   readMicroseconds()   - Gets the last written servo pulse width in microseconds. (was read_us() in first release)
+   attached()  - Returns true if there is a servo attached. 
+   detach()    - Stops an attached servos from pulsing its i/o pin. 
+ */
+
+#ifndef Servo_h
+#define Servo_h
+
+#include <inttypes.h>
+
+/* 
+ * Defines for 16 bit timers used with  Servo library 
+ *
+ * If _useTimerX is defined then TimerX is a 16 bit timer on the curent board
+ * timer16_Sequence_t enumerates the sequence that the timers should be allocated
+ * _Nbr_16timers indicates how many 16 bit timers are available.
+ *
+ */
+
+// Say which 16 bit timers can be used and in what order
+#if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
+#define _useTimer5
+#define _useTimer1 
+#define _useTimer3
+#define _useTimer4 
+typedef enum { _timer5, _timer1, _timer3, _timer4, _Nbr_16timers } timer16_Sequence_t ;
+
+#elif defined(__AVR_ATmega32U4__)  
+#define _useTimer3
+#define _useTimer1 
+typedef enum { _timer3, _timer1, _Nbr_16timers } timer16_Sequence_t ;
+
+#elif defined(__AVR_AT90USB646__) || defined(__AVR_AT90USB1286__)
+#define _useTimer3
+#define _useTimer1
+typedef enum { _timer3, _timer1, _Nbr_16timers } timer16_Sequence_t ;
+
+#elif defined(__AVR_ATmega128__) ||defined(__AVR_ATmega1281__)||defined(__AVR_ATmega2561__)
+#define _useTimer3
+#define _useTimer1
+typedef enum { _timer3, _timer1, _Nbr_16timers } timer16_Sequence_t ;
+
+#else  // everything else
+#define _useTimer1
+typedef enum { _timer1, _Nbr_16timers } timer16_Sequence_t ;                  
+#endif
+
+#define Servo_VERSION           2      // software version of this library
+
+#define MIN_PULSE_WIDTH       544     // the shortest pulse sent to a servo  
+#define MAX_PULSE_WIDTH      2400     // the longest pulse sent to a servo 
+#define DEFAULT_PULSE_WIDTH  1500     // default pulse width when servo is attached
+#define REFRESH_INTERVAL    20000     // minumim time to refresh servos in microseconds 
+
+#define SERVOS_PER_TIMER       12     // the maximum number of servos controlled by one timer 
+#define MAX_SERVOS   (_Nbr_16timers  * SERVOS_PER_TIMER)
+
+#define INVALID_SERVO         255     // flag indicating an invalid servo index
+
+typedef struct  {
+  uint8_t nbr        :6 ;             // a pin number from 0 to 63
+  uint8_t isActive   :1 ;             // true if this channel is enabled, pin not pulsed if false 
+} ServoPin_t   ;  
+
+typedef struct {
+  ServoPin_t Pin;
+  unsigned int ticks;
+} servo_t;
+
+class Servo
+{
+public:
+  Servo();
+  uint8_t attach(int pin);           // attach the given pin to the next free channel, sets pinMode, returns channel number or 0 if failure
+  uint8_t attach(int pin, int min, int max); // as above but also sets min and max values for writes. 
+  void detach();
+  void write(int value);             // if value is < 200 its treated as an angle, otherwise as pulse width in microseconds 
+  void writeMicroseconds(int value); // Write pulse width in microseconds 
+  int read();                        // returns current pulse width as an angle between 0 and 180 degrees
+  int readMicroseconds();            // returns current pulse width in microseconds for this servo (was read_us() in first release)
+  bool attached();                   // return true if this servo is attached, otherwise false 
+private:
+   uint8_t servoIndex;               // index into the channel data for this servo
+   int8_t min;                       // minimum is this value times 4 added to MIN_PULSE_WIDTH    
+   int8_t max;                       // maximum is this value times 4 added to MAX_PULSE_WIDTH   
+};
+
+#endif
\ No newline at end of file
diff --git a/libraries/Servo/examples/Knob/Knob.pde b/libraries/Servo/examples/Knob/Knob.pde
new file mode 100644
index 0000000..886e107
--- /dev/null
+++ b/libraries/Servo/examples/Knob/Knob.pde
@@ -0,0 +1,22 @@
+// Controlling a servo position using a potentiometer (variable resistor) 
+// by Michal Rinott <http://people.interaction-ivrea.it/m.rinott> 
+
+#include <Servo.h> 
+ 
+Servo myservo;  // create servo object to control a servo 
+ 
+int potpin = 0;  // analog pin used to connect the potentiometer
+int val;    // variable to read the value from the analog pin 
+ 
+void setup() 
+{ 
+  myservo.attach(9);  // attaches the servo on pin 9 to the servo object 
+} 
+ 
+void loop() 
+{ 
+  val = analogRead(potpin);            // reads the value of the potentiometer (value between 0 and 1023) 
+  val = map(val, 0, 1023, 0, 179);     // scale it to use it with the servo (value between 0 and 180) 
+  myservo.write(val);                  // sets the servo position according to the scaled value 
+  delay(15);                           // waits for the servo to get there 
+} 
diff --git a/libraries/Servo/examples/Sweep/Sweep.pde b/libraries/Servo/examples/Sweep/Sweep.pde
new file mode 100644
index 0000000..fb326e7
--- /dev/null
+++ b/libraries/Servo/examples/Sweep/Sweep.pde
@@ -0,0 +1,31 @@
+// Sweep
+// by BARRAGAN <http://barraganstudio.com> 
+// This example code is in the public domain.
+
+
+#include <Servo.h> 
+ 
+Servo myservo;  // create servo object to control a servo 
+                // a maximum of eight servo objects can be created 
+ 
+int pos = 0;    // variable to store the servo position 
+ 
+void setup() 
+{ 
+  myservo.attach(9);  // attaches the servo on pin 9 to the servo object 
+} 
+ 
+ 
+void loop() 
+{ 
+  for(pos = 0; pos < 180; pos += 1)  // goes from 0 degrees to 180 degrees 
+  {                                  // in steps of 1 degree 
+    myservo.write(pos);              // tell servo to go to position in variable 'pos' 
+    delay(15);                       // waits 15ms for the servo to reach the position 
+  } 
+  for(pos = 180; pos>=1; pos-=1)     // goes from 180 degrees to 0 degrees 
+  {                                
+    myservo.write(pos);              // tell servo to go to position in variable 'pos' 
+    delay(15);                       // waits 15ms for the servo to reach the position 
+  } 
+} 
diff --git a/libraries/Servo/keywords.txt b/libraries/Servo/keywords.txt
new file mode 100755
index 0000000..ca5ba79
--- /dev/null
+++ b/libraries/Servo/keywords.txt
@@ -0,0 +1,24 @@
+#######################################
+# Syntax Coloring Map Servo
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+Servo	KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+attach	KEYWORD2
+detach	KEYWORD2
+write	KEYWORD2
+read	KEYWORD2
+attached	KEYWORD2
+writeMicroseconds	KEYWORD2
+readMicroseconds	KEYWORD2
+
+#######################################
+# Constants (LITERAL1)
+#######################################
diff --git a/libraries/SoftwareSerial/SoftwareSerial.cpp b/libraries/SoftwareSerial/SoftwareSerial.cpp
new file mode 100755
index 0000000..b8a1fc4
--- /dev/null
+++ b/libraries/SoftwareSerial/SoftwareSerial.cpp
@@ -0,0 +1,512 @@
+/*

+SoftwareSerial.cpp (formerly NewSoftSerial.cpp) - 

+Multi-instance software serial library for Arduino/Wiring

+-- Interrupt-driven receive and other improvements by ladyada

+   (http://ladyada.net)

+-- Tuning, circular buffer, derivation from class Print/Stream,

+   multi-instance support, porting to 8MHz processors,

+   various optimizations, PROGMEM delay tables, inverse logic and 

+   direct port writing by Mikal Hart (http://www.arduiniana.org)

+-- Pin change interrupt macros by Paul Stoffregen (http://www.pjrc.com)

+-- 20MHz processor support by Garrett Mace (http://www.macetech.com)

+-- ATmega1280/2560 support by Brett Hagman (http://www.roguerobotics.com/)

+

+This library is free software; you can redistribute it and/or

+modify it under the terms of the GNU Lesser General Public

+License as published by the Free Software Foundation; either

+version 2.1 of the License, or (at your option) any later version.

+

+This library is distributed in the hope that it will be useful,

+but WITHOUT ANY WARRANTY; without even the implied warranty of

+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

+Lesser General Public License for more details.

+

+You should have received a copy of the GNU Lesser General Public

+License along with this library; if not, write to the Free Software

+Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

+

+The latest version of this library can always be found at

+http://arduiniana.org.

+*/

+

+// When set, _DEBUG co-opts pins 11 and 13 for debugging with an

+// oscilloscope or logic analyzer.  Beware: it also slightly modifies

+// the bit times, so don't rely on it too much at high baud rates

+#define _DEBUG 0

+#define _DEBUG_PIN1 11

+#define _DEBUG_PIN2 13

+// 

+// Includes

+// 

+#include <avr/interrupt.h>

+#include <avr/pgmspace.h>

+#include "Arduino.h"

+#include "SoftwareSerial.h"

+#include "icrmacros.h"

+//

+// Lookup table

+//

+typedef struct _DELAY_TABLE

+{

+  long baud;

+  unsigned short rx_delay_centering;

+  unsigned short rx_delay_intrabit;

+  unsigned short rx_delay_stopbit;

+  unsigned short tx_delay;

+} DELAY_TABLE;

+

+#if F_CPU == 16000000

+

+static const DELAY_TABLE PROGMEM table[] = 

+{

+  //  baud    rxcenter   rxintra    rxstop    tx

+  { 115200,   1,         17,        17,       12,    },

+  { 57600,    10,        37,        37,       33,    },

+  { 38400,    25,        57,        57,       54,    },

+  { 31250,    31,        70,        70,       68,    },

+  { 28800,    34,        77,        77,       74,    },

+  { 19200,    54,        117,       117,      114,   },

+  { 14400,    74,        156,       156,      153,   },

+  { 9600,     114,       236,       236,      233,   },

+  { 4800,     233,       474,       474,      471,   },

+  { 2400,     471,       950,       950,      947,   },

+  { 1200,     947,       1902,      1902,     1899,  },

+  { 300,      3804,      7617,      7617,     7614,  },

+};

+

+const int XMIT_START_ADJUSTMENT = 5;

+

+#elif F_CPU == 8000000

+

+static const DELAY_TABLE table[] PROGMEM = 

+{

+  //  baud    rxcenter    rxintra    rxstop  tx

+  { 115200,   1,          5,         5,      3,      },

+  { 57600,    1,          15,        15,     13,     },

+  { 38400,    2,          25,        26,     23,     },

+  { 31250,    7,          32,        33,     29,     },

+  { 28800,    11,         35,        35,     32,     },

+  { 19200,    20,         55,        55,     52,     },

+  { 14400,    30,         75,        75,     72,     },

+  { 9600,     50,         114,       114,    112,    },

+  { 4800,     110,        233,       233,    230,    },

+  { 2400,     229,        472,       472,    469,    },

+  { 1200,     467,        948,       948,    945,    },

+  { 300,      1895,       3805,      3805,   3802,   },

+};

+

+const int XMIT_START_ADJUSTMENT = 4;

+

+#elif F_CPU == 20000000

+

+// 20MHz support courtesy of the good people at macegr.com.

+// Thanks, Garrett!

+

+static const DELAY_TABLE PROGMEM table[] =

+{

+  //  baud    rxcenter    rxintra    rxstop  tx

+  { 115200,   3,          21,        21,     18,     },

+  { 57600,    20,         43,        43,     41,     },

+  { 38400,    37,         73,        73,     70,     },

+  { 31250,    45,         89,        89,     88,     },

+  { 28800,    46,         98,        98,     95,     },

+  { 19200,    71,         148,       148,    145,    },

+  { 14400,    96,         197,       197,    194,    },

+  { 9600,     146,        297,       297,    294,    },

+  { 4800,     296,        595,       595,    592,    },

+  { 2400,     592,        1189,      1189,   1186,   },

+  { 1200,     1187,       2379,      2379,   2376,   },

+  { 300,      4759,       9523,      9523,   9520,   },

+};

+

+const int XMIT_START_ADJUSTMENT = 6;

+

+#else

+

+#error This version of SoftwareSerial supports only 20, 16 and 8MHz processors

+

+#endif

+

+//

+// Statics

+//

+SoftwareSerial *SoftwareSerial::active_object = 0;

+char SoftwareSerial::_receive_buffer[_SS_MAX_RX_BUFF]; 

+volatile uint8_t SoftwareSerial::_receive_buffer_tail = 0;

+volatile uint8_t SoftwareSerial::_receive_buffer_head = 0;

+

+//

+// Debugging

+//

+// This function generates a brief pulse

+// for debugging or measuring on an oscilloscope.

+inline void DebugPulse(uint8_t pin, uint8_t count)

+{

+#if _DEBUG

+  volatile uint8_t *pport = portOutputRegister(digitalPinToPort(pin));

+

+  uint8_t val = *pport;

+  while (count--)

+  {

+    *pport = val | digitalPinToBitMask(pin);

+    *pport = val;

+  }

+#endif

+}

+

+//

+// Private methods

+//

+

+/* static */ 

+inline void SoftwareSerial::tunedDelay(uint16_t delay) { 

+  uint8_t tmp=0;

+

+  asm volatile("sbiw    %0, 0x01 \n\t"

+    "ldi %1, 0xFF \n\t"

+    "cpi %A0, 0xFF \n\t"

+    "cpc %B0, %1 \n\t"

+    "brne .-10 \n\t"

+    : "+r" (delay), "+a" (tmp)

+    : "0" (delay)

+    );

+}

+

+// This function sets the current object as the "listening"

+// one and returns true if it replaces another 

+bool SoftwareSerial::listen()

+{

+  if (active_object != this)

+  {

+    _buffer_overflow = false;

+    uint8_t oldSREG = SREG;

+    cli();

+    _receive_buffer_head = _receive_buffer_tail = 0;

+    active_object = this;

+    SREG = oldSREG;

+    return true;

+  }

+

+  return false;

+}

+

+//

+// The receive routine called by the interrupt handler

+//

+void SoftwareSerial::recv()

+{

+

+#if GCC_VERSION < 40302

+// Work-around for avr-gcc 4.3.0 OSX version bug

+// Preserve the registers that the compiler misses

+// (courtesy of Arduino forum user *etracer*)

+  asm volatile(

+    "push r18 \n\t"

+    "push r19 \n\t"

+    "push r20 \n\t"

+    "push r21 \n\t"

+    "push r22 \n\t"

+    "push r23 \n\t"

+    "push r26 \n\t"

+    "push r27 \n\t"

+    ::);

+#endif  

+

+  uint8_t d = 0;

+

+  // If RX line is high, then we don't see any start bit

+  // so interrupt is probably not for us

+  if (_inverse_logic ? rx_pin_read() : !rx_pin_read())

+  {

+    // Wait approximately 1/2 of a bit width to "center" the sample

+    tunedDelay(_rx_delay_centering);

+    DebugPulse(_DEBUG_PIN2, 1);

+

+    // Read each of the 8 bits

+    for (uint8_t i=0x1; i; i <<= 1)

+    {

+      tunedDelay(_rx_delay_intrabit);

+      DebugPulse(_DEBUG_PIN2, 1);

+      uint8_t noti = ~i;

+      if (rx_pin_read())

+        d |= i;

+      else // else clause added to ensure function timing is ~balanced

+        d &= noti;

+    }

+

+    // skip the stop bit

+    tunedDelay(_rx_delay_stopbit);

+    DebugPulse(_DEBUG_PIN2, 1);

+

+    if (_inverse_logic)

+      d = ~d;

+

+    // if buffer full, set the overflow flag and return

+    if ((_receive_buffer_tail + 1) % _SS_MAX_RX_BUFF != _receive_buffer_head) 

+    {

+      // save new data in buffer: tail points to where byte goes

+      _receive_buffer[_receive_buffer_tail] = d; // save new byte

+      _receive_buffer_tail = (_receive_buffer_tail + 1) % _SS_MAX_RX_BUFF;

+    } 

+    else 

+    {

+#if _DEBUG // for scope: pulse pin as overflow indictator

+      DebugPulse(_DEBUG_PIN1, 1);

+#endif

+      _buffer_overflow = true;

+    }

+  }

+

+#if GCC_VERSION < 40302

+// Work-around for avr-gcc 4.3.0 OSX version bug

+// Restore the registers that the compiler misses

+  asm volatile(

+    "pop r27 \n\t"

+    "pop r26 \n\t"

+    "pop r23 \n\t"

+    "pop r22 \n\t"

+    "pop r21 \n\t"

+    "pop r20 \n\t"

+    "pop r19 \n\t"

+    "pop r18 \n\t"

+    ::);

+#endif

+}

+

+void SoftwareSerial::tx_pin_write(uint8_t pin_state)

+{

+  if (pin_state == LOW)

+    *_transmitPortRegister &= ~_transmitBitMask;

+  else

+    *_transmitPortRegister |= _transmitBitMask;

+}

+

+uint8_t SoftwareSerial::rx_pin_read()

+{

+  return *_receivePortRegister & _receiveBitMask;

+}

+

+//

+// Interrupt handling

+//

+

+/* static */

+inline void SoftwareSerial::handle_interrupt()

+{

+  if (active_object)

+  {

+    active_object->recv();

+  }

+}

+

+#if defined(PCINT0_vect)

+ISR(PCINT0_vect)

+{

+  SoftwareSerial::handle_interrupt();

+}

+#endif

+

+#if defined(PCINT1_vect)

+ISR(PCINT1_vect)

+{

+  SoftwareSerial::handle_interrupt();

+}

+#endif

+

+#if defined(PCINT2_vect)

+ISR(PCINT2_vect)

+{

+  SoftwareSerial::handle_interrupt();

+}

+#endif

+

+#if defined(PCINT3_vect)

+ISR(PCINT3_vect)

+{

+  SoftwareSerial::handle_interrupt();

+}

+#endif

+

+//

+// Constructor

+//

+SoftwareSerial::SoftwareSerial(uint8_t receivePin, uint8_t transmitPin, bool inverse_logic /* = false */) : 

+  _rx_delay_centering(0),

+  _rx_delay_intrabit(0),

+  _rx_delay_stopbit(0),

+  _tx_delay(0),

+  _buffer_overflow(false),

+  _inverse_logic(inverse_logic)

+{

+  setTX(transmitPin);

+  setRX(receivePin);

+}

+

+//

+// Destructor

+//

+SoftwareSerial::~SoftwareSerial()

+{

+  end();

+}

+

+void SoftwareSerial::setTX(uint8_t tx)

+{

+  pinMode(tx, OUTPUT);

+  digitalWrite(tx, HIGH);

+  _transmitBitMask = digitalPinToBitMask(tx);

+  uint8_t port = digitalPinToPort(tx);

+  _transmitPortRegister = portOutputRegister(port);

+}

+

+void SoftwareSerial::setRX(uint8_t rx)

+{

+  pinMode(rx, INPUT);

+  if (!_inverse_logic)

+    digitalWrite(rx, HIGH);  // pullup for normal logic!

+  _receivePin = rx;

+  _receiveBitMask = digitalPinToBitMask(rx);

+  uint8_t port = digitalPinToPort(rx);

+  _receivePortRegister = portInputRegister(port);

+}

+

+//

+// Public methods

+//

+

+void SoftwareSerial::begin(long speed)

+{

+  _rx_delay_centering = _rx_delay_intrabit = _rx_delay_stopbit = _tx_delay = 0;

+

+  for (unsigned i=0; i<sizeof(table)/sizeof(table[0]); ++i)

+  {

+    long baud = pgm_read_dword(&table[i].baud);

+    if (baud == speed)

+    {

+      _rx_delay_centering = pgm_read_word(&table[i].rx_delay_centering);

+      _rx_delay_intrabit = pgm_read_word(&table[i].rx_delay_intrabit);

+      _rx_delay_stopbit = pgm_read_word(&table[i].rx_delay_stopbit);

+      _tx_delay = pgm_read_word(&table[i].tx_delay);

+      break;

+    }

+  }

+

+  // Set up RX interrupts, but only if we have a valid RX baud rate

+  if (_rx_delay_stopbit)

+  {

+    if (digitalPinToPCICR(_receivePin))

+    {

+      *digitalPinToPCICR(_receivePin) |= _BV(digitalPinToPCICRbit(_receivePin));

+      *digitalPinToPCMSK(_receivePin) |= _BV(digitalPinToPCMSKbit(_receivePin));

+    }

+    tunedDelay(_tx_delay); // if we were low this establishes the end

+  }

+

+#if _DEBUG

+  pinMode(_DEBUG_PIN1, OUTPUT);

+  pinMode(_DEBUG_PIN2, OUTPUT);

+#endif

+

+  listen();

+}

+

+void SoftwareSerial::end()

+{

+  if (digitalPinToPCMSK(_receivePin))

+    *digitalPinToPCMSK(_receivePin) &= ~_BV(digitalPinToPCMSKbit(_receivePin));

+}

+

+

+// Read data from buffer

+int SoftwareSerial::read()

+{

+  if (!isListening())

+    return -1;

+

+  // Empty buffer?

+  if (_receive_buffer_head == _receive_buffer_tail)

+    return -1;

+

+  // Read from "head"

+  uint8_t d = _receive_buffer[_receive_buffer_head]; // grab next byte

+  _receive_buffer_head = (_receive_buffer_head + 1) % _SS_MAX_RX_BUFF;

+  return d;

+}

+

+int SoftwareSerial::available()

+{

+  if (!isListening())

+    return 0;

+

+  return (_receive_buffer_tail + _SS_MAX_RX_BUFF - _receive_buffer_head) % _SS_MAX_RX_BUFF;

+}

+

+void SoftwareSerial::write(uint8_t b)

+{

+  if (_tx_delay == 0)

+    return;

+

+  uint8_t oldSREG = SREG;

+  cli();  // turn off interrupts for a clean txmit

+

+  // Write the start bit

+  tx_pin_write(_inverse_logic ? HIGH : LOW);

+  tunedDelay(_tx_delay + XMIT_START_ADJUSTMENT);

+

+  // Write each of the 8 bits

+  if (_inverse_logic)

+  {

+    for (byte mask = 0x01; mask; mask <<= 1)

+    {

+      if (b & mask) // choose bit

+        tx_pin_write(LOW); // send 1

+      else

+        tx_pin_write(HIGH); // send 0

+    

+      tunedDelay(_tx_delay);

+    }

+

+    tx_pin_write(LOW); // restore pin to natural state

+  }

+  else

+  {

+    for (byte mask = 0x01; mask; mask <<= 1)

+    {

+      if (b & mask) // choose bit

+        tx_pin_write(HIGH); // send 1

+      else

+        tx_pin_write(LOW); // send 0

+    

+      tunedDelay(_tx_delay);

+    }

+

+    tx_pin_write(HIGH); // restore pin to natural state

+  }

+

+  SREG = oldSREG; // turn interrupts back on

+  tunedDelay(_tx_delay);

+}

+

+void SoftwareSerial::flush()

+{

+  if (!isListening())

+    return;

+

+  uint8_t oldSREG = SREG;

+  cli();

+  _receive_buffer_head = _receive_buffer_tail = 0;

+  SREG = oldSREG;

+}

+

+int SoftwareSerial::peek()

+{

+  if (!isListening())

+    return -1;

+

+  // Empty buffer?

+  if (_receive_buffer_head == _receive_buffer_tail)

+    return -1;

+

+  // Read from "head"

+  return _receive_buffer[_receive_buffer_head];

+}

diff --git a/libraries/SoftwareSerial/SoftwareSerial.h b/libraries/SoftwareSerial/SoftwareSerial.h
new file mode 100755
index 0000000..2fc998c
--- /dev/null
+++ b/libraries/SoftwareSerial/SoftwareSerial.h
@@ -0,0 +1,110 @@
+/*

+SoftwareSerial.h (formerly NewSoftSerial.h) - 

+Multi-instance software serial library for Arduino/Wiring

+-- Interrupt-driven receive and other improvements by ladyada

+   (http://ladyada.net)

+-- Tuning, circular buffer, derivation from class Print/Stream,

+   multi-instance support, porting to 8MHz processors,

+   various optimizations, PROGMEM delay tables, inverse logic and 

+   direct port writing by Mikal Hart (http://www.arduiniana.org)

+-- Pin change interrupt macros by Paul Stoffregen (http://www.pjrc.com)

+-- 20MHz processor support by Garrett Mace (http://www.macetech.com)

+-- ATmega1280/2560 support by Brett Hagman (http://www.roguerobotics.com/)

+

+This library is free software; you can redistribute it and/or

+modify it under the terms of the GNU Lesser General Public

+License as published by the Free Software Foundation; either

+version 2.1 of the License, or (at your option) any later version.

+

+This library is distributed in the hope that it will be useful,

+but WITHOUT ANY WARRANTY; without even the implied warranty of

+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

+Lesser General Public License for more details.

+

+You should have received a copy of the GNU Lesser General Public

+License along with this library; if not, write to the Free Software

+Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

+

+The latest version of this library can always be found at

+http://arduiniana.org.

+*/

+

+#ifndef SoftwareSerial_h

+#define SoftwareSerial_h

+

+#include <inttypes.h>

+#include <Stream.h>

+

+/******************************************************************************

+* Definitions

+******************************************************************************/

+

+#define _SS_MAX_RX_BUFF 64 // RX buffer size

+#ifndef GCC_VERSION

+#define GCC_VERSION (__GNUC__ * 10000 + __GNUC_MINOR__ * 100 + __GNUC_PATCHLEVEL__)

+#endif

+

+class SoftwareSerial : public Stream

+{

+private:

+  // per object data

+  uint8_t _receivePin;

+  uint8_t _receiveBitMask;

+  volatile uint8_t *_receivePortRegister;

+  uint8_t _transmitBitMask;

+  volatile uint8_t *_transmitPortRegister;

+

+  uint16_t _rx_delay_centering;

+  uint16_t _rx_delay_intrabit;

+  uint16_t _rx_delay_stopbit;

+  uint16_t _tx_delay;

+

+  uint16_t _buffer_overflow:1;

+  uint16_t _inverse_logic:1;

+

+  // static data

+  static char _receive_buffer[_SS_MAX_RX_BUFF]; 

+  static volatile uint8_t _receive_buffer_tail;

+  static volatile uint8_t _receive_buffer_head;

+  static SoftwareSerial *active_object;

+

+  // private methods

+  void recv();

+  uint8_t rx_pin_read();

+  void tx_pin_write(uint8_t pin_state);

+  void setTX(uint8_t transmitPin);

+  void setRX(uint8_t receivePin);

+

+  // private static method for timing

+  static inline void tunedDelay(uint16_t delay);

+

+public:

+  // public methods

+  SoftwareSerial(uint8_t receivePin, uint8_t transmitPin, bool inverse_logic = false);

+  ~SoftwareSerial();

+  void begin(long speed);

+  bool listen();

+  void end();

+  bool isListening() { return this == active_object; }

+  bool overflow() { bool ret = _buffer_overflow; _buffer_overflow = false; return ret; }

+  int peek();

+

+  virtual void write(uint8_t byte);

+  virtual int read();

+  virtual int available();

+  virtual void flush();

+

+  // public only for easy access by interrupt handlers

+  static inline void handle_interrupt();

+};

+

+// Arduino 0012 workaround

+#undef int

+#undef char

+#undef long

+#undef byte

+#undef float

+#undef abs

+#undef round

+

+#endif

diff --git a/libraries/SoftwareSerial/examples/SoftwareSerialExample/SoftwareSerialExample.ino b/libraries/SoftwareSerial/examples/SoftwareSerialExample/SoftwareSerialExample.ino
new file mode 100644
index 0000000..1f535bd
--- /dev/null
+++ b/libraries/SoftwareSerial/examples/SoftwareSerialExample/SoftwareSerialExample.ino
@@ -0,0 +1,21 @@
+#include <SoftwareSerial.h>
+
+SoftwareSerial mySerial(2, 3);
+
+void setup()  
+{
+  Serial.begin(57600);
+  Serial.println("Goodnight moon!");
+
+  // set the data rate for the SoftwareSerial port
+  mySerial.begin(4800);
+  mySerial.println("Hello, world?");
+}
+
+void loop() // run over and over
+{
+  if (mySerial.available())
+    Serial.write(mySerial.read());
+  if (Serial.available())
+    mySerial.write(Serial.read());
+}
diff --git a/libraries/SoftwareSerial/examples/TwoPortRXExample/TwoPortRXExample.pde b/libraries/SoftwareSerial/examples/TwoPortRXExample/TwoPortRXExample.pde
new file mode 100755
index 0000000..1db4536
--- /dev/null
+++ b/libraries/SoftwareSerial/examples/TwoPortRXExample/TwoPortRXExample.pde
@@ -0,0 +1,50 @@
+#include <SoftwareSerial.h>

+

+SoftwareSerial ss(2, 3);

+SoftwareSerial ss2(4, 5);

+

+/* This sample shows how to correctly process received data

+   on two different "soft" serial ports.  Here we listen on 

+   the first port (ss) until we receive a '?' character.  Then

+   we begin listening on the other soft port.

+*/

+

+void setup()

+{

+  // Start the HW serial port

+  Serial.begin(57600);

+

+  // Start each soft serial port

+  ss.begin(4800);

+  ss2.begin(4800);

+

+  // By default, the most recently "begun" port is listening.

+  // We want to listen on ss, so let's explicitly select it.

+  ss.listen();

+  

+  // Simply wait for a ? character to come down the pipe

+  Serial.println("Data from the first port: ");

+  char c = 0;

+  do

+    if (ss.available())

+    {

+      c = (char)ss.read();

+      Serial.print(c);

+    }

+  while (c != '?');

+

+  // Now listen on the second port

+  ss2.listen();

+

+  Serial.println("Data from the second port: ");

+}

+

+void loop()

+{

+  if (ss2.available())

+  {

+    char c = (char)ss2.read();

+    Serial.print(c);

+  }

+}

+  

diff --git a/libraries/SoftwareSerial/icrmacros.h b/libraries/SoftwareSerial/icrmacros.h
new file mode 100755
index 0000000..936eae8
--- /dev/null
+++ b/libraries/SoftwareSerial/icrmacros.h
@@ -0,0 +1,69 @@
+/*

+icrmacros.h

+

+A place to put useful ICR (interrupt change register) macros

+

+If you want to support non-Arduino processors you can extend or replace

+this file.

+

+This library is free software; you can redistribute it and/or

+modify it under the terms of the GNU Lesser General Public

+License as published by the Free Software Foundation; either

+version 2.1 of the License, or (at your option) any later version.

+

+This library is distributed in the hope that it will be useful,

+but WITHOUT ANY WARRANTY; without even the implied warranty of

+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

+Lesser General Public License for more details.

+

+You should have received a copy of the GNU Lesser General Public

+License along with this library; if not, write to the Free Software

+Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

+

+The latest version of this library can always be found at

+http://arduiniana.org.

+*/

+

+// Abstractions for maximum portability between processors

+// These are macros to associate pins to pin change interrupts

+#if !defined(digitalPinToPCICR) // Courtesy Paul Stoffregen

+

+#if defined(__AVR_ATmega168__) || defined(__AVR_ATmega328P__)

+

+#define digitalPinToPCICR(p)    (((p) >= 0 && (p) <= 21) ? (&PCICR) : ((uint8_t *)0))

+#define digitalPinToPCICRbit(p) (((p) <= 7) ? 2 : (((p) <= 13) ? 0 : 1))

+#define digitalPinToPCMSK(p)    (((p) <= 7) ? (&PCMSK2) : (((p) <= 13) ? (&PCMSK0) : (((p) <= 21) ? (&PCMSK1) : ((uint8_t *)0))))

+#define digitalPinToPCMSKbit(p) (((p) <= 7) ? (p) : (((p) <= 13) ? ((p) - 8) : ((p) - 14)))

+

+#elif defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)

+// Specifically for the Arduino Mega 2560 (or 1280 on the original Arduino Mega)

+// A majority of the pins are NOT PCINTs, SO BE WARNED (i.e. you cannot use them as receive pins)

+// Only pins available for RECEIVE (TRANSMIT can be on any pin):

+// (I've deliberately left out pin mapping to the Hardware USARTs - seems senseless to me)

+// Pins: 10, 11, 12, 13,  50, 51, 52, 53,  62, 63, 64, 65, 66, 67, 68, 69

+

+#define digitalPinToPCICR(p)    ( (((p) >= 10) && ((p) <= 13)) || \

+                                  (((p) >= 50) && ((p) <= 53)) || \

+                                  (((p) >= 62) && ((p) <= 69)) ? (&PCICR) : ((uint8_t *)0) )

+

+#define digitalPinToPCICRbit(p) ( (((p) >= 10) && ((p) <= 13)) || (((p) >= 50) && ((p) <= 53)) ? 0 : \

+                                ( (((p) >= 62) && ((p) <= 69)) ? 2 : \

+                                0 ) )

+

+#define digitalPinToPCMSK(p)    ( (((p) >= 10) && ((p) <= 13)) || (((p) >= 50) && ((p) <= 53)) ? (&PCMSK0) : \

+                                ( (((p) >= 62) && ((p) <= 69)) ? (&PCMSK2) : \

+                                ((uint8_t *)0) ) )

+

+#define digitalPinToPCMSKbit(p) ( (((p) >= 10) && ((p) <= 13)) ? ((p) - 6) : \

+                                ( ((p) == 50) ? 3 : \

+                                ( ((p) == 51) ? 2 : \

+                                ( ((p) == 52) ? 1 : \

+                                ( ((p) == 53) ? 0 : \

+                                ( (((p) >= 62) && ((p) <= 69)) ? ((p) - 62) : \

+                                0 ) ) ) ) ) )

+

+#else

+#error This processor is not supported by SoftwareSerial

+#endif

+#endif

+

diff --git a/libraries/SoftwareSerial/keywords.txt b/libraries/SoftwareSerial/keywords.txt
new file mode 100755
index 0000000..90d4c15
--- /dev/null
+++ b/libraries/SoftwareSerial/keywords.txt
@@ -0,0 +1,27 @@
+#######################################
+# Syntax Coloring Map for NewSoftSerial
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+NewSoftSerial	KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+
+begin	KEYWORD2
+end	KEYWORD2
+read	KEYWORD2
+available	KEYWORD2
+isListening	KEYWORD2
+overflow	KEYWORD2
+flush	KEYWORD2
+listen	KEYWORD2
+
+#######################################
+# Constants (LITERAL1)
+#######################################
+
diff --git a/libraries/Wire/Wire.cpp b/libraries/Wire/Wire.cpp
new file mode 100755
index 0000000..5818bee
--- /dev/null
+++ b/libraries/Wire/Wire.cpp
@@ -0,0 +1,270 @@
+/*
+  TwoWire.cpp - TWI/I2C library for Wiring & Arduino
+  Copyright (c) 2006 Nicholas Zambetti.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+extern "C" {
+  #include <stdlib.h>
+  #include <string.h>
+  #include <inttypes.h>
+  #include "twi.h"
+}
+
+#include "Wire.h"
+
+// Initialize Class Variables //////////////////////////////////////////////////
+
+uint8_t TwoWire::rxBuffer[BUFFER_LENGTH];
+uint8_t TwoWire::rxBufferIndex = 0;
+uint8_t TwoWire::rxBufferLength = 0;
+
+uint8_t TwoWire::txAddress = 0;
+uint8_t TwoWire::txBuffer[BUFFER_LENGTH];
+uint8_t TwoWire::txBufferIndex = 0;
+uint8_t TwoWire::txBufferLength = 0;
+
+uint8_t TwoWire::transmitting = 0;
+void (*TwoWire::user_onRequest)(void);
+void (*TwoWire::user_onReceive)(int);
+
+// Constructors ////////////////////////////////////////////////////////////////
+
+TwoWire::TwoWire()
+{
+}
+
+// Public Methods //////////////////////////////////////////////////////////////
+
+void TwoWire::begin(void)
+{
+  rxBufferIndex = 0;
+  rxBufferLength = 0;
+
+  txBufferIndex = 0;
+  txBufferLength = 0;
+
+  twi_init();
+}
+
+void TwoWire::begin(uint8_t address)
+{
+  twi_setAddress(address);
+  twi_attachSlaveTxEvent(onRequestService);
+  twi_attachSlaveRxEvent(onReceiveService);
+  begin();
+}
+
+void TwoWire::begin(int address)
+{
+  begin((uint8_t)address);
+}
+
+uint8_t TwoWire::requestFrom(uint8_t address, uint8_t quantity)
+{
+  // clamp to buffer length
+  if(quantity > BUFFER_LENGTH){
+    quantity = BUFFER_LENGTH;
+  }
+  // perform blocking read into buffer
+  uint8_t read = twi_readFrom(address, rxBuffer, quantity);
+  // set rx buffer iterator vars
+  rxBufferIndex = 0;
+  rxBufferLength = read;
+
+  return read;
+}
+
+uint8_t TwoWire::requestFrom(int address, int quantity)
+{
+  return requestFrom((uint8_t)address, (uint8_t)quantity);
+}
+
+void TwoWire::beginTransmission(uint8_t address)
+{
+  // indicate that we are transmitting
+  transmitting = 1;
+  // set address of targeted slave
+  txAddress = address;
+  // reset tx buffer iterator vars
+  txBufferIndex = 0;
+  txBufferLength = 0;
+}
+
+void TwoWire::beginTransmission(int address)
+{
+  beginTransmission((uint8_t)address);
+}
+
+uint8_t TwoWire::endTransmission(void)
+{
+  // transmit buffer (blocking)
+  int8_t ret = twi_writeTo(txAddress, txBuffer, txBufferLength, 1);
+  // reset tx buffer iterator vars
+  txBufferIndex = 0;
+  txBufferLength = 0;
+  // indicate that we are done transmitting
+  transmitting = 0;
+  return ret;
+}
+
+// must be called in:
+// slave tx event callback
+// or after beginTransmission(address)
+void TwoWire::write(uint8_t data)
+{
+  if(transmitting){
+  // in master transmitter mode
+    // don't bother if buffer is full
+    if(txBufferLength >= BUFFER_LENGTH){
+      return;
+    }
+    // put byte in tx buffer
+    txBuffer[txBufferIndex] = data;
+    ++txBufferIndex;
+    // update amount in buffer   
+    txBufferLength = txBufferIndex;
+  }else{
+  // in slave send mode
+    // reply to master
+    twi_transmit(&data, 1);
+  }
+}
+
+// must be called in:
+// slave tx event callback
+// or after beginTransmission(address)
+void TwoWire::write(const uint8_t *data, size_t quantity)
+{
+  if(transmitting){
+  // in master transmitter mode
+    for(size_t i = 0; i < quantity; ++i){
+      write(data[i]);
+    }
+  }else{
+  // in slave send mode
+    // reply to master
+    twi_transmit(data, quantity);
+  }
+}
+
+// must be called in:
+// slave tx event callback
+// or after beginTransmission(address)
+void TwoWire::write(const char *data)
+{
+  write((uint8_t*)data, strlen(data));
+}
+
+// must be called in:
+// slave rx event callback
+// or after requestFrom(address, numBytes)
+int TwoWire::available(void)
+{
+  return rxBufferLength - rxBufferIndex;
+}
+
+// must be called in:
+// slave rx event callback
+// or after requestFrom(address, numBytes)
+int TwoWire::read(void)
+{
+  int value = -1;
+  
+  // get each successive byte on each call
+  if(rxBufferIndex < rxBufferLength){
+    value = rxBuffer[rxBufferIndex];
+    ++rxBufferIndex;
+  }
+
+  return value;
+}
+
+// must be called in:
+// slave rx event callback
+// or after requestFrom(address, numBytes)
+int TwoWire::peek(void)
+{
+  int value = -1;
+  
+  if(rxBufferIndex < rxBufferLength){
+    value = rxBuffer[rxBufferIndex];
+  }
+
+  return value;
+}
+
+void TwoWire::flush(void)
+{
+  // XXX: to be implemented.
+}
+
+// behind the scenes function that is called when data is received
+void TwoWire::onReceiveService(uint8_t* inBytes, int numBytes)
+{
+  // don't bother if user hasn't registered a callback
+  if(!user_onReceive){
+    return;
+  }
+  // don't bother if rx buffer is in use by a master requestFrom() op
+  // i know this drops data, but it allows for slight stupidity
+  // meaning, they may not have read all the master requestFrom() data yet
+  if(rxBufferIndex < rxBufferLength){
+    return;
+  }
+  // copy twi rx buffer into local read buffer
+  // this enables new reads to happen in parallel
+  for(uint8_t i = 0; i < numBytes; ++i){
+    rxBuffer[i] = inBytes[i];    
+  }
+  // set rx iterator vars
+  rxBufferIndex = 0;
+  rxBufferLength = numBytes;
+  // alert user program
+  user_onReceive(numBytes);
+}
+
+// behind the scenes function that is called when data is requested
+void TwoWire::onRequestService(void)
+{
+  // don't bother if user hasn't registered a callback
+  if(!user_onRequest){
+    return;
+  }
+  // reset tx buffer iterator vars
+  // !!! this will kill any pending pre-master sendTo() activity
+  txBufferIndex = 0;
+  txBufferLength = 0;
+  // alert user program
+  user_onRequest();
+}
+
+// sets function called on slave write
+void TwoWire::onReceive( void (*function)(int) )
+{
+  user_onReceive = function;
+}
+
+// sets function called on slave read
+void TwoWire::onRequest( void (*function)(void) )
+{
+  user_onRequest = function;
+}
+
+// Preinstantiate Objects //////////////////////////////////////////////////////
+
+TwoWire Wire = TwoWire();
+
diff --git a/libraries/Wire/Wire.h b/libraries/Wire/Wire.h
new file mode 100755
index 0000000..51df04e
--- /dev/null
+++ b/libraries/Wire/Wire.h
@@ -0,0 +1,69 @@
+/*
+  TwoWire.h - TWI/I2C library for Arduino & Wiring
+  Copyright (c) 2006 Nicholas Zambetti.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#ifndef TwoWire_h
+#define TwoWire_h
+
+#include <inttypes.h>
+#include "Stream.h"
+
+#define BUFFER_LENGTH 32
+
+class TwoWire : public Stream
+{
+  private:
+    static uint8_t rxBuffer[];
+    static uint8_t rxBufferIndex;
+    static uint8_t rxBufferLength;
+
+    static uint8_t txAddress;
+    static uint8_t txBuffer[];
+    static uint8_t txBufferIndex;
+    static uint8_t txBufferLength;
+
+    static uint8_t transmitting;
+    static void (*user_onRequest)(void);
+    static void (*user_onReceive)(int);
+    static void onRequestService(void);
+    static void onReceiveService(uint8_t*, int);
+  public:
+    TwoWire();
+    void begin();
+    void begin(uint8_t);
+    void begin(int);
+    void beginTransmission(uint8_t);
+    void beginTransmission(int);
+    uint8_t endTransmission(void);
+    uint8_t requestFrom(uint8_t, uint8_t);
+    uint8_t requestFrom(int, int);
+    virtual void write(uint8_t);
+    virtual void write(const char *);
+    virtual void write(const uint8_t *, size_t);
+    virtual int available(void);
+    virtual int read(void);
+    virtual int peek(void);
+	virtual void flush(void);
+    void onReceive( void (*)(int) );
+    void onRequest( void (*)(void) );
+};
+
+extern TwoWire Wire;
+
+#endif
+
diff --git a/libraries/Wire/examples/SFRRanger_reader/SFRRanger_reader.pde b/libraries/Wire/examples/SFRRanger_reader/SFRRanger_reader.pde
new file mode 100755
index 0000000..9c41c18
--- /dev/null
+++ b/libraries/Wire/examples/SFRRanger_reader/SFRRanger_reader.pde
@@ -0,0 +1,87 @@
+// I2C SRF10 or SRF08 Devantech Ultrasonic Ranger Finder 
+// by Nicholas Zambetti <http://www.zambetti.com>
+// and James Tichenor <http://www.jamestichenor.net> 
+
+// Demonstrates use of the Wire library reading data from the 
+// Devantech Utrasonic Rangers SFR08 and SFR10
+
+// Created 29 April 2006
+
+// This example code is in the public domain.
+
+
+#include <Wire.h>
+
+void setup()
+{
+  Wire.begin();                // join i2c bus (address optional for master)
+  Serial.begin(9600);          // start serial communication at 9600bps
+}
+
+int reading = 0;
+
+void loop()
+{
+  // step 1: instruct sensor to read echoes
+  Wire.beginTransmission(112); // transmit to device #112 (0x70)
+                               // the address specified in the datasheet is 224 (0xE0)
+                               // but i2c adressing uses the high 7 bits so it's 112
+  Wire.write(byte(0x00));      // sets register pointer to the command register (0x00)  
+  Wire.write(byte(0x50));      // command sensor to measure in "inches" (0x50) 
+                               // use 0x51 for centimeters
+                               // use 0x52 for ping microseconds
+  Wire.endTransmission();      // stop transmitting
+
+  // step 2: wait for readings to happen
+  delay(70);                   // datasheet suggests at least 65 milliseconds
+
+  // step 3: instruct sensor to return a particular echo reading
+  Wire.beginTransmission(112); // transmit to device #112
+  Wire.write(byte(0x02));      // sets register pointer to echo #1 register (0x02)
+  Wire.endTransmission();      // stop transmitting
+
+  // step 4: request reading from sensor
+  Wire.requestFrom(112, 2);    // request 2 bytes from slave device #112
+
+  // step 5: receive reading from sensor
+  if(2 <= Wire.available())    // if two bytes were received
+  {
+    reading = Wire.read();  // receive high byte (overwrites previous reading)
+    reading = reading << 8;    // shift high byte to be high 8 bits
+    reading |= Wire.read(); // receive low byte as lower 8 bits
+    Serial.println(reading);   // print the reading
+  }
+
+  delay(250);                  // wait a bit since people have to read the output :)
+}
+
+
+/*
+
+// The following code changes the address of a Devantech Ultrasonic Range Finder (SRF10 or SRF08)
+// usage: changeAddress(0x70, 0xE6);
+
+void changeAddress(byte oldAddress, byte newAddress)
+{
+  Wire.beginTransmission(oldAddress);
+  Wire.write(byte(0x00));
+  Wire.write(byte(0xA0));
+  Wire.endTransmission();
+
+  Wire.beginTransmission(oldAddress);
+  Wire.write(byte(0x00));
+  Wire.write(byte(0xAA));
+  Wire.endTransmission();
+
+  Wire.beginTransmission(oldAddress);
+  Wire.write(byte(0x00));
+  Wire.write(byte(0xA5));
+  Wire.endTransmission();
+
+  Wire.beginTransmission(oldAddress);
+  Wire.write(byte(0x00));
+  Wire.write(newAddress);
+  Wire.endTransmission();
+}
+
+*/
diff --git a/libraries/Wire/examples/digital_potentiometer/digital_potentiometer.pde b/libraries/Wire/examples/digital_potentiometer/digital_potentiometer.pde
new file mode 100644
index 0000000..38da1c5
--- /dev/null
+++ b/libraries/Wire/examples/digital_potentiometer/digital_potentiometer.pde
@@ -0,0 +1,39 @@
+// I2C Digital Potentiometer
+// by Nicholas Zambetti <http://www.zambetti.com>
+// and Shawn Bonkowski <http://people.interaction-ivrea.it/s.bonkowski/>
+
+// Demonstrates use of the Wire library
+// Controls AD5171 digital potentiometer via I2C/TWI
+
+// Created 31 March 2006
+
+// This example code is in the public domain.
+
+// This example code is in the public domain.
+
+
+#include <Wire.h>
+
+void setup()
+{
+  Wire.begin(); // join i2c bus (address optional for master)
+}
+
+byte val = 0;
+
+void loop()
+{
+  Wire.beginTransmission(44); // transmit to device #44 (0x2c)
+                              // device address is specified in datasheet
+  Wire.write(byte(0x00));            // sends instruction byte  
+  Wire.write(val);             // sends potentiometer value byte  
+  Wire.endTransmission();     // stop transmitting
+
+  val++;        // increment value
+  if(val == 64) // if reached 64th position (max)
+  {
+    val = 0;    // start over from lowest value
+  }
+  delay(500);
+}
+
diff --git a/libraries/Wire/examples/master_reader/master_reader.pde b/libraries/Wire/examples/master_reader/master_reader.pde
new file mode 100644
index 0000000..4124d7d
--- /dev/null
+++ b/libraries/Wire/examples/master_reader/master_reader.pde
@@ -0,0 +1,32 @@
+// Wire Master Reader
+// by Nicholas Zambetti <http://www.zambetti.com>
+
+// Demonstrates use of the Wire library
+// Reads data from an I2C/TWI slave device
+// Refer to the "Wire Slave Sender" example for use with this
+
+// Created 29 March 2006
+
+// This example code is in the public domain.
+
+
+#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);
+}
diff --git a/libraries/Wire/examples/master_writer/master_writer.pde b/libraries/Wire/examples/master_writer/master_writer.pde
new file mode 100644
index 0000000..ccaa036
--- /dev/null
+++ b/libraries/Wire/examples/master_writer/master_writer.pde
@@ -0,0 +1,31 @@
+// Wire Master Writer
+// by Nicholas Zambetti <http://www.zambetti.com>
+
+// Demonstrates use of the Wire library
+// Writes data to an I2C/TWI slave device
+// Refer to the "Wire Slave Receiver" example for use with this
+
+// Created 29 March 2006
+
+// This example code is in the public domain.
+
+
+#include <Wire.h>
+
+void setup()
+{
+  Wire.begin(); // join i2c bus (address optional for master)
+}
+
+byte x = 0;
+
+void loop()
+{
+  Wire.beginTransmission(4); // transmit to device #4
+  Wire.write("x is ");        // sends five bytes
+  Wire.write(x);              // sends one byte  
+  Wire.endTransmission();    // stop transmitting
+
+  x++;
+  delay(500);
+}
diff --git a/libraries/Wire/examples/slave_receiver/slave_receiver.pde b/libraries/Wire/examples/slave_receiver/slave_receiver.pde
new file mode 100644
index 0000000..60dd4bd
--- /dev/null
+++ b/libraries/Wire/examples/slave_receiver/slave_receiver.pde
@@ -0,0 +1,38 @@
+// Wire Slave Receiver
+// by Nicholas Zambetti <http://www.zambetti.com>
+
+// Demonstrates use of the Wire library
+// Receives data as an I2C/TWI slave device
+// Refer to the "Wire Master Writer" example for use with this
+
+// Created 29 March 2006
+
+// This example code is in the public domain.
+
+
+#include <Wire.h>
+
+void setup()
+{
+  Wire.begin(4);                // join i2c bus with address #4
+  Wire.onReceive(receiveEvent); // register event
+  Serial.begin(9600);           // start serial for output
+}
+
+void loop()
+{
+  delay(100);
+}
+
+// function that executes whenever data is received from master
+// this function is registered as an event, see setup()
+void receiveEvent(int howMany)
+{
+  while(1 < Wire.available()) // loop through all but the last
+  {
+    char c = Wire.read(); // receive byte as a character
+    Serial.print(c);         // print the character
+  }
+  int x = Wire.read();    // receive byte as an integer
+  Serial.println(x);         // print the integer
+}
diff --git a/libraries/Wire/examples/slave_sender/slave_sender.pde b/libraries/Wire/examples/slave_sender/slave_sender.pde
new file mode 100644
index 0000000..d3b238a
--- /dev/null
+++ b/libraries/Wire/examples/slave_sender/slave_sender.pde
@@ -0,0 +1,32 @@
+// Wire Slave Sender
+// by Nicholas Zambetti <http://www.zambetti.com>
+
+// Demonstrates use of the Wire library
+// Sends data as an I2C/TWI slave device
+// Refer to the "Wire Master Reader" example for use with this
+
+// Created 29 March 2006
+
+// This example code is in the public domain.
+
+
+#include <Wire.h>
+
+void setup()
+{
+  Wire.begin(2);                // join i2c bus with address #2
+  Wire.onRequest(requestEvent); // register event
+}
+
+void loop()
+{
+  delay(100);
+}
+
+// function that executes whenever data is requested by master
+// this function is registered as an event, see setup()
+void requestEvent()
+{
+  Wire.write("hello "); // respond with message of 6 bytes
+                       // as expected by master
+}
diff --git a/libraries/Wire/keywords.txt b/libraries/Wire/keywords.txt
new file mode 100644
index 0000000..12f129b
--- /dev/null
+++ b/libraries/Wire/keywords.txt
@@ -0,0 +1,31 @@
+#######################################
+# Syntax Coloring Map For Wire
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+
+begin	KEYWORD2
+beginTransmission	KEYWORD2
+endTransmission	KEYWORD2
+requestFrom	KEYWORD2
+send	KEYWORD2
+receive	KEYWORD2
+onReceive	KEYWORD2
+onRequest	KEYWORD2
+
+#######################################
+# Instances (KEYWORD2)
+#######################################
+
+Wire	KEYWORD2
+
+#######################################
+# Constants (LITERAL1)
+#######################################
+
diff --git a/libraries/Wire/utility/twi.c b/libraries/Wire/utility/twi.c
new file mode 100644
index 0000000..cef8373
--- /dev/null
+++ b/libraries/Wire/utility/twi.c
@@ -0,0 +1,476 @@
+/*
+  twi.c - TWI/I2C library for Wiring & Arduino
+  Copyright (c) 2006 Nicholas Zambetti.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#include <math.h>
+#include <stdlib.h>
+#include <inttypes.h>
+#include <avr/io.h>
+#include <avr/interrupt.h>
+#include <compat/twi.h>
+
+#ifndef cbi
+#define cbi(sfr, bit) (_SFR_BYTE(sfr) &= ~_BV(bit))
+#endif
+
+#ifndef sbi
+#define sbi(sfr, bit) (_SFR_BYTE(sfr) |= _BV(bit))
+#endif
+
+#include "twi.h"
+
+static volatile uint8_t twi_state;
+static uint8_t twi_slarw;
+
+static void (*twi_onSlaveTransmit)(void);
+static void (*twi_onSlaveReceive)(uint8_t*, int);
+
+static uint8_t twi_masterBuffer[TWI_BUFFER_LENGTH];
+static volatile uint8_t twi_masterBufferIndex;
+static uint8_t twi_masterBufferLength;
+
+static uint8_t twi_txBuffer[TWI_BUFFER_LENGTH];
+static volatile uint8_t twi_txBufferIndex;
+static volatile uint8_t twi_txBufferLength;
+
+static uint8_t twi_rxBuffer[TWI_BUFFER_LENGTH];
+static volatile uint8_t twi_rxBufferIndex;
+
+static volatile uint8_t twi_error;
+
+/* 
+ * Function twi_init
+ * Desc     readys twi pins and sets twi bitrate
+ * Input    none
+ * Output   none
+ */
+void twi_init(void)
+{
+  // initialize state
+  twi_state = TWI_READY;
+
+  #if defined(__AVR_ATmega168__) || defined(__AVR_ATmega8__) || defined(__AVR_ATmega328P__)
+    // activate internal pull-ups for twi
+    // as per note from atmega8 manual pg167
+    sbi(PORTC, 4);
+    sbi(PORTC, 5);
+  #else
+    // activate internal pull-ups for twi
+    // as per note from atmega128 manual pg204
+    sbi(PORTD, 0);
+    sbi(PORTD, 1);
+  #endif
+
+  // initialize twi prescaler and bit rate
+  cbi(TWSR, TWPS0);
+  cbi(TWSR, TWPS1);
+  TWBR = ((F_CPU / TWI_FREQ) - 16) / 2;
+
+  /* twi bit rate formula from atmega128 manual pg 204
+  SCL Frequency = CPU Clock Frequency / (16 + (2 * TWBR))
+  note: TWBR should be 10 or higher for master mode
+  It is 72 for a 16mhz Wiring board with 100kHz TWI */
+
+  // enable twi module, acks, and twi interrupt
+  TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWEA);
+}
+
+/* 
+ * Function twi_slaveInit
+ * Desc     sets slave address and enables interrupt
+ * Input    none
+ * Output   none
+ */
+void twi_setAddress(uint8_t address)
+{
+  // set twi slave address (skip over TWGCE bit)
+  TWAR = address << 1;
+}
+
+/* 
+ * Function twi_readFrom
+ * Desc     attempts to become twi bus master and read a
+ *          series of bytes from a device on the bus
+ * Input    address: 7bit i2c device address
+ *          data: pointer to byte array
+ *          length: number of bytes to read into array
+ * Output   number of bytes read
+ */
+uint8_t twi_readFrom(uint8_t address, uint8_t* data, uint8_t length)
+{
+  uint8_t i;
+
+  // ensure data will fit into buffer
+  if(TWI_BUFFER_LENGTH < length){
+    return 0;
+  }
+
+  // wait until twi is ready, become master receiver
+  while(TWI_READY != twi_state){
+    continue;
+  }
+  twi_state = TWI_MRX;
+  // reset error state (0xFF.. no error occured)
+  twi_error = 0xFF;
+
+  // initialize buffer iteration vars
+  twi_masterBufferIndex = 0;
+  twi_masterBufferLength = length-1;  // This is not intuitive, read on...
+  // On receive, the previously configured ACK/NACK setting is transmitted in
+  // response to the received byte before the interrupt is signalled. 
+  // Therefor we must actually set NACK when the _next_ to last byte is
+  // received, causing that NACK to be sent in response to receiving the last
+  // expected byte of data.
+
+  // build sla+w, slave device address + w bit
+  twi_slarw = TW_READ;
+  twi_slarw |= address << 1;
+
+  // send start condition
+  TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWEA) | _BV(TWINT) | _BV(TWSTA);
+
+  // wait for read operation to complete
+  while(TWI_MRX == twi_state){
+    continue;
+  }
+
+  if (twi_masterBufferIndex < length)
+    length = twi_masterBufferIndex;
+
+  // copy twi buffer to data
+  for(i = 0; i < length; ++i){
+    data[i] = twi_masterBuffer[i];
+  }
+	
+  return length;
+}
+
+/* 
+ * Function twi_writeTo
+ * Desc     attempts to become twi bus master and write a
+ *          series of bytes to a device on the bus
+ * Input    address: 7bit i2c device address
+ *          data: pointer to byte array
+ *          length: number of bytes in array
+ *          wait: boolean indicating to wait for write or not
+ * Output   0 .. success
+ *          1 .. length to long for buffer
+ *          2 .. address send, NACK received
+ *          3 .. data send, NACK received
+ *          4 .. other twi error (lost bus arbitration, bus error, ..)
+ */
+uint8_t twi_writeTo(uint8_t address, uint8_t* data, uint8_t length, uint8_t wait)
+{
+  uint8_t i;
+
+  // ensure data will fit into buffer
+  if(TWI_BUFFER_LENGTH < length){
+    return 1;
+  }
+
+  // wait until twi is ready, become master transmitter
+  while(TWI_READY != twi_state){
+    continue;
+  }
+  twi_state = TWI_MTX;
+  // reset error state (0xFF.. no error occured)
+  twi_error = 0xFF;
+
+  // initialize buffer iteration vars
+  twi_masterBufferIndex = 0;
+  twi_masterBufferLength = length;
+  
+  // copy data to twi buffer
+  for(i = 0; i < length; ++i){
+    twi_masterBuffer[i] = data[i];
+  }
+  
+  // build sla+w, slave device address + w bit
+  twi_slarw = TW_WRITE;
+  twi_slarw |= address << 1;
+  
+  // send start condition
+  TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWEA) | _BV(TWINT) | _BV(TWSTA);
+
+  // wait for write operation to complete
+  while(wait && (TWI_MTX == twi_state)){
+    continue;
+  }
+  
+  if (twi_error == 0xFF)
+    return 0;	// success
+  else if (twi_error == TW_MT_SLA_NACK)
+    return 2;	// error: address send, nack received
+  else if (twi_error == TW_MT_DATA_NACK)
+    return 3;	// error: data send, nack received
+  else
+    return 4;	// other twi error
+}
+
+/* 
+ * Function twi_transmit
+ * Desc     fills slave tx buffer with data
+ *          must be called in slave tx event callback
+ * Input    data: pointer to byte array
+ *          length: number of bytes in array
+ * Output   1 length too long for buffer
+ *          2 not slave transmitter
+ *          0 ok
+ */
+uint8_t twi_transmit(const uint8_t* data, uint8_t length)
+{
+  uint8_t i;
+
+  // ensure data will fit into buffer
+  if(TWI_BUFFER_LENGTH < length){
+    return 1;
+  }
+  
+  // ensure we are currently a slave transmitter
+  if(TWI_STX != twi_state){
+    return 2;
+  }
+  
+  // set length and copy data into tx buffer
+  twi_txBufferLength = length;
+  for(i = 0; i < length; ++i){
+    twi_txBuffer[i] = data[i];
+  }
+  
+  return 0;
+}
+
+/* 
+ * Function twi_attachSlaveRxEvent
+ * Desc     sets function called before a slave read operation
+ * Input    function: callback function to use
+ * Output   none
+ */
+void twi_attachSlaveRxEvent( void (*function)(uint8_t*, int) )
+{
+  twi_onSlaveReceive = function;
+}
+
+/* 
+ * Function twi_attachSlaveTxEvent
+ * Desc     sets function called before a slave write operation
+ * Input    function: callback function to use
+ * Output   none
+ */
+void twi_attachSlaveTxEvent( void (*function)(void) )
+{
+  twi_onSlaveTransmit = function;
+}
+
+/* 
+ * Function twi_reply
+ * Desc     sends byte or readys receive line
+ * Input    ack: byte indicating to ack or to nack
+ * Output   none
+ */
+void twi_reply(uint8_t ack)
+{
+  // transmit master read ready signal, with or without ack
+  if(ack){
+    TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWINT) | _BV(TWEA);
+  }else{
+	  TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWINT);
+  }
+}
+
+/* 
+ * Function twi_stop
+ * Desc     relinquishes bus master status
+ * Input    none
+ * Output   none
+ */
+void twi_stop(void)
+{
+  // send stop condition
+  TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWEA) | _BV(TWINT) | _BV(TWSTO);
+
+  // wait for stop condition to be exectued on bus
+  // TWINT is not set after a stop condition!
+  while(TWCR & _BV(TWSTO)){
+    continue;
+  }
+
+  // update twi state
+  twi_state = TWI_READY;
+}
+
+/* 
+ * Function twi_releaseBus
+ * Desc     releases bus control
+ * Input    none
+ * Output   none
+ */
+void twi_releaseBus(void)
+{
+  // release bus
+  TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWEA) | _BV(TWINT);
+
+  // update twi state
+  twi_state = TWI_READY;
+}
+
+SIGNAL(TWI_vect)
+{
+  switch(TW_STATUS){
+    // All Master
+    case TW_START:     // sent start condition
+    case TW_REP_START: // sent repeated start condition
+      // copy device address and r/w bit to output register and ack
+      TWDR = twi_slarw;
+      twi_reply(1);
+      break;
+
+    // Master Transmitter
+    case TW_MT_SLA_ACK:  // slave receiver acked address
+    case TW_MT_DATA_ACK: // slave receiver acked data
+      // if there is data to send, send it, otherwise stop 
+      if(twi_masterBufferIndex < twi_masterBufferLength){
+        // copy data to output register and ack
+        TWDR = twi_masterBuffer[twi_masterBufferIndex++];
+        twi_reply(1);
+      }else{
+        twi_stop();
+      }
+      break;
+    case TW_MT_SLA_NACK:  // address sent, nack received
+      twi_error = TW_MT_SLA_NACK;
+      twi_stop();
+      break;
+    case TW_MT_DATA_NACK: // data sent, nack received
+      twi_error = TW_MT_DATA_NACK;
+      twi_stop();
+      break;
+    case TW_MT_ARB_LOST: // lost bus arbitration
+      twi_error = TW_MT_ARB_LOST;
+      twi_releaseBus();
+      break;
+
+    // Master Receiver
+    case TW_MR_DATA_ACK: // data received, ack sent
+      // put byte into buffer
+      twi_masterBuffer[twi_masterBufferIndex++] = TWDR;
+    case TW_MR_SLA_ACK:  // address sent, ack received
+      // ack if more bytes are expected, otherwise nack
+      if(twi_masterBufferIndex < twi_masterBufferLength){
+        twi_reply(1);
+      }else{
+        twi_reply(0);
+      }
+      break;
+    case TW_MR_DATA_NACK: // data received, nack sent
+      // put final byte into buffer
+      twi_masterBuffer[twi_masterBufferIndex++] = TWDR;
+    case TW_MR_SLA_NACK: // address sent, nack received
+      twi_stop();
+      break;
+    // TW_MR_ARB_LOST handled by TW_MT_ARB_LOST case
+
+    // Slave Receiver
+    case TW_SR_SLA_ACK:   // addressed, returned ack
+    case TW_SR_GCALL_ACK: // addressed generally, returned ack
+    case TW_SR_ARB_LOST_SLA_ACK:   // lost arbitration, returned ack
+    case TW_SR_ARB_LOST_GCALL_ACK: // lost arbitration, returned ack
+      // enter slave receiver mode
+      twi_state = TWI_SRX;
+      // indicate that rx buffer can be overwritten and ack
+      twi_rxBufferIndex = 0;
+      twi_reply(1);
+      break;
+    case TW_SR_DATA_ACK:       // data received, returned ack
+    case TW_SR_GCALL_DATA_ACK: // data received generally, returned ack
+      // if there is still room in the rx buffer
+      if(twi_rxBufferIndex < TWI_BUFFER_LENGTH){
+        // put byte in buffer and ack
+        twi_rxBuffer[twi_rxBufferIndex++] = TWDR;
+        twi_reply(1);
+      }else{
+        // otherwise nack
+        twi_reply(0);
+      }
+      break;
+    case TW_SR_STOP: // stop or repeated start condition received
+      // put a null char after data if there's room
+      if(twi_rxBufferIndex < TWI_BUFFER_LENGTH){
+        twi_rxBuffer[twi_rxBufferIndex] = '\0';
+      }
+      // sends ack and stops interface for clock stretching
+      twi_stop();
+      // callback to user defined callback
+      twi_onSlaveReceive(twi_rxBuffer, twi_rxBufferIndex);
+      // since we submit rx buffer to "wire" library, we can reset it
+      twi_rxBufferIndex = 0;
+      // ack future responses and leave slave receiver state
+      twi_releaseBus();
+      break;
+    case TW_SR_DATA_NACK:       // data received, returned nack
+    case TW_SR_GCALL_DATA_NACK: // data received generally, returned nack
+      // nack back at master
+      twi_reply(0);
+      break;
+    
+    // Slave Transmitter
+    case TW_ST_SLA_ACK:          // addressed, returned ack
+    case TW_ST_ARB_LOST_SLA_ACK: // arbitration lost, returned ack
+      // enter slave transmitter mode
+      twi_state = TWI_STX;
+      // ready the tx buffer index for iteration
+      twi_txBufferIndex = 0;
+      // set tx buffer length to be zero, to verify if user changes it
+      twi_txBufferLength = 0;
+      // request for txBuffer to be filled and length to be set
+      // note: user must call twi_transmit(bytes, length) to do this
+      twi_onSlaveTransmit();
+      // if they didn't change buffer & length, initialize it
+      if(0 == twi_txBufferLength){
+        twi_txBufferLength = 1;
+        twi_txBuffer[0] = 0x00;
+      }
+      // transmit first byte from buffer, fall
+    case TW_ST_DATA_ACK: // byte sent, ack returned
+      // copy data to output register
+      TWDR = twi_txBuffer[twi_txBufferIndex++];
+      // if there is more to send, ack, otherwise nack
+      if(twi_txBufferIndex < twi_txBufferLength){
+        twi_reply(1);
+      }else{
+        twi_reply(0);
+      }
+      break;
+    case TW_ST_DATA_NACK: // received nack, we are done 
+    case TW_ST_LAST_DATA: // received ack, but we are done already!
+      // ack future responses
+      twi_reply(1);
+      // leave slave receiver state
+      twi_state = TWI_READY;
+      break;
+
+    // All
+    case TW_NO_INFO:   // no state information
+      break;
+    case TW_BUS_ERROR: // bus error, illegal stop/start
+      twi_error = TW_BUS_ERROR;
+      twi_stop();
+      break;
+  }
+}
+
diff --git a/libraries/Wire/utility/twi.h b/libraries/Wire/utility/twi.h
new file mode 100755
index 0000000..831b928
--- /dev/null
+++ b/libraries/Wire/utility/twi.h
@@ -0,0 +1,53 @@
+/*
+  twi.h - TWI/I2C library for Wiring & Arduino
+  Copyright (c) 2006 Nicholas Zambetti.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#ifndef twi_h
+#define twi_h
+
+  #include <inttypes.h>
+
+  //#define ATMEGA8
+
+  #ifndef TWI_FREQ
+  #define TWI_FREQ 100000L
+  #endif
+
+  #ifndef TWI_BUFFER_LENGTH
+  #define TWI_BUFFER_LENGTH 32
+  #endif
+
+  #define TWI_READY 0
+  #define TWI_MRX   1
+  #define TWI_MTX   2
+  #define TWI_SRX   3
+  #define TWI_STX   4
+  
+  void twi_init(void);
+  void twi_setAddress(uint8_t);
+  uint8_t twi_readFrom(uint8_t, uint8_t*, uint8_t);
+  uint8_t twi_writeTo(uint8_t, uint8_t*, uint8_t, uint8_t);
+  uint8_t twi_transmit(const uint8_t*, uint8_t);
+  void twi_attachSlaveRxEvent( void (*)(uint8_t*, int) );
+  void twi_attachSlaveTxEvent( void (*)(void) );
+  void twi_reply(uint8_t);
+  void twi_stop(void);
+  void twi_releaseBus(void);
+
+#endif
+