wm8731audio.h

WM9713 audio codec driver for WinCE 5.0

/*-----------------------------------------------------------------------------
 * Copyright (c) Wolfson Microelectronics plc.  All rights reserved.
 *
 * This software as well as any related documentation is furnished under 
 * license and may only be used or copied in accordance with the terms of the 
 * license. The information in this file is furnished for informational use 
 * only, is subject to change without notice, and should not be construed as 
 * a commitment by Wolfson Microelectronics plc. Wolfson Microelectronics plc
 * assumes no responsibility or liability for any errors or inaccuracies that
 * may appear in this document or any software that may be provided in
 * association with this document. 
 *
 * Except as permitted by such license, no part of this document may be 
 * reproduced, stored in a retrieval system, or transmitted in any form or by 
 * any means without the express written consent of Wolfson Microelectronics plc. 
 *
 * $Id: WM8731Audio.h 2333 2005-10-20 14:06:34Z ib $
 *
 * This file contains platform-independent routines for controlling
 * audio on Wolfson WM8731 codecs.
 *
 * Warning:
 *  This driver is specifically written for Wolfson Codecs. It is not a 
 *  general CODEC device driver.
 *
 *---------------------------------------------------------------------------*/
#ifndef __WM8731AUDIO_H__
#define __WM8731AUDIO_H__

/*
 * Include files
 */

/*
 * Definitions
 */

/*
 * Function prototypes
 */
#ifdef __cplusplus
extern "C" {
#endif

/*
 * Only provide these if we're doing audio support for WM8731 devices.
 */
#if WM_AUDIO && WM8731_FAMILY

/*-----------------------------------------------------------------------------
 * Function:    WM8731ConfigureInterface
 *
 * Configures the streaming format for the link for the given interface.
 *
 * Parameters:
 *      hDevice         handle to the device (from WMOpenDevice)
 *      audioIF         the interface to configure
 *      isMaster        whether the codec masters the link
 *      format          the streaming format to use
 *      width           the number of bits per sample
 *      flags           extra configuration flags
 *
 * Returns:     WMSTATUS
 *      See WMStatus.h.
 *---------------------------------------------------------------------------*/
WMSTATUS WM8731ConfigureInterface( WM_DEVICE_HANDLE     hDevice,
                                   WM_AUDIO_INTERFACE   audioIF,
                                   WM_BOOL              isMaster,
                                   WM_AUDIOIF_FORMAT    format,
                                   WM_AUDIOIF_WIDTH     width,
                                   WM_AUDIOIF_FLAGS     flags
                                 );
                                 
/*-----------------------------------------------------------------------------
 * Function:    WM8731UnconfigureInterface
 *
 * Unconfigures the streaming format for the link for the given interface.
 *
 * Parameters:
 *      hDevice         handle to the device (from WMOpenDevice)
 *      audioIF         the interface to configure
 *
 * Returns:     WMSTATUS
 *      See WMStatus.h.
 *---------------------------------------------------------------------------*/
WMSTATUS WM8731UnconfigureInterface( WM_DEVICE_HANDLE     hDevice,
                                     WM_AUDIO_INTERFACE   audioIF
                                   );

/*-----------------------------------------------------------------------------
 * Function:    WM8731SetSampleRate
 *
 * Called to set the sample rate in the audio-specific sections of the chip. 
 *
 * Parameters:
 *      hDevice      handle to the device (from WMOpenDevice)
 *      stream       The stream for which to set the sample rate
 *      sampleRate   The new sample rate.
 *
 * Returns:     WMSTATUS
 *       See WMStatus.h.
 *---------------------------------------------------------------------------*/
WMSTATUS WM8731SetSampleRate( WM_DEVICE_HANDLE hDevice,
                              WM_STREAM_ID     stream, 
                              WM_SAMPLE_RATE   sampleRate
                            );

/*-----------------------------------------------------------------------------
 * Function:    WM8731EnableHifiPath
 *
 * Sets up for sending data to the HIFI DAC across I2S.
 *
 * Parameters:
 *      hDevice      handle to the device (from WMOpenDevice)
 *
 * Returns:     WMSTATUS
 *      See WMStatus.h
 *---------------------------------------------------------------------------*/
WMSTATUS WM8731EnableHifiPath( WM_DEVICE_HANDLE hDevice );

/*-----------------------------------------------------------------------------
 * Function:    WM8731ConfigureHiFiPath
 *
 * Configure and enable the paths from the DAC to the outputs.
 * NOTE: This function is enabling as many of the outputs as possible
 *       so that there is a good chance that anything coming from the
 *       DAC will end up being heard through any of the outputs.
 *       You will probably want to change this set up to suit your
 *       particular application.
 *
 * Parameters:
 *      hDevice      handle to the device (from WMOpenDevice)
 *
 * Returns:     WMSTATUS
 *      See WMStatus.h
 *---------------------------------------------------------------------------*/
WMSTATUS WM8731ConfigureHiFiPath( WM_DEVICE_HANDLE hDevice );

#endif  /* WM_AUDIO && WM8731_FAMILY */

#ifdef __cplusplus
}   /* extern "C" */
#endif

#endif  /* __WM8731AUDIO_H__ */
/*------------------------------ END OF FILE ---------------------------------*/