SparkFun Qwiic Shield for Teensy Hookup Guide

Pages
Contributors: QCPete
Favorited Favorite 0

Introduction

The SparkFun Qwiic Shield for Teensy and SparkFun Qwiic Shield for Teensy Extended provide an easy-to-assemble way to add the SparkFun Qwiic ecosystem to Teensy development boards. Both of these shields connect the I2C bus (GND, 3.3V, SDA, and SCL) on your Teensy to four SparkFun Qwiic connectors. The Qwiic ecosystem allows for easy daisy chaining so, as long as your devices are on different addresses, you can connect as many Qwiic devices as you'd like.

SparkFun Qwiic Shield for Teensy

SparkFun Qwiic Shield for Teensy

DEV-17119
$4.25 $1.75
1
SparkFun Qwiic Shield for Teensy - Extended

SparkFun Qwiic Shield for Teensy - Extended

DEV-17156
$4.75

Required Materials

To follow along with this tutorial, you will need a Teensy development board with either the "standard" or "extended" form factor. Here are is a collection of the compatible boards. Note, some of them come with headers pre-populated, so keep that in mind when considering which headers to populate on your shield.

Teensy 4.0

Teensy 4.0

DEV-15583
$23.80
15
Teensy 4.1

Teensy 4.1

DEV-16771
$31.50
9
Teensy 4.1 (Headers)

Teensy 4.1 (Headers)

DEV-16996
$35.95
3
Teensy 4.0 (Headers)

Teensy 4.0 (Headers)

DEV-16997
$26.80
2

The Qwiic Shield includes a set of stackable headers to fit the Teensy footprint but you may also need some headers to solder to your Teensy. Or if you would prefer to use another header type for your shield assembly we've listed a few options below:

Break Away Headers - Straight

Break Away Headers - Straight

PRT-00116
$1.75
20
Female Headers

Female Headers

PRT-00115
$1.75
8
Teensy Header Kit

Teensy Header Kit

PRT-13925
$1.50
Now you probably would not want the Qwiic Shield for Teensy if you didn't have any Qwiic products to use with it, right? Well, if you don't have any Qwiic products, the following might not be a bad place to start:

SparkFun GPS Breakout - NEO-M9N, U.FL (Qwiic)

SparkFun GPS Breakout - NEO-M9N, U.FL (Qwiic)

GPS-15712
$69.95
5
SparkFun 16x2 SerLCD - RGB Text (Qwiic)

SparkFun 16x2 SerLCD - RGB Text (Qwiic)

LCD-16397
$21.50
6
SparkFun Qwiic Motor Driver

SparkFun Qwiic Motor Driver

ROB-15451
$19.50
3
SparkFun Cryptographic Co-Processor Breakout - ATECC508A (Qwiic)

SparkFun Cryptographic Co-Processor Breakout - ATECC508A (Qwiic)

DEV-15573
$5.95

You will need some of our Qwiic cables to connect your devices to the shield. Below are a few options:

Qwiic Cable - 50mm

Qwiic Cable - 50mm

PRT-14426
$0.95
Qwiic Cable - 100mm

Qwiic Cable - 100mm

PRT-14427
$1.50

Qwiic Cable - 500mm

PRT-14429
1 Retired

Qwiic Cable - 200mm

PRT-14428
Retired

Lastly, if you want to use a non-Qwiic I2C device, these adapters help to convert it to a Qwiic connector:

SparkFun Qwiic Adapter

SparkFun Qwiic Adapter

DEV-14495
$1.60
4
Qwiic Cable - Breadboard Jumper (4-pin)

Qwiic Cable - Breadboard Jumper (4-pin)

PRT-14425
$1.50

Qwiic Cable - Female Jumper (4-pin)

CAB-14988
Retired

Required Tools

You will need a soldering iron, solder, and general soldering accessories to solder the header pins to the Qwiic shields:

Solder Lead Free - 15-gram Tube

Solder Lead Free - 15-gram Tube

TOL-09163
$3.95
4
Soldering Iron - 30W (US, 110V)

Soldering Iron - 30W (US, 110V)

TOL-09507
$10.95
7

Suggested Reading

If you aren't familiar with the Qwiic system, we recommend reading here for an overview:

Qwiic Connect System
Qwiic Connect System

We would also recommend taking a look at the following tutorials if you aren't familiar with them:

How to Solder: Through-Hole Soldering

This tutorial covers everything you need to know about through-hole soldering.

I2C

An introduction to I2C, one of the main embedded communications protocols in use today.

Getting Started with the Teensy

Basic intro to the Teensy line of products, with soldering and programming suggestions.

Arduino Shields v2

An update to our classic Arduino Shields Tutorial! All things Arduino shields. What they are and how to assemble them.

Hardware Overview

Qwiic Connectors

The Qwiic Shields for Teensy each have four Qwiic connectors on them. The two on the edges are the standard horizontal connectors and the two in the middle are vertical connectors.

Note, the horizontal Qwiic connector on the "top" (aka North end) of the non-extended version is positioned slightly downward to allow space for proper cable insertion, and to avoid any conflicts with the nearby 6-pin header on the edge of the board.

Teensy Qwiic Connectors Teensy Extended Qwiic Connectors

Program Button

Each of these shields have a "PROG" button. This is to allow easier access to a programming button for each time you want to upload to the Teensy. Note, it is electrically in parallel with the "PROG" button on the Teensy boards themselves. This means that you can choose to use either the button on your Teensy or the button on the shield. If your shield is located on top of your Teensy (using stack-able headers), then it will be much more accessible to use the button on the shield, rather than trying to reach under the shield.

Teensy Program Button Teensy Extended Program Button

I2C Jumper

This jumper is a little different than our normal I2C pull up jumpers as it is open by default. The jumper only needs to be closed if your attached I2C device does not have pull up resistors. Essentially all SparkFun I2C breakouts come with pull up resistors on them so if you are using a Qwiic I2C device or another SparkFun I2C device, you can most likely leave it open. When closed, the SDA and SCL lines are pulled to 3.3V by 4.7KΩ resistors. If you have never worked with solder jumpers before, check out this tutorial for some tips and tricks for working with them.

Teensy I2C Jumper Teensy Extended I2C Jumper

External Power Input

These shields include an optional 3.3V power input. The 3.3V pin off of the Teensy is rated to supply 250mA. If your project requires more than that on the Qwiic 3.3V power rail, then you should consider supplying a separate power source and soldering it into the header pins labeled "ALT 3V3". Note, you must also cut the jumper labeled "ISO" to properly isolate the Teensy's 3.3V power rail from your external.

Optional External Power Input Extended Optional External Power Input

Note, when using the external power input header, you may notice a slight voltage drop. This is because we have included a protective diode in the circuit. For most applications, this will be fine to leave in place. For more advanced users, we have included a bypass jumper to easily bypass this jumper and have a direct connection to the 3.3V power net.

Schematic highlight External power input header and bypass jumper

Board Dimensions

The Qwiic Shield for Teensy measures 0.70in x 1.40in (17.78mm x 35.56mm). The extended version measures 0.70in x 2.40in (17.78mm x 60.96mm). Note, because these are such small form factor boards, they do not have any standoff holes. They simply rely on the headers for both electrical connections and "mounting hardware".

Qwiic Shield for Teensy Dimensions Qwiic Shield for Teensy Extended Dimensions

Hardware Assembly

To get started using the Qwiic Shield for Teensy, solder the headers onto your Teensy board and your Qwiic Shield. You may choose to use the included stackable header kit or any combination of male/female breakaway headers. Below we show a couple options using standard breakaway headers. Note, for best access to the program button on the shield and the two vertical Qwiic connectors, it is best to have it be the top of your stack.

Teensy 4.0 and shield with M/F headers soldered into place. Teensy 4.1 and extended shield with M/F headers soldered into place.

Once you have soldered headers to your shield and connected it to your Teensy, it's time to start connecting Qwiic devices! Below you can see an example of each shield connected to the appropriate Teensy (4.0 or 4.1). Here we used our standard breakaway headers along with a couple of Qwiic Devices chained to it.

Teensy Example Hookup Teensy Extended Example Hookup

If you are using the upper-most qwiic connector on the Qwiic Shield for Teensy, please check out the following tips. It helps to bend/curl your Qwiic cable a bit before inserting it into the right-angle connector on the sheild.

Qwiic Cable

Qwiic Cable with a bend.

With the bend in place, you can better align it before inserting it all the way.

Qwiic Cable Being Inserted

Initial alignment.

To avoid stressing the cable wires, it is best to push the Qwiic connector using your fingernails on the sides of the connector plastic. Tweezers can also do the trick.

Qwiic Cable Inserted with Fingernails

Pressing on the sides of the plastic is ideal.

Resources and Going Further

That's a wrap! Your Qwiic Shield for Teensy/Teensy Extended is now ready to connect to any of a host of Qwiic devices SparkFun offers. For more information, take a look at the resources below.

Qwiic Shield for Teensy

Qwiic Shield for Teensy Extended

Even More Resources

If you are having trouble getting your Qwiic devices to connect using your newly assembled Qwiic Shield, you may want to take a look at these tutorials for help troubleshooting and reworking your shield.

Now that you have your Qwiic Shield ready to go, it's time to check out some Qwiic products. Below are a few to get started.

Flexible Qwiic Cable - 50mm

Flexible Qwiic Cable - 50mm

PRT-17260
$1.05
SparkFun Thing Plus - nRF9160

SparkFun Thing Plus - nRF9160

WRL-17354
$139.95
Garmin LIDAR-Lite v4 LED - Distance Measurement Sensor (Qwiic)

Garmin LIDAR-Lite v4 LED - Distance Measurement Sensor (Qwiic)

SEN-18009
$74.95
SparkFun Environmental Sensor - BME688 (Qwiic)

SparkFun Environmental Sensor - BME688 (Qwiic)

SEN-19096
$24.95

Before you go, here are some other tutorials using the Qwiic Connect System you may want to look through:

Qwiic MUX Hookup Guide

Have a bunch of sensors with the same I2C address? Put them on the Qwiic MUX (TCA9548A) to get them all talking on the same bus!

SparkFun Pro nRF52840 Mini Hookup Guide

A hardware overview and hookup guide for the SparkFun Pro nRF52840 Mini -- a breakout for Nordic's impossibly cool Bluetooth/ARM Cortex M4 SoC.

MicroMod Machine Learning Carrier Board Hookup Guide

Get hacking with this tutorial on our Machine Learning Carrier Board!

Qwiic Micro Magnetometer - MMC5983MA Hookup Guide

Let's figure out where we're going with the SparkFun Qwiic Micro Magnetometer - MMC5983MA!