Interactive Map with Circuit Playground Express

Create a map that plays audio clips when different areas of the map are touched

by Dano Wall and

published December 07, 2018, last edited January 20, 2025

posted in CircuitPython Educators Circuit Playground/ Express

Save Download

Beginner

Project guide

CircuitPython Code

makecode_circuitpython_circuit_playground_adafruit_blinka_computer.png

Getting Familiar

CircuitPython is a programming language based on Python, one of the fastest growing programming languages in the world. It is specifically designed to simplify experimenting and learning to code on low-cost microcontroller boards.

CircuitPython is easiest to use within the Mu Editor. If you haven't previously used Mu, this guide will get you started.

If you haven't used Circuit Playground Express and CircuitPython together before, make sure you've updated it with the latest version of CircuitPython. This guide will show you how.

Copy that Code!

Plug your Circuit Playground Express into your computer (mac/PC/Linux) via a known good USB A to micro-B cable. Your board should appear to the computer as a flask disk drive named CIRCUITPY. If you see a disk name CPLAYBOOT, try to press the reset button again. If the only drive name you get is CPLAYBOOT, CircuitPython may not be loaded on the board. You can load CircuitPython per this guide.

Copy code.py from the link below and put it in CIRCUITPY root directory. You can work with this code in any text editing application, or open and save with Mu if you prefer.

Download Project Bundle

Copy Code

# SPDX-FileCopyrightText: 2018 Anne Barela for Adafruit Industries
#
# SPDX-License-Identifier: MIT

# Interactive Map
# for Adafruit Circuit Playground express
# with CircuitPython

from adafruit_circuitplayground.express import cpx

# Change this number to adjust touch sensitivity threshold, 0 is default
cpx.adjust_touch_threshold(600)

WHITE = (30, 30, 30)
RED = (90, 0, 0)
YELLOW = (45, 45, 0)
GREEN = (0, 90, 0)
AQUA = (0, 45, 45)
BLUE = (0, 0, 90)
PURPLE = (45, 0, 45)
BLACK = (0, 0, 0)

cpx.pixels.brightness = 0.1  # set brightness value

# The seven files assigned to the touchpads
audio_file = ["01.wav", "02.wav", "03.wav",
              "04.wav", "05.wav", "06.wav",
              "07.wav"]

# NeoPixel colors
step_col = [RED, YELLOW, GREEN, AQUA, BLUE, PURPLE, WHITE]

def play_it(index):
    cpx.pixels.fill(step_col[index])  # Light lights
    cpx.play_file(audio_file[index])  # play clip
    print("playing file " + audio_file[index])
    cpx.pixels.fill(BLACK)  # unlight lights

while True:
    # playback mode

    if cpx.touch_A1:
        play_it(0)
    if cpx.touch_A2:
        play_it(1)
    if cpx.touch_A3:
        play_it(2)
    if cpx.touch_A4:
        play_it(3)
    if cpx.touch_A5:
        play_it(4)
    if cpx.touch_A6:
        play_it(5)
    if cpx.touch_A7:
        play_it(6)

# SPDX-FileCopyrightText: 2018 Anne Barela for Adafruit Industries
#
# SPDX-License-Identifier: MIT

# Interactive Map
# for Adafruit Circuit Playground express
# with CircuitPython

from adafruit_circuitplayground.express import cpx

# Change this number to adjust touch sensitivity threshold, 0 is default
cpx.adjust_touch_threshold(600)

WHITE = (30, 30, 30)
RED = (90, 0, 0)
YELLOW = (45, 45, 0)
GREEN = (0, 90, 0)
AQUA = (0, 45, 45)
BLUE = (0, 0, 90)
PURPLE = (45, 0, 45)
BLACK = (0, 0, 0)

cpx.pixels.brightness = 0.1  # set brightness value

# The seven files assigned to the touchpads
audio_file = ["01.wav", "02.wav", "03.wav",
              "04.wav", "05.wav", "06.wav",
              "07.wav"]

# NeoPixel colors
step_col = [RED, YELLOW, GREEN, AQUA, BLUE, PURPLE, WHITE]

def play_it(index):
    cpx.pixels.fill(step_col[index])  # Light lights
    cpx.play_file(audio_file[index])  # play clip
    print("playing file " + audio_file[index])
    cpx.pixels.fill(BLACK)  # unlight lights

while True:
    # playback mode

    if cpx.touch_A1:
        play_it(0)
    if cpx.touch_A2:
        play_it(1)
    if cpx.touch_A3:
        play_it(2)
    if cpx.touch_A4:
        play_it(3)
    if cpx.touch_A5:
        play_it(4)
    if cpx.touch_A6:
        play_it(5)
    if cpx.touch_A7:
        play_it(6)

Once the code is saved to CIRCUITPY, drag your audio files over too. You should be able to test that they play by touching the capacitive pads, the miniature speaker on the board will play them (but for higher fidelity and more volume, connecting external speakers is recommended).

circuitpython_Screen_Shot_2018-12-05_at_12.32.08_PM.png

Troubleshooting

Problem: My Circuit Playground Express isn't recognized by Mu!

Solution: Make sure your board is set up with CircuitPython, which has the Circuit Playground Express show up as a flash drive named CIRCUITPY when you connect the CPX to your computer. If it is showing up as CPLAYBOOT on your computer, you can follow the steps in this guide to ensure CircuitPython is loaded and you see the CIRCUITPY drive.

Problem: I can't hear any audio!

Solution: Check that your Circuit Playground Express is connected to your battery pack and the slide switch on pack is set to "ON".

Problem: I STILL can't hear any audio!

Solution: Check that your audio files are all named correctly, 01.wav to 07.wav. Don't forget those leading zeroes!

Page last edited January 20, 2025