Add Audio
Ensure your created sound clips are numbered 01.wav to 32.wav (don't forget those leading zeroes!). They all must be 16 Bit, 22KHz WAV files in mono (single channel audio) or stereo (2 channel audio) and cannot be mixed mono & stereo.
Connect your NeoTrellis to your computer via a known good USB cable. Your operating system will show a new "thumb drive" named CIRCUITPY is available. If you do not see this happening, visit the NeoTrellis M4 introductory tutorial to ensure CircuitPython has been loaded onto the device.
Next, in your file explorer/Finder, create a folder on the CIRCUITPY flash drive labeled /startrek. You can then drag and drop your audio files into that directory (ensuring the files are named from 01.wav through 32.wav). You can change the name of the folder later in the code if you want.
import time
import board
import audioio
import adafruit_fancyled.adafruit_fancyled as fancy
import adafruit_trellism4
from color_names import * # pylint: disable=wildcard-import,unused-wildcard-import
PLAY_SAMPLES_ON_START = False
SAMPLE_FOLDER = "/startrek/" # the name of the folder containing the samples
# This soundboard can select up to *32* sound clips! each one has a filename
# which will be inside the SAMPLE_FOLDER above, and a *color* in a tuple ()
SAMPLES = [("01.wav", RED),
("02.wav", ORANGE),
("03.wav", YELLOW),
("04.wav", GREEN),
("05.wav", TEAL),
("06.wav", BLUE),
("07.wav", PURPLE),
("08.wav", PINK),
("09.wav", RED),
("10.wav", ORANGE),
("11.wav", YELLOW),
("12.wav", GREEN),
("13.wav", TEAL),
("14.wav", BLUE),
("15.wav", PURPLE),
("16.wav", PINK),
("17.wav", RED),
("18.wav", ORANGE),
("19.wav", YELLOW),
("20.wav", GREEN),
("21.wav", TEAL),
("22.wav", BLUE),
("23.wav", PURPLE),
("24.wav", PINK),
("25.wav", RED),
("26.wav", ORANGE),
("27.wav", YELLOW),
("28.wav", GREEN),
("29.wav", TEAL),
("30.wav", BLUE),
("31.wav", PURPLE),
("32.wav", PINK)]
# For the intro, pick any number of colors to make a fancy gradient!
INTRO_SWIRL = [RED, GREEN, BLUE]
# the color for the selected sample
SELECTED_COLOR = WHITE
# Our keypad + neopixel driver
trellis = adafruit_trellism4.TrellisM4Express(rotation=0)
# Play the welcome wav (if its there)
with audioio.AudioOut(board.A1, right_channel=board.A0) as audio:
try:
f = open("welcome.wav", "rb")
wave = audioio.WaveFile(f)
audio.play(wave)
swirl = 0 # we'll swirl through the colors in the gradient
while audio.playing:
for i in range(32):
palette_index = ((swirl+i) % 32) / 32
color = fancy.palette_lookup(INTRO_SWIRL, palette_index)
# display it!
trellis.pixels[(i%8, i//8)] = color.pack()
swirl += 1
time.sleep(0.005)
f.close()
# Clear all pixels
trellis.pixels.fill(0)
# just hold a moment
time.sleep(0.5)
except OSError:
# no biggie, they probably deleted it
pass
# Parse the first file to figure out what format its in
channel_count = None
bits_per_sample = None
sample_rate = None
with open(SAMPLE_FOLDER+SAMPLES[0][0], "rb") as f:
wav = audioio.WaveFile(f)
print("%d channels, %d bits per sample, %d Hz sample rate " %
(wav.channel_count, wav.bits_per_sample, wav.sample_rate))
# Audio playback object - we'll go with either mono or stereo depending on
# what we see in the first file
if wav.channel_count == 1:
audio = audioio.AudioOut(board.A1)
elif wav.channel_count == 2:
audio = audioio.AudioOut(board.A1, right_channel=board.A0)
else:
raise RuntimeError("Must be mono or stereo waves!")
# Clear all pixels
trellis.pixels.fill(0)
# turn on maybe play all of the buttons
for i, v in enumerate(SAMPLES):
filename = SAMPLE_FOLDER+v[0]
try:
with open(filename, "rb") as f:
wav = audioio.WaveFile(f)
print(filename,
"%d channels, %d bits per sample, %d Hz sample rate " %
(wav.channel_count, wav.bits_per_sample, wav.sample_rate))
if wav.channel_count != channel_count:
pass
if wav.bits_per_sample != bits_per_sample:
pass
if wav.sample_rate != sample_rate:
pass
trellis.pixels[(i%8, i//8)] = v[1]
if PLAY_SAMPLES_ON_START:
audio.play(wav)
while audio.playing:
pass
except OSError:
# File not found! skip to next
pass
def stop_playing_sample(playback_details):
print("playing: ", playback_details)
audio.stop()
trellis.pixels[playback_details['neopixel_location']] = playback_details['neopixel_color']
playback_details['file'].close()
playback_details['voice'] = None
current_press = set()
currently_playing = {'voice' : None}
last_samplenum = None
while True:
pressed = set(trellis.pressed_keys)
#if pressed:
# print("Pressed:", pressed)
just_pressed = pressed - current_press
just_released = current_press - pressed
#if just_pressed:
# print("Just pressed", just_pressed)
for down in just_pressed:
sample_num = down[1]*8 + down[0]
print(sample_num)
try:
filename = SAMPLE_FOLDER+SAMPLES[sample_num][0]
f = open(filename, "rb")
wav = audioio.WaveFile(f)
# is something else playing? interrupt it!
if currently_playing['voice'] != None:
print("Interrupt")
stop_playing_sample(currently_playing)
trellis.pixels[down] = WHITE
audio.play(wav)
# voice, neopixel tuple, color, and sample, file handle
currently_playing = {
'voice': 0,
'neopixel_location': down,
'neopixel_color': SAMPLES[sample_num][1],
'sample_num': sample_num,
'file': f}
except OSError:
pass # File not found! skip to next
#if just_released:
# print("Just released:", just_released)
# check if any samples are done
if not audio.playing and currently_playing['voice'] != None:
stop_playing_sample(currently_playing)
time.sleep(0.01) # a little delay here helps avoid debounce annoyances
current_press = pressed
import time
import board
import audioio
import adafruit_fancyled.adafruit_fancyled as fancy
import adafruit_trellism4
from color_names import * # pylint: disable=wildcard-import,unused-wildcard-import
PLAY_SAMPLES_ON_START = False
SAMPLE_FOLDER = "/startrek/" # the name of the folder containing the samples
# This soundboard can select up to *32* sound clips! each one has a filename
# which will be inside the SAMPLE_FOLDER above, and a *color* in a tuple ()
SAMPLES = [("01.wav", RED),
("02.wav", ORANGE),
("03.wav", YELLOW),
("04.wav", GREEN),
("05.wav", TEAL),
("06.wav", BLUE),
("07.wav", PURPLE),
("08.wav", PINK),
("09.wav", RED),
("10.wav", ORANGE),
("11.wav", YELLOW),
("12.wav", GREEN),
("13.wav", TEAL),
("14.wav", BLUE),
("15.wav", PURPLE),
("16.wav", PINK),
("17.wav", RED),
("18.wav", ORANGE),
("19.wav", YELLOW),
("20.wav", GREEN),
("21.wav", TEAL),
("22.wav", BLUE),
("23.wav", PURPLE),
("24.wav", PINK),
("25.wav", RED),
("26.wav", ORANGE),
("27.wav", YELLOW),
("28.wav", GREEN),
("29.wav", TEAL),
("30.wav", BLUE),
("31.wav", PURPLE),
("32.wav", PINK)]
# For the intro, pick any number of colors to make a fancy gradient!
INTRO_SWIRL = [RED, GREEN, BLUE]
# the color for the selected sample
SELECTED_COLOR = WHITE
# Our keypad + neopixel driver
trellis = adafruit_trellism4.TrellisM4Express(rotation=0)
# Play the welcome wav (if its there)
with audioio.AudioOut(board.A1, right_channel=board.A0) as audio:
try:
f = open("welcome.wav", "rb")
wave = audioio.WaveFile(f)
audio.play(wave)
swirl = 0 # we'll swirl through the colors in the gradient
while audio.playing:
for i in range(32):
palette_index = ((swirl+i) % 32) / 32
color = fancy.palette_lookup(INTRO_SWIRL, palette_index)
# display it!
trellis.pixels[(i%8, i//8)] = color.pack()
swirl += 1
time.sleep(0.005)
f.close()
# Clear all pixels
trellis.pixels.fill(0)
# just hold a moment
time.sleep(0.5)
except OSError:
# no biggie, they probably deleted it
pass
# Parse the first file to figure out what format its in
channel_count = None
bits_per_sample = None
sample_rate = None
with open(SAMPLE_FOLDER+SAMPLES[0][0], "rb") as f:
wav = audioio.WaveFile(f)
print("%d channels, %d bits per sample, %d Hz sample rate " %
(wav.channel_count, wav.bits_per_sample, wav.sample_rate))
# Audio playback object - we'll go with either mono or stereo depending on
# what we see in the first file
if wav.channel_count == 1:
audio = audioio.AudioOut(board.A1)
elif wav.channel_count == 2:
audio = audioio.AudioOut(board.A1, right_channel=board.A0)
else:
raise RuntimeError("Must be mono or stereo waves!")
# Clear all pixels
trellis.pixels.fill(0)
# turn on maybe play all of the buttons
for i, v in enumerate(SAMPLES):
filename = SAMPLE_FOLDER+v[0]
try:
with open(filename, "rb") as f:
wav = audioio.WaveFile(f)
print(filename,
"%d channels, %d bits per sample, %d Hz sample rate " %
(wav.channel_count, wav.bits_per_sample, wav.sample_rate))
if wav.channel_count != channel_count:
pass
if wav.bits_per_sample != bits_per_sample:
pass
if wav.sample_rate != sample_rate:
pass
trellis.pixels[(i%8, i//8)] = v[1]
if PLAY_SAMPLES_ON_START:
audio.play(wav)
while audio.playing:
pass
except OSError:
# File not found! skip to next
pass
def stop_playing_sample(playback_details):
print("playing: ", playback_details)
audio.stop()
trellis.pixels[playback_details['neopixel_location']] = playback_details['neopixel_color']
playback_details['file'].close()
playback_details['voice'] = None
current_press = set()
currently_playing = {'voice' : None}
last_samplenum = None
while True:
pressed = set(trellis.pressed_keys)
#if pressed:
# print("Pressed:", pressed)
just_pressed = pressed - current_press
just_released = current_press - pressed
#if just_pressed:
# print("Just pressed", just_pressed)
for down in just_pressed:
sample_num = down[1]*8 + down[0]
print(sample_num)
try:
filename = SAMPLE_FOLDER+SAMPLES[sample_num][0]
f = open(filename, "rb")
wav = audioio.WaveFile(f)
# is something else playing? interrupt it!
if currently_playing['voice'] != None:
print("Interrupt")
stop_playing_sample(currently_playing)
trellis.pixels[down] = WHITE
audio.play(wav)
# voice, neopixel tuple, color, and sample, file handle
currently_playing = {
'voice': 0,
'neopixel_location': down,
'neopixel_color': SAMPLES[sample_num][1],
'sample_num': sample_num,
'file': f}
except OSError:
pass # File not found! skip to next
#if just_released:
# print("Just released:", just_released)
# check if any samples are done
if not audio.playing and currently_playing['voice'] != None:
stop_playing_sample(currently_playing)
time.sleep(0.01) # a little delay here helps avoid debounce annoyances
current_press = pressed
Making Changes
If you'd like to change the code, you can do so as follows:
The line INTRO_SWIRL = [PINK, TEAL, YELLOW] can be changed to be any three color names listed in color_names.py. You can even put more color values in that file and refer to them in your code.
In the definition of SAMPLES near the top of the code - it lists a file name and the color of the button. Feel free to color the buttons how you wish using the color names in color_names.py.
While Star Trek used lots of primary colors (as an early color TV program), your other soundboards may be different. Say, different shades of green for Teenage Mutant Turtles, etc.
Troubleshooting
You can use the serial capability in Mu or a serial terminal program to connect to the NeoTrellis M4 to interact with the CircuitPython prompt. You can see error messages, restart the program, etc. If you use a terminal program, set it to the COM port that appears when the device is plugged in. In Windows, Device Manager will show a keyboard when NeoTrellis is plugged in. Right click, Properties, Hardware will show the COM port. Connect at 9600 baud.
Problem: I don't see the CIRCUITPY drive when I plug the NeoTrellis M4 into my computer
Solution: Ensure CircuitPython is installed via this guide.
Problem: The code does not run.
Solution: Check the files on the CIRCUITPY drive. /lib should have the latest CircuitPython 4.x libraries, /startrek holds the 32 sound files, code.py and color_names.py should be in the main (root) directory.
Problem: Not enough disk space for all the files.
Solution: You cannot use long stereo clips or songs for each button, there is not enough flash memory space. You can reduce the number of files below 32. You can trim your clips to make them shorter. Or you can ensure all your clips are mono instead of stereo. Advanced users can remove libraries in /lib for sensors that are not used by your device to free up small amounts of flash but please do not delete any libraries used by the program or low level input/output libraries.
Problem: My board isn't booting up!
Solution: Make sure your /lib folder is set up with the libraries in the 4.0 latest release and includes trellism4.mpy in its contents.
Problem: I'm not hearing any sounds!
Solution: Check that all your files are formatted as Stereo 16-bit, 22,050Hz, PCM
