Guide.Environment History

Hide minor edits - Show changes to output

August 19, 2013, at 12:54 PM by Roberto Guido - corrected minor typo. Thanks to Mark du Preez for feedback
Changed lines 82-83 from:
* ''Import Library'' [[<<]] Adds a library to your sketch by inserting #include statements at the code of your code. For more details, see [[#libraries | libraries]] below. Additionally, with version 1.0.5 and later of the IDE, you can import a library from a .zip file.
to:
* ''Import Library'' [[<<]] Adds a library to your sketch by inserting #include statements at the start of your code. For more details, see [[#libraries | libraries]] below. Additionally, with version 1.0.5 and later of the IDE, you can import a library from a .zip file.
May 08, 2013, at 01:33 PM by Scott Fitzgerald -
Changed lines 123-124 from:
There is a [[Reference/libraries | list of libraries]] in the reference. Some libraries are included with the Arduino software. Others can be downloaded from a variety of sources. Starting with version 1.0.5 of the DE, you do can import a library from a zip file and use it in an open sketch. See these [[Guide/Libraries | instructions for installing a third-party library]].
to:
There is a [[Reference/libraries | list of libraries]] in the reference. Some libraries are included with the Arduino software. Others can be downloaded from a variety of sources. Starting with version 1.0.5 of the IDE, you do can import a library from a zip file and use it in an open sketch. See these [[Guide/Libraries | instructions for installing a third-party library]].
May 08, 2013, at 12:53 PM by Scott Fitzgerald -
Changed lines 123-124 from:
There is a [[Reference/libraries | list of libraries]] in the reference. Some libraries are included with the Arduino software. Others can be downloaded from a variety of sources. See these [[Guide/Libraries | instructions for installing a third-party library]].
to:
There is a [[Reference/libraries | list of libraries]] in the reference. Some libraries are included with the Arduino software. Others can be downloaded from a variety of sources. Starting with version 1.0.5 of the DE, you do can import a library from a zip file and use it in an open sketch. See these [[Guide/Libraries | instructions for installing a third-party library]].
May 08, 2013, at 12:52 PM by Scott Fitzgerald -
Changed lines 82-83 from:
* ''Import Library'' [[<<]] Adds a library to your sketch by inserting #include statements at the code of your code. For more details, see [[#libraries | libraries]] below.
to:
* ''Import Library'' [[<<]] Adds a library to your sketch by inserting #include statements at the code of your code. For more details, see [[#libraries | libraries]] below. Additionally, with version 1.0.5 and later of the IDE, you can import a library from a .zip file.
October 09, 2012, at 04:15 PM by Scott Fitzgerald -
Changed lines 86-87 from:
* ''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.
to:
* ''Auto Format'' [[<<]] This formats your code nicely: i.e. indents it so that opening and closing curly braces line up, and that the statements inside curly braces are indented more.
September 24, 2012, at 03:37 PM by David A. Mellis -
Changed lines 123-124 from:
There is a [[Reference/libraries | list of libraries]] in the reference. 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 | sketchbook directory]]. Then unzip the library there. For example, to install the DateTime library, its files should be in the '''/libraries/DateTime''' sub-folder of your sketchbook folder.
to:
There is a [[Reference/libraries | list of libraries]] in the reference. Some libraries are included with the Arduino software. Others can be downloaded from a variety of sources. See these [[Guide/Libraries | instructions for installing a third-party library]].
June 02, 2012, at 10:07 PM by David A. Mellis -
Changed lines 163-168 from:
* ''Arduino Duemilanove or Nano w/ ATmega328'' [[<<]] An ATmega328 running at 16 MHz with auto-reset.

* ''Arduino Diecimila, Duemilanove, or Nano w/ ATmega168'' [[<<]] An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset).

* ''Arduino Mega 2560'' [[<<]] An ATmega2560 running at 16 MHz with auto-reset, using an stk500v2 bootloader.
to:
* ''Arduino Duemilanove w/ ATmega328'' [[<<]] An ATmega328 running at 16 MHz with auto-reset.

* ''Arduino Diecimila or Duemilanove w/ ATmega168'' [[<<]] An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset).

* ''Arduino Nano w/ ATmega328'' [[<<]] An ATmega328 running at 16 MHz with auto-reset. Has eight analog inputs.

* ''Arduino Nano w/ ATmega168'' [[<<]] An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset). Has eight analog inputs.

* ''Arduino Mega 2560 or Mega ADK'' [[<<]] An ATmega2560 running at 16 MHz with auto-reset, using an stk500v2 bootloader.
Changed lines 177-178 from:
* ''Arduino Mini'' [[<<]] Equivalent to Arduino NG or older w/ ATmega168 (i.e. an ATmega168 running at 16 MHz without auto-reset).
to:
* ''Arduino Mini w/ ATmega328''[[<<]] An ATmega328 running at 16 MHz with auto-reset, using the optiboot bootloader (115200 baud, 0.5 KB). Has eight analog inputs.

* ''Arduino Mini w/ ATmega168'' [[<<]] Equivalent to Arduino NG or older w/ ATmega168 (i.e. an ATmega168 running at 16 MHz without auto-reset).
Deleted lines 196-197:
* ''Arduino Diecimila, Duemilanove, or Nano w/ ATmega168'' [[<<]] An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset). Also used for the 16 MHz (5V) versions of the Arduino Pro and Pro Mini with an ATmega168.
May 23, 2012, at 03:06 PM by David A. Mellis -
Deleted lines 162-163:
* ''Arduino Leonardo'' [[<<]] An ATmega32u4 running at 16 MHz with auto-reset.
Added lines 171-172:
* ''Arduino Leonardo'' [[<<]] An ATmega32u4 running at 16 MHz with auto-reset.
May 23, 2012, at 03:02 PM by David A. Mellis -
Deleted lines 4-13:
!!!Language Support
Attach:languagePreferences.png \\

The Arduino 1.0.1 software environment has been translated into 30+ different languages. By default, the IDE loads in the language selected by your operating system. (Note: on Windows and possibly Linux, this is determined by the locale setting which controls currency and date formats, not by the language the operating system is displayed in.)

If you would like to change the language manually, start the Arduino software and open the '''Preferences''' window. Next to the '''Editor Language''' there is a dropdown menu of currently supported languages. Select your preferred language from the menu, and restart the software to use the selected language. If your preferred language is not supported, the IDE will default to English.

You can return Arduino to its default setting of selecting its language based on your operating system by selecting '''System Default''' from the '''Editor Language''' drop-down. This setting will take effect when you restart the Arduino software. Similarly, after changing your operating system's settings, you must restart the Arduino software to update it to the new default language.

Added lines 146-155:
[[#languages]]
!!!Language Support
Attach:languagePreferences.png \\

The Arduino 1.0.1 software environment has been translated into 30+ different languages. By default, the IDE loads in the language selected by your operating system. (Note: on Windows and possibly Linux, this is determined by the locale setting which controls currency and date formats, not by the language the operating system is displayed in.)

If you would like to change the language manually, start the Arduino software and open the '''Preferences''' window. Next to the '''Editor Language''' there is a dropdown menu of currently supported languages. Select your preferred language from the menu, and restart the software to use the selected language. If your preferred language is not supported, the IDE will default to English.

You can return Arduino to its default setting of selecting its language based on your operating system by selecting '''System Default''' from the '''Editor Language''' drop-down. This setting will take effect when you restart the Arduino software. Similarly, after changing your operating system's settings, you must restart the Arduino software to update it to the new default language.
May 23, 2012, at 03:01 PM by David A. Mellis -
Deleted line 5:
Arduino 1.0.1 has been fully translated in 20 different languages. By default, the IDE loads in the system's preferred language. If you would like to change the language manually, start the Arduino software and open the '''Preferences''' window. Next to the '''Editor Language''' there is a dropdown menu of currently supported languages. Select your preferred language from the menu, and restart the software to use the selected language.\\
Changed lines 8-10 from:
If your preferred language is not supported, the IDE will default to English. In Windows XP and OSX, if you change the system to a supported language are using the default option, Arduino will change its language next time it is launched.

to:
The Arduino 1.0.1 software environment has been translated into 30+ different languages. By default, the IDE loads in the language selected by your operating system. (Note: on Windows and possibly Linux, this is determined by the locale setting which controls currency and date formats, not by the language the operating system is displayed in.)

If you would like to change the language manually, start the Arduino software and open the '''Preferences''' window. Next to the '''Editor Language''' there is a dropdown menu of currently supported languages. Select your preferred language from the menu, and restart the software to use the selected language. If your preferred language is not supported, the IDE will default to English.

You can return Arduino to its default setting of selecting its language based on your operating system by selecting '''System Default''' from the '''Editor Language''' drop-down. This setting will take effect when you restart the Arduino software. Similarly, after changing your operating system's settings, you must restart the Arduino software to update it to the new default language.

April 28, 2012, at 06:32 AM by Scott Fitzgerald -
Added lines 160-161:
* ''Arduino Leonardo'' [[<<]] An ATmega32u4 running at 16 MHz with auto-reset.
Changed line 198 from:
For instructions on installing support for other boards, see [[#thirdpartyhardware | third-party hardware]] above.
to:
For instructions on installing support for other boards, see [[#thirdpartyhardware | third-party hardware]] above.
April 10, 2012, at 11:06 PM by Scott Fitzgerald -
Changed lines 9-10 from:
If your preferred language is not supported, the IDE will default to English.
to:
If your preferred language is not supported, the IDE will default to English. In Windows XP and OSX, if you change the system to a supported language are using the default option, Arduino will change its language next time it is launched.

April 10, 2012, at 08:28 PM by Scott Fitzgerald -
Changed line 6 from:
Arduino 1.0.1 has been fully translated in 20 different languages. By default, the IDE loads in the system's preferred language. If you would like to change the language manually, start the Arduino software and open the '''Preferences''' window. Next to '''Editor Languages''' there is a dropdown menu of currently supported languages. Select your preferred language from the menu, and restart the software to use the selected language.\\
to:
Arduino 1.0.1 has been fully translated in 20 different languages. By default, the IDE loads in the system's preferred language. If you would like to change the language manually, start the Arduino software and open the '''Preferences''' window. Next to the '''Editor Language''' there is a dropdown menu of currently supported languages. Select your preferred language from the menu, and restart the software to use the selected language.\\
April 10, 2012, at 08:28 PM by Scott Fitzgerald -
Added lines 9-10:
If your preferred language is not supported, the IDE will default to English.
April 10, 2012, at 08:22 PM by Scott Fitzgerald -
Changed line 6 from:
Arduino 1.0.1 has been fully translated in 20 different languages. By default, the IDE loads in the system's preferred language. If you would like to change the language manually, start the Arduino software and open the '''Preferences''' window. A dropdown menu has a list of currently supported languages. Once you select your preferred language, you will need to restart the software.\\
to:
Arduino 1.0.1 has been fully translated in 20 different languages. By default, the IDE loads in the system's preferred language. If you would like to change the language manually, start the Arduino software and open the '''Preferences''' window. Next to '''Editor Languages''' there is a dropdown menu of currently supported languages. Select your preferred language from the menu, and restart the software to use the selected language.\\
April 10, 2012, at 08:18 PM by Scott Fitzgerald -
Changed lines 7-8 from:
attach:languagePreferences.png \\
to:
Attach:languagePreferences.png \\
April 10, 2012, at 08:18 PM by Scott Fitzgerald -
Changed line 5 from:
!!!Language Support\\
to:
!!!Language Support
Changed line 9 from:
!!!Writing Sketches\\
to:
!!!Writing Sketches
April 10, 2012, at 08:17 PM by Scott Fitzgerald -
Changed lines 5-6 from:
Software written using Arduino are called '''sketches'''. These sketches are written in the text editor. Sketches are saved with the file extension .ino. 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 bottom righthand corner of the window displays the current board and serial port. The toolbar buttons allow you to verify and upload programs, create, open, and save sketches, and open the serial monitor:
to:
!!!Language Support\\
Arduino 1.0.1 has been fully translated in 20 different languages. By default, the IDE loads in the system's preferred language. If you would like to change the language manually, start the Arduino software and open the '''Preferences''' window. A dropdown menu has a list of currently supported languages. Once you select your preferred language, you will need to restart the software.\\
attach:languagePreferences.png \\

!!!Writing Sketches\\
Software written using Arduino are called '''sketches'''. These sketches are written in the text editor. Sketches are saved with the file extension .ino. 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 bottom righthand corner of the window displays the current board and serial port. The toolbar buttons allow you to verify and upload programs, create, open, and save sketches, and open the serial monitor.
September 23, 2011, at 11:42 PM by Tom Igoe -
Changed lines 5-6 from:
Software written using Arduino are called sketches. These sketches are written in the text editor. Sketches are saved with the file extension .ino. 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 bottom righthand corner of the window displays the current board and serial port. The toolbar buttons allow you to verify and upload programs, create, open, and save sketches, and open the serial monitor:
to:
Software written using Arduino are called '''sketches'''. These sketches are written in the text editor. Sketches are saved with the file extension .ino. 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 bottom righthand corner of the window displays the current board and serial port. The toolbar buttons allow you to verify and upload programs, create, open, and save sketches, and open the serial monitor:
Changed lines 65-66 from:
Additional commands are found within the five 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.
to:
Additional commands are found within the five 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.
Changed lines 93-96 from:
* ''Programmer'' [[<<]] For selecting an AVR ISP when programming a board or chip and not using the onboard USB-serial connection.

* ''Burn Bootloader'' [[<<]] The items in this menu allow you to burn a [[Tutorial/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 you've selected the correct board from the '''Boards''' menu before burning the bootloader.
to:
* ''Programmer'' [[<<]] For selecting a harware programmer when programming a board or chip and not using the onboard USB-serial connection. Normally you won't need this, but if you're [[Tutorial/bootloader|burning a bootloader]] to a new microcontroller, you will use this.

* ''Burn Bootloader'' [[<<]] The items in this menu allow you to burn a [[Tutorial/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 microcontroller (which normally come without a bootloader). Ensure that you've selected the correct board from the '''Boards''' menu before burning the bootloader.
Changed lines 100-103 from:
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. The first 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.

Beginning with version 1.0, files are saved with a .ino file extension. Previous versions use the .pde extension. You may still open .pde named files in version 1.0 and later, the software will automatically rename the extension to .ino.
to:
The Arduino environment uses 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. The first 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.

'''Beginning with version 1.0, files are saved with a .ino file extension. Previous versions use the .pde extension. You may still open .pde named files in version 1.0 and later, the software will automatically rename the extension to .ino.
Changed lines 111-112 from:
Before uploading your sketch, you need to select the correct items from the '''Tools > Board''' and '''Tools > Serial Port''' menus. The [[#boards | boards]] are described below. 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, it's probably '''COM1''' or '''COM2''' (for a serial board) or '''COM4''', '''COM5''', '''COM7''', or higher (for a USB board) - to find 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.
to:
Before uploading your sketch, you need to select the correct items from the '''Tools > Board''' and '''Tools > Serial Port''' menus. The [[#boards | boards]] are described below. On the Mac, the serial port is probably something like '''/dev/tty.usbmodem241''' (for an Uno or Mega2560 or Leonardo) or '''/dev/tty.usbserial-1B1''' (for a Duemilanove or earlier USB board), or '''/dev/tty.USA19QW1b1P1.1''' (for a serial board connected with a Keyspan USB-to-Serial adapter). On Windows, it's probably '''COM1''' or '''COM2''' (for a serial board) or '''COM4''', '''COM5''', '''COM7''', or higher (for a USB board) - to find 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.
Changed lines 115-116 from:
When you upload a sketch, you're 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).
to:
When you upload a sketch, you're 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).
Changed lines 131-132 from:
For details on creating packages for third-party hardware, see the [[http://code.google.com/p/arduino/wiki/Platforms | platforms page]] on the Google Code developers site.
to:
For details on creating packages for third-party hardware, see the [[http://code.google.com/p/arduino/wiki/Platforms | platforms page]] on the Arduino Google Code developers site.
Changed lines 148-149 from:
The board selection has two effects: the parameters (e.g. CPU speed and baud rate) used when compiling and uploading sketches; and the file and fuse settings used by the burn bootloader command. Some of the board definitions differ only in the latter, so even if you've been uploading successfully with a particular selection you'll want to check it before burning the bootloader.
to:
The board selection has two effects: it sets the parameters (e.g. CPU speed and baud rate) used when compiling and uploading sketches; and sets and the file and fuse settings used by the burn bootloader command. Some of the board definitions differ only in the latter, so even if you've been uploading successfully with a particular selection you'll want to check it before burning the bootloader.
Deleted lines 188-191:



September 23, 2011, at 11:32 PM by Tom Igoe -
Changed lines 17-18 from:
''Verify' [[<<]] Checks your code for errors.
to:
''Verify'' [[<<]] Checks your code for errors.
September 14, 2011, at 03:50 PM by Scott Fitzgerald -
Added lines 7-8:
'''NB: Versions of the IDE prior to 1.0 saved sketches with the extension .pde. It is possible to open these files with version 1.0, you will be prompted to save the sketch with the .ino extension on save.'''
September 07, 2011, at 04:52 PM by Scott Fitzgerald - added info about current board/serial port in IDE
Changed lines 5-6 from:
Software written using Arduino are called sketches. These sketches are written in the text editor. Sketches are saved with the file extension .ino. 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:
to:
Software written using Arduino are called sketches. These sketches are written in the text editor. Sketches are saved with the file extension .ino. 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 bottom righthand corner of the window displays the current board and serial port. The toolbar buttons allow you to verify and upload programs, create, open, and save sketches, and open the serial monitor:
September 07, 2011, at 04:09 PM by Scott Fitzgerald -
Changed lines 11-12 from:
Attach:play.gif
to:
Attach:play.png
Changed lines 19-20 from:
Attach:export.gif
to:
Attach:export.png
Changed lines 29-30 from:
Attach:new.gif
to:
Attach:new.png
Changed lines 37-38 from:
Attach:open.gif
to:
Attach:open.png
Changed lines 47-48 from:
Attach:save.gif
to:
Attach:save.png
Changed lines 55-56 from:
Attach:serial_monitor.gif
to:
Attach:serial_monitor.png
September 07, 2011, at 03:08 AM by Scott Fitzgerald - updated icons
Changed lines 11-12 from:
Attach:play.png
to:
Attach:play.gif
Changed lines 19-20 from:
Attach:export.png
to:
Attach:export.gif
Changed lines 29-30 from:
Attach:new.png
to:
Attach:new.gif
Changed lines 37-38 from:
Attach:open.png
to:
Attach:open.gif
Changed lines 47-48 from:
Attach:save.png
to:
Attach:save.gif
Changed lines 55-56 from:
Attach:serial_monitor.png
to:
Attach:serial_monitor.gif
September 07, 2011, at 03:07 AM by Scott Fitzgerald - updated icons
Changed lines 11-12 from:
Attach:play.gif
to:
Attach:play.png
Changed lines 19-20 from:
Attach:export.gif
to:
Attach:export.png
Changed lines 29-30 from:
Attach:new.gif
to:
Attach:new.png
Changed lines 37-38 from:
Attach:open.gif
to:
Attach:open.png
Changed lines 47-48 from:
Attach:save.gif
to:
Attach:save.png
Changed lines 55-56 from:
Attach:serial_monitor.gif
to:
Attach:serial_monitor.png
September 07, 2011, at 03:01 AM by Scott Fitzgerald - added archive sketch and Programmer entries
Added lines 25-26:
Note: If you are using an external programmer, you can hold down the "shift" key on your computer when using this icon. The text will change to "Upload using Programmer"
Changed lines 85-86 from:
* ''Archive Sketch''
to:
* ''Archive Sketch'' [[<<]] Archives a copy of the current sketch in .zip format. The archive is placed in the same directory as the sketch.
Changed lines 91-94 from:
* ''Programmer''

* ''Burn Bootloader'' [[<<]] The items in this menu allow you to burn a [[Tutorial/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 you've selected the correct board from the '''Boards''' menu before burning the bootloader. When using an AVR ISP, you'll need to select the item corresponding to your programmer from the '''Serial Port''' menu.
to:
* ''Programmer'' [[<<]] For selecting an AVR ISP when programming a board or chip and not using the onboard USB-serial connection.

* ''Burn Bootloader'' [[<<]] The items in this menu allow you to burn a [[Tutorial/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 you've selected the correct board from the '''Boards''' menu before burning the bootloader.
September 07, 2011, at 02:55 AM by Scott Fitzgerald - changes for 1.0 (added ethernet board, file extension, other sundries)
Changed lines 5-6 from:
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:
to:
Software written using Arduino are called sketches. These sketches are written in the text editor. Sketches are saved with the file extension .ino. 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:
Changed lines 15-16 from:
''Verify/Compile'' [[<<]] Checks your code for errors.
to:
''Verify' [[<<]] Checks your code for errors.
Changed lines 19-20 from:
Attach:stop.gif
to:
Attach:export.gif
Changed lines 23-24 from:
''Stop'' [[<<]] Stops the serial monitor, or unhighlight other buttons.
to:
''Upload'' [[<<]] Compiles your code and uploads it to the Arduino I/O board. See [[#uploading | uploading]] below for details.
Changed lines 53-54 from:
Attach:export.gif
to:
Attach:serial_monitor.gif
Deleted lines 56-63:
''Upload to I/O Board'' [[<<]] Compiles your code and uploads it to the Arduino I/O board. See [[#uploading | uploading]] below for details.

(:cellnr:)

Attach:serial_monitor.gif

(:cell:)
Changed lines 65-66 from:
* ''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.
to:
* ''Copy for Forum'' [[<<]] Copies the code of your sketch to the clipboard in a form suitable for posting to the forum, complete with syntax coloring.
Added lines 73-76:
* ''Show Sketch Folder'' [[<<]] Opens the current sketch folder.

* ''Add File...'' [[<<]] Adds a source file to the sketch (it will be copied from its current location). The new file appears in a new tab in the sketch window. Files can be removed from the sketch using the tab menu.
Deleted lines 78-81:
* ''Show Sketch Folder'' [[<<]] Opens the sketch folder on the desktop.

* ''Add File...'' [[<<]] Adds a source file to the sketch (it will be copied from its current location). The new file appears in a new tab in the sketch window. Files can be removed from the sketch using the tab menu.
Added lines 83-84:
* ''Archive Sketch''
Added lines 89-90:
* ''Programmer''
Added lines 98-99:
Beginning with version 1.0, files are saved with a .ino file extension. Previous versions use the .pde extension. You may still open .pde named files in version 1.0 and later, the software will automatically rename the extension to .ino.
Changed lines 109-110 from:
Once you've 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. Current Arduino boards will reset automatically and begin the upload. With older boards that lack auto-reset, you'll need to press the reset button on the board just before starting the upload. On most boards, you'll see the RX and TX LEDs blink as the sketch is uploaded. The Arduino environment will display a message when the upload is complete, or show an error.
to:
Once you've selected the correct serial port and board, press the upload button in the toolbar or select the '''Upload''' item from the '''File''' menu. Current Arduino boards will reset automatically and begin the upload. With older boards (pre-Diecimila) that lack auto-reset, you'll need to press the reset button on the board just before starting the upload. On most boards, you'll see the RX and TX LEDs blink as the sketch is uploaded. The Arduino environment will display a message when the upload is complete, or show an error.
Added lines 158-159:
* ''Arduino Ethernet'' [[<<]] Equivalent to Arduino UNO with an Ethernet shield.
October 17, 2010, at 07:35 PM by David A. Mellis -
Changed lines 160-161 from:
* ''Arduino BT'' [[<<]] ATmega168 running at 16 MHz. The bootloader burned includes codes to initialize the on-board bluetooth module.
to:
* ''Arduino Fio'' [[<<]] An ATmega328 running at 8 MHz with auto-reset. Equivalent to Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328.

* ''Arduino BT w/ ATmega328'' [[<<]] ATmega328 running at 16 MHz. The bootloader burned (4 KB) includes codes to initialize the on-board bluetooth module.

* ''Arduino BT w/ ATmega168'' [[<<]] ATmega168 running at 16 MHz. The bootloader burned includes codes to initialize the on-board bluetooth module.
Changed lines 184-186 from:


to:
For instructions on installing support for other boards, see [[#thirdpartyhardware | third-party hardware]] above.



October 17, 2010, at 07:30 PM by David A. Mellis -
Changed lines 148-153 from:
* ''Arduino Duemilanove or Nano w/ ATmega328'' [[<<]] An ATmega328 running at 16 MHz with auto-reset. Also used for the 16 MHz (5V) versions of the Arduino Pro or Pro Mini with an ATmega328.

* ''Arduino Diecimila, Duemilanove, or Nano w/ ATmega168'' [[<<]] An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset). Also used for the 16 MHz (5V) versions of the Arduino Pro and Pro Mini with an ATmega168.

* ''Arduino Mega'' [[<<]] An ATmega1280 running at 16 MHz with auto-reset.
to:
* ''Arduino Uno'' [[<<]] An ATmega328 running at 16 MHz with auto-reset, using the optiboot bootloader (115200 baud, 0.5 KB).

* ''Arduino Duemilanove or Nano w/ ATmega328'' [[<<]] An ATmega328 running at 16 MHz with auto-reset.

* ''Arduino Diecimila, Duemilanove, or Nano w/ ATmega168'' [[<<]] An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset).

* ''Arduino Mega 2560'' [[<<]] An ATmega2560 running at 16 MHz with auto-reset, using an stk500v2 bootloader.

* ''Arduino Mega (ATmega1280)'' [[<<]] An ATmega1280 running at 16 MHz with auto-reset.
Added lines 166-171:
* ''Arduino Pro or Pro Mini (5V, 16 MHz) w/ ATmega328'' [[<<]] An ATmega328 running at 16 MHz with auto-reset. Equivalent to Arduino Duemilanove or Nano w/ ATmega328.

* ''Arduino Pro or Pro Mini (5V, 16 MHz) w/ ATmega168'' [[<<]] An ATmega168 running at 16 MHz with auto-reset. Equivalent to Arduino Diecimila, Duemilanove, or Nano w/ ATmega168.

* ''Arduino Diecimila, Duemilanove, or Nano w/ ATmega168'' [[<<]] An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset). Also used for the 16 MHz (5V) versions of the Arduino Pro and Pro Mini with an ATmega168.
April 01, 2010, at 10:55 PM by David A. Mellis -
Added lines 122-123:
To write your own library, see [[Hacking/LibraryTutorial | this tutorial]].
March 07, 2010, at 06:36 AM by David A. Mellis -
Changed lines 125-126 from:
Support for third-party hardware can be added to the '''hardware''' directory of your sketchbook directory. Platforms installed there may include board definitions (which appear in the board menu), core libraries, bootloaders, and programmer definitions. To install, create the '''hardware''' directory, then unzip the third-party platform into its own sub-directory. To uninstall, simply delete its directory.
to:
Support for third-party hardware can be added to the '''hardware''' directory of your sketchbook directory. Platforms installed there may include board definitions (which appear in the board menu), core libraries, bootloaders, and programmer definitions. To install, create the '''hardware''' directory, then unzip the third-party platform into its own sub-directory. (Don't use "arduino" as the sub-directory name or you'll override the built-in Arduino platform.) To uninstall, simply delete its directory.
February 02, 2010, at 02:48 PM by David A. Mellis -
Added lines 122-128:
[[#thirdpartyhardware]]
!!!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 definitions (which appear in the board menu), core libraries, bootloaders, and programmer definitions. To install, create the '''hardware''' directory, then unzip the third-party platform into its own sub-directory. To uninstall, simply delete its directory.

For details on creating packages for third-party hardware, see the [[http://code.google.com/p/arduino/wiki/Platforms | platforms page]] on the Google Code developers site.
December 23, 2009, at 07:03 PM by David A. Mellis -
Changed lines 57-58 from:
''Upload to I/O Board'' [[<<]] Compiles your code and uploads it to the Arduino I/O board. Uses the selected items in the '''Tools > Board''' and '''Tools > Serial Port''' menus.
to:
''Upload to I/O Board'' [[<<]] Compiles your code and uploads it to the Arduino I/O board. See [[#uploading | uploading]] below for details.
December 23, 2009, at 06:57 PM by David A. Mellis -
Changed lines 102-103 from:
!!!Tabs and Multiple Files
to:
!!!Tabs, Multiple Files, and Compilation
Deleted lines 105-111:
[[#libraries]]
!!!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.

There is a [[Reference/libraries | list of libraries]] in the reference. 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 | sketchbook directory]]. Then unzip the library there. For example, to install the DateTime library, its files should be in the '''/libraries/DateTime''' sub-folder of your sketchbook folder.
Changed lines 109-110 from:
Before uploading your sketch, you need to select the item from the '''Tools > Serial Port''' menu that represents your Arduino board. On the Mac, this 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, it's probably '''COM1''' or '''COM2''' (for a serial board) or '''COM4''', '''COM5''', '''COM7''', or higher (for a USB board) - to find 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.
to:
Before uploading your sketch, you need to select the correct items from the '''Tools > Board''' and '''Tools > Serial Port''' menus. The [[#boards | boards]] are described below. 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, it's probably '''COM1''' or '''COM2''' (for a serial board) or '''COM4''', '''COM5''', '''COM7''', or higher (for a USB board) - to find 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 you've 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. Current Arduino boards will reset automatically and begin the upload. With older boards that lack auto-reset, you'll need to press the reset button on the board just before starting the upload. On most boards, you'll see the RX and TX LEDs blink as the sketch is uploaded. The Arduino environment will display a message when the upload is complete, or show an error.

When you upload a sketch, you're 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).

[[#libraries]]
!!!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.

There is a [[Reference/libraries | list of libraries]] in the reference. 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 | sketchbook directory]]. Then unzip the library there. For example, to install the DateTime library, its files should be in the '''/libraries/DateTime''' sub-folder of your sketchbook folder.
December 23, 2009, at 06:47 PM by David A. Mellis -
Changed lines 91-94 from:
* ''Board'' [[<<]] Select the board that you're 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. [[<<]] [[<<]] Before uploading your sketch, you need to select the item from this menu that represents your Arduino board. On the Mac, this 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, it's probably '''COM1''' or '''COM2''' (for a serial board) or '''COM4''', '''COM5''', '''COM7''', or higher (for a USB board) - to find 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.
to:
* ''Board'' [[<<]] Select the board that you're using. See below for [[#boards | 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.
Added lines 116-117:
Before uploading your sketch, you need to select the item from the '''Tools > Serial Port''' menu that represents your Arduino board. On the Mac, this 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, it's probably '''COM1''' or '''COM2''' (for a serial board) or '''COM4''', '''COM5''', '''COM7''', or higher (for a USB board) - to find 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.
Added line 130:
[[#boards]]
December 23, 2009, at 06:45 PM by David A. Mellis -
Changed lines 1-2 from:
!!!Arduino Development Environment
to:
!!Arduino Development Environment
December 23, 2009, at 06:45 PM by David A. Mellis -
Deleted lines 0-1:
!!Environment
December 23, 2009, at 06:45 PM by David A. Mellis -
Changed lines 67-70 from:
''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.

You can also talk to the board from Processing, Flash, MaxMSP, etc (see the [[http://www.arduino.cc/playground/Main/Interfacing | interfacing page]] for details).
to:
''Serial Monitor'' [[<<]] Opens the [[#serialmonitor | serial monitor]].
Added lines 115-124:
[[#uploading]]
!!!Uploading

[[#serialmonitor]]
!!!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.

You can also talk to the board from Processing, Flash, MaxMSP, etc (see the [[http://www.arduino.cc/playground/Main/Interfacing | interfacing page]] for details).
December 23, 2009, at 06:43 PM by David A. Mellis -
Deleted lines 72-73:
[[<<]]
Changed lines 124-152 from:
''The board selection has two effects: the parameters (e.g. CPU speed and baud rate) used when compiling and uploading sketches; and the file and fuse settings used by the burn bootloader command. Some of the board definitions differ only in the latter, so even if you've been uploading successfully with a particular selection you'll want to check it before burning the bootloader.''

'''Arduino Duemilanove or Nano w/ ATmega328''' [[<<]] An ATmega328 running at 16 MHz with auto-reset. Also used for the 16 MHz (5V) versions of the Arduino Pro or Pro Mini with an ATmega328.

'''Arduino Diecimila, Duemilanove, or Nano w/ ATmega168''' [[<<]] An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset). Also used for the 16 MHz (5V) versions of the Arduino Pro and Pro Mini with an ATmega168.

'''Arduino Mega''' [[<<]] An ATmega1280 running at 16 MHz with auto-reset.

'''Arduino Mini''' [[<<]] Equivalent to Arduino NG or older w/ ATmega168 (i.e. an ATmega168 running at 16 MHz without auto-reset).

'''Arduino BT''' [[<<]] ATmega168 running at 16 MHz. The bootloader burned includes codes to initialize the on-board bluetooth module.

'''LilyPad Arduino w/ ATmega328''' [[<<]] An ATmega328 running at 8 MHz (3.3V) with auto-reset. Equivalent to Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328.

'''LilyPad Arduino w/ ATmega168''' [[<<]] An ATmega168 running at 8 MHz. Compilation and upload is equivalent to the Arduino Pro or Pro Mini (8 MHz) w/ ATmega168. The bootloader burned, however, has a slower timeout (and blinks the pin 13 LED three times on reset) because the original versions of the LilyPad didn't support auto-reset. They also didn't include an external clock, so the burn bootloader command configures the fuses of ATmega168 for an internal 8 MHz clock.

If you have a recent version of the LilyPad, (w/ a 6-pin programming header), you'll want to select Arduino Pro or Pro Mini (8 MHz) w/ ATmega168 before burning the bootloader.

'''Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328''' [[<<]] An ATmega328 running at 8 MHz (3.3V) with auto-reset. Equivalent to LilyPad Arduino w/ ATmega328.

'''Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega168''' [[<<]] An ATmega168 running at 8 MHz (3.3V) with auto-reset.

'''Arduino NG or older w/ ATmega168''' [[<<]] An ATmega168 running at 16 MHz ''without'' auto-reset. Compilation and upload is equivalent to Arduino Diecimila or Duemilanove w/ ATmega168, but the bootloader burned has a slower timeout (and blinks the pin 13 LED three times on reset).

'''Arduino NG or older w/ ATmega8''' [[<<]] An ATmega8 running at 16 MHz ''without'' auto-reset.



to:
The board selection has two effects: the parameters (e.g. CPU speed and baud rate) used when compiling and uploading sketches; and the file and fuse settings used by the burn bootloader command. Some of the board definitions differ only in the latter, so even if you've been uploading successfully with a particular selection you'll want to check it before burning the bootloader.

* ''Arduino Duemilanove or Nano w/ ATmega328'' [[<<]] An ATmega328 running at 16 MHz with auto-reset. Also used for the 16 MHz (5V) versions of the Arduino Pro or Pro Mini with an ATmega328.

* ''Arduino Diecimila, Duemilanove, or Nano w/ ATmega168'' [[<<]] An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset). Also used for the 16 MHz (5V) versions of the Arduino Pro and Pro Mini with an ATmega168.

* ''Arduino Mega'' [[<<]] An ATmega1280 running at 16 MHz with auto-reset.

* ''Arduino Mini'' [[<<]] Equivalent to Arduino NG or older w/ ATmega168 (i.e. an ATmega168 running at 16 MHz without auto-reset).

* ''Arduino BT'' [[<<]] ATmega168 running at 16 MHz. The bootloader burned includes codes to initialize the on-board bluetooth module.

* ''LilyPad Arduino w/ ATmega328'' [[<<]] An ATmega328 running at 8 MHz (3.3V) with auto-reset. Equivalent to Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328.

* ''LilyPad Arduino w/ ATmega168'' [[<<]] An ATmega168 running at 8 MHz. Compilation and upload is equivalent to the Arduino Pro or Pro Mini (8 MHz) w/ ATmega168. The bootloader burned, however, has a slower timeout (and blinks the pin 13 LED three times on reset) because the original versions of the LilyPad didn't support auto-reset. They also didn't include an external clock, so the burn bootloader command configures the fuses of ATmega168 for an internal 8 MHz clock. [[<<]] [[<<]] If you have a recent version of the LilyPad, (w/ a 6-pin programming header), you'll want to select Arduino Pro or Pro Mini (8 MHz) w/ ATmega168 before burning the bootloader.

* ''Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328'' [[<<]] An ATmega328 running at 8 MHz (3.3V) with auto-reset. Equivalent to LilyPad Arduino w/ ATmega328.

* ''Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega168'' [[<<]] An ATmega168 running at 8 MHz (3.3V) with auto-reset.

* ''Arduino NG or older w/ ATmega168'' [[<<]] An ATmega168 running at 16 MHz ''without'' auto-reset. Compilation and upload is equivalent to Arduino Diecimila or Duemilanove w/ ATmega168, but the bootloader burned has a slower timeout (and blinks the pin 13 LED three times on reset).

* ''Arduino NG or older w/ ATmega8'' [[<<]] An ATmega8 running at 16 MHz ''without'' auto-reset.



December 23, 2009, at 06:41 PM by David A. Mellis -
Added lines 73-74:
[[<<]]
Deleted lines 123-124:
[[<<]]
December 23, 2009, at 06:39 PM by David A. Mellis -
Changed lines 124-125 from:
!!!Board Descriptions
to:
!!!Boards
Changed lines 128-160 from:
(:table width=100% border=0 cellpadding=5 cellspacing=0:)
(:cell width=50%:)

'''Arduino Duemilanove or Nano w/ ATmega328'''

An ATmega328 running at 16 MHz with auto-reset. Also used for the 16 MHz (5V) versions of the Arduino Pro or Pro Mini with an ATmega328.

'''Arduino Diecimila, Duemilanove, or Nano w/ ATmega168'''

An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset). Also used for the 16 MHz (5V) versions of the Arduino Pro and Pro Mini with an ATmega168.

'''Arduino Mega'''

An ATmega1280 running at 16 MHz with auto-reset.

'''Arduino Mini'''

Equivalent to Arduino NG or older w/ ATmega168 (i.e. an ATmega168 running at 16 MHz without auto-reset).

'''Arduino BT'''

ATmega168 running at 16 MHz. The bootloader burned includes codes to initialize the on-board bluetooth module.

(:cell width=50%:)

'''LilyPad Arduino w/ ATmega328'''

An ATmega328 running at 8 MHz (3.3V) with auto-reset. Equivalent to Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328.

'''LilyPad Arduino w/ ATmega168'''

An ATmega168 running at 8 MHz. Compilation and upload is equivalent to the Arduino Pro or Pro Mini (8 MHz) w/ ATmega168. The bootloader burned, however, has a slower timeout (and blinks the pin 13 LED three times on reset) because the original versions of the LilyPad didn't support auto-reset. They also didn't include an external clock, so the burn bootloader command configures the fuses of ATmega168 for an internal 8 MHz clock.
to:
'''Arduino Duemilanove or Nano w/ ATmega328''' [[<<]] An ATmega328 running at 16 MHz with auto-reset. Also used for the 16 MHz (5V) versions of the Arduino Pro or Pro Mini with an ATmega328.

'''Arduino Diecimila, Duemilanove, or Nano w/ ATmega168''' [[<<]] An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset). Also used for the 16 MHz (5V) versions of the Arduino Pro and Pro Mini with an ATmega168.

'''Arduino Mega''' [[<<]] An ATmega1280 running at 16 MHz with auto-reset.

'''Arduino Mini''' [[<<]] Equivalent to Arduino NG or older w/ ATmega168 (i.e. an ATmega168 running at 16 MHz without auto-reset).

'''Arduino BT''' [[<<]] ATmega168 running at 16 MHz. The bootloader burned includes codes to initialize the on-board bluetooth module.

'''LilyPad Arduino w/ ATmega328''' [[<<]] An ATmega328 running at 8 MHz (3.3V) with auto-reset. Equivalent to Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328.

'''LilyPad Arduino w/ ATmega168''' [[<<]] An ATmega168 running at 8 MHz. Compilation and upload is equivalent to the Arduino Pro or Pro Mini (8 MHz) w/ ATmega168. The bootloader burned, however, has a slower timeout (and blinks the pin 13 LED three times on reset) because the original versions of the LilyPad didn't support auto-reset. They also didn't include an external clock, so the burn bootloader command configures the fuses of ATmega168 for an internal 8 MHz clock.
Changed lines 144-163 from:
'''Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328'''

An ATmega328 running at 8 MHz (3.3V) with auto-reset. Equivalent to LilyPad Arduino w/ ATmega328.

'''Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega168'''

An ATmega168 running at 8 MHz (3.3V) with auto-reset.

'''Arduino NG or older w/ ATmega168'''

An ATmega168 running at 16 MHz ''without'' auto-reset. Compilation and upload is equivalent to Arduino Diecimila or Duemilanove w/ ATmega168, but the bootloader burned has a slower timeout (and blinks the pin 13 LED three times on reset).

'''Arduino NG or older w/ ATmega8'''

An ATmega8 running at 16 MHz ''without'' auto-reset.

(:tableend:)


to:
'''Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328''' [[<<]] An ATmega328 running at 8 MHz (3.3V) with auto-reset. Equivalent to LilyPad Arduino w/ ATmega328.

'''Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega168''' [[<<]] An ATmega168 running at 8 MHz (3.3V) with auto-reset.

'''Arduino NG or older w/ ATmega168''' [[<<]] An ATmega168 running at 16 MHz ''without'' auto-reset. Compilation and upload is equivalent to Arduino Diecimila or Duemilanove w/ ATmega168, but the bootloader burned has a slower timeout (and blinks the pin 13 LED three times on reset).

'''Arduino NG or older w/ ATmega8''' [[<<]] An ATmega8 running at 16 MHz ''without'' auto-reset.



December 23, 2009, at 06:35 PM by David A. Mellis -
Changed lines 9-10 from:
''Verify/Compile''
to:
(:table width=100%:)

(:cellnr width=40:)
Changed lines 15-18 from:
Checks your code for errors.

''Stop''
to:
(:cell:)

''Verify/Compile'' [[<<]] Checks your code for errors.

(:cellnr:)
Changed lines 23-26 from:
Stops the serial monitor, or unhighlight other buttons.

''New''
to:
(:cell:)

''Stop'' [[<<]] Stops the serial monitor, or unhighlight other buttons.

(:cellnr:)
Changed lines 31-34 from:
Creates a new sketch.

''Open''
to:
(:cell:)

''New'' [[<<]] Creates a new sketch.

(:cellnr:)
Changed lines 39-40 from:
Presents a menu of all the sketches in your sketchbook. Clicking one will open it within the current window.
to:
(:cell:)

''Open'' [[<<]] Presents a menu of all the sketches in your sketchbook. Clicking one will open it within the current window.
Changed lines 45-46 from:
''Save''
to:
(:cellnr:)
Changed lines 49-52 from:
Saves your sketch.

''Upload to I/O Board''
to:
(:cell:)

''Save'' [[<<]] Saves your sketch.

(:cellnr:)
Changed lines 57-60 from:
Compiles your code and uploads it to the Arduino I/O board. Uses the selected items in the '''Tools > Board''' and '''Tools > Serial Port''' menus.

''Serial Monitor''
to:
(:cell:)

''Upload to I/O Board'' [[<<]] Compiles your code and uploads it to the Arduino I/O board. Uses the selected items in the '''Tools > Board''' and '''Tools > Serial Port''' menus.

(:cellnr:)
Changed lines 65-66 from:
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.
to:
(:cell:)

''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.
Added lines 71-72:
(:tableend:)
December 23, 2009, at 06:30 PM by David A. Mellis -
Added line 56:
Changed lines 59-66 from:
''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.
to:
* ''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.
Changed lines 65-80 from:
''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 | libraries]] below.

''Show Sketch Folder''

Opens the sketch folder on the desktop.

''Add File...''

Adds a source file to the sketch (it will be copied from its current location). The new file appears in a new tab in the sketch window. Files can be removed from the sketch using the tab menu.
to:
* ''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 | libraries]] below.

* ''Show Sketch Folder'' [[<<]] Opens the sketch folder on the desktop.

* ''Add File...'' [[<<]] Adds a source file to the sketch (it will be copied from its current location). The new file appears in a new tab in the sketch window. Files can be removed from the sketch using the tab menu.
Changed lines 75-92 from:
''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 you're using. This controls the way that your sketch is compiled and uploaded as well as the behavior of the Burn Bootloader menu items. ''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.

Before uploading your sketch, you need to select the item from this menu that represents your Arduino board. On the Mac, this 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, it's probably '''COM1''' or '''COM2''' (for a serial board) or '''COM4''', '''COM5''', '''COM7''', or higher (for a USB board) - to find 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.

''Burn Bootloader''

The items in this menu allow you to burn a [[Tutorial/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 you've selected the correct board from the '''Boards''' menu before burning the bootloader. When using an AVR ISP, you'll need to select the item corresponding to your programmer from the '''Serial Port''' menu.
to:
* ''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 you're 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. [[<<]] [[<<]] Before uploading your sketch, you need to select the item from this menu that represents your Arduino board. On the Mac, this 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, it's probably '''COM1''' or '''COM2''' (for a serial board) or '''COM4''', '''COM5''', '''COM7''', or higher (for a USB board) - to find 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.

* ''Burn Bootloader'' [[<<]] The items in this menu allow you to burn a [[Tutorial/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 you've selected the correct board from the '''Boards''' menu before burning the bootloader. When using an AVR ISP, you'll need to select the item corresponding to your programmer from the '''Serial Port''' menu.
December 23, 2009, at 06:25 PM by David A. Mellis -
Changed lines 1-7 from:
!!Introduction to the Arduino Environment

(:table width=100% border=0 cellpadding=5 cellspacing=0:)
(:cell width=50%:)

!!!Toolbar
to:
!!Environment

!!!Arduino Development Environment

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.

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:
Changed lines 55-64 from:
!!!!Tab Menu

Attach:tabs.gif

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

(:cell width=50%:)

!!!Menus
to:
Additional commands are found within the five 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.
Deleted lines 103-104:
(:tableend:)
Added lines 109-112:
!!!Tabs and Multiple Files

Allows you to manage sketches with more than one file (each of which appears in its own tab). These can be normal Arduino code files (no extension), C files (.c extension), C++ files (.cpp), or header files (.h).
December 23, 2009, at 05:49 PM by David A. Mellis -
Changed lines 124-125 from:
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 | sketchbook directory]]. Then unzip the library there. For example, to install the DateTime library, its files should be in the '''/libraries/DateTime''' sub-folder of your sketchbook folder.
to:
There is a [[Reference/libraries | list of libraries]] in the reference. 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 | sketchbook directory]]. Then unzip the library there. For example, to install the DateTime library, its files should be in the '''/libraries/DateTime''' sub-folder of your sketchbook folder.
December 23, 2009, at 05:48 PM by David A. Mellis -
Changed lines 122-123 from:
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 to the '''libraries''' directory.
to:
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.

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 | sketchbook directory]]. Then unzip the library there. For example, to install the DateTime library, its files should be in the '''/libraries/DateTime''' sub-folder of your sketchbook folder.
December 23, 2009, at 05:30 PM by David A. Mellis -
Changed lines 82-83 from:
Adds a library to your sketch by inserting #include statements at the code of your code. For more details, see [[#libraries]] below.
to:
Adds a library to your sketch by inserting #include statements at the code of your code. For more details, see [[#libraries | libraries]] below.
December 23, 2009, at 05:29 PM by David A. Mellis -
Changed lines 82-83 from:
Uses a library in your sketch. Works by adding '''#include'''s to the top of your code. This makes extra functionality available to your sketch, but increases its size. To stop using a library, delete the appropriate '''#include'''s from the top of your sketch. For more details, see the page on [[Reference/Libraries]].
to:
Adds a library to your sketch by inserting #include statements at the code of your code. For more details, see [[#libraries]] below.
December 23, 2009, at 05:27 PM by David A. Mellis -
Added line 114:
[[#sketchbook]]
Added line 119:
[[#libraries]]
Added line 124:
[[#preferences]]
November 29, 2009, at 01:48 AM by David A. Mellis -
Added lines 126-127:
[[<<]]
November 29, 2009, at 01:46 AM by David A. Mellis -
Changed lines 112-113 from:
(:cellnr:)
to:
(:tableend:)
Deleted lines 121-122:
(:cell:)
Deleted lines 125-126:
(:tableend:)
November 29, 2009, at 01:44 AM by David A. Mellis -
Added lines 112-127:
(:cellnr:)

!!!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. The first 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.

!!!Libraries

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 to the '''libraries''' directory.

(:cell:)

!!!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 file, whose location is shown in the preference dialog.
Changed lines 187-192 from:
!!!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 file, whose location is shown in the preference dialog.


to:

November 01, 2009, at 05:40 PM by David A. Mellis -
Changed lines 173-176 from:
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 [[Hacking/Preferences | preference files]].


to:
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 file, whose location is shown in the preference dialog.


August 15, 2009, at 02:38 PM by David A. Mellis -
Changed lines 30-31 from:
Presents a menu of all the sketches in your sketchbook. Note: due to a bug in Java, this menu doesn't scroll; if you need to open a sketch late in the list, use the '''File | Sketchbook''' menu instead.
to:
Presents a menu of all the sketches in your sketchbook. Clicking one will open it within the current window.

Note: due to a bug in Java, this menu doesn't scroll; if you need to open a sketch late in the list, use the '''File | Sketchbook''' menu instead.
Changed lines 44-45 from:
Uploads your code to the Arduino I/O board. Make sure to save or verify your sketch before uploading it.
to:
Compiles your code and uploads it to the Arduino I/O board. Uses the selected items in the '''Tools > Board''' and '''Tools > Serial Port''' menus.
Changed lines 58-59 from:
Allows you to manage sketches with more than one file (each of which appears in its own tab). These can be normal Arduino code files (no extension), C files (.c extension), C++ files (.cpp), or header files (.h). See the [[Hacking/BuildProcess | description of the build process]] for details of how these are handled.
to:
Allows you to manage sketches with more than one file (each of which appears in its own tab). These can be normal Arduino code files (no extension), C files (.c extension), C++ files (.cpp), or header files (.h).
Added lines 64-73:
!!!!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.
Changed lines 90-92 from:
Adds another source file to the sketch. The new file appears in a new tab in the sketch window. This facilitates and larger projects with multiple source files. Files can be removed from a sketch using the tab menu.

to:
Adds a source file to the sketch (it will be copied from its current location). The new file appears in a new tab in the sketch window. Files can be removed from the sketch using the tab menu.
Deleted lines 97-104:
''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.
Changed lines 100-101 from:
Select the board that you're using. This controls the way that your sketch is compiled and uploaded as well as the behavior of the Burn Bootloader menu items. ''See below for details.''
to:
Select the board that you're using. This controls the way that your sketch is compiled and uploaded as well as the behavior of the Burn Bootloader menu items. ''See below for descriptions of the various boards.''
Changed lines 106-107 from:
Before uploading your sketch, you need to select the item from this menu that represents your Arduino board. On the Mac, this 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, it's probably '''COM1''' or '''COM2''' (for a serial board) or '''COM4''', '''COM5''', '''COM7''', or higher (for a USB board) - to find out, you look for USB serial device in the ports section of the Windows Device Manager.
to:
Before uploading your sketch, you need to select the item from this menu that represents your Arduino board. On the Mac, this 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, it's probably '''COM1''' or '''COM2''' (for a serial board) or '''COM4''', '''COM5''', '''COM7''', or higher (for a USB board) - to find 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.
Changed lines 110-111 from:
The items in this menu allow you to burn a [[Hacking/bootloader]] onto your board with a variety of programmers. This is not required for normal use of an Arduino board, but may be useful if you purchase additional ATmega's or are building a board yourself. Ensure that you've selected the correct board from the Boards menu beforehand. To burn a bootloader with the AVR ISP, you need to select the item corresponding to your programmer from the Serial Port menu. Instructions are available for building a [[Main/parallel programmer]].
to:
The items in this menu allow you to burn a [[Tutorial/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 you've selected the correct board from the '''Boards''' menu before burning the bootloader. When using an AVR ISP, you'll need to select the item corresponding to your programmer from the '''Serial Port''' menu.
Changed lines 121-122 from:
'''Arduino Duemilanove w/ ATmega328'''
to:
'''Arduino Duemilanove or Nano w/ ATmega328'''
Changed lines 125-126 from:
'''Arduino Diecimila or Duemilanove w/ ATmega168'''
to:
'''Arduino Diecimila, Duemilanove, or Nano w/ ATmega168'''
Deleted lines 136-139:
'''Arduino Nano'''

Equivalent to Arduino Diecimila or Duemilanove w/ ATmega168 (i.e. an ATmega168 running at 16 MHz with auto-reset).
June 07, 2009, at 09:39 PM by David A. Mellis -
Added lines 91-94:
''Copy as HTML''

Copies the code of your sketch to the clipboard as HTML, suitable for embedding in web pages.
June 07, 2009, at 09:38 PM by David A. Mellis -
Added lines 109-110:
''The board selection has two effects: the parameters (e.g. CPU speed and baud rate) used when compiling and uploading sketches; and the file and fuse settings used by the burn bootloader command. Some of the board definitions differ only in the latter, so even if you've been uploading successfully with a particular selection you'll want to check it before burning the bootloader.''
June 07, 2009, at 09:31 PM by David A. Mellis - re-ordering board descriptions to match menu order in Arduino 0016.
Deleted lines 119-144:
'''Arduino NG or older w/ ATmega168'''

An ATmega168 running at 16 MHz ''without'' auto-reset. Compilation and upload is equivalent to Arduino Diecimila or Duemilanove w/ ATmega168, but the bootloader burned has a slower timeout (and blinks the pin 13 LED three times on reset).

'''Arduino NG or older w/ ATmega8'''

An ATmega8 running at 16 MHz ''without'' auto-reset.

'''Arduino Pro or Pro Mini (8 MHz) w/ ATmega328'''

An ATmega328 running at 8 MHz (3.3V) with auto-reset.

'''Arduino Pro or Pro Mini (8 MHz) w/ ATmega168'''

An ATmega168 running at 8 MHz (3.3V) with auto-reset.

(:cell width=50%:)

'''Arduino Nano'''

Equivalent to Arduino Diecimila or Duemilanove w/ ATmega168 (i.e. an ATmega168 running at 16 MHz with auto-reset).

'''Arduino Mini'''

Equivalent to Arduino NG or older w/ ATmega168 (i.e. an ATmega168 running at 16 MHz without auto-reset).
Added lines 124-131:
'''Arduino Mini'''

Equivalent to Arduino NG or older w/ ATmega168 (i.e. an ATmega168 running at 16 MHz without auto-reset).

'''Arduino Nano'''

Equivalent to Arduino Diecimila or Duemilanove w/ ATmega168 (i.e. an ATmega168 running at 16 MHz with auto-reset).
Changed lines 136-137 from:
'''LilyPad Arduino'''
to:
(:cell width=50%:)

'''LilyPad Arduino w/ ATmega328'''

An ATmega328 running at 8 MHz (3.3V) with auto-reset. Equivalent to Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328.

'''LilyPad Arduino w/ ATmega168'''
Added lines 148-163:
'''Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328'''

An ATmega328 running at 8 MHz (3.3V) with auto-reset. Equivalent to LilyPad Arduino w/ ATmega328.

'''Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega168'''

An ATmega168 running at 8 MHz (3.3V) with auto-reset.

'''Arduino NG or older w/ ATmega168'''

An ATmega168 running at 16 MHz ''without'' auto-reset. Compilation and upload is equivalent to Arduino Diecimila or Duemilanove w/ ATmega168, but the bootloader burned has a slower timeout (and blinks the pin 13 LED three times on reset).

'''Arduino NG or older w/ ATmega8'''

An ATmega8 running at 16 MHz ''without'' auto-reset.
May 19, 2009, at 09:16 PM by David A. Mellis -
Changed lines 156-157 from:
An ATmega168 running at 8 MHz. Compilation and upload is equivalent to the Arduino Pro or Pro Mini (8 MHz) w/ ATmega168. The bootloader burned, however, has a slower timeout (and blinks the pin 13 LED three times on reset) because the original versions of the LilyPad didn't support auto-reset. Newer versions do, so if you need to reburn the bootloader on a recent LilyPad (w/ a 6-pin programming header), you should select Arduino Pro or Pro Mini (8 MHz) w/ ATmega168.
to:
An ATmega168 running at 8 MHz. Compilation and upload is equivalent to the Arduino Pro or Pro Mini (8 MHz) w/ ATmega168. The bootloader burned, however, has a slower timeout (and blinks the pin 13 LED three times on reset) because the original versions of the LilyPad didn't support auto-reset. They also didn't include an external clock, so the burn bootloader command configures the fuses of ATmega168 for an internal 8 MHz clock.

If you have a recent version of the LilyPad, (w/ a 6-pin programming header), you'll want to select Arduino Pro or Pro Mini (8 MHz) w/ ATmega168 before burning the bootloader.
May 08, 2009, at 02:12 PM by David A. Mellis -
Added lines 109-111:
(:table width=100% border=0 cellpadding=5 cellspacing=0:)
(:cell width=50%:)
Deleted lines 115-118:
'''Arduino Pro or Pro Mini (8 MHz) w/ ATmega328'''

An ATmega328 running at 8 MHz (3.3V) with auto-reset.
Deleted lines 119-122:
'''Arduino Nano'''

Equivalent to Arduino Diecimila or Duemilanove w/ ATmega168 (i.e. an ATmega168 running at 16 MHz with auto-reset).
Changed lines 124-131 from:
'''Arduino Mini'''

Equivalent to Arduino NG or older w/ ATmega168 (i.e. an ATmega168 running at 16 MHz without auto-reset).

'''LilyPad Arduino'''

An ATmega168 running at 8 MHz. Compilation and upload is equivalent to the Arduino Pro or Pro Mini (8 MHz) w/ ATmega168. The bootloader burned, however, has a slower timeout (and blinks the pin 13 LED three times on reset) because the original versions of the LilyPad didn't support auto-reset. Newer versions do, so if you need to reburn the bootloader on a recent LilyPad (w/ a 6-pin programming header), you should select Arduino Pro or Pro Mini (8 MHz) w/ ATmega168.
to:
'''Arduino NG or older w/ ATmega8'''

An ATmega8 running at 16 MHz ''without'' auto-reset.

'''Arduino Pro or Pro Mini (8 MHz) w/ ATmega328'''

An ATmega328 running at 8 MHz (3.3V) with auto-reset.
Changed lines 134-135 from:
An ATmega168 running at 8 MHz with auto-reset.
to:
An ATmega168 running at 8 MHz (3.3V) with auto-reset.

(:cell width=50%:)

'''Arduino Nano'''

Equivalent to Arduino Diecimila or Duemilanove w/ ATmega168 (i.e. an ATmega168 running at 16 MHz with auto-reset).

'''Arduino Mini'''

Equivalent to Arduino NG or older w/ ATmega168 (i.e. an ATmega168 running at 16 MHz without auto-reset).
Changed lines 154-157 from:
'''Arduino NG or older w/ ATmega8'''

ATmega8 running at 16 MHz ''without'' auto-reset.
to:
'''LilyPad Arduino'''

An ATmega168 running at 8 MHz. Compilation and upload is equivalent to the Arduino Pro or Pro Mini (8 MHz) w/ ATmega168. The bootloader burned, however, has a slower timeout (and blinks the pin 13 LED three times on reset) because the original versions of the LilyPad didn't support auto-reset. Newer versions do, so if you need to reburn the bootloader on a recent LilyPad (w/ a 6-pin programming header), you should select Arduino Pro or Pro Mini (8 MHz) w/ ATmega168.

(:tableend:)
May 08, 2009, at 02:08 PM by David A. Mellis -
Changed lines 93-94 from:
Select the board that you're using. This controls the way that your sketch is compiled and uploaded as well as the behavior of the Burn Bootloader menu items.
to:
Select the board that you're using. This controls the way that your sketch is compiled and uploaded as well as the behavior of the Burn Bootloader menu items. ''See below for details.''
Added lines 107-152:
!!!Board Descriptions

'''Arduino Duemilanove w/ ATmega328'''

An ATmega328 running at 16 MHz with auto-reset. Also used for the 16 MHz (5V) versions of the Arduino Pro or Pro Mini with an ATmega328.

'''Arduino Pro or Pro Mini (8 MHz) w/ ATmega328'''

An ATmega328 running at 8 MHz (3.3V) with auto-reset.

'''Arduino Diecimila or Duemilanove w/ ATmega168'''

An ATmega168 running at 16 MHz with auto-reset. Compilation and upload is equivalent to Arduino NG or older w/ ATmega168, but the bootloader burned has a faster timeout (and blinks the pin 13 LED only once on reset). Also used for the 16 MHz (5V) versions of the Arduino Pro and Pro Mini with an ATmega168.

'''Arduino Nano'''

Equivalent to Arduino Diecimila or Duemilanove w/ ATmega168 (i.e. an ATmega168 running at 16 MHz with auto-reset).

'''Arduino NG or older w/ ATmega168'''

An ATmega168 running at 16 MHz ''without'' auto-reset. Compilation and upload is equivalent to Arduino Diecimila or Duemilanove w/ ATmega168, but the bootloader burned has a slower timeout (and blinks the pin 13 LED three times on reset).

'''Arduino Mini'''

Equivalent to Arduino NG or older w/ ATmega168 (i.e. an ATmega168 running at 16 MHz without auto-reset).

'''LilyPad Arduino'''

An ATmega168 running at 8 MHz. Compilation and upload is equivalent to the Arduino Pro or Pro Mini (8 MHz) w/ ATmega168. The bootloader burned, however, has a slower timeout (and blinks the pin 13 LED three times on reset) because the original versions of the LilyPad didn't support auto-reset. Newer versions do, so if you need to reburn the bootloader on a recent LilyPad (w/ a 6-pin programming header), you should select Arduino Pro or Pro Mini (8 MHz) w/ ATmega168.

'''Arduino Pro or Pro Mini (8 MHz) w/ ATmega168'''

An ATmega168 running at 8 MHz with auto-reset.

'''Arduino Mega'''

An ATmega1280 running at 16 MHz with auto-reset.

'''Arduino BT'''

ATmega168 running at 16 MHz. The bootloader burned includes codes to initialize the on-board bluetooth module.

'''Arduino NG or older w/ ATmega8'''

ATmega8 running at 16 MHz ''without'' auto-reset.
December 26, 2008, at 05:03 PM by David A. Mellis -
Changed lines 109-112 from:
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 [[Hacking/Preferences | preference files]].
to:
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 [[Hacking/Preferences | preference files]].


April 24, 2008, at 05:28 AM by David A. Mellis -
Changed line 3 from:
(:table width=90% border=0 cellpadding=5 cellspacing=0:)
to:
(:table width=100% border=0 cellpadding=5 cellspacing=0:)
January 30, 2008, at 04:41 PM by David A. Mellis -
Added lines 52-53:
!!!!Tab Menu
Changed lines 78-80 from:
Adds another source file to the sketch. The new file appears in a new tab in the sketch window. This facilitates cut and paste between sketches, and larger projects with multiple source files. Deleting extra files in a sketch must be done manually be opening the sketch folder and deleting the unwanted file.

to:
Adds another source file to the sketch. The new file appears in a new tab in the sketch window. This facilitates and larger projects with multiple source files. Files can be removed from a sketch using the tab menu.

January 30, 2008, at 02:12 PM by Paul Badger -
Changed lines 76-78 from:
Adds another source file to the sketch. This facilitates cut and paste between sketches, and larger projects with multiple source files. Deleting extra files in a sketch must be done manually be opening the sketch folder and deleting the unwanted file.

to:
Adds another source file to the sketch. The new file appears in a new tab in the sketch window. This facilitates cut and paste between sketches, and larger projects with multiple source files. Deleting extra files in a sketch must be done manually be opening the sketch folder and deleting the unwanted file.

January 30, 2008, at 02:09 PM by Paul Badger -
Changed lines 70-71 from:
''Show Sketch Folder"
to:
''Show Sketch Folder''
Changed lines 74-75 from:
''Add File..."
to:
''Add File...''
January 30, 2008, at 02:08 PM by Paul Badger -
Added lines 70-78:
''Show Sketch Folder"

Opens the sketch folder on the desktop.

''Add File..."

Adds another source file to the sketch. This facilitates cut and paste between sketches, and larger projects with multiple source files. Deleting extra files in a sketch must be done manually be opening the sketch folder and deleting the unwanted file.

January 05, 2008, at 05:29 AM by David A. Mellis -
Added lines 54-55:
Allows you to manage sketches with more than one file (each of which appears in its own tab). These can be normal Arduino code files (no extension), C files (.c extension), C++ files (.cpp), or header files (.h). See the [[Hacking/BuildProcess | description of the build process]] for details of how these are handled.
January 05, 2008, at 05:25 AM by David A. Mellis -
Added lines 52-53:
Attach:tabs.gif
January 05, 2008, at 05:13 AM by David A. Mellis -
Added lines 72-75:
''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.
November 02, 2007, at 10:24 PM by David A. Mellis -
Changed line 90 from:
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 [[Hacking/Preferences | preferences files]].
to:
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 [[Hacking/Preferences | preference files]].
November 02, 2007, at 10:24 PM by David A. Mellis -
Changed line 90 from:
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 [[Main/preferences | preferences.txt file]].
to:
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 [[Hacking/Preferences | preferences files]].
November 02, 2007, at 10:24 PM by David A. Mellis -
Changed lines 64-65 from:
Uses a library in your sketch. Works by adding '''#include'''s to the top of your code. This makes extra functionality available to your sketch, but increases its size. To stop using a library, delete the appropriate '''#include'''s from the top of your sketch. For more details, see the page on [[Main/libraries]].
to:
Uses a library in your sketch. Works by adding '''#include'''s to the top of your code. This makes extra functionality available to your sketch, but increases its size. To stop using a library, delete the appropriate '''#include'''s from the top of your sketch. For more details, see the page on [[Reference/Libraries]].
October 22, 2007, at 05:52 PM by David A. Mellis -
Changed lines 72-75 from:
''Microcontroller (MCU)''

This menu lets you choose which microcontroller you're using; it should match the name (up to the dash) of the chip on your Arduino board (e.g. if your chip says "ATMEGA168-20PU", you would choose "atmega168"). New Arduino boards use the ATmega168, but some older ones have ATmega8s.
to:
''Board''

Select the board that you're using. This controls the way that your sketch is compiled and uploaded as well as the behavior of the Burn Bootloader menu items.
Deleted lines 81-88:
''Burn Diecimila Bootloader''

This burns the Arduino Diecimila ATmega168 bootloader to your Arduino board using an AVRISP mkII. Only available if you have ATmega168 selected in the '''Microcontroller''' submenu. For more details see the [[Hacking/bootloader]] page.

''Burn Mini/NG Bootloader''

This burns the Arduino Mini/NG bootloader to your Arduino board using an AVRISP mkII. Only available if you have ATmega168 selected in the '''Microcontroller''' submenu. For more details see the [[Hacking/bootloader]] page.
Changed lines 84-89 from:
This burns the ATmega8 bootloader to your Arduino board using an AVRISP and the serial port you've selected in the '''Serial Port''' submenu. Only available if you have ATmega8 selected in the '''Microcontroller''' submenu. For more details see the [[Hacking/bootloader]] page.

''Burn Bootloader (parallel)''

''Windows and Linux only''. Burns the bootloader to your Arduino board, using a [[Main/parallel programmer]]. This only works with the atmega8 (not the atmega168).
to:
The items in this menu allow you to burn a [[Hacking/bootloader]] onto your board with a variety of programmers. This is not required for normal use of an Arduino board, but may be useful if you purchase additional ATmega's or are building a board yourself. Ensure that you've selected the correct board from the Boards menu beforehand. To burn a bootloader with the AVR ISP, you need to select the item corresponding to your programmer from the Serial Port menu. Instructions are available for building a [[Main/parallel programmer]].
August 07, 2007, at 05:39 PM by David A. Mellis -
Changed lines 48-49 from:
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.
to:
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.
August 07, 2007, at 03:56 AM by David A. Mellis - updating burn bootloader documentation for arduino 0009
Added lines 82-89:
''Burn Diecimila Bootloader''

This burns the Arduino Diecimila ATmega168 bootloader to your Arduino board using an AVRISP mkII. Only available if you have ATmega168 selected in the '''Microcontroller''' submenu. For more details see the [[Hacking/bootloader]] page.

''Burn Mini/NG Bootloader''

This burns the Arduino Mini/NG bootloader to your Arduino board using an AVRISP mkII. Only available if you have ATmega168 selected in the '''Microcontroller''' submenu. For more details see the [[Hacking/bootloader]] page.
Changed lines 92-93 from:
This burns the bootloader to your Arduino board, using an an AVR-ISP connected to the serial port selected in the '''Serial Port''' submenu. This only works with the atmega8 (not the atmega168). For more details see the [[Main/bootloader]] page.
to:
This burns the ATmega8 bootloader to your Arduino board using an AVRISP and the serial port you've selected in the '''Serial Port''' submenu. Only available if you have ATmega8 selected in the '''Microcontroller''' submenu. For more details see the [[Hacking/bootloader]] page.
June 16, 2007, at 12:36 AM by David A. Mellis - removing references to ancient versions of the software
Changed lines 48-49 from:
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 (in Arduino 0005, pressing enter appends a newline to your text, this was removed in Arduino 0006). Choose the baud rate from the drop-down that matches the rate passed to '''Serial.begin''' in your sketch (in version of Arduino prior to 0006, the baud rate is specified in the '''Tools | Serial Monitor Baud Rate''' menu).
to:
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.
Deleted lines 81-86:
''Serial Monitor Baud Rate'' (Arduino 0005 and earlier)

This menu item controls the baud rate (speed) that the serial monitor uses to communicate with a sketch running on the Arduino board. It must match the value passed to [[../Reference/BeginSerial/ | beginSerial]] in the code of the sketch. In Arduino 0006, this baud rate is set from a drop-down in the status bar when the serial monitor is enabled.

This baud rate does not affect the process of uploading sketches to the Arduino board; see the [[FAQ]] if you need to change that.
June 16, 2007, at 12:35 AM by David A. Mellis -
Changed lines 74-75 from:
This menu lets you choose which microcontroller you're using; it should match the name (up to the dash) of the chip on your Arduino board (e.g. if your chip says "ATMEGA8-16PI", you would choose "atmega8"). Almost all Arduino boards use the atmega8, but the new Arduino stamps use the atmega168 (which can hold programs which are twice as big).
to:
This menu lets you choose which microcontroller you're using; it should match the name (up to the dash) of the chip on your Arduino board (e.g. if your chip says "ATMEGA168-20PU", you would choose "atmega168"). New Arduino boards use the ATmega168, but some older ones have ATmega8s.
November 04, 2006, at 05:36 PM by David A. Mellis -
Changed lines 64-65 from:
Uses a library in your sketch. Works by adding '''#include'''s to the top of your code. This makes extra functionality available to your sketch, but increases its size. To stop using a library, delete the appropriate '''#include'''s from the top of your sketch. For more details, see the page on [[libraries]].
to:
Uses a library in your sketch. Works by adding '''#include'''s to the top of your code. This makes extra functionality available to your sketch, but increases its size. To stop using a library, delete the appropriate '''#include'''s from the top of your sketch. For more details, see the page on [[Main/libraries]].
Changed lines 90-91 from:
This burns the bootloader to your Arduino board, using an an AVR-ISP connected to the serial port selected in the '''Serial Port''' submenu. This only works with the atmega8 (not the atmega168). For more details see the [[bootloader]] page.
to:
This burns the bootloader to your Arduino board, using an an AVR-ISP connected to the serial port selected in the '''Serial Port''' submenu. This only works with the atmega8 (not the atmega168). For more details see the [[Main/bootloader]] page.
Changed lines 94-95 from:
''Windows and Linux only''. Burns the bootloader to your Arduino board, using a [[parallel programmer]]. This only works with the atmega8 (not the atmega168).
to:
''Windows and Linux only''. Burns the bootloader to your Arduino board, using a [[Main/parallel programmer]]. This only works with the atmega8 (not the atmega168).
Changed line 100 from:
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 | preferences.txt file]].
to:
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 [[Main/preferences | preferences.txt file]].
November 04, 2006, at 05:20 PM by David A. Mellis -
Deleted lines 2-3:
Attach:ArduinoEnvironment.png
November 04, 2006, at 05:20 PM by David A. Mellis -
Added lines 3-4:
Attach:ArduinoEnvironment.png
October 26, 2006, at 10:26 PM by David A. Mellis -
Added lines 1-100:
!!Introduction to the Arduino Environment

(:table width=90% border=0 cellpadding=5 cellspacing=0:)
(:cell width=50%:)

!!!Toolbar

''Verify/Compile''

Attach:play.gif

Checks your code for errors.

''Stop''

Attach:stop.gif

Stops the serial monitor, or unhighlight other buttons.

''New''

Attach:new.gif

Creates a new sketch.

''Open''

Attach:open.gif

Presents a menu of all the sketches in your sketchbook. Note: due to a bug in Java, this menu doesn't scroll; if you need to open a sketch late in the list, use the '''File | Sketchbook''' menu instead.

''Save''

Attach:save.gif

Saves your sketch.

''Upload to I/O Board''

Attach:export.gif

Uploads your code to the Arduino I/O board. Make sure to save or verify your sketch before uploading it.

''Serial Monitor''

Attach:serial_monitor.gif

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 (in Arduino 0005, pressing enter appends a newline to your text, this was removed in Arduino 0006). Choose the baud rate from the drop-down that matches the rate passed to '''Serial.begin''' in your sketch (in version of Arduino prior to 0006, the baud rate is specified in the '''Tools | Serial Monitor Baud Rate''' menu).

You can also talk to the board from Processing, Flash, MaxMSP, etc (see the [[http://www.arduino.cc/playground/Main/Interfacing | interfacing page]] for details).

(:cell width=50%:)

!!!Menus

!!!!Sketch

''Verify/Compile''

Checks your sketch for errors.

''Import Library''

Uses a library in your sketch. Works by adding '''#include'''s to the top of your code. This makes extra functionality available to your sketch, but increases its size. To stop using a library, delete the appropriate '''#include'''s from the top of your sketch. For more details, see the page on [[libraries]].

!!!!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.

''Microcontroller (MCU)''

This menu lets you choose which microcontroller you're using; it should match the name (up to the dash) of the chip on your Arduino board (e.g. if your chip says "ATMEGA8-16PI", you would choose "atmega8"). Almost all Arduino boards use the atmega8, but the new Arduino stamps use the atmega168 (which can hold programs which are twice as big).

''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.

Before uploading your sketch, you need to select the item from this menu that represents your Arduino board. On the Mac, this 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, it's probably '''COM1''' or '''COM2''' (for a serial board) or '''COM4''', '''COM5''', '''COM7''', or higher (for a USB board) - to find out, you look for USB serial device in the ports section of the Windows Device Manager.

''Serial Monitor Baud Rate'' (Arduino 0005 and earlier)

This menu item controls the baud rate (speed) that the serial monitor uses to communicate with a sketch running on the Arduino board. It must match the value passed to [[../Reference/BeginSerial/ | beginSerial]] in the code of the sketch. In Arduino 0006, this baud rate is set from a drop-down in the status bar when the serial monitor is enabled.

This baud rate does not affect the process of uploading sketches to the Arduino board; see the [[FAQ]] if you need to change that.

''Burn Bootloader''

This burns the bootloader to your Arduino board, using an an AVR-ISP connected to the serial port selected in the '''Serial Port''' submenu. This only works with the atmega8 (not the atmega168). For more details see the [[bootloader]] page.

''Burn Bootloader (parallel)''

''Windows and Linux only''. Burns the bootloader to your Arduino board, using a [[parallel programmer]]. This only works with the atmega8 (not the atmega168).

(:tableend:)

!!!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 | preferences.txt file]].

Share