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 Teensyduino Libraries Firmata

PJRC Store
Teensy 3.6, $29.25
Teensy 3.5, $24.25
Teensy 3.2, $19.80
Teensy LC, $11.65
Teensy 2.0, $16.00
Teensy++ 2.0, $24.00
Teensy
Main Page
Hardware
Getting Started
How-To Tips
Code Library
Projects
Teensyduino
Reference

Firmata Library

Firmata allows you to control your Teensy from Adobe Flash, Puredata, Max/MSP and other applications that use the Firmata communication protocol.

Download: Firmata - Compiled for Teensy
Firmata - Source Code
TODO: Maxuino link
TODO: Pduino - updated for Teensy
TODO: serialproxy & as3glue

Normally you can simply load the compiled Firmata code onto your Teensy using the Teensy Loader, and then concentrate on using one of the software packages that supports Firmata to control your board. You do NOT need to use the Arduino software, unless you want to create a customized version of Firmata, which is rarely needed.

Startup LED Blink

When Firmata boots, it blinks the LED in a pattern to let you know it's running, and give you the version number. Checking the LED blink is a simple way to verify your Teensy is running Firmata, before you attempt to control it from another program on your PC or Mac.

TODO: document LED blink - video? - animated gif??

Communication Port

Windows: must run serial installer - then use device manager to discover COM port number - TODO: document this - get device manager screenshot

Mac: /dev/cu.usbmodem12341

Linux: /dev/ttyACM0 - use "tail -f /var/log/messages" while plugging in the USB cable

Basic Usage - Flash

This page is a work-in-progress.

Basic Usage - Max/MSP

This page is a work-in-progress.

Basic Usage - Puredata

This page is a work-in-progress. TODO: instructions, screenshots, etc.

Known Issues

Firmata allows you to configure each pin, but this communication is only one way, from your PC to the board running Firmata. Your PC can not learn the current configuration of the pins. If you use a program, like Pduino, which shows the state of each pin, its initial configuration is likely NOT the same as your board. The on-screen settings are only the same as your hardware after they have been sent.

PWM only supports up to pin 15, due to a limitation in the Firmata protocol.

Servo motors are only supported on pins 0 to 11.

Please report any bugs to paul@pjrc.com. Please try to include enough information so the bug is "reproducible".

Firmata Resources

Firmata - Official Website

Maxuino

Arduino's Firmata Documentation