kb_sound.h File Reference

Include dependency graph for kb_sound.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct snd_t

Functions

void kb_snd_init (snd_t *snd, const char *mixer_device, const char *dsp_device)

void kb_snd_exit (snd_t *snd)

int kb_snd_open (snd_t *snd)

void kb_snd_close (snd_t *snd)

int kb_snd_doMmap (snd_t *snd)

int kb_snd_doMunmap (snd_t *snd)

int kb_snd_enableTrigger (snd_t *snd, int mask)

int kb_snd_enableFrag (snd_t *snd)

short * kb_snd_getIPtr (snd_t *snd)

short * kb_snd_getOPtr (snd_t *snd)

unsigned int kb_snd_getFragSize (snd_t *snd)

void kb_snd_copyFragTo (snd_t *snd, short *buf)

void kb_snd_copyFragFrom (snd_t *snd, short *buf)

int kb_snd_setVolume (snd_t *snd, unsigned int line, unsigned int vol_left, unsigned int vol_right)

int kb_snd_setSampleRate (snd_t *snd, unsigned int sampleRate)

int kb_snd_waitFrag (snd_t *snd)

int kb_snd_record (snd_t *snd, short *data, unsigned long nsamples)

int kb_snd_play (snd_t *snd, short *data, unsigned long nsamples)

int kb_snd_reset (snd_t *snd)

int kb_snd_flush (snd_t *snd)

int kb_snd_openDevices (snd_t *snd)

unsigned long kb_smplfromdur (unsigned int duration, unsigned smplrate)

unsigned long kb_durfromsmpl (unsigned int smplnbr, unsigned smplrate)

unsigned int kb_snd_fragInit (snd_t *snd, int line1Vol, int line2Vol, int smplRate, int mode)

void kb_snd_fragPlay (snd_t *snd, int fragSize)

Function Documentation

unsigned long kb_durfromsmpl	(	unsigned int	smplnbr,
		unsigned	smplrate
	)

This function get the duration for a given sample number

Parameters:

	smplnbr	duration in second
	smplrate	sample rate ie 44100

Returns:: the duration

Definition at line 530 of file kb_sound.c.

unsigned long kb_smplfromdur	(	unsigned int	duration,
		unsigned	smplrate
	)

This function get the number of samples for a given duration

Parameters:

	duration	duration in second
	smplrate	sample rate ie 44100

Returns:: the number of samples for a given duration

Definition at line 516 of file kb_sound.c.

void kb_snd_close ( snd_t * snd )

This function closes the file descriptor opened by kb_snd_open

Definition at line 111 of file kb_sound.c.

References snd_t::dsp_fd, snd_t::ibuf, kb_snd_doMunmap(), and snd_t::mix_fd.

Referenced by kb_snd_exit(), and kb_snd_open().

Here is the call graph for this function:

void kb_snd_copyFragFrom	(	snd_t *	snd,
		short *	buf
	)

Definition at line 344 of file kb_sound.c.

References snd_t::fragSize, and kb_snd_getOPtr().

Here is the call graph for this function:

void kb_snd_copyFragTo	(	snd_t *	snd,
		short *	buf
	)

Definition at line 331 of file kb_sound.c.

References snd_t::fragSize, and kb_snd_getIPtr().

Here is the call graph for this function:

int kb_snd_doMmap ( snd_t * snd )

Definition at line 131 of file kb_sound.c.

References snd_t::dsp_fd, snd_t::fragCount, snd_t::fragSize, snd_t::ibuf, snd_t::iend, snd_t::isize, KB_DEBUG, snd_t::obuf, snd_t::oend, and snd_t::osize.

Referenced by kb_snd_fragInit().

int kb_snd_doMunmap ( snd_t * snd )

Definition at line 175 of file kb_sound.c.

References snd_t::ibuf, snd_t::iend, snd_t::isize, snd_t::obuf, snd_t::oend, and snd_t::osize.

Referenced by kb_snd_close().

int kb_snd_enableFrag ( snd_t * snd )

Definition at line 229 of file kb_sound.c.

References snd_t::dsp_fd, snd_t::fragCount, snd_t::fragSize, KB_DEBUG, KB_ERROR, KB_ERROR_DUPLEX, KB_ERROR_FRAGEXP, and KB_ERROR_FRAGMENT.

Referenced by kb_snd_fragInit().

int kb_snd_enableTrigger	(	snd_t *	snd,
		int	mask
	)

Definition at line 195 of file kb_sound.c.

References snd_t::dsp_fd, and KB_DEBUG.

Referenced by kb_snd_fragInit().

void kb_snd_exit ( snd_t * snd )

Definition at line 28 of file kb_sound.c.

References kb_snd_close().

Here is the call graph for this function:

int kb_snd_flush ( snd_t * snd )

Definition at line 457 of file kb_sound.c.

References snd_t::dsp_fd.

Referenced by kb_snd_play().

unsigned int kb_snd_fragInit	(	snd_t *	snd,
		int	line1Vol,
		int	line2Vol,
		int	smplRate,
		int	mode
	)

This function completely initialise then open the sound devices various volumes such as the "Line IN", sample rate and mode are set from the various arguments

Parameters:

	snd	pointer to a snd_t structure
	line1Vol	"Line 1" volume ( from 0 to 255 )
	line2Vol	"Line 2" volume ( from 0 to 255 )
	smplrate	sample rate, ie 44100
	mode	Trigger mode : 0 Input way 1 Outptut way 2 both way

Returns:

frag size :

0 any error
> 0 fragment size

Definition at line 554 of file kb_sound.c.

References kb_snd_doMmap(), kb_snd_enableFrag(), kb_snd_enableTrigger(), kb_snd_getFragSize(), kb_snd_openDevices(), kb_snd_setSampleRate(), and kb_snd_setVolume().

Here is the call graph for this function:

void kb_snd_fragPlay	(	snd_t *	snd,
		int	fragSize
	)

This function just play a fragment from the sound card both argument supposed to be retrieved with the kb_snd_fragInit()

Parameters:

	snd	pointer to an initialised snd_t structure
	fragSize	fragment size

just do some OutFrag = InFrag

Definition at line 603 of file kb_sound.c.

References kb_snd_getIPtr(), kb_snd_getOPtr(), and kb_snd_waitFrag().

Here is the call graph for this function:

unsigned int kb_snd_getFragSize ( snd_t * snd )

Definition at line 323 of file kb_sound.c.

References snd_t::fragSize.

Referenced by kb_snd_fragInit().

short* kb_snd_getIPtr ( snd_t * snd )

Definition at line 271 of file kb_sound.c.

References snd_t::dsp_fd, snd_t::fragSize, snd_t::ibuf, snd_t::isize, KB_ERROR, and KB_ERROR_IPTR.

Referenced by kb_snd_copyFragTo(), and kb_snd_fragPlay().

short* kb_snd_getOPtr ( snd_t * snd )

Definition at line 296 of file kb_sound.c.

References snd_t::dsp_fd, snd_t::fragSize, KB_ERROR, KB_ERROR_OPTR, snd_t::obuf, snd_t::oend, and snd_t::osize.

Referenced by kb_snd_copyFragFrom(), and kb_snd_fragPlay().

void kb_snd_init	(	snd_t *	snd,
		const char *	mixer_device,
		const char *	dsp_device
	)

Definition at line 9 of file kb_sound.c.

References snd_t::dsp_device, snd_t::dsp_fd, snd_t::fragCount, snd_t::fragSize, snd_t::ibuf, snd_t::iend, snd_t::mix_fd, snd_t::mixer_device, snd_t::obuf, and snd_t::oend.

Referenced by kb_snd_openDevices(), koa_sound_task(), and main().

int kb_snd_open ( snd_t * snd )

This function opens all devices need for producing sound.

Definition at line 37 of file kb_sound.c.

References snd_t::bytePerSample, snd_t::dsp_device, snd_t::dsp_fd, snd_t::fragCount, snd_t::fragSize, KB_DEBUG, kb_snd_close(), snd_t::mix_fd, snd_t::mixer_device, snd_t::nbChannels, and snd_t::sampleSize.

Referenced by kb_snd_openDevices(), koa_sound_task(), and main().

Here is the call graph for this function:

int kb_snd_openDevices ( snd_t * snd )

This function open and initializes the default sound devices

Parameters:

snd

pointer to a snd_t structure

Returns:

an error code

1 error
0 no error

Definition at line 484 of file kb_sound.c.

References KB_DEBUG, kb_init(), kb_snd_init(), and kb_snd_open().

Referenced by kb_snd_fragInit().

Here is the call graph for this function:

int kb_snd_play	(	snd_t *	snd,
		short *	data,
		unsigned long	size
	)

This function plays a given number of samples

Definition at line 440 of file kb_sound.c.

References snd_t::dsp_fd, and kb_snd_flush().

Referenced by kb_wav_play(), koa_sound_task(), and main().

Here is the call graph for this function:

int kb_snd_record	(	snd_t *	snd,
		short *	data,
		unsigned long	size
	)

This function records a given number of samples

Definition at line 421 of file kb_sound.c.

References snd_t::dsp_fd.

int kb_snd_reset ( snd_t * snd )

Definition at line 467 of file kb_sound.c.

References snd_t::dsp_fd.

int kb_snd_setSampleRate	(	snd_t *	snd,
		unsigned int	sampleRate
	)

This function sets the sampling rate

Definition at line 375 of file kb_sound.c.

References snd_t::dsp_fd, and KB_DEBUG.

Referenced by kb_snd_fragInit(), koa_sound_task(), and main().

int kb_snd_setVolume	(	snd_t *	snd,
		unsigned int	line,
		unsigned int	vol_left,
		unsigned int	vol_right
	)

This function sets the input/output volume and selects the input.

Definition at line 358 of file kb_sound.c.

References snd_t::mix_fd.

Referenced by kb_snd_fragInit().

int kb_snd_waitFrag ( snd_t * snd )

Definition at line 390 of file kb_sound.c.

References snd_t::dsp_fd.

Referenced by kb_snd_fragPlay().


Data Structures
struct	snd_t
Functions
void	kb_snd_init (snd_t snd, const char mixer_device, const char *dsp_device)
void	kb_snd_exit (snd_t *snd)
int	kb_snd_open (snd_t *snd)
void	kb_snd_close (snd_t *snd)
int	kb_snd_doMmap (snd_t *snd)
int	kb_snd_doMunmap (snd_t *snd)
int	kb_snd_enableTrigger (snd_t *snd, int mask)
int	kb_snd_enableFrag (snd_t *snd)
short *	kb_snd_getIPtr (snd_t *snd)
short *	kb_snd_getOPtr (snd_t *snd)
unsigned int	kb_snd_getFragSize (snd_t *snd)
void	kb_snd_copyFragTo (snd_t snd, short buf)
void	kb_snd_copyFragFrom (snd_t snd, short buf)
int	kb_snd_setVolume (snd_t *snd, unsigned int line, unsigned int vol_left, unsigned int vol_right)
int	kb_snd_setSampleRate (snd_t *snd, unsigned int sampleRate)
int	kb_snd_waitFrag (snd_t *snd)
int	kb_snd_record (snd_t snd, short data, unsigned long nsamples)
int	kb_snd_play (snd_t snd, short data, unsigned long nsamples)
int	kb_snd_reset (snd_t *snd)
int	kb_snd_flush (snd_t *snd)
int	kb_snd_openDevices (snd_t *snd)
unsigned long	kb_smplfromdur (unsigned int duration, unsigned smplrate)
unsigned long	kb_durfromsmpl (unsigned int smplnbr, unsigned smplrate)
unsigned int	kb_snd_fragInit (snd_t *snd, int line1Vol, int line2Vol, int smplRate, int mode)
void	kb_snd_fragPlay (snd_t *snd, int fragSize)