SparkFun_Qwiic_MP3_Trigger_Arduino_Library (community library)

Summary

Library for the SparkFun Qwiic MP3 Trigger An Arduino Library for the Qwist MP3 Trigger. Qwiic MP3 Trigger is an easy to use MP3 player that makes loading and playing MP3s easy and fast. Play, pause, stop, volume, and EQ are all digitally controlled over I2C . Available at: https://www.sparkfun.com/products/15165

Example Build Testing

Library Read Me

This content is provided by the library maintainer and has not been validated or approved.

SparkFun Qwiic MP3 Trigger Arduino Library

SparkFun Qwiic MP3 Trigger (image removed)

SparkFun Qwiic MP3 Trigger (DEV-15165)

This repo is the Arduino library that controls the Qwiic MP3 Trigger.

Sometimes you just need an MP3 to play. Whether it's a theme song as you enter the room or a pirate cackling when a dollar gets donated to the kid's museum. The Qwiic MP3 Trigger takes care of all the necessary bits, all you need to do is send a simple I2C command and listen.

The Qwiic MP3 Trigger comes loaded with everything a user may need. Connecting a USB C cable enumerates the Qwiic MP3 Trigger as a jump drive. Simply plug in the Qwiic MP3 Trigger and you'll be transferring MP3s. No need for drivers and no need for WAV or Vorbis conversion! Sound output is provided via a headphone jack or poke-home connector allowing an external speaker to be connected without soldering. The speaker is boosted by a Class-D mono amplifier capable of outputting up to 1.4W. What does 1.4W mean? It's incredibly loud; great for making sure your mech effects are heard on the *con floor and wonderful for annoying your officemates. Volume is software selectable between 32 levels. Equalization can be tuned to be sure your classical hits sound different from your jazz dance routines (in all seriousness EQ selection is available but it's pretty paltry).

And if you don't want to deal with any programming, there are four trigger pins. When pin 3 is pulled low the T003.mp3 file will immediately be played. This allows you to start playing sound effects with the touch of a button! By pulling multiple pins down simultaneously the four triggers can play up to ten tracks: T001 to T010.

All settings including volume, EQ, and I2C address are stored in NVM and loaded at each power up. The I2C address of the Qwiic MP3 Trigger can be modified via a solder jumper or be assigned using a software command. Multiple Qwiic MP3 Triggers can be chained together on a single bus allowing for simultaneous track mixing and triggering.

We've written an extensive Arduino library to make MP3 playing over I2C a breeze. Play track X, change volume, play next/previous, check if track is playing, stop play, change EQ, and change I2C address are all supported.

This board is one of our many Qwiic compatible boards! Simply plug and go. No soldering, no figuring out which is SDA or SCL, and no voltage regulation or translation required!

The I2C address of Qwiic MP3 Trigger is software configurable which means you can hookup over 100 on a single I2C bus!

Repository Contents

• /examples - Example sketches for the library (.ino). Run these from the Arduino IDE.
• /src - Source files for the library (.cpp, .h).
• keywords.txt - Keywords from this library that will be highlighted in the Arduino IDE.
• library.properties - General library properties for the Arduino package manager.

Documentation

• Qwiic MP3 Trigger Hookup Guide - Hookup guide for the Qwiic MP3 Trigger
• Installing an Arduino Library Guide - Basic information on how to install an Arduino library.
• Product Repository - Main repository (including hardware files)

Product Versions

• DEV-15165- SparkFun Qwiic MP3 Trigger
• SPX-14808- SparkX MP3 Trigger (buzzing fixed!)
• SPX-14714 - Retired SparkX MP3 Trigger

License Information

This product is open source!

Please review the LICENSE.md file for license information.

If you have any questions or concerns on licensing, please contact techsupport@sparkfun.com.

Please use, reuse, and modify these files as you see fit. Please maintain attribution to SparkFun Electronics and release any derivative under the same license.

Distributed as-is; no warranty is given.

• Your friends at SparkFun.

Browse Library Files