include/asm-arm/arch-omap/eac.h

   1 /*
   2  * linux/include/asm-arm/arch-omap2/eac.h
   3  *
   4  * Defines for Enhanced Audio Controller
   5  *
   6  * Contact: Jarkko Nikula <jarkko.nikula@nokia.com>
   7  *
   8  * Copyright (C) 2006 Nokia Corporation
   9  * Copyright (C) 2004 Texas Instruments, Inc.
  10  *
  11  * This program is free software; you can redistribute it and/or
  12  * modify it under the terms of the GNU General Public License
  13  * version 2 as published by the Free Software Foundation.
  14  *
  15  * This program is distributed in the hope that it will be useful, but
  16  * WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  18  * General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
  23  * 02110-1301 USA
  24  *
  25  */
  26
  27 #ifndef __ASM_ARM_ARCH_OMAP2_EAC_H
  28 #define __ASM_ARM_ARCH_OMAP2_EAC_H
  29
  30 #include <asm/arch/io.h>
  31 #include <asm/arch/hardware.h>
  32 #include <asm/irq.h>
  33
  34 #include <sound/driver.h>
  35 #include <sound/core.h>
  36
  37 /* master codec clock source */
  38 #define EAC_MCLK_EXT_MASK       0x100
  39 enum eac_mclk_src {
  40         EAC_MCLK_INT_11290000, /* internal 96 MHz / 8.5 = 11.29 Mhz */
  41         EAC_MCLK_EXT_11289600 = EAC_MCLK_EXT_MASK,
  42         EAC_MCLK_EXT_12288000,
  43         EAC_MCLK_EXT_2x11289600,
  44         EAC_MCLK_EXT_2x12288000,
  45 };
  46
  47 /* codec port interface mode */
  48 enum eac_codec_mode {
  49         EAC_CODEC_PCM,
  50         EAC_CODEC_AC97,
  51         EAC_CODEC_I2S,
  52 };
  53
  54 /* configuration structure for I2S mode */
  55 struct eac_i2s_conf {
  56         /* it seems according to TRM that the polarity-changed I2S mode is not
  57          * only that frame sync polarity (EAC.AC_FS) is changed but also direction
  58          * of it and interface serial clock (EAC.AC_SCLK) */
  59         unsigned        polarity_changed_mode:1;
  60         /* if enabled, then serial data starts one clock cycle after the
  61          * of EAC.AC_FS for first audio slot */
  62         unsigned        sync_delay_enable:1;
  63 };
  64
  65 /* configuration structure for EAC codec port */
  66 struct eac_codec {
  67         enum eac_mclk_src       mclk_src;
  68
  69         enum eac_codec_mode     codec_mode;
  70         union {
  71                 struct eac_i2s_conf     i2s;
  72         } codec_conf;
  73
  74         int             default_rate; /* audio sampling rate */
  75
  76         int             (* set_power)(void *private_data, int dac, int adc);
  77         int             (* register_controls)(void *private_data,
  78                                               struct snd_card *card);
  79         const char      *short_name;
  80
  81         void            *private_data;
  82 };
  83
  84 /* structure for passing platform dependent data to the EAC driver */
  85 struct eac_platform_data {
  86         int     (* init)(struct device *eac_dev);
  87         void    (* cleanup)(struct device *eac_dev);
  88         /* these callbacks are used to configure & control external MCLK
  89          * source. NULL if not used */
  90         int     (* enable_ext_clocks)(struct device *eac_dev);
  91         void    (* disable_ext_clocks)(struct device *eac_dev);
  92 };
  93
  94 extern void omap_init_eac(struct eac_platform_data *pdata);
  95
  96 extern int eac_register_codec(struct device *eac_dev, struct eac_codec *codec);
  97 extern void eac_unregister_codec(struct device *eac_dev);
  98
  99 extern int eac_set_mode(struct device *eac_dev, int play, int rec);
 100
 101 #endif /* __ASM_ARM_ARCH_OMAP2_EAC_H */