Arduino Eclipse IDE and Plugin V2.2 installation

Update: The newest version of the Arduino Eclipse IDE/Plugin is 2.4. The installation instructions and process particularly for the Teensy boards from is much simpler.

These installation instructions are written for users that are already familiar with the Arduino IDE. While these are written for Mac users, other than the file locations and slight OS dependent differences in the Eclipse User interface, there is actually very little Mac specific content and these instructions should also work for windows and Linux. If you notice any mistakes or encounter problems, please leave a comment here and I’ll do my best to fix these.

Also these are written particularly for the new version of the Arduino Eclipse Plugin version 2.2.  and the new Arduino Eclipse IDE which provides integration of the Teensy processor family, including the new Teensy3 and Teensy 3.1. These are Arduino compatible boards utilizing an ARM Cortex M4 32-bit micro controller.

Arduino Eclipse IDE 

The plugin is still the same “thing”  however the Arduino Eclipse IDE is new. It does not require a separate download of the Eclipse C/C++ IDE and then a separate installation of the plugin. It combines Eclipse Kepler and the  Plugin (and then some). If you have not previously installed Eclipse and /or the plugin then it is recommended to use this. Should you have worked with the previous version of the plugin but would like to upgrade to Eclipse Kepler, the Arduino Eclipse IDE and the Plugin V2.2 are compatible with projects created to maintained with Plugin V2.1.0.4. Teensy users will will need to go, into the project properties and re-select the  boards.txt file. 

  1. Download the Arduino Eclipse IDE appropriate for your OS following this LINK
  2. Un-zip the file and move the folder to your preferred location. On my iMac it is located it the Applications folder.
  3. Download and and install Arduino 1.5.2 beta (preferred) or Arduino 1.5.5. Do  NOT use Arduino 1.5.4!
  4. If you want to program Teensy boards you will possibly already have Arduino 1.0.5 and Teensyduino installed and will need to create a Teensy Extension file as described HERE. Otherwise please skip this step.
  5. Proceed to step 9 of the Plugin installation sequence, set your preferences and you’re done.

Arduino Eclipse Plugin V2.2

  1. Download and install Eclipse IDE for C/C++ Developers. It needs to be he 32bit version of Eclipse Juno or Kepler. The lug in will not work with older versions.
  2. Download and and install Arduino 1.5.2 beta (preferred) or Arduino 1.5.5. Do  NOT use Arduino 1.5.4!
  3. If you want to program Teensy boards you will possibly already have Arduino 1.0.5 and Teensyduino installed and will need to create a Teensy Extension file as described HERE. Otherwise please skip this step.
  4. Start Eclipse. The first time it will ask you to select a workspace. For an Arduino work environment I’d suggest you select the place where you have all your Arduino Projects/Sketches. You can always change to another workspace if you have several of such directories.
  5. From the Eclipse menu bar Eclipse select “Help” –> “Install new software”.
    Screen Shot 2013-07-03 at 7.15.06 AM
  6. Make sure to uncheck the five check boxes in the above screen as otherwise you will not see the plugin in the selection window.
  7. Select “Add” to add the download site for the Arduino Eclipse plugin :
    Screen Shot 2013-07-03 at 7.16.10 AM
  8. Eclipse will show which versions are available (Make sure to keep the “Group items by category” unchecked). Select the version and click on “Finish”. You will be asked to restart Eclipse. Accept and follow the rest of the installation steps. The Plugin installs the usual Arduino button icons into the menu bar .
    Screen Shot 2013-07-02 at 7.53.13 PM
  9. Now that the plugin is installed, from the Eclipse menu bar select “Eclipse” –> “Preferences”. In the preferences pane select “Arduino” and fill in the appropriate fields for “Arduino IDE path”, “Private library path” and “Private hardware path”. The example below shows where these directories located on my machine. Obviously this may be different on each users machine.
    V2.2_Plugin_ _Preferences
  10. D.O.N.E. This concludes the installation. And now you can start with your first project using the Arduino Eclipse Plugin
I would also recommend for new users to read the info that Jantje has provided on his web site . There is a video demonstrating some of the above and while it is not reflecting the latest version of the plugin it still may provide some helpful hints.
  1. Thank you for your support. I have been able to compile and upload fine on a teensy 3.1 with the boards.txt and opcodes corrections. (Ubuntu 12.04)

  2. Hi,

    I have installed the updated plugin successfully. It works great for nearly all of my products.
    However it will not compile .S (Assembler) files . When I am using Arduino IDE it worked. I have already made the corrections as suggested for

    Please help me. I need to have included my .S files for performance reason.

    What can I do?

    • Hi,

      I am glad the plugin works for you. However, I only wrote installation instructions. For questions such as yours I would like to refer you to the plugin thread on the Arduino forum, which I have linked to in previous answers.
      Jantje, the main developer of the plugin answers questions there. You can also go to the Github page and report it there

  3. Hi! I’ve just downloaded the Arduino Eclipse IDE, but when I open it with 7zip to extract the .tar file, 7zip give me an error that the file is corrupt, in spite of that, I get the .tar file in my Desktop. When I open it, there is a folder called “eclipseArduino”, but inside there is no executable. I’ve tried with releases and nightly builds but I’ve got the same problem too. Don’t you have any idea?

    My apologies for any mistake when writing.

  4. Thanks a lot for interesting article. I want to recommend you to look into PlatformIO project. This is a cross-platform code builder and library manager and can be easy integrated into to Eclipse under different platforms.

    • Hi Ivan,
      Thanks for the link. It looks interesting. As a console tool, what does PlatformIO offer on top of the Arduino-Eclipse IDE ?
      I also exclusively use the 32 bit ARM based Teensy boards for. Does PlatformIO support the Arm Tool chain ?

      • > As a console tool, what does PlatformIO offer on top of the Arduino-Eclipse IDE ?

        With PlatformIO tool you can build single sources for different platforms (+ boards) via single command `$ platformio run`. See example here. The configured project with `platformio.ini` will have the same behaviour on different OS(Linux/Mac/Windows).

        > Does PlatformIO support the Arm Tool chain ?

        Teensyduino supports only Arduino version 1.0.5.But PlatformIO uses Arduino Framework 1.5.x branch. If I had Teensyduino, I would add support for it. But if you can help me with testing, I will start on it. Please open a new issue here. Because I don’t see any problems to add ARM support for Teensyduino. Thanks.

      • Hi Ivan,

        Your tool looks well thought out, however is till don’t understand what makes it unique tool and what problem it attempts to solve and how it solves that problem better than other approaches, e.g. an IDE line Eclipse.

        Teensyduino is free and can be downloaded from the website. It is an. Installer that runs on Linux, windows and Max OSX. As you don,t have a Teensy boar I understand that it would be difficult for you to test. I could help but I have very limited time already to finish my own projects already and it would be very sporadic.
        Perhaps it would be interesting for you to post your willingness to integrate it on the Teensy forum. In general the Regular posters there exhibit much more expertise than usually found on the Arduino forum and your tool is likely to get more attention there.

      • Hi,

        I’ve just pushed new documentation for PlatformIO with a lot of informations. Please go to

  5. Hi theree outstanding blog! Does running a blog like this require a large amount of work?
    I’ve absolutely no understanding of coding but I had been hoping to start my own blog in the near future.
    Anyhow, should you have anyy suggestions or techniques for new
    blog owners please share. I know this is off subject butt I imply had to ask.
    Thank you!

    • Hi Jennie,

      My blog is really not outstanding ( nor does it aim to be) , but thanks anyway 🙂
      It is not a lot of work or at least I don’t put much into it. Maybe that’s why it’s not outstanding 😉 Ha, fine with me!
      You don’t need to code anything. Just read a few tutorials and jump in.

  6. Thank you for the tutorial. Unfortunately I can’t flash my Arduino Uno with your IDE / Plugin. When I click on the button to upload the code it says:
    avrdude: can’t open input file …folderpath…/ElecWorld/Release/ElecWorld.hex: No such file or directory
    avrdude: read from file ‘ …folderpath…/ElecWorld/Release/ElecWorld.hex’ failed
    When I look into the specified directory then I can’t find the hex file either.
    I’m running it on Linux Mint, 64 bit.
    Thanks in advance!

    • Hi, just for the record, this is not MY IDE, or MY plugin 😉
      The plugin was initially written by Jantje who has received help now from a number of other people. I simply wrote these instructions to help people that want to integrate the Teensy boards and that also work on a Mac. So, having that said, I will try to help you but I am not sure I can. A good place to post issues such as yours is also the Thread on the Arduino Forum, or if you are so inclined you can also create an issue on the GitHub site or the plugin. In this case I’d post to the Forum as the GitHub site is more for functionality issues and bugs. I added a menu time “Other resources” to the list of instructions that provides links to both.

      You did not post enough detail for me o help:
      What version of the plugin did you install. Is it one of the stable/nightly bundles the combine Eclipse and the Plugin, or did you install Eclipse and the Plugin separately ?

      It looks like the path does not fully resolve. There is certainly more console output than you posted and if there is no .hex file something else failed before that in the compilation process. Maybe post it here ?
      Just a general hint that the plugin does not like spaces in any of the folder names that Eclipse references.

      • Hey!

        Okay, I’ll do so next time.

        I’m using Arduino (IDE 1.5.2) with the Arduino Eclipse Plugin Combination thing (linux64.2014-12-12_02-07-00.tar.gz, guess it’s the latest release what I took) from So I didn’t install it separately.

        I figured out something (what might have been the problem): When I add a New Project (New Sketch) and in the field “select code” use “Default ino file”, then the error above appears and I can’t flash my device. But when I use “Default cpp file”, there won’t be an error and it works! That might be helpful for other people too. Why is that? In my opinion, a .ino-File in the directory is slightly easyer to handle than a .cpp and a .h file, isn’t it?

        And there is also another thing: When I want to add a new Source File (Sketch), do I really need to add a whole new Project? I mean, isn’t a project a collection of related sketches or code-files instead of just one file? Big applications might become messy if you need to add a new project for every application part.

        But anyway, I’m quite glad that it works now. Have been trying around for a while. Eclipse is so much more comfortable than the common Arduino IDE!

        Thank you for your effort!

        Kind regards

      • Aha. .ino files. The ability for .ino files was added to the plugin after I wrote these instructions and in general I don’t use .ino files.
        I am glad you figured this out!

        You can add .cpp and .h files to a project. I am not sitting on my Mac right now and cannot exactly remeber how to do it, but it can be done. Usually you would only have one .ino file and one or more .cpp and .h file, equivalently to the Arduino IDE I guess. I’ve stopped working with the Arduino IDE Because working with the Ardno IDE when developing libraries became a frustrating hassle.
        I’ve learned more about what goes on under the hood of Arduino once I started using the Eclipse Plugin.
        You may want to read through the documentation on the Eclipse Arduino sit in reference to the .ino files. The only time I personally would use a .ino file is when I create an tutorial for general Arduino code.

        Also, thanks for the feedback after you got it to work! Very much appreciated!

  7. I Installed Arduiono 1.6.1, Teensyduino 1.2.1 and Eclipse (eclipse-cpp-luna-SR2-win32-x86_64).
    Furthermore i had to copy the make-file Folder into the Arduino-Folder from Version 1.5.6-r2 due to those are missing in later Versions.
    I am a newbie and it took me quite some time to get so far.

    Now i try to compile this simple Hello World program:

    // Do not remove the include below
    #include “test1.h”

    int led = 13;

    void setup()
    pinMode(led, OUTPUT);

    void loop()
    digitalWrite(led, HIGH);
    digitalWrite(led, LOW);

    I get the following Error:

    Starting combiner
    “C:/Arduino/hardware/tools/arm/bin/arm-none-eabi-gcc” -Os -Wl,–gc-sections,–relax,–defsym=__rtc_localtime= “-T/mk20dx256.ld” –specs=nano.specs -mthumb -mcpu=cortex-m4 -o “G:/Daten/uC/ArduinoWorkspace/test1/Release/test1.elf” ./test1.cpp.o G:/Daten/uC/ArduinoWorkspace/test1/Release/ “G:/Daten/uC/ArduinoWorkspace/test1/Release/” “-LG:/Daten/uC/ArduinoWorkspace/test1/Release” -larm_cortexM4l_math -lm
    c:/arduino/hardware/tools/arm/bin/../lib/gcc/arm-none-eabi/4.8.4/../../../../arm-none-eabi/bin/ld.exe:–defsym:1: syntax error
    collect2.exe: error: ld returned 1 exit status
    make: *** [test1.elf] Error 1

    I’m lost now. Has somebody any ideas?
    Thanks in advance!

    • Hi Ralph,

      I have not upgraded my own development system and cannot make any specific comments.
      PJRC is very close to releasing Teensyduino 1.22. It may perhaps be release this weekend. Then I’ll try out Arduino 1.6.3 in conjunction with Teensyduino 1.22.

      Once I have successfully created that I will update the instructions – they should get much simpler – and re-post here. So don’t despair, just have a little patience. If you are beginner as you state you should have enough stuff to play with by using the Arduino IDE.
      Once that IDE has thoroughly frustrated by the Arduino IDE you’ll appreciate the Eclipse Arduino IDE even more.

      Viele Gruesse!

  8. Hi trippylighting,

    Thanks a lot for the answer. I look forward to the updates.
    You are right. I can play well with the Arduino Editor meanwhile.

    Viele Grüsse!

    • I’ve got the Blink sketch compiled, uploaded and working on Teensy 3 and Teensy LC on Mac OS X 10.10.2 and Windows 7 (32 bit).
      These are the software versions installed:
      Arduino 1.6.3
      Teensyduino 1.22
      Arduino Eclipse 2.4 Nightly Build from 01-Apr-2015

      You need to put “C:\Program Files\Arduino\hardware” into “Private hardware path”

      On Windows a “make” tool is needed. You can copy the necessary files from Arduino 1.5.6 beta into the new Arduino 1.6.3.
      “C:/Arduino/hardware/tools/avr/utils/bin”> I simply copied the utils folder + contents into the same location in Arduino 1.6.3.

  9. It works now for me too.
    In “Help” –> “Install new software” i changed the path from “” to “” to get the update “Arduino Eclipse 2.4 Nightly Build from 01-Apr-2015”.
    Furthermore i put “C:\Program Files\Arduino\hardware” into “Private hardware path”, as you recommended.
    Thanks a lot for the hints. 🙂
    Grüsse Ralph

  10. Hi, i am having Issues with the plugin and already tried many things that didn’t help (just switched to nightly build) but nothing helps.
    It would be great if you could take a look at it!

    I have posted it on StackOverflow:


    • Hi Pawel,

      commenting on what you posted on Stackoverflow the only correct thing you did was posting on my blog.
      I posted new installation instructions with the newest version of everything needed:

      While those instructions do not directly cover Linux, for previous version the instructions also worked with Linux.

      If you are new to the Arduino Eclipse world, do NOT use separate installations of Eclipse and the Plugin. Use the Arduino Eclipse IDE which bundles Eclipse and the plugin pre-configured. I’d also recommend you read the instructions on the Eclipse Arduino IDE website. Linux is the home OS of the plugin as Jantje develops the plugin on Linux.

  11. Hello again!
    I’m trying to do some floppy music and I need to install the TimerOne library. But when I add the TimerOne Library Folder to the Arduino library Folder and include it in my FloppyMusic Project (in FloppyMusic.h, not .cpp) I get an error: Unresolved inclusion (he can’t find the library). I’ve put the TimerOne library folder into the folder path stated in Eclipse -> Project -> Properties -> Resource > Linked Resources -> ArduinoLibPath or ArduinoPrivLibPath.
    Is there something I did wrong? Do I need to put it into another folder? I don’t wanna put it into the FloppyMusic project itself because I might like to access the TimerOne library also from other projects.

    • Hi wagner,

      How did you install the timerOne library ? Based on your description I am guessing you are not following the correct process, so please describe in detail how you installed the library.

  12. Hi friends

    i am moni from delhi Thank you for your support. I have been able to compile and upload fine on a teensy 3.1 with the boards.txt and opcodes corr

    Thank you.

  13. hi there…
    I would like to make one project for my graduation in my university
    can I ask you some question for completing this

    I would like call my project is “GARAGE DOOR WITH SMARTPHONE ANDROID”

    This is a simple for you I think..

    Could You help me with this?

  14. Hi there,
    I downloaded both Eclipse C++ IDE’s and eclipse-cpp-luna-SR2
    I tried to do step 7:
    7. Select “Add” to add the download site for the Arduino Eclipse plugin :
    I get the message:
    “There is no categorized items”

    I was also dissapointed to find contrary to comments on some web sites that Arduino is not available with Luna C++ IDE

    I have tried to download your plugging manually from :
    both from windows7 and Ubuntu Linux only to get errors when extracting the files

    Has any one got this to work recently ?
    Am I an idiot ?
    Should I not waist my time using Eclipse and try InteliJ?
    regards and apologies

    • Hi Nico,

      Do you want to use the Arduino Eclipse IDE with the newest Arduino 1.6.7 IDE ?
      What boards do you intend the use it with ?

      It’s not “my” plugin ;-). I’ve just been working with it for 3-4 years and helped a little to incorporate the Teensy boards from and of course I wrote these instructions as there are not a lot of documents around that explain how to install the Arduino Eclipse IDE on a mac.
      The original author of the tool is Jan Baeyens. Mostly he goes by “jantje”. He is not the only person that works on the plugin and there are now several people that help with it.

      At the moment the Arduino Eclipse IDE is being re-written and I am not sure what the latest good version is to work with. I’ve asked jantje, so hang on until I report back with an answer.

      No, you are to an idiot 😉 You’ve just tried things out during a big change in the Arduino Eclipse IDE. However, nothing prevents you from using an alternative tool. I am very happy with the Arduino Eclipse IDE, however it never hurts to check out another tool to find the one that suits your projects best.

  1. Pingback: Programowanie Arduino w Eclipse, czyli Arduino Eclipse IDE »

  2. Pingback: Arduino on Eclipse | Ahmed Adel

Leave a Reply to AK Cancel reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: