/*************************************************************************** * __________ __ ___. * Open \______ \ ____ ____ | | _\_ |__ _______ ___ * Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ / * Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < < * Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \ * \/ \/ \/ \/ \/ * $Id$ * * Copyright (C) 2005 by Linus Nielsen Feltzing * * All files in this archive are subject to the GNU General Public License. * See the file COPYING in the source tree root for full license agreement. * * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY * KIND, either express or implied. * ****************************************************************************/ #ifndef AUDIO_H #define AUDIO_H #include #include /* These must always be included with audio.h for this to compile under cetain conditions. Do it here or else spread the complication around to many files. */ #if CONFIG_CODEC == SWCODEC #include "pcm_sampr.h" #include "pcm_playback.h" #ifdef HAVE_RECORDING #include "pcm_record.h" #include "id3.h" #include "enc_base.h" #endif /* HAVE_RECORDING */ #endif /* CONFIG_CODEC == SWCODEC */ #ifdef SIMULATOR #define audio_play(x) sim_audio_play(x) #endif #define AUDIO_STATUS_PLAY 0x0001 #define AUDIO_STATUS_PAUSE 0x0002 #define AUDIO_STATUS_RECORD 0x0004 #define AUDIO_STATUS_PRERECORD 0x0008 #define AUDIO_STATUS_ERROR 0x0010 #define AUDIO_STATUS_WARNING 0x0020 #define AUDIOERR_DISK_FULL 1 #define AUDIO_GAIN_LINEIN 0 #define AUDIO_GAIN_MIC 1 struct audio_debug { int audiobuflen; int audiobuf_write; int audiobuf_swapwrite; int audiobuf_read; int last_dma_chunk_size; bool dma_on; bool playing; bool play_pending; bool is_playing; bool filling; bool dma_underrun; int unplayed_space; int playable_space; int unswapped_space; int low_watermark_level; int lowest_watermark_level; }; void audio_init(void); void audio_play(long offset); void audio_stop(void); void audio_pause(void); void audio_resume(void); void audio_next(void); void audio_prev(void); int audio_status(void); #if CONFIG_CODEC == SWCODEC int audio_track_count(void); /* SWCODEC only */ long audio_filebufused(void); /* SWCODEC only */ void audio_pre_ff_rewind(void); /* SWCODEC only */ #endif /* CONFIG_CODEC == SWCODEC */ void audio_ff_rewind(long newtime); void audio_flush_and_reload_tracks(void); struct mp3entry* audio_current_track(void); struct mp3entry* audio_next_track(void); bool audio_has_changed_track(void); void audio_get_debugdata(struct audio_debug *dbgdata); void audio_set_crossfade(int type); #ifndef HAVE_FLASH_STORAGE void audio_set_buffer_margin(int seconds); #endif unsigned int audio_error(void); void audio_error_clear(void); int audio_get_file_pos(void); void audio_beep(int duration); void audio_init_playback(void); /* Required call when audio buffer is require for some other purpose */ unsigned char *audio_get_buffer(bool talk_buf, size_t *buffer_size); #ifdef IRAM_STEAL /* Required call when codec IRAM is needed for some other purpose */ void audio_iram_steal(void); #endif /* channel modes */ enum rec_channel_modes { __CHN_MODE_START_INDEX = -1, CHN_MODE_STEREO, CHN_MODE_MONO, CHN_NUM_MODES }; #if CONFIG_CODEC == SWCODEC /* channel mode capability bits */ #define CHN_CAP_STEREO (1 << CHN_MODE_STEREO) #define CHN_CAP_MONO (1 << CHN_MODE_MONO) #define CHN_CAP_ALL (CHN_CAP_STEREO | CHN_CAP_MONO) #endif /* CONFIG_CODEC == SWCODEC */ /* the enums below must match prestr[] in recording.c */ enum audio_sources { AUDIO_SRC_PLAYBACK = -1, /* Virtual source */ HAVE_MIC_IN_(AUDIO_SRC_MIC,) HAVE_LINE_IN_(AUDIO_SRC_LINEIN,) HAVE_SPDIF_IN_(AUDIO_SRC_SPDIF,) HAVE_FMRADIO_IN_(AUDIO_SRC_FMRADIO,) AUDIO_NUM_SOURCES, AUDIO_SRC_MAX = AUDIO_NUM_SOURCES-1, AUDIO_SRC_DEFAULT = AUDIO_SRC_PLAYBACK }; extern int audio_channels; extern int audio_output_source; #ifdef HAVE_RECORDING /* Recordable source implies it has the input as well */ /* For now there's no restrictions on any targets with which inputs are recordable so define them as equivalent - if they do differ, special handling is needed right now. */ enum rec_sources { __REC_SRC_FIRST = -1, HAVE_MIC_REC_(REC_SRC_MIC,) HAVE_LINE_REC_(REC_SRC_LINEIN,) HAVE_SPDIF_REC_(REC_SRC_SPDIF,) HAVE_FMRADIO_REC_(REC_SRC_FMRADIO,) REC_NUM_SOURCES }; #endif /* HAVE_RECORDING */ #if CONFIG_CODEC == SWCODEC /* selects a source to monitor for recording or playback */ #define SRCF_PLAYBACK 0x0000 /* default */ #define SRCF_RECORDING 0x1000 #if CONFIG_TUNER /* for AUDIO_SRC_FMRADIO */ #define SRCF_FMRADIO_PLAYING 0x0000 /* default */ #define SRCF_FMRADIO_PAUSED 0x2000 #endif #endif #ifdef HAVE_RECORDING /* parameters for audio_set_recording_options */ struct audio_recording_options { int rec_source; int rec_frequency; int rec_channels; int rec_prerecord_time; #if CONFIG_CODEC == SWCODEC int rec_source_flags; /* for rec_set_source */ struct encoder_config enc_config; #else int rec_quality; bool rec_editable; #endif }; /* audio recording functions */ void audio_init_recording(unsigned int buffer_offset); void audio_close_recording(void); void audio_record(const char *filename); void audio_stop_recording(void); void audio_pause_recording(void); void audio_resume_recording(void); void audio_new_file(const char *filename); void audio_set_recording_options(struct audio_recording_options *options); void audio_set_recording_gain(int left, int right, int type); unsigned long audio_recorded_time(void); unsigned long audio_num_recorded_bytes(void); #if CONFIG_CODEC == SWCODEC /* SWCODEC recoring functions */ /* playback.c */ bool audio_load_encoder(int afmt); void audio_remove_encoder(void); unsigned char *audio_get_recording_buffer(size_t *buffer_size); #endif /* CONFIG_CODEC == SWCODEC */ #endif /* HAVE_RECORDING */ #if CONFIG_CODEC == SWCODEC /* SWCODEC misc. audio functions */ #if INPUT_SRC_CAPS != 0 /* audio.c */ void audio_set_input_source(int source, unsigned flags); /* audio_input_mux: target-specific implementation used by audio_set_source to set hardware inputs and audio paths */ void audio_input_mux(int source, unsigned flags); void audio_set_output_source(int source); #endif /* INPUT_SRC_CAPS */ #endif /* CONFIG_CODEC == SWCODEC */ #ifdef HAVE_SPDIF_IN /* returns index into rec_master_sampr_list */ int audio_get_spdif_sample_rate(void); /* > 0: monitor EBUin, 0: Monitor IISrecv, <0: reset only */ void audio_spdif_set_monitor(int monitor_spdif); #endif /* HAVE_SPDIF_IN */ unsigned long audio_prev_elapsed(void); /***********************************************************************/ /* audio event handling */ /* subscribe to one or more audio event(s) by OR'ing together the desired */ /* event IDs (defined below); a handler is called with a solitary event ID */ /* (so switch() is okay) and possibly some useful data (depending on the */ /* event); a handler must return one of the return codes defined below */ typedef int (*AUDIO_EVENT_HANDLER)(unsigned short event, unsigned long data); void audio_register_event_handler(AUDIO_EVENT_HANDLER handler, unsigned short mask); /***********************************************************************/ /* handler return codes */ #define AUDIO_EVENT_RC_IGNORED 200 /* indicates that no action was taken or the event was not recognized */ #define AUDIO_EVENT_RC_HANDLED 201 /* indicates that the event was handled and some action was taken which renders the original event invalid; USE WITH CARE!; this return code aborts all further processing of the given event */ /***********************************************************************/ /* audio event IDs */ #define AUDIO_EVENT_POS_REPORT (1<<0) /* sends a periodic song position report to handlers; a report is sent on each kernal tick; the number of ticks per second is defined by HZ; on each report the current song position is passed in 'data'; if a handler takes an action that changes the song or the song position it must return AUDIO_EVENT_RC_HANDLED which suppresses the event for any remaining handlers */ #define AUDIO_EVENT_END_OF_TRACK (1<<1) /* generated when the end of the currently playing track is reached; no data is passed; if the handler implements some alternate end-of-track processing it should return AUDIO_EVENT_RC_HANDLED which suppresses the event for any remaining handlers as well as the normal end-of-track processing */ #endif