Teensy¶

Optimization¶

(valid only for Teensy LC, Teensy 3.0-3.6)

You can control firmware optimization via special macro/define using build_flags in “platformio.ini” (Project Configuration File):

• -D TEENSY_OPT_FASTER, default

• -D TEENSY_OPT_FASTER_LTO

• -D TEENSY_OPT_FAST

• -D TEENSY_OPT_FAST_LTO

• -D TEENSY_OPT_FASTEST

• -D TEENSY_OPT_FASTEST_LTO

• -D TEENSY_OPT_FASTEST_PURE_CODE, valid only for Teensy 3.5-3.6

• -D TEENSY_OPT_FASTEST_PURE_CODE_LTO, valid only for Teensy 3.5-3.6

• -D TEENSY_OPT_DEBUG

• -D TEENSY_OPT_DEBUG_LTO

• -D TEENSY_OPT_SMALLEST_CODE

• -D TEENSY_OPT_SMALLEST_CODE_LTO

The only one macro can be used in per one build environment. Also, you can see verbose build using -v, --verbose option for pio run command.

Example:

Let’s set optimization for the smallest code

[env:teensy_hid_device]
platform = teensy
framework = arduino
board = teensy36
build_flags = -D TEENSY_OPT_SMALLEST_CODE

USB Features¶

If you want to use Teensy USB Features, you need to add special macro/define using build_flags:

• -D USB_SERIAL

• -D USB_KEYBOARDONLY

• -D USB_TOUCHSCREEN

• -D USB_HID_TOUCHSCREEN

• -D USB_HID

• -D USB_SERIAL_HID

• -D USB_MIDI

• -D USB_MIDI4

• -D USB_MIDI16

• -D USB_MIDI_SERIAL

• -D USB_MIDI4_SERIAL

• -D USB_MIDI16_SERIAL

• -D USB_AUDIO

• -D USB_MIDI_AUDIO_SERIAL

• -D USB_MIDI16_AUDIO_SERIAL

• -D USB_MTPDISK

• -D USB_RAWHID

• -D USB_FLIGHTSIM

• -D USB_FLIGHTSIM_JOYSTICK

• -D USB_EVERYTHING

• -D USB_DISABLED

A default macro is set to -D USB_SERIAL if no one is specified.

Example:

[env:teensy_hid_device]
platform = teensy
framework = arduino
board = teensy20
build_flags = -D USB_RAWHID

See Teensy USB Examples.

Uploading using CLI¶

By default the Teensy platform uses the graphical version of the Teensy upload tools. For cases where the GUI tools cannot be used (e.g. headless OS) the native Teensy Loader tool is also available in a command line version which can be enabled directly in your project configuration, for example:

[env:teensy36]
platform = teensy
framework = arduino
board = teensy36
upload_protocol = teensy-cli

Tools & Debug Probes¶

Supported debugging tools are listed in “Debug” column. For more detailed information, please scroll table by horizontal. You can switch between debugging Tools & Debug Probes using debug_tool option in “platformio.ini” (Project Configuration File).

Stable¶

; Latest stable version
[env:latest_stable]
platform = teensy
board = ...

; Custom stable version
[env:custom_stable]
platform = teensy@x.y.z
board = ...

Upstream¶

[env:upstream_develop]
platform = https://github.com/platformio/platform-teensy.git
board = ...

SparkFun¶

Teensy¶