Guide.Environment History

Hide minor edits - Show changes to markup

September 01, 2015, at 03:08 PM by Arturo -
Changed line 160 from:
  • Upload Using Programmer
    This will overwrite the bootloader on the board; you will need to use Tools > Burn Bootloader to restore it and be able to Upload to USB serial port again. However, it allows you to use the full capacity of the Flash memory for your sketch.
to:
  • Upload Using Programmer
    This will overwrite the bootloader on the board; you will need to use Tools > Burn Bootloader to restore it and be able to Upload to USB serial port again. However, it allows you to use the full capacity of the Flash memory for your sketch. Please note that this command will NOT burn the fuses. To do so a Tools -> Burn Bootloader command must be executed.
Changed lines 176-178 from:
  • 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 or Genuino 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 on the target board.

to:
  • 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 or Genuino 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 on the target board. This command also set the right fuses.

August 20, 2015, at 12:34 PM by Alice Pintus -
Changed line 16 from:
     English (英语)
to:
     English
Changed line 20 from:
      <li class="selected">English (英语)</li>
to:
      <li class="selected">English </li>
Changed line 48 from:
      <li><a href="?setlang=en">English (英语)</a></li>
to:
      <li><a href="?setlang=en">英语 (English)</a></li>
Added line 59:

Arduino Software (IDE)

Changed lines 61-62 from:

Arduino Software (IDE)

to:
August 10, 2015, at 01:50 PM by Simone Maiocchi -
Changed lines 444-445 from:
  • 修正编码及重载
    修正了编辑字符与其他系统字符间可能存在的差异。
to:
  • 编码修正及重载
    修正了编辑字符与其他系统字符间可能存在的差异。
Changed lines 448-449 from:
to:
Changed lines 524-525 from:

控制板

to:

Changed line 566 from:
to:
August 10, 2015, at 11:41 AM by Simone Maiocchi -
Changed lines 302-309 from:

Arduino集成开发环境(或是Arduino IDE)包含了一个用于写代码的文本编辑器、一个消息区、一个文本控制台以及一个带有常用功能按钮和文本菜单的工具栏。软件连接Arduino和Genuino之后,能给所连接的控制板烧写程序,还能与控制板相互通信。

写草稿

使用Arduino软件(IDE)编写的代码被称为草稿(sketches),这些草稿写在文本编辑器中,以.ino的文件形式保存,软件中的文本编辑器有剪切/粘贴和搜索/替换功能。当保存、输出以及出现错误时消息区会显示反馈信息。控制台会文字形式显示Arduino软件(IDE)的输出信息,包括完整的错误信息以及其他消息。整个窗口的右下角会显示当前选定的控制板和串口信息。工具栏按钮包含校验、下载程序、新建、打开、保存以及串口监视窗的功能。

注意:Arduino软件(IDE)1.0之前的版本中草稿的保存格式为.pde,你能够用1.0版本的软件打开这些文件,软件会提示你将这些草稿保存为.ino的形式。

to:

Arduino集成开发环境(或是Arduino IDE)包含了一个用于写代码的文本编辑器、一个消息区、一个文本控制台以及一个带有常用功能按钮和文本菜单的工具栏。软件连接Arduino和Genuino之后,能给所连接的控制板上传程序,还能与控制板相互通信。

写项目

使用Arduino软件(IDE)编写的代码被称为项目(sketches),这些项目写在文本编辑器中,以.ino的文件形式保存,软件中的文本编辑器有剪切/粘贴和搜索/替换功能。当保存、输出以及出现错误时消息区会显示反馈信息。控制台会文字形式显示Arduino软件(IDE)的输出信息,包括完整的错误信息以及其他消息。整个窗口的右下角会显示当前选定的控制板和串口信息。工具栏按钮包含验证、下载程序、新建、打开、保存以及串口监视器的功能。

注意:Arduino软件(IDE)1.0之前的版本中项目的保存格式为.pde,你能够用1.0版本的软件打开这些文件,软件会提示你将这些项目保存为.ino的形式。

Changed lines 318-319 from:

校验
检查代码编译时的错误

to:

验证
检查代码编译时的错误

Changed lines 326-329 from:

烧写
编译你的代码并且烧写到选定的控制板中,细节请查看后面的 烧写 内容

注意:如果你使用的是专门的编程器,你需要在点击按钮时按住电脑的“shift”键,显示的文字会变成“使用编程器烧写”。

to:

上传
编译你的代码并且上传到选定的控制板中,细节请查看后面的 上传 内容

注意:如果你使用的是专门的编程器,你需要在点击按钮时按住电脑的“shift”键,显示的文字会变成“使用编程器上传”。

Changed lines 336-337 from:

新建
创建一个新的草稿。

to:

新建
创建一个新的项目。

Changed lines 344-348 from:

打开
弹出一个包含你在项目文件夹中所有草稿的菜单,选择其中一个会打开相应的代码,新的草稿会覆盖当前的草稿。

注意:因为Java中的一个问题,所以这个菜单不会滚动,如果你需要打开的草稿在列表的最后,那么需要通过菜单中的文件|项目文件夹来选择。

to:

打开
弹出一个包含你在项目文件夹中所有项目的菜单,选择其中一个会打开相应的代码,新的项目会覆盖当前的项目。

注意:因为Java中的一个问题,所以这个菜单不会滚动,如果你需要打开的项目在列表的最后,那么需要通过菜单中的文件|项目文件夹来选择。

Changed lines 355-356 from:

保存
保存你的草稿。

to:

保存
保存你的项目。

Changed lines 364-365 from:

串口监视窗
打开串口监视窗。

to:

串口监视器
打开串口监视器。

Changed lines 368-369 from:

其他命令我们能够在文本菜单中找到,文本菜单包含五个部分文件编辑草稿工具帮助。这些菜单是与你执行的操作与内容有关的,所以只有那些与当前操作有关的菜单才能使用。

to:

其他命令我们能够在文本菜单中找到,文本菜单包含五个部分文件编辑项目工具帮助。这些菜单是与你执行的操作与内容有关的,所以只有那些与当前操作有关的菜单才能使用。

Changed lines 372-378 from:
  • 新建
    创建一个新的草稿,草稿中已经自动完成了一段Arduino程序的最小结构。
  • 打开
    允许通过计算机的文件管理器打开一个指定的草稿。

  • 最近打开的
    提供一个最近打开过的草稿的列表,可以通过选择打开其中一个。

  • 项目文件夹
    显示目前项目文件夹中的草稿,选择其中一个会在新的窗口中打开相应的代码。
to:
  • 新建
    创建一个新的项目,项目中已经自动完成了一段Arduino程序的最小结构。
  • 打开
    允许通过计算机的文件管理器打开一个指定的项目。

  • Open Recent
    提供一个最近打开过的项目的列表,可以通过选择打开其中一个。

  • 项目文件夹
    显示目前项目文件夹中的项目,选择其中一个会在新的窗口中打开相应的代码。
Changed lines 383-386 from:
  • 保存
    用当前的名字保存草稿,如果文件还没有命名,则会弹出“另存为”窗口要求输入一个名字。

  • 另存为
    允许用另一个名字保存当前的草稿。
to:
  • 保存
    用当前的名字保存项目,如果文件还没有命名,则会弹出“另存为”窗口要求输入一个名字。

  • 另存为
    允许用另一个名字保存当前的项目。
Changed lines 389-390 from:
  • 打印
    按照页面设置中的设定发送当前的草稿给打印机。
to:
  • 打印
    按照页面设置中的设定发送当前的项目给打印机。
Changed lines 393-394 from:
  • 退出
    关闭所有IDE窗口,当下次打开IDE的时候会自动打开同样的草稿。
to:
  • 退出
    关闭所有IDE窗口,当下次打开IDE的时候会自动打开同样的项目。
Changed lines 397-398 from:
  • 撤销/重做
    撤销你在编辑区的一步或多步操作;当你撤销之后,可以通过重做再执行一遍相应的操作。
to:
  • 撤销
    撤销你在编辑区的一步或多步操作。
  • 重做
    当你撤销之后,可以通过重做再执行一遍相应的操作。
Changed lines 403-406 from:
  • 复制到论坛
    复制草稿中的代码放置在剪切板中,复制的内容包括完整的语法颜色提示,适合粘贴到论坛中。

  • 以HTML形式复制
    以HTML形式复制草稿中的代码放置在剪切板中,适合将代码嵌入到网页中。
to:
  • 复制到论坛
    复制项目中的代码放置在剪切板中,复制的内容包括完整的语法颜色提示,适合粘贴到论坛中。

  • 复制为HTML格式
    以HTML形式复制项目中的代码放置在剪切板中,适合将代码嵌入到网页中。
Changed lines 413-416 from:
  • 缩进/取消缩进
    在选中行的开头增加或取消一段缩进的位置,文本内容会相应的向右或向左移动。

  • 查找
    会打开查找和替换窗口,在这个小窗口内你可以根据几个选项在当前的草稿中查找特定的文字。
to:
  • 增加缩进
    在选中行的开头增加一段缩进的位置,文本内容会相应的向右移动。
  • 减少缩进
    在选中行的开头减少一段缩进的位置,文本内容会相应的向左移动。
  • 查找
    会打开查找和替换窗口,在这个小窗口内你可以根据几个选项在当前的项目中查找特定的文字。
Changed lines 421-437 from:

草稿

  • 校验/编译
    检查你代码中编译的错误,代码和变量使用存储区的情况会显示在控制台。

  • 烧写
    编译并通过设定的串口烧写二进制到选定的控制板当中。

  • 使用编程器烧写
    这将覆盖控制板中的引导程序;你需要使用 工具>烧写引导程序 来恢复控制板,这样下次才能再通过USB串口烧写程序。不过这种形式允许你的草稿使用芯片的全部存储区。

  • Export Compiled Binary (导出编译的二进制代码)
    保存一个.hex文件作为存档或是用其他工具给控制板烧写程序。

  • 显示草稿文件夹
    打开当前草稿所在的文件夹。

  • Include Library (导入库)
    在代码开头通过#include 的形式添加一个库文件到你的草稿当中,更多细节请参考库当中的内容,另外,通过这个菜单项你能够访问库管理器,并且能够从.zip文件中导入新库。

  • 添加文件
    添加源文件到草稿中(会从当前位置复制过来)。新的文件会出现在草稿窗口中的新选项卡中。可以通过小三角形图标的选项卡菜单命令来删除文件,选项卡菜单位于串口监视窗按钮的下方。

to:

项目

  • 验证/编译
    检查你代码中编译的错误,代码和变量使用存储区的情况会显示在控制台。

  • 上传
    编译并通过设定的串口上传二进制到选定的控制板当中。

  • 使用编程器上传
    这将覆盖控制板中的引导程序;你需要使用 工具>上传引导程序 来恢复控制板,这样下次才能再通过USB串口上传程序。不过这种形式允许你的项目使用芯片的全部存储区。

  • Export Compiled Binary (导出编译的二进制代码)
    保存一个.hex文件作为存档或是用其他工具给控制板上传程序。

  • 显示项目文件夹
    打开当前项目所在的文件夹。

  • Include Library (导入库)
    在代码开头通过#include 的形式添加一个库文件到你的项目当中,更多细节请参考库当中的内容,另外,通过这个菜单项你能够访问库管理器,并且能够从.zip文件中导入新库。

  • 添加文件
    添加源文件到项目中(会从当前位置复制过来)。新的文件会出现在项目窗口中的新选项卡中。可以通过小三角形图标的选项卡菜单命令来删除文件,选项卡菜单位于串口监视器按钮的下方。

Changed lines 442-443 from:
  • 草稿存档
    将当前的草稿以.zip形式存档,存档文件放在草稿所在的目录下。
to:
  • 项目存档
    将当前的项目以.zip形式存档,存档文件放在项目所在的目录下。
Changed lines 446-447 from:
  • 串口监视窗
    打开串口监视窗口,通过当前选定的串口查看与控制板之间交互的数据。通常这个操作会重启控制器,如果当前控制板支持打开串口复位的话。
to:
  • 串口监视器
    打开串口监视器口,通过当前选定的串口查看与控制板之间交互的数据。通常这个操作会重启控制器,如果当前控制板支持打开串口复位的话。
Changed lines 452-455 from:
  • 编程器
    当我们不是通过USB转串口的连接方式给控制板或芯片烧写程序的时候就需要通过这个菜单选择硬件的编程器。一般你不需要使用这个功能,除非你要为一个新的控制器烧写引导程序。

  • 烧写引导程序
    这个菜单项允许你给Arduino上的微控制器烧写引导程序,如果你是正常使用Arduino或是Genuino控制板这个菜单项不是必须的,不过如果你购买了一个新的ATmega微控制器的话(通常都不包含引导程序),那么这个菜单项非常有用。在为目标板烧写引导程序时要确保你从“控制板”菜单中选择了正确的控制板。
to:
  • 编程器
    当我们不是通过USB转串口的连接方式给控制板或芯片上传程序的时候就需要通过这个菜单选择硬件的编程器。一般你不需要使用这个功能,除非你要为一个新的控制器上传引导程序。

  • 上传引导程序
    这个菜单项允许你给Arduino上的微控制器上传引导程序,如果你是正常使用Arduino或是Genuino控制板这个菜单项不是必须的,不过如果你购买了一个新的ATmega微控制器的话(通常都不包含引导程序),那么这个菜单项非常有用。在为目标板上传引导程序时要确保你从“控制板”菜单中选择了正确的控制板。
Changed lines 464-466 from:

Arduino软件(IDE)采用项目的方式对草稿进行管理:所有的代码(或草图)存在一个统一的位置,可以通过菜单文件>项目文件夹或是工具栏中的打开按钮从项目文件夹中打开一个草稿。当你第一次运行Arduino软件的时候会自动创建一个项目文件夹,你可以通过“首选项”的对话框来改变项目文件夹的位置。

to:

Arduino软件(IDE)采用项目的方式对项目进行管理:所有的代码(或草图)存在一个统一的位置,可以通过菜单文件>项目文件夹或是工具栏中的打开按钮从项目文件夹中打开一个项目。当你第一次运行Arduino软件的时候会自动创建一个项目文件夹,你可以通过“首选项”的对话框来改变项目文件夹的位置。

Changed lines 472-473 from:

允许你在草稿中使用多个文件(每一个文件有一个自己的选项卡),这些文件可以是正常的Arduino代码文件(扩展名不可见),也可以是C文件(扩展名.c)、C++文件(.cpp)或是头文件(.h)。

to:

允许你在项目中使用多个文件(每一个文件有一个自己的选项卡),这些文件可以是正常的Arduino代码文件(扩展名不可见),也可以是C文件(扩展名.c)、C++文件(.cpp)或是头文件(.h)。

Changed lines 475-482 from:

烧写

烧写程序之前,你需要通过工具>控制板以及工具>端口选择正确的选项,控制板的描述在这里。在Mac中,端口可能像/dev/tty.usbmodem241 (Uno或Mega2560或Leonardo)这样,或是像/dev/tty.usbserial-1B1 (Duemilanove或更老的版本)这样,或是像/dev/tty.USA19QW1b1P1.1 (使用Keyspan USB转串口适配器连接的控制板)这样。在Windows中,通常是COM1COM2 (串口板),或是COM4, COM5, COM7或更大(USB接口板),通常在Windows的设备管理器中查看USB串口设备的串口号。在Linux中,通常显示的是/dev/ttyACMx , /dev/ttyUSBx之类的。

一旦你选择了正确的控制板和端口,那么当你点击工具栏中的烧写按钮或是在草稿菜单中选择烧写子菜单时,当前的Arduino控制板就会自动重启然后开始烧写。老版的控制板(Diecimila之前)没有自动重启功能,所以当你开始烧写时需要按以下板上的重启按钮。更多的控制板的情况是,当烧写时你能看到RX和TX灯开始闪烁。当烧写完成时,Arduino软件(IDE)将显示一个烧写完成的信息,或是显示一个烧写错误的信息。

当你烧写草稿时,使用到了Arduino的引导程序,这个一个在微控制器中运行的非常小的程序 ,这个程序允许你在没有其他附件硬件设备的情况下烧写代码。引导程序在控制板重启的时候会运行几秒钟,此时就能够将草稿烧写到微控制器当中。当引导程序运行时板载的LED(13脚)会闪烁(比如重启的时候)。

to:

上传

上传程序之前,你需要通过工具>控制板以及工具>端口选择正确的选项,控制板的描述在这里。在Mac中,端口可能像/dev/tty.usbmodem241 (Uno或Mega2560或Leonardo)这样,或是像/dev/tty.usbserial-1B1 (Duemilanove或更老的版本)这样,或是像/dev/tty.USA19QW1b1P1.1 (使用Keyspan USB转串口适配器连接的控制板)这样。在Windows中,通常是COM1COM2 (串口板),或是COM4, COM5, COM7或更大(USB接口板),通常在Windows的设备管理器中查看USB串口设备的串口号。在Linux中,通常显示的是/dev/ttyACMx , /dev/ttyUSBx之类的。

一旦你选择了正确的控制板和端口,那么当你点击工具栏中的上传按钮或是在项目菜单中选择上传子菜单时,当前的Arduino控制板就会自动重启然后开始上传。老版的控制板(Diecimila之前)没有自动重启功能,所以当你开始上传时需要按以下板上的重启按钮。更多的控制板的情况是,当上传时你能看到RX和TX灯开始闪烁。当上传完成时,Arduino软件(IDE)将显示一个上传完成的信息,或是显示一个上传错误的信息。

当你上传项目时,使用到了Arduino的引导程序,这个一个在微控制器中运行的非常小的程序 ,这个程序允许你在没有其他附件硬件设备的情况下上传代码。引导程序在控制板重启的时候会运行几秒钟,此时就能够将项目上传到微控制器当中。当引导程序运行时板载的LED(13脚)会闪烁(比如重启的时候)。

Changed lines 486-489 from:

库为草稿提供了额外的功能,比如,硬件的使用和数据的处理。要在草稿中使用库,需要选择菜单草稿>Include Library(导入库) 。这将在代码开头通过#include 的形式添加一个或多个库文件到你的草稿当中,因为库会随你的草稿烧写到控制板当中,所以这会增加代码对存储空间的占用,如果代码中不再需要一个库,最简单的就是在代码中删除相应的#include部分。

在参考文件中有 库的列表 ,一些库是包含在Arduino的软件当中的,另外一些则是在不同的网站或是库管理器上下载的。IDE软件从1.0.5开始,你能够从一个.zip文件中导入一个库并用在草稿中,具体参照第三方库安装指南.

to:

库为项目提供了额外的功能,比如,硬件的使用和数据的处理。要在项目中使用库,需要选择菜单项目>Include Library(导入库) 。这将在代码开头通过#include 的形式添加一个或多个库文件到你的项目当中,因为库会随你的项目上传到控制板当中,所以这会增加代码对存储空间的占用,如果代码中不再需要一个库,最简单的就是在代码中删除相应的#include部分。

在参考文件中有 库的列表 ,一些库是包含在Arduino的软件当中的,另外一些则是在不同的网站或是库管理器上下载的。IDE软件从1.0.5开始,你能够从一个.zip文件中导入一个库并用在项目中,具体参照第三方库安装指南.

Changed lines 501-504 from:

串口监视窗

显示Arduino或Genuino(USB或串口板)发送的数据,要想发送数据给控制板的话,就需要在文本框中输入文本,然后点击"发送"按钮或回车。从下来菜单中选择合适的波特率,这个波特率要与程序中Serial.begin后的参数一致。注意在Windows、Mac或Linux中,当你打开串口监视窗的时候Arduino或Genuino会重启(程序会重新开始运行)。

to:

串口监视器

显示Arduino或Genuino(USB或串口板)发送的数据,要想发送数据给控制板的话,就需要在文本框中输入文本,然后点击"发送"按钮或回车。从下来菜单中选择合适的波特率,这个波特率要与程序中Serial.begin后的参数一致。注意在Windows、Mac或Linux中,当你打开串口监视器的时候Arduino或Genuino会重启(程序会重新开始运行)。

Changed lines 526-527 from:

选择控制板有两个作用:设定编译或烧写程序是的参数(比如CPU的速度和波特率),以及设定烧写引导程序时的文件以及熔丝位设置。一些控制板只是引导程序不一样,所以即使你在一个特定的选择下烧写成功了,在烧写引导程序之前也要仔细检查一下。这里我们将不同的控制板做一个比较

to:

选择控制板有两个作用:设定编译或上传程序是的参数(比如CPU的速度和波特率),以及设定上传引导程序时的文件以及熔丝位设置。一些控制板只是引导程序不一样,所以即使你在一个特定的选择下上传成功了,在上传引导程序之前也要仔细检查一下。这里我们将不同的控制板做一个比较

Changed line 558 from:
  • Arduino NG or older w/ ATmega168
    基于 ATmega168,16 MHz晶振,没有自动复位功能,编译和烧写等效于Arduino Diecimila 或 Duemilanove w/ ATmega168,不过烧写引导程序超时较慢(13脚的LED在重启后会闪烁3次),6个模拟量输入, 14个数字I/O,其中6 个PWM.
to:
  • Arduino NG or older w/ ATmega168
    基于 ATmega168,16 MHz晶振,没有自动复位功能,编译和上传等效于Arduino Diecimila 或 Duemilanove w/ ATmega168,不过上传引导程序超时较慢(13脚的LED在重启后会闪烁3次),6个模拟量输入, 14个数字I/O,其中6 个PWM.
Changed line 566 from:
to:
August 10, 2015, at 11:28 AM by Simone Maiocchi -
August 07, 2015, at 12:45 PM by Simone Maiocchi -
Changed lines 514-515 from:

to:


Changed lines 528-566 from:
  • Arduino Yùn

基于ATmega32u4, 16 MHz晶振,自动复位, 12个模拟量输入, 20个数字 I/O ,其中7个 PWM.

  • Arduino/Genuino Uno

基于 ATmega328, 16 MHz晶振,自动复位, 6个模拟量输入, 14个数字 I/O ,其中6个 PWM.

  • Arduino Diecimila 或 Duemilanove w/ ATmega168

 基于ATmega168,16 MHz晶振,自动复位,

  • Arduino Nano w/ ATmega328
 基于ATmega328,16 MHz晶振,自动复位, .8个模拟量输入.

  • Arduino/Genuino Mega 2560

基于ATmega2560 ,16 MHz晶振,自动复位, 16个模拟量输入,54个数字 I/O,其中15个 PWM.

  • Arduino Mega

基于ATmega1280 ,16 MHz晶振,自动复位, 16个模拟量输入, 54个数字 I/O ,其中15个 PWM.

  • Arduino Mega ADK
 基于ATmega2560,16 MHz晶振,自动复位,  16个模拟量输入, 54个数字 I/O,其中15 个PWM.

  • Arduino Leonardo

基于 ATmega32u4,16 MHz晶振,自动复位, 12个模拟量输入, 20个数字 I/O ,其中7个 PWM.

  • Arduino Micro

基于 ATmega32u4,16 MHz晶振,自动复位, 12个模拟量输入, 20个数字 I/O ,其中7个 PWM.

  • Arduino Esplora
    An ATmega32u4 running at 16 MHz with auto-reset.

基于 ATmega32u4,16 MHz晶振,自动复位,

  • Arduino Mini w/ ATmega328

基于 ATmega328, 16 MHz晶振,自动复位, 8个模拟量输入, 14个数字 I/O ,其中6个 PWM

  • Arduino Ethernet
    等效于ArduinoUNO与以太网扩展板的组合,基于 ATmega328, 16 MHz晶振,自动复位, 6个模拟量输入, 14个数字 I/O ,其中6个 PWM
to:
  • Arduino Yùn
    基于ATmega32u4, 16 MHz晶振,自动复位, 12个模拟量输入, 20个数字 I/O ,其中7个 PWM.

  • Arduino/Genuino Uno
    基于 ATmega328, 16 MHz晶振,自动复位, 6个模拟量输入, 14个数字 I/O ,其中6个 PWM.

  • Arduino Diecimila 或 Duemilanove w/ ATmega168
    基于ATmega168,16 MHz晶振,自动复位,

  • Arduino Nano w/ ATmega328
    基于ATmega328,16 MHz晶振,自动复位, .8个模拟量输入.

  • Arduino/Genuino Mega 2560
    基于ATmega2560 ,16 MHz晶振,自动复位, 16个模拟量输入,54个数字 I/O,其中15个 PWM.

  • Arduino Mega
    基于ATmega1280 ,16 MHz晶振,自动复位, 16个模拟量输入, 54个数字 I/O ,其中15个 PWM.

  • Arduino Mega ADK
    基于ATmega2560,16 MHz晶振,自动复位, 16个模拟量输入, 54个数字 I/O,其中15 个PWM.

  • Arduino Leonardo
    基于 ATmega32u4,16 MHz晶振,自动复位, 12个模拟量输入, 20个数字 I/O ,其中7个 PWM.

  • Arduino Micro
    基于 ATmega32u4,16 MHz晶振,自动复位, 12个模拟量输入, 20个数字 I/O ,其中7个 PWM.

  • Arduino Esplora
    基于 ATmega32u4,16 MHz晶振,自动复位,

  • Arduino Mini w/ ATmega328
    基于 ATmega328, 16 MHz晶振,自动复位, 8个模拟量输入, 14个数字 I/O ,其中6个 PWM

  • Arduino Ethernet
    等效于ArduinoUNO与以太网扩展板的组合,基于 ATmega328, 16 MHz晶振,自动复位, 6个模拟量输入, 14个数字 I/O ,其中6个 PWM
August 07, 2015, at 12:40 PM by Simone Maiocchi -
Deleted lines 534-535:
Deleted line 557:
Deleted line 560:
Deleted lines 568-569:
Deleted lines 569-570:
Deleted line 570:
Deleted lines 571-572:
Deleted lines 572-574:

Deleted line 573:
Deleted line 574:
August 07, 2015, at 12:27 PM by Simone Maiocchi -
Added lines 58-59:
August 07, 2015, at 12:21 PM by Simone Maiocchi -
Added lines 295-297:
Deleted line 492:

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.

August 07, 2015, at 12:19 PM by Simone Maiocchi -
Changed lines 424-425 from:
  • '' Export Compiled Binary (导出编译的二进制代码')'
    保存一个.hex文件作为存档或是用其他工具给控制板烧写程序。
to:
  • Export Compiled Binary (导出编译的二进制代码)
    保存一个.hex文件作为存档或是用其他工具给控制板烧写程序。
Changed line 592 from:
to:
August 07, 2015, at 12:17 PM by Simone Maiocchi -
Deleted line 294:
Changed lines 321-322 from:

烧写
编译你的代码并且烧写到选定的控制板中,细节请查看后面的 烧写 内容

to:

烧写
编译你的代码并且烧写到选定的控制板中,细节请查看后面的 烧写 内容

Changed lines 363-370 from:

其他命令我们能够在文本菜单中找到,文本菜单包含五个部分*文件*、*编辑*、*草稿*、*工具*、*帮助*。这些菜单是与你执行的操作与内容有关的,所以只有那些与当前操作有关的菜单才能使用。

to:

其他命令我们能够在文本菜单中找到,文本菜单包含五个部分文件编辑草稿工具帮助。这些菜单是与你执行的操作与内容有关的,所以只有那些与当前操作有关的菜单才能使用。

文件

  • 新建
    创建一个新的草稿,草稿中已经自动完成了一段Arduino程序的最小结构。
  • 打开
    允许通过计算机的文件管理器打开一个指定的草稿。

  • 最近打开的
    提供一个最近打开过的草稿的列表,可以通过选择打开其中一个。

  • 项目文件夹
    显示目前项目文件夹中的草稿,选择其中一个会在新的窗口中打开相应的代码。

  • 示例
    显示Arduino软件(IDE)或是库文件提供的每一个例子,所有这些例子通过树形结构显示,这样就能通过主题或库的名字轻易的找到对应的示例程序。

  • 关闭
    关闭当前选中的程序。

  • 保存
    用当前的名字保存草稿,如果文件还没有命名,则会弹出“另存为”窗口要求输入一个名字。

  • 另存为
    允许用另一个名字保存当前的草稿。

  • 页面设置
    显示用于打印的页面设置窗口。

  • 打印
    按照页面设置中的设定发送当前的草稿给打印机。

  • 首选项
    打开首选项窗口能够自己设定IDE的参数,比如IDE的语言环境。

  • 退出
    关闭所有IDE窗口,当下次打开IDE的时候会自动打开同样的草稿。

编辑

  • 撤销/重做
    撤销你在编辑区的一步或多步操作;当你撤销之后,可以通过重做再执行一遍相应的操作。

  • 剪切
    删除选择的文本放置在剪切板中。

  • 复制
    复制选中的文本放置在剪切板中。

  • 复制到论坛
    复制草稿中的代码放置在剪切板中,复制的内容包括完整的语法颜色提示,适合粘贴到论坛中。

  • 以HTML形式复制
    以HTML形式复制草稿中的代码放置在剪切板中,适合将代码嵌入到网页中。

  • 粘帖
    将剪切板中的内容放在编辑区的光标处。

  • 全选
    选中编辑区的所有内容。

  • 注释/取消注释
    在选中行的开头增加或移除注释标记符//。

  • 缩进/取消缩进
    在选中行的开头增加或取消一段缩进的位置,文本内容会相应的向右或向左移动。

  • 查找
    会打开查找和替换窗口,在这个小窗口内你可以根据几个选项在当前的草稿中查找特定的文字。

  • 查找下一个
    高亮显示下一个在查找窗口中指定的文字(如果有的话),同时将光标移动到对应的位置。

  • 查找上一个
    高亮显示上一个在查找窗口中指定的文字(如果有的话),同时将光标移动到对应的位置。

草稿

  • 校验/编译
    检查你代码中编译的错误,代码和变量使用存储区的情况会显示在控制台。

  • 烧写
    编译并通过设定的串口烧写二进制到选定的控制板当中。

  • 使用编程器烧写
    这将覆盖控制板中的引导程序;你需要使用 工具>烧写引导程序 来恢复控制板,这样下次才能再通过USB串口烧写程序。不过这种形式允许你的草稿使用芯片的全部存储区。

  • '' Export Compiled Binary (导出编译的二进制代码')'
    保存一个.hex文件作为存档或是用其他工具给控制板烧写程序。

  • 显示草稿文件夹
    打开当前草稿所在的文件夹。

  • Include Library (导入库)
    在代码开头通过#include 的形式添加一个库文件到你的草稿当中,更多细节请参考库当中的内容,另外,通过这个菜单项你能够访问库管理器,并且能够从.zip文件中导入新库。

  • 添加文件
    添加源文件到草稿中(会从当前位置复制过来)。新的文件会出现在草稿窗口中的新选项卡中。可以通过小三角形图标的选项卡菜单命令来删除文件,选项卡菜单位于串口监视窗按钮的下方。

工具

  • 自动格式化
    格式化之后代码看起来会更美观,比如,大括号内的代码要增加一段缩进,而大括号内的语句缩进更多。

  • 草稿存档
    将当前的草稿以.zip形式存档,存档文件放在草稿所在的目录下。

  • 修正编码及重载
    修正了编辑字符与其他系统字符间可能存在的差异。

  • 串口监视窗
    打开串口监视窗口,通过当前选定的串口查看与控制板之间交互的数据。通常这个操作会重启控制器,如果当前控制板支持打开串口复位的话。

  • 控制板
    选择你使用的控制板,详细信息参考各个控制板的介绍

  • 端口
    这个菜单包含了你电脑上所有的串口设备(真的串口设备或虚拟的串口设备),每次打开工具菜单时,这个列表都会自动刷新。

  • 编程器
    当我们不是通过USB转串口的连接方式给控制板或芯片烧写程序的时候就需要通过这个菜单选择硬件的编程器。一般你不需要使用这个功能,除非你要为一个新的控制器烧写引导程序。

  • 烧写引导程序
    这个菜单项允许你给Arduino上的微控制器烧写引导程序,如果你是正常使用Arduino或是Genuino控制板这个菜单项不是必须的,不过如果你购买了一个新的ATmega微控制器的话(通常都不包含引导程序),那么这个菜单项非常有用。在为目标板烧写引导程序时要确保你从“控制板”菜单中选择了正确的控制板。

帮助

这里你能够轻易的找到和Arduino软件(IDE)相关的各种文档。在未联网的情况下能够找到入门、参考资料、IDE使用指南以及其他的本地文档,这些文档是我们网站资源的拷贝,通过它们能够链接到我们的网站。

  • 在参考文件中寻找
    这是帮助菜单中唯一的交互功能,这样能够根据光标选中的部分直接跳转到相关的参考文件。

 

项目文件夹

Arduino软件(IDE)采用项目的方式对草稿进行管理:所有的代码(或草图)存在一个统一的位置,可以通过菜单文件>项目文件夹或是工具栏中的打开按钮从项目文件夹中打开一个草稿。当你第一次运行Arduino软件的时候会自动创建一个项目文件夹,你可以通过“首选项”的对话框来改变项目文件夹的位置。

1.0版本之后保存文件的扩展名是.ino,之前的版本保存文件的扩展名为.pde。在1.0以及之后的版本中你依然可以打开.pde的文件,软件会自动重命名为.ino。

选项卡,多个文件以及代码编译

允许你在草稿中使用多个文件(每一个文件有一个自己的选项卡),这些文件可以是正常的Arduino代码文件(扩展名不可见),也可以是C文件(扩展名.c)、C++文件(.cpp)或是头文件(.h)。

烧写

烧写程序之前,你需要通过工具>控制板以及工具>端口选择正确的选项,控制板的描述在这里。在Mac中,端口可能像/dev/tty.usbmodem241 (Uno或Mega2560或Leonardo)这样,或是像/dev/tty.usbserial-1B1 (Duemilanove或更老的版本)这样,或是像/dev/tty.USA19QW1b1P1.1 (使用Keyspan USB转串口适配器连接的控制板)这样。在Windows中,通常是COM1COM2 (串口板),或是COM4, COM5, COM7或更大(USB接口板),通常在Windows的设备管理器中查看USB串口设备的串口号。在Linux中,通常显示的是/dev/ttyACMx , /dev/ttyUSBx之类的。

一旦你选择了正确的控制板和端口,那么当你点击工具栏中的烧写按钮或是在草稿菜单中选择烧写子菜单时,当前的Arduino控制板就会自动重启然后开始烧写。老版的控制板(Diecimila之前)没有自动重启功能,所以当你开始烧写时需要按以下板上的重启按钮。更多的控制板的情况是,当烧写时你能看到RX和TX灯开始闪烁。当烧写完成时,Arduino软件(IDE)将显示一个烧写完成的信息,或是显示一个烧写错误的信息。

当你烧写草稿时,使用到了Arduino的引导程序,这个一个在微控制器中运行的非常小的程序 ,这个程序允许你在没有其他附件硬件设备的情况下烧写代码。引导程序在控制板重启的时候会运行几秒钟,此时就能够将草稿烧写到微控制器当中。当引导程序运行时板载的LED(13脚)会闪烁(比如重启的时候)。

 

库为草稿提供了额外的功能,比如,硬件的使用和数据的处理。要在草稿中使用库,需要选择菜单草稿>Include Library(导入库) 。这将在代码开头通过#include 的形式添加一个或多个库文件到你的草稿当中,因为库会随你的草稿烧写到控制板当中,所以这会增加代码对存储空间的占用,如果代码中不再需要一个库,最简单的就是在代码中删除相应的#include部分。

在参考文件中有 库的列表 ,一些库是包含在Arduino的软件当中的,另外一些则是在不同的网站或是库管理器上下载的。IDE软件从1.0.5开始,你能够从一个.zip文件中导入一个库并用在草稿中,具体参照第三方库安装指南.

想写自己的库,可以参考 这个教程

第三方硬件

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. 添加第三方硬件可以直接添加到项目文件夹所在目录的hardware文件夹中,平台安装必须包含控制板定义(出现在控制板菜单项中)、核心库、引导程序以及编程器定义。步骤是首先创建一个hareware的文件夹,然后将第三方平台解压到相应的文件夹下。(不要使用“arduino”作为子目录的名字,这样有可能改变原本的Arduino平台。)卸载的话简单删除文件夹就好了。

创建第三方硬件安装包的详细内容可以参考Arduino IDE 1.5第三方硬件说明.

 

串口监视窗

显示Arduino或Genuino(USB或串口板)发送的数据,要想发送数据给控制板的话,就需要在文本框中输入文本,然后点击"发送"按钮或回车。从下来菜单中选择合适的波特率,这个波特率要与程序中Serial.begin后的参数一致。注意在Windows、Mac或Linux中,当你打开串口监视窗的时候Arduino或Genuino会重启(程序会重新开始运行)。

控制板同样能够和Processing, Flash, MaxMSP等软件通信,参考交互页面了解细节。

 

首选项

一些首选项能够通过首选项对话框设定(Mac中在Arduino菜单下,Windows或Linux中在文件菜单下。)其他的设定能够在首选项对话框中设定的目录中找到。

语言支持


从版本1.0.1开始,Arduino软件(IDE)已被翻译成30多种语言,默认的情况下,IDE会根据系统的语言选择相应的语言(注意:在Windows中以及可以在Linux中,这是由系统的日期和时间格式来确定的,而不是由操作系统显示的语言来确定的。)

如果你想手动更改语言,那就打开Arduino软件,然后在首选项的对话框中选择编辑器语言,在弹出的下来菜单中选择相应的语言,然后重启软件使所选择的语言生效,如果你的操作系统不支持你所选择的语言,那么IDE会默认采用英文。

你能够返回Arduino的默认设置,让IDE根据系统的语言选择相应的语言,只需要在语言选择的下拉菜单中选择系统默认。当你重启软件时这个设置会生效。同样的,改变你的系统设置后,你需要重新启动Arduino软件才能变为新的默认语言。

 

控制板

选择控制板有两个作用:设定编译或烧写程序是的参数(比如CPU的速度和波特率),以及设定烧写引导程序时的文件以及熔丝位设置。一些控制板只是引导程序不一样,所以即使你在一个特定的选择下烧写成功了,在烧写引导程序之前也要仔细检查一下。这里我们将不同的控制板做一个比较

  • Arduino Yùn

基于ATmega32u4, 16 MHz晶振,自动复位, 12个模拟量输入, 20个数字 I/O ,其中7个 PWM.

  • Arduino/Genuino Uno

基于 ATmega328, 16 MHz晶振,自动复位, 6个模拟量输入, 14个数字 I/O ,其中6个 PWM.

  • Arduino Diecimila 或 Duemilanove w/ ATmega168

 基于ATmega168,16 MHz晶振,自动复位,

  • Arduino Nano w/ ATmega328
 基于ATmega328,16 MHz晶振,自动复位, .8个模拟量输入.

  • Arduino/Genuino Mega 2560

基于ATmega2560 ,16 MHz晶振,自动复位, 16个模拟量输入,54个数字 I/O,其中15个 PWM.

  • Arduino Mega

基于ATmega1280 ,16 MHz晶振,自动复位, 16个模拟量输入, 54个数字 I/O ,其中15个 PWM.

  • Arduino Mega ADK
 基于ATmega2560,16 MHz晶振,自动复位,  16个模拟量输入, 54个数字 I/O,其中15 个PWM.

  • Arduino Leonardo

基于 ATmega32u4,16 MHz晶振,自动复位, 12个模拟量输入, 20个数字 I/O ,其中7个 PWM.

  • Arduino Micro

基于 ATmega32u4,16 MHz晶振,自动复位, 12个模拟量输入, 20个数字 I/O ,其中7个 PWM.

  • Arduino Esplora
    An ATmega32u4 running at 16 MHz with auto-reset.

基于 ATmega32u4,16 MHz晶振,自动复位,

  • Arduino Mini w/ ATmega328

基于 ATmega328, 16 MHz晶振,自动复位, 8个模拟量输入, 14个数字 I/O ,其中6个 PWM

  • Arduino Ethernet
    等效于ArduinoUNO与以太网扩展板的组合,基于 ATmega328, 16 MHz晶振,自动复位, 6个模拟量输入, 14个数字 I/O ,其中6个 PWM

  • Arduino Fio
    基于 ATmega328, 8 MHz晶振,自动复位, 等效于Arduino Pro 或 Pro Mini (3.3V, 8 MHz) w/ ATmega328 ,6个模拟量输入, 14个数字 I/O ,其中6个 PWM

  • Arduino BT w/ ATmega328
    基于 ATmega328, 16 MHz晶振,引导程序包含蓝牙模块的初始化程序,6个模拟量输入, 14个数字 I/O ,其中6个 PWM

  • LilyPad Arduino USB
    基于 ATmega32u4, 8MHz晶振,自动复位, 4个模拟量输入, 9个数字 I/O ,其中4个 PWM

  • LilyPad Arduino
    基于 ATmega168ATmega132, 8MHz晶振,自动复位, 6个模拟量输入, 14个数字 I/O ,其中6个 PWM

  • Arduino Pro or Pro Mini (5V, 16 MHz) w/ ATmega328
    基于 ATmega328,16 MHz晶振,自动复位. 等效于Arduino Duemilanove 或 Nano w/ ATmega328, 6个模拟量输入, 14个数字I/O ,其中6个 PWM.

  • Arduino NG or older w/ ATmega168
    基于 ATmega168,16 MHz晶振,没有自动复位功能,编译和烧写等效于Arduino Diecimila 或 Duemilanove w/ ATmega168,不过烧写引导程序超时较慢(13脚的LED在重启后会闪烁3次),6个模拟量输入, 14个数字I/O,其中6 个PWM.

  • Arduino Robot Control
    基于 ATmega328,16 MHz晶振,自动复位.

  • Arduino Robot Motor
    基于 ATmega328,16 MHz晶振,自动复位.

  • Arduino Gemma
    基于 ATtiny85,8 MHz晶振,自动复位. 4 个模拟量输入, 9个数字I/O ,其中4个 PWM.


关于安装其他控制板的介绍,参考 第三方硬件 的相关内容。

August 07, 2015, at 09:32 AM by Simone Maiocchi -
Deleted lines 297-298:
August 07, 2015, at 09:31 AM by Simone Maiocchi -
Deleted lines 295-296:

(*toc)

Added lines 298-299:
August 07, 2015, at 09:29 AM by Simone Maiocchi -
Added lines 295-297:

(*toc)

August 07, 2015, at 08:58 AM by Luca Cipriani -
Changed lines 321-322 from:

烧写
编译你的代码并且烧写到选定的控制板中,细节请查看后面的 烧写 内容

to:

烧写
编译你的代码并且烧写到选定的控制板中,细节请查看后面的 烧写 内容

August 07, 2015, at 08:52 AM by Simone Maiocchi -
Changed lines 363-370 from:

其他命令我们能够在文本菜单中找到,文本菜单包含五个部分文件编辑草稿工具帮助。这些菜单是与你执行的操作与内容有关的,所以只有那些与当前操作有关的菜单才能使用。

to:

其他命令我们能够在文本菜单中找到,文本菜单包含五个部分*文件*、*编辑*、*草稿*、*工具*、*帮助*。这些菜单是与你执行的操作与内容有关的,所以只有那些与当前操作有关的菜单才能使用。

August 07, 2015, at 08:40 AM by Simone Maiocchi -
Changed line 57 from:
to:
August 07, 2015, at 08:39 AM by Simone Maiocchi -
Changed lines 295-371 from:
to:
August 07, 2015, at 08:26 AM by Simone Maiocchi -
Changed line 9 from:
      > Introduction
to:
      > Arduino Software (IDE)
Added line 57:
Added lines 292-295:
August 07, 2015, at 08:23 AM by Simone Maiocchi -
Changed line 1 from:
to:
Changed line 6 from:
  <div class="breadcrumb columns large-10 medium-10">
to:

<div class="breadcrumb columns large-10 medium-10">

Changed lines 8-9 from:
      <a class="wikilink" href="www.arduino.cc">Home </a>
      > Genuino Brand
to:
      <a class="wikilink" href="/en/Guide/HomePage">Getting Started</a>
      > Introduction
Added line 13:
Changed line 16 from:
      Chinese
to:
     English (英语)
Changed lines 20-21 from:
      <li class="selected">Chinese</li>
      <li><a href="?setlang=en">English</a></li>
to:
      <li class="selected">English (英语)</li>
      <li><a href="?setlang=cn">中文 (Chinese)</a></li>
Changed lines 27-31 from:
to:
Changed line 34 from:
  <div class="breadcrumb columns large-10 medium-10">
to:

<div class="breadcrumb columns large-10 medium-10">

Changed lines 36-37 from:
      <a class="wikilink" href="www.arduino.cc">Home </a>
      > Genuino Brand
to:
      <a class="wikilink" href="/cn/Main/Landingpage">欢迎来到Genuino的世界  </a>
      > Arduino 软件 (IDE) 
Changed line 43 from:
      English
to:
      中文 (Chinese)
Changed lines 47-48 from:
      <li class="selected">English</li>
      <li><a href="?setlang=cn">Chinese</a></li>
to:
      <li class="selected">中文 (Chinese)</li>
      <li><a href="?setlang=en">English (英语)</a></li>
Changed lines 54-56 from:
to:
August 03, 2015, at 05:49 PM by Alice Pintus -
July 31, 2015, at 03:26 PM by Alice Pintus -
July 31, 2015, at 03:21 PM by Stefania Mellai -
Changed line 20 from:
      <li><a href="?setlang=cn">English</a></li>
to:
      <li><a href="?setlang=en">English</a></li>
July 31, 2015, at 03:17 PM by Stefania Mellai -
July 31, 2015, at 03:11 PM by Stefania Mellai -
Changed line 1 from:
to:
Changed line 15 from:
      English
to:
      Chinese
Changed lines 19-20 from:
      <li class="selected">English</li>
      <li><a href="?setlang=cn">Chinese</a></li>
to:
      <li class="selected">Chinese</li>
      <li><a href="?setlang=cn">English</a></li>
Changed line 44 from:
      Chinese
to:
      English
Changed lines 48-49 from:
      <li class="selected">Chinese</li>
      <li><a href="?setlang=cn">English</a></li>
to:
      <li class="selected">English</li>
      <li><a href="?setlang=cn">Chinese</a></li>
July 31, 2015, at 03:08 PM by Stefania Mellai -
Added lines 1-55:
July 23, 2015, at 02:33 PM by Simone Maiocchi -
Changed lines 1-4 from:

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.

to:

Arduino Software (IDE)

The Arduino Integrated Development Environment - or Arduino Software (IDE) - 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 and Genuino hardware to upload programs and communicate with them.

Changed lines 6-9 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.

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.

to:

Programs written using Arduino Software (IDE) are called sketches. These sketches are written in the text editor and are saved with the file extension .ino. The editor 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 Software (IDE), including complete error messages and other information. The bottom righthand corner of the window displays the configured board and serial port. The toolbar buttons allow you to verify and upload programs, create, open, and save sketches, and open the serial monitor.

NB: Versions of the Arduino Software (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.

Changed lines 18-19 from:

Verify
Checks your code for errors.

to:

Verify
Checks your code for errors compiling it.

Changed lines 26-29 from:

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

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"

to:

Upload
Compiles your code and uploads it to the configured board. See uploading below for details.

Note: If you are using an external programmer with your board, you can hold down the "shift" key on your computer when using this icon. The text will change to "Upload using Programmer"

Changed lines 44-45 from:

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

to:

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

Changed lines 66-67 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 69-70 from:
  • Quit
    Closes all IDE windows. The sketches will be automatically reopened the next time you start the IDE.
to:
  • New
    Creates a new instance of the editor, with the bare minimum structure of a sketch already in place.
  • Open
    Allows to load a sketch file browsing through the computer drives and folders.
  • Open Recent
    Provides a short list of the most recent sketches, ready to be opened.
  • Sketchbook
    Shows the current sketches within the sketchbook folder structure; clicking on any name opens the corresponding sketch in a new editor instance.
  • Examples
    Any example provided by the Arduino Software (IDE) or library shows up in this menu item. All the examples are structured in a tree that allows easy access by topic or library.
  • Close
    Closes the instance of the Arduino Software from which it is clicked.
  • Save
    Saves the sketch with the current name. If the file hasn't been named before, a name will be provided in a "Save as.." window.
  • Save as...
    Allows to save the current sketch with a different name.
  • Page Setup
    It shows the Page Setup window for printing.
  • Print
    Sends the current sketch to the printer according to the settings defined in Page Setup.
  • Preferences
    Opens the Preferences window where some settings of the IDE may be customized, as the language of the IDE interface.
  • Quit
    Closes all IDE windows. The same sketches open when Quit was chosen will be automatically reopened the next time you start the IDE.
Added lines 84-86:
  • Undo/Redo
    Goes back of one or more steps you did while editing; when you go back, you may go forward with Redo.
  • Cut
    Removes the selected text from the editor and places it into the clipboard.
  • Copy
    Duplicates the selected text in the editor and places it into the clipboard.
Deleted line 87:
Changed lines 89-96 from:
to:
  • Paste
    Puts the contents of the clipboard at the cursor position, in the editor.
  • Select All
    Selects and highlights the whole content of the editor.
  • Comment/Uncomment
    Puts or removes the // comment marker at the beginning of each selected line.
  • Increase/Decrease Indent
    Adds or subtracts a space at the beginning of each selected line, moving the text one space on the right or eliminating a space at the beginning.
  • Find
    Opens the Find and Replace window where you can specify text to search inside the current sketch according to several options.
  • Find Next
    Highlights the next occurrence - if any - of the string specified as the search item in the Find window, relative to the cursor position.
  • Find Previous
    Highlights the previous occurrence - if any - of the string specified as the search item in the Find window relative to the cursor position.
Changed lines 99-100 from:
  • Verify/Compile
    Checks your sketch for errors.
to:
  • Verify/Compile
    Checks your sketch for errors compiling it; it will report memory usage for code and variables in the console area.
  • Upload
    Compiles and loads the binary file onto the configured board through the configured Port.
  • Upload Using Programmer
    This will overwrite the bootloader on the board; you will need to use Tools > Burn Bootloader to restore it and be able to Upload to USB serial port again. However, it allows you to use the full capacity of the Flash memory for your sketch.
  • Export Compiled Binary
    Saves a .hex file that may be kept as archive or sent to the board using other tools.
Changed lines 104-110 from:
  • 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.

  • Upload Using Programmer
    This will overwrite the bootloader and so you will need to use Tools > Burn Bootloader to be able to Upload to USB serial port. Allows you to use the full capacity of the Flash memory for your sketch.

  • Include Library
    Adds a library to your sketch by inserting #include statements at the start of your code. For more details, see libraries below. Additionally, with version 1.0.5 and later of the IDE, you can import a library from a .zip file.
to:
  • Include Library
    Adds a library to your sketch by inserting #include statements at the start of your code. For more details, see libraries below. Additionally, from this menu item you can access the Library Manager and import new libraries from .zip files.
  • 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 accessible clicking on the small triangle icon below the serial monitor one on the right side o the toolbar.

Deleted line 110:
Changed lines 112-113 from:
to:
  • Fix Encoding & Reload
    Fixes possible discrepancies between the editor char map encoding and other operating systems char maps.
  • Serial Monitor
    Opens the serial monitor window and initiates the exchange of data with any connected board on the currently selected Port. This usually resets the board, if the board supports Reset over serial port opening.
Changed lines 115-117 from:
  • 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.
to:
  • 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.
Changed lines 117-119 from:
  • 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 microcontroller (which normally come without a bootloader). Ensure that you've selected the correct board from the Boards menu before burning the bootloader.
to:
  • 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 or Genuino 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 on the target board.

Help

Here you find easy access to a number of documents that come with the Arduino Software (IDE). You have access to Getting Started, Reference, this guide to the IDE and other documents locally, without an internet connection. The documents are a local copy of the online ones and may link back to our online website.

  • Find in Reference
    This is the only interactive function of the Help menu: it directly selects the relevant page in the local copy of the Reference for the function or command under the cursor.

Changed lines 129-130 from:

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.

to:

The Arduino Software (IDE) 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.

Changed lines 135-136 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).

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 visible extension), C files (.c extension), C++ files (.cpp), or header files (.h).

Changed lines 140-143 from:

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

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.

to:

Before uploading your sketch, you need to select the correct items from the Tools > Board and Tools > Port menus. The 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/ttyACMx , /dev/ttyUSBx or similar. 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 Software (IDE) will display a message when the upload is complete, or show an error.

Changed lines 150-151 from:

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. 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 instructions for installing a third-party library.

to:

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 or through the Library Manager. 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 instructions for installing a third-party library.

Changed lines 164-165 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:

Displays serial data being sent from the Arduino or Genuino 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 Windows, Mac or Linux, the Arduino or Genuino board will reset (rerun your sketch execution to the beginning) when you connect with the serial monitor.

Changed lines 177-182 from:

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.

to:

Since version 1.0.1 , the Arduino Software (IDE) 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 (IDE) 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 operating system language is not supported, the Arduino Software (IDE) will default to English.

You can return the software 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 (IDE). Similarly, after changing your operating system's settings, you must restart the Arduino Software (IDE) to update it to the new default language.

Changed lines 186-193 from:

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.

  • Arduino Uno
    An ATmega328 running at 16 MHz with auto-reset, using the optiboot bootloader (115200 baud, 0.5 KB).

  • 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).
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. You can find a comparison table between the various boards here.

  • Arduino Yùn
    An ATmega32u4 running at 16 MHz with auto-reset, 12 Analog In, 20 Digital I/O and 7 PWM.

  • Arduino/Genuino Uno
    An ATmega328 running at 16 MHz with auto-reset, 6 Analog In, 14 Digital I/O and 6 PWM.

  • Arduino Diecimila or Duemilanove w/ ATmega168
    An ATmega168 running at 16 MHz with auto-reset.
Changed lines 196-232 from:
  • 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.

  • Arduino Mega (ATmega1280)
    An ATmega1280 running at 16 MHz with auto-reset.

  • Arduino Leonardo
    An ATmega32u4 running at 16 MHz with auto-reset.

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

  • Arduino Ethernet
    Equivalent to Arduino UNO with an Ethernet shield.

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

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

For instructions on installing support for other boards, see third-party hardware above.

to:
  • Arduino/Genuino Mega 2560
    An ATmega2560 running at 16 MHz with auto-reset, 16 Analog In, 54 Digital I/O and 15 PWM.

  • Arduino Mega
    An ATmega1280 running at 16 MHz with auto-reset, 16 Analog In, 54 Digital I/O and 15 PWM.

  • Arduino Mega ADK
    An ATmega2560 running at 16 MHz with auto-reset, 16 Analog In, 54 Digital I/O and 15 PWM.

  • Arduino Leonardo
    An ATmega32u4 running at 16 MHz with auto-reset, 12 Analog In, 20 Digital I/O and 7 PWM.

  • Arduino Micro
    An ATmega32u4 running at 16 MHz with auto-reset, 12 Analog In, 20 Digital I/O and 7 PWM.

  • Arduino Esplora
    An ATmega32u4 running at 16 MHz with auto-reset.

  • Arduino Mini w/ ATmega328
    An ATmega328 running at 16 MHz with auto-reset, 8 Analog In, 14 Digital I/O and 6 PWM.

  • Arduino Ethernet
    Equivalent to Arduino UNO with an Ethernet shield: An ATmega328 running at 16 MHz with auto-reset, 6 Analog In, 14 Digital I/O and 6 PWM.

  • Arduino Fio
    An ATmega328 running at 8 MHz with auto-reset. Equivalent to Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328, 6 Analog In, 14 Digital I/O and 6 PWM.

  • Arduino BT w/ ATmega328
    ATmega328 running at 16 MHz. The bootloader burned (4 KB) includes codes to initialize the on-board bluetooth module, 6 Analog In, 14 Digital I/O and 6 PWM..

  • LilyPad Arduino USB
    An ATmega32u4 running at 8 MHz with auto-reset, 4 Analog In, 9 Digital I/O and 4 PWM.

  • LilyPad Arduino
    An ATmega168 or ATmega132 running at 8 MHz with auto-reset, 6 Analog In, 14 Digital I/O and 6 PWM.

  • 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; 6 Analog In, 14 Digital I/O and 6 PWM.

  • 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); 6 Analog In, 14 Digital I/O and 6 PWM.

  • Arduino Robot Control
    An ATmega328 running at 16 MHz with auto-reset.

  • Arduino Robot Motor
    An ATmega328 running at 16 MHz with auto-reset.

  • Arduino Gemma
    An ATtiny85 running at 8 MHz with auto-reset, 4 Analog In, 9 Digital I/O and 4 PWM.


For instructions on installing support for other boards, see third-party hardware above.


\\

June 25, 2015, at 02:21 PM by Arturo -
Added lines 68-70:

File

  • Quit
    Closes all IDE windows. The sketches will be automatically reopened the next time you start the IDE.
Changed lines 108-109 from:

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

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.

June 25, 2015, at 10:16 AM by Arturo -
Changed lines 82-83 from:
  • Import Library
    Adds a library to your sketch by inserting #include statements at the start of your code. For more details, see libraries below. Additionally, with version 1.0.5 and later of the IDE, you can import a library from a .zip file.
to:
  • Upload Using Programmer
    This will overwrite the bootloader and so you will need to use Tools > Burn Bootloader to be able to Upload to USB serial port. Allows you to use the full capacity of the Flash memory for your sketch.

  • Include Library
    Adds a library to your sketch by inserting #include statements at the start of your code. For more details, see libraries below. Additionally, with version 1.0.5 and later of the IDE, you can import a library from a .zip file.
Changed lines 134-135 from:

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

to:

For details on creating packages for third-party hardware, see the Arduino IDE 1.5 3rd party Hardware specification.

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 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 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 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 instructions for installing a third-party library.

to:

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. 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 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 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 instructions for installing a third-party library.

to:

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

to:

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


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:

Language Support


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 third-party hardware above.

to:

For instructions on installing support for other boards, see 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:

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 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 burning a bootloader to a new microcontroller, you will use this.

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

to:

For details on creating packages for third-party hardware, see the 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:
to:
Changed lines 19-20 from:
to:
Changed lines 29-30 from:
to:
Changed lines 37-38 from:
to:
Changed lines 47-48 from:
to:
Changed lines 55-56 from:
to:
September 07, 2011, at 03:08 AM by Scott Fitzgerald - updated icons
Changed lines 11-12 from:
to:
Changed lines 19-20 from:
to:
Changed lines 29-30 from:
to:
Changed lines 37-38 from:
to:
Changed lines 47-48 from:
to:
Changed lines 55-56 from:
to:
September 07, 2011, at 03:07 AM by Scott Fitzgerald - updated icons
Changed lines 11-12 from:
to:
Changed lines 19-20 from:
to:
Changed lines 29-30 from:
to:
Changed lines 37-38 from:
to:
Changed lines 47-48 from:
to:
Changed lines 55-56 from:
to:
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 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 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:
to:
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 below for details.

Changed lines 53-54 from:
to:
Deleted lines 56-63:
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 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 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:

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.

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

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

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

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

to:

Serial Monitor
Opens the serial monitor.

Added lines 115-124:

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

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:
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:
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:
Changed lines 15-18 from:

Checks your code for errors.

Stop

to:
Changed lines 23-26 from:

Stops the serial monitor, or unhighlight other buttons.

New

to:
Changed lines 31-34 from:

Creates a new sketch.

Open

to:
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:
Changed lines 45-46 from:

Save

to:
Changed lines 49-52 from:

Saves your sketch.

Upload to I/O Board

to:
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:
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:
Added lines 71-72:
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 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 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 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 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:
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:
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:
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 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 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.

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

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:29 PM by David A. Mellis -
Changed lines 82-83 from:

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.

to:

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

December 23, 2009, at 05:27 PM by David A. Mellis -
Added line 114:

Added line 119:

Added line 124:

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:
to:
Deleted lines 121-122:
Deleted lines 125-126:
November 29, 2009, at 01:44 AM by David A. Mellis -
Added lines 112-127:
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 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 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 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.

to:

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.

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:
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:
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:
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:
Changed lines 154-157 from:

Arduino NG or older w/ ATmega8

ATmega8 running at 16 MHz without auto-reset.

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

April 24, 2008, at 05:28 AM by David A. Mellis -
Changed line 3 from:
to:
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 -
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 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 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 #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.

to:

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.

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

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

to:

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.

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

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

to:

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.

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

November 04, 2006, at 05:20 PM by David A. Mellis -
Deleted lines 2-3:
November 04, 2006, at 05:20 PM by David A. Mellis -
Added lines 3-4:
October 26, 2006, at 10:26 PM by David A. Mellis -
Added lines 1-100:

Share