#include <types.h>
#include <irx.h>

Include dependency graph for audsrv.h:

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

Macros
#define	AUDSRV_INIT 0x0000

#define	AUDSRV_QUIT 0x0001

#define	AUDSRV_FORMAT_OK 0x0002

#define	AUDSRV_SET_FORMAT 0x0003

#define	AUDSRV_PLAY_AUDIO 0x0004

#define	AUDSRV_WAIT_AUDIO 0x0005

#define	AUDSRV_STOP_AUDIO 0x0006

#define	AUDSRV_SET_VOLUME 0x0007

#define	AUDSRV_SET_THRESHOLD 0x0008

#define	AUDSRV_PLAY_CD 0x0009

#define	AUDSRV_STOP_CD 0x000a

#define	AUDSRV_GET_CDPOS 0x000b

#define	AUDSRV_GET_TRACKPOS 0x000c

#define	AUDSRV_GET_NUMTRACKS 0x000d

#define	AUDSRV_GET_TRACKOFFSET 0x000e

#define	AUDSRV_PAUSE_CD 0x0011

#define	AUDSRV_RESUME_CD 0x0012

#define	AUDSRV_PLAY_SECTORS 0x0013

#define	AUDSRV_GET_CD_STATUS 0x0014

#define	AUDSRV_GET_CD_TYPE 0x0015

#define	AUDSRV_INIT_ADPCM 0x0016

#define	AUDSRV_LOAD_ADPCM 0x0017

#define	AUDSRV_PLAY_ADPCM 0x0018

#define	AUDSRV_SET_ADPCM_VOL 0x0019

#define	AUDSRV_FREE_ADPCM 0x001c

#define	AUDSRV_IS_ADPCM_PLAYING 0x001d

#define	AUDSRV_AVAILABLE 0x001a

#define	AUDSRV_QUEUED 0x001b

#define	AUDSRV_FILLBUF_CALLBACK 0x0001

#define	AUDSRV_CDDA_CALLBACK 0x0002

#define	AUDSRV_ERR_NOERROR 0x0000

#define	AUDSRV_ERR_NOT_INITIALIZED 0x0001

#define	AUDSRV_ERR_RPC_FAILED 0x0002

#define	AUDSRV_ERR_FORMAT_NOT_SUPPORTED 0x0003

#define	AUDSRV_ERR_OUT_OF_MEMORY 0x0004

#define	AUDSRV_ERR_ARGS 0x0005

#define	AUDSRV_ERR_NO_DISC 0x0006

#define	AUDSRV_ERR_NO_MORE_CHANNELS 0x0007

#define	audsrv_play_adpcm(id) audsrv_ch_play_adpcm(-1, id)

#define	audsrv_IMPORTS_start DECLARE_IMPORT_TABLE(audsrv, 1, 4)

#define	audsrv_IMPORTS_end END_IMPORT_TABLE

#define	I_audsrv_init DECLARE_IMPORT( 4, audsrv_init)

#define	I_audsrv_quit DECLARE_IMPORT( 5, audsrv_quit)

#define	I_audsrv_format_ok DECLARE_IMPORT( 6, audsrv_format_ok)

#define	I_audsrv_set_format DECLARE_IMPORT( 7, audsrv_set_format)

#define	I_audsrv_wait_audio DECLARE_IMPORT( 8, audsrv_wait_audio)

#define	I_audsrv_play_audio DECLARE_IMPORT( 9, audsrv_play_audio)

#define	I_audsrv_stop_audio DECLARE_IMPORT(10, audsrv_stop_audio)

#define	I_audsrv_set_volume DECLARE_IMPORT(11, audsrv_set_volume)

#define	I_audsrv_play_cd DECLARE_IMPORT(12, audsrv_play_cd)

#define	I_audsrv_stop_cd DECLARE_IMPORT(13, audsrv_stop_cd)

#define	I_audsrv_set_threshold DECLARE_IMPORT(14, audsrv_set_threshold)

#define	I_audsrv_get_cdpos DECLARE_IMPORT(15, audsrv_get_cdpos)

#define	I_audsrv_get_trackpos DECLARE_IMPORT(16, audsrv_get_trackpos)

#define	I_audsrv_get_numtracks DECLARE_IMPORT(17, audsrv_get_numtracks)

#define	I_audsrv_get_track_offset DECLARE_IMPORT(18, audsrv_get_track_offset)

#define	I_audsrv_cd_pause DECLARE_IMPORT(19, audsrv_cd_pause)

#define	I_audsrv_cd_resume DECLARE_IMPORT(20, audsrv_cd_resume)

#define	I_audsrv_cd_play_sectors DECLARE_IMPORT(21, audsrv_cd_play_sectors)

#define	I_audsrv_get_cd_status DECLARE_IMPORT(22, audsrv_get_cd_status)

#define	I_audsrv_get_cd_type DECLARE_IMPORT(23, audsrv_get_cd_type)

#define	I_audsrv_adpcm_init DECLARE_IMPORT(24, audsrv_adpcm_init)

#define	I_audsrv_load_adpcm DECLARE_IMPORT(25, audsrv_load_adpcm)

#define	I_audsrv_play_adpcm I_audsrv_ch_play_adpcm

#define	I_audsrv_ch_play_adpcm DECLARE_IMPORT(26, audsrv_ch_play_adpcm)

#define	I_audsrv_adpcm_set_volume DECLARE_IMPORT(27, audsrv_adpcm_set_volume)

#define	I_audsrv_available DECLARE_IMPORT(28, audsrv_available)

#define	I_audsrv_queued DECLARE_IMPORT(29, audsrv_queued)

Functions
int	audsrv_init ()

int	audsrv_quit ()

int	audsrv_format_ok (int freq, int bits, int channels)

int	audsrv_set_format (int freq, int bits, int channels)

int	audsrv_wait_audio (int buflen)

int	audsrv_play_audio (const char *buf, int buflen)

int	audsrv_stop_audio ()

int	audsrv_set_volume (int vol)

int	audsrv_available ()

int	audsrv_queued ()

int	audsrv_play_cd (int track)

int	audsrv_stop_cd ()

int	audsrv_set_threshold (int amount)

int	audsrv_get_cdpos ()

int	audsrv_get_trackpos ()

int	audsrv_get_numtracks ()

int	audsrv_get_track_offset (int track)

int	audsrv_cd_pause ()

int	audsrv_cd_resume ()

int	audsrv_cd_play_sectors (int start, int end)

int	audsrv_get_cd_status ()

int	audsrv_get_cd_type ()

int	audsrv_adpcm_init ()

int	audsrv_adpcm_set_volume (int ch, int voll, int volr)

void *	audsrv_load_adpcm (u32 *buffer, int size, int id)

int	audsrv_ch_play_adpcm (int ch, u32 id)

int	audsrv_is_adpcm_playing (int ch, u32 id)

int	free_sample (u32 id)

Detailed Description

audsrv IOP server

Definition in file audsrv.h.

Macro Definition Documentation

◆ AUDSRV_INIT

#define AUDSRV_INIT 0x0000

intialization and destruction functions

Definition at line 22 of file audsrv.h.

◆ AUDSRV_FORMAT_OK

#define AUDSRV_FORMAT_OK 0x0002

audio control functions

Definition at line 26 of file audsrv.h.

◆ AUDSRV_PLAY_CD

#define AUDSRV_PLAY_CD 0x0009

cdrom functions

Definition at line 35 of file audsrv.h.

Function Documentation

◆ audsrv_init()

int audsrv_init ( )

Initializes audsrv library

Returns: error code

Initializes audsrv library

Returns: 0 on success

Definition at line 328 of file audsrv_rpc.c.

References initialized.

◆ audsrv_quit()

int audsrv_quit ( )

Shutdowns audsrv

Returns: AUDSRV_ERR_NOERROR

Definition at line 143 of file audsrv_rpc.c.

References audsrv_adpcm_init(), audsrv_stop_audio(), and audsrv_stop_cd().

◆ audsrv_format_ok()

int audsrv_format_ok	(	int	freq,
		int	bits,
		int	channels
	)

Checks if the format noted by frequency and depth is supported

Parameters

freq	frequency in hz
bits	bits per sample (8, 16)
channels	channels

Returns: positive on success, zero value on failure

Definition at line 156 of file audsrv.c.

References find_upsampler().

Referenced by audsrv_set_format().

◆ audsrv_set_format()

int audsrv_set_format	(	int	freq,
		int	bits,
		int	channels
	)

Configures audio stream

Parameters

freq	frequency in hz
bits	bits per sample (8, 16)
channels	number of channels

Returns: 0 on success, negative if configuration is not supported

This sets up audsrv to accept stream in this format and convert it to SPU2's native format if required. Note: it is possible to change the format at any point. You might want to stop audio prior to that, to prevent mismatched audio output.

Definition at line 178 of file audsrv.c.

References audsrv_format_ok().

◆ audsrv_wait_audio()

int audsrv_wait_audio ( int buflen )

Blocks until there is enough space to enqueue chunk

Parameters

bytes size of chunk requested to be enqueued (in bytes)

Returns: error code

Blocks until there are enough space to store the upcoming chunk in audsrv's internal ring buffer.

Blocks until there is enough space to enqueue chunk

Parameters

buflen size of chunk requested to be enqueued (in bytes)

Returns: error status code

Blocks until there are enough space to store the upcoming chunk in audsrv's internal ring buffer.

Definition at line 178 of file audsrv_rpc.c.

References call_rpc_1(), and ringbuf_size.

◆ audsrv_play_audio()

int audsrv_play_audio	(	const char *	buf,
		int	buflen
	)

Uploads audio buffer to SPU

Parameters

chunk	audio buffer
bytes	size of chunk in bytes

Returns: positive number of bytes sent to processor or negative error status

Plays an audio buffer; It will not interrupt a playing buffer, rather queue it up and play it as soon as possible without interfering with fluent streaming. The buffer and buflen are given in host format (i.e, 11025hz 8bit stereo.)

Uploads audio buffer to SPU

Parameters

buf	audio chunk
buflen	size of chunk in bytes

Returns: positive number of bytes sent to processor or negative error status

Plays an audio buffer; It will not interrupt a playing buffer, rather queue it up and play it as soon as possible without interfering with fluent streaming. The buffer and buflen are given in host format (i.e, 11025hz 8bit stereo.)

Definition at line 254 of file audsrv_rpc.c.

References AUDSRV_ERR_NOERROR, and set_error().

◆ audsrv_stop_audio()

int audsrv_stop_audio ( )

Stops audio from playing.

Returns: status code

Stops all audio playing

Returns: 0, always

Mutes output and stops accepting audio blocks; also, clears callbacks.

Definition at line 292 of file audsrv_rpc.c.

References AUDSRV_ERR_NOERROR, call_rpc_1(), fillbuf_threshold, playing, and update_volume().

Referenced by audsrv_quit().

◆ audsrv_set_volume()

int audsrv_set_volume ( int vol )

Sets output volume

Parameters

vol	volume in percentage

Returns: error code

Sets output volume

Parameters

vol	volume in SPU2 units [0 .. 0x3fff]

Returns: 0 on success, negative otherwise

Definition at line 183 of file audsrv_rpc.c.

References call_rpc_1(), MAX_VOLUME, and MIN_VOLUME.

◆ audsrv_available()

int audsrv_available ( )

Returns the number of bytes that can be queued

Returns: number of bytes left in the ring buffer

Returns the number of bytes that are available in the ring buffer. This is the total bytes that can be queued, without collision of the reading head with the writing head.

Returns the number of bytes that can be queued

Returns: byte count

Returns the number of bytes that are available in the ring buffer. This is the total bytes that can be queued, without collision of the reading head with the writing head.

Definition at line 549 of file audsrv_rpc.c.

References call_rpc_1(), readpos, ringbuf_size, and writepos.

◆ audsrv_queued()

int audsrv_queued ( )

Returns the number of bytes already in queue

Returns: byte count

Returns the number of bytes that are already in the ring buffer.

Definition at line 554 of file audsrv_rpc.c.

References call_rpc_1(), readpos, ringbuf_size, and writepos.

◆ audsrv_play_cd()

int audsrv_play_cd ( int track )

Starts playing the request track

Parameters

track segment to play

Returns: status code

Plays CD audio track

Parameters

track segment to play [1 .. 99]

Returns: error status

Definition at line 197 of file audsrv_rpc.c.

References AUDSRV_PLAY_CD, and call_rpc_1().

◆ audsrv_stop_cd()

int audsrv_stop_cd ( )

Stops CD from playing.

Returns: status code

Stops CD play

Returns: 0, always

Stops CD from being played; this has no effect on other music audsrv is currently playing

Definition at line 207 of file audsrv_rpc.c.

References audsrv_stop_cd_stream(), call_rpc_1(), and cdda_play_tid.

◆ audsrv_get_cdpos()

int audsrv_get_cdpos ( )

Returns the current playing sector

Returns: sector number

CDDA type discs have sector size of 2352 bytes. There are 75 such sectors per second.

Returns the current sector being played

Returns: sector number, or negative value on error

Definition at line 214 of file audsrv_rpc.c.

References call_rpc_1(), cd_playing, and cdda_pos.

◆ audsrv_get_trackpos()

int audsrv_get_trackpos ( )

Returns the current playing sector, relative to track

Returns: sector number

There are 75 sectors a second. To translate this position to mm:ss:ff use the following: mm = sector / (75*60) ss = (sector / 75) % 60 ff = sector % 75

where ff is the frame number, 1/75th of a second.

Returns the current sector being played, relative to first sector in track

Returns: sector number, or negative value on error

Definition at line 219 of file audsrv_rpc.c.

References call_rpc_1(), cd_playing, cdda_play_start, and cdda_pos.

◆ audsrv_get_numtracks()

int audsrv_get_numtracks ( )

Returns the number of tracks available on the CD in tray

Returns: positive track count, or negative error status code

Definition at line 224 of file audsrv_rpc.c.

References call_rpc_1().

◆ audsrv_get_track_offset()

int audsrv_get_track_offset ( int track )

Returns the first sector for the given track

Parameters

track track index, must be between 1 and the trackcount

Returns: sector number, or negative status code

Definition at line 229 of file audsrv_rpc.c.

References call_rpc_1().

◆ audsrv_cd_pause()

int audsrv_cd_pause ( )

Pauses CD playing

Returns: status code

Definition at line 298 of file cdrom.c.

References AUDSRV_ERR_NOERROR, and cd_paused.

◆ audsrv_cd_resume()

int audsrv_cd_resume ( )

Resumes CD playing

Returns: status code

Definition at line 307 of file cdrom.c.

References AUDSRV_ERR_NOERROR, and cd_paused.

◆ audsrv_cd_play_sectors()

int audsrv_cd_play_sectors	(	int	start,
		int	end
	)

Starts playing cdda sectors from disc

Parameters

start	first sector to play
end	stop playing at this sector

Returns: status code

Starts the cdda feeding thread at the given sector. Any previously set up playback is stopped. If a callback was set, it will NOT be called, as the thread is stopped abnormally.

Definition at line 472 of file cdrom.c.

◆ audsrv_get_cd_status()

int audsrv_get_cd_status ( )

Returns the status of the CD tray (open, closed, seeking etc.)

Returns: value as defined in libcdvd, negative on error

Returns CD drive status

Returns: status according to PS2 native values

Definition at line 249 of file audsrv_rpc.c.

References call_rpc_1(), and sceCdStatus().

◆ audsrv_get_cd_type()

int audsrv_get_cd_type ( )

Returns the type of disc currently in tray

Returns: value as defined in libcdvd, negative on error

Returns the type of disc in drive

Returns: disc type (according to native PS2 values) or -AUDSRV_ERR_NO_DISC

Definition at line 244 of file audsrv_rpc.c.

References call_rpc_1().

◆ audsrv_adpcm_init()

int audsrv_adpcm_init ( )

Initializes adpcm unit of audsrv

Returns: zero on success, negative value on error

Frees up all memory taken by samples, and stops all voices from being played. This can be called multiple times

Initializes adpcm unit of audsrv

Returns: zero on success, negative value on error

Definition at line 394 of file audsrv_rpc.c.

References AUDSRV_INIT_ADPCM, and call_rpc_1().

◆ audsrv_adpcm_set_volume()

int audsrv_adpcm_set_volume	(	int	ch,
		int	voll,
		int	volr
	)

Sets output volume for the specified voice channel.

Parameters

ch	Voice channel ID
voll	left volume in SPU2 units [0 .. 0x3fff]
volr	right volume in SPU2 units [0 .. 0x3fff]

Returns: 0 on success, negative otherwise

Definition at line 347 of file adpcm.c.

References MAX_VOLUME.

◆ audsrv_load_adpcm()

void* audsrv_load_adpcm	(	u32 *	buffer,
		int	size,
		int	id
	)

Uploads a sample to SPU2 memory

Parameters

buffer	pointer to adpcm sample header
size	size of sample in bytes
id	sample identifier (to be later used in play())

Returns: pointer to local adpcm buffer

Definition at line 160 of file adpcm.c.

◆ audsrv_ch_play_adpcm()

int audsrv_ch_play_adpcm	(	int	ch,
		u32	id
	)

Plays an adpcm sample already uploaded with audsrv_load_adpcm()

Parameters

ch	channel identifier. Specifies one of the 24 voice channel to play the ADPCM channel on. If set to an invalid channel ID, an unoccupied channel will be selected.
id	sample identifier, as specified in load()

Returns: channel identifier on success, negative value on error

When ch is set to an invalid channel ID, the sample will be played in an unoccupied channel. If all 24 channels are used, then -AUDSRV_ERR_NO_MORE_CHANNELS is returned. When ch is set to a valid channel ID, -AUDSRV_ERR_NO_MORE_CHANNELS is returned if the channel is currently in use. Trying to play a sample which is unavailable will result in -AUDSRV_ERR_ARGS

Definition at line 277 of file adpcm.c.

References adpcm_loaded().

◆ free_sample()

int free_sample ( u32 id )

Remove an adpcm sample uploaded with audsrv_load_adpcm() from the list of loaded sounds

Parameters

id	sample identifier, as specified in load()

SPU memory is freed only when there are no sounds in the list that where loaded after the ones that have been freed

Definition at line 84 of file adpcm.c.

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ AUDSRV_INIT

◆ AUDSRV_FORMAT_OK

◆ AUDSRV_PLAY_CD

Function Documentation

◆ audsrv_init()

◆ audsrv_quit()

◆ audsrv_format_ok()

◆ audsrv_set_format()

◆ audsrv_wait_audio()

◆ audsrv_play_audio()

◆ audsrv_stop_audio()

◆ audsrv_set_volume()

◆ audsrv_available()

◆ audsrv_queued()

◆ audsrv_play_cd()

◆ audsrv_stop_cd()

◆ audsrv_get_cdpos()

◆ audsrv_get_trackpos()

◆ audsrv_get_numtracks()

◆ audsrv_get_track_offset()

◆ audsrv_cd_pause()

◆ audsrv_cd_resume()

◆ audsrv_cd_play_sectors()

◆ audsrv_get_cd_status()

◆ audsrv_get_cd_type()

◆ audsrv_adpcm_init()

◆ audsrv_adpcm_set_volume()

◆ audsrv_load_adpcm()

◆ audsrv_ch_play_adpcm()

◆ free_sample()