Component: WAV Player ROM (File)

Author	Matrix TSL
Version	1.0
Category	File

WAV Player ROM component

Stores an audio WAV file in ROM and contains component macros to allow the WAV file to be streamed out. Compatible with analogue outputs such as DAC or PWM.

Component Source Code

Please click here for the component source code: FC_Comp_Source_WAV_Player.fcfx

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

	SetFilePointer
Allows direct control of the file pointer. Write the file pointer to 0 to reset the pointer to the beginning of the file. Write the file pointer to 0xFFFFFFFF to force the pointer to the end of the file.
- ULONG	Pointer
Range: 0x0 to 0xFFFFFFFF, 0 = Beginning of file
- VOID	Return

	EndOfFile
A simple check to see if we are at the end of the file. Returns 0 if we and not yet at the end fo the file. Returns 1 if we are at the end of the file.
- BOOL	Return

	GetNumChannels
Returns the number of audio channels stored in the WAV file.
- BYTE	Return

	GetBitsPerSample
Returns the number of bits per sample.
- BYTE	Return

	GetNextSample
Retreives the value for the next sample and auto increments the file pointer. Ideally this function should be called as part of a timer interrupt at the sample rate. The value returned should be passed onto a means of analogue output e.g. a DAC or PWM.
- UINT	Return

Property reference

	Properties
	WAV File
WAV File to Embed into the ROM Flash memory.
	File Status
Displays diagnostic data about the selected file.
	Num Channels
Number of audio channels encoded in the WAV file. 1 indicates a MONO audio stream. 2 indicates a STEREO autio stream.
	Sample Rate
The rate in samples per second at which the WAV file was recorded.
	Bits Per Sample
The number of bits used to store a single sample.
	Byte Rate
The number of data bytes per second that need to be processed in order to maintain playback.
	ROM Bytes
Number of bytes of ROM that will be required to store the WAV file.