Microchip® Advanced Software Framework

usb_stream_player_with_resampling.c File Reference
#include <stdio.h>
#include "conf_usb.h"
#include "conf_audio_player.h"
#include "audio_mixer.h"
#include "usb_drv.h"
#include "usb_stream_player.h"
#include "dsp.h"
#include "cycle_counter.h"

Macros

#define BROKEN_STREAM_TIMER   4000
 

Functions

void dac_sample_sent_cb (void)
 This callback function is called when the DAC interrupt has sent the buffer 'n-1' and switches to buffer 'n'. More...
 
void dac_underflow_cb (void)
 This callback function is called when the PWM DAC interrupt does not have any more audio samples (i.e. More...
 
void player_init (void)
 
void player_shutdown (void)
 
void usb_stream_close (void)
 
static int usb_stream_count_nb_buffer (buffer_state_t state)
 Returns the number of buffer filtered by state. More...
 
static int usb_stream_current_buffer_size_left (void)
 Returns the length of the free part of the current buffer size. More...
 
static void usb_stream_fill_input_buffers (void *buffer, int size, int nb_channels, int bits_per_sample)
 
uint32_t usb_stream_get_buffer_level ()
 This function returns the number of full buffers. More...
 
uint16_t usb_stream_get_counter ()
 This function returns the internal audio counter. More...
 
static void * usb_stream_get_current_buffer_for_writing (int channel)
 Returns a pointer on free space where to store new samples. More...
 
uint8_t usb_stream_get_status (void)
 
uint16_t usb_stream_get_stream_status ()
 This function returns the audio status. More...
 
void usb_stream_init (uint32_t sample_rate_hz, uint8_t num_channels, uint8_t bits_per_sample, bool swap_channels)
 This function initializes the USB Stream driver. More...
 
int usb_stream_input (usb_stream_side_t side, uint8_t pipe_in, uint32_t *pFifoCount)
 This function takes the stream coming from the selected USB pipe and sends it to the DAC driver. More...
 
bool usb_stream_new_sample_rate (uint32_t sample_rate)
 Sync the sample rate of the audio output stream with the USB stream. More...
 
void usb_stream_out_of_samples (void)
 
int32_t usb_stream_ppm_get (void)
 This function returns the PPM differences between the input audio stream frequency and the DAC output frequency. More...
 
static bool usb_stream_process (void)
 
void usb_stream_resync (void)
 This function ensures that no underflow/underflow will never occur by adjusting the SSC/ABDAC frequencies. More...
 
bool usb_stream_task (void)
 
static void usb_stream_update_buffers (int written_buffer_size)
 Update usb_stream_context->current_buffer_index usb_stream_context->current_buffer. More...
 

Variables

static t_cpu_time broken_stream_timer
 
volatile uint16_t usb_stream_cnt =0
 
usb_stream_context_tusb_stream_context = NULL
 

#define BROKEN_STREAM_TIMER   4000

void dac_sample_sent_cb ( void  )

This callback function is called when the DAC interrupt has sent the buffer 'n-1' and switches to buffer 'n'.

The aim of this function is thus to prepare the buffer 'n+1'; so that there is always a pending buffer for the interrupt.

References usb_stream_context_t::current_full_buffer, usb_stream_context_t::error, and USB_STREAM_ERROR_UNDERFLOW.

void dac_underflow_cb ( void  )

This callback function is called when the PWM DAC interrupt does not have any more audio samples (i.e.

"famine").

References usb_stream_context_t::error, usb_stream_context_t::synchronized, and USB_STREAM_ERROR_UNDERFLOW.

static int usb_stream_count_nb_buffer ( buffer_state_t  state)
static
static int usb_stream_current_buffer_size_left ( void  )
inlinestatic

Returns the length of the free part of the current buffer size.

References usb_stream_context_t::current_buffer_index, and usb_stream_context_t::input_buffer_size.

Referenced by usb_stream_fill_input_buffers().

static void usb_stream_fill_input_buffers ( void *  buffer,
int  size,
int  nb_channels,
int  bits_per_sample 
)
static
uint32_t usb_stream_get_buffer_level ( void  )

This function returns the number of full buffers.

References BUFFER_STATE_FULL, and usb_stream_count_nb_buffer().

uint16_t usb_stream_get_counter ( void  )

This function returns the internal audio counter.

References usb_stream_cnt.

static void * usb_stream_get_current_buffer_for_writing ( int  channel)
inlinestatic
uint8_t usb_stream_get_status ( void  )
uint16_t usb_stream_get_stream_status ( void  )

This function returns the audio status.

References usb_stream_context_t::error.

void usb_stream_init ( uint32_t  sample_rate_hz,
uint8_t  num_channels,
uint8_t  bits_per_sample,
bool  swap_channels 
)

This function initializes the USB Stream driver.

References audio_mixer_dacs_setup_direct(), AUDIO_STREAM_IN_OUT_FS_DEFAULT_VALUE, AUDIO_STREAM_IN_OUT_FS_TRANSLATION_TAB, AUDIO_STREAM_MAX_NB_CHANNELS, AUDIO_STREAM_NB_INPUT_BUFFERS, AUDIO_STREAM_NB_OUTPUT_BUFFERS, bits_per_sample, usb_stream_context_t::bits_per_sample, BROKEN_STREAM_TIMER, buffer_t::buffer_state, BUFFER_STATE_EMPTY, dsp16_resampling_options_t::coefficients_generation, cpu_ms_2_cy(), cpu_set_timeout(), usb_stream_context_t::ctx, usb_stream_context_t::ctx_original, usb_stream_context_t::ctx_overrun, usb_stream_context_t::ctx_underrun, usb_stream_context_t::current_buffer, usb_stream_context_t::current_full_buffer, dsp16_resampling_get_output_max_buffer_size(), dsp16_resampling_setup(), usb_stream_context_t::duplicate_channels, dsp16_resampling_options_t::dynamic, usb_stream_context_t::error, FCPU_HZ, usb_stream_context_t::fs_output, resampling_config_t::gain, resampling_context_t::gain, resampling_config_t::gain_overrun, resampling_config_t::gain_underrun, usb_stream_context_t::input_buffer_size, usb_stream_context_t::input_buffers, max, usb_stream_context_t::nb_channels, num_channels, resampling_config_t::order, usb_stream_context_t::output_buffers, resampling_config_t::output_fs_hz, resampling_config_t::output_overrun_fs_hz, usb_stream_context_t::output_temp_buffer, resampling_config_t::output_underrun_fs_hz, resampling_context_t::resampling, usb_stream_context_t::status, swap_channels, usb_stream_context_t::swap_channels, usb_stream_context_t::synchronized, usb_stream_close(), USB_STREAM_ERROR_NONE, USB_STREAM_ERROR_UNSUPPORTED, and USB_STREAM_STATUS_IDLE.

Referenced by host_audio_task(), and usb_stream_new_sample_rate().

int usb_stream_input ( usb_stream_side_t  side,
uint8_t  pipe_in,
uint32_t *  pFifoCount 
)

This function takes the stream coming from the selected USB pipe and sends it to the DAC driver.

Moreover, it ensures that both input and output stream keep synchronized by adding or deleting samples.

Parameters
sideUSB_STREAM_HOST for USB host, USB_STREAM_DEVICE for device.
pipe_inNumber of the addressed pipe
pFifoCount(return parameter) NULL or pointer to the number of used buffers at this time
Returns
status: (USB_STREAM_STATUS_OK, USB_STREAM_STATUS_NOT_SYNCHRONIZED, USB_STREAM_STATUS_SPEED_UP, USB_STREAM_STATUS_SLOW_DOWN, USB_STREAM_STATUS_BUFFER_OVERFLOW)

References usb_stream_context_t::bits_per_sample, BROKEN_STREAM_TIMER, BUFFER_STATE_FULL, cpu_is_timeout(), cpu_ms_2_cy(), cpu_set_timeout(), usb_stream_context_t::duplicate_channels, usb_stream_context_t::error, FCPU_HZ, Host_byte_count, host_read_p_rxpacket(), Host_reset_pipe_fifo_access, usb_stream_context_t::input_temp_buffer, Min, usb_stream_context_t::nb_channels, usb_stream_context_t::status, Usb_byte_count, Usb_reset_endpoint_fifo_access, usb_stream_cnt, usb_stream_count_nb_buffer(), USB_STREAM_DEVICE, USB_STREAM_ERROR_BROKEN_STREAM, USB_STREAM_ERROR_NO_DATA, USB_STREAM_ERROR_NONE, USB_STREAM_ERROR_NOT_SYNCHRONIZED, usb_stream_fill_input_buffers(), USB_STREAM_HOST, USB_STREAM_STATUS_DATA_ACQUIRING, and USB_STREAM_STATUS_NOT_INITIALIZED.

Referenced by host_audio_task().

bool usb_stream_new_sample_rate ( uint32_t  sample_rate)

Sync the sample rate of the audio output stream with the USB stream.

Return values
falseThe new sample rate already matches the current settings.
trueThe output sample rate was changed.

References audio_mixer_dacs_flush_direct(), and usb_stream_init().

void usb_stream_out_of_samples ( void  )
int32_t usb_stream_ppm_get ( void  )

This function returns the PPM differences between the input audio stream frequency and the DAC output frequency.

Note that this information should only be considered as an indication, for debug or visual effect for example.

Referenced by mmi_activity_display().

void usb_stream_resync ( void  )

This function ensures that no underflow/underflow will never occur by adjusting the SSC/ABDAC frequencies.

References usb_stream_task().

Referenced by host_audio_task().

t_cpu_time broken_stream_timer
static
volatile uint16_t usb_stream_cnt =0
usb_stream_context_t* usb_stream_context = NULL