EtherPort

EtherPort is a transport layer that works in conjunction with Firmata.js to enable communcation with an Ethernet capable Arduino or similar device.

Setup

EtherPort can be used to communicate with an Arduino (or similar) board running either:

• StandardFirmataEthernet
• StandardFirmataEthernetPlus
• ConfigurableFirmata

The latest version Arduino IDE ships with StandardFirmataEthernet and StandardFirmataEthernetPlus.

1. If using an Ethernet shield, plug the shield into the board.
2. Connect the board to the computer via USB cable.
3. Connect the board to the computer via Ethernet cable.
4. Open Arduino IDE, then: File -> Examples -> Ethernet -> DhcpAddressPrinter and then press the upload button.
5. Open the serial terminal and copy the printed IP address.
6. Obtain your ethernet port IP address (many ways to do this)
7. In the Arduino IDE, open File -> Examples -> Firmata -> StandardFirmataEthernet (or StandardFirmataEthernetPlus)
8. Update these lines with your computer and board IP addresses:

• This is the computer's address

#define remote_ip IPAddress(10, 0, 0, 3)

• This is the Arduino's address:

#define local_ip IPAddress(10, 0, 0, 3)

Everything on the board side should be ready now, all you need to do is install the latest Johnny-Five and EtherPort:

npm install johnny-five etherport

To test:

var five = require("johnny-five");
var EtherPort = require("etherport");
var board = new five.Board({ 
  port: new EtherPort(3030) 
});

board.on("ready", function() {
  var led = new five.Led(9);
  led.blink(500);
});

Compatible Shields & Boards

The following shields are those that have been tested and confirmed to work correctly with Etherport + Firmata.js + Johnny-Five.

Arduino Ethernet Shield

• Arduino Ethernet Shield
• Arduino Ethernet Shield R3

Generic Arduino Compatible Ethernet Shield

• Ethernet Shield W5100

DFRobot X-Board V2

• XBoard V2 -A bridge between home and internet (Arduino Compatible)

License

See LICENSE-MIT file.