skip navigational linksPJRC
Shopping Cart Download Website
Home Products Teensy Blog Forum
You are here: Teensy Getting Started 2: Teensy Loader Linux

PJRC Store
Teensy 4.1, $31.50
Teensy 4.0, $23.80
Main Page
Getting Started
How-To Tips
Code Library

Using The Teensy Loader on Ubuntu Linux

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 insta ll Teensyduino to use Teensy 3.0.

Files to download:

Ubuntu and other modern Linux distibutions use udev to manage device files when USB devices are added and removed. By default, udev will create a device with read-only permission which will not allow to you download code. You must place the udev rules file at /etc/udev/rules.d/00-teensy.rules

The file is tar & gzip compressed. Here are sample commands. Please adjust as necessary, for example the download directory.

cd Desktop
sudo cp 00-teensy.rules /etc/udev/rules.d/
tar -xvzf teensy_linux64.tar.gz
./teensy &

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.