EtherTen Quickstart Guide

1. Download the latest Arduino IDE (version 0022 or higher) for your operating system from www.arduino.cc/en/Main/Software and install it to suit. You'll also find more step-by-step guides for installation here: www.arduino.cc/en/Guide/HomePage

Windows users please note: The USB driver for the EtherTen must be downloaded and used for first-time installation of the EtherTen's USB port: www.freetronics.com/usbdriver

2. Once the Arduino IDE is installed, we're ready to do the initial board and port setup. You won't need to do this again unless the serial port number changes such as when using a different USB port on your computer.

3. In the Arduino IDE, select Tools > Board > Arduino Uno.

4. Before connecting your EtherTen to the USB port, have a look at the list of ports in Tools > Serial Port. That's where your EtherTen serial port is going to appear when you plug it in.

5. Connect your EtherTen to the computer USB port. We supply an appropriate USB cable with the EtherTen. After a short while if you look at Tools > Serial Port again you'll see a new port appear: that's the EtherTen ready to be used. Select that port now with Tools > Serial Port so there is a tick mark next to it

6. You're ready to go. The Arduino IDE now knows about your board and has a connection to it. Our EtherTen boards ship with the "Blink" sketch preloaded so you should immediately see the blue power LED illuminate, and the red D13 LED will begin flashing on and off at 1 second intervals.

Compiling and uploading a sketch to the EtherTen

"Sketch" is the Arduino term for a program. To test uploading a simple sketch to your EtherTen:

1. Choose File > Examples > Digital > Blink. You'll see the code for Blink open in the IDE.

2. Select Sketch > Verify/Compile, you've now built (compiled) the program ready to be loaded.

3. Lastly, to load the program into the EtherTen, select File > Upload to I/O Board. You'll see the red D13 LED flicker as the board is reset, then the green and yellow RX and TX LEDs will flash while the upload is in being done.

4. A few seconds later the RX and TX LEDs will go off, the board will reset, and the red D13 LED will begin flashing on and off at 1 second intervals. Congratulations! You've now compiled and uploaded your first sketch to the EtherTen. Try experimenting with changing the delay values in the sketch and repeating the process to see the LED blink at different rates.

Using the LAN port

The network functionality of the EtherTen uses the Wiznet W5100 chip, which is the same chip used on the official Arduino Ethernet Shield. We also kept all the pin assignments the same, so functionally the EtherTen is identical to having, say, an Arduino Uno with an official Ethernet Shield plugged into it.

This means any relevant tutorials or examples you find will work just fine on the EtherTen, and also that it's fully supported by the official "Ethernet" library and associated examples included with the Arduino IDE. If you select File > Examples > Ethernet you will see a variety of sketches that you can try with your EtherTen.

Note that just like the official Ethernet Shield, the EtherTen does not come with a specifically assigned MAC address stored in hardware. The MAC address must be set from inside your sketch, just as you'll find near the start of each of the Ethernet examples. You can pick any valid MAC address you like as long as it's unique on your network.

There is one small addition you may need to make to EtherTen sketches with Ethernet support, so Ethernet works correctly after a power on. This is because of the onboard reset chip feature of the EtherTen. Read about it here.

Using the microSD card slot

The microSD card slot is supported by a variety of libraries that implement different versions of the FAT filesystem commonly used on microSD cards. The Arduino IDE comes bundled with the "SD" library pre-installed including some example sketches, so look in File > Examples > SD to see how to communicate with a microSD card.

The "select" line for the microSD slot on the EtherTen is D4, the same as used in the examples bundled with the IDE, so the examples should work exactly as-is.

Note that even though both the Ethernet chipset and the microSD card slot use pins D11, D12, and D13, you can still have both features operating at the same time because they can share those pins. You can therefore combine those features to do things like display a list of files on a microSD card in a web page.

EtherTen specifications