mirror of
https://github.com/Rockbox/rockbox.git
synced 2025-12-07 05:35:02 -05:00
bbcf210c94
They haven't seen any work since 2013, and likely hasn't compiled in at least a couple of releases -- not that we ever "released" anything for these targets. Futhermore, upstream for both has been effectively dead for about as long, and there's been no user reports of these being used since 2017 (and even then only in passing). It isn't worth the effort to triage their current state, much less uplift into something supportable, while the maintenance burden of keeping these things in-tree can be demonstrated by the diffstat. Change-Id: Id93bd450679d1b75e2c74295b3ae1548cd241b24
147 lines
4.8 KiB
C
147 lines
4.8 KiB
C
/***************************************************************************
|
|
* __________ __ ___.
|
|
* Open \______ \ ____ ____ | | _\_ |__ _______ ___
|
|
* Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
|
|
* Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
|
|
* Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
|
|
* \/ \/ \/ \/ \/
|
|
* $Id$
|
|
*
|
|
* Copyright (C) 2011 by Michael Sevakis
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
* KIND, either express or implied.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifndef PCM_MIXER_H
|
|
#define PCM_MIXER_H
|
|
|
|
#include <sys/types.h>
|
|
|
|
/** Simple config **/
|
|
|
|
/* Length of PCM frames (always) */
|
|
#if CONFIG_CPU == PP5002
|
|
/* There's far less time to do mixing because HW FIFOs are short */
|
|
#define MIX_FRAME_SAMPLES 64
|
|
#elif (CONFIG_CPU == JZ4760B) || (CONFIG_CPU == JZ4732)
|
|
/* These MIPS32r1 targets have a very high interrupt latency, which
|
|
unfortunately causes a lot of audio underruns under even moderate load */
|
|
#define MIX_FRAME_SAMPLES 2048
|
|
#elif defined(DX50) || defined(DX90)
|
|
/* iBasso Devices: Match Rockbox PCM buffer size to ALSA PCM buffer size
|
|
to minimize memory transfers. */
|
|
#define MIX_FRAME_SAMPLES 2048
|
|
#elif (CONFIG_PLATFORM & PLATFORM_HOSTED)
|
|
/* Hosted targets need larger buffers for decent performance due to
|
|
OS locking/scheduling overhead */
|
|
#define MIX_FRAME_SAMPLES 1024
|
|
#else
|
|
/* Assume HW DMA engine is available or sufficient latency exists in the
|
|
PCM pathway */
|
|
#define MIX_FRAME_SAMPLES 256
|
|
#endif
|
|
|
|
#if defined(CPU_COLDFIRE) || defined(CPU_PP)
|
|
/* For Coldfire, it's just faster
|
|
For PortalPlayer, this also avoids more expensive cache coherency */
|
|
#define DOWNMIX_BUF_IBSS IBSS_ATTR
|
|
#else
|
|
/* Otherwise can't DMA from IRAM, IRAM is pointless or worse */
|
|
#define DOWNMIX_BUF_IBSS
|
|
#endif
|
|
|
|
#if defined(CPU_COLDFIRE) || defined(CPU_PP)
|
|
#define MIXER_CALLBACK_ICODE ICODE_ATTR
|
|
#else
|
|
#define MIXER_CALLBACK_ICODE
|
|
#endif
|
|
|
|
|
|
/** Definitions **/
|
|
|
|
/* Channels are preassigned for simplicity */
|
|
enum pcm_mixer_channel
|
|
{
|
|
PCM_MIXER_CHAN_PLAYBACK = 0,
|
|
#ifdef USB_ENABLE_AUDIO
|
|
PCM_MIXER_CHAN_USBAUDIO,
|
|
#endif
|
|
PCM_MIXER_CHAN_VOICE,
|
|
#ifndef HAVE_HARDWARE_BEEP
|
|
PCM_MIXER_CHAN_BEEP,
|
|
#endif
|
|
/* Add new channel indexes above this line */
|
|
PCM_MIXER_NUM_CHANNELS,
|
|
};
|
|
|
|
/* Channel playback states */
|
|
enum channel_status
|
|
{
|
|
CHANNEL_STOPPED = 0,
|
|
CHANNEL_PLAYING,
|
|
CHANNEL_PAUSED,
|
|
};
|
|
|
|
#define MIX_AMP_UNITY 0x00010000
|
|
#define MIX_AMP_MUTE 0x00000000
|
|
|
|
|
|
/** Public interfaces **/
|
|
|
|
/* Start playback on a channel */
|
|
void mixer_channel_play_data(enum pcm_mixer_channel channel,
|
|
pcm_play_callback_type get_more,
|
|
const void *start, size_t size);
|
|
|
|
/* Pause or resume a channel (when started) */
|
|
void mixer_channel_play_pause(enum pcm_mixer_channel channel, bool play);
|
|
|
|
/* Stop playback on a channel */
|
|
void mixer_channel_stop(enum pcm_mixer_channel channel);
|
|
|
|
/* Set channel's amplitude factor */
|
|
void mixer_channel_set_amplitude(enum pcm_mixer_channel channel,
|
|
unsigned int amplitude);
|
|
|
|
/* Return channel's playback status */
|
|
enum channel_status mixer_channel_status(enum pcm_mixer_channel channel);
|
|
|
|
/* Returns amount data remaining in channel before next callback */
|
|
size_t mixer_channel_get_bytes_waiting(enum pcm_mixer_channel channel);
|
|
|
|
/* Return pointer to channel's playing audio data and the size remaining */
|
|
const void * mixer_channel_get_buffer(enum pcm_mixer_channel channel,
|
|
int *count);
|
|
|
|
/* Calculate peak values for channel */
|
|
void mixer_channel_calculate_peaks(enum pcm_mixer_channel channel,
|
|
struct pcm_peaks *peaks);
|
|
|
|
/* Adjust channel pointer by a given offset to support movable buffers */
|
|
void mixer_adjust_channel_address(enum pcm_mixer_channel channel,
|
|
off_t offset);
|
|
|
|
/* Set a hook that is called upon getting a new source buffer for a channel
|
|
NOTE: Called for each buffer, not each mixer chunk */
|
|
typedef void (*chan_buffer_hook_fn_type)(const void *start, size_t size);
|
|
|
|
void mixer_channel_set_buffer_hook(enum pcm_mixer_channel channel,
|
|
chan_buffer_hook_fn_type fn);
|
|
|
|
/* Stop ALL channels and PCM and reset state */
|
|
void mixer_reset(void);
|
|
|
|
/* Set output samplerate */
|
|
void mixer_set_frequency(unsigned int samplerate);
|
|
|
|
/* Get output samplerate */
|
|
unsigned int mixer_get_frequency(void);
|
|
|
|
#endif /* PCM_MIXER_H */
|