Arduino User Manual

ThinkLab

Contents
1 2 3 4 Introduction Getting Started (Windows) Arduino Development Environment Hardware 2 4 9 15

Chapter 1

Introduction
Arduino is a tool for making computers that can sense and control more of the physical world than your desktop computer. Its an open-source physical computing platform based on a simple microcontroller board, and a development environment for writing software for the board. Arduino can be used to develop interactive objects, taking inputs from a variety of switches or sensors, and controlling a variety of lights, motors, and other physical outputs. Arduino projects can be stand-alone, or they can be communicate with software running on your computer (e.g. Flash, Processing, MaxMSP.) The boards can be assembled by hand or purchased preassembled; the open-source IDE can be downloaded for free. The Arduino programming language is an implementation of Wiring, a similar physical computing platform, which is based on the Processing multimedia programming environment.

Figure 1.1: An Arduino Board There are many other microcontrollers and microcontroller platforms available for physical computing. Parallax Basic Stamp, Netmedias BX-24, Phidgets, MITs Handyboard, and many others offer similar functionality. All of these tools take the messy details of microcontroller programming and wrap it up in an easy-to-use package. Arduino also simplies the process of working with microcontrollers, but it offers some advantage for teachers, students, and interested amateurs over other systems: Inexpensive - Arduino boards are relatively inexpensive compared to other microcontroller platforms. Cross-platform - The Arduino software runs on Windows, Macintosh OSX, and Linux operating systems. Most microcontroller systems are limited to Windows.

CHAPTER 1. INTRODUCTION

Simple, clear programming environment - The Arduino programming environment is easy-to-use for beginners, yet exible enough for advanced users to take advantage of as well. For teachers, its conveniently based on the Processing programming environment, so students learning to program in that environment will be familiar with the look and feel of Arduino Open source and extensible software- The Arduino software and is published as open source tools, available for extension by experienced programmers. The language can be expanded through C++ libraries, and people wanting to understand the technical details can make the leap from Arduino to the AVR C programming language on which its based. Similarly, you can add AVR-C code directly into your Arduino programs if you want to. Open source and extensible hardware - The Arduino is based on Atmels ATMEGA8 and ATMEGA168 microcontrollers. The plans for the modules are published under a Creative Commons license, so experienced circuit designers can make their own version of the module, extending it and improving it. Even relatively inexperienced users can build the breadboard version of the module in order to understand how it works and save money.

Chapter 2

Getting Started (Windows)

1. Get an Arduino board and USB cable. In this tutorial, we assume youre using a Gizduino by E-gizmo.

Figure 2.1: Gizduino You also need a standard USB cable (A plug to B plug): the kind you would connect to a USB printer, for example.

Figure 2.2: USB Cable 2. Download the Arduino environment. Get the latest version from: http://arduino.cc/en/Main/Software. When the download nishes, unzip the downloaded le. Make sure to preserve the folder structure. Double-click the folder to open it. There should be a few les and sub-folders inside. 4

CHAPTER 2. GETTING STARTED (WINDOWS)

Figure 2.3: Contents of Arduino Folder 3. Connect the board. Connect the Arduino board to your computer using the USB cable. The green power LED (labelled PWR) should go on. Youll need to make sure that the board is congured to draw power from the USB connection. The power source is selected with a jumper, a small piece of plastic that ts onto two of the three pins between the USB and power jacks. Check that its on the two pins closest to the USB port. 4. Install the drivers. When you connect the board, Windows should initiate the driver installation process (if you havent used the computer with an Arduino board before). On Windows Vista, the driver should be automatically downloaded and installed. (Really, it works!) On Windows XP, download Prolic serial drivers from: http://www.prolific.com.tw/eng/downloads. asp?ID=31. Double-click the executable to install the corresponding driver. You can check that the drivers have been installed by opening the Windows Device Mananger (in the Hardware tab of System control panel). Look for a "USB Serial Port" in the Ports section; thats the Arduino board.

Figure 2.4: Arduino Board on Device Manager 5. Launch the Arduino application. Double-click the Arduino application.

Figure 2.5: Arduino Icon

CHAPTER 2. GETTING STARTED (WINDOWS)

Figure 2.6: Arduino Software 6. Open the blink example Open the LED blink example sketch by: File > Examples > Digital > Blink.

Figure 2.7: Location of Blink Example You should see something like the next gure.

CHAPTER 2. GETTING STARTED (WINDOWS)

Figure 2.8: Blink Sketch on Arduino 7. Select your board Youll need to select the entry in the Tools > Board menu that corresponds to your Arduino. Select Arduino Diecimila, Duemilanove, or Nano w/ ATmega168.

Figure 2.9: Selecting Correct Arduino Board 8. Select your serial port Select the serial device of the Arduino board from the Tools | Serial Port menu. This is likely to be COM3 or higher (COM1 and COM2 are usually reserved for hardware serial ports). To nd out, you can disconnect your Arduino board and re-open the menu; the entry that disappears should be the Arduino board. Reconnect the board and select that serial port.

Figure 2.10: Selecting Correct Serial Port

CHAPTER 2. GETTING STARTED (WINDOWS) 9. Upload the program Now, simply click the "Upload" button in the environment.

Figure 2.11: Upload Button If the upload is successful, the message "Done uploading." will appear in the status bar.

Figure 2.12: Done Uploading Status Message You should see an LED blinking every 1 second.

Chapter 3

Arduino Development Environment

3.1 IDE

The Arduino development environment contains a text editor for writing code, a message area, a text console, a toolbar with buttons for common functions, and a series of menus. It connects to the Arduino hardware to upload programs and communicate with them.

Figure 3.1: Arduino IDE Software written using Arduino are called sketches. These sketches are written in the text editor. It has features for cutting/pasting and for searching/replacing text. The message area gives feedback while saving and exporting and also displays errors. The console displays text output by the Arduino environment including complete error messages and other information. The toolbar buttons allow you to verify and upload programs, create, open, and save sketches, and open the serial monitor:

CHAPTER 3. ARDUINO DEVELOPMENT ENVIRONMENT

10

Figure 3.2: Arduino Shortcut Icons Additional commands are found within the ve menus: File, Edit, Sketch, Tools, Help. The menus are context sensitive which means only those items relevant to the work currently being carried out are available.

Edit
Copy for Discourse Copies the code of your sketch to the clipboard in a forum suitable for posting to the forum, complete with syntax coloring. Copy as HTML Copies the code of your sketch to the clipboard as HTML, suitable for embedding in web pages.

Sketch
Verify/Compile Checks your sketch for errors. Import Library Adds a library to your sketch by inserting #include statements at the code of your code. For more details, see libraries below. Show Sketch Folder Opens the sketch folder on the desktop. Add File... Adds a source le to the sketch (it will be copied from its current location). The new le appears in a new tab in the sketch window. Files can be removed from the sketch using the tab menu.

Tools
Auto Format This formats your code nicely: i.e. indents it so that opening and closing curly braces line up, and that the statements instead curly braces are indented more. Board Select the board that youre using. See below for descriptions of the various boards. Serial Port This menu contains all the serial devices (real or virtual) on your machine. It should automatically refresh every time you open the top-level tools menu. Burn Bootloader The items in this menu allow you to burn a bootloader onto the microcontroller on an Arduino board. This is not required for normal use of an Arduino board but is useful if you purchase a new ATmega (which normally come without a bootloader). Ensure that youve selected the correct board from the Boards menu before burning the bootloader. When using an AVR ISP, youll need to select the item corresponding to your programmer from the Serial Port menu.

CHAPTER 3. ARDUINO DEVELOPMENT ENVIRONMENT

11

3.2

Sketchbook

The Arduino environment includes the concept of a sketchbook: a standard place to store your programs (or sketches). The sketches in your sketchbook can be opened from the File > Sketchbook menu or from the Open button on the toolbar.

Figure 3.3: Opening Sketches The rst time you run the Arduino software, it will automatically create a directory for your sketchbook. You can view or change the location of the sketchbook location from with the Preferences dialog.

Figure 3.4: Changing File Location of Sketchbook

3.3

Tabs, Multiple Files, and Compilation

Allows you to manage sketches with more than one le (each of which appears in its own tab). These can be normal Arduino code les (no extension), C les (.c extension), C++ les (.cpp), or header les (.h).

Figure 3.5: Use of Tabs in IDE

CHAPTER 3. ARDUINO DEVELOPMENT ENVIRONMENT

12

3.4

Uploading

Before uploading your sketch, you need to select the correct items from the Tools > Board and Tools > Serial Port menus.

Figure 3.6: Board and Serial Port Menus On the Mac, the serial port is probably something like /dev/tty.usbserial-1B1 (for a USB board), or /dev/tty.USA19QW1b1P1.1 (for a serial board connected with a Keyspan USB-to-Serial adapter). On Windows, its probably COM1 or COM2 (for a serial board) or COM4, COM5, COM7, or higher (for a USB board) - to nd out, you look for USB serial device in the ports section of the Windows Device Manager. On Linux, it should be /dev/ttyUSB0, /dev/ttyUSB1 or similar. Once youve selected the correct serial port and board, press the upload button in the toolbar or select the Upload to I/O Board item from the File menu. Arduino will reset automatically and begin the upload. The Arduino environment will display a message when the upload is complete, or show an error.

Figure 3.7: Upload Button When you upload a sketch, youre using the Arduino bootloader, a small program that has been loaded on to the microcontroller on your board. It allows you to upload code without using any additional hardware. The bootloader is active for a few seconds when the board resets; then it starts whichever sketch was most recently uploaded to the microcontroller. The bootloader will blink the on-board (pin 13) LED when it starts (i.e. when the board resets).

3.5

Libraries

Libraries provide extra functionality for use in sketches, e.g. working with hardware or manipulating data. To use a library in a sketch, select it from the Sketch > Import Library menu. This will insert one or more #include statements at the top of the sketch and compile the library with your sketch. Because libraries are uploaded to the board with your sketch, they increase the amount of space it takes up. If a sketch no longer needs a library, simply delete its #include statements from the top of your code.

CHAPTER 3. ARDUINO DEVELOPMENT ENVIRONMENT

13

Figure 3.8: Importing Libraries There is a list of libraries in the reference of the Arduino website: http://arduino.cc/en/Reference/ HomePage. Some libraries are included with the Arduino software. Others can be downloaded from a variety of sources. To install these third-party libraries, create a directory called libraries within your sketchbook directory. Then unzip the library there. For example, to install the DateTime library, its les should be in the /libraries/DateTime sub-folder of your sketchbook folder.

3.6

Third-Party Hardware

Support for third-party hardware can be added to the hardware directory of your sketchbook directory. Platforms installed there may include board denitions (which appear in the board menu), core libraries, bootloaders, and programmer denitions. To install, create the hardware directory, then unzip the third-party platform into its own sub-directory. (Dont use "arduino" as the sub-directory name or youll override the built-in Arduino platform.) To uninstall, simply delete its directory.

3.7

Serial Monitor

Displays serial data being sent from the Arduino board (USB or serial board). To send data to the board, enter text and click on the "send" button or press enter. Choose the baud rate from the drop-down that matches the rate passed to Serial.begin in your sketch. Note that on Mac or Linux, the Arduino board will reset (rerun your sketch from the beginning) when you connect with the serial monitor.

CHAPTER 3. ARDUINO DEVELOPMENT ENVIRONMENT

14

Figure 3.9: Serial Monitor Menu

Figure 3.10: Serial Port Monitor

3.8

Preferences

Some preferences can be set in the preferences dialog (found under the Arduino menu on the Mac, or File on Windows and Linux). The rest can be found in the preferences le, whose location is shown in the preference dialog.

Figure 3.11: Preferences Dialog

Chapter 4

Hardware
4.1 Overview

Eduino is based on Arduino Diecimila, a microcontroller board based on the ATmega168. It has 14 digital input/output pins (of which 6 can be used as PWM outputs), 6 analog inputs, a 16 MHz crystal oscillator, a USB connection, a power jack, an ICSP header, and a reset button. It contains everything needed to support the microcontroller; simply connect it to a computer with a USB cable or power it with a AC-to-DC adapter or battery to get started. "Diecimila" means 10,000 in Italian and was named thusly to mark the fact that over 10,000 Arduino boards have been made.

Figure 4.1: Arduino Diecimila

4.2

Specications

Microcontroller ATmega168 Operating Voltage 5V Input Voltage (recommended) 7-12 V Input Voltage (limits) 6-20 V Digital I/O Pins 14 (of which 6 provide PWM output) Analog Input Pins 6 DC Current per I/O Pin 40 mA

15

CHAPTER 4. HARDWARE DC Current for 3.3V Pin 50 mA Flash Memory 16 KB (of which 2 KB used by bootloader) SRAM 1 KB EEPROM 512 bytes Clock Speed 16 MHz

16