Using the Adafruit STEMMA speaker is as simple as connecting it to your project. Existing audio code works the same way but will use the STEMMA speaker instead. Let's take a look at an example using Circuit Playground Express.

Circuit Playground Express Wiring

First, wire up the STEMMA speaker to a Circuit Playground Express as shown. We suggest using a 3-pin JST to alligator clip cable with the 3-pin JST connector on the STEMMA Speaker.

Circuit Playground Express Example Code

This example uses CircuitPython. If you're not already using CircuitPython, check out this quick-start to get it going.

The first example plays a different tone for each button on the Circuit Playground Express.

Copy the following code to a code.py file on your CIRCUITPY drive:

# SPDX-FileCopyrightText: 2017 Kattni Rembor for Adafruit Industries
#
# SPDX-License-Identifier: MIT

from adafruit_circuitplayground.express import cpx

while True:
    if cpx.button_a:
        cpx.play_tone(260, 1)
    if cpx.button_b:
        cpx.play_tone(292, 1)

# SPDX-FileCopyrightText: 2017 Kattni Rembor for Adafruit Industries
#
# SPDX-License-Identifier: MIT

from adafruit_circuitplayground.express import cpx

while True:
    if cpx.button_a:
        cpx.play_tone(260, 1)
    if cpx.button_b:
        cpx.play_tone(292, 1)

Press each button to play a different tone through your STEMMA speaker.

The second example plays a different wav file for each button on the Circuit Playground Express.

Click the buttons below to download the two wav files and copy them to your CIRCUITPY drive.

Then, copy the following code to a code.py file on your CIRCUITPY drive:

# SPDX-FileCopyrightText: 2017 Kattni Rembor for Adafruit Industries
#
# SPDX-License-Identifier: MIT

from adafruit_circuitplayground.express import cpx

while True:
    if cpx.button_a:
        cpx.play_file("rise.wav")
    if cpx.button_b:
        cpx.play_file("dip.wav")

# SPDX-FileCopyrightText: 2017 Kattni Rembor for Adafruit Industries
#
# SPDX-License-Identifier: MIT

from adafruit_circuitplayground.express import cpx

while True:
    if cpx.button_a:
        cpx.play_file("rise.wav")
    if cpx.button_b:
        cpx.play_file("dip.wav")

Press each button on the Circuit Playground Express to play each file through your STEMMA Speaker.

That's all there is to using your STEMMA Speaker with Circuit Playground Express and CircuitPython!

Further Information

For more information on using the STEMMA Speaker with MakeCode, check out the Music and Sound in MakeCode page of the Make It Sound guide.

For more information on using the STEMMA Speaker with CircuitPython, check out the Music and Sound in CircuitPython page of the Make It Sound guide.