Maple Reference Documentation

# Maple Development Reference: Installation

If you still can't get the IDE installed after reading this page, check the troubleshooting page for help with some common problems. If all else fails try google, our forum, or contact us directly!

- Download
- Java
- Linux Directions
- Windows Directions
- Mac OSX Directions

## Download

The latest binary release of the Maple IDE for popular platforms can be downloaded straight from LeafLabs's server using the links below. The package bundles together a compiler, an upload utility, a software library, and a simple GUI text editor to tie it all together.

All this software is free and open, feel free to redistribute, hack, and generally mess around with it! We're grateful to the Arduino, Codesourcery, GNU, and OpenMoko developers, as well as many others, who allow us to reuse their software.

Linux | Tested on Ubuntu 9.10 (64bit) and 10.04 (32bit) | maple-ide-LATEST-linux32.tgz (about 30mb) maple-ide-LATEST-linux64.tgz (about 30mb)
Mac OSX | Tested on Snow Leopard 10.6 (64bit and 32bit) | maple-ide-LATEST-macosx-10_6.dmg (about 40mb)
Windows | Tested on 32bit Windows XP | maple-ide-LATEST-windowsxp32.zip (about 75mb)

## Java

The IDE is written in Java and requires a compatible runtime (JRE). Our windows release includes runtime, Mac OSX has one installed already, and it's pretty easy to install one on Linux. If you already have a JRE setup you can skip to the next step; Sun Java 1.6 and OpenJDK 1.6 are known to work, and runtimes mostly compatible with Sun Java 1.4+ should probably get the job done.

To install Java on a linux/unix system, try using your distribution's software packaging tool and search for "JRE" or "java". On modern Debian-based systems (including Ubuntu) you can try to install the OpenJDK 1.6 JRE with:

    $ sudo aptitude install openjdk-6-jre

## Linux Directions

Once it's downloaded, you need to chose a place to unzip the IDE. Unless you've got a special place of honor in mind just plop it on your desktop or in your home folder. Your system should have a tool to deal with the file time of the archive (gzipped tar files on Linux, .dmg archives on Mac OSX, and classic .zip files on Windows); make sure you actually extract the contents out of the archive instead of running it live out of the archive file.

On Linux the tar tool can be used from the command line a la:

    $ tar -xvf maple-ide-SOMETHING.tgz

In the long run you might want to move the extracted program around; that's fine, your programs (sketches) and configuration options will be stored in your home folder (changeable in the Preferences menu).

#### Install udev rules

As a security precaution, new USB devices like the Maple are accessible only by the root user on Linux systems. It's thrilling to run around with root permissions every now and then but in the long run it's safer to configure the operating system to allow regular users access to the Maple when it's plugged in.

Enter the unzipped maple-ide folder and run the install-udev-rules.sh script to configure the system so that members of the "plugdev" group can access the maple device automatically; it will ask for root permissions (via "sudo"). Or you can manually copy the `45-maple.rules` file into `/etc/udev/rules.d` and set the appropriate permissions.

If the 'plugdev' group doesn't exist or you are not a member of it, you can create it and add `ben_bitdiddle` a la:

    $ sudo addgroup plugdev
    $ sudo usermod -G plugdev ben_bitdiddle
    $ sudo /etc/init.d/udev restart

If this doesn't work out for you (eg, an error gets thrown or later on you can't upload your program or connect to the serial port), as a temporary or last resort measure you can run the entire IDE as root (`sudo maple-ide`).

## Mac OS X Directions

Once it's downloaded, you need to chose a place to unzip the IDE. Unless you've got a special place of honor in mind just plop it on your desktop or in your home folder. Your system should have a tool to deal with the file type of the archive (.dmg archives on Mac OSX); once the archive is open, you can either drag the Maple IDE folder into the link to your Applications folder for a permanent installation, or drag it to you desktop for now.

In the long run you might want to move the extracted program around; that's fine, your programs (sketches) and configuration options will be stored in your home folder (changeable in the Preferences menu).

An ACM modem setup dialog will pop up everytime you plug in the Maple; if you go to Network Settings and accept the default ("unconfigured") settings the dialog won't pop up and everything will work fine.

## Windows Directions

Once the IDE is downloaded, you need to chose a place to unzip the IDE. Unless you've got a special place of honor in mind just plop it on your desktop or in your home folder. Your system should have a tool to deal with the file time of the archive (classic .zip files on Windows); make sure you actually extract the contents out of the archive instead of running it live out of the archive file.

In the long run you might want to move the extracted program around; that's fine, your programs (sketches) and configuration options will be stored in your home folder (changeable in the Preferences menu).

The Maple runs in one of two modes, and requires drivers for each. After reset, it runs in bootloader mode for about 6 seconds. In this mode, the Maple is configured to act as a DFU (device firmware upgrade) device; this is how it receives code from the host computer. Windows does not come bundled with DFU drivers, so we have provided them using libusb. After the 6 second timeout, Maple will exit DFU mode and jump to whatever code you have uploaded to it. While running your code, another set of drivers are needed to implement the serial over USB (virtual COM) port.

To install the DFU drivers:

1. Plug your maple into the usb port
2. Hit reset a few times and notice the 6 fast blinks followed by some number of slower ones.
3. Hit reset again, and this time push and hold the boot button during the 6 fast blinks. You can release it once the slow blinks start
4. Maple should now be in perpetual bootloader mode. In this mode, Maple stays a DFU device and does not jump to user code until the next reset. This should give you a chance to install the DFU drivers.
5. Windows should now prompt you for some drivers. In the top level directory of the Maple IDE, point windows to `drivers/mapleDrv/dfu/`.

Then, to install the serial drivers:

1. Reset Maple and allow it to exit the bootloader (the slow blinking should stop and transition to something else). If there is no user code currently in memory (there should have been when you got it), then flash some on there using the instruction elsewhere in this document.
2. Once Maple is running some user code, windows should prompt you for more drivers. Point windows to `driver/mapleDrv/serial`.

### About this Document

A more recent version of this document may be available from the LeafLabs website. Our documentation is versioned on github; you can track changes to the master branch at this link.

This documentation is released under a Creative Commons Attribution-Share Alike 3.0 license.

Translations are welcomed; give us a ping to make sure we aren't in the process of revising or editing first.