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 | Coming soon! | |
Windows | Tested on 32bit Windows XP | maple-ide-LATEST-windowsxp32.zip (about 70mb) |
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 don't have a JRE and dont know how to get one setup see the installation page.
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. Make sure you actually extract the contents out of the archive instead of running it live out of the archive file.
On Linux only, you'll want to run the
install-udev-rules.sh
at this point; it will ask for root
perimissions. This will grant members of 'plugdev' read/write access to Maple
devices over USB.
On Windows only, you'll have to install drivers; see the installation page. Sorry!
On Mac OS X only, you can just drag and drop the Maple IDE folder to install it in your applications folder. You'll also want to install the serial port driver bundled in the archive, and ignore the ACM modem setup dialog that pops up when you plug in the Maple.
Double click, run from command line, or smash into the stack as appropriate!
delay(1000);
' numbers to a
different value the speed of the blink will change. The value is a time in
milliseconds to pause before continuing with the program, so by default the
LED will be on for 1 second, then off for 1 second, etc.
Next select the Maple board from the Tools pull-down under Board. You have the option between RAM and FLASH programming: FLASH saves the program into permanent memory so the program will be run every time the Maple is reset, while RAM simply injects the compiled program into the processor's memory. Programming to RAM is faster to upload and a buggy program can be wiped away with a simple reset, while FLASH memory is larger and is the only option for permanently uploading a program.
Press the "verify" button (furthest to the left with a "play" arrow) to compile
the code. Unless you've got a persnickety typo you should eventually get back
a confirmation message in the bottom pane.
If all systems are go press the "upload" button (right arrow to a bunch of
dots) to upload your program to the maple. You should see some text and a
progress bar flash by in the status window of the IDE, then some blinky
patterns on the maple, and then a constant blink with whatever time period you
programmed in above.
As a last step to make sure everything has been configured correctly, let's upload a hello world program that will send text from the Maple back to the IDE over the USB connection. From File select Examples, Maple, HelloWorld, and make sure the correct board and serial port targets are selected from the Tools pull-down. And of course you could change the text to be printed out; make sure you leave the double quotes around it though or you'll get a compile error.
Open the serial monitor window (button on the far right) and make sure the 9600
baud speed is selected. Then go back to the code editing window and upload your
program (upload will recompile your code automatically if there's been any
change since the last "verify"). You should get text spit at you over the
serial monitor right after the program is uploaded. Shout back! We can hear
you!
If you blew through this guide and are the kind of person who drinks their coffee straight and has more than than a 100 lines of vim or emacs customization and doesn't even have a mouse plugged into your computer you may want to look at the GNU Toolchain quickstart guide to getting working with your old friends make, jtag, and gcc.
Let us know what you come up with! Tag internet content with #leaflabs, post in the forums, track us down in the real world, whatever. We love projects!
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.