Se puede también comunicar con la placa desde Processing, Flash, MaxMSP, etc (ver Web de interface ('interfacing page') para más detalles)

Open
Presenta un menú de todos los programas sketch de su "sketchbook", (librería de sketch) . Un click sobre uno de ellos lo abrirá en la ventana actual.

• Verify/Compile
  Verifica los errores de su programa (sketch)

• Import Library
  Añade una librería a su programa(sketch) insertando la sentencia #include en el código. Para más detalles ver Librerías más abajo.

• Serial Port
  Este menú contiene todos los dispositivos serie (reales o virtuales) de su equipo. Se refrescará automáticamente cada vez que abras el menú tools.

Las librerías proporcionan funcionalidad extra para la utilización en "sketches", por ejemplo para trabajar con hardware o manipular datos. Para utilizar una librería en un "sketch", seleccione el menú Sketch > Import Library. Esto insertará una o más sentencias #include al principio del "sketch" y compilará la librería con su "sketch". Debido a que las librerías se vuelcan a la placa junto con su "sketch", incrementan la ocupación del espacio disponible. Si un "sketch" no precisa de una libreria, simplemente borra su sentencia #include en la parte inicial de su código.

Existe una Lista de librerías en las referencias. Algunas librerias estan incluidas en el software Arduino, otras pueden ser descargadas desde una gran variedad de fuentes. Para instalar estas librerías de terceros, crea un directorio denominado libraries en su Directorio sketchbook. Después descomprime la librería allí. Por ejemplo, para instalar la librería Data Time, sus ficheros deberían estar en una subcarpeta /libraries/DateTime en su carpeta de sketchbook.

Muestra los datos enviados desde la placa Arduino (placa USB o serie). Para enviar datos a la placa, teclee el texto y pulsa el botón "send" o enter. Seleccione la velocidad (baud rate) en el menú desplegable que coincida con el configurado en Serial.begin dentro de su "sketch". Advertir que en Mac o Linux, la placa Arduino se resetea (su "sketch" es reiniciado desde el principio) cuando conecta con el monitor serie.

Las librerías proporcionan funcionalidad extra para la utilización en "sketches", por ejemplo para trabajar con hardware o manipular datos. Para utilizar una librería en un "sketch", seleccione el menú Sketch > Import Library. Esto insertará una o más sentencias #include al principio del "sketch" y compilará la librería con su "sketch". Debido a que las librerías se vuelcan a la placa junto con tu "sketch", incrementan la ocupación del espacio disponible. Si un "sketch" no precisa de una libreria, simplemente borra su sentencia #include en la parte inicial de tu código.

Se puede agregar soporte para hardware de terceros en el directorio hardware del directorio "sketchbook". Las plataformas instaladas aquí pueden incluir la definición de las placas (que aparecen en el menú board), librerías del núcleo, "bootloaders", y definiciones de programador. Para instalarla, cree un directorio hardware, y en él descomprima la plataforma de terceros con su directorio. (No utilices "arduino" como nombre del subdirectorio o sobreescribirás la plataforma Arduino). Para desinstalarlo, simplemente borre ese directorio.

Muestra los datos enviados desde la placa Arduino (placa USB o serie). Para enviar datos a la placa, teclee el texto y pulsa el botón "send" o enter. Seleccione la velocidad (baud rate) en el menú desplegable que coincida con el configurado en Serial.begin dentro de tu "sketch". Advertir que en Mac o Linux, la placa Arduino se resetea (su "sketch" es reiniciado desde el principio) cuando conecta con el monitor serie.

La selección de placa tiene dos efectos: los parámetros utilizados cuando compila(por ejemplo, CPU usada y velocidad (baud rate)) y vuelcan los "sketches"; y el fichero y configuración utilizados por el gestor de arranque (bootloader)) al ser cargado. Algunas de las definiciones de las placas difieren sólo en lo segundo, incluso si ha sido cargado satisfactoriamente con una particular selección, usted podrá comprobarlo antes de grabar el "bootloader"

• Arduino BT
  ATmega168 trabajando a 16MHz. El bootloader incluye código para iniciar el módulo bluetooth de la placa.

El entorno de Arduino incluye el concepto de "sketchbook": que es el lugar estándar para el almacenamiento de sus programas (o "sketch"). Los "sketches" dentro de su "sketchbook" pueden abrirse desde el menú File > Sketchbook o desde el botón de la barra de herramientas Open. La primera vez que arranque el software Arduino, se creará un directorio para su "sketchbook". Puede visualizar o cambiar su localización dentro de "sketchbook location" desde el apartado Preferences

Antes de volcar su "sketch", necesitaa seleccionar los elementos correspondientes desde los menús Tools > Board y Tools > Serial Port.

Una vez que ha seleccionado el puerto serie y la placa, presione el botón de volcado en la barra de harramientas o selecione Upload to I/O Board desde el menú File. Las actuales placas de Arduino se resetearán automáticmamente y comenzará el volcado. Como las placas antiguas carecen de auto-reset, necesitará presionar el botón de reset en la placa, justo antes de iniciar el volcado. En muchas placas verá el led RX y TX parpadeando cuando el "sketch" está actualizándose. El entorno de Arduino mostrará un mensaje cuando el volcado esté completado, o mostrará un error.

Cuando se vuelca un "sketch", está utilizando el "bootloader" de Arduino, un pequeño programa que ha sido cargado en el microcontrolador en su placa. Permite el volcado del código sin utilizar hardware adicional. El "bootloader" está activo durante unos segundos cuando la placa es reseteada; después se incia el "sketch" que más recientemente se hubiera actualizado en el microcontrolador. El "bootloader" produce un parpadeo en el LED de la placa (pin 13) cuando se inicia (p.e. cuando las placas son reseteadas)

• Burn Bootloader
  Este elemento del menú le permite grabar un gestor de arranque (bootloader) dentro del microcontrolador de la placa Arduinio. Aunque no es un requisito para el normal funcionamiento de la placa Arduino, le será útil si compra un nuevo ATmega (el cual viene normalmente sin gestor de arranque). Asegúrese que ha seleccionado la placa correcta en el menú Boards antes de grabar el bootloader. Cuando use AVR ISP, tendrá que seleccionar en el menú Serial Port el puerto correspondiente.

El entorno de Desarrollo Arduino está constituido por un editor de texto para escribir el código, un área de mensajes, una consola de texto, una barra de herramientas con botones para las funciones comunes, y una serie de menús. Permite la conexión con el hardware de Arduino para cargar los programas y comunicarse con ellos.

Arduino utiliza para escribir el software lo que denomina "sketch" (programa). Estos programas son escritos en el editor de texto. Existe la posibilidad de cortar/pegar y buscar/remplazar texto. En el área de mensajes se muestra información mientras se cargan los programas y también muestra errores. La consola muestra el texto de salida para el entorno de Arduino incluyendo los mensajes de error completos y otras informaciones. La barra de herramientas permite verificar el proceso de carga, creación, apertura y guardado de programas, y la monitorización serie:

Nota: Debido a un error bug en Java, la barra de desplazamiento scroll no funciona en este menú; si necesita abrir un programa que no se vea en la lista, utilice File | Sketchbook en el menú.

Upload to I/O Board
Compila el código y lo vuelca en la placa E/S de Arduino. Ver Volcado más detalles abajo.

Encontrará otros comandos en los cinco menús: File, Edit, Sketch, Tools, Help. Los menús son sensibles al contexto, lo que significa que estarán disponibles sólo los elementos relevantes para la tarea que este realizando en ese momento.

• Copy for Discourse
  Copia el código de su sketch en el portapapeles para con el formato adecuado para publicarlo en un foro, incluyendo la sintaxis coloreada.

• Arduino Duemilanove o Nano w/ ATmega328
  Un ATmega328 trabajando a 16MHz con auto-reset. También usado para las versiones 16 MHz (5V) de los Arduino Pro o Pro Mini con ATmega328.

• Arduino Diecimila, Duemilanove, o Nano w/ ATmega168
  Un ATmega168 trabajando a 16MHz con auto-reset. En cuanto a la compilación y volcado es equivalente al Arduino NG o el más antiguo w/ATmega168, pero el "bootloader" tiene un timeout rápido (el LED en el pin 13 parpace sólo en el reset).También usa las versiones 16 MHz (5V) de los Arduino Pro y Pro Mini con ATmega168.

• LilyPad Arduino w/ ATmega168
  Un ATmega168 trabajando a 8MHz. En cuanto a la compilación y volcado es equivalente a Arduino Pro o Pro Mini (8MHz) w/ARmega168. El "bootloader", sin embargo, tiene un lento timeout (el LED 13 parpadea 3 veces y realiza el reset) debido a que la versión original del LilyPad no soporta auto-reset. Tampoco incluyen un reloj externo, por lo que el boottloader se ha cargado comfigurando los fuses del ATmega168 con el reloj interno de 8MHz.
  
  Si tenes una versión actual del LilyPad, (con un conector de programación de 6 pines) tendrás que seleccionar Arduino Pro o Pro Mini (8MHz) con ATmega168 antes de grabar el "bootloader"

La selección de placa tiene dos efectos: los parámetros (por ejemplo, CPU usada y velocidad (baud rate)) usados cuando compila y vuelcan los "sketches"; y el fichero y configuración de fuse utilizados por el gestor de arranque (bootloader)) al ser cargado. Algunas de las definiciones de las placas difieren sólo en lo segundo, incluso si has estado cargando satisfactoriamente con una particular selección podrías querer comprobarlo antes de grabar el "bootloader"

Pueden configurarse otras preferencias en el apartado preference (lo podrás encontrar bajo el menú Arduino para los Mac, o en File para Windows y Linux). El resto de opciones puede ser localizado en el fichero de preferencias, que se podrá encontrar dentro del mismo apartado preference.

Se puede también comunicar con la placa desde Processing, Flash, MaxMSP, etc (ver interfacing page (pagina de interfaces) para más detalles)

Se puede también comunicar con la placa desde Processing, Flash, MaxMSP, etc (ver interfacing page? (pagina de interfaces) para más detalles)

Muestra los datos enviados desde la placa Arduino (placa USB o serie). Para enviar datos a la placa, teclea el texto y pulsa el botón "send" o enter. Selecciona la velocidad (baud rate) en el menú desplegable que coincida con el configurado en Serial.begin dentro de tu "sketch". Advertir que en Mac o Linux, la placa Arduino se resetea (tu "sketch" es reiniciado desde el principio) cuando conectas con el monitor serie.

Se puede agregar soporte para hardware de terceros en el directorio hardware del directorio "sketchbook". Las plataformas instaladas aqúí pueden incluir la definición de las placas (que aparecen en el menú board), librerías del núcleo, "bootloaders", y definiciones de programador. Para instalarla, crea un directorio hardware, y en el descomprime la plataforma de terceros con su directorio. (No utilices "arduino" como nombre del subdirectorio o sobreescribirás la plataforma Arduino). Para desinstalarlo, simplemente borra ese directorio.

Para más detalles sobre la creación de paquetes de hardware de terceros visita Páginas de Plataformas en la web de Google Code developers.

Third-Party Hardware (Hardware de terceros)

Se puede agregar soporte para hardware de terceros en el directorio hardware del directorio "sketchbook". Las plataformas instaladas aqúí pueden incluir la definición de las placas (las cuales se publican en el menú de la placa), librerías del núcleo, "bootloaders", y definición de programador. Para instalarla, cree un directorio hardware, en el descomprima la plataforma a terceros en su directorio. (No utilice "arduino" como nombre del subdirectorio o sobreescribirá sobre la plataforma Arduino). Para desinstalarlo, simplemente borre este directorio.

Existe una Lista de librerías en las referencias. Algunas librerias estan incluidas en el software Arduino, otras pueden ser descargadas desde una gran variedad de fuentes. Para instalar estas librerías de terceros, crea un directorio denominado libraries en tu Directorio sketchbook. Después descomprime la librería allí. Por ejemplo, para instalar la librería Data Time, sus ficheros deberían estar en una subcarpeta /libraries/DateTime en tu carpeta de sketchbook.

Para escribir su propia librería, revisa este tutorial

Las librerías proporcionan funcionalidad extra para la utilización en "sketches", por ejemplo para trabajar con hardware o manipular datos. Para utilizar una librería en un "sketch", selecciona el menú Sketch > Import Library. Esto insertará una o más sentencias #include al principio del "sketch" y compilará la librería con tu "sketch". Debido a que las librerías se vuelcan a la placa junto con tu "sketch", incrementan la ocupación del espacio disponible. Si un "sketch" no precisa de una libreria, simplemente borra su sentencia #include en la parte inicial de tu código.

Cuando se vuelca un "sketch", estás utilizando el "bootloader" de Arduino, un pequeño programa que ha sido cargado en el microcontrolador en tu placa. Permite el volcado del código sin utilizar hardware adicional. El "bootloader" está activo durante unos pocos segundos cuando la placa es reseteada; después se incia el "sketch" que más recientemente se hubiera actualizado en el microcontrolador. El "bootloader" produce un parpadeo en el LED de la placa (pin 13) cuando se inicia (p.e. cuando las placas son reseteadas)

Una vez que has seleccionado el puerto serie y la placa, presiona el botón de volcado en la barra de harramientas o seleciona Upload to I/O Board desde el menú File. Las actuales placas de Arduino se resetearán automáticmamente y comenzará el volcado. Como las placas antiguas carecen de auto-reset, necesitarás presionar el botón de reset en la placa, justo antes de iniciar el volcado. En muchas placas verás el led RX y TX parpadeando cuando el "sketch" está actualizándose. El entorno de Arduino mostrará un mensaje cuando el volcado esté completado, o mostrará un error.

Antes de volcar tu "sketch", necesitas seleccionar los elementos correspondientes desde los menús Tools > Board y Tools > Serial Port. Las boards (placas) están descritas abajo. En los Mac, el puerto serie será probablemente algo como /dev/tty.usbserial-1B1 (para una placa USB), o /dev/tty.USA19QW1b1P1.1 (para una placa serie conectada con un adaptador Keyspan USB-to-Serial). En Windows, probablemente sea COM1 o COM2 (para una placa serie) o COM4, COM5, COM7, o superior (para una placa USB)- para encontrarlos, debes buscar los dispositivos serie USB en la sección de puertos del Administrador de Dispositivos de Windows. En Linux, debería ser /dev/ttyUSB0, /dev/ttyUSB1 o similar.

Permite manejar "sketches" con más de un fichero (cada uno de los cuales aparece en su pestaña). Pueden ser normalmente ficheros de código Arduino (no extensiones), ficheros C (extensiones .c), ficheros c++ (.cpp), o ficheros de cabecera (.h)

• Serial Port
  Este menú contiene todos los dispositivos serie (reales o virtuales) de tu equipo. Se refrescará automáticamente cada vez que abras el menú tools.

• Burn Bootloader
  Este elemento del menú te permite grabar un gestor de arranque (bootloader) dentro del microcontrolador de la placa Arduinio. Esto no es un requisito para un normal uso de la placa Arduino, pero es útil si compras un nuevo ATmega (el cual viene normalmente sin gestor de arranque). Asegurate de que has seleccionado la placa correcta en el menú Boards antes de grabar el bootloader. Cuando uses AVR ISP, tendrás que seleccionar en el menú Serial Port el puerto correspondiente.

Sketchbook (Librería de Sketch)

• Burn Bootloader
  Este elemento del menú te permite grabar un gestor de arranque (bootloader) dentro del microcontrolador de la placa Arduinio. Lo que no es un requisito para un normal uso de la placa Arduino, pero es útil si compras un nuevo ATmega (el cual viene normalmente sin placa). Asegura que has seleccionado la correcta placa desde el menú Boards antes de grabar el "bootloader". cuando uses un AVR ISP, necesitaras seleccionar el punto correspondiente de tu programa desde el menú Serial Port.

• Add File...
  Añade un fichero fuente al programa (se incluirá desde su ubicación actual). El fichero aparece en una nueva pestaña en la ventana del programa. Los ficheros pueden ser quitados del programa (sketch) utilizando el menú "tab".

• Auto Format
  Da formato al código proporcionando estética: por ejemplo realiza tabulaciones entre la apertura y cierre de llaves, y las sentencias que tengan que ser tabuladas lo estarán.

• Board
  Selecciona la placa que estás usuando. Ver más abajo Descripción de las placas.

• Serial Port
  Este menú contiene todos los dispositivos serie (reales o virtuales) de tu equipo. Se refrescará automáticamente cada vez que abras el menú "tools".

• Import Library
  Añade una librería a tu programa(sketch) insertando la sentencia #include en el código. Para más detalles ver Librerías más abajo.

• Show Sketch Folder
  Abre la carpeta de programas (sketch) en el escritorio.

• Add File...
  Añade un fichero fuente al programa (será copiada en la actual posición). El nuevo fichero aparece en una nueva etiqueta en la ventana de "sketch". Los ficheros pueden ser borrados desde el "sketch" utilizando el menú de etiquetas "tab".

• Copy for Discourse
  Copia el código de tu sketch en el portapapeles para con el formato adecuado para publicarlo en un foro, incluyendo la sintaxis coloreada.

• Copy as HTML
  Copia el código de un programa(sketch) al portapapeles en formato HTML, adecuándolo para incrustarlo en una página web.

• Verify/Compile
  Verifica los errores tu programa (sketch)

Upload to I/O Board
Compila el código y lo vuelca en la placa E/S de Arduino. Ver Volcado más abajo para más detalles.

Encontrarás otros comandos en los cinco menús: File, Edit, Sketch, Tools, Help. Los menús son sensibles al contexto, lo que significa que estarán disponibles sólo los elementos relevantes para la tarea que estemos realizando en ese momento.

• Copy for Discourse
  Copia el código de un sketch en el sitio justo del portapapeles para situarlo al lugar, completando la sintaxis coloreada.

• Copy as HTML
  Copia el código de un programa(sketch) al portapapeles como HTML, adecuándolo para incrustarlo en una página web.

Verify/Compile
Chequea el código en busca de errores.

Stop
Finaliza la monitorización serie y oculta otros botones

New
Crea un nuevo sketch.

Open
Presenta un menú de todos los programas sketch de tu "sketchbook", (librería de sketch) . Un click sobre uno de ellos lo abrirá en la ventana actual.

Nota: Debido a un error bug en Java, la barra de desplazamiento scroll no funciona en este menú; si necesitas abrir un programa que no se vea en la lista, utiliza File | Sketchbook en el menú.

Save
Salva el programa sketch.

• Arduino Diecimila, Duemilanove, or Nano w/ ATmega168
  Un ATmega168 trabajando a 16MHz con auto-reset. En cuanto a la compilación y volcado es equivalente al Arduino NG o el más antiguo w/ATmega168, pero el "bootloader" tiene un timeout rápido (el LED en el pin 13 parpace sólo en el reset).También usa las versiones 16 MHz (5V) de los Arduino Pro y Pro Mini con ATmega168.

• Arduino NG or older w/ ATmega168
  Un ATmega168 trabajando 16MHz sin auto-reset. En cuanto a la Compilación y volcado es equivalente al Arduino Diecimila o Duemilanove w/ATmega168, pero el grabado del "bootloader" es más lento (el LED 13 parpadea 3 veces y realiza el reset)

• Arduino NG or older w/ ATmega8
  Un ATmega8 trabajando en 16MHz sin auto-reset

• Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega168
  Un ATmega168 trabajando a 8 MHz (3.3V) con auto-reset.

• Arduino NG or older w/ ATmega168
  Un ATmega168 trabajando 16MHz sin auto-reset. En cuanto a la Compilación 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 Duemilanove or Nano w/ ATmega328
  Un ATmega328 trabajando a 16MHz con auto-reset. También usado para las versiones 16 MHz (5V) de los Arduino Pro o Pro Mini con ATmega328.

• Arduino Diecimila, Duemilanove, or Nano w/ ATmega168
  Un ATmega168 trabajando a 16MHz con auto-reset. En cuanto a la compilación y volcado es equivalente al Arduino NG o el más antiguo w/ATmega168, pero el "bootloader" tiene un timeout rápido (un LED en el pin 13 parpace sólo en el reset).También usa las versiones 16 MHz (5V) de los Arduino Pro y Pro Mini con ATmega168.

• Arduino Mega
  Un ATmega1280 trabajando a 16MHz con auto-reset.

• Arduino Mini
  Equivalente al Ardunio NG o el más antiguo w/ATmega168 (por ejemplo un ATmega168 trabajando a 16MHz sin auto-reset)

• Arduino BT
  ATmega168 trabajando a 16MHz. El bootloader incluye codigo para iniciar el módulo bluetooth de la placa.

• LilyPad Arduino w/ ATmega328
  Un ATmega328 trabajando a 8MHz (3.3V) con autor-reset. Equivalente al Arduino Pro o Pro Mini (3.3V 8 MHz) w/ATmega328.

• LilyPad Arduino w/ ATmega168
  Un ATmega168 trabajando a 8MHz. En cuanto a la compilación y volcado es equivalente a Arduino Pro o Pro Mini (8MHz) w/ARmega168. El "bootloader", sin embargo, tiene un lento timeout (el LED 13 parpadea 3 veces y realiza el reset) debido a que la versión original del LylePad no soporta auto-reset. Ellas tampoco incluyen un relot externo, por el comando de grabación del "bootloadar" se fusiona con el reloj interno de 8MHz del ATmega168
  
  Si tenes una versión actual del LilyPad, (w/ una cabecera de programación con 6-pin) tendrás que seleccionar Arduino Pro o Pro Mini (8MHz) w/ ATmega168 antes de grabar el "bootloader"

• Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328
  Un ATmega328 trabajando a 8MHz (3.3V) con auto-reset. Equivalente a LilyPad Arduino w/ ATmega328.

Algunas preferencias pueden ser configuradas en el apartado preference (lo podrá encontrar bajo el menú Arduino para los Mac, o en File para Windows y Linux). El resto de opciones puede ser localizado en el fichero de preferencias, que lo podrá encontrar dentro del mismo apartado preference.

Boards (Placas)

La selección de placa tiene dos efectos: los parámetros (por ejemplo, CPU usada y velocidad (baud rate)) usados cuando compila y vuelca los "sketches"; y el fichero y parámetros fusionados utilizados para el comando de grabado en el "bootloader". Algunas de las definiciones para las placas difieren sólo en la parte final , incluso si ha cargado satisfactoriamente con una particular selección podría chequearlo antes de grabarlo en el "bootloader"

Se puede también comunicarse con la placa desde Processing, Flash, MaxMSP, etc (ver interfacing page (pagina de interfaces) para más detalles)

Preferences (Preferencias)

Para más detalles sobre la creación de paquetes de hardware de terceros vea Páginas de Plataformas en la web de Google Code developers.

Se muestran los datos series que son enviados desde la placa Arduino (USB o placa serie). Para enviar datos a la placa, introduzca el texto y pulsar en el botón "send" o enter. Eleja la velocidad (baud rate) del menú desplegable que coincida con el rango configurado en Serial.begin dentro de su "sketch". Advertir que en Mac o Linux, la placa Arduino se resetea (su "sketch" es rearrancado desde el principio) cuando conectas con el monitor serie.

Se puede también comunicarse con la placa desde Processing, Flash, MaxMSP, etc (ver [[http://www.arduino.cc/playground/Main/Interfacing | interfacing page] (pagina de interfaces) para más detalles)

For details on creating packages for third-party hardware, see the platforms page en la Google Code developers site.

Serial Monitor (Monitor Serie)

Soportado para hardware de terceros puede ser añadido al directorio hardware de su directorio de "sketchbook" Las plataformas instaladas allí podrían incluir la definición de las placas (las cuales se publican en el menú de la placa), librerías del núcleo, "bootloaders", y definición de programador. Para instalarla, cree un directorio hardware, en el descomprima la plataforma a terceros en su directorio. (No utilice "arduino" como nombre del subdirectorio o sobreescribirá sobre la plataforma Arduino). Para desinstalarlo, simplemente borre este directorio.

Para más detalles sobre la creación de paquetes de hardware de terceros vea platforms page en la Google Code developers site.

Para escribir su propia librería, vea este tutorial

Third-Party Hardware (Software de terceros)

Soportado para hardware de terceros puede ser añadido al directorio hardware de su directorio de "sketchbook" Las plataformas instaladas allí podrían incluir la definción de las placas (las cuales

Exista una Lista de librerías en las referencias. Algunas librerias son incluidas con el software Arduino, Otras pueden ser descargadas desde una gran variedad de fuentes. Para instalar estas librerías de terceros, cree un directorio denominado libraries sobre su Directorio sketchbook. Después descomprima la librería allí. Por ejemplo, para instalar la librería Data Time, sus ficheros deberían estar en una subcarpeta /libraries/DateTime en su carpeta de sketchbook.

Para escribir su propia librería, vea this tutorial

Exista una Lista de librerías en las referencias. Algunas librerias son incluidas con el software Arduino, Otras pueden ser descargadas desde una gran variedad de fuentes. Para instalar estas librerías de terceros, cree un directorio denominado libraries sobre su Directorio sketchbook. Después descomprima la librería allí. Por ejemplo, para instalar la librería Data Time, sus ficheros deberían estar en una subcarpeta /libraries/DataTime en tu carpeta de sketchbook.

Las librerías proporcionan funcionalidad extra para la utilización en "sketches", por ejemplo para trabajar con hardware o manejo de datos. Para utilizar una librería en un "sketch", seleccione el menú Sketch > Import Library. Esto insertará uno o más instancias #include al principio del "sketch" y compilará la libraría con su "sketch". Debido a que las librerías son volcadas a la placa con su "sketch", incrementan la ocupación del espacio disponible. Si un "sketch" no precisa de una libreria, simplemente borre su instancia #include desde la parte inicial de su código.

Cuando se vuelca un "sketch", utilizando el Arduino "bootloader", un pequeño programa que ha sido cargado en el microcontrolador en tu placa. Permite el volcado del código sin utilizar un hardware adicional. El "bootloader" está activo durante unos pocos segundos cuando la placa es reseteada; entonces se incia el "sketch" que más recientemente se hubiera actualizado en el microcontrolador. El "bootloader" produce un parpadeo en el LED de la placa (pin 13) cuando se inicia (p.e. cuando las placas son reseteadas)

Libraries (Librerías)

Una vez que ha seleccionado el puerto serie y la placa, presione el botón de volcado en la barra de harramientas o selecione Upload to I/O Board desde el menú File. Las actuales placas de Arduino se resetearán automáticmamente y comienza el volcado. Como las placas antiguas carecen de auto-reset, necesitará presionar el botón de reset en la placa, justo antes de iniciar el volcado. En muchas placas verá el led RX y TX parpadeando cuando el "sketch" está actualizándose. El entorno de Arduino mostrará un mensaje cuando el volcado esté completado, o mostrará un error

Las boards (placas) son descritas abajo. En los Mac, el puerto serie es probablemente algo como /dev/tty.usbserial-1B1 (para una placa USB), o /dev/tty.USA19QW1b1P1.1 (para una placa serie conectada con un adaptador Keyspan USB-to-Serial). En Windows, probablemente sea COM1 o COM2 (para una placa serie) o COM4, COM5, COM7, o superior (para una placa USB)- para encontrarlos, debes buscar en la sección los dispositivos serie USB en la sección de puertos del Administrador de Dispositivos de Windows. En Linux, debería ser /dev/ttyUSB0, /dev/ttyUSB1 o similar.

Upload to I/O Board
Compila tu código y lo vuelca en la placa E/S de Arduino. Ver Volcado abajo para más detalles.

El entorno de Desarrollo Arduino contiene un editor de texto para escribir el código, un área de mensajes, una consola de texto, una barra de herramientas con botones para las funciones comunes, y una serie de menús. Conecta con el hardware de Arduino para cargar los programas y comunicarse con ellos.

Arduino utiliza para escribir el software lo que denomina "sketch" (programa). Estos programas son escritos en el editor de texto. Tiene las capacidades para cortar/pegar y buscar/remplazar texto. En el área de mensajes se muestra información mientras se cargan los programas y también muestra errores. La consola muestra el texto de salida para el entorno de Arduino incluyendo los mensajes de error completos y otras informaciones. La barra de herramientas permite verificar el proceso de carga, creación, apertura y guardado de programas, y abrir el monitor serie:

Verify/Compile
Chequea tu código en busca de errores.

Open
Presenta un menú de todos los programas "sketch" de tu "sketchbook", (librería de sketch) . Un click sobre él lo abrirá en la ventana actual.

Nota: Debido a un error "bug" en Java, la barra de desplazamiento "scroll" no funciona en este menú; si necesitas abrir un programa que no se vea en la lista, utiliza File | Sketchbook en el menú.

Tabs, Multiple Files, and Compilation (Pestañas, Ficheros múltiples y compilación)

Permite manejar "sketches" con más de un fichero (cada uno de los cuales aparece en su pestaña). Puede ser normalmente ficheros de código Arduino (no extensiones), ficheros C (extensiones .c), ficheros c++ (.cpp), o ficheros de cabecera (.h)

Uploading (Volcado)

Antes de volcar tu "sketch", necesitas seleccionarlo desde los menús Tools > Board y Tools > Serial Port. Las boards (placas) son descritas abajo. En los Mac, el puerto serie es probablemente algo como /dev/tty.usbserial-1B1 (para una placa USB), o /dev/tty.USA19QW1b1P1.1 (para una placa serie conectada con un adaptador Keyspan USB-to-Serial). En Windows, probablemente sea COM1 o COM2 (para una placa serie) o COM4, COM5, COM7, o superior (para una placa USB)- para encontrarlos, debes buscar en la sección los dispositivos series USB

Sketchbook (Librería de "Sketch")

El entorno de Arduino incluye el concepto de "sketchbook": que es un lugar estándar para el almacenamiento de tus programas (o "sketch"). Los "sketches" dentro de tu "sketchbook" pueden abrirse desde el menú File > Sketchbook o desde el botón de la barra de herramientas Open. La primera vez que arrancas el software Arduino, se creará un directorio para tu "sketchbook". Puedes visualizarlo o cambiarlo de localización dentro de "sketchbook location" desde el apartado Preferences

• Burn Bootloader
  Este elemento del menú permite grabar unrn a bootloader dentro del microcontrolador de la placa Arduinio. Lo que no es un requisito para un normal uso de la placa Arduino, pero es útil si compras un nuevo ATmega (el cual viene normalmente sin placa). Asegura que has seleccionado la correcta placa desde el menú Boards antes de grabar el "bootloader". cuando uses un AVR ISP, necesitaras seleccionar el punto correspondiente de tu programa desde el menú Serial Port.

Serial Monitor
Inicia la monitorización serie Monitorización Serie.

• Serial Port
  Este menú contiene todos los dispositivos serie (reales o virtuales) en tu equipo. Se refrescará automáticamente cada vez que abras el nivel alto del menú de herramientas.

Save
Salva tu "sketch".

Upload to I/O Board
Compila tu código y lo vuelca en la placa I/O de Arduino. Ver Volcado abajo para más detalles.

Serial Monitor
Inicia la monitorización serie serial monitor.

• Import Library
  Añade una librería a tu boceto (sketch) para insertar estamentos #include como código para tu código. Para más detalles ver abajo Librerías .

• Show Sketch Folder
  Abre la carpeta de "sketch" en el escritorio.

• Board
  Selecciona la placa que tu estás usuando. Ver más abajo Descripción de las placas.

Arduino utiliza para escribir el software lo que denomina "sketch". Estos bocetos son escritos en un editor de texto. Tiene la característica para cortar/pegar y buscar/remplazar texto. Esta área de mensajes da realimentación mientras exporta y también muestra errores. La consola muestra el texto de salida para el entorno de Arduino incluido los mensajes de error completos y otra información. La barra de herramientas permite verificar el proceso de carga, creación, apertura y guardado de bocetos, y abrir el monitor serie:

New
Crea un nuevo "sketch".

Open
Presenta un menú de todos los bocetos "sketch" de tu "sketchbook", librería de sketch . Un click sobre él lo abrirá en la ventana actual.

Nota: Debido a un error "bug" en Java, la barra de desplazamiento "scroll" no funciona en este menú; is necesitas abrir un boceto más tarde en la lista, utilizar File | Sketchbook en el menú.

• Copy for Discourse
  Copia el código de un "sketch" en el sitio justo del portapapeles para situarlo al lugar, completando la sintaxis coloreada.

• Add File...
  Añade un fichero fuente al "sketch" (será copiada desde su actual ubicación). El nuevo fichero aparece en una nueva etiqueta en la ventana de "sketch". Los ficheros pueden ser borrados desde el "sketch" utilizando el menú de etiquetas "tab".

• Auto Format
  Esto formatea tu código amablemente: por ejemplo realiza tabulaciones abriendo o cerrando las líneas, y que las instancias que tengan que ser tabuladas lo estén.

• Add File...
  Añade un fichero fuente a el boceto (sketch) (será copiada desde su actual ubicación). El nuevo fichero aparece en una nueva etiqueta en la ventana de bocetos (sketch). Los ficheros pueden ser borrados desde el boceto (sketch) utilizando el menú de etiquetas (tab).

• Auto Format
  Esto formatea tu código amablemente: por ejemplo lo tabula

 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.

Serial Monitor
Abre la monitorización serie serial monitor.

• Import Library
  Añade una librería a tu boceto (sketch) para insertar estamentos #include como código para tu código. Para más detalles ver abajo libraries .

• Show Sketch Folder
  Abre la carpeta de bocetos (sketch) en el escritorio.

• Add File...
  añade un fichero fuente a el boceto (sketch) (será copiada desde su actual ubicación). El nuevo fichero aparece en una nueva etiqueta en la ventana de bocetos (sketch). Los ficheros pueden ser borrados desde el boceto (sketch) utilizando el menú de etiquetas (tab).

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.

• Copy as HTML
  Copia el código de un boceto (sketch) al portapapeles como HTML, adecuándolo para incrustarlo en una página web.

• Verify/Compile
  Verifica de errores tu boceto (sketch)

• Import Library
  Añade una librería a tu boceto (sketch) para insertar estamentos #include como código para tu código. Para más detalles ver abajolibraries .

• Copy for Discourse
  Copia el código de un boceto (sketch) en el sitio justo del portapapeles para situarlo al lugar, completando la sintaxis coloreada.

• Copy as HTML
  Copia el código de un boceto (sketch) al portapapeles como HTML, adecuándolo para incrustarlo en una página WEB.

Copies the code of your sketch to the clipboard as HTML, suitable for embedding in web pages.

• Copy for Discourse
  Copia el código de un boceto (sketch) en el sitio justo del porta papeles para situarlo al lugar, completando la sintaxis coloreada.

Upload to I/O Board
Compila tu código y lo carga en la placa I/O de Arduino. Ver uploading abajo para más detalles.

Otros comandos son encontrados sobre los cinco menús: File, Edit, Sketch, Tools, Help. Los menús son sensibles al contexto, lo que significa que sólo los elementos relevantes funcionan cuando estos deben estar disponibles.

• Copy for Discourse
  Copia el código de un boceto (sketch) al portapapeles

Copies the code of your sketch to the clipboard in a forum suitable for posting to the forum, complete with syntax coloring.

El entorno de Desarrollo Arduino contiene un editor de texto para escribir el código, un área de mensajes, una consola de texto, una barra de herramientas con botones para las funciones comunes, y una serie de menús. Conecta el hardware de Arduino para cargar los programas y comunicarse con ellos.

Arduino utiliza para escribir el software lo que denomina bocetos (sketch). Estos bocetos son escritos en un editor de texto. Tiene la característica para cortar/pegar y buscar/remplazar texto. Esta área de mensajes da realimentación mientras exporta y también muestra errores. La consola muestra el texto de salida para el entorno de Arduino incluido los mensajes de error completos y otra información. La barra de herramientas permite verificar el proceso de carga, creación, apertura y guardado de bocetos, y abrir el monitor serie:

Verify/Compile
Chequeo tu código en busca de errores.

Stop
Finaliza monitorización serie y oculta otros botones

New
Crea un nuevo boceto (sketch).

Open
Presenta un menú de todos los bocetos (sketchs) de tu libro de bocetos (sketchbook). Un click sobre él lo abrirá en la ventana actual.

Nota: Debido a un error (bug) en Java, la barra de desplazamiento (scroll) no funciona en este menú; is necesitas abrir un boceto más tarde en la lista, utilizar File | Sketchbook en el menú.

Save
Salva tu boceto (sketch).

Upload to I/O Board
Compila tu codigo y lo carga en la placa I/O de Arduino. Ver uploading abajo para más detalles.

Entorno de Desarrollo para Arduino

El entorno de desarrollo Arduino contiene un editor de texto para escribir el código, un área de mensajes, una consola de texto, una barra de herramientas con botones para las funciones comunes, y una serie de menús. Conecta el hardware de Arduino para cargar los programas y comunicarse con ellos.

Arduino utiliza para escribir el software lo que denomina bocetos. Estos bocetos son escritos en un editor de texto. Tiene la característica para cortar/pegar y buscar/remplazar texto. Esta área de mensajes da realimentación mientras exporta y también muestra errores. La consola muestra el texto de salida para el entorno de Arduino incluido los mensajes de error completos y otra información. La barra de herramientas permite verificar el proceso de carga, creación, apertura y guardado de bocetos, y abrir el monitor serie:

To write your own library, see this tutorial.

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.

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 platforms page on the Google Code developers site.

Upload to I/O Board
Compiles your code and uploads it to the Arduino I/O board. See uploading below for details.

Tabs, Multiple Files, and Compilation

Before uploading your sketch, you need to select the correct items from the Tools > Board and Tools > Serial Port menus. The 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 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 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 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.

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

Arduino Development Environment

Serial Monitor
Opens the serial monitor.

Uploading

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 interfacing page for details).

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.

Boards

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.

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.

(:table width=100%:)

(:cellnr width=40:)

(:cell:)

Verify/Compile
Checks your code for errors.

(:cellnr:)

(:cell:)

Stop
Stops the serial monitor, or unhighlight other buttons.

(:cellnr:)

(:cell:)

New
Creates a new sketch.

(:cellnr:)

(:cell:)

Open
Presents a menu of all the sketches in your sketchbook. Clicking one will open it within the current window.

(:cellnr:)

(:cell:)

Save
Saves your sketch.

(:cellnr:)

(: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:)

(: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.

(:tableend:)

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

• Verify/Compile
  Checks your sketch for errors.

• Import Library
  Adds a library to your sketch by inserting #include statements at the code of your code. For more details, see libraries below.

• Show Sketch Folder
  Opens the sketch folder on the desktop.

• Add File...
  Adds a source 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.

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

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:

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.

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

There is a 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 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.

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

Adds a library to your sketch by inserting #include statements at the code of your code. For more details, see libraries below.

Adds a library to your sketch by inserting #include statements at the code of your code. For more details, see below.

(:tableend:)

(: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.

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.

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.

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.

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

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.

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.

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.

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.

The items in this menu allow you to burn a bootloader onto the microcontroller on an Arduino board. This is not required for normal use of an Arduino board but is useful if you purchase a new ATmega (which normally come without a bootloader). Ensure that 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.

Arduino Duemilanove or Nano w/ ATmega328

Arduino Diecimila, Duemilanove, or Nano w/ ATmega168

Copy as HTML

Copies the code of your sketch to the clipboard as HTML, suitable for embedding in web pages.

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

(: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

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.

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.

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

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.

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

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:)

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.

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.

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 preference files.

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

Tab Menu

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.

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.

Show Sketch Folder

Add File...

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

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 description of the build process for details of how these are handled.

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.

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 preference files.

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

Uses a library in your sketch. Works by adding #includes 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 #includes from the top of your sketch. For more details, see the page on Libraries.

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.

The items in this menu allow you to burn a 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 parallel programmer.

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.

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 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 bootloader page.

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 bootloader page.

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.

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.

Uses a library in your sketch. Works by adding #includes 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 #includes from the top of your sketch. For more details, see the page on libraries.

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.

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

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.txt file.

Introduction to the Arduino Environment

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

Toolbar

Verify/Compile

Checks your code for errors.

Stop

Stops the serial monitor, or unhighlight other buttons.

New

Creates a new sketch.

Open

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

Saves your sketch.

Upload to I/O Board

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

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 (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 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 #includes 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 #includes 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 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.txt file?.