Interface Driver to the VS10xx chip on the SPI. More...

#include <vs1053_avr_renesas_uno.h>

Classes
union	sci_bass_m
	A handler for accessing nibbles of the SCI_BASS word. More...

Public Member Functions
uint8_t	begin ()
	Initialize the MP3 Player shield.
void	end ()
	Disables the MP3 Player shield.
uint8_t	vs_init ()
	Initialize the VS10xx Audio Decoder Chip.
void	setVolume (uint8_t, uint8_t)
	Store and Push member volume to VS10xx chip.
void	setVolume (uint16_t)
	Overload function of vs1053::setVolume(leftchannel, rightchannel)
void	setVolume (uint8_t)
	Overload function of vs1053::setVolume(leftchannel, rightchannel)
uint16_t	getTrebleFrequency ()
	Get the current Treble Frequency limit from the VS10xx chip.
int8_t	getTrebleAmplitude ()
	Get the current Treble Amplitude from the VS10xx chip.
uint16_t	getBassFrequency ()
	Get the current Bass Frequency limit from the VS10xx chip.
int8_t	getBassAmplitude ()
	Get the current Bass boost amplitude from the VS10xx chip.
void	setTrebleFrequency (uint16_t)
	Set the current treble frequency limit in VS10xx chip.
void	setTrebleAmplitude (int8_t)
	Set the current Treble Amplitude in VS10xx chip.
void	setBassFrequency (uint16_t)
	Set the current Bass Boost Frequency limit cutoff in VS10xx chip.
void	setBassAmplitude (uint8_t)
	Set the current Bass Boost amplitude in VS10xx chip.
void	setPlaySpeed (uint16_t)
	Set the current playSpeed of the VS10xx chip.
uint16_t	getPlaySpeed ()
	Get the current playSpeed from the VS10xx chip.
uint16_t	getVolume ()
	Get the current volume from the VS10xx chip.
uint8_t	getEarSpeaker ()
	Get the current Spatial EarSpeaker setting from the VS10xx chip.
state_m	getState ()
	Get the current state of the device.
void	setEarSpeaker (uint16_t)
	Set the current Spatial EarSpeaker setting of the VS10xx chip.
uint16_t	getMonoMode ()
	Get the current Stereo/Mono setting of the VS10xx output.
void	setMonoMode (uint16_t)
	Set the current Stereo/Mono setting of the VS10xx output.
void	setDifferentialOutput (uint16_t)
	Set the current SM_DIFF setting of the VS10xx chip.
uint8_t	getDifferentialOutput ()
	Get the current SM_DIFF setting from the VS10xx chip.
uint8_t	playTrack (uint8_t)
	Begin playing a mp3 file, just with a number.
uint8_t	playMP3 (char *, uint32_t timecode=0)
	Begin playing a mp3 file by its filename.
void	trackTitle (char *)
	Get Track's Title.
void	trackArtist (char *)
	Get Track's Artist.
void	trackAlbum (char *)
	Get Track's Album.
void	stopTrack ()
	Gracefully close track and cancel refill.
uint8_t	isPlaying ()
	Inidicate if a song is playing?
uint8_t	skip (int32_t)
	Skips to a duration in the track.
uint8_t	skipTo (uint32_t)
	Skips to a certain point in the track.
uint32_t	currentPosition ()
	Current timecode in ms.
void	setBitRate (uint16_t)
	Force bit rate.
void	pauseDataStream ()
	Pause streaming data to the VSdsp.
void	resumeDataStream ()
	Unpause streaming data to the VSdsp.
void	pauseMusic ()
	Pause music.
bool	resumeMusic ()
	Resume music from where it was paused.
uint8_t	resumeMusic (uint32_t)
	Resume music from pause at new location.
void	getAudioInfo ()
	Display various Audio information from the VSdsp.
uint8_t	enableTestSineWave (uint8_t)
	Generate Test Sine wave.
uint8_t	disableTestSineWave ()
	Disable Test Sine wave.
uint16_t	memoryTest ()
	Perform Memory Test.
uint8_t	ADMixerLoad (char *)
	Initially load ADMixer patch and configure line/mic mode.
void	ADMixerVol (int8_t)
	Set ADMixer's attenuation of input to between -3 and -31 dB otherwise disable.
int8_t	getVUmeter ()
	get the status of the VSdsp VU Meter
int8_t	setVUmeter (int8_t)
	enable VSdsp VU Meter
int16_t	getVUlevel ()
	get current measured VU Meter
void	SendSingleMIDInote ()
	Play hardcoded MIDI file.

Static Public Member Functions
static void	available ()
	Public interface of refill.

Private Member Functions
void	getTrackInfo (uint8_t, char *)
	Fetch ID3 Tag information.
void	getBitRateFromMP3File (char *)
	Read the Bit-Rate from the current track's filehandle.
uint8_t	VSLoadUserCode (char *)
	load VS1xxx with patch or plugin from file on SDcard.

Static Private Member Functions
static void	refill ()
	Refill the VS10xx buffer with new data.
static void	flush_cancel (flush_m)
	flush the VSdsp buffer and cancel
static void	spiInit ()
	Initialize the SPI for VS10xx use.
static void	cs_low ()
	Select Control Channel.
static void	cs_high ()
	Deselect Control Channel.
static void	dcs_low ()
	Select Data Channel.
static void	dcs_high ()
	Deselect Data Channel.
static void	Mp3WriteRegister (uint8_t, uint8_t, uint8_t)
	Write a value a VSDsp's register.
static void	Mp3WriteRegister (uint8_t, uint16_t)
	uint16_t Overload of vs1053::Mp3WriteRegister
static uint16_t	Mp3ReadRegister (uint8_t)
	Read a VS10xx register.
static uint16_t	Mp3ReadWRAM (uint16_t)
	Read a VS10xx WRAM Location.
static void	Mp3WriteWRAM (uint16_t, uint16_t)
	Write a VS10xx WRAM Location.
static void	enableRefill ()
	Enable the Interrupts for refill.
static void	disableRefill ()
	Disable the Interrupts for refill.

Private Attributes
uint8_t	bitrate
	contains a local value of the beleived current bit-rate.
uint32_t	start_of_music
	contains a filehandles offset to the begining of the current file.
uint8_t	VolL
	contains a local value of the VSdsp's master volume left channels
uint8_t	VolR
	contains a local value of the VSdsp's master volume Right channels

Static Private Attributes
static SdFile	track
	Initializer for the instance of the SdCard's static member.
static state_m	playing_state
	Boolean flag indicating if filehandle is streaming.
static uint32_t	spi_Max_Rate
	Rate of the SPI to be used with communicating to the VSdsp.
static uint8_t	mp3DataBuffer [32]
	Buffer for moving data between Filehandle and VSdsp.

Detailed Description

Interface Driver to the VS10xx chip on the SPI.

Definition at line 675 of file vs1053_avr_renesas_uno.h.

Member Function Documentation

◆ ADMixerLoad()

uint8_t vs1053::ADMixerLoad ( char * fileName )

Initially load ADMixer patch and configure line/mic mode.

Parameters

[out] fileName pointer of a char array (aka string), contianing the filename

Loads a patch file of Analog to Digital Mixer. Current available options are as follows:

"admxster.053" Takes both ADC channels and routes them to left and right outputs.
"admxswap.053" Swaps both Left and Right ADC channels and routes them to left and right outputs.
"admxleft.053" MIC/LINE1 routed to both left and right output
"admxrght.053" LINE2 routed to both left and right output
"admxmono.053" mono version mixes both left and right inputs and plays them using both left and right outputs.

And subsequently returns the following result codes.

Returns

Any Value other than zero indicates a problem occured.

0 indicates that upload was successful.
1 indicates the upload can not be performed while currently streaming music.
2 indicates that desired file was not found.
3 indicates that the VSdsp is in reset.

Definition at line 2206 of file vs1053_avr_renesas_uno.cpp.

◆ ADMixerVol()

void vs1053::ADMixerVol ( int8_t ADM_volume )

Set ADMixer's attenuation of input to between -3 and -31 dB otherwise disable.

Parameters

[in] ADM_volume -3 through -31 dB of attentuation.

Will range check the requested value and for values out of range the VSdsp's ADMixer will be disabled. While valid ranges will write to VSdsp's current operating volume and enable the the ADMixer.

Warning: If file patch not applied this call will lock up the VS10xx. need to add interlock to avoid.

Definition at line 2243 of file vs1053_avr_renesas_uno.cpp.

◆ available()

void vs1053::available ( )

static

Public interface of refill.

Serves as a helper as to correspondingly run either the timer service or run the refill() direclty, depending upon the configured means for refilling.

Definition at line 1956 of file vs1053_avr_renesas_uno.cpp.

◆ begin()

uint8_t vs1053::begin ( )

Initialize the MP3 Player shield.

Execute this function before anything else, typically during setup(). It will bring the VS10xx out of reset, initialize the connected pins and then ready the VSdsp for playback, with vs_init().

Returns: Any Value other than zero indicates a problem occured. where value indicates specific error

See also: end() for low power mode; Error Codes

Warning: Will disrupt playback, if issued while playing back.

Note: The SdFat::begin() function is required to be executed prior, as to define the volume for the tracks (aka files) to be operated on.

Definition at line 139 of file vs1053_avr_renesas_uno.cpp.

◆ cs_high()

void vs1053::cs_high ( )

staticprivate

Deselect Control Channel.

Primative function to Deselect the VS10xx's Control Chip Select as per defined by MP3_XCS.

Definition at line 1759 of file vs1053_avr_renesas_uno.cpp.

◆ cs_low()

void vs1053::cs_low ( )

staticprivate

Select Control Channel.

Primative function to configure the SPI's Mode and rate control to that of the current VX10xx. Then select the VS10xx's Control Chip Select as per defined by MP3_XCS.

Warning: This uses spiInit() which sets the rate fast for write, too fast for reading. In the case of a subsequent SPI.transfer that is reading back data followup with a SPI.setClockDivider(spi_Read_Rate); as not to get gibberish.

Definition at line 1747 of file vs1053_avr_renesas_uno.cpp.

◆ currentPosition()

uint32_t vs1053::currentPosition ( )

Current timecode in ms.

Reads the currenty position from the VSdsp's decode time and converts the value to milliseconds.

Returns: the milliseconds offset of stream played.

Note: SCI_DECODE_TIME is cleared during vs1053::playMP3, as to restart the position for each file stream. Erasing prior streams weight.

Warning: Not very accurate, rounded off to second. And Variable Bit-Rates are completely inaccurate.

Definition at line 1396 of file vs1053_avr_renesas_uno.cpp.

◆ dcs_high()

void vs1053::dcs_high ( )

staticprivate

Deselect Data Channel.

Primative function to Deselect the VS10xx's Control Data Select as per defined by MP3_XDCS.

Definition at line 1785 of file vs1053_avr_renesas_uno.cpp.

◆ dcs_low()

void vs1053::dcs_low ( )

staticprivate

Select Data Channel.

Primative function to configure the SPI's Mode and rate control to that of the current VX10xx. Then select the VS10xx's Data Chip Select as per defined by MP3_XDCS.

Warning: This uses spiInit() which sets the rate fast for write, too fast for reading. In the case of a subsequent SPI.transfer that is reading back data followup with a SPI.setClockDivider(spi_Read_Rate); as not to get gibberish.

Definition at line 1773 of file vs1053_avr_renesas_uno.cpp.

◆ disableRefill()

void vs1053::disableRefill ( )

staticprivate

Disable the Interrupts for refill.

Depending upon the means selected to request refill of the VSdsp's data stream buffer, this routine will disable the corresponding service.

Definition at line 2107 of file vs1053_avr_renesas_uno.cpp.

◆ disableTestSineWave()

uint8_t vs1053::disableTestSineWave ( )

Disable Test Sine wave.

Disable and report the generation of Test Sine Wave as per specified. As specified by Data Sheet Section 9.12.1

Returns

-1 indicates the test can not be performed while currently streaming music or chip is reset.
0 indicates the test is not previously enabled and skipping disable.
1 indicates that test was disabled.

See also: Error Codes

Definition at line 446 of file vs1053_avr_renesas_uno.cpp.

◆ enableRefill()

void vs1053::enableRefill ( )

staticprivate

Enable the Interrupts for refill.

Depending upon the means selected to request refill of the VSdsp's data stream buffer, this routine will enable the corresponding service.

Definition at line 2087 of file vs1053_avr_renesas_uno.cpp.

◆ enableTestSineWave()

uint8_t vs1053::enableTestSineWave ( uint8_t freq )

Generate Test Sine wave.

Parameters

[in] freq specifies the output frequency sine wave.

Enable and/or report the generation of Test Sine Wave as per specified. As specified by Data Sheet Section 9.12.1

Returns

-1 indicates the test can not be performed while currently streaming music or chip is reset.
1 indicates that test has begun successfully.
2 indicates that test is already in progress.

See also: Error Codes

Note: 9.12.5 New Sine and Sweep Tests was not implemented.

Definition at line 394 of file vs1053_avr_renesas_uno.cpp.

◆ end()

void vs1053::end ( )

Disables the MP3 Player shield.

Places the VS10xx into low power hard reset, after polity closing files after releasing interrupts and or timers.

Warning: Will stop any playing tracks. Check isPlaying() prior to executing, as not to stop on a track.

Note: use begin() to reinitialize the VS10xx, for use.

Definition at line 194 of file vs1053_avr_renesas_uno.cpp.

◆ flush_cancel()

void vs1053::flush_cancel ( flush_m mode )

staticprivate

flush the VSdsp buffer and cancel

Parameters

[in] mode is an enumerated value of flush_m

Typically called after a filehandlers' stream has been stopped, as to gracefully flush any buffer contents still playing. Along with issueing a SM_CANCEL to the VSdsp's SCI_MODE register.

post - will flush vx10xx's 2K buffer after cancelled, typically with stopping a file, to have immediate affect.
pre - will flush buffer prior to issuing cancel, typically to allow completion of file
both - will flush before and after issuing cancel
none - will just issue cancel. Not sure if this should be used. Such as in skipTo().

Note: if cancel fails the vs10xx will be reset and initialized to current values.

Definition at line 2134 of file vs1053_avr_renesas_uno.cpp.

◆ getAudioInfo()

void vs1053::getAudioInfo ( )

Display various Audio information from the VSdsp.

Read numerous attributes from the VSdsp's registers about either the currently or prior played stream and display in a column format for easy reviewing.

This may be called while playing a current stream.

Note: this suspends currently playing streams and returns afterwards. Restoring the file position to where it left off, before resuming.

Definition at line 1508 of file vs1053_avr_renesas_uno.cpp.

◆ getBassAmplitude()

int8_t vs1053::getBassAmplitude ( )

Get the current Bass boost amplitude from the VS10xx chip.

Returns: int16_t of bass bost amplitude in dB.

Note: Any value greater then zero enables the Bass Enhancer VSBE is a powerful bass boosting DSP algorithm, which tries to take the most out of the users earphones without causing clipping.

Definition at line 691 of file vs1053_avr_renesas_uno.cpp.

◆ getBassFrequency()

uint16_t vs1053::getBassFrequency ( )

Get the current Bass Frequency limit from the VS10xx chip.

Returns: int16_t of bass frequency limit in Hertz.

Definition at line 673 of file vs1053_avr_renesas_uno.cpp.

◆ getBitRateFromMP3File()

void vs1053::getBitRateFromMP3File ( char * fileName )

private

Read the Bit-Rate from the current track's filehandle.

Parameters

[out] fileName pointer of a char array (aka string), contianing the filename

locate the MP3 header in the current file and from there determine the Bit-Rate, using bitrate_table located in flash. And return the position to the prior location.

Note: the bitrate will be updated, as read back from the VS10xx when needed.

Warning: This feature only works on MP3 files. It will LOCK-UP on other file formats, looking for the MP3 header.

Definition at line 1592 of file vs1053_avr_renesas_uno.cpp.

◆ getDifferentialOutput()

uint8_t vs1053::getDifferentialOutput ( )

Get the current SM_DIFF setting from the VS10xx chip.

Read the VS10xx SCI_MODE register bits SM_DIFF for current SM_DIFF and return its results as a composite integer. To indicate if the Left Channel is either normal or differential output. As specified by Data Sheet Section 8.7.1

Returns

0 for Normal and 1 is Differential Output.

0 Normal in-phase audio output of left and right speaker signals.
1 Left channel output is the invert of the right channel.

See also: setDifferentialOutput()

Definition at line 935 of file vs1053_avr_renesas_uno.cpp.

◆ getEarSpeaker()

uint8_t vs1053::getEarSpeaker ( )

Get the current Spatial EarSpeaker setting from the VS10xx chip.

Read the VS10xx SCI_MODE register bits SM_EARSPEAKER_LO and SM_EARSPEAKER_HIGH for current EarSpeaker and return its results as a composite integer. As specified by Data Sheet Section 8.7.1 and 8.4

Returns: result between 0 and 3. Where 0 is OFF and 3 is maximum.

Definition at line 871 of file vs1053_avr_renesas_uno.cpp.

◆ getMonoMode()

uint16_t vs1053::getMonoMode ( )

Get the current Stereo/Mono setting of the VS10xx output.

Read the VS10xx WRAMADDR bit 0 of para_MonoOutput] for the current Stereo/Mono and return its results as a byte. As specified by VS1053B PATCHES AND FLAC DECODER Data Sheet Section 1.2 Mono output mode.

Returns: result between 0 and 3. Where 0 is OFF and 3 is maximum.

Warning: This feature is only available when composite patch 1.7 or higher is loaded into the VSdsp.

Definition at line 989 of file vs1053_avr_renesas_uno.cpp.

◆ getPlaySpeed()

uint16_t vs1053::getPlaySpeed ( )

Get the current playSpeed from the VS10xx chip.

Read the VS10xx extra parameter memory for playSpeed register and return its results. As specified by Data Sheet Section 9.11.1

Returns: multipler of current playspeed versus normal speed. Where 0 and/or 1 are normal 1x speed. e.g. 4 to playSpeed will play the song four times as fast as normal, if you are able to feed the data with that speed.

Warning: Excessive playspeed beyond the ability to stream data between the SdCard, Arduino and VS10xx may result in erratic behavior.

Definition at line 831 of file vs1053_avr_renesas_uno.cpp.

◆ getState()

state_m vs1053::getState ( )

Get the current state of the device.

Reports the current operational status of the device from the list of possible states enumerated by state_m

Returns: the value held by vs1053::playing_state

Definition at line 1167 of file vs1053_avr_renesas_uno.cpp.

◆ getTrackInfo()

void vs1053::getTrackInfo	(	uint8_t	offset,
		char *	infobuffer )

private

Fetch ID3 Tag information.

Parameters

[in]	offset	for the desired information desired.
[out]	infobuffer	pointer char array of filename to be read.

Read current filehandles offset of track ID3 tag information. Then strip all non readible (ascii) characters.

Note: this suspends currently playing streams and returns afterwards. Restoring the file position to where it left off, before resuming.

Definition at line 1469 of file vs1053_avr_renesas_uno.cpp.

◆ getTrebleAmplitude()

int8_t vs1053::getTrebleAmplitude ( )

Get the current Treble Amplitude from the VS10xx chip.

Returns: int16_t of amplitude (from -8 to 7).

Definition at line 660 of file vs1053_avr_renesas_uno.cpp.

◆ getTrebleFrequency()

uint16_t vs1053::getTrebleFrequency ( )

Get the current Treble Frequency limit from the VS10xx chip.

Returns: int16_t of frequency limit in Hertz.

Definition at line 646 of file vs1053_avr_renesas_uno.cpp.

◆ getVolume()

uint16_t vs1053::getVolume ( )

Get the current volume from the VS10xx chip.

Read the VS10xx SC_VOL register and return its results As specified by Data Sheet Section 8.7.11

Returns: uint16_t of both channels of master volume. Where the left channel is in the upper byte and right channel is in the lower byte.

Note: Input values are -1/2dB. e.g. 40 results in -20dB.; Cast the output to the union of twobyte.word to access individual channels, with twobyte.byte[1] and [0].

Definition at line 628 of file vs1053_avr_renesas_uno.cpp.

◆ getVUlevel()

int16_t vs1053::getVUlevel ( )

get current measured VU Meter

Returns the calculated peak sample values from both channels in 3 dB increaments through. Where the high byte represent the left channel, and the low bytes the right channel.

Values from 0 to 31 are valid for both channels.

Warning: This feature is only available with patches that support VU meter.

Definition at line 1701 of file vs1053_avr_renesas_uno.cpp.

◆ getVUmeter()

int8_t vs1053::getVUmeter ( )

get the status of the VSdsp VU Meter

Returns: responds with the current value of the SS_VU_ENABLE bit of the SCI_STATUS register indicating if the VU meter is enabled.

See data patches data sheet VU meter for details.

Warning: This feature is only available with patches that support VU meter.

Definition at line 1658 of file vs1053_avr_renesas_uno.cpp.

◆ isPlaying()

uint8_t vs1053::isPlaying ( )

Inidicate if a song is playing?

Public method for determining if a file is streaming to the VSdsp.

Returns

0 indicates NO file is currently being streamed to the VSdsp.
1 indicates that a file is currently being streamed to the VSdsp.
3 indicates that the VSdsp is in reset.

Definition at line 1144 of file vs1053_avr_renesas_uno.cpp.

◆ memoryTest()

uint16_t vs1053::memoryTest ( )

Perform Memory Test.

Perform the internal memory test of the VSdsp core processor and resources. As specified by Data Sheet Section 9.12.4

Returns

-1 indicates the test can not be performed while currently streaming music or chip is reset.
1 indicates that test has begun successfully.
2 indicates that test is already in progress.

See also: Error Codes

Definition at line 502 of file vs1053_avr_renesas_uno.cpp.

◆ Mp3ReadRegister()

uint16_t vs1053::Mp3ReadRegister ( uint8_t addressbyte )

staticprivate

Read a VS10xx register.

Parameters

[in] addressbyte of the VSdsp's register to be read

Returns: result read from the register

Primative function to suspend playing and directly communicate over the SPI to the VSdsp's registers.

Definition at line 1860 of file vs1053_avr_renesas_uno.cpp.

◆ Mp3ReadWRAM()

uint16_t vs1053::Mp3ReadWRAM ( uint16_t addressbyte )

staticprivate

Read a VS10xx WRAM Location.

Parameters

[in] addressbyte of the VSdsp's WRAM to be read

Returns: result read from the WRAM

Function to communicate to the VSdsp's registers, indirectly accessing the WRAM. As per data sheet the result is read back twice to verify. As it is not buffered.

Definition at line 1908 of file vs1053_avr_renesas_uno.cpp.

◆ Mp3WriteRegister() [1/2]

void vs1053::Mp3WriteRegister	(	uint8_t	addressbyte,
		uint16_t	data )

staticprivate

uint16_t Overload of vs1053::Mp3WriteRegister

Parameters

[in]	addressbyte	of the VSdsp's register to be written
[in]	data	to writen to the register

Forces the input value into the Big Endian Corresponding positions of Mp3WriteRegister as to be written to the addressed VSdsp's registers.

Definition at line 1799 of file vs1053_avr_renesas_uno.cpp.

◆ Mp3WriteRegister() [2/2]

void vs1053::Mp3WriteRegister	(	uint8_t	addressbyte,
		uint8_t	highbyte,
		uint8_t	lowbyte )

staticprivate

Write a value a VSDsp's register.

Parameters

[in]	addressbyte	of the VSdsp's register to be written
[in]	highbyte	to writen to the register
[in]	lowbyte	to writen to the register

Primative function to suspend playing and directly communicate over the SPI to the VSdsp's registers. Where the value write is Big Endian (MSB first).

Definition at line 1816 of file vs1053_avr_renesas_uno.cpp.

◆ Mp3WriteWRAM()

void vs1053::Mp3WriteWRAM	(	uint16_t	addressbyte,
		uint16_t	data )

staticprivate

Write a VS10xx WRAM Location.

Parameters

[in]	addressbyte	of the VSdsp's WRAM to be read
[in]	data	written to the VSdsp's WRAM

Function to communicate to the VSdsp's registers, indirectly accessing the WRAM.

Definition at line 1943 of file vs1053_avr_renesas_uno.cpp.

◆ pauseDataStream()

void vs1053::pauseDataStream ( )

Pause streaming data to the VSdsp.

Public method for disabling the refill with disableRefill().

Definition at line 1177 of file vs1053_avr_renesas_uno.cpp.

◆ pauseMusic()

void vs1053::pauseMusic ( )

Pause music.

Public method for pausing the play of music.

Note: This is currently equal to pauseDataStream() and is a place holder to pausing the VSdsp's playing and DREQ's.

Definition at line 1215 of file vs1053_avr_renesas_uno.cpp.

◆ playMP3()

uint8_t vs1053::playMP3	(	char *	fileName,
		uint32_t	timecode = 0 )

Begin playing a mp3 file by its filename.

Parameters

[out]	fileName	pointer of a char array (aka string), contianing the filename
[in]	timecode	(optional) milliseconds from the begining of the file. Only works with mp3 files, otherwise do nothing.

Skip, if already playing. Otherwise initialize the SdCard track to desired filehandle. Reset the ByteRate and Play position and set playing to indicate such. If the filename extension is MP3, then pre-read the byterate from the file. And initially fill the VSDsp's buffer, then enable refilling.

Returns: Any Value other than zero indicates a problem occured. where value indicates specific error

See also: Error Codes

Note

Currently bitrate to calculate time offset is determined by either playing files or by reading MP3 headers. Hence only the later is doable without actually playing files. Hence other formats are not available, yet.
enableRefill() will enable the appropiate interrupt to match the corresponding means selected.
use SdFat::chvol() command prior, to select desired SdCard volume, if multiple cards are used.

Definition at line 1074 of file vs1053_avr_renesas_uno.cpp.

◆ playTrack()

uint8_t vs1053::playTrack ( uint8_t trackNo )

Begin playing a mp3 file, just with a number.

Parameters

[in] trackNo integer value between 0 and 9, corresponding to the track to play.

Formats the input number into a corresponding filename, from track001.mp3 through track009.mp3. Then executes the track by calling vs1053::playMP3(char* fileName)

Returns: Any Value other than zero indicates a problem occured. where value indicates specific error

See also: Error Codes

Definition at line 1032 of file vs1053_avr_renesas_uno.cpp.

◆ refill()

void vs1053::refill ( )

staticprivate

Refill the VS10xx buffer with new data.

This the primative function to refilling the VSdsp's buffers. And is typically called as an interrupt to the rising edge of the VS10xx's DREQ. Where if the DREQ is indicating not full, it will read 32 bytes from the filehandle's track and send them via SPI to the VSdsp's data stream buffer. Repeating until the DREQ indicates it is full.

When the filehandle's track indicates it is at the end of file. The track is closed, the playing indicator is set to false, interrupts for refilling are disabled and the VSdsp's data stream buffer is flushed appropiately.

Definition at line 1978 of file vs1053_avr_renesas_uno.cpp.

◆ resumeDataStream()

void vs1053::resumeDataStream ( )

Unpause streaming data to the VSdsp.

Public method for re-enabling the refill with enableRefill(). Where skipped if not currently playing.

Definition at line 1194 of file vs1053_avr_renesas_uno.cpp.

◆ resumeMusic() [1/2]

bool vs1053::resumeMusic ( )

Resume music from where it was paused.

Public method for resuming the play of music from a specific file location.

Returns

0 indicates the position was changed.
1 indicates no action, in lieu of any current file stream.

Note: This is effectively equal to resumeDataStream() and is a place holder to resuming the VSdsp's playing and DREQ's.

Definition at line 1260 of file vs1053_avr_renesas_uno.cpp.

◆ resumeMusic() [2/2]

uint8_t vs1053::resumeMusic ( uint32_t timecode )

Resume music from pause at new location.

Parameters

[in] timecode (optional) milliseconds from the begining of the file.

Public method for resuming the play of music from a specific file location.

Returns

0 indicates the position was changed.
1 indicates no action, in lieu of any current file stream.
2 indicates failure to skip to new file location.

Note: This is effectively equal to resumeDataStream() and is a place holder to resuming the VSdsp's playing and DREQ's.

Definition at line 1235 of file vs1053_avr_renesas_uno.cpp.

◆ SendSingleMIDInote()

void vs1053::SendSingleMIDInote ( )

Play hardcoded MIDI file.

This the primative function to fill the VSdsp's buffers quicly. The intention is to send a quick MIDI file of a single note on and off. This can be used responses to buttons and such. Where the MIDI file is short enough to be stored into an array that can be delivered via SPI to the VSdsp's data stream buffer. Waiting for DREQ every 32 bytes.

Definition at line 2040 of file vs1053_avr_renesas_uno.cpp.

◆ setBassAmplitude()

void vs1053::setBassAmplitude ( uint8_t amplitude )

Set the current Bass Boost amplitude in VS10xx chip.

Parameters

[in] amplitude to Bass Boost amplitude in dB (0dB to 15dB).

Note: Any value greater then zero enables the Bass Enhancer VSBE is a powerful bass boosting DSP algorithm, which tries to take the most out of the users earphones without causing clipping.; The upper and lower limits of this parameter is checked.

Definition at line 791 of file vs1053_avr_renesas_uno.cpp.

◆ setBassFrequency()

void vs1053::setBassFrequency ( uint16_t frequency )

Set the current Bass Boost Frequency limit cutoff in VS10xx chip.

Parameters

[in] frequency of Bass Boost frequency cutoff limit in Hertz (20Hz to 150Hz).

Note: The upper and lower limits of this parameter is checked.

Definition at line 759 of file vs1053_avr_renesas_uno.cpp.

◆ setBitRate()

void vs1053::setBitRate ( uint16_t bitr )

Force bit rate.

Parameters

[in] bitr new bit-rate

Public method for forcing the percieved bit-rate to a desired value. Useful if auto-detect failed

Definition at line 1717 of file vs1053_avr_renesas_uno.cpp.

◆ setDifferentialOutput()

void vs1053::setDifferentialOutput ( uint16_t DiffMode )

Set the current SM_DIFF setting of the VS10xx chip.

Parameters

[in] DiffMode integer value between 0 and 1.

The input value is mapped onto the SM_DIFF of the SCI_MODE register, preserving the remainder of SCI_MODE. For stereo playback streams this creates a virtual sound, and for mono streams this creates a differential left/right output with a maximum output of 3V.

As specified by Data Sheet Section 8.7.1

See also: getDifferentialOutput()

Definition at line 959 of file vs1053_avr_renesas_uno.cpp.

◆ setEarSpeaker()

void vs1053::setEarSpeaker ( uint16_t EarSpeaker )

Set the current Spatial EarSpeaker setting of the VS10xx chip.

Parameters

[in] EarSpeaker integer value between 0 and 3. Where 0 is OFF and 3 is maximum.

The input value is mapped onto SM_EARSPEAKER_LO and SM_EARSPEAKER_HIGH bits and written the VS10xx SCI_MODE register, preserving the remainder of SCI_MODE. As specified by Data Sheet Section 8.7.1 and 8.4

Definition at line 895 of file vs1053_avr_renesas_uno.cpp.

◆ setMonoMode()

void vs1053::setMonoMode ( uint16_t StereoMode )

Set the current Stereo/Mono setting of the VS10xx output.

Write the VS10xx WRAMADDR para_MonoOutput bit 0 to configure the current Stereo/Mono. As specified by VS1053B PATCHES AND FLAC DECODER Data Sheet Section 1.2 Mono output mode. While preserving the other bits.

Warning: This feature is only available when composite patch 1.7 or higher is loaded into the VSdsp.

Definition at line 1005 of file vs1053_avr_renesas_uno.cpp.

◆ setPlaySpeed()

void vs1053::setPlaySpeed ( uint16_t data )

Set the current playSpeed of the VS10xx chip.

Write the VS10xx extra parameter memory for playSpeed register with the desired multipler.

Where 0 and/or 1 are normal 1x speed. e.g. 4 to playSpeed will play the song four times as fast as normal, if you are able to feed the data with that speed. As specified by Data Sheet Section 9.11.1

Warning: Excessive playspeed beyond the ability to stream data between the SdCard, Arduino and VS10xx may result in erratic behavior.

Definition at line 851 of file vs1053_avr_renesas_uno.cpp.

◆ setTrebleAmplitude()

void vs1053::setTrebleAmplitude ( int8_t amplitude )

Set the current Treble Amplitude in VS10xx chip.

Parameters

[in] amplitude Treble in dB from -8 to 7.

Note: The upper and lower limits of this parameter is checked.

Definition at line 733 of file vs1053_avr_renesas_uno.cpp.

◆ setTrebleFrequency()

void vs1053::setTrebleFrequency ( uint16_t frequency )

Set the current treble frequency limit in VS10xx chip.

Parameters

[in] frequency Treble cutoff limit in Hertz.

Note: The upper and lower limits of this parameter is checked.

Definition at line 705 of file vs1053_avr_renesas_uno.cpp.

◆ setVolume() [1/3]

void vs1053::setVolume ( uint16_t data )

Overload function of vs1053::setVolume(leftchannel, rightchannel)

Parameters

[in] data packed with left and right master volume

calls vs1053::setVolume expecting the left channel in the upper byte and right channel in the lower byte.

As specified by Data Sheet Section 8.7.11

Definition at line 572 of file vs1053_avr_renesas_uno.cpp.

◆ setVolume() [2/3]

void vs1053::setVolume ( uint8_t data )

Overload function of vs1053::setVolume(leftchannel, rightchannel)

Parameters

[in] data byte to be placed into both Left and Right

calls vs1053::setVolume placing the input into both the left channel and right channels.

As specified by Data Sheet Section 8.7.11

Definition at line 589 of file vs1053_avr_renesas_uno.cpp.

◆ setVolume() [3/3]

void vs1053::setVolume	(	uint8_t	leftchannel,
		uint8_t	rightchannel )

Store and Push member volume to VS10xx chip.

Parameters

[in]	leftchannel	writes the left channel master volume
[in]	rightchannel	writes the right channel master volume

Updates the VS10xx SCI_VOL register's left and right master volume level in -0.5 dB Steps. Where maximum volume is 0x0000 and total silence is 0xFEFE. As specified by Data Sheet Section 8.7.11

Note: input values are -1/2dB. e.g. 40 results in -20dB.

Definition at line 606 of file vs1053_avr_renesas_uno.cpp.

◆ setVUmeter()

int8_t vs1053::setVUmeter ( int8_t enable )

enable VSdsp VU Meter

Parameters

[in] enable when set will enable the VU meter

Writes the SS_VU_ENABLE bit of the SCI_STATUS register to enable VU meter on board to the VSdsp.

See data patches data sheet VU meter for details.

Warning: This feature is only available with patches that support VU meter.
The VU meter takes about 0.2MHz of processing power with 48 kHz samplerate.

Definition at line 1678 of file vs1053_avr_renesas_uno.cpp.

◆ skip()

uint8_t vs1053::skip ( int32_t timecode )

Skips to a duration in the track.

Parameters

[in] timecode offset milliseconds from the current location of the file.

Repositions the filehandles track location to the requested offset. As calculated by the bitrate multiplied by the desired ms offset.

Returns

0 indicates the position was changed.
1 indicates no action, in lieu of any current file stream.
2 indicates failure to skip to new file location.

Warning: Limited to +/- 32768ms, since SdFile::seekCur(int32_t);

Definition at line 1284 of file vs1053_avr_renesas_uno.cpp.

◆ skipTo()

uint8_t vs1053::skipTo ( uint32_t timecode )

Skips to a certain point in the track.

Parameters

[in] timecode offset milliseconds from the begining of the file.

Repositions the filehandles track location to the requested offset. As calculated by the bitrate multiplied by the desired ms offset.

Returns

0 indicates the position was changed.
1 indicates no action, in lieu of any current file stream.
2 indicates failure to skip to new file location.

Warning: Limited to first 65535ms, since SdFile::seekSet(int32_t);

Definition at line 1340 of file vs1053_avr_renesas_uno.cpp.

◆ spiInit()

void vs1053::spiInit ( )

staticprivate

Initialize the SPI for VS10xx use.

Primative function to configure the SPI's BitOrder, DataMode and ClockDivider to that of the current VX10xx.

Warning: This sets the rate fast for write, too fast for reading. In the case of a subsequent SPI.transfer that is reading back data followup with a SPI.setClockDivider(spi_Read_Rate); as not to get gibberish.

Definition at line 1732 of file vs1053_avr_renesas_uno.cpp.

◆ stopTrack()

void vs1053::stopTrack ( )

Gracefully close track and cancel refill.

Skip if already not playing. Otherwise Disable the refill means, then set playing to false, close the filehandle track instance. And finally flush the VSdsp's stream buffer.

Definition at line 1116 of file vs1053_avr_renesas_uno.cpp.

◆ trackAlbum()

void vs1053::trackAlbum ( char * infobuffer )

Get Track's Album.

Parameters

[out] infobuffer pointer char array to be updated with result

Extract the Album from the current filehandles track ID3 tag information.

Warning: ID3 Tag information may not be present on all source files. Otherwise may result in non-sense. It is possible to add it with common tools outside of this project.

Definition at line 1452 of file vs1053_avr_renesas_uno.cpp.

◆ trackArtist()

void vs1053::trackArtist ( char * infobuffer )

Get Track's Artist.

Parameters

[out] infobuffer pointer char array to be updated with result

Extract the Artist from the current filehandles track ID3 tag information.

Warning: ID3 Tag information may not be present on all source files. Otherwise may result in non-sense. It is possible to add it with common tools outside of this project.

Definition at line 1420 of file vs1053_avr_renesas_uno.cpp.

◆ trackTitle()

void vs1053::trackTitle ( char * infobuffer )

Get Track's Title.

Parameters

[out] infobuffer pointer char array to be updated with result

Extract the Title from the current filehandles track ID3 tag information.

Warning: ID3 Tag information may not be present on all source files. Otherwise may result in non-sense. It is possible to add it with common tools outside of this project.

Definition at line 1436 of file vs1053_avr_renesas_uno.cpp.

◆ vs_init()

uint8_t vs1053::vs_init ( )

Initialize the VS10xx Audio Decoder Chip.

Reset and initialize the VS10xx chip's internal registers such as clock for normal operation with the vs1053 class's members. Along with uploading corresponding accumilative patch file, if present.

Returns

Any Value other than zero indicates a problem occured.

0 indicates that upload was successful.
1 thru 3 are omitted, as not to overlap with other errors.
4 indicates other than default values were found in the SCI_MODE register.
5 indicates SCI_CLOCKF did not read back and verify the configured value.

Note: returned Error codes are typically passed and therefore need to avoid overlap.

See also: Error Codes

Definition at line 227 of file vs1053_avr_renesas_uno.cpp.

◆ VSLoadUserCode()

uint8_t vs1053::VSLoadUserCode ( char * fileName )

private

load VS1xxx with patch or plugin from file on SDcard.

Parameters

[out] fileName pointer of a char array (aka string), contianing the filename

Loads the VX10xx with filename of the specified patch, if present. This can be used to load various VSdsp apps, patches and plug-in's. Providing many new features and updates not present on the default firmware.

The file format of the plugin is raw binary, in VLSI's interleaved and RLE compressed format, as extracted from the source plugin file (.plg). A perl script vs_plg_to_bin.pl is provided to convert the .plg file in to the binary filename.053. Where the extension of .053 is a convention to indicate the VSdsp chip version.

Note: by default all plug-ins are expected to be in the root of the SdCard.

Returns

Any Value other than zero indicates a problem occured.

0 indicates that upload was successful.
1 indicates the upload can not be performed while currently streaming music.
2 indicates that desired file was not found.
3 indicates that the VSdsp is in reset.

See also

Error Codes
Plug_Ins

Definition at line 332 of file vs1053_avr_renesas_uno.cpp.

Member Data Documentation

◆ bitrate

uint8_t vs1053::bitrate

private

contains a local value of the beleived current bit-rate.

Definition at line 761 of file vs1053_avr_renesas_uno.h.

◆ mp3DataBuffer

uint8_t vs1053::mp3DataBuffer

staticprivate

Buffer for moving data between Filehandle and VSdsp.

Definition at line 758 of file vs1053_avr_renesas_uno.h.

◆ playing_state

state_m vs1053::playing_state

staticprivate

Boolean flag indicating if filehandle is streaming.

Initializer for the instance of the SdCard's static member.

Definition at line 752 of file vs1053_avr_renesas_uno.h.

◆ spi_Max_Rate

uint32_t vs1053::spi_Max_Rate

staticprivate

Rate of the SPI to be used with communicating to the VSdsp.

Initializer for the instance of the SdCard's static member.

Definition at line 755 of file vs1053_avr_renesas_uno.h.

◆ start_of_music

uint32_t vs1053::start_of_music

private

contains a filehandles offset to the begining of the current file.

Definition at line 764 of file vs1053_avr_renesas_uno.h.

◆ track

SdFile vs1053::track

staticprivate

Initializer for the instance of the SdCard's static member.

Definition at line 730 of file vs1053_avr_renesas_uno.h.

◆ VolL

uint8_t vs1053::VolL

private

contains a local value of the VSdsp's master volume left channels

Definition at line 767 of file vs1053_avr_renesas_uno.h.

◆ VolR

uint8_t vs1053::VolR

private

contains a local value of the VSdsp's master volume Right channels

Definition at line 770 of file vs1053_avr_renesas_uno.h.

The documentation for this class was generated from the following files:

src/vs1053_avr_renesas_uno.h
src/vs1053_avr_renesas_uno.cpp

Classes

Public Member Functions

Static Public Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Function Documentation

◆ ADMixerLoad()

◆ ADMixerVol()

◆ available()

◆ begin()

◆ cs_high()

◆ cs_low()

◆ currentPosition()

◆ dcs_high()

◆ dcs_low()

◆ disableRefill()

◆ disableTestSineWave()

◆ enableRefill()

◆ enableTestSineWave()

◆ end()

◆ flush_cancel()

◆ getAudioInfo()

◆ getBassAmplitude()

◆ getBassFrequency()

◆ getBitRateFromMP3File()

◆ getDifferentialOutput()

◆ getEarSpeaker()

◆ getMonoMode()

◆ getPlaySpeed()

◆ getState()

◆ getTrackInfo()

◆ getTrebleAmplitude()

◆ getTrebleFrequency()

◆ getVolume()

◆ getVUlevel()

◆ getVUmeter()

◆ isPlaying()

◆ memoryTest()

◆ Mp3ReadRegister()

◆ Mp3ReadWRAM()

◆ Mp3WriteRegister() [1/2]

◆ Mp3WriteRegister() [2/2]

◆ Mp3WriteWRAM()

◆ pauseDataStream()

◆ pauseMusic()

◆ playMP3()

◆ playTrack()

◆ refill()

◆ resumeDataStream()

◆ resumeMusic() [1/2]

◆ resumeMusic() [2/2]

◆ SendSingleMIDInote()

◆ setBassAmplitude()

◆ setBassFrequency()

◆ setBitRate()

◆ setDifferentialOutput()

◆ setEarSpeaker()

◆ setMonoMode()

◆ setPlaySpeed()

◆ setTrebleAmplitude()

◆ setTrebleFrequency()

◆ setVolume() [1/3]

◆ setVolume() [2/3]

◆ setVolume() [3/3]

◆ setVUmeter()

◆ skip()

◆ skipTo()

◆ spiInit()

◆ stopTrack()

◆ trackAlbum()

◆ trackArtist()

◆ trackTitle()

◆ vs_init()

◆ VSLoadUserCode()

Member Data Documentation

◆ bitrate

◆ mp3DataBuffer