manualshive.com logo in svg

sparkfun WIG-13660, Manual, Page: 29 / 32

Share
Download
sparkfun WIG-13660 Manual Download Page 29

The SparkFun Tsunami Qwiic Arduino Library in the Arduino library manager. Click to enlarge)

Users can install this library through the Arduino Library Manager. Search for 

SparkFun Tsunami Qwiic Arduino

Library

 and you should be able to install the latest version. Users who prefer manually downloading the libraries

from the GitHub repository, can download it here:

DOWNLOAD THE SPARKFUN TSUNAMI QWIIC ARDUINO LIBRARY

The utilization of this library mimics the serial control version to allow users to easily transition between the two.
For more details on how to use this library, users can check out the documentation from the serial control library
and the Tsunami user guide.

Tsunami Qwiic Arduino Library Example

Note:

 If users experience problems with the audio output to their headphones, there are different headphone

connector standards that might be the issue. If that is the case, users only need to swap the connection from

SLEEVE

 pin on TRRS 3.5mm breakout board to the 

RING2

 pin.

  

Two of the more common variations of the headphone jack connection standards. (Click to enlarge)  

Source: quora.com

Once you've got the Qwiic version of the library installed, open the 

Example 01 PlayFile

 sketch. You can find it

under

File > Examples > SparkFun Tsunami Super WAV Trigger Qwiic > Examples 

Then load it onto your RedBoard Plus or Uno. Open your favorite Serial Terminal to see the debug output and
trigger the board to reset.

Summary of Contents for WIG-13660

Page 1: ... that make it so versatile Novice users may want to consider the WAV Trigger or MP3 Trigger first The Tsunami Super WAV Trigger Qwiic is a polyphonic WAV file player that was developed in collaboration with Robertsonics a portion of each sale goes back to them for product support and development The Tsunami Super WAV Trigger Qwiic is an improved version of the Tsunami Super WAV Trigger the bigger ...

Page 2: ...SB C and PTH 5 15V micro B USB and PTH 6 15V DC Barrel Jack Tracks Number Layer Mixing Up to 4096 uncompressed files 18 stereo WAV files 32 mono WAV files Up to 4096 uncompressed files 18 stereo WAV files 32 mono WAV files Up to 2048 uncompressed files 14 stereo WAV files Audio Outputs 8 channel Mono 4 channel Stereo 8 channel Mono 4 channel Stereo 3 5mm TRRS Audio Jack Speaker connector PTH Mono ...

Page 3: ...e a few of these items including the required USB C cable so feel free to modify your cart based on your needs Note For the best results we recommend Class 10 SD cards with a FAT16 or FAT32 file system format and a 32kB file allocation size We recommend avoiding The 1GB SparkX SD Card from our catalog since it isn t a Class 10 card and can lead to reliability issues SD Cards with a capacity larger...

Page 4: ...ample a RedBoard Qwiic Plus and Qwiic cable are required There are also alternative part options for this example as well click button below to toggle options Tsunami Super WAV Trigger Qwiic WIG 18159 microSD Card 16GB Class 10 COM 15051 IC Hook Test Leads CAB 00501 microSD USB Reader COM 13004 SparkFun TRRS 3 5mm Jack Breakout BOB 11570 USB 3 1 Cable A to C 3 Foot CAB 14743 ...

Page 5: ...rm utility for generating Tsunami configuration files and updating the firmware All of which can be downloaded from the Robertsonics Tsunami downloads page If you re unfamiliar with serial terminals jumper pads or I C be sure to checkout some of these foundational tutorials SparkFun Qwiic Cable Kit KIT 15081 SparkFun RedBoard Plus DEV 18158 USB 3 1 Cable A to C 3 Foot CAB 14743 2 Logic Levels I2C ...

Page 6: ...s tutorial will show you how to communicate with your serial devices using a variety of terminal emulator applications How to Solder Through Hole Soldering This tutorial covers everything you need to know about through hole soldering SD Cards and Writing Images How to upload images to an SD card for Raspberry Pi PCDuino or your favorite SBC MIDI Tutorial Understanding the Musical Instrument Digita...

Page 7: ...n Arduino library Installing Arduino IDE A step by step guide to installing and testing the Arduino software on Windows Mac and Linux SparkFun Serial Basic CH340C Hookup Guide SparkFun Serial Basic Breakout takes advantage of USB C and is an easy to use USB to Serial adapter based on the CH340C IC from WCH With USB C you can get up to three times the power delivery over the previous USB generation...

Page 8: ...e compatible with standard 4 40 screws The dimensions for the Qwiic Tsunami Click to enlarge Power WARNING The input voltage on the Qwiic Tsunami is limited to 5 10V while the original Tsunami had a voltage range up to 15V Users swapping or replacing boards should be aware of this change exceeding the input voltage range will damage the board permanently There is a status LED to help make sure tha...

Page 9: ...r system Although it isn t recommended users can modify the 3V3_Qwiic jumper to draw power from the Qwiic connector see jumper section below The Qwiic system is meant to run on 3 3V be sure that another voltage is NOT used with the Qwiic system Polyphonic Engine The operation of the polyphonic engine on the Tsunami is proprietary to Robertsonics While we can t go into exact details on how the boar...

Page 10: ...n allows changing SD cards without power cycle Firmware updates from µSD card No additional hardware required For more details users can checkout the Tsunami product page on the Robertsonics website µSD Card Slot Note For the best results we recommend Class 10 SD cards with a FAT16 or FAT32 file system format and a 32kB file allocation size We recommend avoiding The 1GB SparkX SD Card from our cat...

Page 11: ...to update the firmware from the SD card 1 Hold the USER button down 2 Insert SD card with new firmware tsunamix hex file can have normal operation wav and ini files 3 Press RESET button 4 Wait for successful firmware update status indicator before releasing the USER button The RESET and USER buttons on the Qwiic Tsunami Click to enlarge Status LED New on the Qwiic Tsunami is the RGB status indicat...

Page 12: ... firmware 1 long red Bootloader operation Updating firmware Firmware successfully updated Solid green Error Codes All bootloader blink codes except success repeat forever No µSD card One long blue repeats slow blinking blue µSD card format error card installed but can t read FAT One long red one short red repeats No firmware hex file found or incorrect file contents One long red two short reds rep...

Page 13: ...anently attach an external power source The input voltage range is 5 10V but we recommend providing a 5V supply The power input pins on the Qwiic Tsunami Click to enlarge Audio Pins The audio pins support up to 7 1 channel surround sound or 8 mono channels output and stereo or 2 mono channels line level input Output Channels Note For impedance matching the audio output channels the impedance of th...

Page 14: ...rts mono wav file playback and audio output channels will act independently as eight mono outputs For the best results users should be hooking up the audio outputs to an amplifier or active speakers which include an internal amplifier The audio output pins on the Qwiic Tsunami Click to enlarge Input Channels There are two line level inputs on the Qwiic Tsunami The inputs have capacitors to negate ...

Page 15: ...ns are active high and are triggered by pulling the pins low The trigger pins on the Qwiic Tsunami Click to enlarge Serial Control Note Any inputs to the Qwiic Tsunami must use 3 3V logic levels otherwise users risk permanently damaging their board Users have the option of controlling the Qwiic Tsunami through the serial pins Users can directly connect a USB to serial UART bridge like the Serial B...

Page 16: ...can be connected with MIDI controllers and instruments users only need to solder the pins to a 5 pin DIN connector For more details users can checkout the Tsunami User Guide and tutorial on the Robertsonics website The MIDI interface pins on the Qwiic Tsunami Click to enlarge Buttons There are two PTH breakouts for the two user buttons These allow users to solder on their own right angle buttons f...

Page 17: ...ltage is NOT used with the Qwiic system New for the Qwiic Tsunami users can now control the board through the an I C protocol The polarized Qwiic connector allows users to easily interface with the Qwiic connect system The Qwiic Tsunami s default I C address is 0x13 7 bit The Qwiic connector on the Qwiic Tsunami Click to enlarge I C Jumpers There are two jumpers on the Qwiic Tsunami I2C 3V3_Qwiic ...

Page 18: ...o the 3 3V input voltage of the Qwiic connect system The 3 3V power jumper on the Qwiic Tsunami Click to enlarge Prepare the μSD Card Format the µSD Card Note For the best results we recommend Class 10 SD cards with a FAT16 or FAT32 file system format and a 32kB file allocation size We recommend avoiding The 1GB SparkX SD Card from our catalog since it isn t a Class 10 card and can lead to reliabi...

Page 19: ...mware on the Qwiic Tsunami will utilize audio wav files and a tsunami ini initialization file The firmware on the Qwiic Tsunami by default is configured to operate in the following manner 1 Default firmware operation filenames matching the trigger inputs will output on the first audio output channel 1L 2 If there is a tsunami ini file on the µSD card on reset the Qwiic Tsunami will operate on its ...

Page 20: ... metadata containing the header infromation i e title artist genre etc The following video gives a brief demonstration of the Audacity export process Exporting from Audacity to Tsunami Click to enlarge Note For users curious about the header contents Rail John Rogut has written the Header Investigator application which can display Pro Tools region information and BWF time stamps This extra data mi...

Page 21: ...h the configuration tool users should make sure to select the proper settings for the firmware on the Qwiic Tsunami By default the Qwiic Tsunami factory programmed firmware is configured for the mono setting and the configuration tool settings should match the image below Click to enlarge Below is a comparison of the configuration tool appearance between the mono and stereo settings Users will not...

Page 22: ...he Qwiic Tsunami will operate on its configuration content 3 Any additional changes via I2C or serial commands then take precedence over the initialization file Updating the Firmware When necessary users can easily update the firmware by saving the file to the µSD card The latest firmware for the Qwiic Tsunami can be found on Robertsonics website The file name needs to be changed to tsunami hex fo...

Page 23: ... their configured µSD card with wav files and connect their headphones to the Qwiic Tsunami Inserting the µSD Card Inserting the µSD card prepared from the previous section is straight forward The µSD card slot contains a spring loaded locking mechanism Insert the card and press in to lock the card into the slot Press in to unlock and remove the card from the slot The inserting an µSD card into th...

Page 24: ...cables Connect the TRRS 3 5mm jack breakout board to the Qwiic Tsunami as illustrated below Connect three of the IC hook cables to the TIP RING1 and SLEEVE pins on the TRRS headphone jack breakout board Connect the other end of the cables to the 1L 1R and GND audio output pins of the Qwiic Tsunami Attaching the IC hooks to the TRRS headphone jack breakout board Click to enlarge A close up of the I...

Page 25: ...m jack breakout board The overall hardware assembly should resemble the image below Completed assembly with headphones attached and the Qwiic Tsunami powered through a USB cable Click to enlarge For a more permanent solution users can solder the boards together with hook up wire Assembly for Arduino Qwiic Example The assembly for the example in the Arduino library section is similar to the previou...

Page 26: ...Qwiic Tsunami to other MIDI devices will need to solder the MIDI pins to a 5 pin DIN connector For more information users can check out the original Tsunami hookup guide our MIDI tutorial and the Tsunami user guide Basic Operation Example Attaching a MIDI connector to the Qwiic Tsunami Click to enlarge A close up of the MIDI connector pins Click to enlarge ...

Page 27: ...ge Source quora com The simplest way to utilize the Qwiic Tsunami is with the trigger pins The trigger pins are active high by default therefore the pins need to be shorted to ground for the board to react As a simple demonstration use one of the IC hook cables to bridge a trigger input to the corresponding ground pads Triggering the Qwiic Tsunami to play a wav file Click to enlarge Once the wire ...

Page 28: ...be controlled from the serial connection with the Tsunami Arduino serial library For more details on how to utilize this library please refer to the Tsunami user guide and tutorial which are available on the Robertsonics website DOWNLOAD THE TSUNAMI ARDUINO SERIAL LIBRARY I C Qwiic Control Unlike the original Tsunami the Qwiic Tsunami now has a Qwiic connector and therefore the board can be contro...

Page 29: ...umentation from the serial control library and the Tsunami user guide Tsunami Qwiic Arduino Library Example Note If users experience problems with the audio output to their headphones there are different headphone connector standards that might be the issue If that is the case users only need to swap the connection from SLEEVE pin on TRRS 3 5mm breakout board to the RING2 pin Two of the more commo...

Page 30: ...ormation on the Qwiic Tsunami can be found on the Robertsonics website including instructions for serial control and MIDI implementation Other useful resources include Tsunami User Guide Tsunami Product Page and FAQ Robertsonics Tutorial Page Latest Firmware Downloads Page For users looking for technical assistance click on the link There you will find basic troubleshooting tips and instructions t...

Page 31: ...ide Learn how to use the SparkFun Touch Potentiometer to control lighting volume or other inputs in your daily life Si4703 FM Radio Receiver Hookup Guide Add some tunes to your project with the Si4703 FM Radio Receiver Breakout micro bit Educator Lab Pack Experiment Guide A quickstart guide for the micro bit educator lab pack Proto Pedal Assembly and Theory Guide Getting started with the SparkFun ...

Page 32: ...Vibe O Matic 3000 We attempt to emulate a car seat to ease a baby to sleep Papa Soundie Audio Player Hookup Guide Add sound effects to your project prop or costume with Papa Soundie Audio Player ...

Reviews:

No comments