SparkFun Qwiic MP3 Trigger Arduino Library
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!
- /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.
- 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)
- DEV-15165- SparkFun Qwiic MP3 Trigger
- SPX-14808- SparkX MP3 Trigger (buzzing fixed!)
- SPX-14714 - Retired SparkX MP3 Trigger
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 email@example.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.