Choose the correct version for your operating system:
|Windows XP (Legacy)||Tested on 32-bit Windows XP. Official Windows support is so far out of date it is effectively non-existent.|
|Linux 32-bit||Tested on Ubuntu 10.04 (32-bit)|
|Linux 64-bit||Tested on Debian Wheezy (64-bit) and Mint 14.1 (64-bit)|
|Mac OS X||Tested on Snow Leopard (10.6); believed to work with more recent versions|
The package bundles together a compiler, an upload utility, a software library, and a simple GUI text editor. All this software is free and open; we are grateful to the Arduino, CodeSourcery, GNU, and OpenMoko developers, as well as many others, who allow us to reuse their software.
Looking for something older? Source archives and binaries are available for previously-released versions.
First, extract all the files in the ZIP file to a suitable location on your system (like your Desktop folder). Next, you have to install some drivers. Sorry!
Note that while these instructions work on Windows XP, changes in Windows 7 (and later) mean that you won’t be able to install the IDE without disabling driver signing on your computer. Users on the forum have reported a workaround, but we only officially support the IDE on 32-bit Windows XP.
First, install DFU drivers (for uploading code to your Maple) using the following steps.
Next, install serial drivers (for communicating with your Maple using serial over USB).
You can now run the Maple IDE by double-clicking on the maple-ide program from within the extracted IDE directory.
The IDE is written in Java and requires a compatible runtime (JRE).
If you don’t have one, they’re usually pretty easy to install. Sun Java 1.6 and OpenJDK 1.6 are known to work, and runtimes mostly compatible with Sun Java 1.5+ should probably get the job done.
To install Java, try using your distribution’s software packaging tool and search for “JRE” or “java”. On Debian-based systems (including Ubuntu) you can try to install the OpenJDK 1.6 JRE with:
$ sudo aptitude install openjdk-6-jre
Extract the tarball to an appropriate location (like your home directory or desktop).
Make sure you have a Java runtime (JRE) installed; if you can run java from the shell, you should be fine.
On 64-bit distros only, you will also need to install some 32-bit libraries needed by the LeafLabs-supported ARM GCC toolchain with
# 64-bit systems only! $ sudo apt-get install ia32-libs
You may also need to remove brltty (if it is installed) with
# Optional $ sudo apt-get remove brltty
Brltty provides braille access to the console. It has been reported to cause conflicts with Maple.
For some non-Debian distributions, you may additionally need to install libusb. Specifically, for 64-bit ArchLinux you need lib32-libusb and lib32-libusb-compat.
Next, run the script install-udev-rules.sh in the extracted IDE directory. It will ask for root permissions (you will be prompted with something along the lines of [sudo] password for <username>:). You now need to restart udev:
# For upstart distros like Ubuntu $ sudo restart udev # For SysV init distros like Debian $ sudo /etc/init.d/udev restart
This will grant members of the group plugdev read/write access to Maple devices over USB. For Debian (and perhaps some versions of Ubuntu and Mint), you want to be in the dialout group. It’s easy to find out: just ls -l /dev/ttyACM0 with the Maple plugged in and see which group owns the device. Make sure that you are in the appropriate group by running, eg, $ sudo adduser <your_username> plugdev (which will ensure access to the Maple, but may report that you are already a member of that group). (For more information on why this is part of the install process, see the Unix toolchain quickstart).
To run the Maple IDE, run ./maple-ide from the shell, or double-click on it if your window system supports it.
Feel free to put the IDE directory wherever you want. As long as you leave its internal structure unchanged, things should be fine.