Arduino TextMate Bundle 1.0a
TextMate is the best editor in human history. Arduino is the easiest embedded platform to dive into. Why don't the two work together? The Arduino TextMate Bundle solves that glaring error, and the universe is thus balanced.
There are other TextMate bundles out there, but they're mostly over two years old and don't work with new Arduino versions. This project aims to remain up-to-date and make embedded as enjoyable as everything else in TextMate.
The little 'a' in '1.0a' stands for 'alpha'. Read that as "might not work for you". It will grow and improve with time, but for now brace yourself for bugs. That means bug reports, feature requests and patches!
As of 1.0a, the bundle can compiles and uploads to the device, provides access to the documentation and highlights syntax correctly.
Installation
- Get the latest Arduino. Version 1.0 and later is supported, and it must be installed to /Applications
- Get TextMate.
- Get the latest Arduino TextMate bundle.
- Extract the zip file to
~/Library/Application Support/TextMate/Bundles/Arduino.tmbundle - If TextMate was open during this process, click Bundles>Bundle Editor>Reload Bundles
- Check the 'Default Environment vars' near the top of
~/Library/Application Support/TextMate/Bundles/Arduino.tmbundle/Support/Makefile. Any you need to override - especially check the ARDUINO_MCU var - can be added in TextMate's Preferences => Advanced => Shell Variables.
Usage
- ⌘U Compiles and uploads your sketch to the connected Arduino
- ⌃⌥⌘H Opens up local HTML documentation on to current word
- Bundles > Arduino > Watch Serial Port Opens a terminal window monitoring the serial port.
- File > New From Template > Arduino > Basic Sketch Creates a file with a blank basic sketch.
Shell Variables
The compile/upload process can be finely controlled using TextMate's shell variables.
Textmate > Preferences > Advanced > Shell Variables
| Variable | Value |
|---|---|
| BOARD | The Arduino variant being used. See table below. |
| SERIALDEV | We try to guess the correct serial port. If that is not possible, you have to set the correct serial port. Like: /dev/tty.usbmodem1411 |
Supported Arduino Boards
| Value | Description |
|---|---|
| uno | Arduino Uno |
| atmega328 | Arduino Duemilanove w/ ATmega328 |
| diecimila | Arduino Diecimila or Duemilanove w/ ATmega168 |
| nano328 | Arduino Nano w/ ATmega328 |
| nano | Arduino Nano w/ ATmega168 |
| mega2560 | Arduino Mega 2560 or Mega ADK |
| mega | Arduino Mega (ATmega1280) |
| leonardo | Arduino Leonardo |
| esplora | Arduino Esplora |
| micro | Arduino Micro |
| mini328 | Arduino Mini w/ ATmega328 |
| mini | Arduino Mini w/ ATmega168 |
| ethernet | Arduino Ethernet |
| fio | Arduino Fio |
| bt328 | Arduino BT w/ ATmega328 |
| bt | Arduino BT w/ ATmega168 |
| LilyPadUSB | LilyPad Arduino USB |
| lilypad328 | LilyPad Arduino w/ ATmega328 |
| lilypad | LilyPad Arduino w/ ATmega168 |
| pro5v328 | Arduino Pro or Pro Mini (5V, 16 MHz) w/ ATmega328 |
| pro5v | Arduino Pro or Pro Mini (5V, 16 MHz) w/ ATmega168 |
| pro328 | Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega328 |
| pro | Arduino Pro or Pro Mini (3.3V, 8 MHz) w/ ATmega168 |
| atmega168 | Arduino NG or older w/ ATmega168 |
| atmega8 | Arduino NG or older w/ ATmega8 |
| robotControl | Arduino Robot Control |
| robotMotor | Arduino Robot Motor |
Bleeding Edge
For the adventurous
git clone git://github.com/nasser/arduino.tmbundle.git ~/Library/Application\ Support/TextMate/Bundles/Arduino.tmbundle
Changes
1.0a
- Fixed for Arduino 1.0
- Improved local help command
- Changed versioning scheme to match Arduino's. This bundle's version will always be equal to the version of Arduino it is most compatible with.
0.21a
- Added snippets for common methods
- Added an Arduino project template
- Altered the monitor script - it's now aware of your USB ports
0.2a
- Compile/upload bug fixed
- Syntax highlighting added
- Local help added
- Initial Watch Serial Port implementation
- More intelligent Makefile with environment variable overrides
0.1a
- Initial release, basic implementation of compiling/uploading