LXR linux/sound/pci/lola/lola.h

   1/*
   2 *  Support for Digigram Lola PCI-e boards
   3 *
   4 *  Copyright (c) 2011 Takashi Iwai <tiwai@suse.de>
   5 *
   6 *  This program is free software; you can redistribute it and/or modify it
   7 *  under the terms of the GNU General Public License as published by the Free
   8 *  Software Foundation; either version 2 of the License, or (at your option)
   9 *  any later version.
  10 *
  11 *  This program is distributed in the hope that it will be useful, but WITHOUT
  12 *  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13 *  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  14 *  more details.
  15 *
  16 *  You should have received a copy of the GNU General Public License along with
  17 *  this program; if not, write to the Free Software Foundation, Inc., 59
  18 *  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  19 */
  20
  21#ifndef _LOLA_H
  22#define _LOLA_H
  23
  24#define DRVNAME "snd-lola"
  25#define SFX     DRVNAME ": "
  26
  27/*
  28 * Lola HD Audio Registers BAR0
  29 */
  30#define LOLA_BAR0_GCAP          0x00
  31#define LOLA_BAR0_VMIN          0x02
  32#define LOLA_BAR0_VMAJ          0x03
  33#define LOLA_BAR0_OUTPAY        0x04
  34#define LOLA_BAR0_INPAY         0x06
  35#define LOLA_BAR0_GCTL          0x08
  36#define LOLA_BAR0_WAKEEN        0x0c
  37#define LOLA_BAR0_STATESTS      0x0e
  38#define LOLA_BAR0_GSTS          0x10
  39#define LOLA_BAR0_OUTSTRMPAY    0x18
  40#define LOLA_BAR0_INSTRMPAY     0x1a
  41#define LOLA_BAR0_INTCTL        0x20
  42#define LOLA_BAR0_INTSTS        0x24
  43#define LOLA_BAR0_WALCLK        0x30
  44#define LOLA_BAR0_SSYNC         0x38
  45
  46#define LOLA_BAR0_CORBLBASE     0x40
  47#define LOLA_BAR0_CORBUBASE     0x44
  48#define LOLA_BAR0_CORBWP        0x48    /* no ULONG access */
  49#define LOLA_BAR0_CORBRP        0x4a    /* no ULONG access */
  50#define LOLA_BAR0_CORBCTL       0x4c    /* no ULONG access */
  51#define LOLA_BAR0_CORBSTS       0x4d    /* UCHAR access only */
  52#define LOLA_BAR0_CORBSIZE      0x4e    /* no ULONG access */
  53
  54#define LOLA_BAR0_RIRBLBASE     0x50
  55#define LOLA_BAR0_RIRBUBASE     0x54
  56#define LOLA_BAR0_RIRBWP        0x58
  57#define LOLA_BAR0_RINTCNT       0x5a    /* no ULONG access */
  58#define LOLA_BAR0_RIRBCTL       0x5c
  59#define LOLA_BAR0_RIRBSTS       0x5d    /* UCHAR access only */
  60#define LOLA_BAR0_RIRBSIZE      0x5e    /* no ULONG access */
  61
  62#define LOLA_BAR0_ICW           0x60
  63#define LOLA_BAR0_IRR           0x64
  64#define LOLA_BAR0_ICS           0x68
  65#define LOLA_BAR0_DPLBASE       0x70
  66#define LOLA_BAR0_DPUBASE       0x74
  67
  68/* stream register offsets from stream base 0x80 */
  69#define LOLA_BAR0_SD0_OFFSET    0x80
  70#define LOLA_REG0_SD_CTL        0x00
  71#define LOLA_REG0_SD_STS        0x03
  72#define LOLA_REG0_SD_LPIB       0x04
  73#define LOLA_REG0_SD_CBL        0x08
  74#define LOLA_REG0_SD_LVI        0x0c
  75#define LOLA_REG0_SD_FIFOW      0x0e
  76#define LOLA_REG0_SD_FIFOSIZE   0x10
  77#define LOLA_REG0_SD_FORMAT     0x12
  78#define LOLA_REG0_SD_BDLPL      0x18
  79#define LOLA_REG0_SD_BDLPU      0x1c
  80
  81/*
  82 * Lola Digigram Registers BAR1
  83 */
  84#define LOLA_BAR1_FPGAVER       0x00
  85#define LOLA_BAR1_DEVER         0x04
  86#define LOLA_BAR1_UCBMV         0x08
  87#define LOLA_BAR1_JTAG          0x0c
  88#define LOLA_BAR1_UARTRX        0x10
  89#define LOLA_BAR1_UARTTX        0x14
  90#define LOLA_BAR1_UARTCR        0x18
  91#define LOLA_BAR1_NVRAMVER      0x1c
  92#define LOLA_BAR1_CTRLSPI       0x20
  93#define LOLA_BAR1_DSPI          0x24
  94#define LOLA_BAR1_AISPI         0x28
  95#define LOLA_BAR1_GRAN          0x2c
  96
  97#define LOLA_BAR1_DINTCTL       0x80
  98#define LOLA_BAR1_DIINTCTL      0x84
  99#define LOLA_BAR1_DOINTCTL      0x88
 100#define LOLA_BAR1_LRC           0x90
 101#define LOLA_BAR1_DINTSTS       0x94
 102#define LOLA_BAR1_DIINTSTS      0x98
 103#define LOLA_BAR1_DOINTSTS      0x9c
 104
 105#define LOLA_BAR1_DSD0_OFFSET   0xa0
 106#define LOLA_BAR1_DSD_SIZE      0x18
 107
 108#define LOLA_BAR1_DSDnSTS       0x00
 109#define LOLA_BAR1_DSDnLPIB      0x04
 110#define LOLA_BAR1_DSDnCTL       0x08
 111#define LOLA_BAR1_DSDnLVI       0x0c
 112#define LOLA_BAR1_DSDnBDPL      0x10
 113#define LOLA_BAR1_DSDnBDPU      0x14
 114
 115#define LOLA_BAR1_SSYNC         0x03e8
 116
 117#define LOLA_BAR1_BOARD_CTRL    0x0f00
 118#define LOLA_BAR1_BOARD_MODE    0x0f02
 119
 120#define LOLA_BAR1_SOURCE_GAIN_ENABLE            0x1000
 121#define LOLA_BAR1_DEST00_MIX_GAIN_ENABLE        0x1004
 122#define LOLA_BAR1_DEST31_MIX_GAIN_ENABLE        0x1080
 123#define LOLA_BAR1_SOURCE00_01_GAIN              0x1084
 124#define LOLA_BAR1_SOURCE30_31_GAIN              0x10c0
 125#define LOLA_BAR1_SOURCE_GAIN(src) \
 126        (LOLA_BAR1_SOURCE00_01_GAIN + (src) * 2)
 127#define LOLA_BAR1_DEST00_MIX00_01_GAIN          0x10c4
 128#define LOLA_BAR1_DEST00_MIX30_31_GAIN          0x1100
 129#define LOLA_BAR1_DEST01_MIX00_01_GAIN          0x1104
 130#define LOLA_BAR1_DEST01_MIX30_31_GAIN          0x1140
 131#define LOLA_BAR1_DEST31_MIX00_01_GAIN          0x1884
 132#define LOLA_BAR1_DEST31_MIX30_31_GAIN          0x18c0
 133#define LOLA_BAR1_MIX_GAIN(dest, mix) \
 134        (LOLA_BAR1_DEST00_MIX00_01_GAIN + (dest) * 0x40 + (mix) * 2)
 135#define LOLA_BAR1_ANALOG_CLIP_IN                0x18c4
 136#define LOLA_BAR1_PEAKMETERS_SOURCE00_01        0x18c8
 137#define LOLA_BAR1_PEAKMETERS_SOURCE30_31        0x1904
 138#define LOLA_BAR1_PEAKMETERS_SOURCE(src) \
 139        (LOLA_BAR1_PEAKMETERS_SOURCE00_01 + (src) * 2)
 140#define LOLA_BAR1_PEAKMETERS_DEST00_01          0x1908
 141#define LOLA_BAR1_PEAKMETERS_DEST30_31          0x1944
 142#define LOLA_BAR1_PEAKMETERS_DEST(dest) \
 143        (LOLA_BAR1_PEAKMETERS_DEST00_01 + (dest) * 2)
 144#define LOLA_BAR1_PEAKMETERS_AGC00_01           0x1948
 145#define LOLA_BAR1_PEAKMETERS_AGC14_15           0x1964
 146#define LOLA_BAR1_PEAKMETERS_AGC(x) \
 147        (LOLA_BAR1_PEAKMETERS_AGC00_01 + (x) * 2)
 148
 149/* GCTL reset bit */
 150#define LOLA_GCTL_RESET         (1 << 0)
 151/* GCTL unsolicited response enable bit */
 152#define LOLA_GCTL_UREN          (1 << 8)
 153
 154/* CORB/RIRB control, read/write pointer */
 155#define LOLA_RBCTL_DMA_EN       0x02    /* enable DMA */
 156#define LOLA_RBCTL_IRQ_EN       0x01    /* enable IRQ */
 157#define LOLA_RBRWP_CLR          0x8000  /* read/write pointer clear */
 158
 159#define LOLA_RIRB_EX_UNSOL_EV   0x40000000
 160#define LOLA_RIRB_EX_ERROR      0x80000000
 161
 162/* CORB int mask: CMEI[0] */
 163#define LOLA_CORB_INT_CMEI      0x01
 164#define LOLA_CORB_INT_MASK      LOLA_CORB_INT_CMEI
 165
 166/* RIRB int mask: overrun[2], response[0] */
 167#define LOLA_RIRB_INT_RESPONSE  0x01
 168#define LOLA_RIRB_INT_OVERRUN   0x04
 169#define LOLA_RIRB_INT_MASK      (LOLA_RIRB_INT_RESPONSE | LOLA_RIRB_INT_OVERRUN)
 170
 171/* DINTCTL and DINTSTS */
 172#define LOLA_DINT_GLOBAL        0x80000000 /* global interrupt enable bit */
 173#define LOLA_DINT_CTRL          0x40000000 /* controller interrupt enable bit */
 174#define LOLA_DINT_FIFOERR       0x20000000 /* global fifo error enable bit */
 175#define LOLA_DINT_MUERR         0x10000000 /* global microcontroller underrun error */
 176
 177/* DSDnCTL bits */
 178#define LOLA_DSD_CTL_SRST       0x01    /* stream reset bit */
 179#define LOLA_DSD_CTL_SRUN       0x02    /* stream DMA start bit */
 180#define LOLA_DSD_CTL_IOCE       0x04    /* interrupt on completion enable */
 181#define LOLA_DSD_CTL_DEIE       0x10    /* descriptor error interrupt enable */
 182#define LOLA_DSD_CTL_VLRCV      0x20    /* valid LRCountValue information in bits 8..31 */
 183#define LOLA_LRC_MASK           0xffffff00
 184
 185/* DSDnSTS */
 186#define LOLA_DSD_STS_BCIS       0x04    /* buffer completion interrupt status */
 187#define LOLA_DSD_STS_DESE       0x10    /* descriptor error interrupt */
 188#define LOLA_DSD_STS_FIFORDY    0x20    /* fifo ready */
 189
 190#define LOLA_CORB_ENTRIES       256
 191
 192#define MAX_STREAM_IN_COUNT     16
 193#define MAX_STREAM_OUT_COUNT    16
 194#define MAX_STREAM_COUNT        16
 195#define MAX_PINS                MAX_STREAM_COUNT
 196#define MAX_STREAM_BUFFER_COUNT 16
 197#define MAX_AUDIO_INOUT_COUNT   16
 198
 199#define LOLA_CLOCK_TYPE_INTERNAL    0
 200#define LOLA_CLOCK_TYPE_AES         1
 201#define LOLA_CLOCK_TYPE_AES_SYNC    2
 202#define LOLA_CLOCK_TYPE_WORDCLOCK   3
 203#define LOLA_CLOCK_TYPE_ETHERSOUND  4
 204#define LOLA_CLOCK_TYPE_VIDEO       5
 205
 206#define LOLA_CLOCK_FORMAT_NONE      0
 207#define LOLA_CLOCK_FORMAT_NTSC      1
 208#define LOLA_CLOCK_FORMAT_PAL       2
 209
 210#define MAX_SAMPLE_CLOCK_COUNT  48
 211
 212/* parameters used with mixer widget's mixer capabilities */
 213#define LOLA_PEAK_METER_CAN_AGC_MASK            1
 214#define LOLA_PEAK_METER_CAN_ANALOG_CLIP_MASK    2
 215
 216struct lola_bar {
 217        unsigned long addr;
 218        void __iomem *remap_addr;
 219};
 220
 221/* CORB/RIRB */
 222struct lola_rb {
 223        u32 *buf;               /* CORB/RIRB buffer, 8 byte per each entry */
 224        dma_addr_t addr;        /* physical address of CORB/RIRB buffer */
 225        unsigned short rp, wp;  /* read/write pointers */
 226        int cmds;               /* number of pending requests */
 227};
 228
 229/* Pin widget setup */
 230struct lola_pin {
 231        unsigned int nid;
 232        bool is_analog;
 233        unsigned int amp_mute;
 234        unsigned int amp_step_size;
 235        unsigned int amp_num_steps;
 236        unsigned int amp_offset;
 237        unsigned int max_level;
 238        unsigned int config_default_reg;
 239        unsigned int fixed_gain_list_len;
 240        unsigned int cur_gain_step;
 241};
 242
 243struct lola_pin_array {
 244        unsigned int num_pins;
 245        unsigned int num_analog_pins;
 246        struct lola_pin pins[MAX_PINS];
 247};
 248
 249/* Clock widget setup */
 250struct lola_sample_clock {
 251        unsigned int type;
 252        unsigned int format;
 253        unsigned int freq;
 254};
 255
 256struct lola_clock_widget {
 257        unsigned int nid;
 258        unsigned int items;
 259        unsigned int cur_index;
 260        unsigned int cur_freq;
 261        bool cur_valid;
 262        struct lola_sample_clock sample_clock[MAX_SAMPLE_CLOCK_COUNT];
 263        unsigned int idx_lookup[MAX_SAMPLE_CLOCK_COUNT];
 264};
 265
 266#define LOLA_MIXER_DIM      32
 267struct lola_mixer_array {
 268        u32 src_gain_enable;
 269        u32 dest_mix_gain_enable[LOLA_MIXER_DIM];
 270        u16 src_gain[LOLA_MIXER_DIM];
 271        u16 dest_mix_gain[LOLA_MIXER_DIM][LOLA_MIXER_DIM];
 272};
 273
 274/* Mixer widget setup */
 275struct lola_mixer_widget {
 276        unsigned int nid;
 277        unsigned int caps;
 278        struct lola_mixer_array __user *array;
 279        struct lola_mixer_array *array_saved;
 280        unsigned int src_stream_outs;
 281        unsigned int src_phys_ins;
 282        unsigned int dest_stream_ins;
 283        unsigned int dest_phys_outs;
 284        unsigned int src_stream_out_ofs;
 285        unsigned int dest_phys_out_ofs;
 286        unsigned int src_mask;
 287        unsigned int dest_mask;
 288};
 289
 290/* Audio stream */
 291struct lola_stream {
 292        unsigned int nid;       /* audio widget NID */
 293        unsigned int index;     /* array index */
 294        unsigned int dsd;       /* DSD index */
 295        bool can_float;
 296        struct snd_pcm_substream *substream; /* assigned PCM substream */
 297        struct lola_stream *master;     /* master stream (for multi-channel) */
 298
 299        /* buffer setup */
 300        unsigned int bufsize;
 301        unsigned int period_bytes;
 302        unsigned int frags;
 303
 304        /* format + channel setup */
 305        unsigned int format_verb;
 306
 307        /* flags */
 308        unsigned int opened:1;
 309        unsigned int prepared:1;
 310        unsigned int paused:1;
 311        unsigned int running:1;
 312};
 313
 314#define PLAY    SNDRV_PCM_STREAM_PLAYBACK
 315#define CAPT    SNDRV_PCM_STREAM_CAPTURE
 316
 317struct lola_pcm {
 318        unsigned int num_streams;
 319        struct snd_dma_buffer bdl; /* BDL buffer */
 320        struct lola_stream streams[MAX_STREAM_COUNT];
 321};
 322
 323/* card instance */
 324struct lola {
 325        struct snd_card *card;
 326        struct pci_dev *pci;
 327
 328        /* pci resources */
 329        struct lola_bar bar[2];
 330        int irq;
 331
 332        /* locks */
 333        spinlock_t reg_lock;
 334        struct mutex open_mutex;
 335
 336        /* CORB/RIRB */
 337        struct lola_rb corb;
 338        struct lola_rb rirb;
 339        unsigned int res, res_ex;       /* last read values */
 340        /* last command (for debugging) */
 341        unsigned int last_cmd_nid, last_verb, last_data, last_extdata;
 342
 343        /* CORB/RIRB buffers */
 344        struct snd_dma_buffer rb;
 345
 346        /* unsolicited events */
 347        unsigned int last_unsol_res;
 348
 349        /* streams */
 350        struct lola_pcm pcm[2];
 351
 352        /* input src */
 353        unsigned int input_src_caps_mask;
 354        unsigned int input_src_mask;
 355
 356        /* pins */
 357        struct lola_pin_array pin[2];
 358
 359        /* clock */
 360        struct lola_clock_widget clock;
 361        int ref_count_rate;
 362        unsigned int sample_rate;
 363
 364        /* mixer */
 365        struct lola_mixer_widget mixer;
 366
 367        /* hw info */
 368        unsigned int version;
 369        unsigned int lola_caps;
 370
 371        /* parameters */
 372        unsigned int granularity;
 373        unsigned int sample_rate_min;
 374        unsigned int sample_rate_max;
 375
 376        /* flags */
 377        unsigned int initialized:1;
 378        unsigned int cold_reset:1;
 379        unsigned int polling_mode:1;
 380
 381        /* for debugging */
 382        unsigned int debug_res;
 383        unsigned int debug_res_ex;
 384};
 385
 386#define BAR0    0
 387#define BAR1    1
 388
 389/* Helper macros */
 390#define lola_readl(chip, idx, name) \
 391        readl((chip)->bar[idx].remap_addr + LOLA_##idx##_##name)
 392#define lola_readw(chip, idx, name) \
 393        readw((chip)->bar[idx].remap_addr + LOLA_##idx##_##name)
 394#define lola_readb(chip, idx, name) \
 395        readb((chip)->bar[idx].remap_addr + LOLA_##idx##_##name)
 396#define lola_writel(chip, idx, name, val) \
 397        writel((val), (chip)->bar[idx].remap_addr + LOLA_##idx##_##name)
 398#define lola_writew(chip, idx, name, val) \
 399        writew((val), (chip)->bar[idx].remap_addr + LOLA_##idx##_##name)
 400#define lola_writeb(chip, idx, name, val) \
 401        writeb((val), (chip)->bar[idx].remap_addr + LOLA_##idx##_##name)
 402
 403#define lola_dsd_read(chip, dsd, name) \
 404        readl((chip)->bar[BAR1].remap_addr + LOLA_BAR1_DSD0_OFFSET + \
 405              (LOLA_BAR1_DSD_SIZE * (dsd)) + LOLA_BAR1_DSDn##name)
 406#define lola_dsd_write(chip, dsd, name, val) \
 407        writel((val), (chip)->bar[BAR1].remap_addr + LOLA_BAR1_DSD0_OFFSET + \
 408               (LOLA_BAR1_DSD_SIZE * (dsd)) + LOLA_BAR1_DSDn##name)
 409
 410/* GET verbs HDAudio */
 411#define LOLA_VERB_GET_STREAM_FORMAT             0xa00
 412#define LOLA_VERB_GET_AMP_GAIN_MUTE             0xb00
 413#define LOLA_VERB_PARAMETERS                    0xf00
 414#define LOLA_VERB_GET_POWER_STATE               0xf05
 415#define LOLA_VERB_GET_CONV                      0xf06
 416#define LOLA_VERB_GET_UNSOLICITED_RESPONSE      0xf08
 417#define LOLA_VERB_GET_DIGI_CONVERT_1            0xf0d
 418#define LOLA_VERB_GET_CONFIG_DEFAULT            0xf1c
 419#define LOLA_VERB_GET_SUBSYSTEM_ID              0xf20
 420/* GET verbs Digigram */
 421#define LOLA_VERB_GET_FIXED_GAIN                0xfc0
 422#define LOLA_VERB_GET_GAIN_SELECT               0xfc1
 423#define LOLA_VERB_GET_MAX_LEVEL                 0xfc2
 424#define LOLA_VERB_GET_CLOCK_LIST                0xfc3
 425#define LOLA_VERB_GET_CLOCK_SELECT              0xfc4
 426#define LOLA_VERB_GET_CLOCK_STATUS              0xfc5
 427
 428/* SET verbs HDAudio */
 429#define LOLA_VERB_SET_STREAM_FORMAT             0x200
 430#define LOLA_VERB_SET_AMP_GAIN_MUTE             0x300
 431#define LOLA_VERB_SET_POWER_STATE               0x705
 432#define LOLA_VERB_SET_CHANNEL_STREAMID          0x706
 433#define LOLA_VERB_SET_UNSOLICITED_ENABLE        0x708
 434#define LOLA_VERB_SET_DIGI_CONVERT_1            0x70d
 435/* SET verbs Digigram */
 436#define LOLA_VERB_SET_GAIN_SELECT               0xf81
 437#define LOLA_VERB_SET_CLOCK_SELECT              0xf84
 438#define LOLA_VERB_SET_GRANULARITY_STEPS         0xf86
 439#define LOLA_VERB_SET_SOURCE_GAIN               0xf87
 440#define LOLA_VERB_SET_MIX_GAIN                  0xf88
 441#define LOLA_VERB_SET_DESTINATION_GAIN          0xf89
 442#define LOLA_VERB_SET_SRC                       0xf8a
 443
 444/* Parameter IDs used with LOLA_VERB_PARAMETERS */
 445#define LOLA_PAR_VENDOR_ID                      0x00
 446#define LOLA_PAR_FUNCTION_TYPE                  0x05
 447#define LOLA_PAR_AUDIO_WIDGET_CAP               0x09
 448#define LOLA_PAR_PCM                            0x0a
 449#define LOLA_PAR_STREAM_FORMATS                 0x0b
 450#define LOLA_PAR_PIN_CAP                        0x0c
 451#define LOLA_PAR_AMP_IN_CAP                     0x0d
 452#define LOLA_PAR_CONNLIST_LEN                   0x0e
 453#define LOLA_PAR_POWER_STATE                    0x0f
 454#define LOLA_PAR_GPIO_CAP                       0x11
 455#define LOLA_PAR_AMP_OUT_CAP                    0x12
 456#define LOLA_PAR_SPECIFIC_CAPS                  0x80
 457#define LOLA_PAR_FIXED_GAIN_LIST                0x81
 458
 459/* extract results of LOLA_PAR_SPECIFIC_CAPS */
 460#define LOLA_AFG_MIXER_WIDGET_PRESENT(res)      ((res & (1 << 21)) != 0)
 461#define LOLA_AFG_CLOCK_WIDGET_PRESENT(res)      ((res & (1 << 20)) != 0)
 462#define LOLA_AFG_INPUT_PIN_COUNT(res)           ((res >> 10) & 0x2ff)
 463#define LOLA_AFG_OUTPUT_PIN_COUNT(res)          ((res) & 0x2ff)
 464
 465/* extract results of LOLA_PAR_AMP_IN_CAP / LOLA_PAR_AMP_OUT_CAP */
 466#define LOLA_AMP_MUTE_CAPABLE(res)              ((res & (1 << 31)) != 0)
 467#define LOLA_AMP_STEP_SIZE(res)                 ((res >> 24) & 0x7f)
 468#define LOLA_AMP_NUM_STEPS(res)                 ((res >> 12) & 0x3ff)
 469#define LOLA_AMP_OFFSET(res)                    ((res) & 0x3ff)
 470
 471#define LOLA_GRANULARITY_MIN            8
 472#define LOLA_GRANULARITY_MAX            32
 473#define LOLA_GRANULARITY_STEP           8
 474
 475/* parameters used with unsolicited command/response */
 476#define LOLA_UNSOLICITED_TAG_MASK       0x3f
 477#define LOLA_UNSOLICITED_TAG            0x1a
 478#define LOLA_UNSOLICITED_ENABLE         0x80
 479#define LOLA_UNSOL_RESP_TAG_OFFSET      26
 480
 481/* count values in the Vendor Specific Mixer Widget's Audio Widget Capabilities */
 482#define LOLA_MIXER_SRC_INPUT_PLAY_SEPARATION(res)   ((res >> 2) & 0x1f)
 483#define LOLA_MIXER_DEST_REC_OUTPUT_SEPARATION(res)  ((res >> 7) & 0x1f)
 484
 485int lola_codec_write(struct lola *chip, unsigned int nid, unsigned int verb,
 486                     unsigned int data, unsigned int extdata);
 487int lola_codec_read(struct lola *chip, unsigned int nid, unsigned int verb,
 488                    unsigned int data, unsigned int extdata,
 489                    unsigned int *val, unsigned int *extval);
 490int lola_codec_flush(struct lola *chip);
 491#define lola_read_param(chip, nid, param, val) \
 492        lola_codec_read(chip, nid, LOLA_VERB_PARAMETERS, param, 0, val, NULL)
 493
 494/* PCM */
 495int lola_create_pcm(struct lola *chip);
 496void lola_free_pcm(struct lola *chip);
 497int lola_init_pcm(struct lola *chip, int dir, int *nidp);
 498void lola_pcm_update(struct lola *chip, struct lola_pcm *pcm, unsigned int bits);
 499
 500/* clock */
 501int lola_init_clock_widget(struct lola *chip, int nid);
 502int lola_set_granularity(struct lola *chip, unsigned int val, bool force);
 503int lola_enable_clock_events(struct lola *chip);
 504int lola_set_clock_index(struct lola *chip, unsigned int idx);
 505int lola_set_clock(struct lola *chip, int idx);
 506int lola_set_sample_rate(struct lola *chip, int rate);
 507bool lola_update_ext_clock_freq(struct lola *chip, unsigned int val);
 508unsigned int lola_sample_rate_convert(unsigned int coded);
 509
 510/* mixer */
 511int lola_init_pins(struct lola *chip, int dir, int *nidp);
 512int lola_init_mixer_widget(struct lola *chip, int nid);
 513void lola_free_mixer(struct lola *chip);
 514int lola_create_mixer(struct lola *chip);
 515int lola_setup_all_analog_gains(struct lola *chip, int dir, bool mute);
 516void lola_save_mixer(struct lola *chip);
 517void lola_restore_mixer(struct lola *chip);
 518int lola_set_src_config(struct lola *chip, unsigned int src_mask, bool update);
 519
 520/* proc */
 521#ifdef CONFIG_SND_DEBUG
 522void lola_proc_debug_new(struct lola *chip);
 523#else
 524#define lola_proc_debug_new(chip)
 525#endif
 526
 527#endif /* _LOLA_H */
 528