Installing Eclipse

Eclipse Install

• Download and extract the latest version of Eclipse Classic for your platform from http://www.eclipse.org.
• Install a recent AVR Toolchain. Windows & OSX users should use Inferno Embedded AVR Tools, as should Linux users if their distro does not include GCC-4.8.
• Install Doxygen

Running Eclipse for the first time

• Download and extract workspace.7z from the bottom of this page. This will give you an Eclipse workspace that is preconfigured with extensive syntax highlighting.
• Launch Eclipse, and select your new workspace
• Extract the eclipse-updatesites.7z archive from the bottom of this page
• We will now be installing the following Eclipse plugins:
  • AnyEdit Tools - cleans up whitespace on save
  • Eclox - provides Doxygen parsing
  • MultiClipboard - provides support for multiple clipboard
  • EGit - manage Git repositories within Eclipse
• Click on "Help", "Install New Software"
• Click on "Available Software Sites", "Import", then select the eclipse-updatesites.xml you extracted earlier
• Exit and restart Eclipse
• Click on "Help", "Install New Software"
• Select the "Anyedit" update site, "Eclipse-3.5-3.7 Plugins", and install "AnyEditTools". Restart when prompted
• Click on "Help", "Install New Software"
• Select the "AVR Eclipse" update site, then "AVR Eclipse Plugin". Restart when prompted
• Click on "Window", "Preferences", "AVR', "Paths" and configure your AVR toolchain. If you are using Inferno Embedded AVR Tools, you should set up the following custom paths (examples are for a 64 bit Windows install):
• Click on "Help", "Install New Software"
• Select the "Eclox" update site, then Eclox". Restart when prompted
• Click on "Help", "Install New Software"
• Select the "Multi Clipboard" update site, then Multi Clipboard. Restart when prompted

Importing Flame

• In Eclipse, select File, Import, Git, Projects from Git, Clone URI, then enter as the uri: http://git.infernoembedded.com/flame.git
• Select "master" as the repository to clone
• Eclipse will spend a while cloning the repository andindexing all the code, then you are ready to compile
• Select all the projects in Project Explorer (or just the projects you care about), right click and select "Build Configurations", "Set Active", "ATmega328P_20MHz" (for the MHVBoard), or whatever is suitable for your target platform

Building Flame

• Right click on "flame" in "Project Explorer", then select "Build Configurations", "Set Active", and choose the build configuration you need. MHVBoard R2/R7 users should choose ATmega328p-20MHz
• Right click on "mhvlib" and select "Build Project"
• The same procedure can be used to build any of the tutorial projects

Uploading to the Microcontroller

• Build your project (see above)
• Right click on the project in "Project Explorer", select "Properties", "AVR", "AVRDude" and select a programmer configuration from the Programmer tab (not the configuration selection on top, which allows you to have multiple configs, we use this to support different microcontrollers)
• You can create a new programmer configuration by selecting "New", and filling out the details from the table below. The supplied workspace already has a few common programmers setups added
• If you are using an MHVBoard (or other bootloader that needs an explicit reset), reset your device
• Right click on the project in "Project Explorer", select "AVR", "Upload Project to Target Device"

Updating Flame

• To fetch the latest version of Flame from the git repository, issue a "git pull" in the flame directory

Useful Information

• Keyboard shortcuts can be configured in Windows, Preferences, General, Keys
• Syntax highlighting can be configured in Windows, Preferences, C/C++, Editor, Syntax Coloring