XMOS xsoftip Audio SDRAM-Delay Function Library

Transcription

1 XMOS xsoftip Audio SDRAM-Delay Function Library Document Number: Publication Date: 2014/4/16 XMOS 2014, All Rights Reserved.

2 XMOS xsoftip Audio SDRAM-Delay Function Library 2/10 Table of Contents 1 Overview 3 2 Resource Requirements Available Memory Computation Evaluation Platforms Recommended Hardware slicekit Demonstration Applications Stand Alone Demo Reverb Demo API Configuration Defines Functions Data Types Data Structures Configuration Functions DSP Processing Functions Programming Guide Key Files Usage Demo Applications Long-Delay Application For slicekit Board (app_slicekit_long_delay) Makefile Running the application with the Command Line Tools Trouble-shooting Try Other Audio Applications

3 1 Overview This function library can be used to create long multiple echoes by feeding the input audio stream into a delay-line. The delay-line returns a set of delayed outputs (taps), with the number of taps being configurable. This library makes use of the xsoftip SDRAM controller component, and for an 8 MByte SDRAM, can delay a stereo channel by up to 20 seconds (at 48 khz sample rate) There is a delay-line that uses only the 64 KByte xcore memory, but only short delays are possible. See the Short Delay Function Library.

4 2 Resource Requirements IN THIS CHAPTER Available Memory Computation 2.1 Available Memory This application stores the delayed samples in the SDRAM Memory-Slice, the memory useage is variable depending on the maximum delay requested, and the number of channels being processed. A MEM_SAMPS definition is used to indicate the amount of memory available for the delay-line. Currently this is set at 2 Mega-samples, which is the default size for a 8 MByte SDRAM Memory-slice. This approximate memory usage for this module is (figures shown in Bytes): codememory: 11K datamemory: 10K 2.2 Computation The DSP processing for the delay-line does NOT use multiplication. So far a maximum of 4 delay taps have been used successfully, each on 4 channels. By inspecting timings, the processing time for one tap is about 80 cycles. For a 48 khz sample rate and 500 MHz processor, this would allow about 100 taps/sample/channel.

5 3 Evaluation Platforms IN THIS CHAPTER Recommended Hardware Demonstration Applications 3.1 Recommended Hardware slicekit This module may be evaluated using the slicekit Modular Development Platform, available from digikey. Minimum Required board SKUs are: XP-SKC-L16 (slicekit L16 Core Board) plus XA-SK-AUDIO plus XA-SK-XTAG2 (slicekit xtag adaptor) XA-SK-SDRAM (Memory-Slice Board) plugged into same Tile as running main.xc 3.2 Demonstration Applications Stand Alone Demo Example stand-alone usage of this module can be found within the xsoftip suite as follows: Package: sw_audio_effects Application: app_slicekit_long_delay Reverb Demo This module is used in the app_slicekit_long_reverb example application which shows how the module is deployed within the context of a more complex audio processing application. Note that in addition to the recommended hardware above, the XA-SK-SDRAM slicecard will also be required, since this application buffers more audio samples than can be accommodated in the free internal SRAM of the xcore Tile. Package: sw_audio_effects Application: app_slicekit_long_reverb

6 4 API IN THIS CHAPTER Configuration Defines Functions 4.1 Configuration Defines DEF_SAMP_FREQ MEM_SAMPS Default Sample Frequency (In Hz) MByte Memory available to configure delay buffers (in samples), adjust to suit platform: (2 << 20) 4.2 Functions Data Types S32_T 32-bit types Data Structures DELAY_PARAM_TAG Structure containing delay parameters. Fields S32_T us_delays S32_T num S32_T freq S32_T dbg

7 XMOS xsoftip Audio SDRAM-Delay Function Library 7/ Configuration Functions config_sdram_delay() Configure sdram_delay parameters. Must be called before use_sdram_delay Type void config_sdram_delay(delay_param_s &cur_param_s) Parameters cur_param_s DSP Processing Functions use_sdram_delay() // Reference to structure containing delay-line parameters Exercise sdram_delay for one input sample. Must have previously called config_sdram_delay Type void use_sdram_delay(cntrl_sdram_s &sdram_gs) Parameters sdram_gs // Reference to structure containing data to control SDRAM buffering

8 5 Programming Guide IN THIS CHAPTER Key Files Usage 5.1 Key Files sdram_delay.c: Contains C function library sdram_delay.h: Header file for C function library 5.2 Usage There are 2 functions in the C library, designed to be called from an xc file. config_sdram_delay() Called to do initial configuration of delay parameters (e.g. delay offsets). WARNING: This must be called before... use_sdram_delay() Called to apply set of delays to one audio-sample, designed to be called from an xc file. Note, after initialization, config_sdram_delay() can be called again as required to re-configure the delay offsets. Delays are set in microseconds in the us_delays field of the DELAY_PARAM_S structure.

9 6 Demo Applications IN THIS CHAPTER Long-Delay Application For slicekit Board (app_slicekit_long_delay) Try Other Audio Applications To get started with this application, run through the instructions in the BiQuad Filter quickstart guide. 6.1 Long-Delay Application For slicekit Board (app_slicekit_long_delay) This application uses module_dsp_long_delay to create a set of delays (or echoes) for an audio-stream, passing through the slicekit Core board. The audio is connected to the Audio Slice board using the following Analogue ports: Input 0/1 (Microphone mini-jack) Output 0/1 (Headphone mini-jack) An intermediate signal is created mixing the input stream with the output of the delay-line, which is set-up to produce 4 different echoes. This intermedate signal is used for the output, but also fed back into the delay-line, to create a potentially infinite set of echoes. In fact the mixing is arranged so that the echoes decay exponentially in amplitude Makefile The Makefile is found in the top-level directory of the application (e.g. app_slicekit_long_delay) The application is for the slicekit Core Board so the TARGET variable needs to be set in the Makefile: e.g TARGET = SLICEKIT-L16.xn The number of channels supported in currently 2 or 4, this is set in auto_conf.h: e.g. NUM_DELAY_CHANS = Running the application with the Command Line Tools In the top-level directory of the application (e.g. app_slicekit_long_delay) type

10 XMOS xsoftip Audio SDRAM-Delay Function Library 10/10 xmake clean xmake all Connect the board to your PC using an xtag-2 To start the demo type xrun io bin/app_slicekit_long_delay.xe When listening to the output audio at 48kHz sample rate, you should hear the following... About 16 seconds of the effect (i.e. multiple echoes decaying in amplitude), followed by About 8 seconds of the dry (un-effected) signal. This cycle will repeat indefinitely Trouble-shooting During initialization, and when the system is reconfigured, there may be audible clicks in the audio. This is expected. 6.2 Try Other Audio Applications Another audio application is app_slicekit_long_reverb. The long reverb application is an example of a more complex application running 4 cores, and combining the biquad, loudness and long-delay modules to create large room-sizes, e.g. 200 meters (for a stereo channel at 48 khz). Long-Reverb slicekit Audio Demo Copyright 2014, All Rights Reserved. Xmos Ltd. is the owner or licensee of this design, code, or Information (collectively, the Information ) and is providing it to you AS IS with no warranty of any kind, express or implied and shall have no liability in relation to its use. Xmos Ltd. makes no representation that the Information, or any particular implementation thereof, is or will be free from any claims of infringement and again, shall have no liability in relation to any such claims. XMOS and the XMOS logo are registered trademarks of Xmos Ltd. in the United Kingdom and other countries, and may not be used without written permission. All other trademarks are property of their respective owners. Where those designations appear in this book, and XMOS was aware of a trademark claim, the designations have been printed with initial capital letters or in all capitals.