Getting Started with the Teensy

Pages
Contributors: Toni_K, MTaylor
Favorited Favorite 7

Programming

To start working with the Teensy, all you need to do is plug in your USB cable to your computer and your Teensy board. There are two options for programming the Teensy boards - the Arduino IDE or your favorite C compiler.

Arduino IDE

Note: If this is your first time using Arduino, please review our tutorial on installing the Arduino IDE. If you have not previously installed an Arduino library, please check out our installation guide.

Teensyduino Add-On Installation

You will need to download the Teensyduino add-on for Arduino. You can find the Teensyduino download from PJRC here.

Please follow their installation instructions for the most up-to-date version of the Teensyduino. You will also need to select which Teensy-compatible libraries you'd like to install at that time. If you aren't sure which libraries you will want, you can always download them and install them later from the curated list.

Programming the Teensy

When you first plug the Teensy in, the appropriate drivers will be installed (if using a Windows machine). Your Teensy should default to the standard Blink sketch. You should see the LED blinking, as a quick check to make sure your board is functioning.

Open up the Arduino IDE, and select the appropriate Teensy board from the Board menu. This will provide you with additional options in the Tools menu.

Arduino Teensy Options

Drop-down options in Arduino for Teensy boards.

If you would like to use the Teensy as an HID, MIDI, or user interface device (such as a keyboard or mouse), you can select that option from the USB Type menu.

The CPU speed can be changed for low-power applications.

Note: If you are using the Teensy 3.1, you must set the CPU speed to 24MHz or faster for proper functionality.

The Keyboard Layout option can be updated to your preferred style.

If this is the first time uploading, click on the Arduino's Verify button. The Teensy Loader Program will open (if it is not already open) and prompt you to push the pushbutton (the BOOT button). You should see this window:

Teensy Loader

Teensy Loader Window

Verify your example code, and upload to the board as usual in the Arduino IDE. The Teensy Loader Program will also open when pressing the upload button as well. In some cases, you will need to hit the on-board BOOT button once the IDE has compiled the code to finish uploading it to your Teensy. You should only need to do this the first time you upload code for the duration that your Teensy is powered.

C Compiler

This is typically a more advanced option. For step-by-step instructions on using a C-compiler for the Teensy, please check out PJRC's directions here. You will still need to download and install the Teensyduino and modify the Arduino files to use the Makefile for the Teensy boards.

Additional support for other languages is slowly being added. Please check here for more information.

MicroPython

For those that are comfortable with Python language, you can also load MicroPython on the Teensy! Check out the following tutorial for more information on getting started.

How to Load MicroPython on a Microcontroller Board

September 4, 2018

This tutorial will show you how to load the MicroPython interpreter onto a variety of development boards.