Teensyduino is a software add-on for the Arduino IDE. Please download the version that corresponds to the version of the Arduino software you are using.

Teensyduino Files:	Teensy Loader Files:
Macintosh OS X Installer for 0018 Macintosh OS X Installer for 0017 Macintosh OS X Installer for 0016 Linux Installer for 0018 Linux Installer for 0017 Linux Installer for 0016 Linux udev rules Windows Installer for 0018 Windows Installer for 0017 Windows Installer for 0016 Windows Serial Installer	Macintosh OS X Teensy Loader Linux Teensy Loader Windows Teensy Loader

Installation Steps

First, you must download the Arudino Software. It is a big ZIP archive. Simply extract the contents, and of course remember the location where you extracted the files.

Second, you must also install the Teensy Loader software. Steps 1 and 2 in the getting started section are highly recommended, to verify that your Teensy board is working properly.

Once you have installed the Arduino Software and the Teensy Loader, run the Teensyduino installer. On Macintosh, it can run directly from the disk image (no need to copy to Applications). On Linux, you may need to change the file's execute permission setting to be able to run it.

The Teensyduino installer should appear. Just click Next.

You must select the location where you extracted the Arduino Software. The Next button will only activate when the installer detects a directory which contains the Arduino Software.

Once you have selected the directory, just click Install.

The installer will copy all the necessary files into your Arduino Software.

When installation is finished, you will see this final screen. Just click Done to quit the installer.

Additional Installation Steps

These additional steps are necessary on specific systems. Future Teensyduino installers will include these steps automatically, but for now you have to do these manually.

Windows

You must also run this Windows Serial Installer. The first time you run a "USB Serial" sketch, the Found New Harware wizard will appear. If this has been run, it will be able to locate the driver (which is actually part of Windows, but the wizard doesn't know that by default).

You must run this as Administrator. On Vista or Windows 7, right click and choose "Run as administrator".

Linux

The udev rule need to be installed in /etc/udev/rules.d/49-teensy.rules.

sudo cp 49-teensy.rules /etc/udev/rules.d/

This udev rule gives you permission to actually use the USB serial device. It also creates a symbolic link using a name the Arduino Software understands (Arduino does not recognize the default name assigned by the linux kernel).

Teensyduino Revision History

Version 0.8

Add support for Teensy++ 2.0

Add support for Arduino 0018

Fix ethernet library

Add Serial.end() - shuts off and disconnects USB, saves power!

Automatically shut down USB when possible

Serial.begin() attempts to wait until PC/Mac has initialized USB

Add Uart.end()

Remove Teensy_Firmata - StandardFirmata branch now supports Teensy

Optimize most functions

Minor bug fixes

Version 0.7

Better error checking when installing files

Do not require rxtx lib on linux, which is removed on 64 bit systems

Fix USB Keyboard/Mouse on Teensy 1.0

Support 8, 4, 2, 1 MHz if specified in boards.txt

Use ADC in high speed mode, makes analogRead() twice as fast

Use lower power idle mode inside delay()

Minor bugs fixed

Version 0.6

Add Keyboard and Mouse board types

Add support for Teensy 2.0 (ATMEGA32U4 chip)

Add support for 0017.

Version 0.5

Add Firmata example

Add USB serial extensions to Serial

Add support for 0016.

Fix Serial.available()

Fix HardwareSerial()

Check Arduino version, do not install onto wrong version!

Version 0.4

Library fixes included, compatible with Sanguino

Add support for 0015.

Update core with improvements and bug fixes from 0012 to 0015.

Many small improvements.....

Version 0.3

Version 0.3 adds support for the Teensy++.

Pin names are now defined automatically. PIN_B0, PIN_C7, etc.

Add support for 0014 (0013 on linux because 0014 was never released on linux).

Version 0.2

Change API to use Serial.print to talk to USB.

Fix pinout

Many bugs fixed

Version 0.1

Initial release

Known Issues

All: If the serial monitor is opened immediately after an upload, the Teensy may not have been detected by the operating system yet, and the serial monitor is unable to open the device. Future versions will retry for several seconds to solve this issue.

Windows & Linux: When using the Serial Monitor with the USB Keyboard/Mouse option, sometimes a "teensy gateway communication error" can occur. Close and reopen the serial monitor to regain communication.

Windows: You may need to run the Teensyduino installer as administrator for it to install all files. Some anti-virus programs can also interfere with installation and must be temporarily disabled.

All: The Upload button can only work if your Teensy is running a previously loaded sketch. If your board can not be rebooted automatically, a message will ask you to press the reset button.

Mac OS X: When you run Arduino after installing Teensyduino, the Leopard's firewall will recognize the program has changed and will ask again if you wish to allow internet connection (Arduino checks for updates). Teensyduino does not "phone home", but Arduino does! TODO: is this still an issue with recent versions of Arduino??

Windows: You can select different drive letters, but the GUI doesn't make it very easy to see how. In the directory pull-down menu, the "blank" option selects a list of the drive letters.

Please report bugs to paul@pjrc.com

Credits

The Teensyduino installer is based in part on the work of the FLTK project (http://www.fltk.org).

Numerous files covered by various open source licenses are installed by Teensyduino. Nearly all are provided in source code form. Please refer to the comments within each file for copyright and licensing information.

Files installed in compiled binary format that are based on code licensed under the GNU General Public License have their corresponding source code installed in a "src" directory. On Macintosh, starting with 0017, use control-click on Arduino.app and select "Show Package Contents" from the menu.