skip navigational linksPJRC
Shopping Cart Checkout Shipping Cost Download Website
Home MP3 Player 8051 Tools All Projects PJRC Store Site Map
You are here: Teensy Getting Started 2: Teensy Loader Mac OS X

PJRC Store
Teensy 3.1, $19.80
Teensy 2.0, $16.00
Teensy++ 2.0, $24.00
USB Cable, $4.00
Teensy
Main Page
Teensy 3.1
Getting Started
How-To Tips
Code Library
Projects
Teensyduino
Reference

Using The Teensy Loader on Mac OS X

Update: Teensy 3.0 is supported by Teensyduino. After installation, Teensy Loader is in hardware/tools. It is run automatically when using Verify or Upload within the Arduino software. This version on this web page has not been updated for Teensy 3.0. Please install Teensyduino to use Teensy 3.0.

Files to download:

When you open the disk image, it contains 1 item, the Teensy Loader application.

You may copy the Teensy Loader to your hard drive, perhaps even add it to your dock. But it will run perfectly directly from the disk image, so just double click it.

Yes, the Teensy Loader is safe, so click Open.

The Teensy Loader should appear as a small window. If the Teensy board is running the LED blink, or not connected, you should see this window.

If HalfKay is running, you should see this. If not, simply make sure your Teensy board is connected, and press the pushbutton to run HalfKay. The Teensy Loader will quickly recognize it.

From the File name, choose "Open HEX File" and open blink_fast.hex, which you downloaded using the link at the top of this page. You can also open the file using the toolbar button, or using drag-and-drop onto the upper portion of the window. When the file is opened, the filename and percentage usage of the Teensy's memory are shown.

Select "Program" from the "Operations" menu, or click the Program button on the tool bar. The download should be very quick, perhaps too fast to see a tiny progress bar appear, but you should see the "Download Complete" message.

Choose "Reboot" from the "Operations" menu, or click the Reboot button on the tool bar. Your Teensy board should immediately begin running the fast LED blink program!

To try Automatic mode, simply click the "Auto" button, or choose "Automatic Mode" from the Operations menu. The Auto button should illuminate bright green. Then, open the slow LED blink HEX file.

When you press the button on your Teensy board, Automatic Mode will quickly program and reboot your board. Normally, while working on a project, you can leave the Teensy Loader in Automatic Mode. Teensy Loader always reads the latest version of your HEX file, so you can just compile your code, then press the pushbutton to program and run your code.

Mac OS 10.4 Tiger (does not work)

Apple changed their HID manager API in 10.5 Leopard. Apple Technical Note 2187 has all the details. Teensy Loader uses this API and the IOHIDDeviceSetReport function to write your code.

Apple's earlier API does not seem to have any functions that can write to HID reports. All functions only read. If you know of any way to set HID reports in Tiger's HID API, please email paul@pjrc.com