1 /***************************************************************************
3 * Open \______ \ ____ ____ | | _\_ |__ _______ ___
4 * Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
5 * Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
6 * Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
10 * Copyright (C) 2005 by Linus Nielsen Feltzing
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License
14 * as published by the Free Software Foundation; either version 2
15 * of the License, or (at your option) any later version.
17 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
18 * KIND, either express or implied.
20 ****************************************************************************/
25 #include <string.h> /* size_t */
27 /* These must always be included with audio.h for this to compile under
28 cetain conditions. Do it here or else spread the complication around to
30 #if CONFIG_CODEC == SWCODEC
31 #include "pcm_sampr.h"
35 #endif /* HAVE_RECORDING */
36 #endif /* CONFIG_CODEC == SWCODEC */
40 #define audio_play(x) sim_audio_play(x)
43 #define AUDIO_STATUS_PLAY 0x0001
44 #define AUDIO_STATUS_PAUSE 0x0002
45 #define AUDIO_STATUS_RECORD 0x0004
46 #define AUDIO_STATUS_PRERECORD 0x0008
47 #define AUDIO_STATUS_ERROR 0x0010
48 #define AUDIO_STATUS_WARNING 0x0020
49 #define AUDIO_STATUS_FADING 0x0040
51 #define AUDIOERR_DISK_FULL 1
53 #define AUDIO_GAIN_LINEIN 0
54 #define AUDIO_GAIN_MIC 1
57 void audio_init(void) INIT_ATTR
;
58 void audio_play(long offset
);
59 void audio_stop(void);
60 void audio_pause(void);
61 void audio_resume(void);
62 void audio_next(void);
63 void audio_prev(void);
64 int audio_status(void);
65 void audio_ff_rewind(long newpos
);
66 void audio_flush_and_reload_tracks(void);
67 struct mp3entry
* audio_current_track(void);
68 struct mp3entry
* audio_next_track(void);
69 bool audio_peek_track(struct mp3entry
** id3
, int offset
);
70 #ifdef HAVE_DISK_STORAGE
71 void audio_set_buffer_margin(int setting
);
73 void audio_error_clear(void);
74 int audio_get_file_pos(void);
75 void audio_beep(int duration
);
77 #if CONFIG_CODEC == SWCODEC
78 /* Required call when audio buffer is required for some other purpose */
79 unsigned char *audio_get_buffer(bool talk_buf
, size_t *buffer_size
);
80 /* only implemented in playback.c, but called from firmware */
82 void audio_next_dir(void);
83 void audio_prev_dir(void);
85 #else /* hwcodec only */
90 int audiobuf_swapwrite
;
93 int last_dma_chunk_size
;
106 int low_watermark_level
;
107 int lowest_watermark_level
;
110 void audio_get_debugdata(struct audio_debug
*dbgdata
);
111 /* unsigned int audio_error(void); - unused function */
112 void audio_init_playback(void);
114 #define audio_next_dir() ({ })
115 #define audio_prev_dir() ({ })
120 enum rec_channel_modes
122 __CHN_MODE_START_INDEX
= -1,
130 #if CONFIG_CODEC == SWCODEC
131 /* channel mode capability bits */
132 #define CHN_CAP_STEREO (1 << CHN_MODE_STEREO)
133 #define CHN_CAP_MONO (1 << CHN_MODE_MONO)
134 #define CHN_CAP_ALL (CHN_CAP_STEREO | CHN_CAP_MONO)
135 #endif /* CONFIG_CODEC == SWCODEC */
137 /* the enums below must match prestr[] in recording.c */
140 AUDIO_SRC_PLAYBACK
= -1, /* Virtual source */
141 HAVE_MIC_IN_(AUDIO_SRC_MIC
,)
142 HAVE_LINE_IN_(AUDIO_SRC_LINEIN
,)
143 HAVE_SPDIF_IN_(AUDIO_SRC_SPDIF
,)
144 HAVE_FMRADIO_IN_(AUDIO_SRC_FMRADIO
,)
146 AUDIO_SRC_MAX
= AUDIO_NUM_SOURCES
-1,
147 AUDIO_SRC_DEFAULT
= AUDIO_SRC_PLAYBACK
150 extern int audio_channels
;
151 extern int audio_output_source
;
153 #ifdef HAVE_RECORDING
154 /* Recordable source implies it has the input as well */
156 /* For now there's no restrictions on any targets with which inputs
157 are recordable so define them as equivalent - if they do differ,
158 special handling is needed right now. */
161 __REC_SRC_FIRST
= -1,
162 HAVE_MIC_REC_(REC_SRC_MIC
,)
163 HAVE_LINE_REC_(REC_SRC_LINEIN
,)
164 HAVE_SPDIF_REC_(REC_SRC_SPDIF
,)
165 HAVE_FMRADIO_REC_(REC_SRC_FMRADIO
,)
168 #endif /* HAVE_RECORDING */
170 #if CONFIG_CODEC == SWCODEC
171 /* selects a source to monitor for recording or playback */
172 #define SRCF_PLAYBACK 0x0000 /* default */
173 #define SRCF_RECORDING 0x1000
175 /* for AUDIO_SRC_FMRADIO */
176 #define SRCF_FMRADIO_PLAYING 0x0000 /* default */
177 #define SRCF_FMRADIO_PAUSED 0x2000
181 #ifdef HAVE_RECORDING
182 /* parameters for audio_set_recording_options */
183 struct audio_recording_options
188 int rec_prerecord_time
;
189 #if CONFIG_CODEC == SWCODEC
191 int rec_source_flags
; /* for rec_set_source */
192 struct encoder_config enc_config
;
199 /* audio recording functions */
200 void audio_init_recording(unsigned int buffer_offset
);
201 void audio_close_recording(void);
202 void audio_record(const char *filename
);
203 void audio_stop_recording(void);
204 void audio_pause_recording(void);
205 void audio_resume_recording(void);
206 void audio_new_file(const char *filename
);
207 void audio_set_recording_options(struct audio_recording_options
*options
);
208 void audio_set_recording_gain(int left
, int right
, int type
);
209 unsigned long audio_recorded_time(void);
210 unsigned long audio_num_recorded_bytes(void);
212 #if CONFIG_CODEC == SWCODEC
213 /* SWCODEC recording functions */
215 bool audio_load_encoder(int afmt
);
216 void audio_remove_encoder(void);
217 unsigned char *audio_get_recording_buffer(size_t *buffer_size
);
218 #endif /* CONFIG_CODEC == SWCODEC */
220 #endif /* HAVE_RECORDING */
222 #if CONFIG_CODEC == SWCODEC
223 /* SWCODEC misc. audio functions */
224 #if INPUT_SRC_CAPS != 0
226 void audio_set_input_source(int source
, unsigned flags
);
227 /* audio_input_mux: target-specific implementation used by audio_set_source
228 to set hardware inputs and audio paths */
229 void audio_input_mux(int source
, unsigned flags
);
230 void audio_set_output_source(int source
);
231 #endif /* INPUT_SRC_CAPS */
232 #endif /* CONFIG_CODEC == SWCODEC */
235 /* returns index into rec_master_sampr_list */
236 int audio_get_spdif_sample_rate(void);
237 /* > 0: monitor EBUin, 0: Monitor IISrecv, <0: reset only */
238 void audio_spdif_set_monitor(int monitor_spdif
);
239 #endif /* HAVE_SPDIF_IN */
241 unsigned long audio_prev_elapsed(void);
243 #if CONFIG_CODEC != SWCODEC
244 /***********************************************************************/
245 /* audio event handling */
247 /* subscribe to one or more audio event(s) by OR'ing together the desired */
248 /* event IDs (defined below); a handler is called with a solitary event ID */
249 /* (so switch() is okay) and possibly some useful data (depending on the */
250 /* event); a handler must return one of the return codes defined below */
252 typedef int (*AUDIO_EVENT_HANDLER
)(unsigned short event
, unsigned long data
);
254 void audio_register_event_handler(AUDIO_EVENT_HANDLER handler
, unsigned short mask
);
256 /***********************************************************************/
257 /* handler return codes */
259 #define AUDIO_EVENT_RC_IGNORED 200
260 /* indicates that no action was taken or the event was not recognized */
262 #define AUDIO_EVENT_RC_HANDLED 201
263 /* indicates that the event was handled and some action was taken which renders
264 the original event invalid; USE WITH CARE!; this return code aborts all further
265 processing of the given event */
267 /***********************************************************************/
268 /* audio event IDs */
270 #define AUDIO_EVENT_POS_REPORT (1<<0)
271 /* sends a periodic song position report to handlers; a report is sent on
272 each kernal tick; the number of ticks per second is defined by HZ; on each
273 report the current song position is passed in 'data'; if a handler takes an
274 action that changes the song or the song position it must return
275 AUDIO_EVENT_RC_HANDLED which suppresses the event for any remaining handlers */
277 #define AUDIO_EVENT_END_OF_TRACK (1<<1)
278 /* generated when the end of the currently playing track is reached; no
279 data is passed; if the handler implements some alternate end-of-track
280 processing it should return AUDIO_EVENT_RC_HANDLED which suppresses the
281 event for any remaining handlers as well as the normal end-of-track